pkgwise 0.1.0__py3-none-any.whl

pkgwise/utils/distro.py

@@ -0,0 +1,88 @@
+"""Linux distribution detection.
+
+Reads ``/etc/os-release`` (the standard, spec-compliant source) so PkgWise can
+select the correct package-manager backend. Falls back to ``uname`` metadata
+when ``os-release`` is missing.
+"""
+
+from __future__ import annotations
+
+import os
+from typing import Dict, Optional
+
+from pkgwise.core.models import SystemInfo
+
+_OS_RELEASE_PATH = "/etc/os-release"
+_OS_RELEASE_ALT = "/usr/lib/os-release"
+
+
+def _parse_os_release(content: str) -> Dict[str, str]:
+    """Parse os-release key=value lines into a dict.
+
+    Values may be quoted with single or double quotes which are stripped.
+    The ID has special semantics (``ID=arch`` vs ``ID=\"arch\"``) handled here.
+    """
+    fields: Dict[str, str] = {}
+    for raw in content.splitlines():
+        line = raw.strip()
+        if not line or line.startswith("#") or "=" not in line:
+            continue
+        key, _, value = line.partition("=")
+        key = key.strip()
+        value = value.strip()
+        if len(value) >= 2 and value[0] == value[-1] and value[0] in ("'", '"'):
+            value = value[1:-1]
+        fields[key] = value
+    return fields
+
+
+def read_os_release() -> Dict[str, str]:
+    """Return parsed os-release fields for the running system.
+
+    Returns an empty dict when neither standard location exists.
+    """
+    for path in (_OS_RELEASE_PATH, _OS_RELEASE_ALT):
+        try:
+            with open(path, "r", encoding="utf-8") as fh:
+                return _parse_os_release(fh.read())
+        except (OSError, UnicodeDecodeError):
+            continue
+    return {}
+
+
+def get_system_info() -> SystemInfo:
+    """Detect the running distribution and produce a :class:`SystemInfo`."""
+    fields = read_os_release()
+    distro_name = fields.get("NAME") or _fallback_name()
+    distro_id = fields.get("ID", "").lower()
+    version = fields.get("VERSION_ID", "") or fields.get("VERSION", "")
+    package_manager = _package_manager_for(distro_id)
+    return SystemInfo(
+        distro_name=distro_name,
+        distro_version=version,
+        package_manager=package_manager,
+    )
+
+
+def _fallback_name() -> str:
+    """Best-effort name when os-release is unavailable."""
+    try:
+        with open("/proc/sys/kernel/ostype", "r", encoding="utf-8") as fh:
+            return fh.read().strip() or "Linux"
+    except OSError:
+        return "Linux"
+
+
+def _package_manager_for(distro_id: str) -> str:
+    """Map a distro ID to its native package manager."""
+    arch_family = {"arch", "archlinux", "artix", "endeavouros", "manjaro"}
+    debian_family = {"debian", "ubuntu", "kali", "raspbian", "linuxmint", "pop"}
+    if distro_id in arch_family or "arch" in distro_id:
+        return "pacman"
+    if distro_id in debian_family or "debian" in distro_id or "ubuntu" in distro_id:
+        return "apt"
+    return "unknown"
+
+
+def is_arch(distro_id: str) -> bool:
+    return distro_id in {"arch", "archlinux", "artix", "endeavouros", "manjaro"}

pkgwise/utils/formatting.py

