pystand 2.34__tar.gz → 2.36__tar.gz

{pystand-2.34/pystand.egg-info → pystand-2.36}/PKG-INFO

@@ -1,12 +1,11 @@
 Metadata-Version: 2.4
 Name: pystand
-Version: 2.34
+Version: 2.36
 Summary: Install Python versions from python-build-standalone project
 Author-email: Mark Blakeney <mark.blakeney@bullet-systems.net>
 License-Expression: GPL-3.0-or-later
 Project-URL: Homepage, https://github.com/bulletmark/pystand
 Keywords: python-build-standalone,pyenv,hatch,pdm
-Classifier: Programming Language :: Python :: 3
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 Requires-Dist: packaging
@@ -141,10 +140,10 @@ Type `pystand` or `pystand -h` to view the usage summary:
 
 ```
 usage: pystand [-h] [-D DISTRIBUTION] [-P PREFIX_DIR] [-C CACHE_DIR]
-                  [-M CACHE_MINUTES] [--purge-days PURGE_DAYS]
-                  [--github-access-token GITHUB_ACCESS_TOKEN] [--no-strip]
-                  [--no-color] [--cert {system,certifi,none}] [-V]
-                  {install,i,update,u,up,remove,r,rm,list,l,show,s,path,p,cache,c,uv,uvx} ...
+               [-M CACHE_MINUTES] [--purge-days PURGE_DAYS]
+               [--github-access-token GITHUB_ACCESS_TOKEN] [--no-strip]
+               [--no-color] [--cert {system,certifi,none}] [-V]
+               {install,i,update,u,up,remove,r,rm,list,l,show,s,path,p,cache,c,uv,uvx} ...
 
 Command line tool to download, install, and update pre-built Python versions
 from the python-build-standalone project at https://github.com/astral-
@@ -203,14 +202,13 @@ Some commands offer aliases as shown in parentheses above. Note you can set
 default starting global options in ~/.config/pystand-flags.conf.
 ```
 
-Type `pystand <command> -h` to see specific help/usage for any
-individual command:
+Type `pystand <command> -h` to see specific help/usage for any individual command:
 
 ### Command `install`
 
 ```
 usage: pystand install [-h] [-r RELEASE] [-a] [-A] [--skip] [-f] [-s]
-                          [version ...]
+                       [version ...]
 
 Install one, more, or all versions from a python-build-standalone release.
 
@@ -239,7 +237,7 @@ aliases: i
 
 ```
 usage: pystand update [-h] [-r RELEASE] [-a] [--pre-release] [--skip] [-k]
-                         [version ...]
+                      [version ...]
 
 Update one, more, or all versions to another release.
 
@@ -378,7 +376,7 @@ aliases: c
 
 ```
 usage: pystand uv [-h] [-p PYTHON]
-                     command [subcommand] [uv_args_for_command ...]
+                  command [subcommand] [uv_args_for_command ...]
 
 Run a uv command using a version of python installed by pystand.
 

{pystand-2.34 → pystand-2.36}/README.md

@@ -122,10 +122,10 @@ Type `pystand` or `pystand -h` to view the usage summary:
 
 ```
 usage: pystand [-h] [-D DISTRIBUTION] [-P PREFIX_DIR] [-C CACHE_DIR]
-                  [-M CACHE_MINUTES] [--purge-days PURGE_DAYS]
-                  [--github-access-token GITHUB_ACCESS_TOKEN] [--no-strip]
-                  [--no-color] [--cert {system,certifi,none}] [-V]
-                  {install,i,update,u,up,remove,r,rm,list,l,show,s,path,p,cache,c,uv,uvx} ...
+               [-M CACHE_MINUTES] [--purge-days PURGE_DAYS]
+               [--github-access-token GITHUB_ACCESS_TOKEN] [--no-strip]
+               [--no-color] [--cert {system,certifi,none}] [-V]
+               {install,i,update,u,up,remove,r,rm,list,l,show,s,path,p,cache,c,uv,uvx} ...
 
 Command line tool to download, install, and update pre-built Python versions
 from the python-build-standalone project at https://github.com/astral-
