pystand 2.27__tar.gz → 2.28__tar.gz

{pystand-2.27/pystand.egg-info → pystand-2.28}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pystand
-Version: 2.27
+Version: 2.28
 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
@@ -9,7 +9,6 @@ Keywords: python-build-standalone,pyenv,hatch,pdm
 Classifier: Programming Language :: Python :: 3
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
-Requires-Dist: argcomplete
 Requires-Dist: packaging
 Requires-Dist: platformdirs
 Requires-Dist: argparse-from-file
@@ -145,7 +144,7 @@ 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,update,upgrade,remove,uninstall,list,show,path,cache,uv,uvx} ...
+                  {install,i,update,u,upgrade,remove,r,uninstall,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-
@@ -162,10 +161,10 @@ options:
                         standalone/main/
   -P, --prefix-dir PREFIX_DIR
                         specify prefix dir for storing versions. Default is
-                        "$HOME/.local/share/pystand".
+                        "~/.local/share/pystand".
   -C, --cache-dir CACHE_DIR
                         specify cache dir for downloads. Default is
-                        "$HOME/.cache/pystand".
+                        "~/.cache/pystand".
   -M, --cache-minutes CACHE_MINUTES
                         cache latest YYYYMMDD release tag fetch for this many
                         minutes, before rechecking for latest. Default is 60
@@ -185,16 +184,18 @@ options:
   -V, --version         just show pystand version
 
 Commands:
-  {install,update,upgrade,remove,uninstall,list,show,path,cache,uv,uvx}
-    install             Install one, more, or all versions from a python-
+  {install,i,update,u,upgrade,remove,r,uninstall,list,l,show,s,path,p,cache,c,uv,uvx}
+    install (i)         Install one, more, or all versions from a python-
                         build-standalone release.
-    update (upgrade)    Update one, more, or all versions to another release.
-    remove (uninstall)  Remove/uninstall one, more, or all versions.
-    list                List installed versions and show which have an update
+    update (u, upgrade)
+                        Update one, more, or all versions to another release.
+    remove (r, uninstall)
+                        Remove/uninstall one, more, or all versions.
+    list (l)            List installed versions and show which have an update
                         available.
-    show                Show versions available from a release.
-    path                Show path prefix to installed version base directory.
-    cache               Show size of release download caches.
+    show (s)            Show versions available from a release.
+    path (p)            Show path prefix to installed version base directory.
+    cache (c)           Show size of release download caches.
     uv                  Run a uv command using a version of python installed
                         by pystand.
     uvx                 Run a program using uvx and a version of python
@@ -232,6 +233,8 @@ options:
   -f, --force           force install even if already installed
   -s, --include-source  also install source files if available in distribution
                         download
+
+aliases: i
 ```
 
 ### Command `update`
@@ -255,7 +258,7 @@ options:
   -k, --keep            keep old version after updating (but only if different
                         version number)
 
-aliases: upgrade
+aliases: u, upgrade
 ```
 
 ### Command `remove`
@@ -277,7 +280,7 @@ options:
                         only remove versions if from specified YYYMMDD release
                         (e.g. 20240415)
 
-aliases: uninstall
+aliases: r, uninstall
 ```
 
 ### Command `list`
@@ -297,6 +300,8 @@ options:
   -r, --release RELEASE
                         use specified YYYYMMDD release (e.g. 20240415) for
                         verbose compare, default is latest release
+
+aliases: l
 ```
 
 ### Command `show`
@@ -320,6 +325,8 @@ options:
                         20240415), default is latest release
   -a, --all             show all available distributions for each version from
                         the release
+
+aliases: s
 ```
 
 ### Command `path`
@@ -337,6 +344,8 @@ options:
   -p, --python-path  add path to python executable
   -r, --resolve      fully resolve given version
   -c, --cache-path   just show path to cache dir
+
+aliases: p
 ```
 
 ### Command `cache`
@@ -358,6 +367,8 @@ options:
   -R, --remove-all-unused
                         remove caches for all currently unused releases
                         instead of showing size
