pystand 2.26__tar.gz → 2.28__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pystand
-Version: 2.26
+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
@@ -35,6 +34,9 @@ provided:
  |`list`|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.|
+ |`uv`|Run a uv command using a version of python installed by pystand.|
+ |`uvx`|Run a program using uvx and a version of python installed by pystand.|
 
 By default, Python versions are sourced from the latest
 `python-build-standalone` [release][pbs-rel] available (e.g.
@@ -102,11 +104,11 @@ Version 3.12.3 is already installed.
 Here are some examples showing how to use an installed version ..
 
 ```sh
-# Use uv to create a virtual environment to be run with latest pystand
+# Use uv to create a virtual environment to be run with pystand
 # installed python 3.12:
 $ uv venv -p $(pystand path 3.12) myenv
 
-# Create a regular virtual environment to be run with latest pystand
+# Create a regular virtual environment to be run with pystand
 # installed python 3.12:
 $ $(pystand path -p 3.12) -m venv myenv
 
@@ -142,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} ...
+                  {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-
@@ -159,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
@@ -182,16 +184,22 @@ options:
   -V, --version         just show pystand version
 
 Commands:
-  {install,update,upgrade,remove,uninstall,list,show,path,cache}
-    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
+                        installed by pystand.
 
 Some commands offer aliases as shown in parentheses above. Note you can set
 default starting global options in ~/.config/pystand-flags.conf.
@@ -225,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`
@@ -248,7 +258,7 @@ options:
   -k, --keep            keep old version after updating (but only if different
                         version number)
 
-aliases: upgrade
+aliases: u, upgrade
 ```
 
 ### Command `remove`
@@ -270,7 +280,7 @@ options:
                         only remove versions if from specified YYYMMDD release
                         (e.g. 20240415)
 
-aliases: uninstall
+aliases: r, uninstall
 ```
 
 ### Command `list`
@@ -290,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`
@@ -313,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`
@@ -330,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`
@@ -351,6 +367,46 @@ options:
   -R, --remove-all-unused
                         remove caches for all currently unused releases
                         instead of showing size
+
+aliases: c
+```
+
+### Command `uv`
+
+```
+usage: pystand uv [-h] [-p PYTHON]
+                     command [subcommand] [uv_args_for_command ...]
+
+Run a uv command using a version of python installed by pystand.
+
+positional arguments:
+  command              uv command to run
+  subcommand           optional uv sub-command
+  uv_args_for_command  optional extra arguments to pass to uv command [sub-
+                       command], start any options with "-- "
+
+options:
+  -h, --help           show this help message and exit
+  -p, --python PYTHON  version of python to use, e.g. "3.12", default is
+                       latest release version
+```
+
+### Command `uvx`
+
+```
+usage: pystand uvx [-h] [-p PYTHON] program [uvx_args_for_program ...]
+
+Run a program using uvx and a version of python installed by pystand.
+
+positional arguments:
+  program               uvx program to run
+  uvx_args_for_program  optional extra arguments to pass to uvx program, start
+                        any options with "-- "
+
+options:
+  -h, --help            show this help message and exit
+  -p, --python PYTHON   version of python to use, e.g. "3.12", default is
+                        latest release version
 ```
 
 ## Installation and Upgrade
@@ -590,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
 
@@ -623,14 +680,53 @@ The available options are:
 Specify the option on the command line with `--cert`, or set that as a [default
 option](#command-default-options).
 
-## Command Line Tab Completion
+## Direct Usage with UV Tool
+
+Many [`uv`][uv] commands accept a `-p/--python` option to specify a Python
+version or path. To use a `pystand` installed Python version, instead of the
+`uv` maintained or system python, you can use one of the following approaches:
+
+E.g. To create a `uv venv` using `pystand` installed 3.12, just hard code the
+path directly, e.g. for a Linux platform:
+
+```sh
+uv venv -p ~/.local/share/pystand/3.12
+```
+
+Or, specify the path using pystand itself:
+
+```sh
+uv venv -p $(pystand path 3.12)
+```
+
+Or, use the `pystand uv` wrapper command:
+
+```sh
+pystand uv venv -p 3.12
+```
+
+For the common case where you simply want to use the latest `pystand` Python
+release you can omit the `-p` option (and `pystand` will specify it to `uv`
+under the hood): :
+
+```sh
+pystand uv venv
+```
+
+Note if you use the `pystand uv` wrapper, and want to specify switches to the
+`uv` command, you must use `--` to separate `uv` arguments from `pystand uv`
+arguments. E.g.:
+
+```sh
+pystand uv tool install -p 3.12 cowsay -- --verbose
+```
+
+`pystand` also provides a similar wrapper command `pystand uvx` for [`uvx`][uvx]
+commands.
 
-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).
+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.
 
 ## License
 
@@ -649,6 +745,8 @@ FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License at
 [pbs-rel]: https://github.com/astral-sh/python-build-standalone/releases
 [pipx]: https://github.com/pypa/pipx
 [pipxu]: https://github.com/bulletmark/pipxu
+[uv]: https://docs.astral.sh/uv
+[uvx]: https://docs.astral.sh/uv/guides/tools/#running-tools
 [uvtool]: https://docs.astral.sh/uv/guides/tools/#installing-tools
 [pyenv]: https://github.com/pyenv/pyenv
 [pdm]: https://pdm-project.org/

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

@@ -15,6 +15,9 @@ provided:
  |`list`|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.|
+ |`uv`|Run a uv command using a version of python installed by pystand.|
+ |`uvx`|Run a program using uvx and a version of python installed by pystand.|
 
 By default, Python versions are sourced from the latest
 `python-build-standalone` [release][pbs-rel] available (e.g.
@@ -82,11 +85,11 @@ Version 3.12.3 is already installed.
 Here are some examples showing how to use an installed version ..
 
 ```sh
-# Use uv to create a virtual environment to be run with latest pystand
+# Use uv to create a virtual environment to be run with pystand
 # installed python 3.12:
 $ uv venv -p $(pystand path 3.12) myenv
 
-# Create a regular virtual environment to be run with latest pystand
+# Create a regular virtual environment to be run with pystand
 # installed python 3.12:
 $ $(pystand path -p 3.12) -m venv myenv
 
@@ -122,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} ...
+                  {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-
@@ -139,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
@@ -162,16 +165,22 @@ options:
   -V, --version         just show pystand version
 
 Commands:
-  {install,update,upgrade,remove,uninstall,list,show,path,cache}
-    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
+                        installed by pystand.
 
 Some commands offer aliases as shown in parentheses above. Note you can set
 default starting global options in ~/.config/pystand-flags.conf.
@@ -205,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`
@@ -228,7 +239,7 @@ options:
   -k, --keep            keep old version after updating (but only if different
                         version number)
 
-aliases: upgrade
+aliases: u, upgrade
 ```
 
 ### Command `remove`
@@ -250,7 +261,7 @@ options:
                         only remove versions if from specified YYYMMDD release
                         (e.g. 20240415)
 
-aliases: uninstall
+aliases: r, uninstall
 ```
 
 ### Command `list`
@@ -270,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`
@@ -293,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`
@@ -310,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`
@@ -331,6 +348,46 @@ options:
   -R, --remove-all-unused
                         remove caches for all currently unused releases
                         instead of showing size
+
+aliases: c
+```
+
+### Command `uv`
+
+```
+usage: pystand uv [-h] [-p PYTHON]
+                     command [subcommand] [uv_args_for_command ...]
+
+Run a uv command using a version of python installed by pystand.
+
+positional arguments:
+  command              uv command to run
+  subcommand           optional uv sub-command
+  uv_args_for_command  optional extra arguments to pass to uv command [sub-
+                       command], start any options with "-- "
+
+options:
+  -h, --help           show this help message and exit
+  -p, --python PYTHON  version of python to use, e.g. "3.12", default is
+                       latest release version
+```
+
+### Command `uvx`
+
+```
+usage: pystand uvx [-h] [-p PYTHON] program [uvx_args_for_program ...]
+
+Run a program using uvx and a version of python installed by pystand.
+
+positional arguments:
+  program               uvx program to run
+  uvx_args_for_program  optional extra arguments to pass to uvx program, start
+                        any options with "-- "
+
+options:
+  -h, --help            show this help message and exit
+  -p, --python PYTHON   version of python to use, e.g. "3.12", default is
+                        latest release version
 ```
 
 ## Installation and Upgrade
@@ -570,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
 
@@ -603,14 +661,53 @@ The available options are:
 Specify the option on the command line with `--cert`, or set that as a [default
 option](#command-default-options).
 
-## Command Line Tab Completion
+## Direct Usage with UV Tool
+
+Many [`uv`][uv] commands accept a `-p/--python` option to specify a Python
+version or path. To use a `pystand` installed Python version, instead of the
+`uv` maintained or system python, you can use one of the following approaches:
+
+E.g. To create a `uv venv` using `pystand` installed 3.12, just hard code the
+path directly, e.g. for a Linux platform:
+
+```sh
+uv venv -p ~/.local/share/pystand/3.12
+```
+
+Or, specify the path using pystand itself:
+
+```sh
+uv venv -p $(pystand path 3.12)
+```
+
+Or, use the `pystand uv` wrapper command:
+
+```sh
+pystand uv venv -p 3.12
+```
+
+For the common case where you simply want to use the latest `pystand` Python
+release you can omit the `-p` option (and `pystand` will specify it to `uv`
+under the hood): :
+
+```sh
+pystand uv venv
+```
+
+Note if you use the `pystand uv` wrapper, and want to specify switches to the
+`uv` command, you must use `--` to separate `uv` arguments from `pystand uv`
+arguments. E.g.:
+
+```sh
+pystand uv tool install -p 3.12 cowsay -- --verbose
+```
+
+`pystand` also provides a similar wrapper command `pystand uvx` for [`uvx`][uvx]
+commands.
 
-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).
+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.
 
 ## License
 
@@ -629,6 +726,8 @@ FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License at
 [pbs-rel]: https://github.com/astral-sh/python-build-standalone/releases
 [pipx]: https://github.com/pypa/pipx
 [pipxu]: https://github.com/bulletmark/pipxu
+[uv]: https://docs.astral.sh/uv
+[uvx]: https://docs.astral.sh/uv/guides/tools/#running-tools
 [uvtool]: https://docs.astral.sh/uv/guides/tools/#installing-tools
 [pyenv]: https://github.com/pyenv/pyenv
 [pdm]: https://pdm-project.org/

{pystand-2.26 → pystand-2.28}/justfile

@@ -1,4 +1,4 @@
-PYFILES := file_name(justfile_dir()) + '.py'
+PYFILES := file_name(justfile_directory()) + '.py'
 
 check:
 	ruff check {{PYFILES}}

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

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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pystand
-Version: 2.26
+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
@@ -35,6 +34,9 @@ provided:
  |`list`|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.|
+ |`uv`|Run a uv command using a version of python installed by pystand.|
+ |`uvx`|Run a program using uvx and a version of python installed by pystand.|
 
 By default, Python versions are sourced from the latest
 `python-build-standalone` [release][pbs-rel] available (e.g.
@@ -102,11 +104,11 @@ Version 3.12.3 is already installed.
 Here are some examples showing how to use an installed version ..
 
 ```sh
-# Use uv to create a virtual environment to be run with latest pystand
+# Use uv to create a virtual environment to be run with pystand
 # installed python 3.12:
 $ uv venv -p $(pystand path 3.12) myenv
 
-# Create a regular virtual environment to be run with latest pystand
+# Create a regular virtual environment to be run with pystand
 # installed python 3.12:
 $ $(pystand path -p 3.12) -m venv myenv
 
@@ -142,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} ...
+                  {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-
@@ -159,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
@@ -182,16 +184,22 @@ options:
   -V, --version         just show pystand version
 
 Commands:
-  {install,update,upgrade,remove,uninstall,list,show,path,cache}
-    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
+                        installed by pystand.
 
 Some commands offer aliases as shown in parentheses above. Note you can set
 default starting global options in ~/.config/pystand-flags.conf.
@@ -225,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`
@@ -248,7 +258,7 @@ options:
   -k, --keep            keep old version after updating (but only if different
                         version number)
 
-aliases: upgrade
+aliases: u, upgrade
 ```
 
 ### Command `remove`
@@ -270,7 +280,7 @@ options:
                         only remove versions if from specified YYYMMDD release
                         (e.g. 20240415)
 
-aliases: uninstall
+aliases: r, uninstall
 ```
 
 ### Command `list`
@@ -290,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`
@@ -313,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`
@@ -330,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`
@@ -351,6 +367,46 @@ options:
   -R, --remove-all-unused
                         remove caches for all currently unused releases
                         instead of showing size
+
+aliases: c
+```
+
+### Command `uv`
+
+```
+usage: pystand uv [-h] [-p PYTHON]
+                     command [subcommand] [uv_args_for_command ...]
+
+Run a uv command using a version of python installed by pystand.
+
+positional arguments:
+  command              uv command to run
+  subcommand           optional uv sub-command
+  uv_args_for_command  optional extra arguments to pass to uv command [sub-
+                       command], start any options with "-- "
+
+options:
+  -h, --help           show this help message and exit
+  -p, --python PYTHON  version of python to use, e.g. "3.12", default is
+                       latest release version
+```
+
+### Command `uvx`
+
+```
+usage: pystand uvx [-h] [-p PYTHON] program [uvx_args_for_program ...]
+
+Run a program using uvx and a version of python installed by pystand.
+
+positional arguments:
+  program               uvx program to run
+  uvx_args_for_program  optional extra arguments to pass to uvx program, start
+                        any options with "-- "
+
+options:
+  -h, --help            show this help message and exit
+  -p, --python PYTHON   version of python to use, e.g. "3.12", default is
+                        latest release version
 ```
 
 ## Installation and Upgrade
@@ -590,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
 
@@ -623,14 +680,53 @@ The available options are:
 Specify the option on the command line with `--cert`, or set that as a [default
 option](#command-default-options).
 
-## Command Line Tab Completion
+## Direct Usage with UV Tool
+
+Many [`uv`][uv] commands accept a `-p/--python` option to specify a Python
+version or path. To use a `pystand` installed Python version, instead of the
+`uv` maintained or system python, you can use one of the following approaches:
+
+E.g. To create a `uv venv` using `pystand` installed 3.12, just hard code the
+path directly, e.g. for a Linux platform:
+
+```sh
+uv venv -p ~/.local/share/pystand/3.12
+```
+
+Or, specify the path using pystand itself:
+
+```sh
+uv venv -p $(pystand path 3.12)
+```
+
+Or, use the `pystand uv` wrapper command:
+
+```sh
+pystand uv venv -p 3.12
+```
+
+For the common case where you simply want to use the latest `pystand` Python
+release you can omit the `-p` option (and `pystand` will specify it to `uv`
+under the hood): :
+
+```sh
+pystand uv venv
+```
+
+Note if you use the `pystand uv` wrapper, and want to specify switches to the
+`uv` command, you must use `--` to separate `uv` arguments from `pystand uv`
+arguments. E.g.:
+
+```sh
+pystand uv tool install -p 3.12 cowsay -- --verbose
+```
+
+`pystand` also provides a similar wrapper command `pystand uvx` for [`uvx`][uvx]
+commands.
 
-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).
+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.
 
 ## License
 
@@ -649,6 +745,8 @@ FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License at
 [pbs-rel]: https://github.com/astral-sh/python-build-standalone/releases
 [pipx]: https://github.com/pypa/pipx
 [pipxu]: https://github.com/bulletmark/pipxu
+[uv]: https://docs.astral.sh/uv
+[uvx]: https://docs.astral.sh/uv/guides/tools/#running-tools
 [uvtool]: https://docs.astral.sh/uv/guides/tools/#installing-tools
 [pyenv]: https://github.com/pyenv/pyenv
 [pdm]: https://pdm-project.org/

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

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

{pystand-2.26 → 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
@@ -14,6 +13,7 @@ import platform
 import re
 import shutil
 import ssl
+import subprocess
 import sys
 import time
 from collections import defaultdict
@@ -23,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'
@@ -114,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':
@@ -136,6 +144,12 @@ def get_version() -> str:
     return ver
 
 
+def get_major_version(args: Namespace) -> str | None:
+    '"Return the latest major version installed"'
+    vers = sorted(f.name for f in args._versions.glob('[3-9]'))
+    return vers[-1] if vers else None
+
+
 def get_json(file: Path) -> dict[str, Any]:
     from json import load
 
@@ -582,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)
@@ -598,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}')
 
 
@@ -631,7 +650,6 @@ def remove(args: Namespace, version: str) -> None:
 
 def strip_binaries(vdir: Path, distribution: str) -> bool:
     "Strip binaries from files in a version directory"
-    from subprocess import DEVNULL, run
 
     # Only run the strip command on Linux hosts and for Linux distributions
     was_stripped = False
@@ -645,7 +663,7 @@ def strip_binaries(vdir: Path, distribution: str) -> bool:
                 if not file.is_symlink() and file.is_file():
                     cmd = f'strip -p --strip-unneeded {file}'.split()
                     try:
-                        run(cmd, stderr=DEVNULL)
+                        subprocess.run(cmd, stderr=subprocess.DEVNULL)
                     except Exception:
                         pass
                     else:
@@ -734,14 +752,31 @@ def create_cert(option: str) -> ssl.SSLContext | None:
     return ssl._create_unverified_context()
 
 
+def run_uv(args: Namespace, cmd: list[str], cmdopts: list[str]) -> str | None:
+    "Run a uv command with the specified or latest installed python version"
+    if not (vers := (args.python or get_major_version(args))):
+        return 'No installed python version found.'
+
+    py = args._versions / vers
+    if not py.is_dir():
+        return f'No installed python {py.name} version found.'
+
+    # Resolve to at least minor version if only major version specified
+    if '.' not in py.name:
+        py = py.resolve()
+        py = py.with_name(py.stem)
+
+    subprocess.run(cmd + ['-p', py] + cmdopts)
+
+
 def main() -> str | None:
     "Main code"
     distro_default = DISTRIBUTIONS.get((platform.system(), platform.machine()))
     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(
@@ -760,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(
@@ -832,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:
@@ -889,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:
@@ -988,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:
@@ -1075,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:
@@ -1116,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(
@@ -1204,6 +1240,7 @@ class show_:
     View available releases and their distributions at
     {GITHUB_SITE}/releases.
     """
+    aliases = ['s']
 
     @staticmethod
     def init(parser: ArgumentParser) -> None:
@@ -1278,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(
@@ -1329,6 +1368,8 @@ class path_:
 class cache_:
     "Show size of release download caches."
 
+    aliases = ['c']
+
     @staticmethod
     def init(parser: ArgumentParser) -> None:
         parser.add_argument(
@@ -1395,5 +1436,59 @@ class cache_:
                 show_cache_size(args._downloads, args)
 
 
+# COMMAND
+class uv_:
+    __doc__ = f'Run a uv command using a version of python installed by {PROG}.'
+
+    @staticmethod
+    def init(parser: ArgumentParser) -> None:
+        parser.add_argument(
+            '-p',
+            '--python',
+            help='version of python to use, e.g. "3.12", default is latest release version',
+        )
+
+        parser.add_argument('command', help='uv command to run')
+        parser.add_argument('subcommand', nargs='?', help='optional uv sub-command')
+
+        parser.add_argument(
+            'uv_args_for_command',
+            nargs='*',
+            help='optional extra arguments to pass to uv command [sub-command], start any options with "-- "',
+        )
+
+    @staticmethod
+    def run(args: Namespace) -> str | None:
+        cmd = ['uv', args.command]
+        if args.subcommand:
+            cmd.append(args.subcommand)
+
+        return run_uv(args, cmd, args.uv_args_for_command)
+
+
+# COMMAND
+class uvx_:
+    __doc__ = f'Run a program using uvx and a version of python installed by {PROG}.'
+
+    @staticmethod
+    def init(parser: ArgumentParser) -> None:
+        parser.add_argument(
+            '-p',
+            '--python',
+            help='version of python to use, e.g. "3.12", default is latest release version',
+        )
+
+        parser.add_argument('program', help='uvx program to run')
+        parser.add_argument(
+            'uvx_args_for_program',
+            nargs='*',
+            help='optional extra arguments to pass to uvx program, start any options with "-- "',
+        )
+
+    @staticmethod
+    def run(args: Namespace) -> str | None:
+        return run_uv(args, ['uvx'], [args.program] + args.uvx_args_for_program)
+
+
 if __name__ == '__main__':
     sys.exit(main())