venv-cmds 2026.9.26.1__tar.gz

venv_cmds-2026.9.26.1/LICENSE

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

venv_cmds-2026.9.26.1/PKG-INFO

@@ -0,0 +1,91 @@
+Metadata-Version: 2.4
+Name: venv-cmds
+Version: 2026.9.26.1
+Summary: List available console commands in the active Python environment, check for package updates
+Author-email: Paul McGowan <paul.mcgowan@ophix.io>
+License-Expression: MIT
+Project-URL: Homepage, https://ophix.io
+Project-URL: Documentation, https://github.com/ophixproject/venv-cmds#readme
+Project-URL: Source, https://github.com/ophixproject/venv-cmds
+Keywords: venv,python,cli,console scripts
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+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: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Utilities
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: importlib_metadata>=3.6; python_version < "3.8"
+Requires-Dist: argcomplete>=3.0
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Dynamic: license-file
+
+# venv-cmds
+
+Small discovery and maintenance utilities for Python virtual environments.
+
+## Why this exists
+
+When you activate a virtual environment it is not always obvious which
+command-line tools are available or whether they are up to date.
+`venv-cmds` provides two commands: `list` to discover what is installed,
+and `check_updates` to check for newer versions on the configured pip index.
+
+## Commands
+
+Running `venv-cmds` with no subcommand is equivalent to `venv-cmds list`.
+
+### `list`
+
+Show all `console_scripts` entry points in the active environment.
+
+```bash
+venv-cmds list
+venv-cmds list --details    # include package name alongside each command
+```
+
+### `check_updates`
+
+Check all installed packages against the configured pip index and report
+which have updates available. Respects all pip index sources configured for
+the environment — public PyPI, private indexes, and local mirrors all work
+without any extra configuration.
+
+If `pip` isn't importable in the current venv (e.g. one created with
+`uv venv` without `--seed`), falls back automatically to `uv pip list`
+targeting this same interpreter, provided `uv` is installed on `PATH`.
+
+```bash
+venv-cmds check_updates
+venv-cmds check_updates --updates-only            # only show packages with updates
+venv-cmds check_updates --no-progress             # suppress status message on stderr (cron-safe)
+venv-cmds check_updates --include-install-date    # add an 'Installed on' column
+venv-cmds check_updates --timeout 60              # per-package query timeout in seconds (default: 30)
+venv-cmds check_updates --output-file updates.txt # write pinned requirements file for updates
+venv-cmds check_updates --output-file -           # write pinned requirements to stdout
+```
+
+When `--output-file` is used the output file contains `package==version` lines
+for every package with an available update. Passing this file to
+`pip install -r updates.txt` will upgrade exactly the packages that were
+flagged, with no other changes.
+
+## Installation
+
+```bash
+pip install venv-cmds
+```
+
+Requires Python 3.7 or later. Works with both `venv` and `virtualenv`.

venv_cmds-2026.9.26.1/README.md

@@ -0,0 +1,57 @@
+# venv-cmds
+
+Small discovery and maintenance utilities for Python virtual environments.
+
+## Why this exists
+
+When you activate a virtual environment it is not always obvious which
+command-line tools are available or whether they are up to date.
+`venv-cmds` provides two commands: `list` to discover what is installed,
+and `check_updates` to check for newer versions on the configured pip index.
+
+## Commands
+
+Running `venv-cmds` with no subcommand is equivalent to `venv-cmds list`.
+
+### `list`
+
+Show all `console_scripts` entry points in the active environment.
+
+```bash
+venv-cmds list
+venv-cmds list --details    # include package name alongside each command
+```
+
+### `check_updates`
+
+Check all installed packages against the configured pip index and report
+which have updates available. Respects all pip index sources configured for
+the environment — public PyPI, private indexes, and local mirrors all work
+without any extra configuration.
+
+If `pip` isn't importable in the current venv (e.g. one created with
+`uv venv` without `--seed`), falls back automatically to `uv pip list`
+targeting this same interpreter, provided `uv` is installed on `PATH`.
+
+```bash
+venv-cmds check_updates
+venv-cmds check_updates --updates-only            # only show packages with updates
+venv-cmds check_updates --no-progress             # suppress status message on stderr (cron-safe)
+venv-cmds check_updates --include-install-date    # add an 'Installed on' column
+venv-cmds check_updates --timeout 60              # per-package query timeout in seconds (default: 30)
+venv-cmds check_updates --output-file updates.txt # write pinned requirements file for updates
+venv-cmds check_updates --output-file -           # write pinned requirements to stdout
+```
+
+When `--output-file` is used the output file contains `package==version` lines
+for every package with an available update. Passing this file to
+`pip install -r updates.txt` will upgrade exactly the packages that were
+flagged, with no other changes.
+
+## Installation
+
+```bash
+pip install venv-cmds
+```
+
+Requires Python 3.7 or later. Works with both `venv` and `virtualenv`.

