pystand 2.39__tar.gz → 2.40__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pystand
-Version: 2.39
+Version: 2.40
 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
+
+options:
+  -h, --help  show this help message and exit
+
+aliases: m
+```
+
 ### Command `uv`
 
 ```

{pystand-2.39 → pystand-2.40}/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
+
+options:
+  -h, --help  show this help message and exit
+
+aliases: m
+```
+
 ### Command `uv`
 
 ```

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pystand
-Version: 2.39
+Version: 2.40
 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
+
+options:
+  -h, --help  show this help message and exit
+
+aliases: m
+```
+
 ### Command `uv`
 
 ```

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

@@ -0,0 +1,8 @@
+{
+  "tag": "2.40",
+  "distance": 0,
+  "node": "g9abbd4e9ec899e5c4c00d23d30bba5a63cae906e",
+  "dirty": false,
+  "branch": "main",
+  "node_date": "2026-09-25"
+}

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

@@ -45,6 +45,7 @@ SAMPL_RELEASE = '20260807'
 
 PROG = Path(__file__).stem
 HOME = Path.home()
+MANPATH = Path('share', 'man', 'man1', 'python.1')
 
 # Default distributions for various platforms
 DISTRIBUTIONS = {
@@ -719,6 +720,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_file():
+        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:
@@ -751,6 +764,7 @@ def install_version(
     else:
         remove_version(args, version)
         tmpdir.replace(vdir)
+        ensure_manpage_link(vdir)
 
     return error
 
@@ -977,6 +991,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 +1571,34 @@ 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'
+        )
+
+    @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"
-}