Release/5.3.0-beta11

Copyrights

Please see the docs/Licenses directory for copies of any licenses for software we use with EDMarketConnector, either at runtime, or to produce the Windows executables and installer.

---

• We now test against, and package with, Python 3.10.2.

  As a consequence of this we no longer support Windows 7.
  This is due to Python 3.10.x itself not supporting Windows 7.
  The application (both EDMarketConnector.exe and EDMC.exe) will crash on startup due to a missing DLL.

  This should have no other impact on users or plugin developers, other than the latter now being free to use features that were introduced since the Python 3.7 series.

  Developers can check the contents of the .python-version file in the source (it's not distributed with the Windows installer) for the
  currently used version in a given branch.

---

Pre-Release 5.3.0-beta11

• EDND: Implement forthcoming approachsettlement/1 schema.

• EDND: Implement forthcoming fssallbodiesfound/1 schema.

• Inara: Only send a setCommanderCredits message at game login. Yes, you will NEED to relog to send an updated balance. This is the only way in which to sanely keep the 'Total Assets' value on Inara from bouncing around. Refer to Inara:API:docs:setCommanderCredits.

  Closes #1401.

Plugin Developers

• It's unlikely to affect you, but our requirements-dev.txt now explicitly cites a specific version of setuptools. This was necessary to ensure we have a version that works with py2exe for the windows build process.

  If anything this will ensure you have a more up to date version of setuptools installed.

Release/5.3.0-beta9

• Inara: Fix for always sending a Rank Progress of 0%.

Release/5.3.0-beta10

• Revert semantic_version python module to v2.8.5, as v2.9.0 doesn't get correctly included by py2exe. This lead to application crash at startup when using the Windows .exe.

Release/5.3.0-beta8

This pre-release should be identical to https://github.com/EDCD/EDMarketConnector/releases/tag/Release%2F5.3.0-beta7 in terms of application functionality. There are literally no changes to any code.

What this release does do is address how the switch to using https://github.com/EDCD/FDevIDs - rather than copied/processed versions of its files, had broken the GitHub windows-build action, due to the latter not also checking out submodules.

So:

1. This was built on GitHub, unlike -beta7.
2. This should have all the same FDevIDs sourced files as -beta7.
3. The things that would break if there are any FDevIDs-sourced data files differences are e.g. Settings > Output > 'Market data in Trade Dangerous format file'. Also the 'Ship loadout' option there.

Pre-Release 5.3.0-beta7

Pre-Release 5.3.0-beta7

NB: Due to this issue with GitHub's Actions
we were unable to build this version on GitHub. THE INSTALLER FOR THIS
RELEASE WAS BUILT ON A DEVELOPER'S OWN MACHINE. THERE IS NO REASON TO BELIEVE
THAT THIS IN ANY WAY INCREASES THE RISK OF IT ACTUALLY CONTAINING MALWARE.

As has sadly become routine now, please read
our statement about malware false positives
affecting our installers and/or the files they contain. We are as confident
as we can be, without detailed auditing of python.org's releases and all of
the py2exe source and releases, that there is no malware in the files we make
available.

• We now test and build using Python 3.10.2. We do not yet make use of any
  features specific to Python 3.10 (or 3.9). Let us restate that we
  absolutely reserve the right to commence doing so.

• "File" -> "Status" will now show the new Odyssey ranks, both the new
  categories and the new 'prestige' ranks, e.g. 'Elite I'. Closes
  #1369.

• Running EDMarketConnector.exe --reset-ui will now also reset any changes to
  the application "UI Scale" or geometry (position and size). Closes
  #1155.

• We now use UTC-based timestamps in the application's log files. Prior to
  this change it was the "local time", but without any indication of the
  applied timezone. Each line's timestamp has UTC as a suffix now. We
  are assuming that your local clock is correct and the timezone is set
  correctly, such that Python's time.gmtime() yields UTC times.

  This should make it easier to correlate application logfiles with in-game
  time and/or third-party service timestamps.

• All communication with remote web servers and APIs now uses the same custom
  "User-Agent" header to make attribution to this application clear.

• The process used to build the Windows installers should now always pick up
  all the necessary files automatically. Prior to this we used a manual
  process to update the installer configuration which was prone to both user
  error and neglecting to update it as necessary.

• If the application fails to load valid data from the NavRoute.json file
  when processing a Journal NavRoute event, it will attempt to retry this
  operation a number of times as it processes subsequent Journal events.

  This should hopefully work around a race condition where the game might
  not have yet updated NavRoute.json at all, or has truncated it to empty,
  when we first attempt this.

  We will also now NOT attempt to load NavRoute.json during the startup
  'Journal catch-up' mode, which only sets internal state.

  Closes #1348.

• Inara: Use the <journal log>->Statistics->Bank_Account->Current_Wealth
  value when sending a setCommanderCredits message to Inara to set
  commanderAssets.

  This should cause Inara and EDMC to agree on the Commander's current total
  assets credits figure, and thus prevent it bouncing between two values.

  Closes #1401.

• Inara: Send a setCommanderRankPilot message when the player logs in to the
  game on-foot. Previously you would HAVE to be in a ship at login time
  for this to be sent.

  Thus, you can now relog on-foot in order to update Inara with any Rank up
  or progress since the session started.

  Closes #1378.

• Inara: We will now send the new idea of "credits in the Commander's wallet"
  when the delta from the last sent value is either 5% or at least
  10 million. It used to require a strict 5% difference, which meant needing
  very large deltas if you had a large credit balance.

  The intention of the 5% is so that newer/poorer commanders still get
  updates at an acceptable frequency, with the 10 million alternative trigger
  allowing richer commanders to also experience more frequent updates than
  was previously the case.

  Close #1255.

• Inara: You should once more see updates for any materials used in
  Engineering. The bug was in our more general Journal event processing
  code pertaining to EngineerCraft events, such that the state passed to
  the Inara plugin hadn't been updated.

  Such updates should happen 'immediately', but take into account that there
  can be a delay of up to 35 seconds for any data sent to Inara, due to how
  we avoid breaking the "2 messages a minute" limit on the Inara API.

  Closes #1395.

• EDDN: We now compress all outgoing messages. This might help get some
  particularly large navroute messages go through.

  If any message is now rejected as 'too large' we will drop it, and thus
  not retry it later. The application logs will reflect this.

  NB: The EDDN Gateway was updated to allow messages up to 1 MiB in size
  anyway. The old limit was 100 KiB.

  Closes #1390.

• EDDN: In an attempt to diagnose some errors observed on the EDDN Gateway
  with respect to messages sent from this application some additional checks
  and logging have been added.

  NB: After some thorough investigation it was concluded that these EDDN
  errors were likely the result of long-delayed messages due to use of
  the "Delay sending until docked" option.

  There should be no functional changes for users. But if you see any of
  the following in this application's log files PLEASE OPEN
  AN ISSUE ON GITHUB
  with all the requested information, so that we can correct the relevant
  code:

  • No system name in entry, and system_name was not set either! entry: ...
  • BodyName was present but not a string! ...
  • post-processing entry contains entry ...
  • this.body_id was not set properly: ...
  • system is falsey, can't add StarSystem
  • this.coordinates is falsey, can't add StarPos
  • this.systemaddress is falsey, can't add SystemAddress
  • this.status_body_name was not set properly: ...

  You might also see any of the following in the application status text
  (bottom of the window):

  • passed-in system_name is empty, can't add System
  • CodexEntry had empty string, PLEASE ALERT THE EDMC DEVELOPERS
  • system is falsey, can't add StarSystem
  • this.coordinates is falsey, can't add StarPos
  • this.systemaddress is falsey, can't add SystemAddress

  Ref: #1403
  #1393.

Plugin Developers

• We now have an .editorconfig file which will instruct your editor/IDE to
  change some settings pertaining to things like indentation and line wrap,
  assuming your editor/IDE supports the file.

  See Contributing.md->Text formatting.

• As noted above, prior to this version we weren't properly monitoring
  EngineerCraft events. This caused the state passed to plugins to not
  contain the correct 'materials' (Raw, Manufactured, Encoded) counts.

• config.py has been refactored into a sub-directory, with the per-OS code
  split into separate files. There shouldn't be any changes necessary to
  how you utilise this, e.g. to determine the application version.

  All forms of any import statement that worked before should have
  unchanged functionality.

• We now include FDevIDS as a
  sub-repository, and use its files directly for keeping some game data up to
  date. This should hopefully mean we include, e.g. new ships and modules
  for loadout exports in a more timely manner.

  Developers of third-party plugins should never have been using these files
  anyway, so this shouldn't break anything for them.

• We will now include in the Windows installer all of the files that py2exe
  places in the build directory. We still do not yet include all of the
  Python 'stdlib', so open an issue on GitHub if something you need is
  missing.

Release/5.2.4

• We now test against, and package with, Python 3.9.9.

  As a consequence of this we no longer support Windows 7.
  This is due to Python 3.9.x itself not supporting Windows 7.
  The application (both EDMarketConnector.exe and EDMC.exe) will crash on startup due to a missing DLL.

  This should have no other impact on users or plugin developers, other than the latter now being free to use features that were introduced since the Python 3.7 series.

  Developers can check the contents of the .python-version file in the source (it's not distributed with the Windows installer) for the
  currently used version in a given branch.

---

Release 5.2.4

This is a very minor update that simply imports the latest versions of data files so that some niche functionality works properly.

• Update commodity.csv and rare_commodity.csv from the latest EDCD/FDevIDs versions. This addresses an issue with export of market data in Trade Dangerous format containing OnionHeadC rather than the correct name, Onionhead Gamma Strain, that Trade Dangerous is expecting.

  This will only have affected Trade Dangerous users who use EDMarketConnector as a source of market data.

Release/5.3.0-beta2

In terms of application functionality this is identical to 5.3.0-beta0. The only changes are related to the process of building the Windows installer.

• Ensure we always package all files into the Windows installer.
• Use a different workaround for OneSky (translations website) using zh-Hans for Chinese (Simplified), whereas Windows will call this zh-CN. This is in-code and documented with a comment, as opposed to some 'magic' in the Windows Installer configuration that had no such documentation. It's less fragile than relying on that, or developers using a script/documented process to rename the file.

Release/5.3.0-beta0

This pre-release is intended for testing building under Python 3.10(.0).

There is one other small change:

• We now set a custom User-Agent on all remote-server queries we make. This is of the form EDCD-EDMarketConnector-<full version>, i.e. EDCD-EDMarketConnector-5.3.0-beta0+d546e840.DIRTY. This will aid in debugging any issues EDMC might have with services like EDDN, EDDB and the like.

This should have no direct impact on user experience.

Primarily we just need to ensure that this version installs, runs and doesn't exhibit any weirdness that isn't also present in 5.2.3.

Release/5.2.3

• We now test against, and package with, Python 3.9.9.

  As a consequence of this we no longer support Windows 7.
  This is due to Python 3.9.x itself not supporting Windows 7.
  The application (both EDMarketConnector.exe and EDMC.exe) will crash on startup due to a missing DLL.

  This should have no other impact on users or plugin developers, other than the latter now being free to use features that were introduced since the Python 3.7 series.

  Developers can check the contents of the .python-version file in the source (it's not distributed with the Windows installer) for the currently used version in a given branch.

---

Release 5.2.3

This release fixes one bug and fixes some example code.

• Odyssey changed the order of some Journal events. This caused our logic for tracking the following to break, and thus not report them ever to Inara:

  • Ship Combat, Trade and Exploration ranks.
  • On-foot Combat and Exobiologist ranks.
  • Engineer unlocks and progress.
  • Reputations with Major Factions (Superpowers).

  This is now fixed and the current state of all of these will be correctly reported to Inara if you have API access for it configured.

Developers

• Now built using Python 3.9.9.

• Updated PLUGINS.md to state that we don't actually include all of Python's standard library.

• The click_counter example plugin code has been corrected to both actually work fully, and pass our linting.

Release/5.2.3-beta1

• We now test against, and package with, Python 3.9.9.

  As a consequence of this we no longer support Windows 7.
  This is due to Python 3.9.x itself not supporting Windows 7.
  The application (both EDMarketConnector.exe and EDMC.exe) will crash on startup due to a missing DLL.

  This should have no other impact on users or plugin developers, other than the latter now being free to use features that were introduced since the Python 3.7 series.

  Developers can check the contents of the .python-version file in the source (it's not distributed with the Windows installer) for the currently used version in a given branch.

---

Pre-Release 5.2.3-beta1

This release fixes one bug.

• Odyssey changed the order of some Journal events. This caused our logic for tracking the following to break, and thus not report them ever to Inara:

  • Ship Combat, Trade and Exploration ranks.
  • On-foot Combat and Exobiologist ranks.
  • Engineer unlocks and progress.
  • Reputations with Major Factions (Superpowers).

  This is now fixed and the current state of all of these will be correctly reported to Inara if you have API access for it configured.

Developers

• Now built using Python 3.9.9.