pystand 2.33__tar.gz → 2.34__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pystand
-Version: 2.33
+Version: 2.34
 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
@@ -15,7 +15,7 @@ Requires-Dist: argparse-from-file
 Requires-Dist: pygithub
 Requires-Dist: certifi
 Requires-Dist: filelock
-Requires-Dist: zstandard; python_version < "3.14"
+Requires-Dist: backports.zstd; python_version < "3.14"
 
 ## PYSTAND - Install Python Versions From The Python-Build-Standalone Project
 [![PyPi](https://img.shields.io/pypi/v/pystand)](https://pypi.org/project/pystand/)
@@ -172,7 +172,7 @@ options:
   --purge-days PURGE_DAYS
                         cache YYYYMMDD release file lists and downloads for
                         this number of days after last version referencing
-                        that release is removed. Default is 90 days.
+                        that release is removed. Default is 30 days.
   --github-access-token GITHUB_ACCESS_TOKEN
                         optional Github access token. Can specify to reduce
                         rate limiting.
@@ -215,13 +215,13 @@ usage: pystand install [-h] [-r RELEASE] [-a] [-A] [--skip] [-f] [-s]
 Install one, more, or all versions from a python-build-standalone release.
 
 positional arguments:
-  version               version to install. E.g. 3.12 or 3.12.3
+  version               version to install. E.g. 3.14 or 3.14.1
 
 options:
   -h, --help            show this help message and exit
   -r, --release RELEASE
                         install from specified python-build-standalone
-                        YYYYMMDD release (e.g. 20240415), default is latest
+                        YYYYMMDD release (e.g. 20260807), default is latest
                         release
   -a, --all             install ALL versions from release
   -A, --all-prerelease  install ALL versions from release, including pre-
@@ -249,7 +249,7 @@ positional arguments:
 options:
   -h, --help            show this help message and exit
   -r, --release RELEASE
-                        update to specified YYYMMDD release (e.g. 20240415),
+                        update to specified YYYMMDD release (e.g. 20260807),
                         default is latest release
   -a, --all             update ALL versions
   --pre-release         update release version to a later superceding pre-
@@ -279,7 +279,7 @@ options:
                         can be specified with --all)
   -r, --release RELEASE
                         only remove versions if from specified YYYMMDD release
-                        (e.g. 20240415)
+                        (e.g. 20260807)
 
 aliases: r, rm
 ```
@@ -299,7 +299,7 @@ options:
   -v, --verbose         explicitly report why a version is not eligible for
                         update
   -r, --release RELEASE
-                        use specified YYYYMMDD release (e.g. 20240415) for
+                        use specified YYYYMMDD release (e.g. 20260807) for
                         verbose compare, default is latest release
 
 aliases: l
@@ -323,7 +323,7 @@ options:
   -l, --list            just list recent releases
   -r, --release RELEASE
                         python-build-standalone YYYYMMDD release to show (e.g.
-                        20240415), default is latest release
+                        20260807), default is latest release
   -a, --all             show all available distributions for each version from
                         the release
 
@@ -390,7 +390,7 @@ positional arguments:
 
 options:
   -h, --help           show this help message and exit
-  -p, --python PYTHON  version of python to use, e.g. "3.12", default is
+  -p, --python PYTHON  version of python to use, e.g. "3.14", default is
                        latest release version
 ```
 
@@ -408,7 +408,7 @@ positional arguments:
 
 options:
   -h, --help            show this help message and exit
-  -p, --python PYTHON   version of python to use, e.g. "3.12", default is
+  -p, --python PYTHON   version of python to use, e.g. "3.14", default is
                         latest release version
 ```
 

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

@@ -153,7 +153,7 @@ options:
   --purge-days PURGE_DAYS
                         cache YYYYMMDD release file lists and downloads for
                         this number of days after last version referencing
-                        that release is removed. Default is 90 days.
+                        that release is removed. Default is 30 days.
   --github-access-token GITHUB_ACCESS_TOKEN
                         optional Github access token. Can specify to reduce
                         rate limiting.
@@ -196,13 +196,13 @@ usage: pystand install [-h] [-r RELEASE] [-a] [-A] [--skip] [-f] [-s]
 Install one, more, or all versions from a python-build-standalone release.
 
 positional arguments:
-  version               version to install. E.g. 3.12 or 3.12.3
+  version               version to install. E.g. 3.14 or 3.14.1
 
 options:
   -h, --help            show this help message and exit
   -r, --release RELEASE
                         install from specified python-build-standalone
-                        YYYYMMDD release (e.g. 20240415), default is latest
+                        YYYYMMDD release (e.g. 20260807), default is latest
                         release
   -a, --all             install ALL versions from release
   -A, --all-prerelease  install ALL versions from release, including pre-
@@ -230,7 +230,7 @@ positional arguments:
 options:
   -h, --help            show this help message and exit
   -r, --release RELEASE
-                        update to specified YYYMMDD release (e.g. 20240415),
+                        update to specified YYYMMDD release (e.g. 20260807),
                         default is latest release
   -a, --all             update ALL versions
   --pre-release         update release version to a later superceding pre-
@@ -260,7 +260,7 @@ options:
                         can be specified with --all)
   -r, --release RELEASE
                         only remove versions if from specified YYYMMDD release
-                        (e.g. 20240415)
+                        (e.g. 20260807)
 
 aliases: r, rm
 ```
@@ -280,7 +280,7 @@ options:
   -v, --verbose         explicitly report why a version is not eligible for
                         update
   -r, --release RELEASE
-                        use specified YYYYMMDD release (e.g. 20240415) for
+                        use specified YYYYMMDD release (e.g. 20260807) for
                         verbose compare, default is latest release
 
 aliases: l
@@ -304,7 +304,7 @@ options:
   -l, --list            just list recent releases
   -r, --release RELEASE
                         python-build-standalone YYYYMMDD release to show (e.g.
-                        20240415), default is latest release
+                        20260807), default is latest release
   -a, --all             show all available distributions for each version from
                         the release
 