+
+aliases: c
 ```
 
 ### Command `uv`
@@ -635,7 +646,8 @@ supported options.
 
 The global options: `--distribution`, `--prefix-dir`, `--cache-dir`,
 `--cache-minutes`, `--purge-days`, `--github-access-token`, `--no-strip`,
-`--cert` are the only sensible candidates to consider setting as defaults.
+`--no-color`, and `--cert` are the only sensible candidates to consider setting
+as defaults.
 
 ## Github API Rate Limiting
 
@@ -716,15 +728,6 @@ An example where this functionality may be handy is to conveniently test
 various tools against free-threaded or other Python builds from Python Build
 Standalone releases.
 
-## Command Line Tab Completion
-
-Command line shell [tab
-completion](https://en.wikipedia.org/wiki/Command-line_completion) is
-automatically enabled on `pystand` commands and options using
-[`argcomplete`](https://github.com/kislyuk/argcomplete). You may need to first
-(once-only) [activate argcomplete global
-completion](https://github.com/kislyuk/argcomplete#global-completion).
-
 ## License
 
 Copyright (C) 2024 Mark Blakeney. This program is distributed under the

{pystand-2.27 → pystand-2.28}/README.md

@@ -125,7 +125,7 @@ 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,update,upgrade,remove,uninstall,list,show,path,cache,uv,uvx} ...
+                  {install,i,update,u,upgrade,remove,r,uninstall,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-
@@ -142,10 +142,10 @@ options:
                         standalone/main/
   -P, --prefix-dir PREFIX_DIR
                         specify prefix dir for storing versions. Default is
-                        "$HOME/.local/share/pystand".
+                        "~/.local/share/pystand".
   -C, --cache-dir CACHE_DIR
                         specify cache dir for downloads. Default is
-                        "$HOME/.cache/pystand".
+                        "~/.cache/pystand".
   -M, --cache-minutes CACHE_MINUTES
                         cache latest YYYYMMDD release tag fetch for this many
                         minutes, before rechecking for latest. Default is 60
@@ -165,16 +165,18 @@ options:
   -V, --version         just show pystand version
 
 Commands:
-  {install,update,upgrade,remove,uninstall,list,show,path,cache,uv,uvx}
-    install             Install one, more, or all versions from a python-
+  {install,i,update,u,upgrade,remove,r,uninstall,list,l,show,s,path,p,cache,c,uv,uvx}
+    install (i)         Install one, more, or all versions from a python-
                         build-standalone release.
-    update (upgrade)    Update one, more, or all versions to another release.
-    remove (uninstall)  Remove/uninstall one, more, or all versions.
-    list                List installed versions and show which have an update
+    update (u, upgrade)
+                        Update one, more, or all versions to another release.
+    remove (r, uninstall)
+                        Remove/uninstall one, more, or all versions.
+    list (l)            List installed versions and show which have an update
                         available.
-    show                Show versions available from a release.
-    path                Show path prefix to installed version base directory.
-    cache               Show size of release download caches.
+    show (s)            Show versions available from a release.
+    path (p)            Show path prefix to installed version base directory.
+    cache (c)           Show size of release download caches.
     uv                  Run a uv command using a version of python installed
                         by pystand.
     uvx                 Run a program using uvx and a version of python
@@ -212,6 +214,8 @@ options:
   -f, --force           force install even if already installed
   -s, --include-source  also install source files if available in distribution
                         download
+
+aliases: i
 ```
 
 ### Command `update`
@@ -235,7 +239,7 @@ options:
   -k, --keep            keep old version after updating (but only if different
                         version number)
 
-aliases: upgrade
+aliases: u, upgrade
 ```
 
 ### Command `remove`
@@ -257,7 +261,7 @@ options:
                         only remove versions if from specified YYYMMDD release
                         (e.g. 20240415)
 
-aliases: uninstall
+aliases: r, uninstall
 ```
 
 ### Command `list`
@@ -277,6 +281,8 @@ options:
   -r, --release RELEASE
                         use specified YYYYMMDD release (e.g. 20240415) for
                         verbose compare, default is latest release
