pystand 2.35__tar.gz → 2.37__tar.gz

{pystand-2.35/pystand.egg-info → pystand-2.37}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: pystand
-Version: 2.35
+Version: 2.37
 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
-Requires-Python: >=3.8
+Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 Requires-Dist: packaging
 Requires-Dist: platformdirs
@@ -247,7 +247,7 @@ positional arguments:
 options:
   -h, --help            show this help message and exit
   -r, --release RELEASE
-                        update to specified YYYMMDD release (e.g. 20260807),
+                        update to specified YYYYMMDD release (e.g. 20260807),
                         default is latest release
   -a, --all             update ALL versions
   --pre-release         update release version to a later superceding pre-
@@ -276,8 +276,8 @@ options:
   --skip                skip the specified versions when removing all (only
                         can be specified with --all)
   -r, --release RELEASE
-                        only remove versions if from specified YYYMMDD release
-                        (e.g. 20260807)
+                        only remove versions if from specified YYYYMMDD
+                        release (e.g. 20260807)
 
 aliases: r, rm
 ```
@@ -412,7 +412,7 @@ options:
 
 ## Installation and Upgrade
 
-Python 3.8 or later is required. Arch Linux users can install [`pystand`
+Python 3.9 or later is required. Arch Linux users can install [`pystand`
 from the AUR](https://aur.archlinux.org/packages/pystand) and skip this
 section.
 

{pystand-2.35 → pystand-2.37}/README.md

@@ -229,7 +229,7 @@ positional arguments:
 options:
   -h, --help            show this help message and exit
   -r, --release RELEASE
-                        update to specified YYYMMDD release (e.g. 20260807),
+                        update to specified YYYYMMDD release (e.g. 20260807),
                         default is latest release
   -a, --all             update ALL versions
   --pre-release         update release version to a later superceding pre-
@@ -258,8 +258,8 @@ options:
   --skip                skip the specified versions when removing all (only
                         can be specified with --all)
   -r, --release RELEASE
-                        only remove versions if from specified YYYMMDD release
-                        (e.g. 20260807)
+                        only remove versions if from specified YYYYMMDD
+                        release (e.g. 20260807)
 
 aliases: r, rm
 ```
@@ -394,7 +394,7 @@ options:
 
 ## Installation and Upgrade
 
