depkeeper 0.1.0.dev0__tar.gz → 0.1.0.dev2__tar.gz

{depkeeper-0.1.0.dev0 → depkeeper-0.1.0.dev2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: depkeeper
-Version: 0.1.0.dev0
+Version: 0.1.0.dev2
 Summary: Modern Python dependency management for requirements.txt files
 Author: depkeeper Contributors
 License: Apache-2.0
@@ -25,33 +25,31 @@ Classifier: Topic :: System :: Software Distribution
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: click>=8.1.0
-Requires-Dist: packaging>=23.0
-Requires-Dist: httpx>=0.24.0
-Requires-Dist: rich>=13.0.0
-Requires-Dist: pydantic>=2.0.0
+Requires-Dist: click>=8.1.8
+Requires-Dist: packaging>=23.2
+Requires-Dist: httpx[http2]>=0.24.1
+Requires-Dist: rich>=13.9.4
 Provides-Extra: dev
-Requires-Dist: pytest>=7.4.0; extra == "dev"
+Requires-Dist: pytest>=7.4.4; extra == "dev"
 Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
-Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
-Requires-Dist: pytest-mock>=3.11.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23.8; extra == "dev"
+Requires-Dist: pytest-mock>=3.14.1; extra == "dev"
 Requires-Dist: pytest-httpx>=0.22.0; extra == "dev"
-Requires-Dist: ruff>=0.1.0; extra == "dev"
-Requires-Dist: mypy>=1.5.0; extra == "dev"
+Requires-Dist: mypy>=1.14.1; extra == "dev"
 Requires-Dist: types-setuptools; extra == "dev"
-Requires-Dist: pre-commit>=3.4.0; extra == "dev"
+Requires-Dist: pre-commit>=3.5.0; extra == "dev"
 Provides-Extra: test
-Requires-Dist: pytest>=7.4.0; extra == "test"
+Requires-Dist: pytest>=7.4.4; extra == "test"
 Requires-Dist: pytest-cov>=4.1.0; extra == "test"
-Requires-Dist: pytest-asyncio>=0.21.0; extra == "test"
-Requires-Dist: pytest-mock>=3.11.0; extra == "test"
+Requires-Dist: pytest-asyncio>=0.23.8; extra == "test"
+Requires-Dist: pytest-mock>=3.14.1; extra == "test"
 Requires-Dist: pytest-httpx>=0.22.0; extra == "test"
 Provides-Extra: docs
-Requires-Dist: mkdocs>=1.5.0; extra == "docs"
-Requires-Dist: mkdocs-material>=9.4.0; extra == "docs"
-Requires-Dist: mkdocstrings[python]>=0.23.0; extra == "docs"
+Requires-Dist: mkdocs>=1.6.1; extra == "docs"
+Requires-Dist: mkdocs-material>=9.7.1; extra == "docs"
+Requires-Dist: mkdocstrings[python]>=0.26.1; extra == "docs"
 
-# depkeeper 🛡️🐍
+# depkeeper
 
 [![Tests](https://github.com/rahulkaushal04/depkeeper/workflows/Tests/badge.svg)](https://github.com/rahulkaushal04/depkeeper/actions)
 [![Coverage](https://codecov.io/gh/rahulkaushal04/depkeeper/branch/main/graph/badge.svg)](https://codecov.io/gh/rahulkaushal04/depkeeper)
@@ -60,26 +58,31 @@ Requires-Dist: mkdocstrings[python]>=0.23.0; extra == "docs"
 [![License: Apache-2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 
 Modern, intelligent Python dependency management for `requirements.txt` files.
-Keep your dependencies up-to-date, secure, and conflict-free — without switching from pip.
+Keep your dependencies up-to-date and conflict-free — without switching from pip.
 
 ---
 
-## ✨ Features
+## Features
 
-- 🔍 **Smart Version Checking** — discover available package updates automatically
-- 🛡️ **Security Scanning** — detect known vulnerabilities via advisories
-- 🔒 **Lock File Generation** — create reproducible environments
-- 📊 **Health Scoring** — measure package quality & maintainability
-- 🧠 **Dependency Resolution** — detect and resolve version conflicts
-- 🎯 **Update Strategies** — conservative, moderate, or aggressive upgrade modes
-- 🔄 **Format Conversion** — import/export: `requirements.txt`, `pyproject.toml`, Pipfile, Poetry, Conda
-- ⚡ **Fast & Concurrent** — async operations for maximum performance
-- 🎨 **Beautiful CLI** — rich terminal UI with progress bars & status indicators
-- 🤝 **Flexible** — works with pip instead of replacing it
+- **Smart Version Checking** — discover available package updates with intelligent recommendations
+- **Dependency Conflict Resolution** — detect and resolve version conflicts automatically
+- **Safe Updates** — never cross major version boundaries to prevent breaking changes
+- **Fast & Concurrent** — async PyPI queries for maximum performance
+- **Beautiful CLI** — rich terminal UI with colors & status indicators
+- **Multiple Output Formats** — table, simple text, or JSON for CI/CD integration
+- **Full Requirements Parsing** — PEP 440/508 compliant with support for `-r`, `-c`, VCS URLs, and more
+- **Flexible** — works alongside pip, not instead of it
+
+### Coming Soon
+
+- **Security Scanning** — detect known vulnerabilities
+- **Lock File Generation** — create reproducible environments
+- **Health Scoring** — measure package quality & maintainability
+- **Format Conversion** — import/export between `requirements.txt`, `pyproject.toml`, Pipfile, and more
 
 ---
 
-## 🚀 Quick Start
+## Quick Start
 
 ### Installation
 
@@ -93,28 +96,69 @@ pip install depkeeper
 # Check for available updates
 depkeeper check
 
-# Update dependencies (safe, patch-level updates by default)
+# Check and show only outdated packages
+depkeeper check --outdated-only
+
+# Output as JSON (for CI/CD pipelines)
+depkeeper check --format json
+
+# Update all packages to safe versions (within major version)
 depkeeper update
 
-# Run security audit
-depkeeper audit
+# Preview updates without applying
+depkeeper update --dry-run
+
+# Update specific packages only
+depkeeper update -p flask -p requests
+
+# Create backup before updating and skip confirmation
+depkeeper update --backup -y
+```
+
+---
+
+## Commands
+
+### `depkeeper check`
 
-# Generate lock file
-depkeeper lock
+Analyze your `requirements.txt` file to identify packages with available updates.
 
-# Show dependency tree
-depkeeper tree
+```bash
+depkeeper check [FILE] [OPTIONS]
+
+Options:
+  --outdated-only           Show only packages with available updates
+  -f, --format [table|simple|json]
+                            Output format (default: table)
+  --strict-version-matching Only use exact version pins
+  --check-conflicts         Check for dependency conflicts (default: enabled)
+```
+
+### `depkeeper update`
+
+Update packages to their safe recommended versions (within major version boundaries).
+
+```bash
+depkeeper update [FILE] [OPTIONS]
+
+Options:
+  --dry-run                 Preview changes without applying
+  -y, --yes                 Skip confirmation prompt
+  --backup                  Create backup file before updating
+  -p, --packages TEXT       Update only specific packages (repeatable)
+  --strict-version-matching Only use exact version pins
+  --check-conflicts         Check for conflicts (default: enabled)
 ```
 
 ---
 
-## 📚 Documentation
+## Documentation
 
 Full documentation will be available soon at **[https://docs.depkeeper.dev](https://docs.depkeeper.dev)**
 
 ---
 
-## 💡 Why depkeeper?
+## Why depkeeper?
 
 Depkeeper bridges the gap between pip’s simplicity and Poetry’s sophistication:
 
@@ -123,12 +167,13 @@ Depkeeper bridges the gap between pip’s simplicity and Poetry’s sophisticati
 | simple                      | powerful        | simple + powerful                   |
 | minimal tooling             | strict workflow | flexible workflow                   |
 | limited dependency checking | strong resolver | strong resolver + update automation |
+| no conflict detection       | automatic       | automatic with safe boundaries      |
 
 **Focus on code — let depkeeper handle dependency hygiene.**
 
 ---
 
-## 🤝 Contributing
+## Contributing
 
 We welcome contributions of all kinds!
 Please see our **[Contributing Guide](CONTRIBUTING.md)** for details.
@@ -152,25 +197,22 @@ pre-commit install
 
 ---
 
-## 📄 License
+## License
 
 This project is licensed under the **Apache-2.0 License** — see the [LICENSE](LICENSE) file for details.
 
 ---
 
-## 🙌 Acknowledgments
+## Acknowledgments
 
 - Built with amazing libraries like **Click**, **Rich**, and **httpx**
 - Inspired by tools such as **pip-tools**, **Poetry**, and **Dependabot**
 
 ---
 
-## ❤️ Support
+## Support
 
-- 📬 Email: [support@depkeeper.dev](mailto:support@depkeeper.dev)
-- 💬 GitHub Discussions: [https://github.com/rahulkaushal04/depkeeper/discussions](https://github.com/rahulkaushal04/depkeeper/discussions)
-- 🐞 Issues: [https://github.com/rahulkaushal04/depkeeper/issues](https://github.com/rahulkaushal04/depkeeper/issues)
+- GitHub Discussions: [https://github.com/rahulkaushal04/depkeeper/discussions](https://github.com/rahulkaushal04/depkeeper/discussions)
+- Issues: [https://github.com/rahulkaushal04/depkeeper/issues](https://github.com/rahulkaushal04/depkeeper/issues)
 
 ---
-
-**Made with ❤️ by the depkeeper team**

depkeeper-0.1.0.dev2/README.md

@@ -0,0 +1,167 @@
+# depkeeper
+
+[![Tests](https://github.com/rahulkaushal04/depkeeper/workflows/Tests/badge.svg)](https://github.com/rahulkaushal04/depkeeper/actions)
+[![Coverage](https://codecov.io/gh/rahulkaushal04/depkeeper/branch/main/graph/badge.svg)](https://codecov.io/gh/rahulkaushal04/depkeeper)
+[![PyPI version](https://badge.fury.io/py/depkeeper.svg)](https://badge.fury.io/py/depkeeper)
+[![Python versions](https://img.shields.io/pypi/pyversions/depkeeper.svg)](https://pypi.org/project/depkeeper/)
+[![License: Apache-2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
+
+Modern, intelligent Python dependency management for `requirements.txt` files.
+Keep your dependencies up-to-date and conflict-free — without switching from pip.
+
+---
+
+## Features
+
+- **Smart Version Checking** — discover available package updates with intelligent recommendations
+- **Dependency Conflict Resolution** — detect and resolve version conflicts automatically
+- **Safe Updates** — never cross major version boundaries to prevent breaking changes
+- **Fast & Concurrent** — async PyPI queries for maximum performance
+- **Beautiful CLI** — rich terminal UI with colors & status indicators
+- **Multiple Output Formats** — table, simple text, or JSON for CI/CD integration
+- **Full Requirements Parsing** — PEP 440/508 compliant with support for `-r`, `-c`, VCS URLs, and more
+- **Flexible** — works alongside pip, not instead of it
+
+### Coming Soon
+
+- **Security Scanning** — detect known vulnerabilities
+- **Lock File Generation** — create reproducible environments
+- **Health Scoring** — measure package quality & maintainability
+- **Format Conversion** — import/export between `requirements.txt`, `pyproject.toml`, Pipfile, and more
+
+---
+
+## Quick Start
+
+### Installation
+
+```bash
+pip install depkeeper
+```
+
+### Basic Usage
+
+```bash
+# Check for available updates
+depkeeper check
+
+# Check and show only outdated packages
+depkeeper check --outdated-only
+
+# Output as JSON (for CI/CD pipelines)
+depkeeper check --format json
+
+# Update all packages to safe versions (within major version)
+depkeeper update
+
+# Preview updates without applying
+depkeeper update --dry-run
+
+# Update specific packages only
+depkeeper update -p flask -p requests
+
+# Create backup before updating and skip confirmation
+depkeeper update --backup -y
+```
+
+---
+
+## Commands
+
+### `depkeeper check`
+
+Analyze your `requirements.txt` file to identify packages with available updates.
+
+```bash
+depkeeper check [FILE] [OPTIONS]
+
+Options:
+  --outdated-only           Show only packages with available updates
+  -f, --format [table|simple|json]
+                            Output format (default: table)
+  --strict-version-matching Only use exact version pins
+  --check-conflicts         Check for dependency conflicts (default: enabled)
+```
+
+### `depkeeper update`
+
+Update packages to their safe recommended versions (within major version boundaries).
+
+```bash
+depkeeper update [FILE] [OPTIONS]
+
+Options:
+  --dry-run                 Preview changes without applying
+  -y, --yes                 Skip confirmation prompt
+  --backup                  Create backup file before updating
+  -p, --packages TEXT       Update only specific packages (repeatable)
+  --strict-version-matching Only use exact version pins
+  --check-conflicts         Check for conflicts (default: enabled)
+```
+
+---
+
+## Documentation
+
+Full documentation will be available soon at **[https://docs.depkeeper.dev](https://docs.depkeeper.dev)**
+
+---
+
+## Why depkeeper?
+
+Depkeeper bridges the gap between pip’s simplicity and Poetry’s sophistication:
+
+| pip                         | poetry          | depkeeper                           |
+| --------------------------- | --------------- | ----------------------------------- |
+| simple                      | powerful        | simple + powerful                   |
+| minimal tooling             | strict workflow | flexible workflow                   |
+| limited dependency checking | strong resolver | strong resolver + update automation |
+| no conflict detection       | automatic       | automatic with safe boundaries      |
+
+**Focus on code — let depkeeper handle dependency hygiene.**
+
+---
+
+## Contributing
+
+We welcome contributions of all kinds!
+Please see our **[Contributing Guide](CONTRIBUTING.md)** for details.
+
+### Development Setup
+
+```bash
+# Clone the repository
+git clone https://github.com/rahulkaushal04/depkeeper.git
+cd depkeeper
+
+# Run setup script
+bash scripts/setup_dev.sh
+
+# Or manually:
+python -m venv venv
+source venv/bin/activate  # Windows: venv\Scripts\activate
+pip install -e ".[dev]"
+pre-commit install
+```
+
+---
+
+## License
+
+This project is licensed under the **Apache-2.0 License** — see the [LICENSE](LICENSE) file for details.
+
+---
+
+## Acknowledgments
+
+- Built with amazing libraries like **Click**, **Rich**, and **httpx**
+- Inspired by tools such as **pip-tools**, **Poetry**, and **Dependabot**
+
+---
+
+## Support
+
+- GitHub Discussions: [https://github.com/rahulkaushal04/depkeeper/discussions](https://github.com/rahulkaushal04/depkeeper/discussions)
+- Issues: [https://github.com/rahulkaushal04/depkeeper/issues](https://github.com/rahulkaushal04/depkeeper/issues)
+
+---

depkeeper-0.1.0.dev2/depkeeper/__init__.py

@@ -0,0 +1,32 @@
+"""
+depkeeper — modern Python dependency management for requirements.txt.
+
+depkeeper is an intelligent dependency management tool that helps developers
+keep their ``requirements.txt`` files up to date, secure, and conflict-free.
+
+Quick start
+-----------
+Check for available updates::
+
+    $ depkeeper check
+
+Update packages to newer versions::
+
+    $ depkeeper update
+
+Programmatic usage::
+
+    >>> from depkeeper.core.parser import RequirementsParser
+    >>> from depkeeper.core.checker import VersionChecker
+    >>> parser = RequirementsParser()
+    >>> requirements = parser.parse_file("requirements.txt")
+
+For more information, see:
+    https://docs.depkeeper.dev
+"""
+
+from __future__ import annotations
+
+from depkeeper.__version__ import __version__
+
+__all__ = ["__version__"]

depkeeper-0.1.0.dev2/depkeeper/__main__.py

@@ -0,0 +1,45 @@
+"""
+Module entry point for depkeeper.
+
+This file enables execution via ``python -m depkeeper`` and delegates
+control to the main CLI implementation.
+"""
+
+from __future__ import annotations
+
+import sys
+
+
+def main() -> int:
+    """Entry point for ``python -m depkeeper``.
+
+    Returns:
+        Exit code:
+            0   Success
+            1   Import or runtime error
+            130 Interrupted by user
+    """
+    try:
+        from depkeeper.cli import main as cli_main
+    except ImportError as exc:
+        _print_startup_error(exc)
+        return 1
+
+    return cli_main()
+
+
+def _print_startup_error(exc: ImportError) -> None:
+    """Print a helpful error message if the CLI cannot be imported."""
+    try:
+        from depkeeper.__version__ import __version__
+
+        sys.stderr.write(f"depkeeper version: {__version__}\n")
+    except Exception:
+        sys.stderr.write("depkeeper version: <unknown>\n")
+
+    sys.stderr.write("\n")
+    sys.stderr.write(f"ImportError: {exc}\n")
+
+
+if __name__ == "__main__":
+    sys.exit(main())

depkeeper-0.1.0.dev2/depkeeper/__version__.py

@@ -0,0 +1,12 @@
+"""
+Version information for depkeeper.
+
+This module exposes the canonical version string for the depkeeper
+package. It is intentionally isolated to avoid import cycles and to
+allow tools (CLI, packaging, docs) to query the version reliably.
+"""
+
+from __future__ import annotations
+
+#: Current depkeeper version (PEP 440 compliant).
+__version__: str = "0.1.0.dev2"

depkeeper-0.1.0.dev2/depkeeper/cli.py

@@ -0,0 +1,157 @@
+"""
+Command-line interface for depkeeper.
+
+This module defines the main Click entry point, global options, command
+registration, and top-level error handling for the depkeeper CLI.
+"""
+
+from __future__ import annotations
+
+import os
+import sys
+import logging
+from pathlib import Path
+from typing import Optional
+
+import click
+
+from depkeeper.__version__ import __version__
+from depkeeper.context import DepKeeperContext
+from depkeeper.exceptions import DepKeeperError
+from depkeeper.utils.console import print_error, print_warning
+from depkeeper.utils.logger import get_logger, setup_logging
+
+logger = get_logger("cli")
+
+
+@click.group(context_settings={"help_option_names": ["-h", "--help"]})
+@click.option(
+    "--config",
+    "-c",
+    type=click.Path(exists=True, dir_okay=False, path_type=Path),
+    help="Path to configuration file.",
+    envvar="DEPKEEPER_CONFIG",
+)
+@click.option(
+    "--verbose",
+    "-v",
+    count=True,
+    help="Increase verbosity (can be repeated: -v, -vv).",
+)
+@click.option(
+    "--color/--no-color",
+    default=True,
+    help="Enable or disable colored output.",
+    envvar="DEPKEEPER_COLOR",
+)
+@click.version_option(
+    version=__version__,
+    prog_name="depkeeper",
+    message="%(prog)s %(version)s",
+)
+@click.pass_context
+def cli(
+    ctx: click.Context,
+    config: Optional[Path],
+    verbose: int,
+    color: bool,
+) -> None:
+    """depkeeper — modern dependency management for requirements.txt files.
+
+    \b
+    Available commands:
+      depkeeper check              Check for available updates
+      depkeeper update             Update packages to newer versions
+
+    \b
+    Examples:
+      depkeeper check
+      depkeeper update
+      depkeeper -v check
+
+    Use ``depkeeper COMMAND --help`` for command-specific options.
+    """
+    _configure_logging(verbose)
+
+    depkeeper_ctx = DepKeeperContext()
+    depkeeper_ctx.config_path = config
+    depkeeper_ctx.verbose = verbose
+    depkeeper_ctx.color = color
+    ctx.obj = depkeeper_ctx
+
+    # Respect NO_COLOR for downstream libraries
+    if color:
+        os.environ.pop("NO_COLOR", None)
+    else:
+        os.environ["NO_COLOR"] = "1"
+
+    logger.debug("depkeeper v%s", __version__)
+    logger.debug("Config path: %s", config)
+    logger.debug("Verbosity: %s | Color: %s", verbose, color)
+
+
+def _configure_logging(verbose: int) -> None:
+    """Configure logging level based on verbosity flags."""
+    if verbose <= 0:
+        level = logging.WARNING
+    elif verbose == 1:
+        level = logging.INFO
+    else:
+        level = logging.DEBUG
+
+    setup_logging(level=level)
+    logger.debug("Logging initialized at %s level", logging.getLevelName(level))
+
+
+# Register CLI subcommands
+try:
+    from depkeeper.commands.check import check
+    from depkeeper.commands.update import update
+
+    cli.add_command(check)
+    cli.add_command(update)
+
+except ImportError as exc:
+    sys.stderr.write(f"FATAL: Failed to import CLI commands: {exc}\n")
+    sys.exit(1)
+
+
+def main() -> int:
+    """Main entry point for the depkeeper CLI.
+
+    Returns:
+        Exit code:
+            0   Success
+            1   Unhandled or application error
+            2   Usage error (Click)
+            130 Interrupted by user (Ctrl+C)
+    """
+    try:
+        cli(standalone_mode=False)
+        return 0
+
+    except click.ClickException as exc:
+        exc.show()
+        return exc.exit_code
+
+    except DepKeeperError as exc:
+        print_error(str(exc))
+        logger.debug(
+            "DepKeeperError details: %s",
+            exc.details or "<none>",
+            exc_info=True,
+        )
+        return 1
+
+    except KeyboardInterrupt:
+        print_warning("\nOperation cancelled by user")
+        return 130
+
+    except Exception as exc:
+        print_error(f"Unexpected error: {exc}")
+        logger.exception("Unhandled exception in CLI")
+        return 1
+
+
+if __name__ == "__main__":
+    sys.exit(main())