dnfseek 0.1.0__tar.gz

dnfseek-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,19 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v9.0.0
+      - name: Build package
+        run: uv build
+      - name: Publish to PyPI
+        run: uv publish

dnfseek-0.1.0/.gitignore

@@ -0,0 +1,121 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# VSCODE IDE
+.vscode
+
+#Pycharm IDE
+.idea

dnfseek-0.1.0/PKG-INFO

@@ -0,0 +1,92 @@
+Metadata-Version: 2.4
+Name: dnfseek
+Version: 0.1.0
+Summary: A TUI package browser for Fedora, built with Textual
+Requires-Python: >=3.12
+Requires-Dist: textual>=8.2.8
+Description-Content-Type: text/markdown
+
+# dnfseek
+
+A TUI package browser for Fedora, built with [Textual](https://github.com/Textualize/textual).
+A Python port of my forked bash + fzf [`dnfseek`](https://github.com/Sam-Horry/dnfseek) script.
+
+![dnfseek](https://img.shields.io/badge/python-3.12%2B-blue)
+
+## Prerequisites
+
+- Fedora (or another dnf-based distro)
+- [`uv`](https://docs.astral.sh/uv/) — `curl -LsSf https://astral.sh/uv/install.sh | sh` (recommended)
+
+## Test it out
+
+You can test out dnfseek without having to install it, using uvx:
+
+```bash
+uvx --from git+https://github.com/Sam-Horry/dnfseek-tui dnfseek
+```
+
+## Installation
+
+### From git (recommended)
+
+```bash
+uv tool install git+https://github.com/Sam-Horry/dnfseek-tui
+```
+
+### From PyPI
+
+```bash
+uv tool install dnfseek
+```
+
+Either way you get a `dnfseek` command on your PATH. On first run the app
+asks for your sudo password (via `sudo -v`) before the interface starts.
+
+## Usage
+
+```bash
+dnfseek
+```
+
+| Key | Action |
+| ----- | -------- |
+| `tab` | Switch between search and package list |
+| `u` | Upgrade all packages |
+| `r` | Refresh package cache |
+| `i` / `x` / `e` / `g` | Install / remove / reinstall / update selected package |
+| `d` | Show dependencies |
+| `space` | Show package info |
+
+Package lists are cached in `~/.cache/dnfseek` and refreshed if older than
+24 hours.
+
+Using the built-in command palette (ctrl+p), you can change dnfseek's behaviour by searching all
+available packages, or only search packages currently installed on your system.
+All the above actions can be performed from the command palette, as well as:
+
+| Command | Action |
+| --------- | -------- |
+| Search all | Search all available packages |
+| Search installed | Search installed packages |
+| Theme | Change the app theme |
+| Keys | Shows a help widget with a summary of available keys |
+
+## Updating
+
+```bash
+uv tool upgrade dnfseek
+```
+
+## Notes
+
+- This tool is basically a wrapper for dnf, with only a few commands at the moment.
+- This tool is provided as-is, use at your own risk. I am not liable if something goes
+  wrong - though in practice, dnf makes it pretty hard to brick your system.
+  Most mistakes are recoverable with a rollback or `dnf history undo`
+- Installed as a tool, the binary lives in `~/.local/bin/dnfseek`, which
+  takes precedence over a `dnfseek` script elsewhere on your PATH.
+- Sudo authentication happens once, before the TUI starts. If your sudo
+  session expires mid-session, restart the app to re-authenticate.
+- Requires Python 3.12+; `uv` downloads a compatible interpreter if your
+  system Python is older.

dnfseek-0.1.0/README.md

@@ -0,0 +1,84 @@
+# dnfseek
+
+A TUI package browser for Fedora, built with [Textual](https://github.com/Textualize/textual).
+A Python port of my forked bash + fzf [`dnfseek`](https://github.com/Sam-Horry/dnfseek) script.
+
+![dnfseek](https://img.shields.io/badge/python-3.12%2B-blue)
+
+## Prerequisites
+
+- Fedora (or another dnf-based distro)
+- [`uv`](https://docs.astral.sh/uv/) — `curl -LsSf https://astral.sh/uv/install.sh | sh` (recommended)
+
+## Test it out
+
+You can test out dnfseek without having to install it, using uvx:
+
+```bash
+uvx --from git+https://github.com/Sam-Horry/dnfseek-tui dnfseek
+```
+
+## Installation
+
+### From git (recommended)
+
+```bash
+uv tool install git+https://github.com/Sam-Horry/dnfseek-tui
+```
+
+### From PyPI
+
+```bash
+uv tool install dnfseek
+```
+
+Either way you get a `dnfseek` command on your PATH. On first run the app
+asks for your sudo password (via `sudo -v`) before the interface starts.
+
+## Usage
+
+```bash
+dnfseek
+```
+
+| Key | Action |
+| ----- | -------- |
+| `tab` | Switch between search and package list |
+| `u` | Upgrade all packages |
+| `r` | Refresh package cache |
+| `i` / `x` / `e` / `g` | Install / remove / reinstall / update selected package |
+| `d` | Show dependencies |
+| `space` | Show package info |
+
+Package lists are cached in `~/.cache/dnfseek` and refreshed if older than
+24 hours.
+
+Using the built-in command palette (ctrl+p), you can change dnfseek's behaviour by searching all
+available packages, or only search packages currently installed on your system.
+All the above actions can be performed from the command palette, as well as:
+
+| Command | Action |
+| --------- | -------- |
+| Search all | Search all available packages |
+| Search installed | Search installed packages |
+| Theme | Change the app theme |
+| Keys | Shows a help widget with a summary of available keys |
+
+## Updating
+
+```bash
+uv tool upgrade dnfseek
+```
+
+## Notes
+
+- This tool is basically a wrapper for dnf, with only a few commands at the moment.
+- This tool is provided as-is, use at your own risk. I am not liable if something goes
+  wrong - though in practice, dnf makes it pretty hard to brick your system.
+  Most mistakes are recoverable with a rollback or `dnf history undo`
+- Installed as a tool, the binary lives in `~/.local/bin/dnfseek`, which
+  takes precedence over a `dnfseek` script elsewhere on your PATH.
+- Sudo authentication happens once, before the TUI starts. If your sudo
+  session expires mid-session, restart the app to re-authenticate.
+- Requires Python 3.12+; `uv` downloads a compatible interpreter if your
+  system Python is older.

dnfseek-0.1.0/main.py

@@ -0,0 +1,648 @@
+import asyncio
+import os
+import re
+import tempfile
+import time
+from pathlib import Path
+from typing import Iterable
+
+from textual.app import App, ComposeResult, SystemCommand
+from textual.binding import Binding
+from textual.containers import Horizontal, Vertical
+from textual.screen import Screen
+from textual.theme import Theme
+from textual.widgets import (
+    Input,
+    Static,
+    Header,
+    Footer,
+    OptionList,
+    LoadingIndicator,
+)
+from textual.widgets._option_list import Option
+
+CACHE_DIR = Path.home() / ".cache" / "dnfseek"
+INSTALLED_CACHE = CACHE_DIR / "installed"
+AVAILABLE_CACHE = CACHE_DIR / "available"
+CACHE_MAX_AGE = 24 * 60 * 60
+CONFIG_DIR = Path(os.environ.get("XDG_CONFIG_HOME", Path.home() / ".config")) / "dnfseek"
+THEME_FILE = CONFIG_DIR / "theme"
+DEFAULT_HINT = "Search for a package, and press TAB to switch focus"
+HIDDEN_SYSTEM_COMMANDS = {"Screenshot", "Maximize", "Minimize"}
+
+
+class PackageList(OptionList):
+    BINDINGS = [
+        Binding("space", "select", "Select", show=False),
+    ]
+
+
+class DnfseekApp(App):
+    CSS_PATH = "main.tcss"
+    TITLE = "dnfseek"
+    SUB_TITLE = "a TUI dnf wrapper"
+
+    BINDINGS = [
+        ("u", "upgrade_all", "Upgrade all packages"),
+        ("r", "refresh_cache", "Refresh cache"),
+        ("i", "install", "Install package"),
+        ("x", "remove", "Remove package"),
+        ("e", "reinstall", "Reinstall package"),
+        ("g", "update_package", "Update package"),
+        ("d", "deps", "Show dependencies"),
+    ]
+
+    def __init__(self) -> None:
+        super().__init__()
+        if (saved_theme := self._load_saved_theme()) is not None:
+            self.theme = saved_theme
+        self._installed: set[str] = set()
+        self._available: set[str] = set()
+        self._info_cache: dict[str, str] = {}
+        self._deps_cache: dict[str, str] = {}
+        self._pending_fetches: set[str] = set()
+        self._active_package: str | None = None
+        self._view_names: list[str] = []
+        self._filter = ""
+
+    def compose(self) -> ComposeResult:
+        yield Header()
+        with Horizontal(id="options"):
+            yield LoadingIndicator(id="spinner", classes="hidden")
+            yield Static(DEFAULT_HINT, id="options_text")
+
+        with Horizontal():
+            with Vertical():
+                yield Input(placeholder="Type Package Name", id="input")
+                yield PackageList(id="left_panel")
+            yield Static("Select a package (enter/space) to view its information", id="right_panel", markup=False)
+        yield Footer()
+
+    def on_mount(self) -> None:
+        self.theme_changed_signal.subscribe(self, self._save_theme)
+        self.styles.scrollbar_visibility = "hidden"
+        self.run_worker(
+            self._show_packages(installed_only=False),
+            name="search-all",
+            group="search",
+            exclusive=True,
+            exit_on_error=False,
+        )
+
+    def _load_saved_theme(self) -> str | None:
+        if "TEXTUAL_THEME" in os.environ:
+            return None
+        try:
+            saved = THEME_FILE.read_text().strip()
+        except OSError:
+            return None
+        if not saved or self.get_theme(saved) is None:
+            return None
+        return saved
+
+    def _save_theme(self, theme: Theme) -> None:
+        try:
+            CONFIG_DIR.mkdir(parents=True, exist_ok=True)
+            THEME_FILE.write_text(theme.name)
+        except OSError:
+            pass
+
+    def get_system_commands(self, screen: Screen) -> Iterable[SystemCommand]:
+        # keep built-in commands, minus the ones we don't need
+        for command in super().get_system_commands(screen):
+            if command.title not in HIDDEN_SYSTEM_COMMANDS:
+                yield command
+        # custom commands
+        yield SystemCommand(
+            "Upgrade all", "Upgrade all packages with dnf", self.upgrade_all
+        )
+        yield SystemCommand(
+            "Refresh cache", "Refresh the dnf package cache", self.refresh_cache
+        )
+        yield SystemCommand(
+            "Search all", "Search all available packages", self.search_all
+        )
+        yield SystemCommand(
+            "Search installed", "Search installed packages", self.search_installed
+        )
+        yield SystemCommand(
+            "Install package", "Install the highlighted package with dnf",
+            self.action_install,
+        )
+        yield SystemCommand(
+            "Remove package", "Remove the highlighted package with dnf",
+            self.action_remove,
+        )
+        yield SystemCommand(
+            "Reinstall package", "Reinstall the highlighted package with dnf",
+            self.action_reinstall,
+        )
+        yield SystemCommand(
+            "Update package", "Update the highlighted package with dnf",
+            self.action_update_package,
+        )
+        yield SystemCommand(
+            "Show dependencies", "Show dependencies of the highlighted package",
+            self.action_deps,
+        )
+
+    async def _dnf_list(self, args: list[str]) -> str | None:
+        process = await asyncio.create_subprocess_exec(
+            "dnf", "-q", *args,
+            stdout=asyncio.subprocess.PIPE,
+            stderr=asyncio.subprocess.PIPE,
+        )
+        stdout, _ = await process.communicate()
+        if process.returncode != 0:
+            return None
+        return stdout.decode()
+
+    @staticmethod
+    def _parse_dnf_list(output: str) -> list[str]:
+        names = []
+        for line in output.splitlines():
+            parts = line.split()
+            if len(parts) >= 3 and re.search(r"[0-9.-]", parts[1]):
+                names.append(parts[0])
+        return names
+
+    async def _write_cache(self, path: Path, names: list[str]) -> None:
+        fd, tmp = tempfile.mkstemp(dir=CACHE_DIR)
+        try:
+            with os.fdopen(fd, "w") as f:
+                f.write("\n".join(names))
+                f.write("\n")
+            os.replace(tmp, path)
+        except OSError:
+            os.unlink(tmp)
+
+    def _load_cache(self) -> None:
+        if INSTALLED_CACHE.exists():
+            self._installed = set(INSTALLED_CACHE.read_text().split())
+        if AVAILABLE_CACHE.exists():
+            self._available = set(AVAILABLE_CACHE.read_text().split())
+
+    def _cache_is_stale(self) -> bool:
+        for path in (INSTALLED_CACHE, AVAILABLE_CACHE):
+            if not path.exists():
+                return True
+            if time.time() - path.stat().st_mtime > CACHE_MAX_AGE:
+                return True
+        return False
+
+    async def update_cache(self) -> None:
+        self.notify("Refreshing package lists...", timeout=2)
+        CACHE_DIR.mkdir(parents=True, exist_ok=True)
+        installed, available = await asyncio.gather(
+            self._dnf_list(["list", "--installed"]),
+            self._dnf_list(
+                ["-y", "--setopt=gpgcheck=1", "--setopt=repo_gpgcheck=1",
+                 "list", "--available"]
+            ),
+        )
+        if installed is None or available is None:
+            self.notify("Failed to refresh package lists", severity="error")
+            return
+        installed_names = self._parse_dnf_list(installed)
+        available_names = self._parse_dnf_list(available)
+        await asyncio.gather(
+            self._write_cache(INSTALLED_CACHE, installed_names),
+            self._write_cache(AVAILABLE_CACHE, available_names),
+        )
+        self._installed = set(installed_names)
+        self._available = set(available_names)
+        self.notify("Package lists refreshed", severity="information")
+
+    async def _ensure_cache(self) -> None:
+        if not self._installed and not self._available:
+            self._load_cache()
+        if self._cache_is_stale():
+            await self.update_cache()
+
+    async def refresh_cache(self) -> None:
+        self.run_worker(
+            self.update_cache(),
+            name="refresh-cache",
+            group="cache",
+            exclusive=True,
+            exit_on_error=False,
+        )
+
+    def action_refresh_cache(self) -> None:
+        self.run_worker(
+            self.update_cache(),
+            name="refresh-cache",
+            group="cache",
+            exclusive=True,
+            exit_on_error=False,
+        )
+
+    def _populate_options(self) -> None:
+        names = self._view_names
+        if self._filter:
+            needle = self._filter.casefold()
+            names = [name for name in names if needle in name.casefold()]
+        options = [
+            Option(f"✅ {name}" if name in self._installed else name, id=name)
+            for name in names
+        ]
+        left = self.query_one("#left_panel", OptionList)
+        left.clear_options()
+        left.add_options(options)
+        if options:
+            left.highlighted = 0
+
+    async def search_all(self) -> None:
+        self.run_worker(
+            self._show_packages(installed_only=False),
+            name="search-all",
+            group="search",
+            exclusive=True,
+            exit_on_error=False,
+        )
+
+    async def search_installed(self) -> None:
+        self.run_worker(
+            self._show_packages(installed_only=True),
+            name="show-installed",
+            group="search",
+            exclusive=True,
+            exit_on_error=False,
+        )
+
+    async def _show_packages(self, installed_only: bool) -> None:
+        await self._ensure_cache()
+        if installed_only:
+            names = sorted(self._installed)
+        else:
+            names = sorted(self._installed | self._available)
+        self._view_names = names
+        self._filter = ""
+        self.query_one("#input", Input).value = ""
+        self._populate_options()
+
+    def on_input_changed(self, event: Input.Changed) -> None:
+        if event.input.id != "input":
+            return
+        if event.value == self._filter:
+            return
+        self._filter = event.value
+        self._populate_options()
+
+    def _selected_package(self) -> str | None:
+        option = self.query_one("#left_panel", OptionList).highlighted_option
+        return option.id if option is not None else None
+
+    def _format_info(self, name: str, content: str) -> str:
+        if name in self._installed:
+            actions = "x Remove | e Reinstall | g Update | d Dependencies"
+        else:
+            actions = "i Install | d Dependencies"
+        return f"{content}\n\n── Actions ──\n{actions}"
+
+    def on_option_list_option_selected(
+        self, event: OptionList.OptionSelected
+    ) -> None:
+        name = event.option_id
+        if name is None:
+            return
+        self._active_package = name
+        right_panel = self.query_one("#right_panel", Static)
+        if name in self._info_cache:
+            right_panel.update(self._format_info(name, self._info_cache[name]))
+            return
+        if name in self._pending_fetches:
+            return
+        self._pending_fetches.add(name)
+        right_panel.update(f"Fetching info for {name}...")
+        self.run_worker(
+            self._fetch_package_info(name),
+            name=f"info-{name}",
+            group="info",
+            exit_on_error=False,
+        )
+
+    async def _fetch_package_info(self, name: str) -> None:
+        process = await asyncio.create_subprocess_exec(
+            "dnf", "info", name,
+            stdout=asyncio.subprocess.PIPE,
+            stderr=asyncio.subprocess.PIPE,
+        )
+        stdout, _ = await process.communicate()
+        self._pending_fetches.discard(name)
+        if process.returncode != 0:
+            return
+        lines = [
+            line.strip()
+            for line in stdout.decode().splitlines()
+            if re.match(r"^(Name|Summary|Version|Release|Size|URL|Description)", line.strip())
+        ]
+        info = "\n".join(lines)
+        self._info_cache[name] = info
+        if name == self._active_package:
+            self.query_one("#right_panel", Static).update(
+                self._format_info(name, info)
+            )
+
+    def action_install(self) -> None:
+        name = self._selected_package()
+        if name is None:
+            self.notify("No package selected", severity="warning")
+            return
+        if name in self._installed:
+            self.notify(f"{name} is already installed", severity="warning")
+            return
+        self.notify(f"Installing {name}...", timeout=2)
+        self.run_worker(
+            self._run_dnf(
+                ["dnf", "install", "-y", name],
+                success_msg=f"Installed: {name}",
+                name=name,
+                installed="add",
+            ),
+            name=f"install-{name}",
+            group="dnf",
+            exclusive=True,
+            exit_on_error=False,
+        )
+
+    def action_remove(self) -> None:
+        name = self._selected_package()
+        if name is None:
+            self.notify("No package selected", severity="warning")
+            return
+        if name not in self._installed:
+            self.notify(f"{name} is not installed", severity="warning")
+            return
+        self.notify(f"Removing {name}...", timeout=2)
+        self.run_worker(
+            self._run_dnf(
+                ["dnf", "remove", "-y", name],
+                success_msg=f"Removed: {name}",
+                name=name,
+                installed="remove",
+            ),
+            name=f"remove-{name}",
+            group="dnf",
+            exclusive=True,
+            exit_on_error=False,
+        )
+
+    def action_reinstall(self) -> None:
+        name = self._selected_package()
+        if name is None:
+            self.notify("No package selected", severity="warning")
+            return
+        if name not in self._installed:
+            self.notify(f"{name} is not installed", severity="warning")
+            return
+        self.notify(f"Reinstalling {name}...", timeout=2)
+        self.run_worker(
+            self._run_dnf(
+                ["dnf", "reinstall", "-y", name],
+                success_msg=f"Reinstalled: {name}",
+                name=name,
+            ),
+            name=f"reinstall-{name}",
+            group="dnf",
+            exclusive=True,
+            exit_on_error=False,
+        )
+
+    def action_update_package(self) -> None:
+        name = self._selected_package()
+        if name is None:
+            self.notify("No package selected", severity="warning")
+            return
+        if name not in self._installed:
+            self.notify(f"{name} is not installed", severity="warning")
+            return
+        self.notify(f"Updating {name}...", timeout=2)
+        self.run_worker(
+            self._run_dnf(
+                ["dnf", "upgrade", "-y", name],
+                success_msg=f"Updated: {name}",
+                name=name,
+            ),
+            name=f"update-{name}",
+            group="dnf",
+            exclusive=True,
+            exit_on_error=False,
+        )
+
+    def action_deps(self) -> None:
+        name = self._selected_package()
+        if name is None:
+            self.notify("No package selected", severity="warning")
+            return
+        right_panel = self.query_one("#right_panel", Static)
+        if name in self._deps_cache:
+            right_panel.update(self._format_info(name, self._deps_cache[name]))
+            return
+        right_panel.update(f"Fetching dependencies for {name}...")
+        self.run_worker(
+            self._fetch_deps(name),
+            name=f"deps-{name}",
+            group="info",
+            exit_on_error=False,
+        )
+
+    async def _fetch_deps(self, name: str) -> None:
+        process = await asyncio.create_subprocess_exec(
+            "dnf", "repoquery", "--requires", name,
+            stdout=asyncio.subprocess.PIPE,
+            stderr=asyncio.subprocess.PIPE,
+        )
+        stdout, _ = await process.communicate()
+        right_panel = self.query_one("#right_panel", Static)
+        if process.returncode != 0:
+            right_panel.update(f"Could not fetch dependencies for {name}")
+            self.notify(f"Could not fetch dependencies for {name}", severity="error")
+            return
+        deps = [line.strip() for line in stdout.decode().splitlines() if line.strip()]
+        text = "\n".join(deps) if deps else "No dependencies"
+        self._deps_cache[name] = text
+        right_panel.update(self._format_info(name, text))
+
+    def _restore_package_info(self, name: str) -> None:
+        self._active_package = name
+        if name in self._info_cache:
+            self.query_one("#right_panel", Static).update(
+                self._format_info(name, self._info_cache[name])
+            )
+        else:
+            self.run_worker(
+                self._fetch_package_info(name),
+                name=f"info-{name}",
+                group="info",
+                exit_on_error=False,
+            )
+
+    def _mark_installed(self, name: str) -> None:
+        self._installed.add(name)
+        self._available.discard(name)
+        self._info_cache.pop(name, None)
+        self._deps_cache.pop(name, None)
+        self._populate_options()
+        self.run_worker(
+            self._sync_cache_files(),
+            name="cache-sync",
+            group="cache",
+            exclusive=True,
+            exit_on_error=False,
+        )
+
+    def _mark_removed(self, name: str) -> None:
+        self._installed.discard(name)
+        self._available.add(name)
+        self._info_cache.pop(name, None)
+        self._deps_cache.pop(name, None)
+        self._populate_options()
+        self.run_worker(
+            self._sync_cache_files(),
+            name="cache-sync",
+            group="cache",
+            exclusive=True,
+            exit_on_error=False,
+        )
+
+    async def _sync_cache_files(self) -> None:
+        await asyncio.gather(
+            self._write_cache(INSTALLED_CACHE, sorted(self._installed)),
+            self._write_cache(AVAILABLE_CACHE, sorted(self._available)),
+        )
+
+    def _start_upgrade(self) -> None:
+        self.notify("Upgrading all packages...", timeout=2)
+        self.run_worker(
+            self._run_dnf(
+                ["dnf", "upgrade", "-y"],
+                success_msg="All packages upgraded!",
+            ),
+            name="upgrade_all",
+            group="dnf",
+            exclusive=True,
+            exit_on_error=False,
+        )
+
+    async def upgrade_all(self) -> None:
+        self._start_upgrade()
+
+    def action_upgrade_all(self) -> None:
+        self._start_upgrade()
+
+    async def _run_dnf(
+        self,
+        args: list[str],
+        success_msg: str = "Command completed successfully",
+        name: str | None = None,
+        installed: str | None = None,
+    ) -> None:
+        right_panel = self.query_one("#right_panel", Static)
+        self._show_status(self._action_status(args, name))
+        try:
+            right_panel.update(f"Running: {' '.join(args)}")
+            returncode, stderr = await self._sudo_once(args)
+            if returncode != 0 and (
+                b"a password is required" in stderr.lower()
+                or b"no password was provided" in stderr.lower()
+            ):
+                self.notify(
+                    "Sudo session expired — please restart dnfseek",
+                    severity="error",
+                )
+                self.exit(
+                    result="dnfseek: sudo session expired. "
+                    "Re-run the app to reauthenticate."
+                )
+                return
+            if returncode == 0:
+                self.notify(success_msg, timeout=2, severity="information")
+                if installed == "add" and name is not None:
+                    self._mark_installed(name)
+                    self._restore_package_info(name)
+                elif installed == "remove" and name is not None:
+                    self._mark_removed(name)
+                    self._restore_package_info(name)
+                elif name is not None:
+                    self._restore_package_info(name)
+            else:
+                stderr_text = stderr.decode(errors="replace")
+                error_text = stderr_text.lower()
+                if stderr:
+                    error_lines = stderr_text.splitlines()[-10:]
+                    right_panel.update("\n".join(error_lines))
+                if "already installed" in error_text:
+                    self.notify(
+                        f"{name or 'Package'} is already installed", severity="warning"
+                    )
+                elif "already the latest" in error_text or "nothing to do" in error_text:
+                    self.notify(
+                        f"{name or 'Packages'} are already up to date",
+                        severity="warning",
+                    )
+                else:
+                    self.notify(
+                        f"Command failed (error code {returncode})",
+                        severity="error",
+                    )
+        finally:
+            self._hide_status()
+
+    async def _sudo_once(self, args: list[str]) -> tuple[int, bytes]:
+        """Run `sudo -n <cmd> ...` once, streaming stdout to the right panel."""
+        right_panel = self.query_one("#right_panel", Static)
+        process = await asyncio.create_subprocess_exec(
+            "sudo", "-n", *args,
+            stdout=asyncio.subprocess.PIPE,
+            stderr=asyncio.subprocess.PIPE,
+        )
+        stderr_task = asyncio.create_task(process.stderr.read())
+        lines: list[str] = []
+        async for chunk in process.stdout:
+            for line in chunk.decode(errors="replace").replace("\r", "\n").splitlines():
+                if line.strip():
+                    lines.append(line.strip())
+            right_panel.update("\n".join(lines[-15:]))
+        stderr = await stderr_task
+        await process.wait()
+        return process.returncode or 0, stderr
+
+    @staticmethod
+    def _action_status(args: list[str], name: str | None) -> str:
+        action = args[1]
+        if action == "install":
+            return f"Installing {name}..."
+        if action == "remove":
+            return f"Removing {name}..."
+        if action == "reinstall":
+            return f"Reinstalling {name}..."
+        if action == "upgrade":
+            if name is not None:
+                return f"Upgrading {name}..."
+            return "Upgrading all packages..."
+        return f"Running: {' '.join(args)}"
+
+    def _show_status(self, message: str) -> None:
+        self.query_one("#spinner", LoadingIndicator).remove_class("hidden")
+        self.query_one("#options_text", Static).update(message)
+
+    def _hide_status(self) -> None:
+        self.query_one("#spinner", LoadingIndicator).add_class("hidden")
+        self.query_one("#options_text", Static).update(DEFAULT_HINT)
+
+
+def main() -> None:
+    import subprocess
+    import sys
+
+    if subprocess.run(["sudo", "-v"]).returncode != 0:
+        raise SystemExit("Authentication failed - dnfseek requires sudo access")
+    app = DnfseekApp()
+    result = app.run()
+    if result is not None:
+        print(result, file=sys.stderr)
+
+
+if __name__ == "__main__":
+    main()

dnfseek-0.1.0/main.tcss

@@ -0,0 +1,78 @@
+Screen {
+    background: $background;
+    color: $foreground;
+}
+
+Horizontal {
+    width: 100%;
+}
+
+#options {
+    background: $panel;
+    padding: 0 1;
+    border: solid $border-blurred;
+    height: 3;
+    align: left middle;
+}
+
+#options_text {
+    width: 1fr;
+}
+
+#spinner {
+    width: 10;
+    height: 1;
+}
+
+.hidden {
+    display: none;
+}
+
+#input {
+    background: $panel;
+    border: solid $border-blurred;
+    padding: 0 1;
+    /*margin: 0 0 1 0;*/
+}
+#input:focus {
+    border: solid $border;
+}
+
+#left_panel {
+    width: 1fr;
+    height: 1fr;
+    background: $panel;
+    border: solid $border-blurred;
+    padding: 0 1;
+    /*margin: 0 0 1 0;*/
+}
+#left_panel:focus-within {
+    border: solid $border;
+}
+
+#right_panel {
+    width: 66%;
+    height: 1fr;
+    background: $panel;
+    border: solid $border-blurred;
+    padding: 1 2;
+    /*margin: 0 0 1 0;*/
+}
+#right_panel:focus-within {
+    border: solid $border;
+}
+
+PasswordScreen {
+    align: center middle;
+}
+
+PasswordScreen #password {
+    width: 40;
+    background: $panel;
+    border: solid $border-blurred;
+    padding: 0 1;
+}
+
+PasswordScreen #password:focus {
+    border: solid $border;
+}

