pystand 2.15__tar.gz → 2.16__tar.gz

{pystand-2.15 → pystand-2.16}/Makefile

@@ -3,6 +3,7 @@ check:
 	ruff check $(PYFILES)
 	mypy $(PYFILES)
 	pyright $(PYFILES)
+	md-link-checker
 
 build:
 	rm -rf dist

{pystand-2.15/pystand.egg-info → pystand-2.16}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pystand
-Version: 2.15
+Version: 2.16
 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
@@ -41,7 +41,7 @@ required
 for your machine architecture is normally auto-detected. By default, the
 _`install_only_stripped`_ build of the distribution is installed but you
 can choose to [install any other
-build/distribution](#installing-other-builds/distributions) instead, or
+build/distribution](#installing-other-buildsdistributions) instead, or
 in parallel.
 
 Some simple usage examples are:
@@ -131,7 +131,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]
                   [-V]
-                  {install,update,upgrade,remove,uninstall,list,show,path} ...
+                  {install,update,upgrade,remove,uninstall,list,show,path,cache} ...
 
 Command line tool to download, install, and update pre-built Python versions
 from the python-build-standalone project at https://github.com/astral-
@@ -141,8 +141,9 @@ options:
   -h, --help            show this help message and exit
   -D, --distribution DISTRIBUTION
                         python-build-standalone distribution. Default is
-                        "x86_64_v3-unknown-linux-gnu-install_only_stripped for
-                        this host
+                        "x86_64_v3-unknown-linux-gnu-install_only_stripped"
+                        for this host. Run "pystand show -a" to see all
+                        distributions.
   -P, --prefix-dir PREFIX_DIR
                         specify prefix dir for storing versions. Default is
                         "$HOME/.local/share/pystand"
@@ -164,7 +165,7 @@ options:
   -V, --version         just show pystand version
 
 Commands:
-  {install,update,upgrade,remove,uninstall,list,show,path}
+  {install,update,upgrade,remove,uninstall,list,show,path,cache}
     install             Install one or more versions from a python-build-
                         standalone release.
     update (upgrade)    Update one, more, or all versions to another release.
@@ -173,6 +174,7 @@ Commands:
                         available.
     show                Show versions available from a release.
     path                Show path prefix to installed version base directory.
+    cache               Show release cache sizes.
 
 Some commands offer aliases as shown in parentheses above. Note you can set
 default starting global options in $HOME/.config/pystand-flags.conf.
@@ -307,6 +309,23 @@ options:
   -c, --cache-path   just show path to cache dir
 ```
 
+### Command `cache`
+
+```
+usage: pystand cache [-h] [-T] [-H] [release ...]
+
+Show release cache sizes.
+
+positional arguments:
+  release               show cache size for given release[s] only
+
+options:
+  -h, --help            show this help message and exit
+  -T, --no-total        do not show total cache size
+  -H, --no-human-readable
+                        show sizes in bytes, not human readable format
+```
+
 ## Installation and Upgrade
 
 Python 3.8 or later is required. Arch Linux users can install [`pystand`

{pystand-2.15 → pystand-2.16}/README.md

@@ -24,7 +24,7 @@ required
 for your machine architecture is normally auto-detected. By default, the
 _`install_only_stripped`_ build of the distribution is installed but you
 can choose to [install any other
-build/distribution](#installing-other-builds/distributions) instead, or
+build/distribution](#installing-other-buildsdistributions) instead, or
 in parallel.
 
 Some simple usage examples are:
@@ -114,7 +114,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]
                   [-V]
-                  {install,update,upgrade,remove,uninstall,list,show,path} ...
+                  {install,update,upgrade,remove,uninstall,list,show,path,cache} ...
 
 Command line tool to download, install, and update pre-built Python versions
 from the python-build-standalone project at https://github.com/astral-
@@ -124,8 +124,9 @@ options:
   -h, --help            show this help message and exit
   -D, --distribution DISTRIBUTION
                         python-build-standalone distribution. Default is
-                        "x86_64_v3-unknown-linux-gnu-install_only_stripped for
-                        this host
+                        "x86_64_v3-unknown-linux-gnu-install_only_stripped"
+                        for this host. Run "pystand show -a" to see all
+                        distributions.
   -P, --prefix-dir PREFIX_DIR
                         specify prefix dir for storing versions. Default is
                         "$HOME/.local/share/pystand"
@@ -147,7 +148,7 @@ options:
   -V, --version         just show pystand version
 
 Commands:
-  {install,update,upgrade,remove,uninstall,list,show,path}
+  {install,update,upgrade,remove,uninstall,list,show,path,cache}
     install             Install one or more versions from a python-build-
                         standalone release.
     update (upgrade)    Update one, more, or all versions to another release.
@@ -156,6 +157,7 @@ Commands:
                         available.
     show                Show versions available from a release.
     path                Show path prefix to installed version base directory.
+    cache               Show release cache sizes.
 
 Some commands offer aliases as shown in parentheses above. Note you can set
 default starting global options in $HOME/.config/pystand-flags.conf.
@@ -290,6 +292,23 @@ options:
   -c, --cache-path   just show path to cache dir
 ```
 
