linman 0.0.1__tar.gz

linman-0.0.1/.github/workflows/ci.yml

@@ -0,0 +1,126 @@
+name: CI
+
+on:
+  push:
+    branches: [ main, master, development ]
+    tags: [ "v*" ]
+  pull_request:
+    branches: [ main, master, development ]
+
+concurrency:
+  group: ci-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Build
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Install project (with build backend)
+        # Resolves from pyproject ranges; [tool.uv] exclude-newer applies
+        run: uv sync --all-groups
+
+      - name: Lint
+        run: uv run ruff check apphub tests
+
+      - name: Build sdist + wheel
+        run: uv build
+
+      - name: Upload dist artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+          if-no-files-found: error
+          retention-days: 14
+
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+    needs: build
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: [ "3.11", "3.12", "3.13" ]
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --all-groups
+
+      - name: Run tests with coverage
+        run: >
+          uv run pytest -q
+          --cov=apphub
+          --cov-report=term-missing
+          --cov-report=xml
+          --cov-fail-under=85
+
+      - name: Upload coverage (3.12 only)
+        if: matrix.python-version == '3.12'
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage-report
+          path: coverage.xml
+          if-no-files-found: ignore
+          retention-days: 14
+
+
+  release-package:
+    name: Release package
+    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')
+    needs: [ build, test ]
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      id-token: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Download build artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: List packages
+        run: ls -lh dist/
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: dist/*
+          generate_release_notes: true
+          fail_on_unmatched_files: true
+
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        continue-on-error: true
+        with:
+          packages-dir: dist/
+          skip-existing: true

linman-0.0.1/.gitignore

@@ -0,0 +1,21 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+.pytest_cache/
+build/
+dist/
+wheels/
+*.egg-info
+.run/
+# Virtual environments
+.venv
+/.idea/
+
+# some files
+uv.lock
+.python-version
+linux_app_hub.py
+apphub.log
+.coverage
+coverage.xml
+htmlcov/

linman-0.0.1/LICENSE

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

linman-0.0.1/PKG-INFO

@@ -0,0 +1,163 @@
+Metadata-Version: 2.4
+Name: linman
+Version: 0.0.1
+Summary: Linman - Manage your Linux applications across all formats.
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: black>=26.5.1
+Requires-Dist: pydantic>=2.0
+Requires-Dist: pyyaml>=6.0.3
+Requires-Dist: rich>=13.0.0
+Requires-Dist: typer>=0.24.0
+Description-Content-Type: text/markdown
+
+# linman
+
+`linman` is a terminal-based application manager for Linux. It provides a unified CLI to work with multiple package formats from one place.
+
+## Features
+
+- **Multi-backend support** — manage apps across:
+  - `apt` (Debian packages)
+  - `snap`
+  - `flatpak` (Flathub)
+  - `appimage`
+- **System app detection** — identify and categorize system utilities and libraries
+- **Application manifests** — consistent view of versions, publishers, sizes, and categories
+- **Categorization** — group software into `system`, `cli`, and `desktop`
+
+## Installation
+
+Requires Python **3.11+**.
+
+### pipx (recommended)
+
+```bash
+pipx install linman
+```
+
+### uv
+
+```bash
+uv tool install linman
+```
+
+After install, the CLI is available as:
+
+```bash
+linman --help
+linman --version
+```
+
+### Upgrade
+
+```bash
+pipx upgrade linman
+# or
+uv tool upgrade linman
+```
+
+## Usage
+
+### Common options
+
+| Flag       | Short | Description                                                     | Commands                                                  |
+|------------|-------|-----------------------------------------------------------------|-----------------------------------------------------------|
+| `--json`   |       | Output results as JSON                                          | `list`, `search`, `inspect`, `info`, `storage`, `history` |
+| `--format` | `-f`  | Filter by package format (`snap`, `apt`, `flatpak`, `appimage`) | `list`, `search`, `install`, `storage`, `history`         |
+| `--sort`   | `-s`  | Sort by field (e.g. name, version, format, timestamp)           | `list`, `history`                                         |
+| `--count`  | `-n`  | Print only the number of matching items                         | `list`, `search`                                          |
+
+### Commands
+
+#### `linman list`
+
+List installed applications (name, format, version, publisher).
+
+```bash
+linman list                       # List all applications
+linman list <query>               # Filter installed apps by name
+linman list -e                    # Exclude system/default packages
+linman list -f snap               # Filter by format (repeatable)
+linman list -s version            # Sort by field (name, version, format)
+```
+
+#### `linman search`
+
+Search available applications across supported registries.
+
+```bash
+linman search <query>
+linman search <query> -f flatpak
+linman search <query> -n
+```
+
+#### `linman inspect`
+
+Inspect a local package file (e.g. `.AppImage`, `.deb`) and print its manifest.
+
+```bash
+linman inspect <path_to_file>
+linman inspect <path_to_file> --json
+```
+
+#### `linman install`
+
+Install from a registry name or a local file. Format is auto-detected for local files.
+
+```bash
+linman install <name_or_path>
+linman install <name_or_path> -y   # Auto-confirm
+linman install <name_or_path> -l   # Launch after install
+linman install <name> -f snap      # Restrict search to a format
+```
+
+#### `linman uninstall`
+
+Remove an installed application.
+
+```bash
+linman uninstall <application_name>
+linman uninstall <application_name> -y   # Auto-confirm
+linman uninstall <application_name> -c   # Clean uninstall (associated data)
+```
+
+#### `linman info`
+
+Show detailed metadata for an application.
+
+```bash
+linman info <application_name>
+linman info <application_name> --json
+```
+
+#### `linman storage`
+
+Disk usage by installed applications.
+
+```bash
+linman storage
+linman storage -f snap
+linman storage -t 10
+linman storage --json
+```
+
+#### `linman history`
+
+Installation / upgrade / uninstall history.
+
+```bash
+linman history
+linman history -f flatpak
+linman history -a installed       # installed | upgraded | uninstalled
+linman history -s timestamp -d
+linman history -t 10
+```
+
+## Contributing
+
+Contributions are welcome. Open an issue for larger changes, or submit a pull request.
+
+## License
+
+MIT

linman-0.0.1/README.md

@@ -0,0 +1,150 @@
+# linman
+
+`linman` is a terminal-based application manager for Linux. It provides a unified CLI to work with multiple package formats from one place.
+
+## Features
+
+- **Multi-backend support** — manage apps across:
+  - `apt` (Debian packages)
+  - `snap`
+  - `flatpak` (Flathub)
+  - `appimage`
+- **System app detection** — identify and categorize system utilities and libraries
+- **Application manifests** — consistent view of versions, publishers, sizes, and categories
+- **Categorization** — group software into `system`, `cli`, and `desktop`
+
+## Installation
+
+Requires Python **3.11+**.
+
+### pipx (recommended)
+
+```bash
+pipx install linman
+```
+
+### uv
+
+```bash
+uv tool install linman
+```
+
+After install, the CLI is available as:
+
+```bash
+linman --help
+linman --version
+```
+
+### Upgrade
+
+```bash
+pipx upgrade linman
+# or
+uv tool upgrade linman
+```
+
+## Usage
+
+### Common options
+
+| Flag       | Short | Description                                                     | Commands                                                  |
+|------------|-------|-----------------------------------------------------------------|-----------------------------------------------------------|
+| `--json`   |       | Output results as JSON                                          | `list`, `search`, `inspect`, `info`, `storage`, `history` |
+| `--format` | `-f`  | Filter by package format (`snap`, `apt`, `flatpak`, `appimage`) | `list`, `search`, `install`, `storage`, `history`         |
+| `--sort`   | `-s`  | Sort by field (e.g. name, version, format, timestamp)           | `list`, `history`                                         |
+| `--count`  | `-n`  | Print only the number of matching items                         | `list`, `search`                                          |
+
+### Commands
+
+#### `linman list`
+
+List installed applications (name, format, version, publisher).
+
+```bash
+linman list                       # List all applications
+linman list <query>               # Filter installed apps by name
+linman list -e                    # Exclude system/default packages
+linman list -f snap               # Filter by format (repeatable)
+linman list -s version            # Sort by field (name, version, format)
+```
+
+#### `linman search`
+
+Search available applications across supported registries.
+
+```bash
+linman search <query>
+linman search <query> -f flatpak
+linman search <query> -n
+```
+
+#### `linman inspect`
+
+Inspect a local package file (e.g. `.AppImage`, `.deb`) and print its manifest.
+
+```bash
+linman inspect <path_to_file>
+linman inspect <path_to_file> --json
+```
+
+#### `linman install`
+
+Install from a registry name or a local file. Format is auto-detected for local files.
+
+```bash
+linman install <name_or_path>
+linman install <name_or_path> -y   # Auto-confirm
+linman install <name_or_path> -l   # Launch after install
+linman install <name> -f snap      # Restrict search to a format
+```
+
+#### `linman uninstall`
+
+Remove an installed application.
+
+```bash
+linman uninstall <application_name>
+linman uninstall <application_name> -y   # Auto-confirm
+linman uninstall <application_name> -c   # Clean uninstall (associated data)
+```
+
+#### `linman info`
+
+Show detailed metadata for an application.
+
+```bash
+linman info <application_name>
+linman info <application_name> --json
+```
+
+#### `linman storage`
+
+Disk usage by installed applications.
+
+```bash
+linman storage
+linman storage -f snap
+linman storage -t 10
+linman storage --json
+```
+
+#### `linman history`
+
+Installation / upgrade / uninstall history.
+
+```bash
+linman history
+linman history -f flatpak
+linman history -a installed       # installed | upgraded | uninstalled
+linman history -s timestamp -d
+linman history -t 10
+```
+
+## Contributing
+
+Contributions are welcome. Open an issue for larger changes, or submit a pull request.
+
+## License
+
+MIT

linman-0.0.1/apphub/cli/banner.py

@@ -0,0 +1,74 @@
+from rich.align import Align
+from rich.console import Console, Group
+from rich.panel import Panel
+from rich.text import Text
+
+# Block-style wordmark — reads clearly at typical terminal widths.
+_LOGO_LINES = [
+    r" ██╗     ██╗███╗   ██╗███╗   ███╗ █████╗ ███╗   ██╗",
+    r" ██║     ██║████╗  ██║████╗ ████║██╔══██╗████╗  ██║",
+    r" ██║     ██║██╔██╗ ██║██╔████╔██║███████║██╔██╗ ██║",
+    r" ██║     ██║██║╚██╗██║██║╚██╔╝██║██╔══██║██║╚██╗██║",
+    r" ███████╗██║██║ ╚████║██║ ╚═╝ ██║██║  ██║██║ ╚████║",
+    r" ╚══════╝╚═╝╚═╝  ╚═══╝╚═╝     ╚═╝╚═╝  ╚═╝╚═╝  ╚═══╝",
+]
+
+# Gradient stops (top → bottom) — cyan → blue → magenta.
+_GRADIENT = [
+    "bright_cyan",
+    "cyan",
+    "deep_sky_blue1",
+    "dodger_blue1",
+    "medium_purple",
+    "medium_orchid",
+]
+
+_TAGLINE = "Linux App Manager  ·  apt  ·  snap  ·  flatpak  ·  appimage"
+_SUB = "one CLI  ·  every format  ·  zero friction"
+
+
+def render_logo() -> Text:
+    """Return a colorized LINMAN wordmark."""
+    logo = Text()
+    for i, line in enumerate(_LOGO_LINES):
+        style = _GRADIENT[i % len(_GRADIENT)]
+        logo.append(line + "\n", style=f"bold {style}")
+    return logo
+
+
+def print_banner(
+    console: Console | None = None,
+    *,
+    version: str = "0.1.0",
+    show_panel: bool = True,
+) -> None:
+    """Print the linman logo banner to the terminal."""
+    console = console or Console()
+
+    logo = render_logo()
+    tagline = Text(_TAGLINE, style="bold white")
+    sub = Text(_SUB, style="dim italic")
+    ver = Text(f"v{version}", style="dim cyan")
+
+    body = Group(
+        Align.center(logo),
+        Align.center(tagline),
+        Align.center(sub),
+        Align.center(ver),
+    )
+
+    if show_panel:
+        console.print(
+            Panel(
+                body,
+                border_style="bright_cyan",
+                padding=(1, 2),
+                title="[bold bright_magenta]◆[/] [bold white]linman[/]",
+                title_align="left",
+                subtitle="[dim]unified package hub[/]",
+                subtitle_align="right",
+            )
+        )
+    else:
+        console.print(body)
+        console.print()