pacman-apt-wrapper 0.1.0__tar.gz

pacman_apt_wrapper-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Luki Hackwell ( NL )
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pacman_apt_wrapper-0.1.0/PKG-INFO

@@ -0,0 +1,102 @@
+Metadata-Version: 2.4
+Name: pacman-apt-wrapper
+Version: 0.1.0
+Summary: Pacman-style wrapper for apt-get/apt-cache/dpkg-query
+Author: Pacman Apt Wrapper Contributors
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/networkluki/pacman-apt-wrapper
+Project-URL: Source, https://github.com/networkluki/pacman-apt-wrapper
+Project-URL: Issues, https://github.com/networkluki/pacman-apt-wrapper/issues
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: System Administrators
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: System :: Software Distribution
+Classifier: Topic :: System :: Systems Administration
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# pacman-apt (A pacman-like CLI compatibility layer for linux systems)
+
+## Abstract
+`pacman-apt` provides a small subset of Arch Linux `pacman`-style commands on
+linux system by translating them into native `apt-get` / `apt-cache` / `dpkg-query`
+invocations. The goal is consistent operator muscle-memory across distributions,
+not to replace the underlying package manager.
+
+## Motivation
+Operators and developers frequently work across multiple Linux distributions.
+Command surface area differences (e.g. `pacman -Syu` vs `apt update && apt upgrade`)
+increase cognitive load and can lead to mistakes during routine maintenance.
+
+This project reduces that friction by offering a minimal, explicit translation layer.
+
+## Scope
+### Goals
+- Provide a pacman-like UX for common workflows on linux system:
+  - `-Syu`, `-S`, `-R`, `-Rns`, `-Ss`, `-Qi`, `-Q`
+- Prefer stable, script-friendly Debian tooling (`apt-get`, `apt-cache`, `dpkg-query`)
+- Transparent execution: print commands before running them
+
+### Non-goals
+- Not a package manager: no repository handling, no dependency resolution
+- Not a full `pacman` implementation
+- Not intended for Arch Linux (where `pacman` already exists)
+
+## Design Overview
+`pacman-apt` parses a small flag subset and maps it to linux tooling:
+
+| pacman-style | linux backend |
+|---|---|
+| `pacman -Syu` | `apt-get update && apt-get dist-upgrade -y` |
+| `pacman -S <pkg...>` | `apt-get install -y <pkg...>` |
+| `pacman -R <pkg...>` | `apt-get remove -y <pkg...>` |
+| `pacman -Rns <pkg...>` | `apt-get purge -y <pkg...> && apt-get autoremove --purge -y` |
+| `pacman -Ss <query>` | `apt-cache search <query>` |
+| `pacman -Qi <pkg>` | `apt-cache show <pkg>` (metadata; see Limitations) |
+| `pacman -Q` | `dpkg-query -W -f='${binary:Package}\t${Version}\n'` |
+
+For design rationale, see `docs/design.md`.
+
+## Security Model
+- No `shell=True`; all subprocess calls use explicit argument arrays
+- Conservative privilege handling (uses `sudo` when not root)
+- Commands are echoed before execution for auditability
+
+See `docs/security.md` for the threat model and assumptions.
+
+## Compatibility
+- Debian: stable
+- Ubuntu: LTS
+
+(Exact versions may vary; see `docs/compatibility.md`.)
+
+## Installation
+### Install with pip
+From a local checkout:
+```bash
+python -m pip install .
+```
+
+For development, use an editable install:
+```bash
+python -m pip install -e .
+```
+
+Both pip installs create these commands in the active Python environment:
+- `pacman`
+- `pacman-apt`
+
+If your Python environment's script directory is not on `PATH`, run the module
+entrypoint directly instead:
+```bash
+python -m pacman_apt.cli --help
+```
+
+### Manual (single-file)
+```bash
+sudo install -m 0755 pacman /usr/local/bin/pacman
+```

pacman_apt_wrapper-0.1.0/README.md

