pystand 2.38__tar.gz → 2.40__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pystand
-Version: 2.38
+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.38 → 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.38 → pystand-2.40/pystand.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pystand
-Version: 2.38
+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.38 → pystand-2.40}/pystand.py

@@ -37,11 +37,15 @@ LATEST_RELEASE_TAG = f'{GITHUB_SITE}/releases/latest'
 DOC = 'https://gregoryszorc.com/docs/python-build-standalone/main/'
 VER = f'{sys.version_info.major}.{sys.version_info.minor}'
 
+# Seconds to wait for lock on prefix/cache dirs
+LOCK_TIMEOUT = 5
+
 # Sample release tag for documentation/usage examples
 SAMPL_RELEASE = '20260807'
 
 PROG = Path(__file__).stem
 HOME = Path.home()
+MANPATH = Path('share', 'man', 'man1', 'python.1')
 
 # Default distributions for various platforms
 DISTRIBUTIONS = {
@@ -117,9 +121,11 @@ class ColorDist(ColorTable):
 
 
 def unexpanduser(path: Path) -> 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 name, with $HOME replaced by ~, i.e. opposite of Path.expanduser() for current user"
+    startlen = len(hparts := HOME.parts)
+    parts = path.parts
+    if parts[:startlen] == hparts:
+        path = Path('~', *parts[startlen:])
 
     return path
 
@@ -714,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:
@@ -721,9 +739,7 @@ def install_version(
     version = vdir.name
 
     if not (url := files[version].get(distribution)):
-        return (
-            f'Arch "{distribution}" not found for release {release} version {version}.'
-        )
+        return f'Distribution "{distribution}" not found for release {release} version {version}.'
 
     tmpdir = args._versions / f'.{version}-tmp'
     rm_path(tmpdir)
@@ -748,6 +764,7 @@ def install_version(
     else:
         remove_version(args, version)
         tmpdir.replace(vdir)
+        ensure_manpage_link(vdir)
 
     return error
 
@@ -958,11 +975,14 @@ def main() -> str | None:
     args._latest_release = cache_dir / 'latest_release'
     args._cert = create_cert(args.cert)
 
-    # Only allow one instance of this program to run (to read/write prefix and cache dirs)
-    locks = [filelock.FileLock(d / '.lock') for d in (prefix_dir, cache_dir)]
+    def lock(path: Path) -> filelock.FileLock:
+        "Return a file lock for the given directory path"
+        return filelock.FileLock(path / '.lock', timeout=LOCK_TIMEOUT)
 
+    # Only allow one instance of this program to run (to avoid potential race
+    # condition on writtable dirs)
     try:
-        with locks[0].acquire(blocking=False), locks[1].acquire(blocking=False):
+        with lock(cache_dir), lock(prefix_dir):
             args._release = get_release_tag(args)
             args._fmtrel = ColorRel(args._release, args.no_color).format
             result = args.func(args)
@@ -971,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
 
 
@@ -1542,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.38/pystand.egg-info/scm_version.json

@@ -1,8 +0,0 @@
-{
-  "tag": "2.38",
-  "distance": 0,
-  "node": "ge58d0185e364137af825c64bde9f335ca3f68030",
-  "dirty": false,
-  "branch": "main",
-  "node_date": "2026-09-13"
-}