linux-kernel-manager 0.1.2__tar.gz

linux_kernel_manager-0.1.2/.github/pull_request_template.md

@@ -0,0 +1,73 @@
+## Summary
+
+Merges [lkf](https://github.com/Interested-Deving-1896/lkf) (Linux Kernel Framework — shell build pipeline) and [ukm](https://github.com/Interested-Deving-1896/ukm) (Universal Kernel Manager — Python runtime management) into a single Python package, `lkm`, covering the full kernel lifecycle: **build → install → manage**.
+
+---
+
+## What changed
+
+### A — lkf → ukm handoff
+- `lkm/core/providers/lkf_build.py`: discovers `remix.toml` profiles from the lkf installation, drives `lkf remix` / `lkf build` as a subprocess with live streaming output, locates the output package by extension, and installs it via the system backend.
+- `lkm/core/providers/local_file.py`: installs pre-built `.deb`/`.rpm`/`.pkg.tar.zst`/`.apk`/`.xbps` files dropped in by the user or produced by lkf.
+
+The full CLI pipeline:
+```sh
+lkm build --version 6.12 --flavor tkg --llvm --lto thin --install
+lkm remix --file ~/.local/share/lkf/profiles/gaming.toml --install
+```
+
+### B — New backends (distro/arch agnosticism)
+| Backend | Distro | Notes |
+|---|---|---|
+| `xbps.py` | Void Linux | install/remove via `xbps-install`/`xbps-remove`; hold/unhold via `xbps-pkgdb -m hold/unhold`; local `.xbps` via `-R <repodir>` |
+| `nix.py` | NixOS | emits `boot.kernelPackages` snippets + optional `nixos-rebuild switch`; hold/unhold explains declarative pinning |
+
+`system.py` extended: `VOID`/`NIXOS` added to `DistroFamily` and `PackageManagerKind`; `in_nix_shell` field added to `SystemInfo`.
+
+### C — Unified project
+- Single `pyproject.toml` with `lkm` (CLI) and `lkm-gui` (Qt GUI) entry points.
+- `KernelFamily` gains `LKF_BUILD` for locally compiled kernels.
+- `KernelManager` gains `lkf_provider`, `install_local()`, and `nixos_build_warning()`.
+- `providers/__init__.py` selects family-specific providers (Gentoo, Void, NixOS) at runtime.
+
+### D — GUI Build tab
+`lkm/gui/widgets/lkf_build_dialog.py` — two modes:
+- **Profile**: pick a `remix.toml` from discovered profiles (or browse), run `lkf remix`, stream output live.
+- **Custom**: version + flavor + arch + LLVM/LTO/output-format fields, run `lkf build`.
+
+A `_BuildWorker(QThread)` streams output into the shared `LogPanel`. On success, `build_succeeded(pkg_path)` is emitted; the main window offers to install the result. The toolbar **Build…** button is disabled with a tooltip when lkf is not on PATH.
+
+---
+
+## Tests
+
+97 tests, all passing:
+
+| Suite | Coverage |
+|---|---|
+| `test_kernel_version.py` | `KernelVersion` parse, comparison, sort, hash |
+| `test_system_detection.py` | distro family detection for 10 distros, arch normalisation (9 mappings), PM detection (8 binaries + family fallback) |
+| `test_backends.py` | `XbpsBackend` (13 cases), `NixBackend` (11 cases) |
+| `test_lkf_bridge.py` | profile parsing, output package discovery, availability, listing, streaming, error handling, full build+install pipeline |
+| `test_local_file_provider.py` | version extraction from 4 package formats, install delegation, error cases |
+
+---
+
+## Known limitations
+
+- **NixOS install** runs `nixos-rebuild switch` but does not edit `configuration.nix`. A full implementation requires knowing whether the user is on channels or flakes.
+- **lkf root detection** falls back to `lkf info --json`, which requires lkf ≥ 0.1.0. Older installs still work via `LKF_ROOT` env var or standard path detection.
+- `lkm/build/` is scaffolded but empty — reserved for vendoring lkf's shell scripts if desired.
+
+---
+
+## Distro coverage (against fresh-eggs support matrix)
+
+All package manager backends from ukm are retained. The two new backends close the remaining gaps:
+
+| Added | Distro | Package manager |
+|---|---|---|
+| ✅ | Void Linux | xbps |
+| ✅ | NixOS | nix / nixos-rebuild |
+
+Unsupported distros (Slackware, Mandrake-based, non-Linux) remain out of scope.

linux_kernel_manager-0.1.2/.github/workflows/appimage.yml

@@ -0,0 +1,62 @@
+name: AppImage
+
+on:
+  push:
+    tags:
+      - 'v*'
+  workflow_dispatch:
+
+jobs:
+  build:
+    name: Build AppImage (${{ matrix.arch }})
+    runs-on: ${{ matrix.runner }}
+    strategy:
+      matrix:
+        include:
+          - arch: x86_64
+            runner: ubuntu-22.04
+          - arch: aarch64
+            runner: ubuntu-22.04-arm
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install system dependencies
+        run: |
+          sudo apt-get update -qq
+          sudo apt-get install -y --no-install-recommends \
+            wget libfuse2 imagemagick python3-pip
+
+      - name: Build AppImage
+        env:
+          ARCH: ${{ matrix.arch }}
+          OUT_DIR: ${{ github.workspace }}/dist
+        run: bash pkg/appimage/build-appimage.sh
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: LKM-AppImage-${{ matrix.arch }}
+          path: dist/LKM-*.AppImage
+          if-no-files-found: error
+
+  release:
+    name: Attach to GitHub Release
+    needs: build
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/')
+    permissions:
+      contents: write
+
+    steps:
+      - name: Download artifacts
+        uses: actions/download-artifact@v4
+        with:
+          pattern: LKM-AppImage-*
+          merge-multiple: true
+          path: dist/
+
+      - name: Upload to release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: dist/LKM-*.AppImage

linux_kernel_manager-0.1.2/.github/workflows/ci.yml

@@ -0,0 +1,139 @@
+name: CI
+
+on:
+  push:
+    branches: ["main", "feat/**", "fix/**"]
+  pull_request:
+    branches: ["main"]
+
+jobs:
+  test:
+    name: pytest / Python ${{ matrix.python }} / ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, ubuntu-22.04]
+        python: ["3.11", "3.12"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python }}
+          cache: pip
+
+      - name: Install
+        run: pip install -e ".[dev]"
+
+      - name: Lint (ruff)
+        run: ruff check lkm/
+
+      - name: Test
+        run: pytest --tb=short --cov=lkm --cov-report=term-missing
+
+      - name: Upload coverage
+        if: matrix.python == '3.12' && matrix.os == 'ubuntu-latest'
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage-report
+          path: .coverage
+
+  test-alpine:
+    name: pytest / Python 3.12 / Alpine
+    runs-on: ubuntu-latest
+    container: python:3.12-alpine
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install build deps
+        run: apk add --no-cache gcc musl-dev linux-headers
+
+      - name: Install
+        # PySide6 has no musl wheel; use dev-no-gui to skip it on Alpine
+        run: pip install -e ".[dev-no-gui]"
+
+      - name: Test
+        run: python -m pytest --tb=short
+
+  type-check:
+    name: mypy
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          cache: pip
+
+      - name: Install
+        run: pip install -e ".[dev]"
+
+      - name: Type check
+        run: mypy lkm/ --ignore-missing-imports
+
+  integration-apt:
+    name: Integration / apt (Ubuntu)
+    runs-on: ubuntu-latest
+    # Real package manager operations; allowed to fail without blocking the PR
+    continue-on-error: true
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          cache: pip
+
+      - name: Install
+        run: pip install -e ".[dev]"
+
+      - name: Integration tests (apt)
+        # Use the venv python explicitly so sudo can find pytest.
+        # Failures are informational; the unit test matrix is the hard gate.
+        run: sudo -E "$(which python)" -m pytest tests/integration/test_apt_backend.py -v --tb=short || true
+
+  integration-xbps:
+    name: Integration / xbps (Void Linux)
+    runs-on: ubuntu-latest
+    # xbps is not available on standard runners; tests self-skip via requires_xbps marker
+    continue-on-error: true
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          cache: pip
+
+      - name: Install lkm
+        run: pip install -e ".[dev-no-gui]"
+
+      - name: Integration tests (xbps)
+        # Tests skip automatically when xbps-install is not on PATH
+        run: python -m pytest tests/integration/test_xbps_backend.py -v --tb=short || true
+
+  integration-pacman:
+    name: Integration / pacman (Arch Linux)
+    runs-on: ubuntu-latest
+    container: archlinux:latest
+    # Real package manager operations; allowed to fail without blocking the PR
+    continue-on-error: true
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Python
+        run: pacman -Sy --noconfirm python python-pip
+
+      - name: Install lkm
+        run: pip install -e ".[dev-no-gui]" --break-system-packages
+
+      - name: Integration tests (pacman)
+        run: python -m pytest tests/integration/test_pacman_backend.py -v --tb=short || true

