pystand 2.26__tar.gz → 2.27__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pystand
-Version: 2.26
+Version: 2.27
 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
@@ -35,6 +35,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 +105,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 +145,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,update,upgrade,remove,uninstall,list,show,path,cache,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-
@@ -182,7 +185,7 @@ options:
   -V, --version         just show pystand version
 
 Commands:
-  {install,update,upgrade,remove,uninstall,list,show,path,cache}
+  {install,update,upgrade,remove,uninstall,list,show,path,cache,uv,uvx}
     install             Install one, more, or all versions from a python-
                         build-standalone release.
     update (upgrade)    Update one, more, or all versions to another release.
@@ -192,6 +195,10 @@ Commands:
     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.
 
 Some commands offer aliases as shown in parentheses above. Note you can set
 default starting global options in ~/.config/pystand-flags.conf.
@@ -353,6 +360,44 @@ options:
                         instead of showing size
 ```
 
+### 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
 
 Python 3.8 or later is required. Arch Linux users can install [`pystand`
@@ -623,13 +668,61 @@ The available options are:
 Specify the option on the command line with `--cert`, or set that as a [default
 option](#command-default-options).
 
+## 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.
+
+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
+[`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
@@ -649,6 +742,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.27}/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,update,upgrade,remove,uninstall,list,show,path,cache,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,7 +165,7 @@ options:
   -V, --version         just show pystand version
 
 Commands:
-  {install,update,upgrade,remove,uninstall,list,show,path,cache}
+  {install,update,upgrade,remove,uninstall,list,show,path,cache,uv,uvx}
     install             Install one, more, or all versions from a python-
                         build-standalone release.
     update (upgrade)    Update one, more, or all versions to another release.
@@ -172,6 +175,10 @@ Commands:
     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.
 
 Some commands offer aliases as shown in parentheses above. Note you can set
 default starting global options in ~/.config/pystand-flags.conf.
@@ -333,6 +340,44 @@ options:
                         instead of showing size
 ```
 
+### 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
 
 Python 3.8 or later is required. Arch Linux users can install [`pystand`
@@ -603,13 +648,61 @@ The available options are:
 Specify the option on the command line with `--cert`, or set that as a [default
 option](#command-default-options).
 
+## 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.
+
+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
+[`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
@@ -629,6 +722,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.27}/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.27/pystand.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pystand
-Version: 2.26
+Version: 2.27
 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
@@ -35,6 +35,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 +105,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 +145,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,update,upgrade,remove,uninstall,list,show,path,cache,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-
@@ -182,7 +185,7 @@ options:
   -V, --version         just show pystand version
 
 Commands:
-  {install,update,upgrade,remove,uninstall,list,show,path,cache}
+  {install,update,upgrade,remove,uninstall,list,show,path,cache,uv,uvx}
     install             Install one, more, or all versions from a python-
                         build-standalone release.
     update (upgrade)    Update one, more, or all versions to another release.
@@ -192,6 +195,10 @@ Commands:
     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.
 
 Some commands offer aliases as shown in parentheses above. Note you can set
 default starting global options in ~/.config/pystand-flags.conf.
@@ -353,6 +360,44 @@ options:
                         instead of showing size
 ```
 
+### 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
 
 Python 3.8 or later is required. Arch Linux users can install [`pystand`
@@ -623,13 +668,61 @@ The available options are:
 Specify the option on the command line with `--cert`, or set that as a [default
 option](#command-default-options).
 
+## 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.
+
+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
+[`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
@@ -649,6 +742,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.27}/pystand.py

@@ -14,6 +14,7 @@ import platform
 import re
 import shutil
 import ssl
+import subprocess
 import sys
 import time
 from collections import defaultdict
@@ -136,6 +137,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
 
@@ -631,7 +638,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 +651,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,6 +740,23 @@ 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()))
@@ -1395,5 +1418,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())