pystand 2.22__tar.gz → 2.23__tar.gz

{pystand-2.22/pystand.egg-info → pystand-2.23}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pystand
-Version: 2.22
+Version: 2.23
 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
@@ -27,14 +27,14 @@ installation, and update of pre-built Python versions from the
 [`python-build-standalone`][pbs] project. The following commands are
 provided:
 
-|Command  |Description                                                         |
-|---------|--------------------------------------------------------------------|
-|`install`|Install one or more versions from a python-build-standalone release.|
-|`update` (or `upgrade`) |Update one, more, or all versions to another release.|
-|`remove` (or `uninstall`) |Remove/uninstall one, more, or all versions.|
-|`list`   |List installed versions and show which have an update available.|
-|`show`   |Show versions available from a release.|
-|`path`   |Show path prefix to installed version base directory.|
+ |Command|Description|
+ |---------|--------------------------------------------------------------------|
+ |`install`|Install one, more, or all versions from a python-build-standalone release.|
+ |`update` (or `upgrade`)|Update one, more, or all versions to another release.|
+ |`remove` (or `uninstall`)|Remove/uninstall one, more, or all versions.|
+ |`list`|List installed versions and show which have an update available.|
+ |`show`|Show versions available from a release.|
+ |`path`|Show path prefix to installed version base directory.|
 
 By default, Python versions are sourced from the latest
 `python-build-standalone` [release][pbs-rel] available (e.g.
@@ -89,6 +89,14 @@ Version 3.10.14 @ 20240415 removed.
 
 $ pystand list
 3.12.3 @ 20240415 distribution="x86_64-unknown-linux-gnu-install_only_stripped"
+
+# Install all available versions from latest release:
+$ pystand install -a
+Version 3.8.19 @ 20240415 installed.
+Version 3.9.19 @ 20240415 installed.
+Version 3.10.14 @ 20240415 installed.
+Version 3.11.9 @ 20240415 installed.
+Version 3.12.3 is already installed.
 ```
 
 Here are some examples showing how to use an installed version ..
@@ -175,8 +183,8 @@ options:
 
 Commands:
   {install,update,upgrade,remove,uninstall,list,show,path,cache}
-    install             Install one or more versions from a python-build-
-                        standalone release.
+    install             Install one, more, or all versions from a python-
+                        build-standalone release.
     update (upgrade)    Update one, more, or all versions to another release.
     remove (uninstall)  Remove/uninstall one, more, or all versions.
     list                List installed versions and show which have an update
@@ -195,9 +203,10 @@ individual command:
 ### Command `install`
 
 ```
-usage: pystand install [-h] [-r RELEASE] [-f] [-s] version [version ...]
+usage: pystand install [-h] [-r RELEASE] [-a] [-A] [--skip] [-f] [-s]
+                          [version ...]
 
-Install one or more versions from a python-build-standalone release.
+Install one, more, or all versions from a python-build-standalone release.
 
 positional arguments:
   version               version to install. E.g. 3.12 or 3.12.3
@@ -208,6 +217,11 @@ options:
                         install from specified python-build-standalone
                         YYYYMMDD release (e.g. 20240415), default is latest
                         release
+  -a, --all             install ALL versions from release
+  -A, --all-prerelease  install ALL versions from release, including pre-
+                        releases
+  --skip                skip the specified versions when installing all (only
+                        can be specified with --all)
   -f, --force           force install even if already installed
   -s, --include-source  also install source files if available in distribution
                         download

{pystand-2.22 → pystand-2.23}/README.md

@@ -7,14 +7,14 @@ installation, and update of pre-built Python versions from the
 [`python-build-standalone`][pbs] project. The following commands are
 provided:
 
-|Command  |Description                                                         |
-|---------|--------------------------------------------------------------------|
-|`install`|Install one or more versions from a python-build-standalone release.|
-|`update` (or `upgrade`) |Update one, more, or all versions to another release.|
-|`remove` (or `uninstall`) |Remove/uninstall one, more, or all versions.|
-|`list`   |List installed versions and show which have an update available.|
-|`show`   |Show versions available from a release.|
-|`path`   |Show path prefix to installed version base directory.|
+ |Command|Description|
+ |---------|--------------------------------------------------------------------|
+ |`install`|Install one, more, or all versions from a python-build-standalone release.|
+ |`update` (or `upgrade`)|Update one, more, or all versions to another release.|
+ |`remove` (or `uninstall`)|Remove/uninstall one, more, or all versions.|
+ |`list`|List installed versions and show which have an update available.|
+ |`show`|Show versions available from a release.|
+ |`path`|Show path prefix to installed version base directory.|
 
 By default, Python versions are sourced from the latest
 `python-build-standalone` [release][pbs-rel] available (e.g.
@@ -69,6 +69,14 @@ Version 3.10.14 @ 20240415 removed.
 
 $ pystand list
 3.12.3 @ 20240415 distribution="x86_64-unknown-linux-gnu-install_only_stripped"
+
+# Install all available versions from latest release:
+$ pystand install -a
+Version 3.8.19 @ 20240415 installed.
+Version 3.9.19 @ 20240415 installed.
+Version 3.10.14 @ 20240415 installed.
+Version 3.11.9 @ 20240415 installed.
+Version 3.12.3 is already installed.
 ```
 
 Here are some examples showing how to use an installed version ..
@@ -155,8 +163,8 @@ options:
 
 Commands:
   {install,update,upgrade,remove,uninstall,list,show,path,cache}
-    install             Install one or more versions from a python-build-
-                        standalone release.
+    install             Install one, more, or all versions from a python-
+                        build-standalone release.
     update (upgrade)    Update one, more, or all versions to another release.
     remove (uninstall)  Remove/uninstall one, more, or all versions.
     list                List installed versions and show which have an update
@@ -175,9 +183,10 @@ individual command:
 ### Command `install`
 
 ```
-usage: pystand install [-h] [-r RELEASE] [-f] [-s] version [version ...]
+usage: pystand install [-h] [-r RELEASE] [-a] [-A] [--skip] [-f] [-s]
+                          [version ...]
 
-Install one or more versions from a python-build-standalone release.
+Install one, more, or all versions from a python-build-standalone release.
 
 positional arguments:
   version               version to install. E.g. 3.12 or 3.12.3
@@ -188,6 +197,11 @@ options:
                         install from specified python-build-standalone
                         YYYYMMDD release (e.g. 20240415), default is latest
                         release
+  -a, --all             install ALL versions from release
+  -A, --all-prerelease  install ALL versions from release, including pre-
+                        releases
+  --skip                skip the specified versions when installing all (only
+                        can be specified with --all)
   -f, --force           force install even if already installed
   -s, --include-source  also install source files if available in distribution
                         download

{pystand-2.22 → pystand-2.23/pystand.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pystand
-Version: 2.22
+Version: 2.23
 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
@@ -27,14 +27,14 @@ installation, and update of pre-built Python versions from the
 [`python-build-standalone`][pbs] project. The following commands are
 provided:
 
-|Command  |Description                                                         |
-|---------|--------------------------------------------------------------------|
-|`install`|Install one or more versions from a python-build-standalone release.|
-|`update` (or `upgrade`) |Update one, more, or all versions to another release.|
-|`remove` (or `uninstall`) |Remove/uninstall one, more, or all versions.|
-|`list`   |List installed versions and show which have an update available.|
-|`show`   |Show versions available from a release.|
-|`path`   |Show path prefix to installed version base directory.|
+ |Command|Description|
+ |---------|--------------------------------------------------------------------|
+ |`install`|Install one, more, or all versions from a python-build-standalone release.|
+ |`update` (or `upgrade`)|Update one, more, or all versions to another release.|
+ |`remove` (or `uninstall`)|Remove/uninstall one, more, or all versions.|
+ |`list`|List installed versions and show which have an update available.|
+ |`show`|Show versions available from a release.|
+ |`path`|Show path prefix to installed version base directory.|
 
 By default, Python versions are sourced from the latest
 `python-build-standalone` [release][pbs-rel] available (e.g.
@@ -89,6 +89,14 @@ Version 3.10.14 @ 20240415 removed.
 
 $ pystand list
 3.12.3 @ 20240415 distribution="x86_64-unknown-linux-gnu-install_only_stripped"
+
+# Install all available versions from latest release:
+$ pystand install -a
+Version 3.8.19 @ 20240415 installed.
+Version 3.9.19 @ 20240415 installed.
+Version 3.10.14 @ 20240415 installed.
+Version 3.11.9 @ 20240415 installed.
+Version 3.12.3 is already installed.
 ```
 
 Here are some examples showing how to use an installed version ..
@@ -175,8 +183,8 @@ options:
 
 Commands:
   {install,update,upgrade,remove,uninstall,list,show,path,cache}
-    install             Install one or more versions from a python-build-
-                        standalone release.
+    install             Install one, more, or all versions from a python-
+                        build-standalone release.
     update (upgrade)    Update one, more, or all versions to another release.
     remove (uninstall)  Remove/uninstall one, more, or all versions.
     list                List installed versions and show which have an update
@@ -195,9 +203,10 @@ individual command:
 ### Command `install`
 
 ```
-usage: pystand install [-h] [-r RELEASE] [-f] [-s] version [version ...]
+usage: pystand install [-h] [-r RELEASE] [-a] [-A] [--skip] [-f] [-s]
+                          [version ...]
 
-Install one or more versions from a python-build-standalone release.
+Install one, more, or all versions from a python-build-standalone release.
 
 positional arguments:
   version               version to install. E.g. 3.12 or 3.12.3
@@ -208,6 +217,11 @@ options:
                         install from specified python-build-standalone
                         YYYYMMDD release (e.g. 20240415), default is latest
                         release
+  -a, --all             install ALL versions from release
+  -A, --all-prerelease  install ALL versions from release, including pre-
+                        releases
+  --skip                skip the specified versions when installing all (only
+                        can be specified with --all)
   -f, --force           force install even if already installed
   -s, --include-source  also install source files if available in distribution
                         download

{pystand-2.22 → pystand-2.23}/pystand.py

@@ -850,11 +850,10 @@ def main() -> str | None:
     args._cert = create_cert(args.cert)
 
     # Only allow one instance of this program to run (to read/write prefix and cache dirs)
-    p_lock = filelock.FileLock(prefix_dir / '.lock')
-    c_lock = filelock.FileLock(cache_dir / '.lock')
+    locks = [filelock.FileLock(d / '.lock') for d in (prefix_dir, cache_dir)]
 
     try:
-        with p_lock.acquire(blocking=False), c_lock.acquire(blocking=False):
+        with locks[0].acquire(blocking=False), locks[1].acquire(blocking=False):
             args._release = get_release_tag(args)
             result = args.func(args)
             purge_unused_releases(args)
@@ -867,7 +866,7 @@ def main() -> str | None:
 
 # COMMAND
 class install_:
-    doc = f'Install one or more versions from a {REPO} release.'
+    doc = f'Install one, more, or all versions from a {REPO} release.'
 
     @staticmethod
     def init(parser: ArgumentParser) -> None:
@@ -878,6 +877,21 @@ class install_:
             f'YYYYMMDD release (e.g. {SAMPL_RELEASE}), '
             'default is latest release',
         )
+        parser.add_argument(
+            '-a', '--all', action='store_true', help='install ALL versions from release'
+        )
+        parser.add_argument(
+            '-A',
+            '--all-prerelease',
+            action='store_true',
+            help='install ALL versions from release, including pre-releases',
+        )
+        parser.add_argument(
+            '--skip',
+            action='store_true',
+            help='skip the specified versions when '
+            'installing all (only can be specified with --all)',
+        )
         parser.add_argument(
             '-f',
             '--force',
@@ -891,7 +905,7 @@ class install_:
             help='also install source files if available in distribution download',
         )
         parser.add_argument(
-            'version', nargs='+', help='version to install. E.g. 3.12 or 3.12.3'
+            'version', nargs='*', help='version to install. E.g. 3.12 or 3.12.3'
         )
 
     @staticmethod
@@ -902,6 +916,31 @@ class install_:
             return f'Release "{release}" not found, or has no compatible files.'
 
         matcher = VersionMatcher(files)
+
+        if args.all_prerelease:
+            args.all = True
+
+        if args.all:
+            if not args.skip and args.version:
+                args.parser.error(
+                    'Can not specify versions with --all unless also specifying --skip.'
+                )
+
+            skips = set(v for ver in args.version if (v := matcher.match(ver)))
+
+            args.version = [
+                v
+                for v in files
+                if (args.all_prerelease or is_release_version(v)) and v not in skips
+            ]
+
+        else:
+            if args.skip:
+                args.parser.error('--skip can only be specified with --all.')
+
+            if not args.version:
+                args.parser.error('Must specify at least one version, or --all.')
+
         for version in args.version:
             full_version = matcher.match(version)
             if not full_version:
@@ -911,7 +950,8 @@ class install_:
             vdir = args._versions / version
 
             if vdir.exists() and not args.force:
-                return f'Version "{version}" is already installed.'
+                print(f'Version {version} is already installed.', file=sys.stderr)
+                continue
 
             if error := install(args, vdir, release, args._distribution, files):
                 return error
@@ -1244,7 +1284,7 @@ class path_:
         else:
             path = args._versions / version
             if not path.exists():
-                return f'Version "{version}" is not installed.'
+                return f'Version {version} is not installed.'
 
             if args.resolve:
                 path = path.resolve()