linux_kernel_manager-0.1.2/.github/workflows/flatpak.yml

@@ -0,0 +1,79 @@
+name: Flatpak
+
+on:
+  push:
+    tags:
+      - 'v*'
+  pull_request:
+    paths:
+      - 'pkg/flatpak/**'
+  workflow_dispatch:
+
+jobs:
+  build:
+    name: Build & validate Flatpak
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install flatpak-builder
+        run: |
+          sudo apt-get update -qq
+          sudo apt-get install -y --no-install-recommends \
+            flatpak flatpak-builder elfutils librsvg2-common
+
+      - name: Add Flathub remote
+        run: |
+          sudo flatpak remote-add --if-not-exists flathub \
+            https://dl.flathub.org/repo/flathub.flatpakrepo
+
+      - name: Install KDE runtime & SDK
+        run: |
+          sudo flatpak install -y --noninteractive flathub \
+            org.kde.Platform//6.7 \
+            org.kde.Sdk//6.7
+
+      - name: Build Flatpak
+        run: |
+          flatpak-builder --force-clean --disable-rofiles-fuse \
+            build-dir pkg/flatpak/io.github.lkm.lkm.yml
+
+      - name: Validate metainfo
+        run: |
+          flatpak run --command=appstreamcli org.kde.Sdk//6.7 \
+            validate pkg/flatpak/io.github.lkm.lkm.metainfo.xml || true
+
+      - name: Export bundle
+        if: startsWith(github.ref, 'refs/tags/')
+        run: |
+          flatpak build-export repo build-dir
+          flatpak build-bundle repo LKM.flatpak io.github.lkm.lkm
+
+      - name: Upload bundle artifact
+        if: startsWith(github.ref, 'refs/tags/')
+        uses: actions/upload-artifact@v4
+        with:
+          name: LKM-flatpak
+          path: LKM.flatpak
+          if-no-files-found: error
+
+  release:
+    name: Attach to GitHub Release
+    needs: build
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/')
+    permissions:
+      contents: write
+
+    steps:
+      - name: Download artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: LKM-flatpak
+          path: dist/
+
+      - name: Upload to release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: dist/LKM.flatpak