@@ -184,14 +184,13 @@ Some commands offer aliases as shown in parentheses above. Note you can set
 default starting global options in ~/.config/pystand-flags.conf.
 ```
 
-Type `pystand <command> -h` to see specific help/usage for any
-individual command:
+Type `pystand <command> -h` to see specific help/usage for any individual command:
 
 ### Command `install`
 
 ```
 usage: pystand install [-h] [-r RELEASE] [-a] [-A] [--skip] [-f] [-s]
-                          [version ...]
+                       [version ...]
 
 Install one, more, or all versions from a python-build-standalone release.
 
@@ -220,7 +219,7 @@ aliases: i
 
 ```
 usage: pystand update [-h] [-r RELEASE] [-a] [--pre-release] [--skip] [-k]
-                         [version ...]
+                      [version ...]
 
 Update one, more, or all versions to another release.
 
@@ -359,7 +358,7 @@ aliases: c
 
 ```
 usage: pystand uv [-h] [-p PYTHON]
-                     command [subcommand] [uv_args_for_command ...]
+                  command [subcommand] [uv_args_for_command ...]
 
 Run a uv command using a version of python installed by pystand.
 

{pystand-2.34 → pystand-2.36}/justfile

@@ -15,7 +15,7 @@ upload: build
   uv-publish
 
 doc:
-  update-readme-usage -A
+  update-readme-usage
 
 format:
   ruff check --select I --fix {{PYFILES}} && ruff format {{PYFILES}}

{pystand-2.34 → pystand-2.36}/pyproject.toml

@@ -9,9 +9,6 @@ readme = "README.md"
 license = "GPL-3.0-or-later"
 requires-python = ">=3.8"
 keywords = ["python-build-standalone", "pyenv", "hatch", "pdm"]