@@ -0,0 +1,58 @@
+"""Human-friendly formatting helpers for bytes and plain text."""
+
+from __future__ import annotations
+
+from typing import Optional
+
+_SIZE_UNITS = ("B", "KB", "MB", "GB", "TB", "PB", "EB")
+
+_UNKNOWN_STRING = "Unknown"
+
+
+def format_bytes(num_bytes: Optional[int], decimals: int = 1) -> str:
+    """Render a byte count as a human-readable string, e.g. ``842 MB``.
+
+    ``None`` renders as "Unknown"; negative or zero values render as ``0 B``.
+    """
+    if num_bytes is None:
+        return _UNKNOWN_STRING
+    return _format_positive_bytes(max(num_bytes, 0), decimals)
+
+
+def _format_positive_bytes(num_bytes: int, decimals: int) -> str:
+    if num_bytes < 1024:
+        return f"{num_bytes} B"
+    value = float(num_bytes)
+    for unit in _SIZE_UNITS[1:]:
+        value /= 1024.0
+        if value < 1024.0 or unit == _SIZE_UNITS[-1]:
+            number = f"{value:.{decimals}f}"
+            if number.endswith(".0"):
+                number = number[:-2]
+            return f"{number} {unit}"
+    return f"{num_bytes} B"  # pragma: no cover - unreachable, defensive
+
+
+def format_percent(percentage: float) -> str:
+    """Render a percentage without a decimal when it is effectively whole."""
+    if round(percentage) == percentage:
+        return f"{percentage:.0f}%"
+    return f"{percentage:.1f}%"
+
+
+def unknown_if_none(value: Optional[str]) -> str:
+    """Render ``None`` as "Unknown" and pass real strings through."""
+    return _UNKNOWN_STRING if value is None else value
+
+
+def format_duration(seconds: float) -> str:
+    """Format a number of seconds as a short duration string."""
+    if seconds < 1:
+        return "<1s"
+    if seconds < 60:
+        return f"{int(seconds)}s"
+    minutes, secs = divmod(int(seconds), 60)
+    if minutes < 60:
+        return f"{minutes}m {secs}s"
+    hours, mins = divmod(minutes, 60)
+    return f"{hours}h {mins}m"

pkgwise-0.1.0.dist-info/METADATA