-Python 3.8 or later is required. Arch Linux users can install [`pystand`
+Python 3.9 or later is required. Arch Linux users can install [`pystand`
 from the AUR](https://aur.archlinux.org/packages/pystand) and skip this
 section.
 

{pystand-2.35 → pystand-2.37}/pyproject.toml

@@ -7,7 +7,7 @@ name = "pystand"
 description = "Install Python versions from python-build-standalone project"
 readme = "README.md"
 license = "GPL-3.0-or-later"
-requires-python = ">=3.8"
+requires-python = ">=3.9"
 keywords = ["python-build-standalone", "pyenv", "hatch", "pdm"]
 dynamic = ["version"]
 dependencies = [

{pystand-2.35 → pystand-2.37/pystand.egg-info}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: pystand
-Version: 2.35
+Version: 2.37
 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
-Requires-Python: >=3.8
+Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 Requires-Dist: packaging
 Requires-Dist: platformdirs
@@ -247,7 +247,7 @@ positional arguments:
 options:
   -h, --help            show this help message and exit
   -r, --release RELEASE
-                        update to specified YYYMMDD release (e.g. 20260807),
+                        update to specified YYYYMMDD release (e.g. 20260807),
                         default is latest release
   -a, --all             update ALL versions
   --pre-release         update release version to a later superceding pre-
@@ -276,8 +276,8 @@ options:
   --skip                skip the specified versions when removing all (only
                         can be specified with --all)
   -r, --release RELEASE
-                        only remove versions if from specified YYYMMDD release
-                        (e.g. 20260807)
+                        only remove versions if from specified YYYYMMDD
+                        release (e.g. 20260807)
 
 aliases: r, rm
 ```
@@ -412,7 +412,7 @@ options:
 
 ## Installation and Upgrade
 
-Python 3.8 or later is required. Arch Linux users can install [`pystand`
+Python 3.9 or later is required. Arch Linux users can install [`pystand`
 from the AUR](https://aur.archlinux.org/packages/pystand) and skip this
 section.
 

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

@@ -0,0 +1,8 @@
+{
+  "tag": "2.37",
+  "distance": 0,
+  "node": "g0c04602c6321af5be0ab5b6b6e0337415036645d",
+  "dirty": false,
+  "branch": "main",
+  "node_date": "2026-09-11"
+}

{pystand-2.35 → pystand-2.37}/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
@@ -426,15 +430,18 @@ def get_release_tag(args: Namespace) -> str:
 
         return release
 
-    if args._latest_release.exists():
-        stat = args._latest_release.stat()
-        if time.time() < (stat.st_mtime + int(args.cache_minutes * 60)):
-            return args._latest_release.read_text().strip()
+    latest_release = args._latest_release
+
+    if latest_release.is_file() and (
+        not args.check_latest
+        or time.time() < (latest_release.stat().st_mtime + int(args.cache_minutes * 60))
+    ):
+        return latest_release.read_text().strip()
 
     if not (tag := fetch_tag_latest(args)):
         sys.exit('Latest YYYYMMDD release tag timestamp file is unavailable.')
 
-    args._latest_release.write_text(tag + '\n')
+    latest_release.write_text(tag + '\n')
     return tag
 
 
@@ -559,8 +566,8 @@ def keeplist(args: Namespace) -> set[str]:
     }
 
     # Add current release to keep list (even if not currently installed)
-    if args._latest_release.exists():
-        keep.add(args._latest_release.read_text().strip())
+    if (latest_release := args._latest_release).exists():
+        keep.add(latest_release.read_text().strip())
 
     return keep
 
@@ -577,7 +584,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)
 
@@ -588,13 +595,16 @@ def purge_unused_releases(args: Namespace) -> None:
                 rm_path(path)
 
 
-def show_list(args: Namespace) -> None:
+def show_list(args: Namespace, re_match: re.Pattern | None) -> 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 args._re_match.search(release):
+        if re_match and not re_match.search(release):
             continue
 
         # Ignore any bogus releases that don't parse as versions
@@ -605,6 +615,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()
@@ -620,7 +631,7 @@ 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}')
 
 
@@ -636,7 +647,7 @@ def get_title(desc: str, name: str) -> str:
     sys.exit(f'Must end {name} command description with a full stop.')
 
 
-def remove(args: Namespace, version: str) -> None:
+def remove_version(args: Namespace, version: str) -> None:
     "Remove a version"
     vdir = args._versions / version
     if not vdir.exists():
@@ -665,7 +676,7 @@ 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:
                         res = subprocess.run(cmd, stderr=subprocess.DEVNULL)
                     except Exception:
@@ -703,7 +714,7 @@ def compile_bytecode(srcdir: Path, tgtdir: Path) -> str | None:
     return None
 
 
-def install(
+def install_version(
     args: Namespace, vdir: Path, release: str, distribution: str, files: dict[str, Any]
 ) -> str | None:
     "Install a version"
@@ -728,14 +739,14 @@ def install(
             error = f'Failed to write {version} data file: {error}'
         elif c_error := compile_bytecode(tmpdir, vdir):
             print(
-                f'Warning: Could not compile bytecode for {version}: {c_error}',
+                f'Warning: Error compiling bytecode for {version}: {c_error}',
                 file=sys.stderr,
             )
 
     if error:
         shutil.rmtree(tmpdir)
     else:
-        remove(args, version)
+        remove_version(args, version)
         tmpdir.replace(vdir)
 
     return error
@@ -802,7 +813,14 @@ 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}.'
+
+
+# List of internal command classes, populated by @Command decorator
+commands = []
 
 
 def main() -> str | None:
@@ -878,12 +896,8 @@ def main() -> str | None:
     cmd = opt.add_subparsers(title='Commands', dest='cmdname')
 
     # Add each command ..
-    for name in globals():
-        if not name[0].islower() or not name.endswith('_'):
-            continue
-
-        cls = globals()[name]
-        name = name[:-1]
+    for cls in commands:
+        name = cls.__name__.rstrip('_')
 
         if hasattr(cls, 'doc'):
             desc = cls.doc.strip()
@@ -901,7 +915,12 @@ def main() -> str | None:
             cls.init(cmdopt)
 
         # Set the function to call
-        cmdopt.set_defaults(func=cls.run, name=name, parser=cmdopt)
+        cmdopt.set_defaults(
+            func=cls.run,
+            name=name,
+            parser=cmdopt,
+            check_latest=getattr(cls, 'check_latest', False),
+        )
 
     args = opt.parse_args()
 
@@ -955,10 +974,17 @@ def main() -> str | None:
     return result
 
 
-# COMMAND
-class install_:
+def Command(command: type) -> type:
+    "Decorator to add given command class to list of commands"
+    commands.append(command)
+    return command
+
+
+@Command
+class install:
     doc = f'Install one, more, or all versions from a {REPO} release.'
     aliases = ('i',)
+    check_latest = True
 
     @staticmethod
     def init(parser: ArgumentParser) -> None:
@@ -1048,24 +1074,25 @@ class install_:
                 )
                 continue
 
-            if error := install(args, vdir, release, args._distribution, files):
+            if error := install_version(args, vdir, release, args._distribution, files):
                 return error
 
             print(f'Version {args._fmtrel(version, release)} installed.')
 
 
-# COMMAND
-class update_:
+@Command
+class update:
     "Update one, more, or all versions to another release."
 
     aliases = ('u', 'up')
+    check_latest = True
 
     @staticmethod
     def init(parser: ArgumentParser) -> None:
         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(
@@ -1143,15 +1170,17 @@ class update_:
             # the update.
             args.include_source = (vdir / 'src').is_dir()
 
-            if error := install(args, new_vdir, release_target, distribution, files):
+            if error := install_version(
+                args, new_vdir, release_target, distribution, files
+            ):
                 return error
 
             if nextver != version and not args.keep:
-                remove(args, version)
+                remove_version(args, version)
 
 
-# COMMAND
-class remove_:
+@Command
+class remove:
     "Remove/uninstall one, more, or all versions."
 
     aliases = ('r', 'rm')
@@ -1171,7 +1200,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)'
@@ -1192,10 +1221,12 @@ class remove_:
 
 
 # COMMAND
+@Command
 class list_:
     "List installed versions and show which have an update available."
 
     aliases = ('l',)
+    check_latest = True
 
     @staticmethod
     def init(parser: ArgumentParser) -> None:
@@ -1278,7 +1309,8 @@ class list_:
 
 
 # COMMAND
-class show_:
+@Command
+class show:
     doc = f"""
     Show versions available from a release.
 
@@ -1286,6 +1318,7 @@ class show_:
     {GITHUB_SITE}/releases.
     """
     aliases = ('s',)
+    check_latest = True
 
     @staticmethod
     def init(parser: ArgumentParser) -> None:
@@ -1321,13 +1354,11 @@ class show_:
             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)
+            if args.all:
+                args.parser.error('Can not specify --all with --list.')
+
+            show_list(args, re_match)
             return None
 
         release = args._release
@@ -1362,8 +1393,8 @@ class show_:
             )
 
 
-# COMMAND
-class path_:
+@Command
+class path:
     "Show path prefix to installed version base directory."
 
     aliases = ('p',)
@@ -1410,8 +1441,8 @@ class path_:
             print(path)
 
 
-# COMMAND
-class cache_:
+@Command
+class cache:
     "Show size of release download caches."
 
     aliases = ('c',)
@@ -1477,6 +1508,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):
@@ -1507,8 +1542,8 @@ class cache_:
                 show_cache_size(args._downloads, args)
 
 
-# COMMAND
-class uv_:
+@Command
+class uv:
     __doc__ = f'Run a uv command using a version of python installed by {PROG}.'
 
     @staticmethod
@@ -1537,8 +1572,8 @@ class uv_:
         return run_uv(args, cmd, args.uv_args_for_command)
 
 
-# COMMAND
-class uvx_:
+@Command
+class uvx:
     __doc__ = f'Run a program using uvx and a version of python installed by {PROG}.'
 
     @staticmethod

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

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