pystand 1.9__py3-none-any.whl → 1.11__py3-none-any.whl

{pystand-1.9.dist-info → pystand-1.11.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pystand
-Version: 1.9
+Version: 1.11
 Summary: Install Python versions from python-build-standalone project
 Author-email: Mark Blakeney <mark.blakeney@bullet-systems.net>
 License: GPLv3
@@ -86,14 +86,17 @@ $ pystand list
 Here are some examples showing how to use an installed version ..
 
 ```sh
-# Use uv to create a virtual environment to be run with pystand installed python:
-$ uv venv -p $(pystand path 3.12) myenv
+# Use uv to create a virtual environment to be run with latest pystand
+# installed python:
+$ uv venv -p $(pystand path) myenv
 
-# Create a regular virtual environment to be run with pystand installed python:
-$ $(pystand path -p 3.12) -m venv myenv
+# Create a regular virtual environment to be run with latest pystand
+# installed python:
+$ $(pystand path -p) -m venv myenv
 
-# Use pipx to install a package to be run with pystand installed python:
-$ pipx install --python $(pystand path -p 3.12) cowsay
+# Use pipx to install a package to be run with pystand installed python
+# specific version:
+$ pipx install --python $(pystand path -p 3.11) cowsay
 ```
 
 See detailed usage information in the [Usage](#usage) section that
@@ -152,7 +155,7 @@ options:
                         rate limiting.
   --no-strip            do not use or create stripped binaries
   --no-extra-strip      do not restrip already stripped source binaries
-  -V                    show pystand version
+  -V, --version         just show pystand version
 
 Commands:
   {install,update,remove,list,show,path}
@@ -272,12 +275,13 @@ options:
 ### Command `path`
 
 ```
-usage: pystand path [-h] [-p] version
+usage: pystand path [-h] [-p] [version]
 
 Show path prefix to installed version base directory.
 
 positional arguments:
-  version            version to return path for
+  version            version to return path for, or latest installed version
+                     if not specified
 
 options:
   -h, --help         show this help message and exit
@@ -349,6 +353,18 @@ The global options: `--distribution`, `--base-dir`, `--cache-minutes`,
 `--no-extra-strip` are the only sensible candidates to consider setting
 as defaults.
 
+## Github API Rate Limiting
+
+This tool minimises and caches Github API responses from the
+[`python-build-standalone`][pbs] repository. However, if you install
+many different versions particularly across various releases, you may
+get rate limited by Github so the command will block and you will see
+"backoff" messages reported. You can create a Github access token to
+gain increased rate limits. Create a token in your Github account under
+`Settings -> Developer settings -> Personal access tokens`. Specify the
+token on the command line with `--github-access-token`, or set that as a
+[default option](#command-default-options).
+
 ## Command Line Tab Completion
 
 Command line shell [tab

pystand-1.11.dist-info/RECORD

@@ -0,0 +1,6 @@
+pystand.py,sha256=HuCNuIYwXUcVCpAzqtEEj9hdMn-S4j4F7t8yYfNuYeU,32048
+pystand-1.11.dist-info/METADATA,sha256=6NYVL_gVjjOT0kvk66KNUFfXlRU-KuGo5HBzuO16w0g,15923
+pystand-1.11.dist-info/WHEEL,sha256=GV9aMThwP_4oNCtvEC2ec3qUYutgWeAzklro_0m4WJQ,91
+pystand-1.11.dist-info/entry_points.txt,sha256=DG4ps3I3nni1bubV1tXs6u8FARgkdbAYaEAzZD4RAo8,41
+pystand-1.11.dist-info/top_level.txt,sha256=NoWUh19UQymAJLHTCdxMnVwV6Teftef5fzyF3OWLyNY,8
+pystand-1.11.dist-info/RECORD,,

{pystand-1.9.dist-info → pystand-1.11.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (74.1.2)
+Generator: setuptools (75.1.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

pystand.py

@@ -141,8 +141,17 @@ class VersionMatcher:
     def __init__(self, seq: Iterable[str]) -> None:
         self.seq = sorted(seq, key=parse_version, reverse=True)
 
-    def match(self, version: str, *, upgrade: bool = False) -> str | None:
+    def match(self, version: str | None, *,
+              upgrade: bool = False) -> str | None:
         'Return full version string given a [possibly] part version prefix'
+
+        # If no version specified, return the latest release version
+        if not version:
+            for version in self.seq:
+                if is_release_version(version):
+                    return version
+            return None
+
         if version in self.seq:
             return version
 
@@ -520,8 +529,8 @@ def main() -> str | None:
                      help='do not use or create stripped binaries')
     opt.add_argument('--no-extra-strip', action='store_true',
                      help='do not restrip already stripped source binaries')
-    opt.add_argument('-V', action='store_true',
-                     help=f'show {PROG} version')
+    opt.add_argument('-V', '--version', action='store_true',
+                     help=f'just show {PROG} version')
     cmd = opt.add_subparsers(title='Commands', dest='cmdname')
 
     # Add each command ..
@@ -560,12 +569,12 @@ def main() -> str | None:
 
     args = opt.parse_args(shlex.split(cnflines) + sys.argv[1:])
 
-    if args.V:
-        print(get_version())
-
     if 'func' not in args:
-        if not args.V:
-            opt.print_help()
+        if args.version:
+            print(get_version())
+            return None
+
+        opt.print_help()
         return None
 
     distribution = args.distribution or distro_default
@@ -830,12 +839,16 @@ class _path(COMMAND):
     def init(parser: ArgumentParser) -> None:
         parser.add_argument('-p', '--python-path', action='store_true',
                             help='return full path to python executable')
-        parser.add_argument('version', help='version to return path for')
+        parser.add_argument('version', nargs='?',
+                            help='version to return path for, or latest '
+                            'installed version if not specified')
 
     @staticmethod
     def run(args: Namespace) -> str | None:
         matcher = VersionMatcher([f.name for f in iter_versions(args)])
         version = matcher.match(args.version) or args.version
+        if not version:
+            return f'No Python version installed.'
         path = args._versions / version
         if not path.is_dir():
             return f'Version "{version}" is not installed.'

pystand-1.9.dist-info/RECORD

@@ -1,6 +0,0 @@
-pystand.py,sha256=MtVQfHakq71D_-O_56508AJAvS67LsouV7JDR4no86E,31568
-pystand-1.9.dist-info/METADATA,sha256=KnR67QfaY5HxJ2t5ddCWHGXs0hz-rm9YzVvPQ0oTLZw,15191
-pystand-1.9.dist-info/WHEEL,sha256=cVxcB9AmuTcXqmwrtPhNK88dr7IR_b6qagTj0UvIEbY,91
-pystand-1.9.dist-info/entry_points.txt,sha256=DG4ps3I3nni1bubV1tXs6u8FARgkdbAYaEAzZD4RAo8,41
-pystand-1.9.dist-info/top_level.txt,sha256=NoWUh19UQymAJLHTCdxMnVwV6Teftef5fzyF3OWLyNY,8
-pystand-1.9.dist-info/RECORD,,