@@ -0,0 +1,135 @@
+Metadata-Version: 2.4
+Name: pkgwise
+Version: 0.1.0
+Summary: Know what you're updating before you update — a smart Linux update analyzer.
+Author: PkgWise Developers
+License: MIT
+Project-URL: Homepage, https://github.com/Senpi-Station/PkgWise
+Project-URL: Repository, https://github.com/Senpi-Station/PkgWise
+Project-URL: Issues, https://github.com/Senpi-Station/PkgWise/issues
+Project-URL: Changelog, https://github.com/Senpi-Station/PkgWise/blob/main/CHANGELOG.md
+Keywords: linux,packages,updates,pacman,apt,tui,system-administration
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+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: Topic :: System :: Systems Administration
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: psutil<7,>=5.9
+Requires-Dist: textual<2,>=0.60
+Provides-Extra: test
+Requires-Dist: pytest>=7; extra == "test"
+Requires-Dist: pytest-cov>=4; extra == "test"
+Requires-Dist: pytest-asyncio>=0.23; python_version >= "3.9" and extra == "test"
+Dynamic: license-file
+
+<h1 align="center">PkgWise</h1>
+
+<p align="center">
+  <b>Know what you're updating before you update.</b><br/>
+  A conservative Linux package-update analyzer for Arch (pacman) and Debian-family (apt) systems.
+</p>
+
+<p align="center">
+  <a href="https://github.com/Senpi-Station/PkgWise/actions"><img src="https://github.com/Senpi-Station/PkgWise/actions/workflows/ci.yaml/badge.svg" alt="CI"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License"></a>
+  <a href="https://www.python.org/downloads/"><img src="https://img.shields.io/badge/python-3.9%2B-blue" alt="Python 3.9+"></a>
+</p>
+
+PkgWise checks for available updates **without installing anything**, shows you what
+is waiting (name, versions, sizes, security and reboot hints), scores each update with
+a **transparent, conservative priority**, and only ever runs a real update after you
+explicitly confirm the exact command.
+
+## Features
+
+- **Dual package managers** — `pacman` (Arch) and `apt-get`/`apt-cache` (Debian, Kali, Ubuntu).
+- **Sizes you can plan with** — download and installed sizes are read from the package
+  manager's own metadata, never guessed.
+- **Transparent priorities** — every CRITICAL/HIGH/MEDIUM/LOW label comes with the
+  human-readable reasons behind it. Unknown facts are shown as “Unknown”, never invented.
+- **Security-first updates** — nothing runs automatically, nothing is removed or cleaned,
+  empty selections can never trigger a full-system upgrade, and disk-space + privilege
+  checks gate every real update.
+- **Two interfaces** — a fast terminal CLI and a Textual TUI with selection, detail and
+  confirmation screens.
+- **Mock mode** — preview the whole tool on any machine without touching a real package
+  manager.
+
+## Installation
+
+```bash
+pip install pkgwise          # core (storage + CLI)
+pip install "pkgwise[all]"   # + TUI (textual) and enhanced storage stats (psutil)
+```
+
+Requires Python 3.9+. Works on Arch-based and Debian-based Linux systems.
+
+## Quick start
+
+```console
+$ pkgwise check                 # storage summary + available updates, prioritized
+$ pkgwise updates               # just the pending updates
+$ pkgwise storage               # disk information only (no package manager needed)
+$ pkgwise --refresh             # refresh package indexes first (network)
+$ pkgwise                      # launch the interactive TUI
+$ pkgwise --version             # version and system info
+```
+
+## Example output
+
+```
+STORAGE
+  Total : 291.4 GB
+  Used  : 87.3 GB
+  Free  : 189.2 GB
+  Usage : 30.0%
+  System: Arch Linux (pacman)
+
+UPDATES (3 available, ~150 MB to download)
+  🔴 CRITICAL  openssl          3.0.1 -> 3.0.2   Security-related update        (2.5 MB / 9 MB)
+  🟠 HIGH      linux            6.0.1 -> 6.0.2   Kernel package — needs reboot  (38 MB / 700 MB)
+  🟡 MEDIUM    figlet           2.2.5 -> 2.2.6   No security metadata detected  (0.5 MB / 1 MB)
+```
+
+## How priorities work
+
+PkgWise collects only **observable facts** about a package — security metadata, whether it
+is a kernel, a core system component or a system library — and maps them through a small,
+documented scoring table in `pkgwise/core/priority.py`. Labels always come with their
+reasons, so nothing is ever marked important without an explanation.
+
+## Safety model
+
+| Guarantee | Where enforced |
+| --- | --- |
+| Nothing runs automatically | `cli.py`, TUI confirm screens |
+| Exact command shown before running | backends' `install_command()` |
+| Empty selection can't upgrade everything | backends return `[]` for empty selections |
+| Disk-space check before install | `analyzer.prepare_update()` |
+| Privilege check before install | `analyzer.prepare_update()` |
+| No packages removed or cleaned | analyzer never invokes remove/clean |
+
+## Development
+
+```bash
+python3 -m venv .venv && source .venv/bin/activate
+pip install -e ".[all,test]"
+pytest
+```
+
+See [CONTRIBUTING](docs/CONTRIBUTING.md) and [DEVELOPMENT](docs/DEVELOPMENT.md).
+
+## License
+
+Released under the [MIT License](LICENSE).

pkgwise-0.1.0.dist-info/RECORD