@@ -371,7 +371,7 @@ positional arguments:
 
 options:
   -h, --help           show this help message and exit
-  -p, --python PYTHON  version of python to use, e.g. "3.12", default is
+  -p, --python PYTHON  version of python to use, e.g. "3.14", default is
                        latest release version
 ```
 
@@ -389,7 +389,7 @@ positional arguments:
 
 options:
   -h, --help            show this help message and exit
-  -p, --python PYTHON   version of python to use, e.g. "3.12", default is
+  -p, --python PYTHON   version of python to use, e.g. "3.14", default is
                         latest release version
 ```
 

{pystand-2.33 → pystand-2.34}/check-dist.py

@@ -1,4 +1,3 @@
-#!/usr/bin/python
 import re
 import subprocess
 import sys
@@ -7,7 +6,7 @@ import pystand
 
 cmd = 'pystand show --all'.split()
 out = subprocess.run(cmd, capture_output=True, text=True).stdout
-alldists = set(re.sub(r'.+"(.+)".*', r'\1', ln) for ln in out.splitlines())
+alldists = {re.sub(r'.+"(.+)".*', r'\1', ln) for ln in out.splitlines()}
 
 error = 0
 for mach, dist in pystand.DISTRIBUTIONS.items():

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

@@ -20,7 +20,7 @@ dependencies = [
   "pygithub",
   "certifi",
   "filelock",
-  "zstandard; python_version < '3.14'",
+  "backports.zstd; python_version < '3.14'",
 ]
 
 [[project.authors]]
@@ -45,13 +45,8 @@ ignore_missing_imports = true
 
 [tool.ruff.format]
 quote-style = "single"
-skip-magic-trailing-comma = true
 
-[tool.edit-lint]
-linters = [
-  "ruff check",
-  "mypy",
-  "pyright",
-]
+[tool.ruff.lint]
+ignore = ["SIM115", "SIM905", "BLE001", "PLW1510", "S110"]
 
 # vim:se sw=2:

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pystand
-Version: 2.33
+Version: 2.34
 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
@@ -15,7 +15,7 @@ Requires-Dist: argparse-from-file
 Requires-Dist: pygithub
 Requires-Dist: certifi
 Requires-Dist: filelock