venv_cmds-2026.9.26.1/pyproject.toml

@@ -0,0 +1,53 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "venv-cmds"
+version = "2026.09.26.01"
+description = "List available console commands in the active Python environment, check for package updates"
+readme = "README.md"
+requires-python = ">=3.7"
+license = "MIT"
+keywords = ["venv", "python", "cli", "console scripts"]
+
+authors = [
+    {name = "Paul McGowan", email = "paul.mcgowan@ophix.io"}
+]
+
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Intended Audience :: System Administrators",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.7",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Utilities",
+]
+
+dependencies = [
+    "importlib_metadata>=3.6; python_version < '3.8'",
+    "argcomplete>=3.0",
+]
+
+[project.optional-dependencies]
+test = ["pytest"]
+
+[project.urls]
+Homepage = "https://ophix.io"
+Documentation = "https://github.com/ophixproject/venv-cmds#readme"
+Source = "https://github.com/ophixproject/venv-cmds"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[project.scripts]
+venv-cmds = "venv_cmds.cli:main"

venv_cmds-2026.9.26.1/setup.cfg

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

venv_cmds-2026.9.26.1/src/venv_cmds/_version.py

@@ -0,0 +1,2 @@
+__version__ = "2026.09.26.01"
+__package_name__ = "venv-cmds"

venv_cmds-2026.9.26.1/src/venv_cmds/cli.py

