gripfetch-apt 0.1.0__py3-none-any.whl

gripfetch_apt/__init__.py

@@ -0,0 +1,77 @@
+"""gripfetch-apt — thin sugar for the apt fetcher plugin.
+
+`apt(package, version=None, **kw)` returns exactly the IR that
+`gripsack.fetch.plugin_fetch("apt", ...)` produces — no side channels,
+no extra keys. With gripsack installed you get its real `Fetch`
+object; without it, a mirror of the same frozen dataclass so the
+package works standalone for authoring and type-checking.
+
+    from gripfetch_apt import apt
+
+    module(
+        name="hello",
+        fetch=apt("hello", "2.10-3"),
+    )
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+from typing import Any, Optional
+
+__all__ = ["apt", "Fetch"]
+__version__ = "0.1.0"
+
+try:  # pragma: no cover - exercised only with gripsack installed
+    from gripsack.fetch import Fetch as _GsFetch
+    from gripsack.fetch import plugin_fetch as _gs_plugin_fetch
+
+    def apt(
+        package: str, version: Optional[str] = None, **kw: Any
+    ) -> _GsFetch:
+        """A Debian package fetched via the host's apt (`gripfetch-apt`).
+
+        `version` omitted → latest available (resolved at fetch time).
+        Extra kwargs pass through verbatim (e.g. `repos=[...]`).
+        """
+        return _gs_plugin_fetch("apt", **_args(package, version, kw))
+
+except ImportError:
+    from enum import Enum
+
+    class FetchKind(str, Enum):
+        """Mirrors gripsack.fetch.FetchKind for standalone use."""
+
+        PLUGIN = "plugin"
+
+    @dataclass(frozen=True)
+    class Fetch:
+        """A fetch spec — mirrors gripsack.fetch.Fetch exactly."""
+
+        kind: FetchKind
+        args: dict[str, Any] = field(default_factory=dict)
+
+        def to_ir(self) -> dict[str, Any]:
+            return {"kind": self.kind.value, **self.args}
+
+    def apt(package: str, version: Optional[str] = None, **kw: Any) -> Fetch:
+        """A Debian package fetched via the host's apt (`gripfetch-apt`).
+
+        `version` omitted → latest available (resolved at fetch time).
+        Extra kwargs pass through verbatim (e.g. `repos=[...]`).
+        """
+        return Fetch(
+            FetchKind.PLUGIN,
+            {"name": "apt", "args": _args(package, version, kw)},
+        )
+
+
+def _args(package: str, version: Optional[str], kw: dict[str, Any]) -> dict[str, Any]:
+    """Build the plugin args: package always, version only when pinned."""
+    args: dict[str, Any] = {"package": package}
+    if version is not None:
+        args["version"] = version
+    for key, value in kw.items():
+        if value is not None:
+            args[key] = value
+    return args

gripfetch_apt-0.1.0.dist-info/METADATA

@@ -0,0 +1,38 @@
+Metadata-Version: 2.5
+Name: gripfetch-apt
+Version: 0.1.0
+Summary: gripsack sugar: fetch Debian packages through the gripfetch-apt plugin (wraps the host's apt)
+Project-URL: Repository, https://github.com/gripsack-dev/gripfetch-apt
+Author: gripsack-dev
+License-Expression: MIT
+Keywords: apt,debian,gripfetch,gripsack
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# gripfetch-apt (python sugar)
+
+Thin DSL helper for authoring gripsack modules that fetch Debian
+packages through the [gripfetch-apt plugin](https://github.com/gripsack-dev/gripfetch-apt).
+
+```python
+from gripfetch_apt import apt
+
+module(
+    name="hello",
+    fetch=apt("hello", "2.10-3"),   # version optional → latest available
+    install={"bin/hello": symlink("~/.local/bin/hello")},
+)
+```
+
+`apt(...)` returns exactly what `gripsack.fetch.plugin_fetch("apt", ...)`
+returns — no side channels. The package works standalone (for authoring
+and type-checking) even without gripsack installed: it then returns a
+mirror of the same frozen `Fetch` dataclass.

gripfetch_apt-0.1.0.dist-info/RECORD

@@ -0,0 +1,4 @@
+gripfetch_apt/__init__.py,sha256=ioqioNmGEqUouLzFIxVP-y3cBEMcBediqQaf1vR99FY,2525
+gripfetch_apt-0.1.0.dist-info/METADATA,sha256=VyCMtPdgQjxB6VvdMXhJB4leRXW_rfbAgfpDakgKEdA,1432
+gripfetch_apt-0.1.0.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
+gripfetch_apt-0.1.0.dist-info/RECORD,,

gripfetch_apt-0.1.0.dist-info/WHEEL

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