+
+aliases: l
 ```
 
 ### Command `show`
@@ -300,6 +306,8 @@ options:
                         20240415), default is latest release
   -a, --all             show all available distributions for each version from
                         the release
+
+aliases: s
 ```
 
 ### Command `path`
@@ -317,6 +325,8 @@ options:
   -p, --python-path  add path to python executable
   -r, --resolve      fully resolve given version
   -c, --cache-path   just show path to cache dir
+
+aliases: p
 ```
 
 ### Command `cache`
@@ -338,6 +348,8 @@ options:
   -R, --remove-all-unused
                         remove caches for all currently unused releases
                         instead of showing size
+
+aliases: c
 ```
 
 ### Command `uv`
@@ -615,7 +627,8 @@ supported options.
 
 The global options: `--distribution`, `--prefix-dir`, `--cache-dir`,
 `--cache-minutes`, `--purge-days`, `--github-access-token`, `--no-strip`,
-`--cert` are the only sensible candidates to consider setting as defaults.
+`--no-color`, and `--cert` are the only sensible candidates to consider setting
+as defaults.
 
 ## Github API Rate Limiting
 
@@ -696,15 +709,6 @@ An example where this functionality may be handy is to conveniently test
 various tools against free-threaded or other Python builds from Python Build
 Standalone releases.
 
