visync 0.1.0__py3-none-any.whl

visync-0.1.0.dist-info/METADATA

@@ -0,0 +1,204 @@
+Metadata-Version: 2.5
+Name: visync
+Version: 0.1.0
+Summary: Ventoy ISO Synchronization Tool
+Project-URL: Homepage, https://github.com/hxmbl/visync
+Project-URL: Repository, https://github.com/hxmbl/visync
+Project-URL: Issues, https://github.com/hxmbl/visync/issues
+Author: hxmbl
+License: MIT
+License-File: LICENSE
+Keywords: checksum,iso,linux,package-manager,usb,ventoy
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Classifier: Topic :: System :: Archiving :: Backup
+Classifier: Topic :: System :: Filesystems
+Classifier: Topic :: Utilities
+Requires-Python: <3.16,>=3.12
+Requires-Dist: rich>=13.0
+Requires-Dist: typer>=0.12
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == 'dev'
+Requires-Dist: pyright>=1.1.380; extra == 'dev'
+Requires-Dist: pytest-cov>=5; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: ruff>=0.16; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Visync
+
+Ventoy Package Manager. Install, update, and manage Linux distros on your Ventoy drive.
+
+## Install
+
+Requires Python 3.12+ and a mounted Ventoy drive.
+
+```bash
+pip install visync
+```
+
+For a development checkout:
+
+```bash
+pip install -e ".[dev]"
+```
+
+Both layouts work out of the box: `config.toml` ships inside the installed package, so `visync search` finds the distro list from any directory.
+
+## Quick Start
+
+```bash
+# See what's available
+visync search
+
+# Auto-detect distros already on the drive
+visync autodetect
+
+# Install a distro
+visync install archlinux
+visync install nixos-graphical
+
+# Batch install from file
+visync install -i packages.txt
+
+# Update all installed distros
+visync update
+
+# Update a specific distro
+visync update tails
+
+# Check for old versions (dry-run)
+visync sync
+
+# Remove old versions
+visync sync --clean
+
+# Remove a distro
+visync remove tails
+
+# Show distro details
+visync info archlinux
+
+# Verify checksums
+visync verify
+```
+
+## Commands
+
+| Command | Description |
+|---|---|
+| `visync search [query]` | List available distros (filter by query) |
+| `visync install <name>` | Download and register a distro |
+| `visync install -i <file>` | Batch install from file (one name per line) |
+| `visync remove <name>` | Delete from drive and unregister |
+| `visync update [name]` [--no-staging] | Update installed distros (all if no name given) |
+| `visync sync` [--no-staging] | Sync installed distros to latest |
+| `visync sync --all` [--no-staging] | Sync all configured distros |
+| `visync sync --clean` [--no-staging] | Remove old versions of same distro |
+| `visync sync --reset-visync` | Allow the watchdog to wipe an over-budget `.visync/` |
+| `visync list` | List ISOs on the drive |
+| `visync autodetect` | Register existing ISOs as installed |
+| `visync verify` | Verify checksums against upstream |
+| `visync info <name>` | Show distro details |
+
+## Batch Install File
+
+Create a text file with one distro name per line:
+
+```
+# My Ventoy setup
+archlinux
+nixos-minimal
+tails
+ubuntu-desktop
+ubuntu-server
+```
+
+Then run:
+
+```bash
+visync install -i packages.txt
+```
+
+Blank lines and lines starting with `#` are ignored.
+
+## Configuration
+
+Edit `config.toml` to add or remove distros. Each distro entry defines a scraping strategy, mirror URL, and checksum verification method.
+
+Config resolution order: explicit `--config` path, then `$VISYNC_CONFIG`, then `~/.config/visync/config.toml`, then the `config.toml` shipped inside the installed package. A `config.toml` in the current directory is only used as a last resort, so planted configs cannot hijack identification.
+
+**Release selection:** `version_filter` restricts a scraper to one release family before the newest match is chosen. Ubuntu entries use `\d*[02468]\.04(\.\d+)*` so they track the current LTS (26.04.1) and ignore interim releases (25.10, 26.10). NixOS resolves the newest stable `YY.MM` channel from the release bucket at scrape time, so it advances to the next stable without a config edit; set `channel = "26.05"` to pin deliberately while that channel is current.
+
+**Built-in strategies:**
+
+| Strategy | Description | Example |
+|---|---|---|
+| `direct_match` | Flat index page | Arch Linux |
+| `fedora_nested` | Version dirs + variant subdirs | Fedora, Fedora KDE |
+| `ubuntu_nested` | Version dirs | Ubuntu, Parrot Security |
+| `nixos_channel` | Stable-channel lookup + channel page parse | NixOS Minimal, NixOS Graphical |
+| `popos_api` | JSON API | Pop!_OS |
+| `tails_api` | JSON API | Tails |
+
+**Checksum formats:** `gpg_checksum` (Fedora — inline `SHA256 (file) = hash`), `sha256sums` (Ubuntu, Arch, Parrot, NixOS, Tails), `json` (Tails)
+
+Signature checking is configured separately via `signing_key_url` + `signing_key_fingerprint` and works with any signed layout, so Parrot's sectioned hash list gets both a signature check and a digest check.
+
+## How it works
+
+1. **Detect** — finds mounted Ventoy drives on Windows, macOS, or Linux (with udisksctl automount)
+2. **Scrape** — concurrent mirror scraping with TCP pre-flight checks and watchdog timeouts. A distro whose mirror can't be read is reported with the reason and makes the command exit non-zero; it is never silently counted as up to date
+3. **Select** — release-family filters keep scrapers on the intended series: Ubuntu tracks the current **LTS** (even-year `.04`, skipping interim releases and beta-only directories), and NixOS resolves the current **stable** channel from the release bucket instead of pinning a version string
+4. **Compare** — version-aware comparison (semantic or date-based) against local ISOs
+5. **Download** — streaming downloads with staging buffer (less drive wear), falls back to direct if staging full. Use `--no-staging` / `--no-buffer` to skip the staging buffer and download directly to the Ventoy drive.
+6. **Verify** — optional checksum verification against published hashes
+7. **Clean** — `--clean` removes deprecated ISOs of the same distro variant (dry-run by default)
+8. **State** — tracks installed distros in `.visync/installed.json`
+
+## Safety
+
+- `--clean` is dry-run by default, and `--dry-run` never modifies the drive — `sync --clean --dry-run` deletes nothing and does not touch `.visync/`
+- `remove` and `nuke-metadata` show exactly what will be deleted and ask for confirmation (`--yes` skips)
+- Ambiguous distro queries are refused with candidate lists instead of acting on an arbitrary match
+- Distro matching uses whole-token keywords (`pop` does not match `popcorn.iso`)
+- `.visync/` watchdog enforces a 1 GiB ceiling by deep-cleaning orphaned metadata. Wiping `.visync/` entirely is **opt-in** via `sync --reset-visync`, because it destroys `installed.json` and every registration
+- The watchdog never runs on `--dry-run`
+- Guardrails prevent deletion of `.iso` or `.img` files under any circumstance — including inside `.visync/metadata`
+- Downloads use parallel range requests with per-chunk HTTP 206 and byte-count validation; truncated or range-ignoring servers fail loudly instead of producing silent corruption
+- Checksum mismatch deletes the download; an *unreachable* checksum source keeps the file and warns (`UNVERIFIED`)
+- HTTPS is enforced for all mirrors and checksum sources (loopback exempt); https→http redirects are blocked
+- GPG signature verification supports fingerprint pinning via `signing_key_fingerprint`, and applies to any signed checksum file regardless of its digest layout (Fedora's inline `SHA256 (file) = hash`, Parrot's sectioned md5/sha256/sha512 list)
+- When multiple digests for the same file appear in one signed list, the configured `checksum_algo` selects the section — a first-match parser would compare an MD5 against a SHA-256 and delete a good download as corrupt
+- Failed downloads clean up `.part` files automatically
+- Install verifies file exists on drive before marking as installed
+- State and metadata writes are atomic (tmp file + rename)
+
+## Tests
+
+```bash
+python3 -m pytest test/ -v
+```
+
+CI installs from the committed `uv.lock` so a dependency release cannot break the build without a diff. `uv` is used for reproducible CI and builds only — installing visync itself with `pip` is fully supported.
+
+## Debug
+
+```bash
+VISYNC_DEBUG=1 visync sync
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE).

visync-0.1.0.dist-info/RECORD

@@ -0,0 +1,14 @@
+visync/__init__.py,sha256=uJ4l7PZ1BWLT1VDZdC1rdIBcr5fqGL1i6r1cegBIg30,71
+visync/download.py,sha256=oAymqtmzrISEU0q9dRbudSin7Yl03IzGac9KZq_ucpY,60543
+visync/finder.py,sha256=h2Kv8Mfcm0FDV7uk6XlbhR9MqsK90mtqWETD98wxPl0,26283
+visync/main.py,sha256=GMmsfS1yqPAnTVThyPCgKNqg150NZNAgKduAFh7937E,41204
+visync/net.py,sha256=bIA6yYxRKJ2EU3Bs1B-3fiZZc-HWvTFCFly97_TS2f0,3362
+visync/output.py,sha256=hlDIKFo8Ce8P616-kmeCj1ND74nlQ_SV0R4gPDGkqNA,3428
+visync/pm.py,sha256=vZEXcYUgc2WHEH4T_Jla74f5KL6-sP6YQ6IxmTE0yjo,4301
+visync/verify.py,sha256=AToIkllaeRW1u4KjKgFvUl5ekZnWdPxDCxU7f8PdqvU,25116
+visync/config.toml,sha256=Q2KfFSppFvB6jzMRHKIk-Msa1WWchaOga7aiZWRbueY,9896
+visync-0.1.0.dist-info/METADATA,sha256=XvE3zgVnG_L9R2y0tLFmoqNq2OkUA6IyEKxxIMtkLCI,8792
+visync-0.1.0.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
+visync-0.1.0.dist-info/entry_points.txt,sha256=Yx-VxnL1d-xrPJOyK3h1qQMSFRB9S5VYgV6NhbfzLfM,43
+visync-0.1.0.dist-info/licenses/LICENSE,sha256=8lV2pYYtelPscUmZMKok8VeKJJz4VxHxsIESnspxywk,1062
+visync-0.1.0.dist-info/RECORD,,

visync-0.1.0.dist-info/WHEEL

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

visync-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+visync = visync.main:app

visync-0.1.0.dist-info/licenses/LICENSE

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