pystand 2.17__py3-none-any.whl → 2.18__py3-none-any.whl

{pystand-2.17.dist-info → pystand-2.18.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pystand
-Version: 2.17
+Version: 2.18
 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
@@ -12,6 +12,7 @@ Description-Content-Type: text/markdown
 Requires-Dist: argcomplete
 Requires-Dist: packaging
 Requires-Dist: platformdirs
+Requires-Dist: argparse-from-file
 Requires-Dist: pygithub
 Requires-Dist: certifi
 Requires-Dist: zstandard; python_version < "3.14"
@@ -25,14 +26,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 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.|
 
 By default, Python versions are sourced from the latest
 `python-build-standalone` [release][pbs-rel] available (e.g.
@@ -147,25 +148,25 @@ options:
                         distributions.
   -P, --prefix-dir PREFIX_DIR
                         specify prefix dir for storing versions. Default is
-                        "$HOME/.local/share/pystand"
+                        "$HOME/.local/share/pystand".
   -C, --cache-dir CACHE_DIR
                         specify cache dir for downloads. Default is
-                        "$HOME/.cache/pystand"
+                        "$HOME/.cache/pystand".
   -M, --cache-minutes CACHE_MINUTES
                         cache latest YYYYMMDD release tag fetch for this many
                         minutes, before rechecking for latest. Default is 60
-                        minutes
+                        minutes.
   --purge-days PURGE_DAYS
                         cache YYYYMMDD release file lists and downloads for
                         this number of days after last version referencing
-                        that release is removed. Default is 90 days
+                        that release is removed. Default is 90 days.
   --github-access-token GITHUB_ACCESS_TOKEN
                         optional Github access token. Can specify to reduce
                         rate limiting.
   --no-strip            do not strip downloaded binaries
   --cert {system,certifi,none}
                         specify which SSL certificates to use for HTTPS
-                        requests. Default="system"
+                        requests. Default="system".
   -V, --version         just show pystand version
 
 Commands:
@@ -566,9 +567,8 @@ anything after on a line) are ignored. Type `pystand` to see all
 supported options.
 
 The global options: `--distribution`, `--prefix-dir`, `--cache-dir`,
-`--cache-minutes`, `--purge-days`, `--github-access-token`,
-`--no-strip`, are the only sensible candidates to consider setting
-as defaults.
+`--cache-minutes`, `--purge-days`, `--github-access-token`, `--no-strip`,
+`--cert` are the only sensible candidates to consider setting as defaults.
 
 ## Github API Rate Limiting
 
@@ -583,6 +583,24 @@ either a Github "fine-grained" or "classic" token. Specify the token on
 the command line with `--github-access-token`, or set that as a [default
 option](#command-default-options).
 
+## HTTPS Certificate Verification
+
+A global option `--cert` is provided to specify which SSL certificates to use
+for HTTPS requests. This is useful if you are running `pystand` in an
+environment where the system certificates are not available, or you want to use
+the bundled [`certifi`][certifi] certificates instead.
+
+The available options are:
+
+|Option   |Description
+|-------- |------------
+|`system` |Use system certificates (as used normally by Python). This is the default.|
+|`certifi`|Use the [`certifi`][certifi] package, i.e. use the certificates bundled within the application.|
+|`none`   |Perform unverified https requests (best to avoid using this).|
+
+Specify the option on the command line with `--cert`, or set that as a [default
+option](#command-default-options).
+
 ## Command Line Tab Completion
 
 Command line shell [tab
@@ -602,7 +620,7 @@ either version 3 of the License, or any later version. This program is
 distributed in the hope that it will be useful, but WITHOUT ANY
 WARRANTY; without even the implied warranty of MERCHANTABILITY or
 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License at
-<https://en.wikipedia.org/wiki/GNU_General_Public_License> for more details.
+<https://opensource.org/license/gpl-3-0> for more details.
 
 [pystand]: https://github.com/bulletmark/pystand
 [pbs]: https://github.com/astral-sh/python-build-standalone
@@ -616,5 +634,6 @@ FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License at
 [hatch]: https://hatch.pypa.io/
 [hatchpy]: https://hatch.pypa.io/latest/tutorials/python/manage/
 [ryepy]: https://rye.astral.sh/guide/toolchains/#fetching-toolchains
+[certifi]: https://pypi.org/project/certifi/
 
 <!-- vim: se ai syn=markdown: -->

pystand-2.18.dist-info/RECORD

@@ -0,0 +1,6 @@
+pystand.py,sha256=gszpzgPfqC4D20miYkJBrXwHQRnPc_JkfV_jRX_7N-s,39441
+pystand-2.18.dist-info/METADATA,sha256=ORcOKU-54QsYhbZIpB6zEJRcmNv_H8ThamsTNBFT9aQ,26416
+pystand-2.18.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+pystand-2.18.dist-info/entry_points.txt,sha256=DG4ps3I3nni1bubV1tXs6u8FARgkdbAYaEAzZD4RAo8,41
+pystand-2.18.dist-info/top_level.txt,sha256=NoWUh19UQymAJLHTCdxMnVwV6Teftef5fzyF3OWLyNY,8
+pystand-2.18.dist-info/RECORD,,

pystand.py

@@ -11,20 +11,20 @@ from __future__ import annotations
 import os
 import platform
 import re
-import shlex
 import shutil
 import ssl
 import sys
 import time
-from argparse import ArgumentParser, Namespace
 from collections import defaultdict
+from collections.abc import Iterable, Iterator
 from datetime import date, datetime
 from pathlib import Path
-from typing import Any, Iterable, Iterator
+from typing import Any
 from urllib.request import urlopen
 
 import argcomplete
 import platformdirs
+from argparse_from_file import ArgumentParser, Namespace  # type: ignore
 from packaging.version import parse as parse_version
 
 REPO = 'python-build-standalone'
@@ -37,7 +37,6 @@ LATEST_RELEASE_TAG = f'{GITHUB_SITE}/releases/latest'
 SAMPL_RELEASE = '20240415'
 
 PROG = Path(__file__).stem
-CNFFILE = platformdirs.user_config_path(f'{PROG}-flags.conf')
 
 # Default distributions for various platforms
 DISTRIBUTIONS = {
@@ -678,8 +677,7 @@ def main() -> str | None:
     opt = ArgumentParser(
         description=__doc__,
         epilog='Some commands offer aliases as shown in parentheses above. '
-        'Note you can set default starting global options in '
-        f'{CNFFILE}.',
+        'Note you can set default starting global options in #FROM_FILE_PATH#',
     )
 
     # Set up main/global arguments
@@ -693,13 +691,13 @@ def main() -> str | None:
         '-P',
         '--prefix-dir',
         default=prefix_dir,
-        help='specify prefix dir for storing versions. Default is "%(default)s"',
+        help='specify prefix dir for storing versions. Default is "%(default)s".',
     )
     opt.add_argument(
         '-C',
         '--cache-dir',
         default=str(cache_dir),
-        help='specify cache dir for downloads. Default is "%(default)s"',
+        help='specify cache dir for downloads. Default is "%(default)s".',
     )
     opt.add_argument(
         '-M',
@@ -708,7 +706,7 @@ def main() -> str | None:
         type=float,
         help='cache latest YYYYMMDD release tag fetch for this '
         'many minutes, before rechecking for latest. '
-        'Default is %(default)d minutes',
+        'Default is %(default)d minutes.',
     )
     opt.add_argument(
         '--purge-days',
@@ -716,7 +714,7 @@ def main() -> str | None:
         type=int,
         help='cache YYYYMMDD release file lists and downloads for '
         'this number of days after last version referencing that '
-        'release is removed. Default is %(default)d days',
+        'release is removed. Default is %(default)d days.',
     )
     opt.add_argument(
         '--github-access-token',
@@ -728,7 +726,7 @@ def main() -> str | None:
     opt.add_argument(
         '--cert',
         choices=CERTS,
-        help=f'specify which SSL certificates to use for HTTPS requests. Default="{CERTS[0]}"',
+        help=f'specify which SSL certificates to use for HTTPS requests. Default="{CERTS[0]}".',
     )
     opt.add_argument(
         '-V', '--version', action='store_true', help=f'just show {PROG} version'
@@ -763,18 +761,7 @@ def main() -> str | None:
 
     # Command arguments are now defined, so we can set up argcomplete
     argcomplete.autocomplete(opt)
-
-    # Merge in default args from user config file. Then parse the
-    # command line.
-    cnffile = CNFFILE.expanduser()
-    if cnffile.is_file():
-        with cnffile.open() as fp:
-            lines = [re.sub(r'#.*$', '', line).strip() for line in fp]
-        cnflines = ' '.join(lines).strip()
-    else:
-        cnflines = ''
-
-    args = opt.parse_args(shlex.split(cnflines) + sys.argv[1:])
+    args = opt.parse_args()
 
     if 'func' not in args:
         if args.version:

pystand-2.17.dist-info/RECORD

@@ -1,6 +0,0 @@
-pystand.py,sha256=P1m9MPvtswYsQ1EgwGi324v61FY7g9O28suXJln87Ko,39830
-pystand-2.17.dist-info/METADATA,sha256=ecEhgvLgCKC4sVhhEMKcrQnY-yNHVMSYMYGr9dXWG14,25632
-pystand-2.17.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-pystand-2.17.dist-info/entry_points.txt,sha256=DG4ps3I3nni1bubV1tXs6u8FARgkdbAYaEAzZD4RAo8,41
-pystand-2.17.dist-info/top_level.txt,sha256=NoWUh19UQymAJLHTCdxMnVwV6Teftef5fzyF3OWLyNY,8
-pystand-2.17.dist-info/RECORD,,