when need add SCRIPTS folder to sys.path

- test: for Windows, attempt add SCRIPTS folder to sys.path
- test: for Windows, walk SCRIPTS folder print files and folders

CHANGELOG.md

@@ -8,6 +8,13 @@ and this project follows an extension of
 fourth number represents an administrative maintenance release with no code
 changes.
 
+### [2.4.1.2] - 2024-08-27
+
+#### Tests
+
+* for Windows, attempt add SCRIPTS folder to sys.path
+* for Windows, walk SCRIPTS folder print files and folders
+
 ### [2.4.1.1] - 2024-08-27
 
 #### Tests

src/sphobjinv/version.py

@@ -29,4 +29,4 @@
 
 """
 
-__version__ = "2.4.1"
+__version__ = "2.4.1.2"

tests/test_cli_textconv.py

@@ -64,7 +64,7 @@
 @pytest.fixture
 def windows_paths():
     """Fixture prints diagnostic info for bugging Windows paths."""
-    import os
+    import platform
     import site
 
     def func() -> None:
@@ -74,6 +74,23 @@ def func() -> None:
         # On Windows, what is the lib path?
         # /home/faulkmore/.local/lib/python3.9/site-packages
         print(f"Packages site path: {site.USER_SITE}", file=sys.stderr)
+        if platform.system() == "Windows":
+            site_packages = site.getsitepackages()
+            site_user_packages = site.getusersitepackages()
+            print(f"site packages: {site_packages!r}", file=sys.stderr)
+            print(f"user site packages: {site_user_packages!r}", file=sys.stderr)
+
+            path_scripts = Path(site.USER_SITE).parent.joinpath("SCRIPTS")
+            scripts_path = str(path_scripts)
+            print(f"path_scripts: {path_scripts}", file=sys.stderr)
+            for (dirpath, dirnames, filenames) in os.walk(str(path_scripts)):
+                print(f"{dirpath!s} {dirnames!r} {filenames!r}")
+
+            # Set path to parent folder of package entrypoint executables
+            if scripts_path not in sys.path:
+                # https://stackoverflow.com/a/10253916
+                # `[better way] <https://stackoverflow.com/a/59411635>`_
+                sys.path.append(0, scripts_path)
 
     return func
 

tests/test_cli_textconv_with_git.py

@@ -58,8 +58,8 @@
 @pytest.fixture
 def windows_paths():
     """Fixture prints diagnostic info for bugging Windows paths."""
-    import os
     import site
+    import platform
 
     def func() -> None:
         """Diagnostic info for bugging Windows paths."""
@@ -68,6 +68,23 @@ def func() -> None:
         # On Windows, what is the lib path?
         # /home/faulkmore/.local/lib/python3.9/site-packages
         print(f"Packages site path: {site.USER_SITE}", file=sys.stderr)
+        if platform.system() == "Windows":
+            site_packages = site.getsitepackages()
+            site_user_packages = site.getusersitepackages()
+            print(f"site packages: {site_packages!r}", file=sys.stderr)
+            print(f"user site packages: {site_user_packages!r}", file=sys.stderr)
+
+            path_scripts = Path(site.USER_SITE).parent.joinpath("SCRIPTS")
+            scripts_path = str(path_scripts)
+            print(f"path_scripts: {path_scripts}", file=sys.stderr)
+            for (dirpath, dirnames, filenames) in os.walk(str(path_scripts)):
+                print(f"{dirpath!s} {dirnames!r} {filenames!r}")
+
+            # Set path to parent folder of package entrypoint executables
+            # https://stackoverflow.com/a/10253916
+            # `[better way] <https://stackoverflow.com/a/59411635>`_
+            if scripts_path not in sys.path:
+                sys.path.append(0, scripts_path)
 
     return func
 

tox.ini

@@ -111,8 +111,8 @@ commands=
 deps=
 
 [pytest]
-# cd .tox; tox --root=.. -c ../tox.ini -e py38-sphx_latest-attrs_latest-jsch_latest \
-# --workdir=.; cd - 2>/dev/null
+# cd .tox; PYTHONPATH=../ tox --root=.. -c ../tox.ini \
+# -e py38-sphx_latest-attrs_latest-jsch_latest --workdir=.; cd - 2>/dev/null
 markers =
   local: Tests not requiring Internet access
   nonloc: Tests requiring Internet access