NATLINK_v5.5.7

What's Changed

• fix GetPythonInstallPath in inno-setup-natlink.iss by @LexiconCode in #177
• Documentation migration to docsify by @LexiconCode in #174
• Developer docs pydebug by @dougransom in #183
• Simplify documentation by @quintijn in #188
• Make a very short website for natlink.readthedocs.io by @quintijn in #190
• changes in init.py hopefully prevent Dragon 16 from halting by an… by @dougransom in #191
• playEvents for Dragon16 by @quintijn in #202
• add debug messages, and caught unhandled exception that hangs dragon by @dougransom in #204

Full Changelog: NATLINK_v5.5.6...NATLINK_v5.5.7

NATLINK_v5.5.6

What's Changed

• hints for testing setTrayIcon by @quintijn in #167
• Fix #166 by @dougransom in #168

Full Changelog: NATLINK_v5.5.5...NATLINK_v5.5.6

NATLINK_v5.5.5

What's Changed

• Fix exception in exception in init.py by @quintijn in #143
• NatConnect now returns a context manager. by @dougransom in #156
• Add initial DPI v16 support by @LexiconCode in #158
• Re-factor DNS/DPI version handling in build system/code by @LexiconCode in #160
• Add Natlink Python Environment Bat Shortcut and optimize set up install by @LexiconCode in #163
• Explicitly free memory allocated by @LexiconCode in #164

Full Changelog: NATLINK_5_4_4...NATLINK_v5.5.5

NATLINK_5_4_4

What's Changed

New feature

• Added initial Python 3.11 support - Further testing required of DNS versions in 73251dd

BugFix

• execScript calls with non ascii characters @quintijn in #142

Full Changelog: NATLINK_5_3_4...NATLINK_5_4_4

NATLINK_5_3_4

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
  

What's Changed

• Update developers.rst with enhanced restructured text formatting for development environment set up by @LexiconCode in #102
• Includeinstallerfiles by @quintijn in #105
• Installerdetails by @quintijn in #112
• INI remove hardcoded paths and add tests by @dougransom in #121
• moved natlinkcore to another repository by @dougransom in #122
• Natlink issue 113 by @quintijn in #123
• Natlink issue 113 by @dougransom in #124
• Natlink doc by @quintijn in #130
• Packaging aug22 by @dougransom in #131
• Add missing call to finalize the interpreter on NatSpeak shutdown by @Danesprite in #129
• Build/Installer now uses a wheel by @dougransom in #133

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

natlink5.1.3.pre

** improved compile options of the natlink.pyd file

What's Changed

• Update developers.rst with enhanced restructured text formatting for development environment set up by @LexiconCode in #102
• Includeinstallerfiles by @quintijn in #105
• Installerdetails by @quintijn in #106
• making release 5.1.3.pre by @quintijn in #107

natlinkv5.1.1.pre

started documentation, which is in natlink.readthedocs.io.

fixed issue#86, with wrong C++ compiler packages (VCRUNTIME140D.dll should NOT be a dependency of natlink.pyd).

included (again) sample macros from original version of Joel Gould, a little adapted to python3.

For Dragonfly, Caster, etc. this release should work pretty well.

For Vocola, most things will probably work.

For Unimacro and dtactions, quite a few details need to be solved.

natlink5.1.0.pre

lots of larger and smaller changes:

• natlinkconfigfunctions.py works for most options, this is a CLI interface for configure UserDirectory, DragonflyUserDirectory, UnimacroUserDirectory and VocolaUserDirectory.
• changing the env variables that are checked for config directories: only NATLINK_USERDIR can be specified to define the user directory of Natlink. The config file is always "natlink.ini".
• when no natlink.ini is in the specified directory, the "fallback" file from the default location is copied.
• a wxdialogs dialog is opened when choosing a directory without a "typed out" path.
• loader.py and natlinkstatus.py are now "singleton" classes, creating only one instance. Mechanism of singleton enhanced and put in singleton.py
• Vocola now basically working, and reloading a changing .vcl file on the spot. (At first utterance).
• For this, the "on_mic_on" callback can be set to a (small) int value, (apart from True or False): after so many utterances the value falls back to False. (and is ignored when it is set to True). Vocola uses this.
• Vocola uses a "pre_load" callback.
• Unimacro basically working. Unimacro actions is still work to do. As are the clipboard functions.
• Unimacro has a compare/synchronise function for the supplied grammars (in the release) with respect to the active grammars (in the ActiveGrammars subdirectory of the UnimacroUserDirectory)

to install things: download and run this installer.

1. do a # pip install vocola2, unimacro, dtactions, dragonfly and other packages as wanted.
2. run the natlinkconfigfunctions.py and do your settings. The option "I" opens the natlink.ini file, and you can manually edit the config file.
3. start/restart Dragon.

work in progress...

natlinkv5.0.0.pre

Global Changes

• This is a pre release of natlink (based upon natlink-light as written by kb100, James Murphy and made ready for this release by Fusenthasticus)
• Supports Dragon 13, 14 and 15 with python 3.8 32-bit
• When you configure the userdirectory to be loaded in the file .natlink\natlink.ini in the section [directories]
  you can add your python grammar files into this userdirectory
• Please report issues via github.

2022-02-05, Quintijn Hoogenboom and Aaron Walker

What's Changed

• Added vocola sample of microsoft edge. by @dougransom in #10
• Add call to PySys_SetArgvEx() in CDgnAppSupport::Register() by @Danesprite in #4
• Update the inputFromFile() function's documentation on errors by @Danesprite in #11
• Add & document script for using Natlink's inputFromFile() function by @Danesprite in #12
• Add Python 3.8 pyd - untested by @mrob95 in #13
• Natlink light should now be clean by @quintijn in #78
• include program specific grammars in the loader by @quintijn in #81
• Natlink light by @quintijn in #84

New Contributors

• @Danesprite made their first contribution in #4
• @mrob95 made their first contribution in #13