+### Command `cache`
+
+```
+usage: pystand cache [-h] [-T] [-H] [release ...]
+
+Show release cache sizes.
+
+positional arguments:
+  release               show cache size for given release[s] only
+
+options:
+  -h, --help            show this help message and exit
+  -T, --no-total        do not show total cache size
+  -H, --no-human-readable
+                        show sizes in bytes, not human readable format
+```
+
 ## Installation and Upgrade
 
 Python 3.8 or later is required. Arch Linux users can install [`pystand`

{pystand-2.15 → pystand-2.16/pystand.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pystand
-Version: 2.15
+Version: 2.16
 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
@@ -41,7 +41,7 @@ required
 for your machine architecture is normally auto-detected. By default, the
 _`install_only_stripped`_ build of the distribution is installed but you
 can choose to [install any other
-build/distribution](#installing-other-builds/distributions) instead, or
+build/distribution](#installing-other-buildsdistributions) instead, or
 in parallel.
 
 Some simple usage examples are:
@@ -131,7 +131,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]
                   [-V]
-                  {install,update,upgrade,remove,uninstall,list,show,path} ...
+                  {install,update,upgrade,remove,uninstall,list,show,path,cache} ...
 
 Command line tool to download, install, and update pre-built Python versions
 from the python-build-standalone project at https://github.com/astral-
@@ -141,8 +141,9 @@ options:
   -h, --help            show this help message and exit
   -D, --distribution DISTRIBUTION
                         python-build-standalone distribution. Default is
-                        "x86_64_v3-unknown-linux-gnu-install_only_stripped for
-                        this host
+                        "x86_64_v3-unknown-linux-gnu-install_only_stripped"
+                        for this host. Run "pystand show -a" to see all
+                        distributions.
   -P, --prefix-dir PREFIX_DIR
                         specify prefix dir for storing versions. Default is
                         "$HOME/.local/share/pystand"
@@ -164,7 +165,7 @@ options:
   -V, --version         just show pystand version
 
 Commands:
-  {install,update,upgrade,remove,uninstall,list,show,path}
+  {install,update,upgrade,remove,uninstall,list,show,path,cache}
     install             Install one or more versions from a python-build-
                         standalone release.
     update (upgrade)    Update one, more, or all versions to another release.
@@ -173,6 +174,7 @@ Commands:
                         available.
     show                Show versions available from a release.
     path                Show path prefix to installed version base directory.
+    cache               Show release cache sizes.
 
 Some commands offer aliases as shown in parentheses above. Note you can set
 default starting global options in $HOME/.config/pystand-flags.conf.
@@ -307,6 +309,23 @@ options:
   -c, --cache-path   just show path to cache dir
 ```
 
+### Command `cache`
+
+```
+usage: pystand cache [-h] [-T] [-H] [release ...]
+
+Show release cache sizes.
+
+positional arguments:
+  release               show cache size for given release[s] only
+
+options:
+  -h, --help            show this help message and exit
+  -T, --no-total        do not show total cache size
+  -H, --no-human-readable
+                        show sizes in bytes, not human readable format
+```
+
 ## Installation and Upgrade
 
 Python 3.8 or later is required. Arch Linux users can install [`pystand`

{pystand-2.15 → pystand-2.16}/pystand.py

@@ -610,6 +610,36 @@ def install(
     return error
 
 
+def to_human(num, prec: int | None = None) -> str:
+    "Convert a number of bytes to a human-readable format"
+    units = ('B', 'K', 'M', 'G', 'T', 'P', 'E', 'Z', 'Y')
+    for unit in units:
+        if abs(num) < 1024.0 or unit == units[-1]:
+            return f'{round(num, prec)}{unit}'
+        num /= 1024.0
+
+    return ''
+
+
+def show_cache_size(path: Path, args: Namespace) -> None:
+    "Show the size of the cache directory"
+    total = 0
+    for spath in sorted(path.iterdir()):
+        size = (
+            sum(p.stat().st_size for p in spath.iterdir())
+            if spath.is_dir()
+            else spath.stat().st_size
+        )
+        total += size
+        size_str = f'{size}B' if args.no_human_readable else to_human(size)
+        name = str(spath) if spath.is_dir() else spath.name
+        print(f'{size_str}\t{name}')
+
+    if not args.no_total:
+        size_str = f'{total}B' if args.no_human_readable else to_human(total, 2)
+        print(f'{size_str}\tTOTAL')
+
+
 def main() -> str | None:
     "Main code"
     distro_default = DISTRIBUTIONS.get((platform.system(), platform.machine()))
@@ -631,7 +661,8 @@ def main() -> str | None:
     opt.add_argument(
         '-D',
         '--distribution',
-        help=f'{REPO} distribution. Default is "{distro_help} for this host',
+        help=f'{REPO} distribution. Default is "{distro_help}" for this host. '
+        f'Run "{PROG} show -a" to see all distributions.',
     )
     opt.add_argument(
         '-P',
@@ -1143,5 +1174,33 @@ class path_:
             print(path)
 
 
+# COMMAND
+class cache_:
+    "Show release cache sizes."
+
+    @staticmethod
+    def init(parser: ArgumentParser) -> None:
+        parser.add_argument(
+            '-T', '--no-total', action='store_true', help='do not show total cache size'
+        )
+        parser.add_argument(
+            '-H',
+            '--no-human-readable',
+            action='store_true',
+            help='show sizes in bytes, not human readable format',
+        )
+        parser.add_argument(
+            'release', nargs='*', help='show cache size for given release[s] only'
+        )
+
+    @staticmethod
+    def run(args: Namespace) -> str | None:
+        if args.release:
+            for release in args.release:
+                show_cache_size(args._downloads / release, args)
+        else:
+            show_cache_size(args._downloads, args)
+
+
 if __name__ == '__main__':
     sys.exit(main())