@@ -0,0 +1,81 @@
+# pacman-apt (A pacman-like CLI compatibility layer for linux systems)
+
+## Abstract
+`pacman-apt` provides a small subset of Arch Linux `pacman`-style commands on
+linux system by translating them into native `apt-get` / `apt-cache` / `dpkg-query`
+invocations. The goal is consistent operator muscle-memory across distributions,
+not to replace the underlying package manager.
+
+## Motivation
+Operators and developers frequently work across multiple Linux distributions.
+Command surface area differences (e.g. `pacman -Syu` vs `apt update && apt upgrade`)
+increase cognitive load and can lead to mistakes during routine maintenance.
+
+This project reduces that friction by offering a minimal, explicit translation layer.
+
+## Scope
+### Goals
+- Provide a pacman-like UX for common workflows on linux system:
+  - `-Syu`, `-S`, `-R`, `-Rns`, `-Ss`, `-Qi`, `-Q`
+- Prefer stable, script-friendly Debian tooling (`apt-get`, `apt-cache`, `dpkg-query`)
+- Transparent execution: print commands before running them
+
+### Non-goals
+- Not a package manager: no repository handling, no dependency resolution
+- Not a full `pacman` implementation
+- Not intended for Arch Linux (where `pacman` already exists)
+
+## Design Overview
+`pacman-apt` parses a small flag subset and maps it to linux tooling:
+
+| pacman-style | linux backend |
+|---|---|
+| `pacman -Syu` | `apt-get update && apt-get dist-upgrade -y` |
+| `pacman -S <pkg...>` | `apt-get install -y <pkg...>` |
+| `pacman -R <pkg...>` | `apt-get remove -y <pkg...>` |
+| `pacman -Rns <pkg...>` | `apt-get purge -y <pkg...> && apt-get autoremove --purge -y` |
+| `pacman -Ss <query>` | `apt-cache search <query>` |
+| `pacman -Qi <pkg>` | `apt-cache show <pkg>` (metadata; see Limitations) |
+| `pacman -Q` | `dpkg-query -W -f='${binary:Package}\t${Version}\n'` |
+
+For design rationale, see `docs/design.md`.
+
+## Security Model
+- No `shell=True`; all subprocess calls use explicit argument arrays
+- Conservative privilege handling (uses `sudo` when not root)
+- Commands are echoed before execution for auditability
+
+See `docs/security.md` for the threat model and assumptions.
+
+## Compatibility
+- Debian: stable
+- Ubuntu: LTS
+
+(Exact versions may vary; see `docs/compatibility.md`.)
+
+## Installation
+### Install with pip
+From a local checkout:
+```bash
+python -m pip install .
+```
+
+For development, use an editable install:
+```bash
+python -m pip install -e .
+```
+
+Both pip installs create these commands in the active Python environment:
+- `pacman`
+- `pacman-apt`
+
+If your Python environment's script directory is not on `PATH`, run the module
+entrypoint directly instead:
+```bash
+python -m pacman_apt.cli --help
+```
+
+### Manual (single-file)
+```bash
+sudo install -m 0755 pacman /usr/local/bin/pacman
+```

pacman_apt_wrapper-0.1.0/pyproject.toml

@@ -0,0 +1,38 @@
+[build-system]
+requires = ["setuptools>=77", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pacman-apt-wrapper"
+version = "0.1.0"
+description = "Pacman-style wrapper for apt-get/apt-cache/dpkg-query"
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Pacman Apt Wrapper Contributors" }]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: System Administrators",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Topic :: System :: Software Distribution",
+    "Topic :: System :: Systems Administration",
+]
+
+[project.urls]
+Homepage = "https://github.com/networkluki/pacman-apt-wrapper"
+Source = "https://github.com/networkluki/pacman-apt-wrapper"
+Issues = "https://github.com/networkluki/pacman-apt-wrapper/issues"
+
+[project.scripts]
+pacman-apt = "pacman_apt.cli:main"
+pacman = "pacman_apt.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+addopts = "-q"
+testpaths = ["tests"]

pacman_apt_wrapper-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

pacman_apt_wrapper-0.1.0/src/pacman_apt/__init__.py

@@ -0,0 +1,4 @@
+"""Pacman-style wrapper for apt-get tooling."""
+
+__all__ = ["__version__"]
+__version__ = "0.1.0"

pacman_apt_wrapper-0.1.0/src/pacman_apt/cli.py