@@ -0,0 +1,313 @@
+# PYTHON_ARGCOMPLETE_OK
+import argparse
+import json
+import shutil
+import subprocess
+import sys
+import types
+from datetime import datetime
+from pathlib import Path
+
+import argcomplete
+
+if sys.version_info >= (3, 8):
+    from importlib.metadata import distributions, entry_points
+else:
+    from importlib_metadata import distributions, entry_points
+
+from venv_cmds._version import __version__
+
+# ---------------------------------------------------------------------------
+# Helpers
+# ---------------------------------------------------------------------------
+
+def _in_venv():
+    return sys.prefix != getattr(sys, "base_prefix", sys.prefix)
+
+def _venv_name():
+    return Path(sys.prefix).name
+
+# ---------------------------------------------------------------------------
+# Command handlers
+# ---------------------------------------------------------------------------
+
+def cmd_list(args):
+    if _in_venv():
+        print("Info: detected virtual environment '{}'".format(_venv_name()))
+    else:
+        print("Warning: no virtual environment detected; listing system-wide commands.", file=sys.stderr)
+
+    if sys.version_info >= (3, 9):
+        eps = entry_points(group="console_scripts")
+    else:
+        eps = entry_points().get("console_scripts", [])
+
+    for ep in sorted(eps, key=lambda e: e.name):
+        if getattr(args, "details", False):
+            dist = getattr(ep, "dist", None)
+            pkg_name = dist.metadata.get("Name", "unknown") if dist else "unknown"
+            print("{} (package: {})".format(ep.name, pkg_name))
+        else:
+            print(ep.name)
+
+
+_STATUS_OK     = "ok"
+_STATUS_UPDATE = "update"
+
+
+def _pip_list_json(extra_args, timeout):
+    # Falls back to `uv pip list` if pip isn't importable in this environment
+    # (e.g. a venv created with `uv venv` without --seed). --python targets
+    # this exact interpreter rather than relying on VIRTUAL_ENV being set.
+    result = subprocess.run(
+        [sys.executable, "-m", "pip", "list", "--format=json"] + extra_args,
+        capture_output=True,
+        text=True,
+        timeout=timeout,
+    )
+    if result.returncode != 0:
+        uv_path = shutil.which("uv")
+        if uv_path:
+            result = subprocess.run(
+                [uv_path, "pip", "list", "--format=json", "--python", sys.executable] + extra_args,
+                capture_output=True,
+                text=True,
+                timeout=timeout,
+            )
+    if result.returncode != 0:
+        print("Error: pip list failed:\n{}".format(result.stderr.strip()), file=sys.stderr)
+        sys.exit(1)
+    return json.loads(result.stdout)
+
+
+def _get_install_date(dist):
+    try:
+        path = getattr(dist, "_path", None)
+        if path:
+            return datetime.fromtimestamp(path.stat().st_mtime).strftime("%Y-%m-%d")
+    except Exception:
+        pass
+    return "—"
+
+
+def cmd_check_updates(args):
+    timeout = args.timeout
+    output_file = args.output_file
+    include_install_date = args.include_install_date
+    updates_only = args.updates_only
+    no_progress = args.no_progress
+
+    if not no_progress:
+        print("  Querying index...", end="\r", file=sys.stderr, flush=True)
+
+    outdated = _pip_list_json(["--outdated"], timeout)
+
+    if updates_only:
+        # Single pip call sufficient — no need to fetch the full package list.
+        all_pkgs = outdated
+    else:
+        all_pkgs = _pip_list_json([], timeout)
+
+    if not no_progress:
+        print("                   ", end="\r", file=sys.stderr)
+
+    outdated_map = {p["name"].lower(): p["latest_version"] for p in outdated}
+
+    # Build install-date lookup from importlib.metadata if needed.
+    if include_install_date:
+        dist_map = {}
+        for dist in distributions():
+            name = dist.metadata.get("Name")
+            if name:
+                dist_map[name.lower()] = dist
+
+    results = []
+    for pkg in sorted(all_pkgs, key=lambda p: p["name"].lower()):
+        name      = pkg["name"]
+        installed = pkg["version"]
+        key       = name.lower()
+        latest    = outdated_map.get(key)
+        status    = _STATUS_UPDATE if latest else _STATUS_OK
+        if not latest:
+            latest = installed
+        install_date = _get_install_date(dist_map[key]) if include_install_date and key in dist_map else None
+        results.append((name, installed, install_date, latest, status))
+
+    # When writing requirements to stdout, redirect table output to stderr
+    # so the two streams stay separate and piping works cleanly.
+    out = sys.stderr if output_file == "-" else sys.stdout
+
+    # --- Table ---------------------------------------------------------------
+    col_pkg  = "Package"
+    col_inst = "Installed"
+    col_date = "Installed on"
+    col_lat  = "Latest"
+    col_stat = "Status"
+
+    label = {_STATUS_OK: "OK", _STATUS_UPDATE: "UPDATE AVAILABLE"}
+
+    rows = [
+        (name, inst, idate, lat, label[st], st)
+        for name, inst, idate, lat, st in results
+    ]
+
+    updates      = [r for r in rows if r[5] == _STATUS_UPDATE]
+    display_rows = updates if updates_only else rows
+
+    if display_rows:
+        w_pkg  = max(len(col_pkg),  max(len(r[0]) for r in display_rows))
+        w_inst = max(len(col_inst), max(len(r[1]) for r in display_rows))
+        w_lat  = max(len(col_lat),  max(len(r[3]) for r in display_rows))
+        w_stat = max(len(col_stat), max(len(r[4]) for r in display_rows))
+
+        if include_install_date:
+            w_date  = max(len(col_date), max(len(r[2] or "—") for r in display_rows))
+            fmt     = "{{:<{}}}  {{:<{}}}  {{:<{}}}  {{:<{}}}  {{}}".format(w_pkg, w_inst, w_date, w_lat)
+            divider = "  ".join(["-" * w_pkg, "-" * w_inst, "-" * w_date, "-" * w_lat, "-" * w_stat])
+            header  = fmt.format(col_pkg, col_inst, col_date, col_lat, col_stat)
+        else:
+            fmt     = "{{:<{}}}  {{:<{}}}  {{:<{}}}  {{}}".format(w_pkg, w_inst, w_lat)
+            divider = "  ".join(["-" * w_pkg, "-" * w_inst, "-" * w_lat, "-" * w_stat])
+            header  = fmt.format(col_pkg, col_inst, col_lat, col_stat)
+
+        print(header, file=out)
+        print(divider, file=out)
+        for name, inst, idate, lat, lbl, _ in display_rows:
+            if include_install_date:
+                print(fmt.format(name, inst, idate or "—", lat, lbl), file=out)
+            else:
+                print(fmt.format(name, inst, lat, lbl), file=out)
+        print(file=out)
+
+    if not updates_only:
+        if updates:
+            print("{} update(s) available.".format(len(updates)), file=out)
+        else:
+            print("All packages are up to date.", file=out)
+    elif updates:
+        print("{} update(s) available.".format(len(updates)), file=out)
+
+    if output_file:
+        if not updates:
+            print("No updates available — {} not written.".format(output_file), file=out)
+        elif output_file == "-":
+            sys.stdout.write("\n".join("{}=={}".format(r[0], r[3]) for r in updates) + "\n")
+        else:
+            path = Path(output_file)
+            path.write_text("\n".join("{}=={}".format(r[0], r[3]) for r in updates) + "\n", encoding="utf-8")
+            print("Update list written to {} ({} package(s)).".format(path, len(updates)), file=out)
+
+
+# ---------------------------------------------------------------------------
+# Declarative CLI structure
+# ---------------------------------------------------------------------------
+
+_CONFIG = types.SimpleNamespace(
+    prog="venv-cmds",
+    description="Inspect the active Python environment.",
+    epilog="Tab completion: run activate-global-python-argcomplete once per user account to enable.",
+    version=__version__,
+)
+
+COMMANDS = {
+    "list": {
+        "help": "List console_scripts entry points in the active environment (default).",
+        "arguments": [
+            {"name": ["-d", "--details"], "action": "store_true", "help": "Show package name alongside each command."},
+        ],
+        "handler": cmd_list,
+    },
+    "check_updates": {
+        "help": "Check all installed packages against the configured pip index for available updates.",
+        "arguments": [
+            {
+                "name": ["-t", "--timeout"],
+                "type": int,
+                "default": 30,
+                "metavar": "SECONDS",
+                "help": "Per-package pip query timeout in seconds (default: 30).",
+            },
+            {
+                "name": ["-o", "--output-file"],
+                "metavar": "FILE",
+                "default": None,
+                "help": "Write packages with available updates to FILE in requirements.txt format.",
+            },
+            {
+                "name": ["-u", "--updates-only"],
+                "action": "store_true",
+                "default": False,
+                "help": "Only show packages with available updates. Produces no output when everything is current.",
+            },
+            {
+                "name": ["-i", "--include-install-date"],
+                "action": "store_true",
+                "default": False,
+                "help": "Add an 'Installed on' column showing when each package was installed (approximated from dist-info mtime).",
+            },
+            {
+                "name": ["-n", "--no-progress"],
+                "action": "store_true",
+                "default": False,
+                "help": "Suppress the status message written to stderr while querying the index. Useful when running from cron.",
+            },
+        ],
+        "handler": cmd_check_updates,
+    },
+}
+
+
+# ---------------------------------------------------------------------------
+# Parser builder and entry point
+# ---------------------------------------------------------------------------
+
+def build_parser(config, commands):
+    parser = argparse.ArgumentParser(prog=config.prog, description=config.description, epilog=getattr(config, "epilog", None))
+    parser.add_argument("--version", action="version", version="{} {}".format(config.prog, config.version))
+
+    subparsers = parser.add_subparsers(dest="command")
+
+    for name, spec in commands.items():
+        help_text = argparse.SUPPRESS if spec.get("hidden") else spec.get("help")
+        sub = subparsers.add_parser(name, help=help_text)
+
+        for arg in spec.get("arguments", []):
+            arg = arg.copy()
+            arg_name = arg.pop("name")
+            if isinstance(arg_name, list):
+                sub.add_argument(*arg_name, **arg)
+            else:
+                sub.add_argument(arg_name, **arg)
+
+        for group_spec in spec.get("mutually_exclusive_groups", []):
+            group = sub.add_mutually_exclusive_group(required=group_spec.get("required", False))
+            for arg in group_spec["arguments"]:
+                arg = arg.copy()
+                arg_name = arg.pop("name")
+                group.add_argument(arg_name, **arg)
+
+        sub.set_defaults(func=spec["handler"])
+
+    return parser
+
+
+def make_main(config, commands):
+    default_cmd = "list"
+
+    def main():
+        parser = build_parser(config, commands)
+        argcomplete.autocomplete(parser)
+        args = parser.parse_args()
+
+        if not hasattr(args, "func"):
+            # No subcommand given — reparse as the default command so argparse
+            # fills in the same defaults it would for an explicit invocation
+            # (e.g. store_true flags default to False, not None).
+            args = parser.parse_args([default_cmd])
+
+        args.func(args)
+
+    return main
+
+
+main = make_main(_CONFIG, COMMANDS)