-## Command Line Tab Completion
-
-Command line shell [tab
-completion](https://en.wikipedia.org/wiki/Command-line_completion) is
-automatically enabled on `pystand` commands and options using
-[`argcomplete`](https://github.com/kislyuk/argcomplete). You may need to first
-(once-only) [activate argcomplete global
-completion](https://github.com/kislyuk/argcomplete#global-completion).
-
 ## License
 
 Copyright (C) 2024 Mark Blakeney. This program is distributed under the

{pystand-2.27 → pystand-2.28}/pyproject.toml

@@ -14,7 +14,6 @@ classifiers = [
 ]
 dynamic = ["version"]
 dependencies = [
-  "argcomplete",
   "packaging",
   "platformdirs",
   "argparse-from-file",

{pystand-2.27 → pystand-2.28/pystand.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pystand
-Version: 2.27
+Version: 2.28
 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
@@ -9,7 +9,6 @@ Keywords: python-build-standalone,pyenv,hatch,pdm
 Classifier: Programming Language :: Python :: 3
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
-Requires-Dist: argcomplete
 Requires-Dist: packaging
 Requires-Dist: platformdirs
 Requires-Dist: argparse-from-file
@@ -145,7 +144,7 @@ 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,update,upgrade,remove,uninstall,list,show,path,cache,uv,uvx} ...
+                  {install,i,update,u,upgrade,remove,r,uninstall,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-
@@ -162,10 +161,10 @@ options:
                         standalone/main/
   -P, --prefix-dir PREFIX_DIR
                         specify prefix dir for storing versions. Default is
-                        "$HOME/.local/share/pystand".
+                        "~/.local/share/pystand".
   -C, --cache-dir CACHE_DIR
                         specify cache dir for downloads. Default is
-                        "$HOME/.cache/pystand".
+                        "~/.cache/pystand".
   -M, --cache-minutes CACHE_MINUTES
                         cache latest YYYYMMDD release tag fetch for this many
                         minutes, before rechecking for latest. Default is 60
@@ -185,16 +184,18 @@ options:
   -V, --version         just show pystand version
 
 Commands:
-  {install,update,upgrade,remove,uninstall,list,show,path,cache,uv,uvx}
-    install             Install one, more, or all versions from a python-
+  {install,i,update,u,upgrade,remove,r,uninstall,list,l,show,s,path,p,cache,c,uv,uvx}
+    install (i)         Install one, more, or all versions from a python-
                         build-standalone release.
-    update (upgrade)    Update one, more, or all versions to another release.
-    remove (uninstall)  Remove/uninstall one, more, or all versions.
-    list                List installed versions and show which have an update
+    update (u, upgrade)
+                        Update one, more, or all versions to another release.
+    remove (r, uninstall)
+                        Remove/uninstall one, more, or all versions.
+    list (l)            List installed versions and show which have an update
                         available.
-    show                Show versions available from a release.
-    path                Show path prefix to installed version base directory.
-    cache               Show size of release download caches.
+    show (s)            Show versions available from a release.
+    path (p)            Show path prefix to installed version base directory.
+    cache (c)           Show size of release download caches.
     uv                  Run a uv command using a version of python installed
                         by pystand.
     uvx                 Run a program using uvx and a version of python
@@ -232,6 +233,8 @@ options:
   -f, --force           force install even if already installed
   -s, --include-source  also install source files if available in distribution
                         download
+
+aliases: i
 ```
 
 ### Command `update`
@@ -255,7 +258,7 @@ options:
   -k, --keep            keep old version after updating (but only if different
                         version number)
 
-aliases: upgrade
+aliases: u, upgrade
 ```
 
 ### Command `remove`
@@ -277,7 +280,7 @@ options:
                         only remove versions if from specified YYYMMDD release
                         (e.g. 20240415)
 
-aliases: uninstall
+aliases: r, uninstall
 ```
 
 ### Command `list`
@@ -297,6 +300,8 @@ options:
   -r, --release RELEASE
                         use specified YYYYMMDD release (e.g. 20240415) for
                         verbose compare, default is latest release
+
+aliases: l
 ```
 
 ### Command `show`
@@ -320,6 +325,8 @@ options:
                         20240415), default is latest release
   -a, --all             show all available distributions for each version from
                         the release
+
+aliases: s
 ```
 
 ### Command `path`
@@ -337,6 +344,8 @@ options:
   -p, --python-path  add path to python executable
   -r, --resolve      fully resolve given version
   -c, --cache-path   just show path to cache dir
+
+aliases: p
 ```
 
 ### Command `cache`
@@ -358,6 +367,8 @@ options:
   -R, --remove-all-unused
                         remove caches for all currently unused releases
                         instead of showing size
+
+aliases: c
 ```
 
 ### Command `uv`
@@ -635,7 +646,8 @@ supported options.
 
 The global options: `--distribution`, `--prefix-dir`, `--cache-dir`,
 `--cache-minutes`, `--purge-days`, `--github-access-token`, `--no-strip`,
-`--cert` are the only sensible candidates to consider setting as defaults.
+`--no-color`, and `--cert` are the only sensible candidates to consider setting
+as defaults.
 
 ## Github API Rate Limiting
 
@@ -716,15 +728,6 @@ An example where this functionality may be handy is to conveniently test
 various tools against free-threaded or other Python builds from Python Build
 Standalone releases.
 
-## Command Line Tab Completion
-
-Command line shell [tab
-completion](https://en.wikipedia.org/wiki/Command-line_completion) is
-automatically enabled on `pystand` commands and options using
-[`argcomplete`](https://github.com/kislyuk/argcomplete). You may need to first
-(once-only) [activate argcomplete global
-completion](https://github.com/kislyuk/argcomplete#global-completion).
-
 ## License
 
 Copyright (C) 2024 Mark Blakeney. This program is distributed under the

{pystand-2.27 → pystand-2.28}/pystand.egg-info/requires.txt

@@ -1,4 +1,3 @@
-argcomplete
 packaging
 platformdirs
 argparse-from-file

{pystand-2.27 → pystand-2.28}/pystand.py

@@ -1,5 +1,4 @@
 #!/usr/bin/python3
-# PYTHON_ARGCOMPLETE_OK
 """
 Command line tool to download, install, and update pre-built Python
 versions from the python-build-standalone project at
@@ -24,10 +23,10 @@ from pathlib import Path
 from typing import Any
 from urllib.request import urlopen
 
-import argcomplete
 import filelock
 import platformdirs
 from argparse_from_file import ArgumentParser, Namespace
+from packaging.version import InvalidVersion
 from packaging.version import parse as parse_version
 
 REPO = 'python-build-standalone'
@@ -115,6 +114,14 @@ class ColorDist(ColorTable):
         return text.split('-', 1)[0]
 
 
+def unexpanduser(path: Path, *, home=Path.home()) -> 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) :])
+
+    return path
+
+
 def is_admin() -> bool:
     "Check if we are running as root"
     if platform.system() == 'Windows':
@@ -589,6 +596,12 @@ def show_list(args: Namespace) -> None:
         if args.re_match and not re.search(args.re_match, release):
             continue
 
+        # Ignore any bogus releases that don't parse as versions
+        try:
+            this_version = parse_version(release)
+        except InvalidVersion:
+            continue
+
         if dt_str := releases.get(release):
             dts = (
                 datetime.fromisoformat(dt_str)
@@ -605,8 +618,7 @@ def show_list(args: Namespace) -> None:
         else:
             app = ''
 
-        pre = ' pre-release' if parse_version(release) > latest else ''
-
+        pre = ' pre-release' if this_version > latest else ''
         print(f'{release} {dts}{app}{pre}')
 
 
@@ -763,8 +775,8 @@ def main() -> str | None:
     distro_help = distro_default or '?unknown?'
 
     p = '/opt' if is_admin() else platformdirs.user_data_dir()
-    prefix_dir = str(Path(p, PROG))
-    cache_dir = platformdirs.user_cache_path() / PROG
+    prefix_dir = unexpanduser(Path(p, PROG))
+    cache_dir = unexpanduser(platformdirs.user_cache_path() / PROG)
 
     # Parse arguments
     opt = ArgumentParser(
@@ -783,7 +795,7 @@ def main() -> str | None:
     opt.add_argument(
         '-P',
         '--prefix-dir',
-        default=prefix_dir,
+        default=str(prefix_dir),
         help='specify prefix dir for storing versions. Default is "%(default)s".',
     )
     opt.add_argument(
@@ -855,8 +867,6 @@ def main() -> str | None:
         # Set the function to call
         cmdopt.set_defaults(func=cls.run, name=name, parser=cmdopt)
 
-    # Command arguments are now defined, so we can set up argcomplete
-    argcomplete.autocomplete(opt)
     args = opt.parse_args()
 
     if 'func' not in args:
@@ -912,6 +922,7 @@ def main() -> str | None:
 # COMMAND
 class install_:
     doc = f'Install one, more, or all versions from a {REPO} release.'
+    aliases = ['i']
 
     @staticmethod
     def init(parser: ArgumentParser) -> None:
@@ -1011,7 +1022,7 @@ class install_:
 class update_:
     "Update one, more, or all versions to another release."
 
-    aliases = ['upgrade']
+    aliases = ['u', 'upgrade']
 
     @staticmethod
     def init(parser: ArgumentParser) -> None:
@@ -1098,7 +1109,7 @@ class update_:
 class remove_:
     "Remove/uninstall one, more, or all versions."
 
-    aliases = ['uninstall']
+    aliases = ['r', 'uninstall']
 
     @staticmethod
     def init(parser: ArgumentParser) -> None:
@@ -1139,6 +1150,8 @@ class remove_:
 class list_:
     "List installed versions and show which have an update available."
 
+    aliases = ['l']
+
     @staticmethod
     def init(parser: ArgumentParser) -> None:
         parser.add_argument(
@@ -1227,6 +1240,7 @@ class show_:
     View available releases and their distributions at
     {GITHUB_SITE}/releases.
     """
+    aliases = ['s']
 
     @staticmethod
     def init(parser: ArgumentParser) -> None:
@@ -1301,6 +1315,8 @@ class show_:
 class path_:
     "Show path prefix to installed version base directory."
 
+    aliases = ['p']
+
     @staticmethod
     def init(parser: ArgumentParser) -> None:
         parser.add_argument(
@@ -1352,6 +1368,8 @@ class path_:
 class cache_:
     "Show size of release download caches."
 
+    aliases = ['c']
+
     @staticmethod
     def init(parser: ArgumentParser) -> None:
         parser.add_argument(