-Requires-Dist: zstandard; python_version < "3.14"
+Requires-Dist: backports.zstd; python_version < "3.14"
 
 ## PYSTAND - Install Python Versions From The Python-Build-Standalone Project
 [![PyPi](https://img.shields.io/pypi/v/pystand)](https://pypi.org/project/pystand/)
@@ -172,7 +172,7 @@ options:
   --purge-days PURGE_DAYS
                         cache YYYYMMDD release file lists and downloads for
                         this number of days after last version referencing
-                        that release is removed. Default is 90 days.
+                        that release is removed. Default is 30 days.
   --github-access-token GITHUB_ACCESS_TOKEN
                         optional Github access token. Can specify to reduce
                         rate limiting.
@@ -215,13 +215,13 @@ usage: pystand install [-h] [-r RELEASE] [-a] [-A] [--skip] [-f] [-s]
 Install one, more, or all versions from a python-build-standalone release.
 
 positional arguments:
-  version               version to install. E.g. 3.12 or 3.12.3
+  version               version to install. E.g. 3.14 or 3.14.1
 
 options:
   -h, --help            show this help message and exit
   -r, --release RELEASE
                         install from specified python-build-standalone
-                        YYYYMMDD release (e.g. 20240415), default is latest
+                        YYYYMMDD release (e.g. 20260807), default is latest
                         release
   -a, --all             install ALL versions from release
   -A, --all-prerelease  install ALL versions from release, including pre-
@@ -249,7 +249,7 @@ positional arguments:
 options:
   -h, --help            show this help message and exit
   -r, --release RELEASE
-                        update to specified YYYMMDD release (e.g. 20240415),
+                        update to specified YYYMMDD release (e.g. 20260807),
                         default is latest release
   -a, --all             update ALL versions
   --pre-release         update release version to a later superceding pre-
@@ -279,7 +279,7 @@ options:
                         can be specified with --all)
   -r, --release RELEASE
                         only remove versions if from specified YYYMMDD release
-                        (e.g. 20240415)
+                        (e.g. 20260807)
 
 aliases: r, rm
 ```
@@ -299,7 +299,7 @@ options:
   -v, --verbose         explicitly report why a version is not eligible for
                         update
   -r, --release RELEASE
-                        use specified YYYYMMDD release (e.g. 20240415) for
+                        use specified YYYYMMDD release (e.g. 20260807) for
                         verbose compare, default is latest release
 
 aliases: l
@@ -323,7 +323,7 @@ options:
   -l, --list            just list recent releases
   -r, --release RELEASE
                         python-build-standalone YYYYMMDD release to show (e.g.
-                        20240415), default is latest release
+                        20260807), default is latest release
   -a, --all             show all available distributions for each version from
                         the release
 
@@ -390,7 +390,7 @@ positional arguments:
 
 options:
   -h, --help           show this help message and exit
-  -p, --python PYTHON  version of python to use, e.g. "3.12", default is
+  -p, --python PYTHON  version of python to use, e.g. "3.14", default is
                        latest release version
 ```
 
@@ -408,7 +408,7 @@ positional arguments:
 
 options:
   -h, --help            show this help message and exit
-  -p, --python PYTHON   version of python to use, e.g. "3.12", default is
+  -p, --python PYTHON   version of python to use, e.g. "3.14", default is
                         latest release version
 ```
 

{pystand-2.33 → pystand-2.34}/pystand.egg-info/SOURCES.txt

@@ -9,4 +9,6 @@ pystand.egg-info/SOURCES.txt
 pystand.egg-info/dependency_links.txt
 pystand.egg-info/entry_points.txt
 pystand.egg-info/requires.txt
+pystand.egg-info/scm_file_list.json
+pystand.egg-info/scm_version.json
 pystand.egg-info/top_level.txt

{pystand-2.33 → pystand-2.34}/pystand.egg-info/requires.txt

@@ -6,4 +6,4 @@ certifi
 filelock
 
 [:python_version < "3.14"]
-zstandard
+backports.zstd

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

@@ -0,0 +1,10 @@
+{
+  "files": [
+    ".gitignore",
+    "README.md",
+    "check-dist.py",
+    "justfile",
+    "pyproject.toml",
+    "pystand.py"
+  ]
+}

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

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

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

@@ -1,4 +1,3 @@
-#!/usr/bin/python3
 """
 Command line tool to download, install, and update pre-built Python
 versions from the python-build-standalone project at
@@ -35,11 +34,13 @@ GITHUB_SITE = f'https://github.com/{GITHUB_REPO}'
 LATEST_RELEASES = f'{GITHUB_SITE}/releases.atom'
 LATEST_RELEASE_TAG = f'{GITHUB_SITE}/releases/latest'
 DOC = 'https://gregoryszorc.com/docs/python-build-standalone/main/'
+VER = f'{sys.version_info.major}.{sys.version_info.minor}'
 
 # Sample release tag for documentation/usage examples
-SAMPL_RELEASE = '20240415'
+SAMPL_RELEASE = '20260807'
 
 PROG = Path(__file__).stem
+HOME = Path.home()
 
 # Default distributions for various platforms
 DISTRIBUTIONS = {
@@ -114,10 +115,10 @@ class ColorDist(ColorTable):
         return text.split('-', 1)[0]
 
 
-def unexpanduser(path: Path, *, home=Path.home()) -> Path:
+def unexpanduser(path: Path) -> Path:
     "Return path name, with $HOME replaced by ~ (opposite of Path.expanduser())"
-    if path.parts[: len(home.parts)] == home.parts:
-        return Path('~', *path.parts[len(home.parts) :])
+    if path.parts[: len(HOME.parts)] == HOME.parts:
+        return Path('~', *path.parts[len(HOME.parts) :])
 
     return path
 
@@ -215,23 +216,6 @@ def rm_path(path: Path) -> bool:
     return True
 
 
-def register_zst() -> None:
-    "Register custom zstandard unpacker"
-    import tarfile
-
-    from zstandard import ZstdDecompressor
-
-    def unpack_zst(filename: str, extract_dir: str) -> None:
-        "Unpack a zstandard compressed tar"
-        with open(filename, 'rb') as compressed:
-            dctx = ZstdDecompressor()
-            with dctx.stream_reader(compressed) as reader:
-                with tarfile.open(fileobj=reader, mode='r|') as tar:
-                    tar.extractall(path=extract_dir)
-
-    shutil.register_unpack_format('zst', ['.zst'], unpack_zst)
-
-
 def fetch(args: Namespace, release: str, url: str, tdir: Path) -> str | None:
     "Fetch and unpack a release file"
     from urllib.parse import unquote, urlparse
@@ -256,9 +240,12 @@ def fetch(args: Namespace, release: str, url: str, tdir: Path) -> str | None:
     if error:
         rm_path(cache_file)
     else:
-        # Register custom zstandard handler (only if Python < 3.14 which has built-in support)
-        if filename.endswith('.zst') and sys.version_info < (3, 14):
-            register_zst()
+        # Register external zstd handler (only if Python < 3.14 which has
+        # built-in support)
+        if filename.lower().endswith('.zst') and sys.version_info < (3, 14):
+            from backports.zstd import register_shutil  # type: ignore
+
+            register_shutil()
 
         try:
             shutil.unpack_archive(cache_file, tmpdir)
@@ -307,9 +294,9 @@ class VersionMatcher:
 
         # If no version specified, return the latest release version
         if not version:
-            for version in self.seq:
-                if is_release_version(version):
-                    return version
+            for ver in self.seq:
+                if is_release_version(ver):
+                    return ver
             return None
 
         if version in self.seq:
@@ -329,9 +316,10 @@ class VersionMatcher:
         # Only allow upgrade of formal release to another formal
         # release.
         for full_version in self.seq:
-            if full_version.startswith(version):
-                if not upgrade or not is_release or is_release_version(full_version):
-                    return full_version
+            if full_version.startswith(version) and (
+                not upgrade or not is_release or is_release_version(full_version)
+            ):
+                return full_version
 
         return None
 
@@ -362,7 +350,7 @@ def get_version_names(args: Namespace) -> list[str]:
         if not args.version:
             args.parser.error('Must specify at least one version, or --all.')
 
-    all_names = set(f.name for f in iter_versions(args))
+    all_names = {f.name for f in iter_versions(args)}
 
     # Upconvert all user specified partial version names to full version names
     matcher = VersionMatcher(all_names)
@@ -492,7 +480,7 @@ def get_release_files(args, tag) -> dict[str, Any]:
         try:
             release = gh.get_repo(GITHUB_REPO).get_release(tag)
         except Exception as e:
-            print(f'Error: {str(e)}', file=sys.stderr)
+            print(f'Error: {e}', file=sys.stderr)
             return {}
 
         # Iterate over the release assets and store pertinent files in a
@@ -527,7 +515,7 @@ def update_version_symlinks(args: Namespace) -> None:
 
     # Create a map of all the new major version links
     newlinks_all = defaultdict(set)
-    pre_releases = set(v for v in vers if not is_release_version(v))
+    pre_releases = {v for v in vers if not is_release_version(v)}
     for namevers in vers:
         while '.' in namevers[:-1]:
             namevers_major = namevers.rsplit('.', maxsplit=1)[0]
@@ -546,7 +534,7 @@ def update_version_symlinks(args: Namespace) -> None:
         if ver in pre_releases and (rels := (cands - pre_releases)):
             cands = rels
 
-        newlinks[ver] = sorted(cands, key=parse_version)[-1]
+        newlinks[ver] = max(cands, key=parse_version)
 
     # Remove all old or invalid existing links
     for name, tgt in oldlinks.items():
@@ -601,7 +589,7 @@ def show_list(args: Namespace) -> None:
     "Show a list of available releases"
     latest = parse_version(args._release)
     releases = fetch_tags(args)
-    cached = set(p.name for p in args._releases.iterdir())
+    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):
             continue
@@ -826,7 +814,7 @@ def main() -> str | None:
     )
     opt.add_argument(
         '--purge-days',
-        default=90,
+        default=30,
         type=int,
         help='cache YYYYMMDD release file lists and downloads for '
         'this number of days after last version referencing that '
@@ -867,7 +855,7 @@ def main() -> str | None:
         else:
             return f'Must define a docstring for command class "{name}".'
 
-        aliases = cls.aliases if hasattr(cls, 'aliases') else []
+        aliases = cls.aliases if hasattr(cls, 'aliases') else ()
         title = get_title(desc)
         cmdopt = cmd.add_parser(name, description=desc, help=title, aliases=aliases)
 
@@ -933,7 +921,7 @@ def main() -> str | None:
 # COMMAND
 class install_:
     doc = f'Install one, more, or all versions from a {REPO} release.'
-    aliases = ['i']
+    aliases = ('i',)
 
     @staticmethod
     def init(parser: ArgumentParser) -> None:
@@ -972,7 +960,7 @@ class install_:
             help='also install source files if available in distribution download',
         )
         parser.add_argument(
-            'version', nargs='*', help='version to install. E.g. 3.12 or 3.12.3'
+            'version', nargs='*', help=f'version to install. E.g. {VER} or {VER}.1'
         )
 
     @staticmethod
@@ -993,7 +981,7 @@ class install_:
                     'Can not specify versions with --all unless also specifying --skip.'
                 )
 
-            skips = set(v for ver in args.version if (v := matcher.match(ver)))
+            skips = {v for ver in args.version if (v := matcher.match(ver))}
 
             args.version = [
                 v
@@ -1033,7 +1021,7 @@ class install_:
 class update_:
     "Update one, more, or all versions to another release."
 
-    aliases = ['u', 'up']
+    aliases = ('u', 'up')
 
     @staticmethod
     def init(parser: ArgumentParser) -> None:
@@ -1129,7 +1117,7 @@ class update_:
 class remove_:
     "Remove/uninstall one, more, or all versions."
 
-    aliases = ['r', 'rm']
+    aliases = ('r', 'rm')
 
     @staticmethod
     def init(parser: ArgumentParser) -> None:
@@ -1170,7 +1158,7 @@ class remove_:
 class list_:
     "List installed versions and show which have an update available."
 
-    aliases = ['l']
+    aliases = ('l',)
 
     @staticmethod
     def init(parser: ArgumentParser) -> None:
@@ -1260,7 +1248,7 @@ class show_:
     View available releases and their distributions at
     {GITHUB_SITE}/releases.
     """
-    aliases = ['s']
+    aliases = ('s',)
 
     @staticmethod
     def init(parser: ArgumentParser) -> None:
@@ -1335,7 +1323,7 @@ class show_:
 class path_:
     "Show path prefix to installed version base directory."
 
-    aliases = ['p']
+    aliases = ('p',)
 
     @staticmethod
     def init(parser: ArgumentParser) -> None:
@@ -1388,7 +1376,7 @@ class path_:
 class cache_:
     "Show size of release download caches."
 
-    aliases = ['c']
+    aliases = ('c',)
 
     @staticmethod
     def init(parser: ArgumentParser) -> None:
@@ -1436,9 +1424,7 @@ class cache_:
                 )
 
             keep = keeplist(args)
-            releases = set(
-                p.name for p in args._downloads.iterdir() if p.name.isdigit()
-            )
+            releases = {p.name for p in args._downloads.iterdir() if p.name.isdigit()}
             releases.update(
                 p.name for p in args._releases.iterdir() if p.name.isdigit()
             )
@@ -1492,7 +1478,7 @@ class uv_:
         parser.add_argument(
             '-p',
             '--python',
-            help='version of python to use, e.g. "3.12", default is latest release version',
+            help=f'version of python to use, e.g. "{VER}", default is latest release version',
         )
 
         parser.add_argument('command', help='uv command to run')
@@ -1522,7 +1508,7 @@ class uvx_:
         parser.add_argument(
             '-p',
             '--python',
-            help='version of python to use, e.g. "3.12", default is latest release version',
+            help=f'version of python to use, e.g. "{VER}", default is latest release version',
         )
 
         parser.add_argument('program', help='uvx program to run')