venv_cmds-2026.9.26.1/src/venv_cmds.egg-info/PKG-INFO

@@ -0,0 +1,91 @@
+Metadata-Version: 2.4
+Name: venv-cmds
+Version: 2026.9.26.1
+Summary: List available console commands in the active Python environment, check for package updates
+Author-email: Paul McGowan <paul.mcgowan@ophix.io>
+License-Expression: MIT
+Project-URL: Homepage, https://ophix.io
+Project-URL: Documentation, https://github.com/ophixproject/venv-cmds#readme
+Project-URL: Source, https://github.com/ophixproject/venv-cmds
+Keywords: venv,python,cli,console scripts
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+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: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Utilities
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: importlib_metadata>=3.6; python_version < "3.8"
+Requires-Dist: argcomplete>=3.0
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Dynamic: license-file
+
+# venv-cmds
+
+Small discovery and maintenance utilities for Python virtual environments.
+
+## Why this exists
+
+When you activate a virtual environment it is not always obvious which
+command-line tools are available or whether they are up to date.
+`venv-cmds` provides two commands: `list` to discover what is installed,
+and `check_updates` to check for newer versions on the configured pip index.
+
+## Commands
+
+Running `venv-cmds` with no subcommand is equivalent to `venv-cmds list`.
+
+### `list`
+
+Show all `console_scripts` entry points in the active environment.
+
+```bash
+venv-cmds list
+venv-cmds list --details    # include package name alongside each command
+```
+
+### `check_updates`
+
+Check all installed packages against the configured pip index and report
+which have updates available. Respects all pip index sources configured for
+the environment — public PyPI, private indexes, and local mirrors all work
+without any extra configuration.
+
+If `pip` isn't importable in the current venv (e.g. one created with
+`uv venv` without `--seed`), falls back automatically to `uv pip list`
+targeting this same interpreter, provided `uv` is installed on `PATH`.
+
+```bash
+venv-cmds check_updates
+venv-cmds check_updates --updates-only            # only show packages with updates
+venv-cmds check_updates --no-progress             # suppress status message on stderr (cron-safe)
+venv-cmds check_updates --include-install-date    # add an 'Installed on' column
+venv-cmds check_updates --timeout 60              # per-package query timeout in seconds (default: 30)
+venv-cmds check_updates --output-file updates.txt # write pinned requirements file for updates
+venv-cmds check_updates --output-file -           # write pinned requirements to stdout
+```
+
+When `--output-file` is used the output file contains `package==version` lines
+for every package with an available update. Passing this file to
+`pip install -r updates.txt` will upgrade exactly the packages that were
+flagged, with no other changes.
+
+## Installation
+
+```bash
+pip install venv-cmds
+```
+
+Requires Python 3.7 or later. Works with both `venv` and `virtualenv`.

