dotlocalslashbin 0.0.8__tar.gz → 0.0.10__tar.gz

{dotlocalslashbin-0.0.8 → dotlocalslashbin-0.0.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: dotlocalslashbin
-Version: 0.0.8
+Version: 0.0.10
 Summary: Download and extract files to `~/.local/bin/`.
 Author-email: Keith Maxwell <keith.maxwell@gmail.com>
 Description-Content-Type: text/markdown
@@ -11,7 +11,10 @@ Requires-Dist: codespell ; extra == "test"
 Requires-Dist: flit ; extra == "test"
 Requires-Dist: mypy ; extra == "test"
 Requires-Dist: nox ; extra == "test"
+Requires-Dist: pytest ; extra == "test"
+Requires-Dist: reuse ; extra == "test"
 Requires-Dist: ruff ; extra == "test"
+Requires-Dist: twine ; extra == "test"
 Requires-Dist: usort ; extra == "test"
 Project-URL: Home, https://github.com/maxwell-k/dotlocalslashbin/
 Provides-Extra: test
@@ -43,12 +46,27 @@ Optionally can:
 \* if the URL is an absolute path on the local file system; it is not downloaded
 to the cache.
 
+[uv]: https://github.com/astral-sh/uv
 [TOML]: https://en.wikipedia.org/wiki/TOML
 
+## Installation
+
+The recommended way to run `dotlocalslashbin` is with [uv].
+
+Command to install the latest released `dotlocalslashbin` from PyPI:
+
+    uv tool install dotlocalslashbin
+
+Command to run latest development version of `dotlocalslashbin` directly from
+GitHub:
+
+    uv run https://raw.githubusercontent.com/maxwell-k/dotfiles/refs/heads/main/dotlocalslashbin.py --help
+
 ## Examples
 
 For example to download `yq` to the current working directory, first save the
-following as `yq.toml`, then run the command below:
+following as `yq.toml`, then install with uv (above) and then run the command
+below:
 
 ```
 [yq]

{dotlocalslashbin-0.0.8 → dotlocalslashbin-0.0.10}/README.md

@@ -25,12 +25,27 @@ Optionally can:
 \* if the URL is an absolute path on the local file system; it is not downloaded
 to the cache.
 
+[uv]: https://github.com/astral-sh/uv
 [TOML]: https://en.wikipedia.org/wiki/TOML
 
+## Installation
+
+The recommended way to run `dotlocalslashbin` is with [uv].
+
+Command to install the latest released `dotlocalslashbin` from PyPI:
+
+    uv tool install dotlocalslashbin
+
+Command to run latest development version of `dotlocalslashbin` directly from
+GitHub:
+
+    uv run https://raw.githubusercontent.com/maxwell-k/dotfiles/refs/heads/main/dotlocalslashbin.py --help
+
 ## Examples
 
 For example to download `yq` to the current working directory, first save the
-following as `yq.toml`, then run the command below:
+following as `yq.toml`, then install with uv (above) and then run the command
+below:
 
 ```
 [yq]

{dotlocalslashbin-0.0.8 → dotlocalslashbin-0.0.10}/pyproject.toml

@@ -26,7 +26,10 @@ test = [
   "flit",
   "mypy",
   "nox",
+  "pytest",
+  "reuse",
   "ruff",
+  "twine",
   "usort",
 ]
 
@@ -38,13 +41,10 @@ target-version = "py312"
 [tool.ruff.lint]
 select = ["ALL"]
 ignore = [
-  # "C901", # TODO
   "D203", # incompatible with D211
   "D213", # incompatible with D212
   "I", # prefer usort to ruff isort implementation
-  # "PLR0912", # TODO
-  # "PLR0913", # TODO
-  # "PLR0915", # TODO
+  "PT", # prefer unittest style
   "S310", # the rule errors on the "use instead" code from `ruff rule S310`
   "S602", # assume arguments to subprocess.run are validated
   "S603", # assume trusted input  to subprocess.run

{dotlocalslashbin-0.0.8 → dotlocalslashbin-0.0.10}/src/dotlocalslashbin.py

@@ -2,6 +2,10 @@
 # src/dotlocalslashbin.py
 # Copyright 2022 Keith Maxwell
 # SPDX-License-Identifier: MPL-2.0
+# /// script
+# requires-python = ">=3.11"
+# dependencies = []
+# ///
 """Download and extract files to `~/.local/bin/`."""
 import tarfile
 from argparse import ArgumentDefaultsHelpFormatter, ArgumentParser, Namespace
@@ -19,9 +23,9 @@ from urllib.request import urlopen
 from zipfile import ZipFile
 
 
-__version__ = "0.0.8"
+__version__ = "0.0.10"
 
-DEFAULT_OUTPUT = Path("~/.local/bin/")
+_OUTPUT = Path("~/.local/bin/")
 _SHA512_LENGTH = 128
 
 
@@ -84,7 +88,7 @@ def main() -> int:
             print(f"Error {e.code} downloading {e.url}")
             return 1
 
-        arg0 = item.name if args.output == DEFAULT_OUTPUT else str(item.target)
+        arg0 = item.name if args.output == _OUTPUT else str(item.target.absolute())
         print(" ".join(("#" if item.version else "$", arg0, item.version or "")))
         if item.version:
             run([arg0, item.version], check=True)
@@ -135,7 +139,7 @@ def _parse_args() -> _CustomNamespace:
     help_ = "TOML specification"
     parser.add_argument("--input", default="bin.toml", help=help_, type=Path)
     help_ = "Target directory"
-    parser.add_argument("--output", default=DEFAULT_OUTPUT, help=help_, type=Path)
+    parser.add_argument("--output", default=_OUTPUT, help=help_, type=Path)
     help_ = "Output directory"
     default = "~/.cache/dotlocalslashbin/"
     parser.add_argument("--downloaded", default=default, help=help_, type=Path)