natlinkcore 5.4.2.dev5__tar.gz → 5.4.3__tar.gz

natlinkcore-5.4.3/LICENSE

@@ -0,0 +1,190 @@
+NatLink
+	(c) Copyright 1997-1999 by Joel Gould.
+		Portions (c) Copyright 1997-1999 by Dragon Systems,
+	Inc. All Rights Reserved.  Permission to use, copy, modify and
+	distribute this software (except for the files noted below) and
+	documentation for any purpose and without fee is hereby granted,
+	provided that this copyright notice appear in all copies and
+	that both the copyright notice and this permission notice appear
+	in supporting documentation, and that the name Joel Gould not be
+	used in advertising or publicity pertaining to distribution of
+	the software without specific, written permission.
+	
+	The following files are NOT covered by the previous previous
+	paragraph: NatlinkSource\speech.h and
+	NatlinkSource\dspeech.h. These files may not be redistributed
+	although they can be freely downloaded from
+	http://www.synapseadaptive.com/joel/PythonMacroSystem.html and
+	used on one machine.
+	
+	Joel Gould disclaim all warranties with regard to this software,
+	including all implied warranties of merchantability and fitness,
+	in no event shall Joel Gould be liable for any special, indirect
+	or consequential damages or any damages whatsoever resulting
+	from the loss of use, data or profits whether in an action of
+	contract, negligence or tortious action, arising out of
+	connection with the use or performance of this software.
+	Possession of this software does NOT grant the possessor any
+	license to Dragon NaturallySpeaking or any other Dragon Systems
+	product, except where license to Dragon NaturallySpeaking or any
+	other Dragon Systems products is purchased or otherwise obtained
+	separately.  This copyright only applies to NatLink, including
+	source and object code and not to Dragon NaturallySpeaking or
+	any other Dragon Systems product.  Software on this web site is
+	not available from Dragon Systems, nor is Dragon Systems
+	formally associated with this software in any way.
+
+-----------------------------------
+
+Vocola
+	Copyright (c) 2002-2012 by Rick Mohr
+
+	Portions Copyright (c) 2012-15 by Hewlett-Packard Development
+	Company, L.P.
+
+	Permission is hereby granted, free of charge, to any person
+	obtaining a copy of this software and associated documentation
+	files (the "Software"), to deal in the Software without
+	restriction, including without limitation the rights to use,
+	copy, modify, merge, publish, distribute, sublicense, and/or
+	sell copies of the Software, and to permit persons to whom the
+	Software is furnished to do so, subject to the following
+	conditions:
+
+	The above copyright notice and this permission notice shall be
+	included in all copies or substantial portions of the Software.
+
+	THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+	EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+	OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+	NONINFRINGEMENT.  IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+	HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+	WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+	FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+	OTHER DEALINGS IN THE SOFTWARE.
+
+-----------------------------------
+
+Configurenatlinkunimacrovocola:
+	Copyright (c) 2008 by Quintijn Hoogenboom. It may be
+	redistributed in any way as long as this copyright notice
+	remains.
+
+-----------------------------------
+
+Unimacro (c) 2002-2011 Quintijn Hoogenboom, Ben Staniford, Bart Jan 
+	     van Os 2011 Frank Olaf Sem-Jacobsen
+	
+		"unimacro" is free software; you can redistribute it
+		and/or modify it under the terms of the GNU General
+		Public License, see: http://www.gnu.org/licenses/gpl.txt
+
+		"unimacro" is distributed in the hope that it will be
+		useful, but WITHOUT ANY WARRANTY; See the GNU General
+		Public License details.
+
+"unimacro" makes use of another SourceForge project "natlink",
+which has the copyright notice shown above.
+
+-----------------------------------
+
+ConfigureNatLink.exe NLVCSetup.msi MessageWindow.dll
+	Copyright (c) 2004-2005 Applied Recognition Inc. All rights
+	reserved.
+
+	You may freely obtain this software from
+	http://speechwiki.org/NL.HomePage
+
+	Unauthorized redistribution, reverse engineering, and
+	decompilation is prohibited.
+
+	The Software comes "as is", with no warranties. None
+	whatsoever. This means no express, implied or statutory
+	warranty, including without limitation, warranties of
+	merchantability or fitness for a particular purpose or any
+	warranty of title or non-infringement.
+
+	Neither Applied Recognition Inc. nor any contributor to the
+	Software will be liable for any of those types of damages known
+	as indirect, special, consequential, or incidental related to
+	the Software or this license, to the maximum extent the law
+	permits, no matter what legal theory it's based on.
+
+	
+-----------------------------------
+
+Shared Source License for Microsoft Visual Basic Power Pack for
+Microsoft Visual Basic 2003
+
+This license governs use of the accompanying software
+(`Software'), and your use of the Software constitutes acceptance
+of this license.
+
+You may use the Software for any commercial or noncommercial purpose,
+including distributing derivative works.
+
+In return, we simply require that you agree:
+
+1. Not to remove any copyright or other notices from the Software.
+
+2. That if you distribute the Software in source code form you do so
+   only under this license (i.e. you must include a complete copy of
+   this license with your distribution), and if you distribute the
+   Software solely in object form you only do so under a license that
+   complies with this license.
+
+3. That the Software comes "as is", with no warranties. None
+   whatsoever. This means no express, implied or statutory warranty,
+   including without limitation, warranties of merchantability or
+   fitness for a particular purpose or any warranty of title or
+   non-infringement. Also, you must pass this disclaimer on whenever you
+   distribute the Software or derivative works.
+
+4. That neither Microsoft nor any contributor to the Software will be
+   liable for any of those types of damages known as indirect, special,
+   consequential, or incidental related to the Software or this license,
+   to the maximum extent the law permits, no matter what legal theory
+   it's based on. Also, you must pass this limitation of liability on
+   whenever you distribute the Software or derivative works.
+
+5. That if you sue anyone over patents that you think may apply to the
+   Software for a person's use of the Software, your license to the
+   Software ends automatically.
+
+6. That the patent rights, if any, granted in this license only apply to
+   the Software, not to any derivative works you make.
+
+7. That the Software is subject to U.S. export jurisdiction at the time
+   it is licensed to you, and it may be subject to additional export or
+   import laws in other places.  You agree to comply with all such laws
+   and regulations that may apply to the Software after delivery of the
+   software to you.
+
+8. That if you are an agency of the U.S. Government, (i) Software
+   provided pursuant to a solicitation issued on or after December 1,
+   1995, is provided with the commercial license rights set forth in
+   this license, and (ii) Software provided pursuant to a solicitation
+   issued prior to December 1, 1995, is provided with `Restricted
+   Rights' as set forth in FAR, 48 C.F.R. 52.227-14 (June 1987) or DFAR,
+   48 C.F.R. 252.227-7013 (Oct 1988), as applicable.
+
+9. That your rights under this License end automatically if you breach
+   it in any way.
+
+10. That all rights not expressly granted to you in this license are
+    reserved.
+	
+---------------------------------------
+
+
+XPCommonControls.dll
+From http://www.steepvalley.net
+
+The controls plus the source code are completely free to use. There are
+no cost at all attached to this project.
+
+This means also that I cannot take any responsibility for bugs and
+errors resulting from this code.
+
+
+----------------------------

{natlinkcore-5.4.2.dev5 → natlinkcore-5.4.3}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.3
+Metadata-Version: 2.4
 Name: natlinkcore
-Version: 5.4.2.dev5
+Version: 5.4.3
 Summary: Python portion of Natlink, a compatibility module for Dragon Naturally Speaking
 Author-email: "Quintijn Hoogenboom (maintainer)" <q.hoogenboom@antenna.nl>
 Requires-Python: >=3.10
@@ -13,11 +13,12 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
+License-File: LICENSE
 Requires-Dist: FreeSimpleGUI>=5.1.0
 Requires-Dist: pydebugstring >= 1.0.0.1
-Requires-Dist: dtactions ~= 1.6.4.dev3
+Requires-Dist: dtactions >= 1.6.4.dev3
 Requires-Dist: platformdirs >= 4.2.0
-Requires-Dist: natlink ~= 5.5.8.dev2
+Requires-Dist: natlink >= 5.5.7
 Requires-Dist: pyenvutils ; extra == "dev"
 Requires-Dist: entry-point-inspector ; extra == "dev"
 Requires-Dist: build ; extra == "dev"
@@ -39,6 +40,14 @@ You can install from [The Python Package Index (PyPI)](https://pypi.org/) with
 
 Note that natlinkcore will not install if you have not installed Natlink first.  Natlink is installed through running an installer.
 
+This will install utilties you can run from a shell prompt:  natlinkconfig_cli, natlinkconfig_gui, and natlink_extract_ini_value.
+
+You can use natlink_extract_ini_value to grab a directory or setting out of natlink.ini for copying and pasting or a shell script.
+``` 
+PS C:\Users\doug\code\dt\natlinkcore> natlink_extract_ini_value -s directories -k  dragonflyuserdirectory
+C:\Users\doug\Documents
+```
+
  
 ## Test Framework
 Tests use the [pytest](https://docs.pytest.org/) framework.  

{natlinkcore-5.4.2.dev5 → natlinkcore-5.4.3}/pyproject.toml

@@ -5,7 +5,9 @@ build-backend = "flit_core.buildapi"
 [project]
 name = "natlinkcore"
 authors = [{name = "Quintijn Hoogenboom (maintainer)", email = "q.hoogenboom@antenna.nl"}]
-version="5.4.2.dev5"
+
+version="5.4.3"
+
 dynamic = [ "description"]
 requires-python = ">=3.10"
 readme = "readme.md"
@@ -13,9 +15,10 @@ dependencies= [
 
     "FreeSimpleGUI>=5.1.0", 
     "pydebugstring >= 1.0.0.1",
-    "dtactions ~= 1.6.4.dev3",
+    "dtactions >= 1.6.4.dev3",
     "platformdirs >= 4.2.0",
-    "natlink ~= 5.5.8.dev2"
+    "natlink >= 5.5.7"
+    # "natlink >= 5.5.8.dev2"
 ]
     classifiers=[
         "Development Status :: 4 - Beta",
@@ -54,6 +57,7 @@ testpaths= [
 [project.scripts]
 natlinkconfig_cli = "natlinkcore.configure.natlinkconfig_cli:main_cli"
 natlink_extensions = "natlinkcore.configure.natlink_extensions:main"
+natlink_extract_ini_value = "natlinkcore.configure.natlink_extract_ini_value:main"
 
 [project.gui-scripts]
 natlinkconfig_gui = "natlinkcore.configure.natlinkconfig_gui:main_gui"

{natlinkcore-5.4.2.dev5 → natlinkcore-5.4.3}/readme.md

@@ -11,6 +11,14 @@ You can install from [The Python Package Index (PyPI)](https://pypi.org/) with
 
 Note that natlinkcore will not install if you have not installed Natlink first.  Natlink is installed through running an installer.
 
+This will install utilties you can run from a shell prompt:  natlinkconfig_cli, natlinkconfig_gui, and natlink_extract_ini_value.
+
+You can use natlink_extract_ini_value to grab a directory or setting out of natlink.ini for copying and pasting or a shell script.
+``` 
+PS C:\Users\doug\code\dt\natlinkcore> natlink_extract_ini_value -s directories -k  dragonflyuserdirectory
+C:\Users\doug\Documents
+```
+
  
 ## Test Framework
 Tests use the [pytest](https://docs.pytest.org/) framework.  

{natlinkcore-5.4.2.dev5 → natlinkcore-5.4.3}/src/natlinkcore/config.py

@@ -143,7 +143,7 @@ class NatlinkConfig:
         # should not happen, because of DefaultConfig (was InstallTest)
         raise NoGoodConfigFoundException('No natlink config file found, please run configure natlink program\n\t(***configurenatlink***)')
 
-def expand_path(input_path: str) -> str:
+def expand_path(input_dir: str, must_exist: bool = True) -> str:
     r"""expand path if it starts with "~" or starts with an environment variable or name of python package
     
 Paths can be:
@@ -154,77 +154,103 @@ Paths can be:
 - Obsolete: natlink_userdir/...: instead natlink_settingsdir will be searched for, and a message is thrown. In the config program things are checked more thoroughly.
 - some other environment variable: this environment variable is expanded 
 
+
+must_exist:
+    default: True, the expanded path should exist.
+    If not (possibly when in natlinkconfigfunctions a directory should be created), pass False
+
 The Documents directory can be found by "~\Documents"...
 
 When there is nothing to expand, just return the input
     """
-    expanduser, expandvars, normpath, isdir = os.path.expanduser, os.path.expandvars, os.path.normpath, os.path.isdir
+    expanduser, expandvars, normpath, isdir, join = os.path.expanduser, os.path.expandvars, os.path.normpath, os.path.isdir, os.path.join
     
-    # I think, this is tackled below, input_path is one word, without slashes or ~ or %(...) (QH)
+    # I think, this is tackled below, input_dir is one word, without slashes or ~ or %(...) (QH)
     # try:
-    #     package_spec=u.find_spec(input_path)
+    #     package_spec=u.find_spec(input_dir)
     #     if package_spec is not None:
     #         package_path=str(p.Path(package_spec.origin).parent)
     #         return normpath(package_path)
     # except:
     #     pass
-    if input_path.startswith('~'):
+    if input_dir.startswith('~'):
         home = expanduser('~')
-        env_expanded = home + input_path[1:]
-        # print(f'expand_path: "{input_path}" include "~": expanded: "{env_expanded}"')
-        return normpath(env_expanded)
+        home_expanded = home + input_dir[1:]
+        # print(f'expand_path: "{input_dir}" include "~": expanded: "{env_expanded}"')
+        if must_exist:
+            assert isdir(home_expanded)
+        return normpath(home_expanded)
+    
+    if isdir(input_dir):
+        return normpath(input_dir)
+
+    # split in trunk and rest:
+    if input_dir.find('/') > 0:
+        trunk, rest = input_dir.split('/', 1)
+    elif input_dir.find('\\') > 0:
+        trunk, rest = input_dir.split('\\', 1)
+    else:
+        trunk, rest = input_dir, ''
 
     ## "natlink_userdir" will go obsolete, to be replaced with "natlink_settingsdir" below:
-    if input_path.startswith('natlink_userdir/') or input_path.startswith('natlink_userdir\\'):
-        nud = expand_natlink_settingsdir()
-        if isdir(nud):
-            dir_path = input_path.replace('natlink_userdir', nud)
-            dir_path = normpath(dir_path)
-            if isdir(dir_path):
-                return dir_path
-            print(f'no valid directory found with "natlink_userdir": "{dir_path}"\nbut "natlink_userdir" should be replaced by "natlink_settingsdir" anyway')
-            return dir_path
-        print(f'natlink_userdir does not expand to a valid directory: "{nud}"\nbut "natlink_userdir" should be replaced by "natlink_settingsdir" anyway')
-        return normpath(nud)
-
-    if input_path.startswith('natlink_settingsdir/') or input_path.startswith('natlink_settingsdir\\'):
+    if trunk == 'natlink_userdir':
+        trunk = expand_natlink_settingsdir()
+        if isdir(trunk):
+            replaced_dir = join(trunk, rest)
+            if must_exist:
+                if isdir(replaced_dir):
+                    return normpath(replaced_dir)
+            else:
+                print(f'no valid directory found with "natlink_userdir": "{input_dir}"\nbut "natlink_userdir" should be replaced by "natlink_settingsdir" anyway')
+                return ''
+            # must exist False:
+            return replaced_dir
+        # trunk is NOT a directory:
+        print(f'no valid directory found with "natlink_userdir": "{trunk}"\nbut "natlink_userdir" should be replaced by "natlink_settingsdir" anyway')
+        return ''
+
+    if trunk == 'natlink_settingsdir':
         nsd = expand_natlink_settingsdir()
-        if isdir(nsd):
-            dir_path = input_path.replace('natlink_settingsdir', nsd)
-            dir_path = normpath(dir_path)
-            if isdir(dir_path):
-                return dir_path
-            print(f'no valid directory found with "natlink_settingsdir": "{dir_path}"')
-            return dir_path
-        print(f'natlink_settingsdir does not expand to a valid directory: "{nsd}"')
-        return normpath(nsd)
-    
+        if not isdir(nsd):
+            print(f'natlink_settingsdir does not expand to a valid directory: "{nsd}" (input_dir: "{input_dir}"')
+            return ''
+        
+        replaced_dir = normpath(join(nsd, rest))
+        if isdir(replaced_dir):
+            return replaced_dir
+        if must_exist:
+            return ''
+        return replaced_dir
     
     # try if package:
-    if input_path.find('/') > 0:
-        package_trunk, rest = input_path.split('/', 1)
-    elif input_path.find('\\') > 0:
-        package_trunk, rest = input_path.split('\\', 1)
-    else:
-        package_trunk, rest = input_path, ''
-        # find path for package.  not an alternative way without loading the package is to use importlib.util.findspec.
+    # find path for package.  not an alternative way without loading the package is to use importlib.util.findspec.
     
     # first check for exclude "C:" as trunk:
-    if package_trunk and package_trunk[-1] != ":":
+    if trunk and trunk[-1] != ":":
         try:
-            pack = __import__(package_trunk)
+            pack = __import__(trunk)
             package_path = pack.__path__[-1]
-            if rest:
-                dir_expanded = str(Path(package_path)/rest)
-                return dir_expanded
-            return package_path
+            replaced_dir = join(package_path, rest)
+            if isdir(replaced_dir):
+                return replaced_dir
+            if not must_exist:
+                return replaced_dir
     
         except (ModuleNotFoundError, OSError):
             pass
     
-    env_expanded = expandvars(input_path)
-    # print(f'env_expanded: "{env_expanded}", from envvar: "{input_path}"')
-    return normpath(env_expanded)
+    
+    # if here: try if there are extenden environment variables to expand:
+    env_expanded = expandvars(input_dir)
+    # print(f'env_expanded: "{env_expanded}", from envvar: "{input_dir}"')
+    env_expanded = normpath(env_expanded)
+    if isdir(env_expanded):
+        return env_expanded
+    
+    if not must_exist:
+        return env_expanded
+    # no valid path, but MUST exist (default)
+    return ''
 
 def expand_natlink_settingsdir():
     """Return the location of the natlink config files

natlinkcore-5.4.3/src/natlinkcore/configure/natlink_extract_ini_value.py

@@ -0,0 +1,50 @@
+import argparse
+import sys
+from natlinkcore.configure.natlinkconfigfunctions import NatlinkConfig
+import configparser
+from pathlib import Path
+import configparser
+
+def get_config_value(config, section, key):
+    if not config.has_section(section):
+        raise configparser.NoSectionError(section)
+    if not config.has_option(section, key):
+        raise configparser.NoOptionError(key, section)
+    return config.get(section, key)
+ 
+def main():
+    parser = argparse.ArgumentParser(description=
+        f"""prints the value for the key in the section of natlink.ini to standard out.  You can also ask for the full path to the ini file.  
+        for example, to get the dragonflyuserdirectory key in the directories section:
+        {sys.argv[0]} --section 'directories' --key dragonflyuserdirectory
+        """)
+    parser.add_argument('-i', "--ini_file",action='store_true',  help='print the full path to the natlink.ini file')
+ 
+
+
+    parser.add_argument('-s', '--section', type=str,  help='Section name')
+    parser.add_argument('-k', '--key', type=str, help='Key name')
+
+    args = parser.parse_args()
+
+
+    try:
+        config=NatlinkConfig()
+        config_path=config.natlinkconfig_path
+        config_file=Path(config_path)/"natlink.ini"
+        if args.ini_file:
+            print(config_file)
+            exit(0)
+        if not (args.key and args.section):
+            raise Exception("Must supply key and section or -i/--ini_file")
+        config=configparser.ConfigParser()
+        config.read(config_file)
+        v=get_config_value(config,args.section,args.key)
+        print(f"{v}")
+    except Exception as e:
+        print(e)
+        exit(-1)
+
+
+if __name__ == "__main__":
+    main()