5bb-task 3.42.1__py3-none-any.whl

5bb_task-3.42.1.dist-info/METADATA

@@ -0,0 +1,54 @@
+Metadata-Version: 2.4
+Name: 5bb-task
+Version: 3.42.1
+Summary: Task – a task runner / simpler Make alternative, packaged for easy installation via pip/uv
+Project-URL: Homepage, https://github.com/5-bare-bones/toolbox__monorepo
+Project-URL: Source, https://github.com/go-task/task
+License: MIT
+Keywords: automation,cli,make,task,taskfile
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Utilities
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+
+# 5bb-task
+
+> **task** – a task runner / simpler Make alternative from [Taskfile.dev](https://taskfile.dev), distributed via PyPI/uv.
+
+This package downloads and installs the [`task`](https://github.com/go-task/task) binary for your platform on first use. No compilation required.
+
+## Installation
+
+```bash
+uv tool install 5bb-task
+# or
+pip install 5bb-task
+```
+
+## Usage
+
+```bash
+task --list        # list all available tasks
+task build         # run the 'build' task
+task test          # run the 'test' task
+```
+
+The binary is downloaded from the official GitHub releases on first run and cached in `~/.cache/5bb-task/`.
+
+## Configuration
+
+Set `BB_CACHE_DIR` to override the cache location:
+
+```bash
+BB_CACHE_DIR=/opt/tools task build
+```
+
+## License
+
+MIT – see the [LICENSE](../../LICENSE) file for details.

5bb_task-3.42.1.dist-info/RECORD

@@ -0,0 +1,5 @@
+bb_task/__init__.py,sha256=g8SsVXhcYBWqO65k2hNcq_myAXfHngxrYdHNTo06Ims,3815
+5bb_task-3.42.1.dist-info/METADATA,sha256=o0XoLGeqqdWmP9oF9-qXcFLngQqVH-INXzsDvBWI_H8,1574
+5bb_task-3.42.1.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+5bb_task-3.42.1.dist-info/entry_points.txt,sha256=vunWO3m01d-YtoDrPXe98JOOqwO1ix7qjbt1VheCKPI,37
+5bb_task-3.42.1.dist-info/RECORD,,

5bb_task-3.42.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

5bb_task-3.42.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+task = bb_task:run

bb_task/__init__.py

@@ -0,0 +1,129 @@
+"""
+bb_task – thin Python wrapper around ``task``, the task runner from
+Taskfile.dev (a simpler Make alternative written in Go).
+
+On first use the appropriate pre-built binary is downloaded from the
+official GitHub release page and cached in ``~/.cache/5bb-task/``.
+"""
+
+from __future__ import annotations
+
+import os
+import platform
+import stat
+import subprocess
+import sys
+import tarfile
+import urllib.request
+from pathlib import Path
+
+__version__ = "3.49.1"
+_TASK_VERSION = __version__
+
+# ---------------------------------------------------------------------------
+# Platform detection helpers
+# ---------------------------------------------------------------------------
+
+def _arch() -> str:
+    machine = platform.machine().lower()
+    if machine in ("x86_64", "amd64"):
+        return "amd64"
+    if machine in ("i386", "i686"):
+        return "386"
+    if machine in ("aarch64", "arm64"):
+        return "arm64"
+    if machine.startswith("arm"):
+        return "arm"
+    return machine
+
+
+def _os_name() -> str:
+    system = platform.system().lower()
+    if system == "darwin":
+        return "darwin"
+    if system == "windows":
+        return "windows"
+    return "linux"
+
+
+def _binary_name() -> str:
+    return "task.exe" if platform.system().lower() == "windows" else "task"
+
+
+def _asset_name() -> str:
+    ext = "zip" if platform.system().lower() == "windows" else "tar.gz"
+    return f"task_{_os_name()}_{_arch()}.{ext}"
+
+
+def _download_url() -> str:
+    return (
+        f"https://github.com/go-task/task/releases/download"
+        f"/v{_TASK_VERSION}/{_asset_name()}"
+    )
+
+
+# ---------------------------------------------------------------------------
+# Binary management
+# ---------------------------------------------------------------------------
+
+def _cache_dir() -> Path:
+    return Path(os.environ.get("BB_CACHE_DIR", Path.home() / ".cache")) / "5bb-task"
+
+
+def _binary_path() -> Path:
+    return _cache_dir() / _binary_name()
+
+
+def ensure_binary() -> Path:
+    """Return the path to the task binary, downloading it if necessary."""
+    binary = _binary_path()
+    if binary.exists():
+        return binary
+
+    binary.parent.mkdir(parents=True, exist_ok=True)
+    url = _download_url()
+    asset_name = _asset_name()
+    tmp_archive = binary.parent / asset_name
+
+    print(f"[5bb-task] Downloading task v{_TASK_VERSION} …", file=sys.stderr)
+    try:
+        urllib.request.urlretrieve(url, tmp_archive)  # noqa: S310
+    except Exception as exc:  # pragma: no cover
+        raise SystemExit(
+            f"[5bb-task] Failed to download {url}: {exc}"
+        ) from exc
+
+    if asset_name.endswith(".tar.gz"):
+        with tarfile.open(tmp_archive, "r:gz") as tar:
+            for member in tar.getmembers():
+                if member.name == _binary_name() or member.name.endswith(
+                    f"/{_binary_name()}"
+                ):
+                    member.name = _binary_name()
+                    tar.extract(member, binary.parent)  # noqa: S202
+                    break
+    else:
+        # Windows .zip
+        import zipfile
+
+        with zipfile.ZipFile(tmp_archive, "r") as zf:
+            zf.extract(_binary_name(), binary.parent)
+
+    tmp_archive.unlink(missing_ok=True)
+
+    # Ensure the binary is executable.
+    binary.chmod(binary.stat().st_mode | stat.S_IEXEC | stat.S_IXGRP | stat.S_IXOTH)
+    return binary
+
+
+# ---------------------------------------------------------------------------
+# Entry point
+# ---------------------------------------------------------------------------
+
+def run() -> None:
+    """CLI entry point – delegates all arguments to the task binary."""
+    binary = ensure_binary()
+    args = [str(binary)] + sys.argv[1:]
+    if platform.system().lower() == "windows":
+        sys.exit(subprocess.call(args))
+    os.execv(str(binary), args)