lazyvenv 0.1.0__tar.gz

lazyvenv-0.1.0/LICENSE

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

lazyvenv-0.1.0/PKG-INFO

@@ -0,0 +1,123 @@
+Metadata-Version: 2.4
+Name: lazyvenv
+Version: 0.1.0
+Summary: A TUI for managing Python virtual environments
+Keywords: virtualenv,tui
+Author: Abdulaziz-Hassan
+Author-email: Abdulaziz-Hassan <abdulazizhza@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Operating System :: POSIX
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Dist: rich>=15.0.0
+Requires-Dist: textual>=8.2.8
+Requires-Python: >=3.13
+Project-URL: Homepage, https://github.com/Abdulaziz-Hassan/lazyvenv
+Project-URL: Issues, https://github.com/Abdulaziz-Hassan/lazyvenv/issues
+Description-Content-Type: text/markdown
+
+# lazyvenv
+
+[![PyPI](https://img.shields.io/pypi/v/lazyvenv)](https://pypi.org/project/lazyvenv/)
+[![Python](https://img.shields.io/pypi/pyversions/lazyvenv)](https://pypi.org/project/lazyvenv/)
+[![CI](https://github.com/Abdulaziz-Hassan/lazyvenv/actions/workflows/ci.yml/badge.svg)](https://github.com/Abdulaziz-Hassan/lazyvenv/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+A TUI for managing Python virtual environments.
+
+![screenshot](https://raw.githubusercontent.com/Abdulaziz-Hassan/lazyvenv/main/docs/screenshot.png)
+
+lazyvenv shows the virtual environments in the current directory, lets you
+inspect their installed packages (including origin, size, and metadata), and
+create, delete, activate, and deactivate environments — all from one keyboard-
+driven interface.
+
+## Requirements
+
+- Python 3.13 or newer
+- [uv](https://docs.astral.sh/uv/) — used to list interpreters and create venvs
+- zsh, bash, or sh (for the activation shell hook)
+
+## Install
+
+```bash
+uv tool install lazyvenv
+```
+
+This installs the `lazyvenv` command globally, outside any project venv —
+which is required for activation to work reliably.
+
+## Shell integration (for activation)
+
+Pressing `a` inside the app marks a venv to be (de)activated, and the change
+is applied when you quit. For that to work, add the wrapper function to your
+shell config:
+
+```bash
+# ~/.zshrc or ~/.bashrc
+eval "$(lazyvenv init zsh)"   # or: lazyvenv init bash
+```
+
+Restart your shell (or `source` the file). Without this hook the app still
+works, but `a` will show a warning instead of activating.
+
+## Usage
+
+Run `lazyvenv` inside any directory containing virtual environments (it scans
+the directory itself and its immediate children for `pyvenv.cfg` files):
+
+```bash
+cd your-project
+lazyvenv
+```
+
+### Keys
+
+| Key | Action |
+|-----|--------|
+| `j` / `k` | Move the cursor up/down (arrow keys work too) |
+| `h` / `l` | Switch between the venv list and the packages table |
+| `a` | Toggle (de)activation of the highlighted venv (applied on quit) |
+| `c` | Create a new venv (pick any uv-managed interpreter) |
+| `d` | Delete the highlighted venv (with confirmation) |
+| `r` | Refresh the venv list |
+| `/` | Filter packages by name (`Esc` clears) |
+| `⏎` | Open the full details for the highlighted package |
+| `q` | Quit (or go back, inside a screen/dialog) |
+
+### CLI
+
+```
+lazyvenv               Launch the TUI
+lazyvenv init [shell]  Print the shell wrapper (zsh or bash)
+lazyvenv --version     Print the version
+lazyvenv --help        Show help
+```
+
+## Development
+
+```bash
+git clone https://github.com/Abdulaziz-Hassan/lazyvenv
+cd lazyvenv
+uv sync
+uv run pytest        # tests
+uv run ruff check    # lint
+uv run ruff format   # format
+uv run mypy          # types (strict)
+uv run lazyvenv      # run the app
+```
+
+For local development of the global command (e.g. to test the shell hook):
+
+```bash
+uv tool install --editable .
+```
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md).
+
+## License
+
+[MIT](LICENSE)

lazyvenv-0.1.0/README.md

@@ -0,0 +1,104 @@
+# lazyvenv
+
+[![PyPI](https://img.shields.io/pypi/v/lazyvenv)](https://pypi.org/project/lazyvenv/)
+[![Python](https://img.shields.io/pypi/pyversions/lazyvenv)](https://pypi.org/project/lazyvenv/)
+[![CI](https://github.com/Abdulaziz-Hassan/lazyvenv/actions/workflows/ci.yml/badge.svg)](https://github.com/Abdulaziz-Hassan/lazyvenv/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+A TUI for managing Python virtual environments.
+
+![screenshot](https://raw.githubusercontent.com/Abdulaziz-Hassan/lazyvenv/main/docs/screenshot.png)
+
+lazyvenv shows the virtual environments in the current directory, lets you
+inspect their installed packages (including origin, size, and metadata), and
+create, delete, activate, and deactivate environments — all from one keyboard-
+driven interface.
+
+## Requirements
+
+- Python 3.13 or newer
+- [uv](https://docs.astral.sh/uv/) — used to list interpreters and create venvs
+- zsh, bash, or sh (for the activation shell hook)
+
+## Install
+
+```bash
+uv tool install lazyvenv
+```
+
+This installs the `lazyvenv` command globally, outside any project venv —
+which is required for activation to work reliably.
+
+## Shell integration (for activation)
+
+Pressing `a` inside the app marks a venv to be (de)activated, and the change
+is applied when you quit. For that to work, add the wrapper function to your
+shell config:
+
+```bash
+# ~/.zshrc or ~/.bashrc
+eval "$(lazyvenv init zsh)"   # or: lazyvenv init bash
+```
+
+Restart your shell (or `source` the file). Without this hook the app still
+works, but `a` will show a warning instead of activating.
+
+## Usage
+
+Run `lazyvenv` inside any directory containing virtual environments (it scans
+the directory itself and its immediate children for `pyvenv.cfg` files):
+
+```bash
+cd your-project
+lazyvenv
+```
+
+### Keys
+
+| Key | Action |
+|-----|--------|
+| `j` / `k` | Move the cursor up/down (arrow keys work too) |
+| `h` / `l` | Switch between the venv list and the packages table |
+| `a` | Toggle (de)activation of the highlighted venv (applied on quit) |
+| `c` | Create a new venv (pick any uv-managed interpreter) |
+| `d` | Delete the highlighted venv (with confirmation) |
+| `r` | Refresh the venv list |
+| `/` | Filter packages by name (`Esc` clears) |
+| `⏎` | Open the full details for the highlighted package |
+| `q` | Quit (or go back, inside a screen/dialog) |
+
+### CLI
+
+```
+lazyvenv               Launch the TUI
+lazyvenv init [shell]  Print the shell wrapper (zsh or bash)
+lazyvenv --version     Print the version
+lazyvenv --help        Show help
+```
+
+## Development
+
+```bash
+git clone https://github.com/Abdulaziz-Hassan/lazyvenv
+cd lazyvenv
+uv sync
+uv run pytest        # tests
+uv run ruff check    # lint
+uv run ruff format   # format
+uv run mypy          # types (strict)
+uv run lazyvenv      # run the app
+```
+
+For local development of the global command (e.g. to test the shell hook):
+
+```bash
+uv tool install --editable .
+```
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md).
+
+## License
+
+[MIT](LICENSE)

lazyvenv-0.1.0/pyproject.toml

@@ -0,0 +1,79 @@
+[project]
+name = "lazyvenv"
+version = "0.1.0"
+description = "A TUI for managing Python virtual environments"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.13"
+keywords = [
+    "virtualenv",
+    "tui",
+]
+classifiers = [
+    "Operating System :: POSIX",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+]
+dependencies = [
+    "rich>=15.0.0",
+    "textual>=8.2.8",
+]
+
+[[project.authors]]
+name = "Abdulaziz-Hassan"
+email = "abdulazizhza@gmail.com"
+
+[project.urls]
+Homepage = "https://github.com/Abdulaziz-Hassan/lazyvenv"
+Issues = "https://github.com/Abdulaziz-Hassan/lazyvenv/issues"
+
+[project.scripts]
+lazyvenv = "lazyvenv:main"
+
+[build-system]
+requires = ["uv_build>=0.12.1,<0.13.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "mypy>=2.3.1",
+    "pytest>=9.1.1",
+    "pytest-asyncio>=1.4.0",
+    "ruff>=0.16.3",
+]
+
+[tool.ruff]
+target-version = "py313"
+
+[tool.ruff.lint]
+select = [
+    "E",
+    "F",
+    "I",
+    "UP",
+    "B",
+    "SIM",
+    "RUF",
+]
+
+[tool.ruff.lint.per-file-ignores]
+"src/lazyvenv/packages.py" = ["E501"]
+"tests/test_create.py" = ["E501"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+
+[tool.mypy]
+strict = true
+files = [
+    "src",
+    "tests",
+]
+mypy_path = "src"
+
+[[tool.mypy.overrides]]
+module = "tests.*"
+disallow_untyped_defs = false
+disallow_untyped_calls = false

lazyvenv-0.1.0/pyproject.toml.orig

@@ -0,0 +1,64 @@
+[project]
+name = "lazyvenv"
+version = "0.1.0"
+description = "A TUI for managing Python virtual environments"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+    { name = "Abdulaziz-Hassan", email = "abdulazizhza@gmail.com" }
+]
+requires-python = ">=3.13"
+keywords = ["virtualenv", "tui"]
+classifiers = [
+    "Operating System :: POSIX",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+]
+dependencies = [
+    "rich>=15.0.0",
+    "textual>=8.2.8",
+]
+
+[project.urls]
+Homepage = "https://github.com/Abdulaziz-Hassan/lazyvenv"
+Issues = "https://github.com/Abdulaziz-Hassan/lazyvenv/issues"
+
+[project.scripts]
+lazyvenv = "lazyvenv:main"
+
+[build-system]
+requires = ["uv_build>=0.12.1,<0.13.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "mypy>=2.3.1",
+    "pytest>=9.1.1",
+    "pytest-asyncio>=1.4.0",
+    "ruff>=0.16.3",
+]
+
+[tool.ruff]
+target-version = "py313"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B", "SIM", "RUF"]
+
+[tool.ruff.lint.per-file-ignores]
+"src/lazyvenv/packages.py" = ["E501"]  # embedded inspector script
+"tests/test_create.py" = ["E501"]  # verbatim `uv python list` fixture output
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+
+[tool.mypy]
+strict = true
+files = ["src", "tests"]
+mypy_path = "src"
+
+[[tool.mypy.overrides]]
+module = "tests.*"
+disallow_untyped_defs = false
+disallow_untyped_calls = false

lazyvenv-0.1.0/src/lazyvenv/__init__.py

@@ -0,0 +1,47 @@
+"""lazyvenv - a TUI for managing Python virtual environments."""
+
+import argparse
+import os
+from importlib.metadata import version
+from pathlib import Path
+
+from lazyvenv.activation import init_script
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(
+        prog="lazyvenv",
+        description="A TUI for managing Python virtual environments.",
+    )
+    parser.add_argument(
+        "--version",
+        "-V",
+        action="version",
+        version=f"%(prog)s {version('lazyvenv')}",
+    )
+    subparsers = parser.add_subparsers(dest="command")
+
+    init = subparsers.add_parser("init", help="print the shell wrapper function")
+    init.add_argument("shell", nargs="?", default="zsh", choices=["zsh", "bash", "sh"])
+
+    args = parser.parse_args()
+    if args.command == "init":
+        _print_init(args.shell)
+    else:
+        _run_tui()
+
+
+def _print_init(shell: str) -> None:
+    """Print the shell wrapper function (zsh/bash)."""
+    print(init_script(shell))
+
+
+def _run_tui() -> None:
+    """Launch the TUI, then apply any pending (de)activation."""
+    from lazyvenv.app import LazyVenvApp  # deferred: importing textual is slow
+
+    app = LazyVenvApp()
+    app.run()
+    cmd_file = os.environ.get("LAZYVENV_SHELL_CMD_FILE")
+    if cmd_file and app.pending_command:
+        Path(cmd_file).write_text(app.pending_command + "\n")

lazyvenv-0.1.0/src/lazyvenv/activation.py

@@ -0,0 +1,28 @@
+from lazyvenv.venvs import Venv
+
+DEACTIVATE_COMMAND = "deactivate"
+
+
+def activation_command(venv: Venv) -> str:
+    """The shell command that activates *venv* in the current shell."""
+    return f"source '{venv.path}/bin/activate'"
+
+
+_INIT_SCRIPT = """\
+lazyvenv() {
+    local tmpfile
+    tmpfile="$(mktemp "${TMPDIR:-/tmp}/lazyvenv.XXXXXX")"
+    LAZYVENV_SHELL_CMD_FILE="$tmpfile" command lazyvenv "$@"
+    if [ -s "$tmpfile" ]; then
+        eval "$(cat "$tmpfile")"
+    fi
+    rm -f "$tmpfile"
+}
+"""
+
+
+def init_script(shell: str) -> str:
+    """The wrapper function for *shell* for ``eval "$(lazyvenv init zsh)"``."""
+    if shell not in {"zsh", "bash", "sh"}:
+        raise ValueError(f"unsupported shell: {shell!r} (supported: zsh, bash, sh)")
+    return _INIT_SCRIPT