venv_cmds-2026.9.26.1/src/venv_cmds.egg-info/SOURCES.txt

@@ -0,0 +1,15 @@
+LICENSE
+README.md
+pyproject.toml
+src/venv_cmds/__init__.py
+src/venv_cmds/_version.py
+src/venv_cmds/cli.py
+src/venv_cmds.egg-info/PKG-INFO
+src/venv_cmds.egg-info/SOURCES.txt
+src/venv_cmds.egg-info/dependency_links.txt
+src/venv_cmds.egg-info/entry_points.txt
+src/venv_cmds.egg-info/requires.txt
+src/venv_cmds.egg-info/top_level.txt
+tests/test_check_updates.py
+tests/test_cli.py
+tests/test_list.py

venv_cmds-2026.9.26.1/src/venv_cmds.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

venv_cmds-2026.9.26.1/src/venv_cmds.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+venv-cmds = venv_cmds.cli:main

venv_cmds-2026.9.26.1/src/venv_cmds.egg-info/requires.txt

@@ -0,0 +1,7 @@
+argcomplete>=3.0
+
+[:python_version < "3.8"]
+importlib_metadata>=3.6
+
+[test]
+pytest

venv_cmds-2026.9.26.1/src/venv_cmds.egg-info/top_level.txt

@@ -0,0 +1 @@
+venv_cmds

venv_cmds-2026.9.26.1/tests/test_check_updates.py

