pystand 1.11__py3-none-any.whl → 2.0__py3-none-any.whl

{pystand-1.11.dist-info → pystand-2.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pystand
-Version: 1.11
+Version: 2.0
 Summary: Install Python versions from python-build-standalone project
 Author-email: Mark Blakeney <mark.blakeney@bullet-systems.net>
 License: GPLv3
@@ -13,6 +13,7 @@ Requires-Dist: argcomplete
 Requires-Dist: packaging
 Requires-Dist: platformdirs
 Requires-Dist: pygithub
+Requires-Dist: zstandard
 
 ## PYSTAND - Install Python Versions From The Python-Build-Standalone Project
 [![PyPi](https://img.shields.io/pypi/v/pystand)](https://pypi.org/project/pystand/)
@@ -33,11 +34,15 @@ provided:
 |`path`   |Show path prefix to installed version base directory                  |
 
 By default, Python versions are sourced from the latest
-`python-build-standalone` [release][pbs-rel] available (e.g. "`20240415`") but you can
-optionally specify any older release. The required
+`python-build-standalone` [release][pbs-rel] available (e.g.
+"`20240415`") but you can optionally specify any older release. The
+required
 [distribution](https://gregoryszorc.com/docs/python-build-standalone/main/running.html)
-for your machine architecture is normally auto-detected but can be
-overridden if required.
+for your machine architecture is normally auto-detected. By default, the
+_`install_only_stripped`_ build of the distribution is installed but you
+can choose to [install any other
+build/distribution](#installing-other-builds/distributions) instead, or
+in parallel.
 
 Some simple usage examples are:
 
@@ -66,21 +71,21 @@ $ pystand install 3.10
 Version 3.10.14 @ 20240415 installed.
 
 $ pystand list
-3.10.14 @ 20240415 distribution="x86_64-unknown-linux-gnu"
-3.12.3 @ 20240415 distribution="x86_64-unknown-linux-gnu"
+3.10.14 @ 20240415 distribution="x86_64-unknown-linux-gnu-install_only_stripped"
+3.12.3 @ 20240415 distribution="x86_64-unknown-linux-gnu-install_only_stripped"
 
 $ pystand show
-3.8.19 @ 20240415 distribution="x86_64-unknown-linux-gnu"
-3.9.19 @ 20240415 distribution="x86_64-unknown-linux-gnu"
-3.10.14 @ 20240415 distribution="x86_64-unknown-linux-gnu" (installed)
-3.11.9 @ 20240415 distribution="x86_64-unknown-linux-gnu"
-3.12.3 @ 20240415 distribution="x86_64-unknown-linux-gnu" (installed)
+3.8.19 @ 20240415 distribution="x86_64-unknown-linux-gnu-install_only_stripped"
+3.9.19 @ 20240415 distribution="x86_64-unknown-linux-gnu-install_only_stripped"
+3.10.14 @ 20240415 distribution="x86_64-unknown-linux-gnu-install_only_stripped" (installed)
+3.11.9 @ 20240415 distribution="x86_64-unknown-linux-gnu-install_only_stripped"
+3.12.3 @ 20240415 distribution="x86_64-unknown-linux-gnu-install_only_stripped" (installed)
 
 $ pystand remove 3.10
 Version 3.10.14 @ 20240415 removed.
 
 $ pystand list
-3.12.3 @ 20240415 distribution="x86_64-unknown-linux-gnu"
+3.12.3 @ 20240415 distribution="x86_64-unknown-linux-gnu-install_only_stripped"
 ```
 
 Here are some examples showing how to use an installed version ..
@@ -122,10 +127,10 @@ https://github.com/bulletmark/pystand.
 Type `pystand` or `pystand -h` to view the usage summary:
 
 ```
-usage: pystand [-h] [-D DISTRIBUTION] [-B BASE_DIR] [-C CACHE_MINUTES]
-                  [--purge-days PURGE_DAYS]
+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-extra-strip] [-V]
+                  [-V]
                   {install,update,remove,list,show,path} ...
 
 Command line tool to download, install, and update pre-built Python versions
@@ -135,26 +140,27 @@ https://github.com/indygreg/python-build-standalone.
 options:
   -h, --help            show this help message and exit
   -D DISTRIBUTION, --distribution DISTRIBUTION
-                        python-build-standalone "*-install_only" distribution,
-                        e.g. "x86_64-unknown-linux-gnu". Default is auto-
-                        detected (detected as "x86_64-unknown-linux-gnu" for
-                        this current host).
-  -B BASE_DIR, --base-dir BASE_DIR
-                        specify pystand base dir for storing versions and
-                        metadata. Default is "$HOME/.local/share/pystand"
-  -C CACHE_MINUTES, --cache-minutes CACHE_MINUTES
+                        python-build-standalone distribution. Default is auto-
+                        detected (detected as "x86_64-unknown-linux-gnu-
+                        install_only_stripped" for this current host).
+  -P PREFIX_DIR, --prefix-dir PREFIX_DIR
+                        specify prefix dir for storing versions. Default is
+                        "$HOME/.local/share/pystand"
+  -C CACHE_DIR, --cache-dir CACHE_DIR
+                        specify cache dir for downloads. Default is
+                        "$HOME/.cache/pystand"
+  -M CACHE_MINUTES, --cache-minutes CACHE_MINUTES
                         cache latest YYYYMMDD release tag fetch for this many
                         minutes, before rechecking for latest. Default is 60
                         minutes
   --purge-days PURGE_DAYS
-                        cache YYYYMMDD release file lists for this number of
-                        days after last version referencing it is removed.
-                        Default is 90 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
   --github-access-token GITHUB_ACCESS_TOKEN
                         optional Github access token. Can specify to reduce
                         rate limiting.
-  --no-strip            do not use or create stripped binaries
-  --no-extra-strip      do not restrip already stripped source binaries
+  --no-strip            do strip downloaded binaries
   -V, --version         just show pystand version
 
 Commands:
@@ -258,18 +264,18 @@ options:
 ### Command `show`
 
 ```
-usage: pystand show [-h] [-D] [release]
+usage: pystand show [-h] [-a] [release]
 
 Show versions available from a release.
 
 positional arguments:
-  release             python-build-standalone YYYYMMDD release to show (e.g.
-                      20240415), default is latest release
+  release     python-build-standalone YYYYMMDD release to show (e.g.
+              20240415), default is latest release
 
 options:
-  -h, --help          show this help message and exit
-  -D, --distribution  also show all available distributions for each version
-                      from the release
+  -h, --help  show this help message and exit
+  -a, --all   also show all available distributions for each version from the
+              release
 ```
 
 ### Command `path`
@@ -313,6 +319,36 @@ To uninstall:
 $ pipx uninstall pystand
 ```
 
+## Installing Other Builds/Distributions
+
+The _`install_only_stripped`_ build of each distribution is installed by
+default. See description of distributions/builds
+[here](https://gregoryszorc.com/docs/python-build-standalone/main/running.html#obtaining-distributions).
+However, you can choose to install other distributions/builds. E.g. If
+we use a standard modern Linux x86_64 machine as an example, the default
+distribution is _`x86_64-unknown-linux-gnu-install_only_stripped`_ and
+the versions for these are installed by default at
+`~/.local/share/pystand/<version>`.
+
+However, let's say you want to experiment with the new free-threaded
+3.13 build. You can install this to a different directory, e.g.
+
+```sh
+$ mkdir ./3.13-freethreaded
+$ cd ./3.13-freethreaded
+
+$ pystand -P. -D x86_64-unknown-linux-gnu-freethreaded+lto-full install 3.13
+$ ./3.13/bin/python -V
+Python 3.13.0
+
+$ pystand -P . list
+3.13.0 @ 20241016 distribution="x86_64_v4-unknown-linux-gnu-freethreaded+lto-full"
+```
+
+Note you can set a different default distribution by
+specifying `--distribution` as a [default
+option](#command-default-options).
+
 ## Extrapolation of Python Versions
 
 `pystand` extrapolates any version text you specify on the command line
@@ -348,9 +384,9 @@ options will be concatenated and automatically prepended to your
 anything after on a line) are ignored. Type `pystand` to see all
 supported options.
 
-The global options: `--distribution`, `--base-dir`, `--cache-minutes`,
-`--purge-days`, `--github-access-token`, `--no-strip`,
-`--no-extra-strip` are the only sensible candidates to consider setting
+The global options: `--distribution`, `--prefix-dir`, `--cache-dir`,
+`--cache-minutes`, `--purge-days`, `--github-access-token`,
+`--no-strip`, are the only sensible candidates to consider setting
 as defaults.
 
 ## Github API Rate Limiting

pystand-2.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+pystand.py,sha256=UqlzHehVQ6gsP0p4CmVqrkYoaV6w5t0mO7y1d6VYkR0,32507
+pystand-2.0.dist-info/METADATA,sha256=P6edgnJxiBTLN_iRj9fphdhOLW3nmRMJsZo4SOZA-EI,17403
+pystand-2.0.dist-info/WHEEL,sha256=R06PA3UVYHThwHvxuRWMqaGcr-PuniXahwjmQRFMEkY,91
+pystand-2.0.dist-info/entry_points.txt,sha256=DG4ps3I3nni1bubV1tXs6u8FARgkdbAYaEAzZD4RAo8,41
+pystand-2.0.dist-info/top_level.txt,sha256=NoWUh19UQymAJLHTCdxMnVwV6Teftef5fzyF3OWLyNY,8
+pystand-2.0.dist-info/RECORD,,

{pystand-1.11.dist-info → pystand-2.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (75.1.0)
+Generator: setuptools (75.5.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

pystand.py

@@ -15,7 +15,9 @@ import shlex
 import shutil
 import subprocess
 import sys
+import tarfile
 import time
+import urllib.parse
 import urllib.request
 from argparse import ArgumentParser, Namespace
 from collections import defaultdict
@@ -25,6 +27,7 @@ from typing import Any, Iterable, Iterator
 
 import argcomplete
 import platformdirs
+import zstandard
 from packaging.version import parse as parse_version
 
 REPO_OWNER = 'indygreg'
@@ -33,31 +36,22 @@ GITHUB_REPO = f'{REPO_OWNER}/{REPO}'
 LATEST_RELEASE_URL = f'https://raw.githubusercontent.com/{GITHUB_REPO}'\
         '/latest-release/latest-release.json'
 
-# The following release is the first one that supports "install_only"
-# builds so this tool does not support any releases before this.
-FIRST_RELEASE = '20210724'
-
 # Sample release tag for documentation/usage examples
 SAMPL_RELEASE = '20240415'
 
-STRIP_EXT = '_stripped'
-
-# The following regexp pattern is used to match the end of a release file name
-ENDPAT = r'-install_only[-\dT]*.tar.gz$'
-
 PROG = Path(__file__).stem
 CNFFILE = platformdirs.user_config_path(f'{PROG}-flags.conf')
 
 # Default distributions for various platforms
 DISTRIBUTIONS = {
-    ('Linux', 'x86_64'): 'x86_64-unknown-linux-gnu',
-    ('Linux', 'aarch64'): 'aarch64-unknown-linux-gnu',
-    ('Linux', 'armv7l'): 'armv7-unknown-linux-gnueabihf',
-    ('Linux', 'armv8l'): 'armv7-unknown-linux-gnueabihf',
-    ('Darwin', 'x86_64'): 'x86_64-apple-darwin',
-    ('Darwin', 'aarch64'): 'aarch64-apple-darwin',
-    ('Windows', 'x86_64'): 'x86_64-pc-windows-msvc',
-    ('Windows', 'i686'): 'i686-pc-windows-msvc',
+    ('Linux', 'x86_64'): 'x86_64-unknown-linux-gnu-install_only_stripped',
+    ('Linux', 'aarch64'): 'aarch64-unknown-linux-gnu-install_only_stripped',
+    ('Linux', 'armv7l'): 'armv7-unknown-linux-gnueabihf-install_only_stripped',
+    ('Linux', 'armv8l'): 'armv7-unknown-linux-gnueabihf-install_only_stripped',
+    ('Darwin', 'x86_64'): 'x86_64-apple-darwin-install_only_stripped',
+    ('Darwin', 'aarch64'): 'aarch64-apple-darwin-install_only_stripped',
+    ('Windows', 'x86_64'): 'x86_64-pc-windows-msvc-install_only_stripped',
+    ('Windows', 'i686'): 'i686-pc-windows-msvc-install_only_stripped',
 }
 
 def is_admin() -> bool:
@@ -132,6 +126,51 @@ def rm_path(path: Path) -> None:
     elif path.exists():
         path.unlink()
 
+def unpack_zst(filename, extract_dir):
+    with open(filename, 'rb') as compressed:
+        dctx = zstandard.ZstdDecompressor()
+        with dctx.stream_reader(compressed) as reader:
+            with tarfile.open(fileobj=reader, mode='r|') as tar:
+                tar.extractall(path=extract_dir)
+
+def fetch(args: Namespace, release: str, url: str, tdir: Path) -> str | None:
+    'Fetch and unpack a release file'
+    error = None
+    tmpdir = tdir.with_name(f'{tdir.name}-tmp')
+    rm_path(tmpdir)
+    tmpdir.mkdir(parents=True)
+
+    filename_q = Path(urllib.parse.urlparse(url).path).name
+    filename = urllib.parse.unquote(filename_q)
+    cache_file = args._downloads / release / filename
+    cache_file.parent.mkdir(parents=True, exist_ok=True)
+
+    if not cache_file.exists():
+        try:
+            urllib.request.urlretrieve(url, cache_file)
+        except Exception as e:
+            error = f'Failed to fetch "{url}": {e}'
+
+    if error:
+        rm_path(cache_file)
+    else:
+        if filename.endswith('.zst'):
+            shutil.register_unpack_format('zst', ['.zst'], unpack_zst)
+
+        try:
+            shutil.unpack_archive(cache_file, tmpdir)
+        except Exception as e:
+            error = f'Failed to unpack "{url}": {e}'
+        else:
+            pdir = tmpdir / 'python' / 'install'
+            if not pdir.exists():
+                pdir = pdir.parent
+
+            pdir.replace(tdir)
+
+    rm_path(tmpdir)
+    return error
+
 def is_release_version(version: str) -> bool:
     'Check if a string is a formal Python release tag'
     return version.replace('.', '').isdigit()
@@ -167,11 +206,11 @@ class VersionMatcher:
             version += '.'
 
         # Only allow upgrade of formal release to another formal
-        # release, or alpha/beta release to another alpha/beta release.
+        # release.
         for full_version in self.seq:
             if full_version.startswith(version):
-                if not upgrade \
-                        or is_release_version(full_version) == is_release:
+                if not upgrade or not is_release \
+                        or is_release_version(full_version):
                     return full_version
 
         return None
@@ -211,10 +250,9 @@ def get_version_names(args: Namespace) -> list[str]:
     return sorted(all_names - given, key=parse_version) \
             if args.all else versions
 
-def check_release_tag(release: str, *,
-                      check_first: bool = True) -> str | None:
+def check_release_tag(release: str) -> str | None:
     'Check the specified release tag is valid'
-    if not release.isdigit() or len(release) != len(FIRST_RELEASE):
+    if not release.isdigit() or len(release) != len(SAMPL_RELEASE):
         return 'Release must be a YYYYMMDD string.'
 
     try:
@@ -222,9 +260,6 @@ def check_release_tag(release: str, *,
     except Exception:
         return 'Release must be a YYYYMMDD date string.'
 
-    if check_first and release < FIRST_RELEASE:
-        return f'Releases before "{FIRST_RELEASE}" do not include '\
-                '"*-install_only" builds so are not supported.'
     return None
 
 def get_release_tag(args: Namespace) -> str:
@@ -257,22 +292,32 @@ def get_release_tag(args: Namespace) -> str:
     args._latest_release.write_text(tag + '\n')
     return tag
 
-def merge(files: dict, name: str, url: str, stripped: bool) -> None:
-    'Merge a file into the files dict'
-    # We store: A string url when there is no stripped version; or a
-    # tuple of string urls, the first unstripped and the second
-    # stripped. It's a bit messy but we are keeping compatibility with
-    # earlier releases (and their cached release files) which did not
-    # have stripped versions.
-    impl, ver, distrib = name.split('-', maxsplit=2)
+def add_file(files: dict, tag: str, name: str, url: str) -> None:
+    'Extract the implementation, version, and architecture from a filename'
+    if name.endswith('.tar.zst'):
+        name = name[:-8]
+    elif name.endswith('.tar.gz'):
+        name = name[:-7]
+    else:
+        return
+
+    impl, ver, arch = name.split('-', 2)
+
+    # Modern releases have a '+' in the name to separate the version
+    if '+' in ver:
+        ver, filetag = ver.split('+')
+        if filetag != tag:
+            return
+
     if impl not in files:
-        files[impl] = defaultdict(dict)
+        files[impl] = {}
 
-    if exist := files[impl].get(ver, {}).get(distrib, {}):
-        files[impl][ver][distrib] = (exist, url) \
-                if stripped else (url, exist[1])
-    else:
-        files[impl][ver][distrib] = ('', url) if stripped else url
+    vers = files[impl]
+
+    if ver not in vers:
+        vers[ver] = {}
+
+    vers[ver][arch] = url
 
 def get_release_files(args, tag, implementation: str | None = None) -> dict:
     'Return the release files for the given tag'
@@ -294,13 +339,7 @@ def get_release_files(args, tag, implementation: str | None = None) -> dict:
         # Iterate over the release assets and store pertinent files in a
         # dict to return.
         for asset in release.get_assets():
-            name = asset.name
-            if is_stripped := (STRIP_EXT in name):
-                name = name.replace(STRIP_EXT, '')
-
-            if m := re.search(ENDPAT, name):
-                name = re.sub(r'\+\d{8}', '', name[:m.start()])
-                merge(files, name, asset.browser_download_url, is_stripped)
+            add_file(files, tag, asset.name, asset.browser_download_url)
 
         if not files:
             sys.exit(f'Failed to fetch any files for release {tag}')
@@ -374,10 +413,17 @@ def purge_unused_releases(args: Namespace) -> None:
 
     now_secs = time.time()
     end_secs = args.purge_days * 86400
-    for release in (releases - keep):
+    releases -= keep
+    for release in releases:
         rdir = args._releases / release
         if (rdir.stat().st_mtime + end_secs) < now_secs:
             rdir.unlink()
+        else:
+            keep.add(release)
+
+    downloads = set(f.name for f in args._downloads.iterdir())
+    for release in (downloads - keep):
+        rm_path(args._downloads / release)
 
 class COMMAND:
     'Base class for all commands'
@@ -439,57 +485,29 @@ def install(args: Namespace, vdir: Path, release: str, distribution: str,
     'Install a version'
     version = vdir.name
 
-    if not (fileurl := files[version].get(distribution)):
+    if not (url := files[version].get(distribution)):
         return f'Arch "{distribution}" not found for release '\
                 f'{release} version {version}.'
 
-    if isinstance(fileurl, str):
-        stripped = False
-    else:
-        stripped = not args.no_strip
-        if not (fileurl := fileurl[stripped]):
-            desc = 'stripped' if stripped else 'unstripped'
-            return f'Arch {desc} "{distribution}" not found for release '\
-                    f'{release} version {version}.'
-
     tmpdir = args._versions / f'.{version}-tmp'
     rm_path(tmpdir)
-    tmpdir.mkdir()
-    tmpdir_py = tmpdir / 'python'
-    error = None
-
-    try:
-        urllib.request.urlretrieve(fileurl, tmpdir / 'tmp.tar.gz')
-    except Exception as e:
-        error = f'Failed to fetch "{fileurl}": {e}'
-
-    try:
-        shutil.unpack_archive(tmpdir / 'tmp.tar.gz', tmpdir)
-    except Exception as e:
-        error = f'Failed to unpack "{fileurl}": {e}'
+    tmpdir.mkdir(parents=True)
 
-    if not error:
+    if not (error := fetch(args, release, url, tmpdir)):
         data = {'release': release, 'distribution': distribution}
 
-        if args.no_strip:
-            data['stripped'] = 'forced off'
-        elif stripped and args.no_extra_strip:
-            data['stripped'] = 'at_source_only'
-        else:
-            if strip_binaries(tmpdir_py, distribution):
-                data['stripped'] = 'at_source_and_manually' \
-                        if stripped else 'manually'
-            else:
-                data['stripped'] = 'at_source' if stripped else 'n/a'
+        if not args.no_strip and strip_binaries(tmpdir, distribution):
+            data['stripped'] = 'true'
 
-        if (error := set_json(tmpdir_py / args._data, data)):
+        if (error := set_json(tmpdir / args._data, data)):
             error = f'Failed to write {version} data file: {error}'
 
-    if not error:
+    if error:
+        shutil.rmtree(tmpdir)
+    else:
         remove(args, version)
-        tmpdir_py.replace(vdir)
+        tmpdir.replace(vdir)
 
-    shutil.rmtree(tmpdir)
     return error
 
 def main() -> str | None:
@@ -497,8 +515,9 @@ def main() -> str | None:
     distro_default = DISTRIBUTIONS.get((platform.system(), platform.machine()))
     distro_help = distro_default or '?unknown?'
 
-    base_dir = Path('/opt' if is_admin() else
-                    platformdirs.user_data_dir()) / PROG
+    p = '/opt' if is_admin() else platformdirs.user_data_dir()
+    prefix_dir = str(Path(p, PROG))
+    cache_dir = platformdirs.user_cache_path() / PROG
 
     # Parse arguments
     opt = ArgumentParser(description=__doc__,
@@ -507,28 +526,28 @@ def main() -> str | None:
 
     # Set up main/global arguments
     opt.add_argument('-D', '--distribution',
-                     help=f'{REPO} "*-install_only" '
-                     'distribution, e.g. "x86_64-unknown-linux-gnu". '
+                     help=f'{REPO} distribution. '
                      f'Default is auto-detected (detected as "{distro_help}" '
                      'for this current host).')
-    opt.add_argument('-B', '--base-dir', default=str(base_dir),
-                     help=f'specify {PROG} base dir for storing '
-                     'versions and metadata. Default is "%(default)s"')
-    opt.add_argument('-C', '--cache-minutes', default=60, type=float,
+    opt.add_argument('-P', '--prefix-dir', default=prefix_dir,
+                     help='specify prefix dir for storing '
+                     'versions. Default is "%(default)s"')
+    opt.add_argument('-C', '--cache-dir', default=str(cache_dir),
+                     help='specify cache dir for downloads. '
+                     'Default is "%(default)s"')
+    opt.add_argument('-M', '--cache-minutes', default=60, type=float,
                      help='cache latest YYYYMMDD release tag fetch for this '
                      'many minutes, before rechecking for latest. '
                      'Default is %(default)d minutes')
     opt.add_argument('--purge-days', default=90, type=int,
-                     help='cache YYYYMMDD release file lists for this number '
-                     'of days after last version referencing it is removed. '
-                     'Default is %(default)d days')
+                     help='cache YYYYMMDD release file lists and downloads for '
+                     'this number of days after last version referencing that '
+                     'release is removed. Default is %(default)d days')
     opt.add_argument('--github-access-token',
                      help='optional Github access token. Can specify to reduce '
                      'rate limiting.')
     opt.add_argument('--no-strip', action='store_true',
-                     help='do not use or create stripped binaries')
-    opt.add_argument('--no-extra-strip', action='store_true',
-                     help='do not restrip already stripped source binaries')
+                     help='do strip downloaded binaries')
     opt.add_argument('-V', '--version', action='store_true',
                      help=f'just show {PROG} version')
     cmd = opt.add_subparsers(title='Commands', dest='cmdname')
@@ -583,20 +602,24 @@ def main() -> str | None:
                 'using -D/--distribution option.')
 
     # Keep some useful info in the namespace passed to the command
-    base_dir = Path(args.base_dir).expanduser()
+    prefix_dir = Path(args.prefix_dir).expanduser()
+    cache_dir = Path(args.cache_dir).expanduser()
 
     args._distribution = distribution
     args._data = f'{PROG}.json'
-    args._latest_release = base_dir / 'latest_release'
-    args._latest_release.parent.mkdir(parents=True, exist_ok=True)
-    args._versions = base_dir / 'versions'
+
+    args._versions = prefix_dir
     args._versions.mkdir(parents=True, exist_ok=True)
-    args._releases = base_dir / 'releases'
+
+    args._downloads = cache_dir / 'downloads'
+    args._downloads.mkdir(parents=True, exist_ok=True)
+    args._releases = cache_dir / 'releases'
     args._releases.mkdir(parents=True, exist_ok=True)
+    args._latest_release = cache_dir / 'latest_release'
 
     result = args.func(args)
-    update_version_symlinks(args)
     purge_unused_releases(args)
+    update_version_symlinks(args)
     return result
 
 @COMMAND.add
@@ -670,11 +693,11 @@ class _update(COMMAND):
             if not (data := get_json(args._versions / version / args._data)):
                 continue
 
-            release = data.get('release')
-            if release == release_target:
+            if (release := data.get('release')) == release_target:
                 continue
 
-            nextver = matcher.match(version, upgrade=True)
+            if not (nextver := matcher.match(version, upgrade=True)):
+                continue
 
             distribution = data.get('distribution')
             if not distribution or distribution not in files.get(nextver, {}):
@@ -722,7 +745,7 @@ class _remove(COMMAND):
     def run(args: Namespace) -> str | None:
         release_del = args.release
         if release_del and \
-                (err := check_release_tag(release_del, check_first=False)):
+                (err := check_release_tag(release_del)):
             return err
 
         for version in get_version_names(args):
@@ -768,23 +791,31 @@ class _list(COMMAND):
             app = ''
             if release_target and release != release_target:
                 nextver = matcher.match(version, upgrade=True)
-                new_vdir = args._versions / nextver
-                if nextver != version and new_vdir.exists():
+                if not nextver:
                     if args.verbose:
-                        nrelease = get_json(
-                                new_vdir / args._data).get('release', '?')
-                        app = f' not eligible for '\
-                                f'update because {fmt(nextver, nrelease)} '\
-                                'is already installed.'
+                        app = ' not eligible for update because '\
+                                f'release {release_target} does not provide '\
+                                'this version.'
                 else:
-                    # May not be updatable if newer release does not support
-                    # this same distribution anymore
-                    if nextver and distribution in files.get(nextver, {}):
-                        upd = f' updatable to {fmt(nextver, release_target)}'
-                    elif args.verbose:
-                        app = f' not eligible for update because '\
-                                f'{fmt(nextver, release_target)} does '\
-                                f'not provide distribution="{distribution}".'
+                    new_vdir = args._versions / nextver
+                    if nextver != version and new_vdir.exists():
+                        if args.verbose:
+                            nrelease = get_json(
+                                    new_vdir / args._data).get('release', '?')
+                            app = f' not eligible for '\
+                                    f'update because {fmt(nextver, nrelease)} '\
+                                    'is already installed.'
+                    else:
+                        # May not be updatable if newer release does not support
+                        # this same distribution anymore
+                        if nextver and distribution in files.get(nextver, {}):
+                            upd = ' updatable to '\
+                                    f'{fmt(nextver, release_target)}'
+                        elif args.verbose:
+                            app = ' not eligible for update because '\
+                                    f'{fmt(nextver, release_target)} does '\
+                                    'not provide '\
+                                    f'distribution="{distribution}".'
 
             print(f'{fmt(version, release)}{upd} '
                     f'distribution="{distribution}"{app}')
@@ -794,7 +825,7 @@ class _show(COMMAND):
     'Show versions available from a release.'
     @staticmethod
     def init(parser: ArgumentParser) -> None:
-        parser.add_argument('-D', '--distribution', action='store_true',
+        parser.add_argument('-a', '--all', action='store_true',
                             help='also show all available distributions for '
                             'each version from the release')
         parser.add_argument('release', nargs='?',
@@ -821,7 +852,7 @@ class _show(COMMAND):
             for distribution in files[version]:
                 app = ' (installed)' \
                         if distribution == installed_distribution else ''
-                if args.distribution or app \
+                if args.all or app \
                         or distribution == args._distribution:
                     if distribution == args._distribution:
                         installable = True
@@ -848,7 +879,8 @@ class _path(COMMAND):
         matcher = VersionMatcher([f.name for f in iter_versions(args)])
         version = matcher.match(args.version) or args.version
         if not version:
-            return f'No Python version installed.'
+            return 'No Python version installed.'
+
         path = args._versions / version
         if not path.is_dir():
             return f'Version "{version}" is not installed.'

pystand-1.11.dist-info/RECORD

@@ -1,6 +0,0 @@
-pystand.py,sha256=HuCNuIYwXUcVCpAzqtEEj9hdMn-S4j4F7t8yYfNuYeU,32048
-pystand-1.11.dist-info/METADATA,sha256=6NYVL_gVjjOT0kvk66KNUFfXlRU-KuGo5HBzuO16w0g,15923
-pystand-1.11.dist-info/WHEEL,sha256=GV9aMThwP_4oNCtvEC2ec3qUYutgWeAzklro_0m4WJQ,91
-pystand-1.11.dist-info/entry_points.txt,sha256=DG4ps3I3nni1bubV1tXs6u8FARgkdbAYaEAzZD4RAo8,41
-pystand-1.11.dist-info/top_level.txt,sha256=NoWUh19UQymAJLHTCdxMnVwV6Teftef5fzyF3OWLyNY,8
-pystand-1.11.dist-info/RECORD,,