pystand 1.9__tar.gz → 1.10__tar.gz

{pystand-1.9/pystand.egg-info → pystand-1.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pystand
-Version: 1.9
+Version: 1.10
 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
@@ -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 release 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.9 → pystand-1.10}/README.md

@@ -70,14 +70,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
@@ -256,12 +259,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 release version if
+                     not specified
 
 options:
   -h, --help         show this help message and exit
@@ -333,6 +337,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.9 → pystand-1.10/pystand.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pystand
-Version: 1.9
+Version: 1.10
 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
@@ -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 release 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.9 → pystand-1.10}/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
 
@@ -830,7 +839,9 @@ 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 '
+                            'release version if not specified')
 
     @staticmethod
     def run(args: Namespace) -> str | None: