linux-kernel-manager 0.1.2__py3-none-any.whl

linux_kernel_manager-0.1.2.dist-info/METADATA

@@ -0,0 +1,271 @@
+Metadata-Version: 2.4
+Name: linux-kernel-manager
+Version: 0.1.2
+Summary: Linux Kernel Manager — build, install, and manage kernels across all major distros and architectures
+Project-URL: Repository, https://github.com/Interested-Deving-1896/lkm
+License: GPL-3.0-or-later
+License-File: LICENSE
+Keywords: kernel,kernel-manager,linux,liquorix,lkf,nixos,package-manager,ukm,void,xanmod
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Environment :: X11 Applications :: Qt
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: System :: Operating System Kernels :: Linux
+Classifier: Topic :: System :: Systems Administration
+Classifier: Topic :: Utilities
+Requires-Python: >=3.11
+Requires-Dist: docopt-ng>=0.9
+Requires-Dist: requests>=2.31
+Provides-Extra: dev
+Requires-Dist: mypy; extra == 'dev'
+Requires-Dist: pyside6>=6.6; extra == 'dev'
+Requires-Dist: pytest-cov; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Provides-Extra: dev-no-gui
+Requires-Dist: mypy; extra == 'dev-no-gui'
+Requires-Dist: pytest-cov; extra == 'dev-no-gui'
+Requires-Dist: pytest>=8; extra == 'dev-no-gui'
+Requires-Dist: ruff; extra == 'dev-no-gui'
+Provides-Extra: pyqt6
+Requires-Dist: pyqt6>=6.6; extra == 'pyqt6'
+Provides-Extra: pyside6
+Requires-Dist: pyside6>=6.6; extra == 'pyside6'
+Description-Content-Type: text/markdown
+
+# lkm — Linux Kernel Manager
+
+Install, build, and manage Linux kernels across all major distributions and CPU architectures from a single CLI or GUI.
+
+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 — runtime management) into one tool covering the full kernel lifecycle:
+
+```
+fetch → patch → configure → compile → package → install → hold → remove
+```
+
+---
+
+## Kernel sources
+
+| Source | Architectures |
+|---|---|
+| Ubuntu Mainline PPA | amd64, arm64, armhf, ppc64el, s390x, i386 |
+| XanMod | amd64 (v1–v4, edge, lts, rt) |
+| Liquorix | amd64 |
+| Distro-native (via system package manager) | all |
+| Gentoo source compilation | all |
+| Local file (.deb / .rpm / .pkg.tar.* / .apk / .xbps) | all |
+| **lkf build** (compile from source via lkf profiles) | all |
+
+## Distributions supported
+
+Any distro using one of these package managers:
+
+| Package manager | Distros |
+|---|---|
+| `apt` | Debian, Ubuntu, Mint, Pop!\_OS, Kali, Kubuntu, Xubuntu, Lubuntu, Devuan, MX Linux, antiX, Zorin, elementary, KDE neon, SparkyLinux, BunsenLabs, Parrot, Proxmox, PikaOS, Bodhi, Lite, Emmabuntüs, Voyager, Linuxfx, Kodachi, AV Linux, wattOS, Feren, Peppermint, Q4OS, Ubuntu MATE, Ubuntu Studio, DragonOS, … |
+| `pacman` | Arch, Manjaro, EndeavourOS, CachyOS, Artix, RebornOS, ArchBang, Archcraft, Bluestar, Mabox, … |
+| `dnf` | Fedora, RHEL, AlmaLinux, Rocky, Nobara, Ultramarine, Bazzite, Oracle, Red Hat, … |
+| `zypper` | openSUSE Leap, openSUSE Tumbleweed, SLES, Regata, … |
+| `apk` | Alpine Linux |
+| `portage` | Gentoo |
+| `xbps` | Void Linux |
+| `nix` | NixOS |
+
+---
+
+## Install
+
+```sh
+# CLI only
+pip install lkm
+
+# GUI (PySide6 — recommended, LGPL)
+pip install "lkm[pyside6]"
+
+# GUI (PyQt6 — alternative, GPL)
+pip install "lkm[pyqt6]"
+```
+
+To force a specific Qt binding at runtime:
+
+```sh
+LKM_QT=PyQt6 lkm-gui
+```
+
+---
+
+## CLI usage
+
+### Runtime management
+
+```sh
+lkm list                            # all kernels from all sources
+lkm list --family=xanmod            # filter by family
+lkm list --installed                # installed only
+lkm list --json                     # machine-readable output
+lkm list --refresh                  # force re-fetch remote indexes
+
+lkm install 6.12.0                  # install by version
+lkm install 6.12.0 --flavor=rt      # install specific flavor
+lkm install 6.12.0 --provider=xanmod
+lkm install --local ./linux-image-6.12.0_amd64.deb
+
+lkm remove 6.8.0
+lkm remove 6.8.0 --purge            # also remove config files
+
+lkm hold   6.12.0                   # pin kernel (excluded from auto-upgrades)
+lkm unhold 6.12.0
+
+lkm note 6.12.0 "stable, use this"  # attach a note to a kernel
+
+lkm remove-old                      # remove all but running + most recent
+lkm remove-old --keep=2             # keep 2 most recent
+
+lkm providers                       # list available providers
+lkm info                            # system info (distro, arch, running kernel)
+```
+
+### Building with lkf
+
+Requires [lkf](https://github.com/Interested-Deving-1896/lkf) to be installed (`make install` from the lkf repo).
+
+```sh
+# Build from a remix.toml profile and install the result
+lkm remix --file ~/.local/share/lkf/profiles/gaming.toml --install
+
+# Build mainline 6.12 with Clang/LLVM + thin LTO, produce a .deb, then install
+lkm build --version 6.12 --flavor mainline --llvm --lto thin --output deb --install
+
+# Build without installing (package lands in ~/.cache/lkm/lkf-output/)
+lkm build --version 6.12 --flavor tkg --arch aarch64 --output rpm
+```
+
+---
+
+## GUI
+
+```sh
+lkm-gui
+```
+
+The GUI shows a tabbed window — one tab per kernel family plus an **All** tab. Each tab has a search bar, family/status filters, a sortable kernel table, and a live log panel at the bottom.
+
+Right-click any kernel row for: Install / Remove / Hold / Unhold / Edit Note.
+
+### Build tab
+
+The **⚙ Build…** toolbar button opens the lkf build dialog with two modes:
+
+- **Profile** — pick a `remix.toml` from discovered lkf profiles (or browse for one). Streams `lkf remix` output live.
+- **Custom** — specify version, flavor, arch, compiler flags (LLVM/LTO), and output format. Streams `lkf build` output live.
+
+On a successful build, lkm offers to install the resulting package immediately.
+
+---
+
+## Architecture
+
+```
+lkm/
+├── qt.py                        # PySide6/PyQt6 compatibility shim
+├── core/
+│   ├── kernel.py                # KernelEntry, KernelVersion, KernelFamily, KernelStatus
+│   ├── system.py                # distro/arch/package-manager detection
+│   ├── manager.py               # KernelManager — central coordinator, state persistence
+│   ├── backends/                # Package manager backends
+│   │   ├── apt.py               # Debian / Ubuntu / Mint / …
+│   │   ├── pacman.py            # Arch / Manjaro / CachyOS / …
+│   │   ├── dnf.py               # Fedora / RHEL / AlmaLinux / …
+│   │   ├── zypper.py            # openSUSE
+│   │   ├── apk.py               # Alpine
+│   │   ├── portage.py           # Gentoo
+│   │   ├── xbps.py              # Void Linux
+│   │   └── nix.py               # NixOS
+│   └── providers/               # Kernel source providers
+│       ├── mainline.py          # Ubuntu Mainline PPA
+│       ├── xanmod.py            # XanMod
+│       ├── liquorix.py          # Liquorix
+│       ├── distro.py            # Distro-native packages
+│       ├── local_file.py        # Pre-built local package files
+│       ├── lkf_build.py         # lkf build pipeline bridge
+│       ├── gentoo.py            # Gentoo source compilation
+│       ├── void.py              # Void Linux (xbps)
+│       └── nixos.py             # NixOS (declarative)
+├── cli/
+│   ├── main.py                  # CLI entry point
+│   └── output.py                # Colour output, tables, JSON mode
+└── gui/
+    ├── app.py                   # QApplication entry point + stylesheet
+    ├── kernel_model.py          # QAbstractTableModel for KernelEntry lists
+    ├── main_window.py           # Main window (toolbar, tabs, log panel)
+    └── widgets/
+        ├── kernel_view.py       # Filterable, sortable kernel table
+        ├── log_panel.py         # Collapsible live log panel
+        ├── lkf_build_dialog.py  # lkf build dialog (Profile + Custom modes)
+        ├── gentoo_compile_dialog.py
+        └── note_dialog.py
+```
+
+Adding a new kernel source: implement `KernelProvider` in `lkm/core/providers/` and register it in `lkm/core/providers/__init__.py`.
+
+Adding a new package manager: implement `PackageBackend` in `lkm/core/backends/` and register it in `lkm/core/backends/__init__.py` and `lkm/core/system.py`.
+
+---
+
+## Development
+
+```sh
+git clone https://github.com/Interested-Deving-1896/lkm
+cd lkm
+python3 -m venv .venv && source .venv/bin/activate
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+
+# Lint
+ruff check lkm/
+
+# Type check
+mypy lkm/
+
+# Launch GUI
+lkm-gui
+
+# Launch CLI
+lkm info
+lkm list
+```
+
+---
+
+## Notes on specific providers
+
+**Ubuntu Mainline PPA** — packages are unsigned and will not boot with Secure Boot enabled. lkm warns at startup if Secure Boot is detected.
+
+**XanMod / Liquorix** — x86-64 only. On first use, lkm offers to add the required apt repository and signing key automatically.
+
+**lkf build** — requires [lkf](https://github.com/Interested-Deving-1896/lkf) on PATH. Set `LKF_ROOT` to point lkm at a non-standard lkf installation. Build output lands in `~/.cache/lkm/lkf-output/` by default; override with `LKF_OUTPUT_DIR`.
+
+**Gentoo** — `lkm build` (via lkf) prints the interactive `make menuconfig` command for you to run in a terminal. The GUI Gentoo compile dialog streams the full build output live.
+
+**NixOS** — kernel selection is declarative. lkm emits the `boot.kernelPackages` configuration snippet and optionally runs `nixos-rebuild switch`. It does not edit `configuration.nix` directly. Run lkm inside a `nix-shell` (or `nix develop`) to ensure build tools are on PATH.
+
+---
+
+## License
+
+GPL-3.0-or-later. See [LICENSE](LICENSE).
+
+## Origins
+
+lkm is a merger of:
+- **[lkf](https://github.com/Interested-Deving-1896/lkf)** — Linux Kernel Framework (shell, build pipeline)
+- **[ukm](https://github.com/Interested-Deving-1896/ukm)** — Universal Kernel Manager (Python, runtime management)

linux_kernel_manager-0.1.2.dist-info/RECORD

@@ -0,0 +1,45 @@
+lkm/__init__.py,sha256=QXQ_e-ZYFEqwclZUa1vzq8x0tI97KFcv2xc-BE4lkbQ,76
+lkm/qt.py,sha256=tWEy0d3EfBqM0AleclZXsswX6Ak1Q5lzO31u-kxwoRU,2845
+lkm/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+lkm/cli/main.py,sha256=nBuq3-IwZxOMh6zAhSYCvm5MC34TeU4D6hZzoVEAY-Q,10052
+lkm/cli/output.py,sha256=MJHrzQ1EE1XZcMaDCCwMVC9n8hGRAp9vjAfW42cIssc,1535
+lkm/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+lkm/core/kernel.py,sha256=3TR88RqOSANdqkUBdTx293-BXDEkaCYOPZpJaZhehyg,3099
+lkm/core/manager.py,sha256=Xi8zWiXOz0bfCF2OjIk-0sRse9zBH4LAV1T1Oy89hJM,9561
+lkm/core/system.py,sha256=-NYZ77BxzF_Qjd92IQg5Kyzzv2giduWRSoCC4ziqfuQ,7552
+lkm/core/backends/__init__.py,sha256=n-qEF9mg2LPEpd12Pd8cvFUQZff9CxxVI2XpuPNYnlk,1694
+lkm/core/backends/apk.py,sha256=Z8aGgNscPDUpUrjgnq-wbZinL2xEu-sFlLSRpqFWwKs,1611
+lkm/core/backends/apt.py,sha256=aFEiXEMaXw3WdPj9bKYGJTUoRGJ7rW5KCUCN4b65Guc,3199
+lkm/core/backends/base.py,sha256=vM8pksqmmJpligAUpz2jIzFsZC-0l5F4OkgVdQeBd-M,2893
+lkm/core/backends/dnf.py,sha256=k0NIHQI6yjnCefTa_2tf1CJl3rKAHPV6B-6N5i3csBE,1515
+lkm/core/backends/nix.py,sha256=LWjaRH2jdJnlBx1qyAgbkUmFyqbPUYzvj5ShXXbGNuI,6999
+lkm/core/backends/pacman.py,sha256=S7kJlEaEeuLPjlhRjCEjubQE6BPJOAYgx67GZ0OwzdY,2743
+lkm/core/backends/portage.py,sha256=CcnkZlOtj8_fzezcw1EQ5wJPybznj2H3roth9fOfXjo,3950
+lkm/core/backends/xbps.py,sha256=4h_788dpBbe-g_CA72V8uF8_CWgccDIipc5rlomNuTE,5026
+lkm/core/backends/zypper.py,sha256=MttVePMUNVsvcWEfCBL4E2iJ3Ev-5BJHncO_kDgiBCg,1537
+lkm/core/providers/__init__.py,sha256=Uk11Z5uCdzlBncn0CACN7CigGVxkCQ9NApb61bdnX2Q,2078
+lkm/core/providers/base.py,sha256=e_RfocIUbXzWxnu3Q12tqKvfhx1-dwg5csuRtrwGLv8,2745
+lkm/core/providers/distro.py,sha256=qEWpduxR8W7d9DEm17lgDVxpQD12dUtXjOklbWlYs-c,5095
+lkm/core/providers/gentoo.py,sha256=8UzbUo3BMEeTHtvTgTQRxPd5GVQiCpWAbdr1Pu-7YWg,2197
+lkm/core/providers/liquorix.py,sha256=FODkTga8DvRunr70Yvn1cRQmqjpcHr_GUzaiip0L_9c,2853
+lkm/core/providers/lkf_build.py,sha256=we9WSzaq5Wb6wH-9XPT9fK8E6IDxS8ZXRR_gZt8Sk0o,11343
+lkm/core/providers/local_file.py,sha256=vgbLXjZj7vBibKT2SxULYJccSnn6nBb_sAOOb6N1L7I,3580
+lkm/core/providers/mainline.py,sha256=lrRBX1QllrH519mQ2STQV6sZeNXe89Pp0zbqIpGYR18,3477
+lkm/core/providers/nixos.py,sha256=KHkfz4Fg09HrwP3YGo3TuBsMle7P8tdlAoqIgJr1bAc,2440
+lkm/core/providers/void.py,sha256=UhvEHzX-MSODU4Y-OMyN8RwTdN2la03Ahkci_wugZQk,2096
+lkm/core/providers/xanmod.py,sha256=UETKOY63GBuxZrHV4KN74w2c5U7DYgK-EFgWE3aufyA,2701
+lkm/gui/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+lkm/gui/app.py,sha256=uNdeC4weZ276irehIIAzGmI_SFSga-GhvWUWt6QohqA,1952
+lkm/gui/kernel_model.py,sha256=WsjACbAk2bEZ25SMAwqtCAxdtTMajkuDu9WAPr8WELI,3006
+lkm/gui/main_window.py,sha256=QgrF4M04hjvDh38D5zI10cq8OP6fDpL2gK1D_2g08rE,13616
+lkm/gui/widgets/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+lkm/gui/widgets/gentoo_compile_dialog.py,sha256=rl9TobTUhIsgTzOLduNL_4LJSTR0hLwxcp2QCq6_keM,4244
+lkm/gui/widgets/kernel_view.py,sha256=0RbayzBGnXJQUFXYdMqC-VcKDc_3IfHyQkhTY9B9U54,4545
+lkm/gui/widgets/lkf_build_dialog.py,sha256=DM4JxKy3XDIS5lnj9EqDB1PSmHaesNJilERO2pmmHws,12855
+lkm/gui/widgets/log_panel.py,sha256=EjVkgCR6JPzUBs-155P39jM4JlY9xzcO3SfR_lLvmnQ,2298
+lkm/gui/widgets/note_dialog.py,sha256=-lzZAgQNMx4hQe9vIM0oXFWQ7PsaH90x02YRJBy1g7c,1066
+linux_kernel_manager-0.1.2.dist-info/METADATA,sha256=EwzRku9jneFlBro8P6Q4hJLKBp5my7vxXw_06xoM6tM,10381
+linux_kernel_manager-0.1.2.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+linux_kernel_manager-0.1.2.dist-info/entry_points.txt,sha256=1MV7lTPs9YRsQp_wvfYFJSfmypHRYDnCriGtGot2vEE,69
+linux_kernel_manager-0.1.2.dist-info/licenses/LICENSE,sha256=5X8cMguM-HmKfS_4Om-eBqM6A1hfbgZf6pfx2G24QFI,35150
+linux_kernel_manager-0.1.2.dist-info/RECORD,,

linux_kernel_manager-0.1.2.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

linux_kernel_manager-0.1.2.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+lkm = lkm.cli.main:main
+lkm-gui = lkm.gui.app:main