Skip to content

NATLINK_5_3_4

Pre-release
Pre-release
Compare
Choose a tag to compare
@LexiconCode LexiconCode released this 25 Sep 13:42
· 59 commits to master since this release

Major restructuring:

C++ and Python have been separated from dictation-toolbox/natlink into two separate repositories. C++ code lives in this repository natlink to build the installer. The majority Python resides in natlinkcore as a Python package released on PYPI. Rationale for change.

  • Build systems are different between the C++ with installer (Cmake) and Python package
  • Allows us to run tests on respective repositories.
  • This allows for the Python code (natlinkcore) to be updated through pypi independently of the C++ code (natlink).

Breaking Changes

  • Changes to imports for user scripts.
    • Many Imports like import natlink have changed to:
      from natlinkcore.natlinkutils import *
      from natlinkcore.natlinkstatus import NatlinkStatus

    • C++ natlink functions can be called directly, eg. natlink.execScript, natlink.playString

  • Python 3.10.x 32-bit is now required however If individuals want to build the installer for older python versions it can be built as low as 3.9.

Other changes

  • If a compatible Python environment is not is not detected the installer will offer to install Python off path.
  • Added configuration GUI: Installer runs a GUI for configuration simply select the project of interest to user directory where your scripts
  • Added shortcuts to start menu for natlink GUI/CLI
  • Enhanced natlink config functions

Upgrading existing installs:
The Natlink installer can handle installing Python if it's not detected and it will be off system path

  1. (Optionally) Python 3.10.x-32 eg. https://www.python.org/downloads/release/python-3107/
    • Only needed if you want Python on path
  2. Uninstall any old version of natlink and delete C:\Program Files (x86)\Natlink if needed
  3. Delete C:\Users\%userprofile%\.natlink
  4. Run the natlink5.3.4-py3.10-32-setup.exe
  5. Utilize the GUI at the end to configure setting the user directory as necessary per project.
  • The GUI or CLI can be relaunched from the Windows start menu under Natlink
    image

What's Changed

Full Changelog: natlink5.1.1.pre...NATLINK_5_3_4