@@ -0,0 +1,30 @@
+pkgwise/__init__.py,sha256=OlE0qyc5Nhf_aTyfLZ0zV6gZJlEWQ1vg6sJStc52_QA,365
+pkgwise/__main__.py,sha256=fVkkp3Ye5DEcwWQjcG6oLPjKe4dWGg0Ac6Fbv6g2w5g,117
+pkgwise/cli.py,sha256=RVV72j2IqzqzAW5umaaVTwkL0m0dcxiKu5JZIGaB1dU,7269
+pkgwise/mockdata.py,sha256=nkDOKPgbJp-TQCK6Ba1wvYI6_omzSzjCdBDsQd6mhfg,1684
+pkgwise/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pkgwise/backends/__init__.py,sha256=H652nrCMpN4McU2kQLwSe0baEU2IWyWS7cWN29XviFQ,85
+pkgwise/backends/arch.py,sha256=gzKj9RhkPxsxmwmYst-_M28lz0TO2UHc6wRxvYRfvhg,7652
+pkgwise/backends/base.py,sha256=e01568cX-bcYs4gDMYoWr8sn61GviuSP8MM7s1FiDLY,3342
+pkgwise/backends/debian.py,sha256=tWwdDnS4DyA-6jh4HvbvDiR97TEKpOFgFwc7U5WmKa4,8853
+pkgwise/backends/factory.py,sha256=lmXnIEU32pnKv6H8EoB-LVJk0J8Ew6qnd9Hj4lD_BEA,2247
+pkgwise/core/__init__.py,sha256=BFv6g_Ne2egrSapU20SuNReqjLnLYJFvPI9M946gy-w,77
+pkgwise/core/analyzer.py,sha256=8bDnKwq9aIupv0Ox6yzCgvIUNmSMwSZr-DTA1ssLCo8,5895
+pkgwise/core/models.py,sha256=GVVVoAbJY1tXmSwFaT7fRfNU7ky8GNydPhkndDxSXao,3647
+pkgwise/core/priority.py,sha256=WQ_jWldItz6eeZ5WkxodWP8pDM0NGWj5CviAP17fBU0,5734
+pkgwise/core/storage.py,sha256=UUFumE2qUrs8AHuG2ailXZ3xT2VGeFGv6TOHQVqBaH8,2516
+pkgwise/ui/__init__.py,sha256=FhV_LN_qek0ULtSBo500IuA70zaBW9Rp5Ed5IdJAwBE,68
+pkgwise/ui/app.py,sha256=QWhnuFqpEjq5b3hC-NVkXiDMvv8rWzB_JCAjmvhOEtg,8579
+pkgwise/ui/screens.py,sha256=VBZcgPIoFFDUUneAmVO8hOycutiSKukLYZqg8i1i_wA,14624
+pkgwise/ui/widgets.py,sha256=DuyVHiUFzB9BPGhIjPozp-JJDkLHXb8H8xqhJRNIzAs,1821
+pkgwise/utils/__init__.py,sha256=VgvRg1By6tbsdszCgv-GsP3DOvzsYtvAphnUykd8-nI,83
+pkgwise/utils/commands.py,sha256=12_qv7UKSZqjchg_xO0uutVJHtK4QVzitLs4QRWfon4,3009
+pkgwise/utils/config.py,sha256=hXuEE4ad3uuV2xE5ijyZWl_RtRB5PFrS2Q3MK1mFFVo,4007
+pkgwise/utils/distro.py,sha256=ozlbOtJM475mHABhay2yFG-V9JawI7A_9-lVOGgK-r0,2944
+pkgwise/utils/formatting.py,sha256=i2YXTgo4dfMroEggeDDUj3IivNi0PbjgWqnQyASsYtw,1853
+pkgwise-0.1.0.dist-info/licenses/LICENSE,sha256=IxtfAjoB9TmAaU0EZJrIvZSRktBEAoq_Lz7VWJRInT8,1075
+pkgwise-0.1.0.dist-info/METADATA,sha256=zgwUBY2ChD-bbS3K1kKmqHj-rCDS4Qszj2wHXGEaNww,5592
+pkgwise-0.1.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+pkgwise-0.1.0.dist-info/entry_points.txt,sha256=5754cuiOi8CUbFQQVb-wgzsvpjLszRduzbbZDeeG2pU,45
+pkgwise-0.1.0.dist-info/top_level.txt,sha256=wen5xI0tTYZtZ2Mcbn5b8FQ1KV_nGuQNlNCGngDG6wk,8
+pkgwise-0.1.0.dist-info/RECORD,,

pkgwise-0.1.0.dist-info/WHEEL

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

pkgwise-0.1.0.dist-info/entry_points.txt

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

pkgwise-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PkgWise Developers
+
+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.

pkgwise-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+pkgwise