diskman 0.2.1__tar.gz

diskman-0.2.1/LICENSE

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

diskman-0.2.1/PKG-INFO

@@ -0,0 +1,192 @@
+Metadata-Version: 2.4
+Name: diskman
+Version: 0.2.1
+Summary: CLI + TUI disk manager with SMART, LUKS, and non-blocking automount
+Home-page: https://github.com/gaffer/disk-manager
+Author: Gaffer
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/gaffer/disk-manager
+Project-URL: Repository, https://github.com/gaffer/disk-manager
+Project-URL: Issues, https://github.com/gaffer/disk-manager/issues
+Keywords: linux,disk,partition,mount,luks,smart,tui,cli
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: System Administrators
+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: Topic :: System :: Systems Administration
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: rich>=13.7.0
+Provides-Extra: binary
+Requires-Dist: pyinstaller>=6.0; extra == "binary"
+Provides-Extra: release
+Requires-Dist: build>=1.2.0; extra == "release"
+Requires-Dist: twine>=5.0.0; extra == "release"
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# diskman
+
+[![PyPI version](https://img.shields.io/pypi/v/diskman.svg)](https://pypi.org/project/diskman/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
+
+**diskman** is a lightweight, terminal-first Linux disk and partition manager. It provides a powerful CLI and an interactive TUI for day-to-day storage administration, featuring SMART health monitoring, LUKS encryption support, and filesystem-aware automounting.
+
+---
+
+## 🚀 Key Features
+
+- **Dual Interface:** Full-featured Command Line Interface (CLI) and an interactive Terminal User Interface (TUI).
+- **Smart Automount:** Filesystem-aware mount options (e.g., `discard` for SSDs, UID/GID mapping for FAT/NTFS).
+- **LUKS Support:** Auto-detection, unlocking, and locking of encrypted partitions.
+- **Health Monitoring:** Real-time SMART health status visibility (via `smartmontools`).
+- **Safety First:** Automatically excludes root partitions from destructive operations and provides a **read-only fallback** if a writable mount fails.
+- **Non-Blocking Ops:** Asynchronous mount, unmount, and LUKS operations to keep the TUI responsive.
+- **Persistence:** Easily toggle reboot-persistent mounts via tagged `/etc/fstab` entries.
+- **System Integration:** Ready-to-use `systemd` service and timer for periodic automounting.
+
+---
+
+## 📦 Installation
+
+### From PyPI (Recommended)
+
+Install the latest stable version directly from PyPI:
+
+```bash
+python3 -m pip install --upgrade diskman
+```
+
+### From Source
+
+```bash
+git clone https://github.com/SoyalIslam/disk-manager.git
+cd disk-manager
+python3 -m pip install .
+```
+
+### Requirements
+
+- **OS:** Linux
+- **Python:** 3.9+
+- **System Tools:** `util-linux` (`lsblk`, `findmnt`, `mount`, `umount`)
+- **Optional Tools:**
+  - `cryptsetup` (for LUKS support)
+  - `smartmontools` (for SMART health monitoring)
+
+---
+
+## 🛠 Usage
+
+### CLI Reference
+
+| Command | Description |
+| :--- | :--- |
+| `diskman list` | List all partitions, filesystems, and mount status. |
+| `diskman tui` | Launch the interactive Terminal User Interface. |
+| `sudo diskman automount` | Auto-mount all available partitions (excluding root). |
+| `sudo diskman mount /dev/sdb1` | Mount a specific device (prompts for LUKS if needed). |
+| `sudo diskman umount /dev/sdb1` | Unmount a specific device. |
+| `sudo diskman luks-unlock /dev/sdb2` | Unlock a LUKS encrypted partition. |
+| `sudo diskman boot-add /dev/sdb1` | Enable reboot-persistent mount in `/etc/fstab`. |
+
+*Note: Operations that modify system state (mount/unmount/LUKS/fstab) require `sudo`.*
+
+### TUI Controls
+
+Launch with `diskman tui` (or `sudo diskman tui` for full functionality):
+
+- **`j` / `k`** or **Arrow Keys**: Navigate device list.
+- **`m`**: Mount or unmount the selected partition.
+- **`u` / `l`**: Unlock or lock a LUKS partition.
+- **`a`**: Trigger a background automount of all devices.
+- **`p`**: Toggle persistence (`/etc/fstab`) for the selected device.
+- **`r`**: Refresh the device list.
+- **`q`**: Exit.
+
+---
+
+## ⚙️ System Integration
+
+### Periodic Automount (systemd)
+
+You can automate mounting of external drives using the provided systemd units:
+
+1. **Install Units:**
+   ```bash
+   sudo install -Dm644 extras/systemd/diskman-automount.service /etc/systemd/system/
+   sudo install -Dm644 extras/systemd/diskman-automount.timer /etc/systemd/system/
+   ```
+
+2. **Enable Timer:**
+   ```bash
+   sudo systemctl daemon-reload
+   sudo systemctl enable --now diskman-automount.timer
+   ```
+
+---
+
+## 🏗 Development
+
+### Setup Environment
+
+```bash
+python3 -m venv .venv
+source .venv/bin/activate
+pip install -r requirements-dev.txt
+```
+
+### Build & Package
+
+```bash
+# Build distribution archives
+python3 -m build
+
+# Build standalone binary (via PyInstaller)
+./scripts/build_binary.sh
+```
+
+### GitHub Actions: Publish to PyPI
+
+This repo includes:
+
+- `.github/workflows/publish-pypi.yml`
+
+Set these repository secrets in GitHub:
+
+- `PYPI_API_TOKEN`
+- `TEST_PYPI_API_TOKEN`
+
+Workflow usage:
+
+1. Manual publish to TestPyPI:
+   - Actions -> `Publish Python Package` -> `Run workflow` -> target `testpypi`
+2. Manual publish to PyPI:
+   - Actions -> `Publish Python Package` -> `Run workflow` -> target `pypi`
+3. Auto publish to PyPI on tag:
+   - Push tag `vX.Y.Z` matching `pyproject.toml` version
+
+```bash
+git tag v0.2.1
+git push origin v0.2.1
+```
+
+---
+
+## 📄 License
+
+This project is licensed under the **MIT License**. See the [LICENSE](LICENSE) file for details.
+
+## 🤝 Contributing
+
+Contributions, issues, and feature requests are welcome! Feel free to check the [issues page](https://github.com/SoyalIslam/disk-manager/issues).

diskman-0.2.1/README.md

@@ -0,0 +1,156 @@
+# diskman
+
+[![PyPI version](https://img.shields.io/pypi/v/diskman.svg)](https://pypi.org/project/diskman/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
+
+**diskman** is a lightweight, terminal-first Linux disk and partition manager. It provides a powerful CLI and an interactive TUI for day-to-day storage administration, featuring SMART health monitoring, LUKS encryption support, and filesystem-aware automounting.
+
+---
+
+## 🚀 Key Features
+
+- **Dual Interface:** Full-featured Command Line Interface (CLI) and an interactive Terminal User Interface (TUI).
+- **Smart Automount:** Filesystem-aware mount options (e.g., `discard` for SSDs, UID/GID mapping for FAT/NTFS).
+- **LUKS Support:** Auto-detection, unlocking, and locking of encrypted partitions.
+- **Health Monitoring:** Real-time SMART health status visibility (via `smartmontools`).
+- **Safety First:** Automatically excludes root partitions from destructive operations and provides a **read-only fallback** if a writable mount fails.
+- **Non-Blocking Ops:** Asynchronous mount, unmount, and LUKS operations to keep the TUI responsive.
+- **Persistence:** Easily toggle reboot-persistent mounts via tagged `/etc/fstab` entries.
+- **System Integration:** Ready-to-use `systemd` service and timer for periodic automounting.
+
+---
+
+## 📦 Installation
+
+### From PyPI (Recommended)
+
+Install the latest stable version directly from PyPI:
+
+```bash
+python3 -m pip install --upgrade diskman
+```
+
+### From Source
+
+```bash
+git clone https://github.com/SoyalIslam/disk-manager.git
+cd disk-manager
+python3 -m pip install .
+```
+
+### Requirements
+
+- **OS:** Linux
+- **Python:** 3.9+
+- **System Tools:** `util-linux` (`lsblk`, `findmnt`, `mount`, `umount`)
+- **Optional Tools:**
+  - `cryptsetup` (for LUKS support)
+  - `smartmontools` (for SMART health monitoring)
+
+---
+
+## 🛠 Usage
+
+### CLI Reference
+
+| Command | Description |
+| :--- | :--- |
+| `diskman list` | List all partitions, filesystems, and mount status. |
+| `diskman tui` | Launch the interactive Terminal User Interface. |
+| `sudo diskman automount` | Auto-mount all available partitions (excluding root). |
+| `sudo diskman mount /dev/sdb1` | Mount a specific device (prompts for LUKS if needed). |
+| `sudo diskman umount /dev/sdb1` | Unmount a specific device. |
+| `sudo diskman luks-unlock /dev/sdb2` | Unlock a LUKS encrypted partition. |
+| `sudo diskman boot-add /dev/sdb1` | Enable reboot-persistent mount in `/etc/fstab`. |
+
+*Note: Operations that modify system state (mount/unmount/LUKS/fstab) require `sudo`.*
+
+### TUI Controls
+
+Launch with `diskman tui` (or `sudo diskman tui` for full functionality):
+
+- **`j` / `k`** or **Arrow Keys**: Navigate device list.
+- **`m`**: Mount or unmount the selected partition.
+- **`u` / `l`**: Unlock or lock a LUKS partition.
+- **`a`**: Trigger a background automount of all devices.
+- **`p`**: Toggle persistence (`/etc/fstab`) for the selected device.
+- **`r`**: Refresh the device list.
+- **`q`**: Exit.
+
+---
+
+## ⚙️ System Integration
+
+### Periodic Automount (systemd)
+
+You can automate mounting of external drives using the provided systemd units:
+
+1. **Install Units:**
+   ```bash
+   sudo install -Dm644 extras/systemd/diskman-automount.service /etc/systemd/system/
+   sudo install -Dm644 extras/systemd/diskman-automount.timer /etc/systemd/system/
+   ```
+
+2. **Enable Timer:**
+   ```bash
+   sudo systemctl daemon-reload
+   sudo systemctl enable --now diskman-automount.timer
+   ```
+
+---
+
+## 🏗 Development
+
+### Setup Environment
+
+```bash
+python3 -m venv .venv
+source .venv/bin/activate
+pip install -r requirements-dev.txt
+```
+
+### Build & Package
+
+```bash
+# Build distribution archives
+python3 -m build
+
+# Build standalone binary (via PyInstaller)
+./scripts/build_binary.sh
+```
+
+### GitHub Actions: Publish to PyPI
+
+This repo includes:
+
+- `.github/workflows/publish-pypi.yml`
+
+Set these repository secrets in GitHub:
+
+- `PYPI_API_TOKEN`
+- `TEST_PYPI_API_TOKEN`
+
+Workflow usage:
+
+1. Manual publish to TestPyPI:
+   - Actions -> `Publish Python Package` -> `Run workflow` -> target `testpypi`
+2. Manual publish to PyPI:
+   - Actions -> `Publish Python Package` -> `Run workflow` -> target `pypi`
+3. Auto publish to PyPI on tag:
+   - Push tag `vX.Y.Z` matching `pyproject.toml` version
+
+```bash
+git tag v0.2.1
+git push origin v0.2.1
+```
+
+---
+
+## 📄 License
+
+This project is licensed under the **MIT License**. See the [LICENSE](LICENSE) file for details.
+
+## 🤝 Contributing
+
+Contributions, issues, and feature requests are welcome! Feel free to check the [issues page](https://github.com/SoyalIslam/disk-manager/issues).

diskman-0.2.1/pyproject.toml

@@ -0,0 +1,55 @@
+[build-system]
+requires = ["setuptools>=69", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "diskman"
+version = "0.2.1"
+description = "CLI + TUI disk manager with SMART, LUKS, and non-blocking automount"
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+authors = [
+  {name = "Gaffer"},
+]
+keywords = ["linux", "disk", "partition", "mount", "luks", "smart", "tui", "cli"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Environment :: Console",
+  "Intended Audience :: System Administrators",
+  "Operating System :: POSIX :: Linux",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Topic :: System :: Systems Administration",
+  "Topic :: Utilities",
+]
+dependencies = [
+  "rich>=13.7.0",
+]
+
+[project.scripts]
+diskman = "diskman.cli:main"
+
+[project.optional-dependencies]
+binary = [
+  "pyinstaller>=6.0",
+]
+release = [
+  "build>=1.2.0",
+  "twine>=5.0.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/gaffer/disk-manager"
+Repository = "https://github.com/gaffer/disk-manager"
+Issues = "https://github.com/gaffer/disk-manager/issues"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]

diskman-0.2.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

diskman-0.2.1/setup.py

@@ -0,0 +1,53 @@
+from setuptools import setup, find_packages
+from pathlib import Path
+
+# Extract version from src/diskman/__init__.py
+version = "0.2.1"
+init_file = Path(__file__).parent / "src" / "diskman" / "__init__.py"
+if init_file.exists():
+    for line in init_file.read_text(encoding="utf-8").splitlines():
+        if line.startswith("__version__"):
+            version = line.split("=")[1].strip().strip('"').strip("'")
+            break
+
+setup(
+    name="diskman",
+    version=version,
+    author="Gaffer",
+    description="CLI + TUI disk manager with SMART, LUKS, and non-blocking automount",
+    long_description=Path("README.md").read_text(encoding="utf-8"),
+    long_description_content_type="text/markdown",
+    url="https://github.com/gaffer/disk-manager",
+    project_urls={
+        "Homepage": "https://github.com/gaffer/disk-manager",
+        "Repository": "https://github.com/gaffer/disk-manager",
+        "Issues": "https://github.com/gaffer/disk-manager/issues",
+    },
+    package_dir={"": "src"},
+    packages=find_packages(where="src"),
+    python_requires=">=3.9",
+    install_requires=[
+        "rich>=13.7.0",
+    ],
+    entry_points={
+        "console_scripts": [
+            "diskman=diskman.cli:main",
+        ],
+    },
+    classifiers=[
+        "Development Status :: 4 - Beta",
+        "Environment :: Console",
+        "Intended Audience :: System Administrators",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: POSIX :: Linux",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3 :: Only",
+        "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
+        "Topic :: System :: Systems Administration",
+        "Topic :: Utilities",
+    ],
+    keywords="linux, disk, partition, mount, luks, smart, tui, cli",
+)

diskman-0.2.1/src/diskman/__init__.py

@@ -0,0 +1,2 @@
+__all__ = ["__version__"]
+__version__ = "0.2.1"