pacman-apt-wrapper 0.1.0__py3-none-any.whl

pacman_apt/__init__.py

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

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.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,8 @@
+pacman_apt/__init__.py,sha256=v294TQ2wKz2ZTu26y88JsVzaBDyC8lMY7xRAVjFeTj0,97
+pacman_apt/cli.py,sha256=EdmD9FHGEmKrIGGfJ_SV6P20SF6VYPPjijSvhUS1W6s,4196
+pacman_apt_wrapper-0.1.0.dist-info/licenses/LICENSE,sha256=aed4jZQzr-SCuFQaEH3Q7Er_4-rv1bNyEqlHrX1diPw,1077
+pacman_apt_wrapper-0.1.0.dist-info/METADATA,sha256=jbl2Uv1ALfWi5_RGM93vnye_GsP4ta8SFj9ie2QcSOc,3584
+pacman_apt_wrapper-0.1.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+pacman_apt_wrapper-0.1.0.dist-info/entry_points.txt,sha256=KGcWQ_BS9BbqyNOeut10bZbUOjJtdFsr4RPC_2qriHE,80
+pacman_apt_wrapper-0.1.0.dist-info/top_level.txt,sha256=8E1uAgoVKo0-tlNxt1g9Np8K1PGWkr8IuW-T30UleSU,11
+pacman_apt_wrapper-0.1.0.dist-info/RECORD,,

pacman_apt_wrapper-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

pacman_apt_wrapper-0.1.0.dist-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.dist-info/licenses/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.dist-info/top_level.txt

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