@@ -0,0 +1,152 @@
+#!/usr/bin/env python3
+"""
+pacman (Debian/Ubuntu wrapper)
+
+Implements a small subset of pacman-style flags by translating to:
+- apt-get (stable scripting)
+- apt-cache (search/show)
+- dpkg-query (installed list)
+
+Supported:
+  pacman -Syu
+  pacman -S <pkg...>
+  pacman -R <pkg...>
+  pacman -Rns <pkg...>
+  pacman -Ss <query...>
+  pacman -Qi <pkg...>
+  pacman -Q
+"""
+
+from __future__ import annotations
+
+import os
+import shlex
+import shutil
+import subprocess
+import sys
+from typing import List, Tuple
+
+
+def die(msg: str, code: int = 2) -> None:
+    print(f"error: {msg}", file=sys.stderr)
+    raise SystemExit(code)
+
+
+def ensure_tools() -> None:
+    for tool in ("apt-get", "apt-cache", "dpkg-query"):
+        if shutil.which(tool) is None:
+            die(f"Required tool not found in PATH: {tool}")
+
+
+def split_args(argv: List[str]) -> Tuple[List[str], List[str]]:
+    flags: List[str] = []
+    rest: List[str] = []
+    for arg in argv:
+        if arg.startswith("-") and len(arg) > 1:
+            flags.append(arg)
+        else:
+            rest.append(arg)
+    return flags, rest
+
+
+def has_flag(flags: List[str], needle: str) -> bool:
+    # Pacman combines flags like -Syu
+    for flag in flags:
+        if flag.startswith("--"):
+            continue
+        if needle in flag[1:]:
+            return True
+    return False
+
+
+def as_root(cmd: List[str]) -> List[str]:
+    # Auto-sudo for operations that modify the system
+    if os.geteuid() == 0:
+        return cmd
+    if shutil.which("sudo") is None:
+        die("This operation requires root, and sudo is not available.")
+    return ["sudo", "--"] + cmd
+
+
+def run(cmd: List[str]) -> int:
+    print("+ " + " ".join(shlex.quote(c) for c in cmd))
+    process = subprocess.run(cmd, check=False)
+    return int(process.returncode)
+
+
+def main(argv: List[str] | None = None) -> int:
+    ensure_tools()
+
+    if argv is None:
+        argv = sys.argv[1:]
+
+    if not argv or argv[0] in ("-h", "--help"):
+        print(
+            "pacman (Debian/Ubuntu wrapper)\n\n"
+            "Examples:\n\n"
+            "  pacman -Syu\n\n"
+            "  pacman -S htop curl\n\n"
+            "  pacman -R htop\n\n"
+            "  pacman -Rns htop\n\n"
+            "  pacman -Ss nginx\n\n"
+            "  pacman -Qi nginx\n\n"
+            "  pacman -Q\n"
+        )
+        return 0
+
+    flags, args = split_args(argv)
+
+    # pacman -Syu
+    if has_flag(flags, "S") and has_flag(flags, "y") and has_flag(flags, "u"):
+        cmds = [
+            as_root(["apt-get", "update"]),
+            as_root(["apt-get", "dist-upgrade", "-y"]),
+        ]
+        for cmd in cmds:
+            rc = run(cmd)
+            if rc != 0:
+                return rc
+        return 0
+
+    # pacman -S <pkgs...>
+    if has_flag(flags, "S") and args and not has_flag(flags, "u"):
+        return run(as_root(["apt-get", "install", "-y"] + args))
+
+    # pacman -R / -Rns <pkgs...>
+    if has_flag(flags, "R") and args:
+        purge = has_flag(flags, "n") and has_flag(flags, "s")
+        if purge:
+            # purge + autoremove --purge to mimic "remove + deps + config"
+            rc = run(as_root(["apt-get", "purge", "-y"] + args))
+            if rc != 0:
+                return rc
+            return run(as_root(["apt-get", "autoremove", "--purge", "-y"]))
+        return run(as_root(["apt-get", "remove", "-y"] + args))
+
+    # pacman -Ss <query...>
+    if has_flag(flags, "Ss"):
+        if not args:
+            die("Search requires a query (e.g. pacman -Ss nginx)")
+        return run(["apt-cache", "search"] + args)
+
+    # pacman -Qi <pkg...>
+    if has_flag(flags, "Qi"):
+        if not args:
+            die("Info requires package name(s) (e.g. pacman -Qi nginx)")
+        # apt-cache show shows package metadata (not strictly installed-state)
+        for pkg in args:
+            rc = run(["apt-cache", "show", pkg])
+            if rc != 0:
+                return rc
+        return 0
+
+    # pacman -Q (list installed)
+    if has_flag(flags, "Q") and not args:
+        return run(["dpkg-query", "-W", "-f=${binary:Package}\t${Version}\\n"])
+
+    die(f"Unsupported flags/args: flags={flags!r} args={args!r}")
+    return 2
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