@@ -0,0 +1,214 @@
+import json
+import subprocess
+import types
+
+import pytest
+
+from venv_cmds import cli
+
+
+def _completed(returncode=0, stdout="", stderr=""):
+    return subprocess.CompletedProcess(args=[], returncode=returncode, stdout=stdout, stderr=stderr)
+
+
+def _args(**overrides):
+    defaults = dict(
+        timeout=30,
+        output_file=None,
+        updates_only=False,
+        include_install_date=False,
+        no_progress=True,
+    )
+    defaults.update(overrides)
+    return types.SimpleNamespace(**defaults)
+
+
+# ---------------------------------------------------------------------------
+# _pip_list_json
+# ---------------------------------------------------------------------------
+
+def test_pip_list_json_uses_pip_when_it_succeeds(monkeypatch):
+    payload = [{"name": "foo", "version": "1.0"}]
+    calls = []
+
+    def fake_run(cmd, **kwargs):
+        calls.append(cmd)
+        return _completed(0, stdout=json.dumps(payload))
+
+    monkeypatch.setattr(subprocess, "run", fake_run)
+
+    result = cli._pip_list_json([], timeout=5)
+
+    assert result == payload
+    assert len(calls) == 1
+    assert "pip" in calls[0]
+
+
+def test_pip_list_json_falls_back_to_uv_when_pip_fails(monkeypatch):
+    payload = [{"name": "bar", "version": "2.0"}]
+    calls = []
+
+    def fake_run(cmd, **kwargs):
+        calls.append(cmd)
+        if "uv" in cmd[0]:
+            return _completed(0, stdout=json.dumps(payload))
+        return _completed(1, stderr="pip not importable")
+
+    monkeypatch.setattr(subprocess, "run", fake_run)
+    monkeypatch.setattr(cli.shutil, "which", lambda name: "/usr/bin/uv")
+
+    result = cli._pip_list_json([], timeout=5)
+
+    assert result == payload
+    assert len(calls) == 2
+    assert "--python" in calls[1]
+
+
+def test_pip_list_json_exits_when_both_pip_and_uv_fail(monkeypatch, capsys):
+    def fake_run(cmd, **kwargs):
+        return _completed(1, stderr="boom")
+
+    monkeypatch.setattr(subprocess, "run", fake_run)
+    monkeypatch.setattr(cli.shutil, "which", lambda name: None)
+
+    with pytest.raises(SystemExit) as exc_info:
+        cli._pip_list_json([], timeout=5)
+
+    assert exc_info.value.code == 1
+    _, err = capsys.readouterr()
+    assert "boom" in err
+
+
+# ---------------------------------------------------------------------------
+# _get_install_date
+# ---------------------------------------------------------------------------
+
+def test_get_install_date_from_path_mtime(tmp_path):
+    marker = tmp_path / "pkg.dist-info"
+    marker.write_text("x")
+
+    dist = types.SimpleNamespace(_path=marker)
+
+    result = cli._get_install_date(dist)
+
+    assert len(result) == 10
+    assert result.count("-") == 2
+
+
+def test_get_install_date_returns_placeholder_without_path():
+    dist = types.SimpleNamespace()
+
+    assert cli._get_install_date(dist) == "—"
+
+
+# ---------------------------------------------------------------------------
+# cmd_check_updates
+# ---------------------------------------------------------------------------
+
+def test_check_updates_all_current(monkeypatch, capsys):
+    all_pkgs = [{"name": "alpha", "version": "1.0"}]
+
+    def fake_pip_list_json(extra_args, timeout):
+        return [] if extra_args == ["--outdated"] else all_pkgs
+
+    monkeypatch.setattr(cli, "_pip_list_json", fake_pip_list_json)
+
+    cli.cmd_check_updates(_args())
+
+    out, _ = capsys.readouterr()
+    assert "alpha" in out
+    assert "OK" in out
+    assert "All packages are up to date." in out
+
+
+def test_check_updates_reports_available_update(monkeypatch, capsys):
+    def fake_pip_list_json(extra_args, timeout):
+        if extra_args == ["--outdated"]:
+            return [{"name": "alpha", "version": "1.0", "latest_version": "2.0"}]
+        return [{"name": "alpha", "version": "1.0"}, {"name": "beta", "version": "3.0"}]
+
+    monkeypatch.setattr(cli, "_pip_list_json", fake_pip_list_json)
+
+    cli.cmd_check_updates(_args())
+
+    out, _ = capsys.readouterr()
+    assert "alpha" in out and "UPDATE AVAILABLE" in out
+    assert "beta" in out and "OK" in out
+    assert "1 update(s) available." in out
+
+
+def test_check_updates_only_flag_hides_current_packages(monkeypatch, capsys):
+    def fake_pip_list_json(extra_args, timeout):
+        # updates_only mode should never request the full package list
+        assert extra_args == ["--outdated"]
+        return [{"name": "alpha", "version": "1.0", "latest_version": "2.0"}]
+
+    monkeypatch.setattr(cli, "_pip_list_json", fake_pip_list_json)
+
+    cli.cmd_check_updates(_args(updates_only=True))
+
+    out, _ = capsys.readouterr()
+    assert "alpha" in out
+    assert "beta" not in out
+
+
+def test_check_updates_writes_output_file(monkeypatch, tmp_path):
+    def fake_pip_list_json(extra_args, timeout):
+        if extra_args == ["--outdated"]:
+            return [{"name": "alpha", "version": "1.0", "latest_version": "2.0"}]
+        return [{"name": "alpha", "version": "1.0"}]
+
+    monkeypatch.setattr(cli, "_pip_list_json", fake_pip_list_json)
+
+    out_file = tmp_path / "updates.txt"
+    cli.cmd_check_updates(_args(output_file=str(out_file)))
+
+    assert out_file.read_text(encoding="utf-8") == "alpha==2.0\n"
+
+
+def test_check_updates_output_file_dash_writes_to_stdout(monkeypatch, capsys):
+    def fake_pip_list_json(extra_args, timeout):
+        if extra_args == ["--outdated"]:
+            return [{"name": "alpha", "version": "1.0", "latest_version": "2.0"}]
+        return [{"name": "alpha", "version": "1.0"}]
+
+    monkeypatch.setattr(cli, "_pip_list_json", fake_pip_list_json)
+
+    cli.cmd_check_updates(_args(output_file="-"))
+
+    out, err = capsys.readouterr()
+    assert out == "alpha==2.0\n"
+    # the table itself is redirected to stderr so stdout stays parseable
+    assert "alpha" in err
+
+
+def test_check_updates_no_output_file_when_nothing_outdated(monkeypatch, tmp_path, capsys):
+    def fake_pip_list_json(extra_args, timeout):
+        return [] if extra_args == ["--outdated"] else [{"name": "alpha", "version": "1.0"}]
+
+    monkeypatch.setattr(cli, "_pip_list_json", fake_pip_list_json)
+
+    out_file = tmp_path / "updates.txt"
+    cli.cmd_check_updates(_args(output_file=str(out_file)))
+
+    assert not out_file.exists()
+    out, _ = capsys.readouterr()
+    assert "not written" in out
+
+
+def test_check_updates_include_install_date_column(monkeypatch, tmp_path, capsys):
+    dist_info = tmp_path / "alpha.dist-info"
+    dist_info.write_text("x")
+
+    fake_dist = types.SimpleNamespace(metadata={"Name": "alpha"}, _path=dist_info)
+
+    def fake_pip_list_json(extra_args, timeout):
+        return [] if extra_args == ["--outdated"] else [{"name": "alpha", "version": "1.0"}]
+
+    monkeypatch.setattr(cli, "_pip_list_json", fake_pip_list_json)
+    monkeypatch.setattr(cli, "distributions", lambda: [fake_dist])
+
+    cli.cmd_check_updates(_args(include_install_date=True))
+
+    out, _ = capsys.readouterr()
+    assert "Installed on" in out