dnfseek-0.1.0/pyproject.toml

@@ -0,0 +1,22 @@
+[project]
+name = "dnfseek"
+version = "0.1.0"
+description = "A TUI package browser for Fedora, built with Textual"
+readme = "README.md"
+requires-python = ">=3.12"
+dependencies = [
+    "textual>=8.2.8",
+]
+
+[project.scripts]
+dnfseek = "main:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+include = [
+    "main.py",
+    "main.tcss",
+]

dnfseek-0.1.0/uv.lock

@@ -0,0 +1,130 @@
+version = 1
+revision = 3
+requires-python = ">=3.12"
+
+[[package]]
+name = "dnfseek"
+version = "0.1.0"
+source = { editable = "." }
+dependencies = [
+    { name = "textual" },
+]
+
+[package.metadata]
+requires-dist = [{ name = "textual", specifier = ">=8.2.8" }]
+
+[[package]]
+name = "linkify-it-py"
+version = "2.1.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "uc-micro-py" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/2e/c9/06ea13676ef354f0af6169587ae292d3e2406e212876a413bf9eece4eb23/linkify_it_py-2.1.0.tar.gz", hash = "sha256:43360231720999c10e9328dc3691160e27a718e280673d444c38d7d3aaa3b98b", size = 29158, upload-time = "2026-03-01T07:48:47.683Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b4/de/88b3be5c31b22333b3ca2f6ff1de4e863d8fe45aaea7485f591970ec1d3e/linkify_it_py-2.1.0-py3-none-any.whl", hash = "sha256:0d252c1594ecba2ecedc444053db5d3a9b7ec1b0dd929c8f1d74dce89f86c05e", size = 19878, upload-time = "2026-03-01T07:48:46.098Z" },
+]
+
+[[package]]
+name = "markdown-it-py"
+version = "4.2.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "mdurl" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/06/ff/7841249c247aa650a76b9ee4bbaeae59370dc8bfd2f6c01f3630c35eb134/markdown_it_py-4.2.0.tar.gz", hash = "sha256:04a21681d6fbb623de53f6f364d352309d4094dd4194040a10fd51833e418d49", size = 82454, upload-time = "2026-05-07T12:08:28.36Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b3/81/4da04ced5a082363ecfa159c010d200ecbd959ae410c10c0264a38cac0f5/markdown_it_py-4.2.0-py3-none-any.whl", hash = "sha256:9f7ebbcd14fe59494226453aed97c1070d83f8d24b6fc3a3bcf9a38092641c4a", size = 91687, upload-time = "2026-05-07T12:08:27.182Z" },
+]
+
+[package.optional-dependencies]
+linkify = [
+    { name = "linkify-it-py" },
+]
+
+[[package]]
+name = "mdit-py-plugins"
+version = "0.6.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "markdown-it-py" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/59/fc/f8d0863f8862f25602c0404d75568e89fb6b4109804645e5cdfb1be5cf56/mdit_py_plugins-0.6.1.tar.gz", hash = "sha256:a2bca0f039f39dbd35fb74ae1b5f998608c437463371f0ff7f49a19a17a114d0", size = 56114, upload-time = "2026-05-13T09:03:38.91Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/a5/69/6da5581c6a7fede7dc261bf4e67d6adca4196f176b43288b55b3db395b6e/mdit_py_plugins-0.6.1-py3-none-any.whl", hash = "sha256:214c82fb2ac524472ab6a5bcab1de80f73b50443e187f401bfd77efbc7c6481d", size = 66663, upload-time = "2026-05-13T09:03:37.76Z" },
+]
+
+[[package]]
+name = "mdurl"
+version = "0.1.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d6/54/cfe61301667036ec958cb99bd3efefba235e65cdeb9c84d24a8293ba1d90/mdurl-0.1.2.tar.gz", hash = "sha256:bb413d29f5eea38f31dd4754dd7377d4465116fb207585f97bf925588687c1ba", size = 8729, upload-time = "2022-08-14T12:40:10.846Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b3/38/89ba8ad64ae25be8de66a6d463314cf1eb366222074cfda9ee839c56a4b4/mdurl-0.1.2-py3-none-any.whl", hash = "sha256:84008a41e51615a49fc9966191ff91509e3c40b939176e643fd50a5c2196b8f8", size = 9979, upload-time = "2022-08-14T12:40:09.779Z" },
+]
+
+[[package]]
+name = "platformdirs"
+version = "4.11.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/78/9b/560e4be8e26f6fd133a03630a8df0c663b9e8d61b4ade152b72005aec83b/platformdirs-4.11.0.tar.gz", hash = "sha256:0555d18370482847566ffabcaa53ad7c6c1c29f195989ae1ed634a05f76ea1e0", size = 31953, upload-time = "2026-07-21T13:09:36.565Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/7d/68/d8d58938dfb1370b266a1a729e6d77a985be23689a0496498ee17b2cbf90/platformdirs-4.11.0-py3-none-any.whl", hash = "sha256:360ccded2b7fce0af0ff80cc8f5942a1c5d99b0e856033acb030bfc634709e74", size = 23247, upload-time = "2026-07-21T13:09:35.422Z" },
+]
+
+[[package]]
+name = "pygments"
+version = "2.20.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/c3/b2/bc9c9196916376152d655522fdcebac55e66de6603a76a02bca1b6414f6c/pygments-2.20.0.tar.gz", hash = "sha256:6757cd03768053ff99f3039c1a36d6c0aa0b263438fcab17520b30a303a82b5f", size = 4955991, upload-time = "2026-03-29T13:29:33.898Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/f4/7e/a72dd26f3b0f4f2bf1dd8923c85f7ceb43172af56d63c7383eb62b332364/pygments-2.20.0-py3-none-any.whl", hash = "sha256:81a9e26dd42fd28a23a2d169d86d7ac03b46e2f8b59ed4698fb4785f946d0176", size = 1231151, upload-time = "2026-03-29T13:29:30.038Z" },
+]
+
+[[package]]
+name = "rich"
+version = "15.0.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "markdown-it-py" },
+    { name = "pygments" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/c0/8f/0722ca900cc807c13a6a0c696dacf35430f72e0ec571c4275d2371fca3e9/rich-15.0.0.tar.gz", hash = "sha256:edd07a4824c6b40189fb7ac9bc4c52536e9780fbbfbddf6f1e2502c31b068c36", size = 230680, upload-time = "2026-04-12T08:24:00.75Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/82/3b/64d4899d73f91ba49a8c18a8ff3f0ea8f1c1d75481760df8c68ef5235bf5/rich-15.0.0-py3-none-any.whl", hash = "sha256:33bd4ef74232fb73fe9279a257718407f169c09b78a87ad3d296f548e27de0bb", size = 310654, upload-time = "2026-04-12T08:24:02.83Z" },
+]
+
+[[package]]
+name = "textual"
+version = "8.2.8"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "markdown-it-py", extra = ["linkify"] },
+    { name = "mdit-py-plugins" },
+    { name = "platformdirs" },
+    { name = "pygments" },
+    { name = "rich" },
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/00/21/39a76b01bd5eea82a04baaca7580e105d8c59450df03998345bb2cfb307b/textual-8.2.8.tar.gz", hash = "sha256:3f106a9fbc73e39dd266c9712432087de78a6d644084c7c241d6a25c3169115b", size = 1860502, upload-time = "2026-06-30T06:51:24.495Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/fb/be/35261223d9416a0751cdff1c7b4a6f881387218a12d439fe22fefebc8c04/textual-8.2.8-py3-none-any.whl", hash = "sha256:267375fd402dc8d981457212efa71f0e3365fd17bba144ba9bb3ed7563cb374a", size = 731418, upload-time = "2026-06-30T06:51:26.364Z" },
+]
+
+[[package]]
+name = "typing-extensions"
+version = "4.16.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f6/cc/6253133b5bb138fc3306cebfbda2c520f545d36b5be2c7255cc528bb45d6/typing_extensions-4.16.0.tar.gz", hash = "sha256:dc983d19a509c94dba722ee6abd33940f7c05a89e243c47e907eb4db6f1a43e5", size = 113555, upload-time = "2026-07-02T08:40:05.92Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/49/d3/b8441a820a491ddfc024b0b0cf0393375b75ea13866d9c66727e54c2fc80/typing_extensions-4.16.0-py3-none-any.whl", hash = "sha256:481caa481374e813c1b176ada14e97f1f67a4539ce9cfeb3f350d78d6370c2e8", size = 45571, upload-time = "2026-07-02T08:40:04.659Z" },
+]
+
+[[package]]
+name = "uc-micro-py"
+version = "2.0.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/78/67/9a363818028526e2d4579334460df777115bdec1bb77c08f9db88f6389f2/uc_micro_py-2.0.0.tar.gz", hash = "sha256:c53691e495c8db60e16ffc4861a35469b0ba0821fe409a8a7a0a71864d33a811", size = 6611, upload-time = "2026-03-01T06:31:27.526Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/61/73/d21edf5b204d1467e06500080a50f79d49ef2b997c79123a536d4a17d97c/uc_micro_py-2.0.0-py3-none-any.whl", hash = "sha256:3603a3859af53e5a39bc7677713c78ea6589ff188d70f4fee165db88e22b242c", size = 6383, upload-time = "2026-03-01T06:31:26.257Z" },
+]