pacman_apt_wrapper-0.1.0/src/pacman_apt_wrapper.egg-info/PKG-INFO

@@ -0,0 +1,102 @@
+Metadata-Version: 2.4
+Name: pacman-apt-wrapper
+Version: 0.1.0
+Summary: Pacman-style wrapper for apt-get/apt-cache/dpkg-query
+Author: Pacman Apt Wrapper Contributors
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/networkluki/pacman-apt-wrapper
+Project-URL: Source, https://github.com/networkluki/pacman-apt-wrapper
+Project-URL: Issues, https://github.com/networkluki/pacman-apt-wrapper/issues
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: System Administrators
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: System :: Software Distribution
+Classifier: Topic :: System :: Systems Administration
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# pacman-apt (A pacman-like CLI compatibility layer for linux systems)
+
+## Abstract
+`pacman-apt` provides a small subset of Arch Linux `pacman`-style commands on
+linux system by translating them into native `apt-get` / `apt-cache` / `dpkg-query`
+invocations. The goal is consistent operator muscle-memory across distributions,
+not to replace the underlying package manager.
+
+## Motivation
+Operators and developers frequently work across multiple Linux distributions.
+Command surface area differences (e.g. `pacman -Syu` vs `apt update && apt upgrade`)
+increase cognitive load and can lead to mistakes during routine maintenance.
+
+This project reduces that friction by offering a minimal, explicit translation layer.
+
+## Scope
+### Goals
+- Provide a pacman-like UX for common workflows on linux system:
+  - `-Syu`, `-S`, `-R`, `-Rns`, `-Ss`, `-Qi`, `-Q`
+- Prefer stable, script-friendly Debian tooling (`apt-get`, `apt-cache`, `dpkg-query`)
+- Transparent execution: print commands before running them
+
+### Non-goals
+- Not a package manager: no repository handling, no dependency resolution
+- Not a full `pacman` implementation
+- Not intended for Arch Linux (where `pacman` already exists)
+
+## Design Overview
+`pacman-apt` parses a small flag subset and maps it to linux tooling:
+
+| pacman-style | linux backend |
+|---|---|
+| `pacman -Syu` | `apt-get update && apt-get dist-upgrade -y` |
+| `pacman -S <pkg...>` | `apt-get install -y <pkg...>` |
+| `pacman -R <pkg...>` | `apt-get remove -y <pkg...>` |
+| `pacman -Rns <pkg...>` | `apt-get purge -y <pkg...> && apt-get autoremove --purge -y` |
+| `pacman -Ss <query>` | `apt-cache search <query>` |
+| `pacman -Qi <pkg>` | `apt-cache show <pkg>` (metadata; see Limitations) |
+| `pacman -Q` | `dpkg-query -W -f='${binary:Package}\t${Version}\n'` |
+
+For design rationale, see `docs/design.md`.
+
+## Security Model
+- No `shell=True`; all subprocess calls use explicit argument arrays
+- Conservative privilege handling (uses `sudo` when not root)
+- Commands are echoed before execution for auditability
+
+See `docs/security.md` for the threat model and assumptions.
+
+## Compatibility
+- Debian: stable
+- Ubuntu: LTS
+
+(Exact versions may vary; see `docs/compatibility.md`.)
+
+## Installation
+### Install with pip
+From a local checkout:
+```bash
+python -m pip install .
+```
+
+For development, use an editable install:
+```bash
+python -m pip install -e .
+```
+
+Both pip installs create these commands in the active Python environment:
+- `pacman`
+- `pacman-apt`
+
+If your Python environment's script directory is not on `PATH`, run the module
+entrypoint directly instead:
+```bash
+python -m pacman_apt.cli --help
+```
+
+### Manual (single-file)
+```bash
+sudo install -m 0755 pacman /usr/local/bin/pacman
+```