venv_cmds-2026.9.26.1/tests/test_cli.py

@@ -0,0 +1,75 @@
+import argparse
+
+import pytest
+
+from venv_cmds import cli
+
+
+def test_build_parser_registers_both_commands():
+    parser = cli.build_parser(cli._CONFIG, cli.COMMANDS)
+    subparsers_action = next(
+        a for a in parser._actions if isinstance(a, argparse._SubParsersAction)
+    )
+    assert set(subparsers_action.choices) == {"list", "check_updates"}
+
+
+def test_version_flag_prints_version_and_exits(capsys):
+    parser = cli.build_parser(cli._CONFIG, cli.COMMANDS)
+
+    with pytest.raises(SystemExit) as exc_info:
+        parser.parse_args(["--version"])
+
+    assert exc_info.value.code == 0
+    out, _ = capsys.readouterr()
+    assert cli._CONFIG.version in out
+
+
+def test_check_updates_args_parse_short_flags():
+    parser = cli.build_parser(cli._CONFIG, cli.COMMANDS)
+
+    args = parser.parse_args(["check_updates", "-u", "-t", "5", "-n"])
+
+    assert args.updates_only is True
+    assert args.timeout == 5
+    assert args.no_progress is True
+    assert args.func is cli.cmd_check_updates
+
+
+def test_list_details_flag_parses():
+    parser = cli.build_parser(cli._CONFIG, cli.COMMANDS)
+
+    args = parser.parse_args(["list", "--details"])
+
+    assert args.details is True
+    assert args.func is cli.cmd_list
+
+
+def test_main_with_no_subcommand_runs_list_with_defaults(monkeypatch):
+    seen = {}
+
+    def fake_cmd_list(args):
+        seen["details"] = args.details
+
+    monkeypatch.setitem(cli.COMMANDS["list"], "handler", fake_cmd_list)
+    monkeypatch.setattr(cli.argcomplete, "autocomplete", lambda parser: None)
+    monkeypatch.setattr("sys.argv", ["venv-cmds"])
+
+    cli.main()
+
+    assert seen == {"details": False}
+
+
+def test_main_dispatches_to_explicit_subcommand(monkeypatch):
+    seen = {}
+
+    def fake_cmd_list(args):
+        seen["called"] = True
+        seen["details"] = args.details
+
+    monkeypatch.setitem(cli.COMMANDS["list"], "handler", fake_cmd_list)
+    monkeypatch.setattr(cli.argcomplete, "autocomplete", lambda parser: None)
+    monkeypatch.setattr("sys.argv", ["venv-cmds", "list", "--details"])
+
+    cli.main()
+
+    assert seen == {"called": True, "details": True}

