rookery 0.7.0__tar.gz

rookery-0.7.0/LICENSE

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

rookery-0.7.0/PKG-INFO

@@ -0,0 +1,134 @@
+Metadata-Version: 2.4
+Name: rookery
+Version: 0.7.0
+Summary: Rookery - package manager for third-party development tools
+Keywords: package-manager,cli,developer-tools,installer,linux
+Author: belfner
+Author-email: belfner <belfner@belfner.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: System :: Installation/Setup
+Classifier: Topic :: System :: Software Distribution
+Classifier: Topic :: Utilities
+Requires-Dist: typer>=0.20.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: niquests>=3.18.4
+Requires-Python: >=3.12
+Project-URL: Homepage, https://github.com/belfner/rookery
+Project-URL: Issues, https://github.com/belfner/rookery/issues
+Project-URL: Repository, https://github.com/belfner/rookery
+Description-Content-Type: text/markdown
+
+# Rookery
+
+Package manager for third-party dev tools on Linux. Installs, updates, and wires up symlinks, man pages, and desktop entries so you don't have to.
+
+## Features
+
+- Async downloads with Rich progress bars
+- Parallel batch installs
+- Symlinks, man pages, and desktop entries set up automatically
+- Only asks for sudo when the install paths actually need it
+- GitHub API token support to avoid rate limits
+- Version tracking with update and downgrade support
+- List and install specific versions (`rookery install nvim@0.10.4`)
+- Pin a version to hold it across updates (`rookery pin`)
+
+## Supported Programs
+
+| Program | Type | Description |
+|---------|------|-------------|
+| bat | GitHub binary | `cat` clone with syntax highlighting |
+| blender | Standalone | 3D creation suite |
+| cuda-run | Shell script | Run a command in a throwaway uv environment with a PyPI CUDA toolkit |
+| drawio | GitHub AppImage | Diagram editor |
+| dust | GitHub binary | Intuitive `du` alternative |
+| dysk | GitHub binary | Filesystem information tool |
+| eza | GitHub binary | Modern `ls` replacement |
+| fasttarutils | Python script | Multi-format tar compression/extraction (ftar/funtar) with parallel backends |
+| fastziputils | Shell script | Zip compression/extraction with pv progress bars |
+| gdu | GitHub binary | Disk usage analyzer |
+| gping | GitHub binary | Ping with a graph |
+| hyperfine | GitHub binary | Command-line benchmarking tool |
+| imcat | GitHub source | 24-bit terminal image viewer, compiled from source |
+| just | GitHub binary | Command runner |
+| kpod | Shell script | `kubectl` wrappers that resolve a pod by name prefix |
+| mc | GitHub binary | MinIO Client for S3-compatible object storage |
+| netron | GitHub .deb | Neural network model viewer |
+| nvim | GitHub binary | Hyperextensible Vim-based editor |
+| storageexplorer | GitHub binary | Azure Storage Explorer |
+| tarssh | Shell script | Stream a directory/file over SSH via tar pipe |
+| yazi | GitHub binary | Terminal file manager |
+
+## Installation
+
+Requires Python 3.12+ and [uv](https://docs.astral.sh/uv/).
+
+```bash
+uv tool install rookery
+```
+
+To install the development version from source:
+
+```bash
+uv tool install git+https://github.com/belfner/rookery.git
+```
+
+## Usage
+
+```bash
+rookery install nvim          # Install the latest version
+rookery install nvim@0.10.4   # Install a specific version
+rookery install --all         # Install all programs
+rookery update                # Update all installed programs
+rookery update nvim --force   # Force reinstall
+rookery list                  # List installed programs (with pin status)
+rookery uninstall nvim        # Uninstall a program
+rookery link --all            # Create system links
+rookery unlink --all          # Remove system links
+rookery info                  # Show configuration and stats
+```
+
+### Versions and pinning
+
+```bash
+rookery versions nvim              # List available versions (--all, --include-prerelease, --json)
+rookery install nvim@0.10.4 --pin  # Install a specific version and pin it
+rookery pin nvim                   # Pin the currently installed version
+rookery pin nvim 0.10.4 --install  # Install a version, then pin it
+rookery unpin nvim                 # Remove the pin
+rookery pins                       # List pinned programs (--json)
+```
+
+A pin holds a program at its pinned version: `rookery update` skips pinned programs and reports
+them. Use `rookery unpin`, or `rookery install <prog>@<version> --pin`, to move a pinned program.
+`rookery versions` and `rookery install <prog>@<version>` work for GitHub-release programs; programs
+with a single bundled version (shell scripts) and a few composite sources install the latest only.
+
+### Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `ROOKERY_INSTALL_DIR` | Installation directory (default: `/opt/rookery-programs`) |
+| `ROOKERY_BIN_DIR` | Binary symlink directory |
+| `ROOKERY_DESKTOP_DIR` | Desktop entry directory |
+| `ROOKERY_MAN_DIR` | Man page directory |
+| `ROOKERY_TEMP_DIR` | Download staging directory (default: `/tmp/rookery`) |
+| `ROOKERY_MAX_PARALLEL` | Concurrency limit for batch installs and updates (default: 10) |
+| `GITHUB_TOKEN` / `GH_TOKEN` | GitHub API token for higher rate limits |
+
+## Adding a Program
+
+Create a `Program` subclass in `src/rookery/programs/`. Programs are discovered automatically at runtime. See `agent_docs/new_program.md` for the template and conventions.
+
+## License
+
+[MIT](https://github.com/belfner/rookery/blob/master/LICENSE)

rookery-0.7.0/README.md

@@ -0,0 +1,105 @@
+# Rookery
+
+Package manager for third-party dev tools on Linux. Installs, updates, and wires up symlinks, man pages, and desktop entries so you don't have to.
+
+## Features
+
+- Async downloads with Rich progress bars
+- Parallel batch installs
+- Symlinks, man pages, and desktop entries set up automatically
+- Only asks for sudo when the install paths actually need it
+- GitHub API token support to avoid rate limits
+- Version tracking with update and downgrade support
+- List and install specific versions (`rookery install nvim@0.10.4`)
+- Pin a version to hold it across updates (`rookery pin`)
+
+## Supported Programs
+
+| Program | Type | Description |
+|---------|------|-------------|
+| bat | GitHub binary | `cat` clone with syntax highlighting |
+| blender | Standalone | 3D creation suite |
+| cuda-run | Shell script | Run a command in a throwaway uv environment with a PyPI CUDA toolkit |
+| drawio | GitHub AppImage | Diagram editor |
+| dust | GitHub binary | Intuitive `du` alternative |
+| dysk | GitHub binary | Filesystem information tool |
+| eza | GitHub binary | Modern `ls` replacement |
+| fasttarutils | Python script | Multi-format tar compression/extraction (ftar/funtar) with parallel backends |
+| fastziputils | Shell script | Zip compression/extraction with pv progress bars |
+| gdu | GitHub binary | Disk usage analyzer |
+| gping | GitHub binary | Ping with a graph |
+| hyperfine | GitHub binary | Command-line benchmarking tool |
+| imcat | GitHub source | 24-bit terminal image viewer, compiled from source |
+| just | GitHub binary | Command runner |
+| kpod | Shell script | `kubectl` wrappers that resolve a pod by name prefix |
+| mc | GitHub binary | MinIO Client for S3-compatible object storage |
+| netron | GitHub .deb | Neural network model viewer |
+| nvim | GitHub binary | Hyperextensible Vim-based editor |
+| storageexplorer | GitHub binary | Azure Storage Explorer |
+| tarssh | Shell script | Stream a directory/file over SSH via tar pipe |
+| yazi | GitHub binary | Terminal file manager |
+
+## Installation
+
+Requires Python 3.12+ and [uv](https://docs.astral.sh/uv/).
+
+```bash
+uv tool install rookery
+```
+
+To install the development version from source:
+
+```bash
+uv tool install git+https://github.com/belfner/rookery.git
+```
+
+## Usage
+
+```bash
+rookery install nvim          # Install the latest version
+rookery install nvim@0.10.4   # Install a specific version
+rookery install --all         # Install all programs
+rookery update                # Update all installed programs
+rookery update nvim --force   # Force reinstall
+rookery list                  # List installed programs (with pin status)
+rookery uninstall nvim        # Uninstall a program
+rookery link --all            # Create system links
+rookery unlink --all          # Remove system links
+rookery info                  # Show configuration and stats
+```
+
+### Versions and pinning
+
+```bash
+rookery versions nvim              # List available versions (--all, --include-prerelease, --json)
+rookery install nvim@0.10.4 --pin  # Install a specific version and pin it
+rookery pin nvim                   # Pin the currently installed version
+rookery pin nvim 0.10.4 --install  # Install a version, then pin it
+rookery unpin nvim                 # Remove the pin
+rookery pins                       # List pinned programs (--json)
+```
+
+A pin holds a program at its pinned version: `rookery update` skips pinned programs and reports
+them. Use `rookery unpin`, or `rookery install <prog>@<version> --pin`, to move a pinned program.
+`rookery versions` and `rookery install <prog>@<version>` work for GitHub-release programs; programs
+with a single bundled version (shell scripts) and a few composite sources install the latest only.
+
+### Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `ROOKERY_INSTALL_DIR` | Installation directory (default: `/opt/rookery-programs`) |
+| `ROOKERY_BIN_DIR` | Binary symlink directory |
+| `ROOKERY_DESKTOP_DIR` | Desktop entry directory |
+| `ROOKERY_MAN_DIR` | Man page directory |
+| `ROOKERY_TEMP_DIR` | Download staging directory (default: `/tmp/rookery`) |
+| `ROOKERY_MAX_PARALLEL` | Concurrency limit for batch installs and updates (default: 10) |
+| `GITHUB_TOKEN` / `GH_TOKEN` | GitHub API token for higher rate limits |
+
+## Adding a Program
+
+Create a `Program` subclass in `src/rookery/programs/`. Programs are discovered automatically at runtime. See `agent_docs/new_program.md` for the template and conventions.
+
+## License
+
+[MIT](https://github.com/belfner/rookery/blob/master/LICENSE)

rookery-0.7.0/pyproject.toml

@@ -0,0 +1,108 @@
+[project]
+name = "rookery"
+version = "0.7.0"
+description = "Rookery - package manager for third-party development tools"
+readme = "README.md"
+authors = [
+    { name = "belfner", email = "belfner@belfner.com" }
+]
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.12"
+keywords = [
+    "package-manager",
+    "cli",
+    "developer-tools",
+    "installer",
+    "linux",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Intended Audience :: System Administrators",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: System :: Installation/Setup",
+    "Topic :: System :: Software Distribution",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "typer>=0.20.0",
+    "rich>=13.0.0",
+    "niquests>=3.18.4",
+]
+
+[project.urls]
+Homepage = "https://github.com/belfner/rookery"
+Repository = "https://github.com/belfner/rookery"
+Issues = "https://github.com/belfner/rookery/issues"
+
+[dependency-groups]
+dev = [
+    "mypy>=1.18.2",
+    "pre-commit>=4.3.0",
+    "pytest>=9.1.1",
+    "pytest-asyncio>=1.4.0",
+    "ruff>=0.14.3",
+    "ty>=0.0.1a25",
+]
+
+[project.scripts]
+rookery = "rookery.__main__:app"
+
+[build-system]
+requires = ["uv_build>=0.9.4,<0.10.0"]
+build-backend = "uv_build"
+
+[tool.ruff]
+line-length = 120
+target-version = "py312"
+exclude = [
+    ".git",
+    ".mypy_cache",
+    ".pytest_cache",
+    ".ruff_cache",
+    ".venv",
+]
+
+[tool.ruff.lint]
+select = [
+    "E",      # pycodestyle errors
+    "W",      # pycodestyle warnings
+    "F",      # pyflakes
+    "N",      # pep8-naming
+    "UP",     # pyupgrade
+    "B",      # flake8-bugbear
+    "C4",     # flake8-comprehensions
+    "PTH",    # flake8-use-pathlib
+    "SIM",    # flake8-simplify
+    "RET",    # flake8-return
+]
+ignore = [
+    "E501",   # Line too long (handled by formatter)
+    "SIM118", # Use `key in dict` instead of `key in dict.keys()`
+    "RET505", # Superfluous else after return
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**/*.py" = [
+    "S101",   # Allow assert in tests
+]
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+docstring-code-format = true
+
+[tool.mypy]
+python_version = "3.12"
+strict = true
+disallow_untyped_decorators = false
+files = ["src"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]

rookery-0.7.0/src/rookery/__init__.py

@@ -0,0 +1,12 @@
+"""Rookery - package manager for third-party development tools."""
+
+from importlib.metadata import (
+    PackageNotFoundError,
+    version,
+)
+
+
+try:
+    __version__ = version("rookery")
+except PackageNotFoundError:
+    __version__ = "0.0.0.dev"