-classifiers = [
-  "Programming Language :: Python :: 3",
-]
 dynamic = ["version"]
 dependencies = [
   "packaging",
@@ -36,17 +33,10 @@ pystand = "pystand:main"
 [tool.setuptools_scm]
 version_scheme = "post-release"
 
-[tool.mypy]
-implicit_optional = true
-warn_no_return = false
-allow_untyped_globals = true
-allow_redefinition = true
-ignore_missing_imports = true
-
 [tool.ruff.format]
 quote-style = "single"
 
 [tool.ruff.lint]
-ignore = ["SIM115", "SIM905", "BLE001", "PLW1510", "S110"]
+ignore = ["SIM115", "SIM905", "BLE001", "PLW1510", "S110", "DTZ", "C408"]
 
 # vim:se sw=2:

{pystand-2.34 → pystand-2.36/pystand.egg-info}/PKG-INFO

@@ -1,12 +1,11 @@
 Metadata-Version: 2.4
 Name: pystand
-Version: 2.34
+Version: 2.36
 Summary: Install Python versions from python-build-standalone project
 Author-email: Mark Blakeney <mark.blakeney@bullet-systems.net>
 License-Expression: GPL-3.0-or-later
 Project-URL: Homepage, https://github.com/bulletmark/pystand
 Keywords: python-build-standalone,pyenv,hatch,pdm
-Classifier: Programming Language :: Python :: 3
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 Requires-Dist: packaging
@@ -141,10 +140,10 @@ Type `pystand` or `pystand -h` to view the usage summary:
 
 ```
 usage: pystand [-h] [-D DISTRIBUTION] [-P PREFIX_DIR] [-C CACHE_DIR]
-                  [-M CACHE_MINUTES] [--purge-days PURGE_DAYS]
-                  [--github-access-token GITHUB_ACCESS_TOKEN] [--no-strip]
-                  [--no-color] [--cert {system,certifi,none}] [-V]
-                  {install,i,update,u,up,remove,r,rm,list,l,show,s,path,p,cache,c,uv,uvx} ...
+               [-M CACHE_MINUTES] [--purge-days PURGE_DAYS]
+               [--github-access-token GITHUB_ACCESS_TOKEN] [--no-strip]
+               [--no-color] [--cert {system,certifi,none}] [-V]
+               {install,i,update,u,up,remove,r,rm,list,l,show,s,path,p,cache,c,uv,uvx} ...
 
 Command line tool to download, install, and update pre-built Python versions
 from the python-build-standalone project at https://github.com/astral-
@@ -203,14 +202,13 @@ Some commands offer aliases as shown in parentheses above. Note you can set
 default starting global options in ~/.config/pystand-flags.conf.
 ```
 
-Type `pystand <command> -h` to see specific help/usage for any
-individual command:
+Type `pystand <command> -h` to see specific help/usage for any individual command:
 
 ### Command `install`
 
 ```
 usage: pystand install [-h] [-r RELEASE] [-a] [-A] [--skip] [-f] [-s]
-                          [version ...]
+                       [version ...]
 
 Install one, more, or all versions from a python-build-standalone release.
 
@@ -239,7 +237,7 @@ aliases: i
 
 ```
 usage: pystand update [-h] [-r RELEASE] [-a] [--pre-release] [--skip] [-k]
-                         [version ...]
+                      [version ...]
 
 Update one, more, or all versions to another release.
 
@@ -378,7 +376,7 @@ aliases: c
 
 ```
 usage: pystand uv [-h] [-p PYTHON]
-                     command [subcommand] [uv_args_for_command ...]
+                  command [subcommand] [uv_args_for_command ...]
 
 Run a uv command using a version of python installed by pystand.
 

pystand-2.36/pystand.egg-info/scm_version.json

@@ -0,0 +1,8 @@
+{
+  "tag": "2.36",
+  "distance": 0,
+  "node": "g4d3f67f4313887dc9ada0e74d5186f253c66c1f0",
+  "dirty": false,
+  "branch": "main",
+  "node_date": "2026-09-04"
+}

{pystand-2.34 → pystand-2.36}/pystand.py

@@ -10,6 +10,7 @@ import itertools
 import os
 import platform
 import re
+import shlex
 import shutil
 import ssl
 import subprocess
@@ -254,7 +255,7 @@ def fetch(args: Namespace, release: str, url: str, tdir: Path) -> str | None:
         else:
             pdir = tmpdir / 'python'
             idir = pdir / 'install'
-            if idir.exists():
+            if idir.is_dir():
                 # This is a source distribution, copy the source if
                 # requested
                 if args.include_source:
@@ -266,7 +267,10 @@ def fetch(args: Namespace, release: str, url: str, tdir: Path) -> str | None:
 
                 pdir = idir
 
-            pdir.replace(tdir)
+            if pdir.is_dir():
+                pdir.replace(tdir)
+            else:
+                error = f'Failed to find unpacked python directory in "{url}".'
 
     rm_path(tmpdir)
     return error
@@ -447,7 +451,10 @@ def add_file(files: dict[str, Any], tag: str, name: str, url: str) -> None:
     else:
         return
 
-    impl, ver, arch = name.split('-', 2)
+    try:
+        impl, ver, arch = name.split('-', 2)
+    except ValueError:
+        return
 
     # Modern releases have a '+' in the name to separate the version
     if '+' in ver:
@@ -574,7 +581,7 @@ def purge_unused_releases(args: Namespace) -> None:
         for path in args._releases.iterdir():
             if path.name not in keep:
                 if (path.stat().st_mtime + end_secs) < now_secs:
-                    path.unlink()
+                    rm_path(path)
                 else:
                     keep.add(path.name)
 
@@ -587,11 +594,14 @@ def purge_unused_releases(args: Namespace) -> None:
 
 def show_list(args: Namespace) -> None:
     "Show a list of available releases"
-    latest = parse_version(args._release)
+    try:
+        latest = parse_version(args._release)
+    except InvalidVersion:
+        latest = None
     releases = fetch_tags(args)
     cached = {p.name for p in args._releases.iterdir()}
     for release in sorted(cached.union(releases)):
-        if args.re_match and not re.search(args.re_match, release):
+        if args._re_match and not args._re_match.search(release):
             continue
 
         # Ignore any bogus releases that don't parse as versions
@@ -602,6 +612,7 @@ def show_list(args: Namespace) -> None:
             continue
 
         if dt_str := releases.get(release):
+            dt_str = dt_str.replace('Z', '+00:00')
             dts = (
                 datetime.fromisoformat(dt_str)
                 .astimezone()
@@ -617,20 +628,20 @@ def show_list(args: Namespace) -> None:
         else:
             app = ''
 
-        pre = ' pre-release' if this_version > latest else ''
+        pre = ' pre-release' if (latest and this_version > latest) else ''
         print(f'{release} {dts}{app}{pre}')
 
 
-def get_title(desc: str) -> str:
-    "Return single title line from description"
+def get_title(desc: str, name: str) -> str:
+    "Return single title line from command description"
     res = []
     for line in desc.splitlines():
-        line = line.strip()
-        res.append(line)
-        if line.endswith('.'):
-            return ' '.join(res)
+        if line := line.strip():
+            res.append(line)
+            if line.endswith('.'):
+                return ' '.join(res)
 
-    sys.exit('Must end description with a full stop.')
+    sys.exit(f'Must end {name} command description with a full stop.')
 
 
 def remove(args: Namespace, version: str) -> None:
@@ -642,7 +653,9 @@ def remove(args: Namespace, version: str) -> None:
     # Touch the associated release file to ensure it lives until the
     # full purge time has expired if this was the last version using it
     if release := get_json(vdir / args._data).get('release'):
-        (args._releases / release).touch()
+        release_file = args._releases / release
+        if release_file.is_file():
+            release_file.touch()
 
     shutil.rmtree(vdir)
 
@@ -660,17 +673,44 @@ def strip_binaries(vdir: Path, distribution: str) -> bool:
 
             for file in base.iterdir():
                 if not file.is_symlink() and file.is_file():
-                    cmd = f'strip -p --strip-unneeded {file}'.split()
+                    cmd = ('strip', '-p', '--strip-unneeded', file)
                     try:
-                        subprocess.run(cmd, stderr=subprocess.DEVNULL)
+                        res = subprocess.run(cmd, stderr=subprocess.DEVNULL)
                     except Exception:
                         pass
                     else:
-                        was_stripped = True
+                        was_stripped |= res.returncode == 0
 
     return was_stripped
 
 
+def find_python(vdir: Path) -> Path | None:
+    "Find the python executable in a version directory"
+    for path in (vdir / 'bin' / 'python', vdir / 'python.exe'):
+        if path.is_file():
+            return path
+
+    return None
+
+
+def compile_bytecode(srcdir: Path, tgtdir: Path) -> str | None:
+    "Compile all Python bytecode in a version directory"
+    if not (python := find_python(srcdir)):
+        return f'Python executable not found in {srcdir}'
+
+    cmd = (python, '-m', 'compileall', '-qd', str(tgtdir), str(srcdir))
+
+    try:
+        res = subprocess.run(cmd)
+    except Exception as e:
+        return f'Compile error: {e}'
+
+    if res.returncode != 0:
+        return f'Compile error code: {res.returncode}'
+
+    return None
+
+
 def install(
     args: Namespace, vdir: Path, release: str, distribution: str, files: dict[str, Any]
 ) -> str | None:
@@ -694,6 +734,11 @@ def install(
 
         if error := set_json(tmpdir / args._data, data):
             error = f'Failed to write {version} data file: {error}'
+        elif c_error := compile_bytecode(tmpdir, vdir):
+            print(
+                f'Warning: Error compiling bytecode for {version}: {c_error}',
+                file=sys.stderr,
+            )
 
     if error:
         shutil.rmtree(tmpdir)
@@ -765,7 +810,10 @@ def run_uv(args: Namespace, cmd: list[str], cmdopts: list[str]) -> str | None:
         py = py.resolve()
         py = py.with_name(py.stem)
 
-    subprocess.run(cmd + ['-p', py] + cmdopts)
+    cmd = cmd + ['-p', str(py)] + cmdopts
+    res = subprocess.run(cmd)
+    if res.returncode != 0:
+        return f'Command "{shlex.join(cmd)}" failed with exit code {res.returncode}.'
 
 
 def main() -> str | None:
@@ -856,7 +904,7 @@ def main() -> str | None:
             return f'Must define a docstring for command class "{name}".'
 
         aliases = cls.aliases if hasattr(cls, 'aliases') else ()
-        title = get_title(desc)
+        title = get_title(desc, name)
         cmdopt = cmd.add_parser(name, description=desc, help=title, aliases=aliases)
 
         # Set up this commands own arguments, if it has any
@@ -1028,7 +1076,7 @@ class update_:
         parser.add_argument(
             '-r',
             '--release',
-            help='update to specified YYYMMDD release (e.g. '
+            help='update to specified YYYYMMDD release (e.g. '
             f'{SAMPL_RELEASE}), default is latest release',
         )
         parser.add_argument(
@@ -1134,7 +1182,7 @@ class remove_:
             '-r',
             '--release',
             help='only remove versions if from specified '
-            f'YYYMMDD release (e.g. {SAMPL_RELEASE})',
+            f'YYYYMMDD release (e.g. {SAMPL_RELEASE})',
         )
         parser.add_argument(
             'version', nargs='*', help='version to remove (or to skip for --all --skip)'
@@ -1277,11 +1325,19 @@ class show_:
 
     @staticmethod
     def run(args: Namespace) -> str | None:
+        re_match: re.Pattern | None = None
+        if args.re_match:
+            try:
+                re_match = re.compile(args.re_match)
+            except re.error as error:
+                args.parser.error(f'Invalid regular expression: {error}')
+
         if args.all and args.list:
             args.parser.error('Can not specify --all with --list.')
 
         if args.list:
             args.release = False
+            args._re_match = re_match
             show_list(args)
             return None
 
@@ -1305,9 +1361,7 @@ class show_:
                     if distribution == args._distribution:
                         installable = True
 
-                    if not args.re_match or re.search(
-                        args.re_match, f'{version}+{distribution}'
-                    ):
+                    if not re_match or re_match.search(f'{version}+{distribution}'):
                         print(
                             f'{args._fmtrel(version, release)} '
                             f'{args._fmtdist(distribution)}{app}'
@@ -1361,13 +1415,8 @@ class path_:
             if args.resolve:
                 path = path.resolve()
 
-            if args.python_path:
-                basepath = path
-                path = basepath / 'bin' / 'python'
-                if not path.exists():
-                    path = basepath / 'python.exe'
-                    if not path.exists():
-                        return f'Error: Can not find python executable in "{basepath}"'
+            if args.python_path and not (path := find_python(basepath := path)):
+                return f'Error: Can not find python executable in "{basepath}"'
 
             print(path)
 
@@ -1439,6 +1488,10 @@ class cache_:
             for release in args.release:
                 # Allow user to include cache path in release name
                 path = (args._downloads / release).expanduser()
+                if not path.is_dir():
+                    print(f'No caches found for release {release}.', file=sys.stderr)
+                    continue
+
                 release = path.name
 
                 if err := check_release_tag(release):

pystand-2.34/pystand.egg-info/scm_version.json

@@ -1,8 +0,0 @@
-{
-  "tag": "2.34",
-  "distance": 0,
-  "node": "ge147d95a4c421da907727e05ae933d512bcd48fb",
-  "dirty": false,
-  "branch": "main",
-  "node_date": "2026-08-10"
-}