voom-cli 0.0.0__tar.gz → 0.2.0__tar.gz

voom_cli-0.2.0/PKG-INFO

@@ -0,0 +1,60 @@
+Metadata-Version: 2.4
+Name: voom-cli
+Version: 0.2.0
+Summary: Fast, safe, parallel build-artifact pruning across every major language ecosystem
+Author-email: Na'aman Hirschfeld <nhirschfeld@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/Goldziher/voom
+Project-URL: Documentation, https://github.com/Goldziher/voom#readme
+Project-URL: Repository, https://github.com/Goldziher/voom.git
+Project-URL: Issues, https://github.com/Goldziher/voom/issues
+Project-URL: Changelog, https://github.com/Goldziher/voom/blob/main/CHANGELOG.md
+Keywords: clean,cleanup,build-artifacts,disk-space,monorepo,cli,prune,rust
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Rust
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: System :: Filesystems
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: certifi>=2024.7.4
+Dynamic: license-file
+
+# voom-cli
+
+Fast, safe, parallel build-artifact pruning across every major language ecosystem.
+
+```bash
+pip install voom-cli
+voom --dry-run ~
+```
+
+Or without installing:
+
+```bash
+uvx --from voom-cli voom --dry-run ~
+```
+
+The first run downloads the prebuilt `voom` binary for your platform from the
+[GitHub release](https://github.com/Goldziher/voom/releases) matching this package's version
+and caches it under `~/.cache/voom/`. Set `VOOM_BINARY` to point at your own build instead.
+
+**voom deletes by default.** Use `--dry-run` to preview. It never removes a directory without
+a marker file proving its ecosystem, and it never touches `node_modules/`.
+
+Full documentation: <https://github.com/Goldziher/voom>

voom_cli-0.2.0/README.md

@@ -0,0 +1,23 @@
+# voom-cli
+
+Fast, safe, parallel build-artifact pruning across every major language ecosystem.
+
+```bash
+pip install voom-cli
+voom --dry-run ~
+```
+
+Or without installing:
+
+```bash
+uvx --from voom-cli voom --dry-run ~
+```
+
+The first run downloads the prebuilt `voom` binary for your platform from the
+[GitHub release](https://github.com/Goldziher/voom/releases) matching this package's version
+and caches it under `~/.cache/voom/`. Set `VOOM_BINARY` to point at your own build instead.
+
+**voom deletes by default.** Use `--dry-run` to preview. It never removes a directory without
+a marker file proving its ecosystem, and it never touches `node_modules/`.
+
+Full documentation: <https://github.com/Goldziher/voom>

voom_cli-0.2.0/pyproject.toml

@@ -0,0 +1,50 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "voom-cli"
+version = "0.2.0"
+description = "Fast, safe, parallel build-artifact pruning across every major language ecosystem"
+readme = "README.md"
+license = { text = "MIT" }
+authors = [{ name = "Na'aman Hirschfeld", email = "nhirschfeld@gmail.com" }]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "Intended Audience :: System Administrators",
+  "License :: OSI Approved :: MIT License",
+  # The wheel is pure Python; the binary it downloads exists only for these three, so a
+  # platform outside them fails at first run rather than at install. See voom/downloader.py.
+  "Operating System :: MacOS",
+  "Operating System :: Microsoft :: Windows",
+  "Operating System :: POSIX :: Linux",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
+  "Programming Language :: Rust",
+  "Topic :: Software Development :: Build Tools",
+  "Topic :: System :: Filesystems",
+  "Topic :: Utilities",
+]
+keywords = ["clean", "cleanup", "build-artifacts", "disk-space", "monorepo", "cli", "prune", "rust"]
+requires-python = ">=3.10"
+dependencies = ["certifi>=2024.7.4"]
+
+[project.urls]
+Homepage = "https://github.com/Goldziher/voom"
+Documentation = "https://github.com/Goldziher/voom#readme"
+Repository = "https://github.com/Goldziher/voom.git"
+Issues = "https://github.com/Goldziher/voom/issues"
+Changelog = "https://github.com/Goldziher/voom/blob/main/CHANGELOG.md"
+
+[project.scripts]
+voom = "voom.cli:main"
+
+[tool.setuptools]
+packages = ["voom"]

voom_cli-0.2.0/voom/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.2.0"

voom_cli-0.2.0/voom/cli.py

@@ -0,0 +1,9 @@
+from __future__ import annotations
+
+import sys
+
+from .downloader import run_voom
+
+
+def main() -> None:
+    run_voom(sys.argv[1:])

voom_cli-0.2.0/voom/downloader.py

@@ -0,0 +1,156 @@
+from __future__ import annotations
+
+import os
+import platform
+import ssl
+import subprocess
+import sys
+import tarfile
+import tempfile
+import zipfile
+from pathlib import Path
+from urllib.error import URLError
+from urllib.request import Request, urlopen
+
+import certifi
+
+REPO = "Goldziher/voom"
+BINARY = "voom"
+
+
+def _platform_triple() -> str:
+    system = platform.system().lower()
+    machine = platform.machine().lower()
+
+    if system == "windows":
+        if machine in {"amd64", "x86_64"}:
+            return "x86_64-pc-windows-gnu"
+        if machine in {"x86", "i386", "i686"}:
+            raise RuntimeError("32-bit Windows is not supported")
+    elif system == "linux":
+        if machine in {"amd64", "x86_64"}:
+            return "x86_64-unknown-linux-gnu"
+        if machine in {"aarch64", "arm64"}:
+            return "aarch64-unknown-linux-gnu"
+    elif system == "darwin":
+        if machine in {"amd64", "x86_64"}:
+            return "x86_64-apple-darwin"
+        if machine in {"aarch64", "arm64"}:
+            return "aarch64-apple-darwin"
+
+    raise RuntimeError(f"Unsupported platform: {system} {machine}")
+
+
+def _python_version_to_tag(version: str) -> str:
+    """Reverse PyPI's version normalization to recover the git tag.
+
+    PyPI stores ``0.2.0rc1`` where the git tag is ``v0.2.0-rc.1``. The release
+    workflow performs the forward conversion; this is the inverse, and the two
+    must stay in step or release-candidate installs will 404.
+    """
+    if "rc" in version:
+        core, suffix = version.split("rc")
+        return f"{core}-rc.{suffix}"
+    return version
+
+
+def _asset(version: str) -> tuple[str, str]:
+    tag = _python_version_to_tag(version)
+    triple = _platform_triple()
+    ext = "zip" if "windows" in triple else "tar.gz"
+    url = f"https://github.com/{REPO}/releases/download/v{tag}/{BINARY}-{triple}.{ext}"
+    return url, ext
+
+
+def _download(url: str, destination: Path) -> None:
+    request = Request(url, headers={"User-Agent": "voom-python-wrapper"})
+    context = ssl.create_default_context(cafile=certifi.where())
+    try:
+        with urlopen(request, timeout=30, context=context) as response:
+            if response.status != 200:
+                raise RuntimeError(f"HTTP {response.status}: {response.reason}")
+            destination.write_bytes(response.read())
+    except URLError as exc:
+        raise RuntimeError(f"Failed to download binary: {exc}") from exc
+
+
+def _extract(archive: Path, ext: str, destination: Path) -> None:
+    names = (BINARY, f"{BINARY}.exe")
+    if ext == "zip":
+        with zipfile.ZipFile(archive) as zf:
+            for name in zf.namelist():
+                if name.endswith(names):
+                    with zf.open(name) as src, destination.open("wb") as dst:
+                        dst.write(src.read())
+                    return
+    else:
+        with tarfile.open(archive, "r:gz") as tar:
+            for member in tar.getmembers():
+                if member.name.endswith(names):
+                    extracted = tar.extractfile(member)
+                    if extracted is None:
+                        continue
+                    with extracted as src, destination.open("wb") as dst:
+                        dst.write(src.read())
+                    return
+    raise RuntimeError("Binary not found in downloaded archive")
+
+
+def _cache_root() -> Path:
+    """Where the downloaded binary lives, per user and per version.
+
+    Per user rather than beside the installed package: a wheel often lands somewhere the
+    running user cannot write, which is exactly when the first run needs to write. The npm
+    wrapper caches in the same place for the same reason (npm-package/download.js).
+    """
+    if platform.system().lower() == "windows":
+        local_app_data = os.getenv("LOCALAPPDATA")
+        if local_app_data:
+            return Path(local_app_data) / BINARY
+    return Path.home() / ".cache" / BINARY
+
+
+def _cache_path(version: str) -> Path:
+    cache_dir = _cache_root() / version
+    cache_dir.mkdir(parents=True, exist_ok=True)
+    suffix = ".exe" if platform.system().lower() == "windows" else ""
+    return cache_dir / f"{BINARY}{suffix}"
+
+
+def ensure_binary() -> str:
+    """Return a path to the voom binary, downloading it on first use."""
+    from . import __version__
+
+    override = os.getenv("VOOM_BINARY")
+    if override:
+        return override
+
+    binary_path = _cache_path(__version__)
+    if binary_path.exists() and os.access(binary_path, os.X_OK):
+        return str(binary_path)
+
+    url, ext = _asset(__version__)
+    print(f"Downloading voom binary v{__version__}...", file=sys.stderr)
+
+    with tempfile.TemporaryDirectory() as tmpdir:
+        archive_path = Path(tmpdir) / f"{BINARY}.{ext}"
+        _download(url, archive_path)
+        _extract(archive_path, ext, binary_path)
+
+    if platform.system().lower() != "windows":
+        binary_path.chmod(0o755)
+
+    print("Binary downloaded successfully.", file=sys.stderr)
+    return str(binary_path)
+
+
+def run_voom(args: list[str]) -> None:
+    """Run the voom binary with the given arguments and exit with its status."""
+    binary_path = ensure_binary()
+
+    try:
+        result = subprocess.run([binary_path, *args], check=False)
+    except FileNotFoundError as exc:
+        raise RuntimeError(f"Binary not found at {binary_path}") from exc
+
+    sys.exit(result.returncode)

voom_cli-0.2.0/voom_cli.egg-info/PKG-INFO

@@ -0,0 +1,60 @@
+Metadata-Version: 2.4
+Name: voom-cli
+Version: 0.2.0
+Summary: Fast, safe, parallel build-artifact pruning across every major language ecosystem
+Author-email: Na'aman Hirschfeld <nhirschfeld@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/Goldziher/voom
+Project-URL: Documentation, https://github.com/Goldziher/voom#readme
+Project-URL: Repository, https://github.com/Goldziher/voom.git
+Project-URL: Issues, https://github.com/Goldziher/voom/issues
+Project-URL: Changelog, https://github.com/Goldziher/voom/blob/main/CHANGELOG.md
+Keywords: clean,cleanup,build-artifacts,disk-space,monorepo,cli,prune,rust
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Rust
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: System :: Filesystems
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: certifi>=2024.7.4
+Dynamic: license-file
+
+# voom-cli
+
+Fast, safe, parallel build-artifact pruning across every major language ecosystem.
+
+```bash
+pip install voom-cli
+voom --dry-run ~
+```
+
+Or without installing:
+
+```bash
+uvx --from voom-cli voom --dry-run ~
+```
+
+The first run downloads the prebuilt `voom` binary for your platform from the
+[GitHub release](https://github.com/Goldziher/voom/releases) matching this package's version
+and caches it under `~/.cache/voom/`. Set `VOOM_BINARY` to point at your own build instead.
+
+**voom deletes by default.** Use `--dry-run` to preview. It never removes a directory without
+a marker file proving its ecosystem, and it never touches `node_modules/`.
+
+Full documentation: <https://github.com/Goldziher/voom>

{voom_cli-0.0.0 → voom_cli-0.2.0}/voom_cli.egg-info/SOURCES.txt

@@ -2,7 +2,11 @@ LICENSE
 README.md
 pyproject.toml
 voom/__init__.py
+voom/cli.py
+voom/downloader.py
 voom_cli.egg-info/PKG-INFO
 voom_cli.egg-info/SOURCES.txt
 voom_cli.egg-info/dependency_links.txt
+voom_cli.egg-info/entry_points.txt
+voom_cli.egg-info/requires.txt
 voom_cli.egg-info/top_level.txt

voom_cli-0.2.0/voom_cli.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+voom = voom.cli:main

voom_cli-0.2.0/voom_cli.egg-info/requires.txt

@@ -0,0 +1 @@
+certifi>=2024.7.4

voom_cli-0.0.0/PKG-INFO

@@ -1,32 +0,0 @@
-Metadata-Version: 2.4
-Name: voom-cli
-Version: 0.0.0
-Summary: Fast, safe, parallel build-artifact pruning across 20+ language ecosystems. Name placeholder — the first functional release is 0.1.0.
-Author-email: Na'aman Hirschfeld <nhirschfeld@gmail.com>
-License: MIT
-Project-URL: Homepage, https://github.com/Goldziher/voom
-Project-URL: Repository, https://github.com/Goldziher/voom.git
-Project-URL: Issues, https://github.com/Goldziher/voom/issues
-Keywords: cleanup,build,artifacts,disk-space,cli,prune,rust
-Classifier: Development Status :: 1 - Planning
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Environment :: Console
-Classifier: Topic :: Utilities
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Dynamic: license-file
-
-# voom-cli
-
-Fast, safe, parallel build-artifact pruning across 20+ language ecosystems.
-
-> Named for the substance in Little Cat Z's hat in *The Cat in the Hat Comes Back* —
-> the stuff that cleans up every last speck of pink snow in one go.
-
-**This `0.0.0` release is a name placeholder** and installs nothing. The first functional
-release is `0.1.0`.
-
-See <https://github.com/Goldziher/voom>.

voom_cli-0.0.0/README.md

@@ -1,11 +0,0 @@
-# voom-cli
-
-Fast, safe, parallel build-artifact pruning across 20+ language ecosystems.
-
-> Named for the substance in Little Cat Z's hat in *The Cat in the Hat Comes Back* —
-> the stuff that cleans up every last speck of pink snow in one go.
-
-**This `0.0.0` release is a name placeholder** and installs nothing. The first functional
-release is `0.1.0`.
-
-See <https://github.com/Goldziher/voom>.

voom_cli-0.0.0/pyproject.toml

@@ -1,29 +0,0 @@
-[build-system]
-requires = ["setuptools>=61.0", "wheel"]
-build-backend = "setuptools.build_meta"
-
-[project]
-name = "voom-cli"
-version = "0.0.0"
-description = "Fast, safe, parallel build-artifact pruning across 20+ language ecosystems. Name placeholder — the first functional release is 0.1.0."
-readme = "README.md"
-license = { text = "MIT" }
-authors = [{ name = "Na'aman Hirschfeld", email = "nhirschfeld@gmail.com" }]
-keywords = ["cleanup", "build", "artifacts", "disk-space", "cli", "prune", "rust"]
-requires-python = ">=3.8"
-classifiers = [
-    "Development Status :: 1 - Planning",
-    "Intended Audience :: Developers",
-    "License :: OSI Approved :: MIT License",
-    "Programming Language :: Python :: 3",
-    "Environment :: Console",
-    "Topic :: Utilities",
-]
-
-[project.urls]
-Homepage = "https://github.com/Goldziher/voom"
-Repository = "https://github.com/Goldziher/voom.git"
-Issues = "https://github.com/Goldziher/voom/issues"
-
-[tool.setuptools]
-packages = ["voom"]

voom_cli-0.0.0/voom/__init__.py

@@ -1 +0,0 @@
-__version__ = "0.0.0"

voom_cli-0.0.0/voom_cli.egg-info/PKG-INFO

@@ -1,32 +0,0 @@
-Metadata-Version: 2.4
-Name: voom-cli
-Version: 0.0.0
-Summary: Fast, safe, parallel build-artifact pruning across 20+ language ecosystems. Name placeholder — the first functional release is 0.1.0.
-Author-email: Na'aman Hirschfeld <nhirschfeld@gmail.com>
-License: MIT
-Project-URL: Homepage, https://github.com/Goldziher/voom
-Project-URL: Repository, https://github.com/Goldziher/voom.git
-Project-URL: Issues, https://github.com/Goldziher/voom/issues
-Keywords: cleanup,build,artifacts,disk-space,cli,prune,rust
-Classifier: Development Status :: 1 - Planning
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Environment :: Console
-Classifier: Topic :: Utilities
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Dynamic: license-file
-
-# voom-cli
-
-Fast, safe, parallel build-artifact pruning across 20+ language ecosystems.
-
-> Named for the substance in Little Cat Z's hat in *The Cat in the Hat Comes Back* —
-> the stuff that cleans up every last speck of pink snow in one go.
-
-**This `0.0.0` release is a name placeholder** and installs nothing. The first functional
-release is `0.1.0`.
-
-See <https://github.com/Goldziher/voom>.