pystand 2.39__tar.gz → 2.41__tar.gz

{pystand-2.39/pystand.egg-info → pystand-2.41}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pystand
-Version: 2.39
+Version: 2.41
 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
@@ -143,7 +143,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,i,update,u,up,remove,r,rm,list,l,show,s,path,p,cache,c,uv,uvx} ...
+               {install,i,update,u,up,remove,r,rm,list,l,show,s,path,p,cache,c,man,m,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-
@@ -183,7 +183,7 @@ options:
   -V, --version         just show pystand version
 
 Commands:
-  {install,i,update,u,up,remove,r,rm,list,l,show,s,path,p,cache,c,uv,uvx}
+  {install,i,update,u,up,remove,r,rm,list,l,show,s,path,p,cache,c,man,m,uv,uvx}
     install (i)         Install one, more, or all versions from a python-
                         build-standalone release.
     update (u, up)      Update one, more, or all versions to another release.
@@ -193,6 +193,7 @@ Commands:
     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.
+    man (m)             Show installed man page for latest or given version.
     uv                  Run a uv command using a version of python installed
                         by pystand.
     uvx                 Run a program using uvx and a version of python
@@ -372,6 +373,22 @@ options:
 aliases: c
 ```
 
+### Command `man`
+
+```
+usage: pystand man [-h] [version]
+
+Show installed man page for latest or given version.
+
+positional arguments:
+  version     installed version to show man page for, default is latest
+
+options:
+  -h, --help  show this help message and exit
+
+aliases: m
+```
+
 ### Command `uv`
 
 ```

{pystand-2.39 → pystand-2.41}/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,i,update,u,up,remove,r,rm,list,l,show,s,path,p,cache,c,uv,uvx} ...
+               {install,i,update,u,up,remove,r,rm,list,l,show,s,path,p,cache,c,man,m,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-
@@ -165,7 +165,7 @@ options:
   -V, --version         just show pystand version
 
 Commands:
-  {install,i,update,u,up,remove,r,rm,list,l,show,s,path,p,cache,c,uv,uvx}
+  {install,i,update,u,up,remove,r,rm,list,l,show,s,path,p,cache,c,man,m,uv,uvx}
     install (i)         Install one, more, or all versions from a python-
                         build-standalone release.
     update (u, up)      Update one, more, or all versions to another release.
@@ -175,6 +175,7 @@ Commands:
     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.
+    man (m)             Show installed man page for latest or given version.
     uv                  Run a uv command using a version of python installed
                         by pystand.
     uvx                 Run a program using uvx and a version of python
@@ -354,6 +355,22 @@ options:
 aliases: c
 ```
 
+### Command `man`
+
+```
+usage: pystand man [-h] [version]
+
+Show installed man page for latest or given version.
+
+positional arguments:
+  version     installed version to show man page for, default is latest
+
+options:
+  -h, --help  show this help message and exit
+
+aliases: m
+```
+
 ### Command `uv`
 
 ```

{pystand-2.39 → pystand-2.41/pystand.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pystand
-Version: 2.39
+Version: 2.41
 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
@@ -143,7 +143,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,i,update,u,up,remove,r,rm,list,l,show,s,path,p,cache,c,uv,uvx} ...
+               {install,i,update,u,up,remove,r,rm,list,l,show,s,path,p,cache,c,man,m,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-
@@ -183,7 +183,7 @@ options:
   -V, --version         just show pystand version
 
 Commands:
-  {install,i,update,u,up,remove,r,rm,list,l,show,s,path,p,cache,c,uv,uvx}
+  {install,i,update,u,up,remove,r,rm,list,l,show,s,path,p,cache,c,man,m,uv,uvx}
     install (i)         Install one, more, or all versions from a python-
                         build-standalone release.
     update (u, up)      Update one, more, or all versions to another release.
@@ -193,6 +193,7 @@ Commands:
     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.
+    man (m)             Show installed man page for latest or given version.
     uv                  Run a uv command using a version of python installed
                         by pystand.
     uvx                 Run a program using uvx and a version of python
@@ -372,6 +373,22 @@ options:
 aliases: c
 ```
 
+### Command `man`
+
+```
+usage: pystand man [-h] [version]
+
+Show installed man page for latest or given version.
+
+positional arguments:
+  version     installed version to show man page for, default is latest
+
+options:
+  -h, --help  show this help message and exit
+
+aliases: m
+```
+
 ### Command `uv`
 
 ```

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

@@ -0,0 +1,8 @@
+{
+  "tag": "2.41",
+  "distance": 0,
+  "node": "gdec583e581b565992eeeaae95cb1cd013866f115",
+  "dirty": false,
+  "branch": "main",
+  "node_date": "2026-10-20"
+}

{pystand-2.39 → pystand-2.41}/pystand.py

@@ -6,25 +6,24 @@ https://github.com/astral-sh/python-build-standalone.
 
 from __future__ import annotations
 
-import itertools
+import sys
+
+if sys.version_info >= (3, 15):
+    sys.set_lazy_imports('all')
+
 import os
 import platform
 import re
-import shlex
 import shutil
 import ssl
 import subprocess
-import sys
 import time
-from collections import defaultdict
 from collections.abc import Iterable, Iterator
-from datetime import date, datetime
 from pathlib import Path
 from typing import Any
 from urllib.request import urlopen
 
 import filelock
-import platformdirs
 from argparse_from_file import ArgumentParser, Namespace
 from packaging.version import InvalidVersion
 from packaging.version import parse as parse_version
@@ -45,6 +44,7 @@ SAMPL_RELEASE = '20260807'
 
 PROG = Path(__file__).stem
 HOME = Path.home()
+MANPATH = Path('share', 'man', 'man1', 'python.1')
 
 # Default distributions for various platforms
 DISTRIBUTIONS = {
@@ -82,6 +82,8 @@ class ColorTable:
     "Base class for color tables"
 
     def __init__(self, initval: str, no_color: bool) -> None:
+        import itertools
+
         self.table = None if no_color else {self.parse_key(initval): COLORS[0]}
         self.next = itertools.cycle(COLORS[1:-1])
 
@@ -377,6 +379,8 @@ def get_version_names(args: Namespace) -> list[str]:
 
 def check_release_tag(release: str) -> str | None:
     "Check the specified release tag is valid"
+    from datetime import date
+
     if not release.isdigit() or len(release) != len(SAMPL_RELEASE):
         return 'Release must be a YYYYMMDD string.'
 
@@ -514,6 +518,8 @@ def get_release_files(args, tag) -> dict[str, Any]:
 
 def update_version_symlinks(args: Namespace) -> None:
     "Create/update symlinks pointing to latest version"
+    from collections import defaultdict
+
     base = args._versions
     if not base.exists():
         return
@@ -602,6 +608,8 @@ def purge_unused_releases(args: Namespace) -> None:
 
 def show_list(args: Namespace, re_match: re.Pattern | None) -> None:
     "Show a list of available releases"
+    from datetime import datetime
+
     try:
         latest = parse_version(args._release)
     except InvalidVersion:
@@ -719,6 +727,18 @@ def compile_bytecode(srcdir: Path, tgtdir: Path) -> str | None:
     return None
 
 
+def ensure_manpage_link(vdir: Path) -> None:
+    "Ensure a symlink to the man page for this version exists"
+    manpath = vdir / MANPATH
+    if manpath.is_symlink() or manpath.exists():
+        return
+
+    for path in manpath.parent.iterdir():
+        if not path.is_symlink() and path.name.startswith('python'):
+            manpath.symlink_to(path.name)
+            break
+
+
 def install_version(
     args: Namespace, vdir: Path, release: str, distribution: str, files: dict[str, Any]
 ) -> str | None:
@@ -749,6 +769,7 @@ def install_version(
     if error:
         shutil.rmtree(tmpdir)
     else:
+        ensure_manpage_link(tmpdir)
         remove_version(args, version)
         tmpdir.replace(vdir)
 
@@ -804,6 +825,8 @@ def create_cert(option: str) -> ssl.SSLContext | None:
 
 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"
+    import shlex
+
     if not (vers := (args.python or get_major_version(args))):
         return 'No installed python version found.'
 
@@ -828,6 +851,8 @@ commands = []
 
 def main() -> str | None:
     "Main code"
+    import platformdirs
+
     distro_default = DISTRIBUTIONS.get((platform.system(), platform.machine()))
     distro_help = distro_default or '?unknown?'
 
@@ -977,6 +1002,15 @@ def main() -> str | None:
     except filelock.Timeout:
         return f'ERROR: Another instance of {PROG} is already running.'
 
+    # If the command returned a tuple, treat it as a subprocess command to run
+    if isinstance(result, tuple):
+        try:
+            subprocess.run(result)
+        except Exception as e:
+            result = f'Error running command: {e}'
+        else:
+            result = None
+
     return result
 
 
@@ -1548,6 +1582,36 @@ class cache:
                 show_cache_size(args._downloads, args)
 
 
+@Command
+class man:
+    "Show installed man page for latest or given version."
+
+    aliases = ('m',)
+
+    @staticmethod
+    def init(parser: ArgumentParser) -> None:
+        parser.add_argument(
+            'version',
+            nargs='?',
+            help='installed version to show man page for, default is latest',
+        )
+
+    @staticmethod
+    def run(args: Namespace) -> str | tuple | None:
+        if not (version := args.version):
+            version = get_major_version(args)
+
+        vdir = (args._versions / version).resolve()
+        if not vdir.exists():
+            return f'Version {version} is not installed.'
+
+        man_path = (vdir / MANPATH).parent.parent
+        if not man_path.is_dir():
+            return f'No man page found for version {version}.'
+
+        return ('man', '-M', str(man_path), 'python')
+
+
 @Command
 class uv:
     __doc__ = f'Run a uv command using a version of python installed by {PROG}.'

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

@@ -1,8 +0,0 @@
-{
-  "tag": "2.39",
-  "distance": 0,
-  "node": "g3bfced01900026625a7fe977f022eed41afa2c53",
-  "dirty": false,
-  "branch": "main",
-  "node_date": "2026-09-24"
-}