venv_cmds-2026.9.26.1/tests/test_list.py

@@ -0,0 +1,74 @@
+import types
+from importlib.metadata import entry_points
+
+from venv_cmds import cli
+
+
+def test_console_scripts_exist():
+    eps = entry_points(group="console_scripts")
+    names = {ep.name for ep in eps}
+
+    # pip should always exist in a venv
+    assert "pip" in names
+
+
+class _FakeDist:
+    def __init__(self, name):
+        self.metadata = {"Name": name}
+
+
+class _FakeEntryPoint:
+    def __init__(self, name, dist=None):
+        self.name = name
+        self.dist = dist
+
+
+def _fake_entry_points(monkeypatch, eps):
+    monkeypatch.setattr(cli, "entry_points", lambda group=None: eps)
+
+
+def test_cmd_list_plain_sorted(monkeypatch, capsys):
+    monkeypatch.setattr(cli, "_in_venv", lambda: False)
+    _fake_entry_points(monkeypatch, [
+        _FakeEntryPoint("zeta"),
+        _FakeEntryPoint("alpha"),
+    ])
+
+    cli.cmd_list(types.SimpleNamespace(details=False))
+
+    out, err = capsys.readouterr()
+    assert out.splitlines() == ["alpha", "zeta"]
+    assert "Warning" in err
+
+
+def test_cmd_list_details_shows_package_name(monkeypatch, capsys):
+    monkeypatch.setattr(cli, "_in_venv", lambda: False)
+    _fake_entry_points(monkeypatch, [
+        _FakeEntryPoint("thing", dist=_FakeDist("thing-package")),
+    ])
+
+    cli.cmd_list(types.SimpleNamespace(details=True))
+
+    out, _ = capsys.readouterr()
+    assert out.strip() == "thing (package: thing-package)"
+
+
+def test_cmd_list_details_unknown_package_when_no_dist(monkeypatch, capsys):
+    monkeypatch.setattr(cli, "_in_venv", lambda: False)
+    _fake_entry_points(monkeypatch, [_FakeEntryPoint("orphan", dist=None)])
+
+    cli.cmd_list(types.SimpleNamespace(details=True))
+
+    out, _ = capsys.readouterr()
+    assert out.strip() == "orphan (package: unknown)"
+
+
+def test_cmd_list_in_venv_prints_info(monkeypatch, capsys):
+    monkeypatch.setattr(cli, "_in_venv", lambda: True)
+    monkeypatch.setattr(cli, "_venv_name", lambda: "myenv")
+    _fake_entry_points(monkeypatch, [])
+
+    cli.cmd_list(types.SimpleNamespace(details=False))
+
+    out, _ = capsys.readouterr()
+    assert "detected virtual environment 'myenv'" in out