pacman_apt_wrapper-0.1.0/src/pacman_apt_wrapper.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+LICENSE
+README.md
+pyproject.toml
+src/pacman_apt/__init__.py
+src/pacman_apt/cli.py
+src/pacman_apt_wrapper.egg-info/PKG-INFO
+src/pacman_apt_wrapper.egg-info/SOURCES.txt
+src/pacman_apt_wrapper.egg-info/dependency_links.txt
+src/pacman_apt_wrapper.egg-info/entry_points.txt
+src/pacman_apt_wrapper.egg-info/top_level.txt
+tests/test_cli.py
+tests/test_packaging.py

pacman_apt_wrapper-0.1.0/src/pacman_apt_wrapper.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

pacman_apt_wrapper-0.1.0/src/pacman_apt_wrapper.egg-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+pacman = pacman_apt.cli:main
+pacman-apt = pacman_apt.cli:main

pacman_apt_wrapper-0.1.0/src/pacman_apt_wrapper.egg-info/top_level.txt

@@ -0,0 +1 @@
+pacman_apt

pacman_apt_wrapper-0.1.0/tests/test_cli.py

@@ -0,0 +1,62 @@
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+PROJECT_ROOT = Path(__file__).resolve().parents[1]
+sys.path.insert(0, str(PROJECT_ROOT / "src"))
+
+import pacman_apt.cli as cli  # noqa: E402
+
+
+def test_split_args_separates_flags_and_args():
+    flags, args = cli.split_args(["-Syu", "htop", "-R", "curl"])
+    assert flags == ["-Syu", "-R"]
+    assert args == ["htop", "curl"]
+
+
+def test_has_flag_combined():
+    assert cli.has_flag(["-Syu"], "S") is True
+    assert cli.has_flag(["-Syu"], "y") is True
+    assert cli.has_flag(["-Syu"], "u") is True
+    assert cli.has_flag(["-Syu"], "R") is False
+
+
+def test_main_help_prints_usage(monkeypatch, capsys):
+    monkeypatch.setattr(cli, "ensure_tools", lambda: None)
+    exit_code = cli.main(["--help"])
+    captured = capsys.readouterr()
+    assert exit_code == 0
+    assert "pacman (Debian/Ubuntu wrapper)" in captured.out
+
+
+def test_main_search_requires_query(monkeypatch):
+    monkeypatch.setattr(cli, "ensure_tools", lambda: None)
+    errors = {}
+
+    def fake_die(msg: str, code: int = 2) -> None:
+        errors["msg"] = msg
+        errors["code"] = code
+        raise SystemExit(code)
+
+    monkeypatch.setattr(cli, "die", fake_die)
+    try:
+        cli.main(["-Ss"])
+    except SystemExit as exc:
+        assert exc.code == 2
+    assert "Search requires a query" in errors["msg"]
+
+
+def test_main_install_routes_to_apt_get(monkeypatch):
+    monkeypatch.setattr(cli, "ensure_tools", lambda: None)
+    monkeypatch.setattr(cli, "as_root", lambda cmd: cmd)
+    called = {}
+
+    def fake_run(cmd):
+        called["cmd"] = cmd
+        return 0
+
+    monkeypatch.setattr(cli, "run", fake_run)
+    exit_code = cli.main(["-S", "htop", "curl"])
+    assert exit_code == 0
+    assert called["cmd"] == ["apt-get", "install", "-y", "htop", "curl"]

pacman_apt_wrapper-0.1.0/tests/test_packaging.py

@@ -0,0 +1,21 @@
+from __future__ import annotations
+
+from pathlib import Path
+
+PROJECT_ROOT = Path(__file__).resolve().parents[1]
+PYPROJECT = PROJECT_ROOT / "pyproject.toml"
+
+
+def test_pip_install_exposes_pacman_command():
+    pyproject = PYPROJECT.read_text(encoding="utf-8")
+
+    assert "[project.scripts]" in pyproject
+    assert 'pacman = "pacman_apt.cli:main"' in pyproject
+    assert 'pacman-apt = "pacman_apt.cli:main"' in pyproject
+
+
+def test_setuptools_uses_src_package_layout():
+    pyproject = PYPROJECT.read_text(encoding="utf-8")
+
+    assert "[tool.setuptools.packages.find]" in pyproject
+    assert 'where = ["src"]' in pyproject