linux_kernel_manager-0.1.2/.github/workflows/publish.yml

@@ -0,0 +1,85 @@
+name: Publish to PyPI
+
+# Trusted publishing must be configured on PyPI/TestPyPI before this workflow
+# will succeed. See: https://docs.pypi.org/trusted-publishers/adding-a-publisher/
+#
+# Required configuration on both PyPI and TestPyPI:
+#   Owner:     Interested-Deving-1896
+#   Repo:      lkm
+#   Workflow:  publish.yml
+#   Env (TestPyPI): testpypi
+#   Env (PyPI):     pypi
+
+on:
+  push:
+    tags:
+      - "v*.*.*"
+
+jobs:
+  build:
+    name: Build distribution
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tools
+        run: pip install build twine
+
+      - name: Build sdist and wheel
+        run: python -m build
+
+      - name: Check distribution
+        run: twine check dist/*
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish-testpypi:
+    name: Publish to TestPyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment: testpypi
+    permissions:
+      id-token: write
+
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to TestPyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+          skip-existing: true
+        # Trusted publisher must be configured at test.pypi.org first.
+        # Failure here does not block the PyPI publish job.
+        continue-on-error: true
+
+  publish-pypi:
+    name: Publish to PyPI
+    # Run after build regardless of TestPyPI outcome
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          skip-existing: true

linux_kernel_manager-0.1.2/.gitignore

@@ -0,0 +1,33 @@
+# Python
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+.Python
+*.egg-info/
+dist/
+build/
+.eggs/
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# Test / coverage
+.pytest_cache/
+.coverage
+htmlcov/
+.mypy_cache/
+.ruff_cache/
+
+# Editor
+.vscode/
+.idea/
+*.swp
+*.swo
+.DS_Store
+
+# lkm runtime state
+~/.config/lkm/
+~/.cache/lkm/