depkeeper 0.1.0.dev0__tar.gz → 0.1.0.dev1__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: depkeeper
-Version: 0.1.0.dev0
+Version: 0.1.0.dev1
 Summary: Modern Python dependency management for requirements.txt files
 Author: depkeeper Contributors
 License: Apache-2.0
@@ -25,18 +25,16 @@ 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: click>=8.1.8
+Requires-Dist: packaging>=23.2
 Requires-Dist: httpx>=0.24.0
-Requires-Dist: rich>=13.0.0
-Requires-Dist: pydantic>=2.0.0
+Requires-Dist: rich>=13.9.4
 Provides-Extra: dev
 Requires-Dist: pytest>=7.4.0; 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-httpx>=0.22.0; extra == "dev"
-Requires-Dist: ruff>=0.1.0; extra == "dev"
 Requires-Dist: mypy>=1.5.0; extra == "dev"
 Requires-Dist: types-setuptools; extra == "dev"
 Requires-Dist: pre-commit>=3.4.0; extra == "dev"
@@ -47,9 +45,9 @@ Requires-Dist: pytest-asyncio>=0.21.0; extra == "test"
 Requires-Dist: pytest-mock>=3.11.0; 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 🛡️🐍
 
@@ -167,7 +165,6 @@ This project is licensed under the **Apache-2.0 License** — see the [LICENSE](
 
 ## ❤️ 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)
 

{depkeeper-0.1.0.dev0 → depkeeper-0.1.0.dev1}/README.md

@@ -114,7 +114,6 @@ This project is licensed under the **Apache-2.0 License** — see the [LICENSE](
 
 ## ❤️ 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)
 

depkeeper-0.1.0.dev1/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.dev1/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.dev1/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.dev1"

depkeeper-0.1.0.dev1/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())

depkeeper-0.1.0.dev1/depkeeper/constants.py

@@ -0,0 +1,94 @@
+"""
+Centralized constants for depkeeper.
+
+This module defines immutable configuration values used across depkeeper,
+including network settings, file patterns, CLI directives, and logging
+formats. All values are intended to be treated as read-only.
+"""
+
+from typing import Final, Mapping, Sequence
+
+# ---------------------------------------------------------------------------
+# Project metadata
+# ---------------------------------------------------------------------------
+
+#: HTTP User-Agent template used for outbound requests.
+USER_AGENT_TEMPLATE: Final[str] = (
+    "depkeeper/{version} (https://github.com/rahulkaushal04/depkeeper)"
+)
+
+# ---------------------------------------------------------------------------
+# PyPI endpoints
+# ---------------------------------------------------------------------------
+
+#: Base URL for the PyPI JSON API.
+PYPI_JSON_API: Final[str] = "https://pypi.org/pypi/{package}/json"
+
+# ---------------------------------------------------------------------------
+# HTTP configuration
+# ---------------------------------------------------------------------------
+
+#: Default network timeout in seconds.
+DEFAULT_TIMEOUT: Final[int] = 30
+
+#: Maximum number of retries for failed HTTP requests.
+DEFAULT_MAX_RETRIES: Final[int] = 3
+
+# ---------------------------------------------------------------------------
+# Requirement file patterns and directives
+# ---------------------------------------------------------------------------
+
+#: Glob patterns used to detect supported requirement-related files.
+REQUIREMENT_FILE_PATTERNS: Final[Mapping[str, Sequence[str]]] = {
+    "requirements": (
+        "requirements.txt",
+        "requirements-*.txt",
+        "requirements/*.txt",
+    ),
+    "constraints": (
+        "constraints.txt",
+        "constraints-*.txt",
+    ),
+    "backup": ("*.backup",),
+}
+
+#: Short include directive for requirement files.
+INCLUDE_DIRECTIVE: Final[str] = "-r"
+
+#: Long include directive for requirement files.
+INCLUDE_DIRECTIVE_LONG: Final[str] = "--requirement"
+
+#: Short constraint directive.
+CONSTRAINT_DIRECTIVE: Final[str] = "-c"
+
+#: Long constraint directive.
+CONSTRAINT_DIRECTIVE_LONG: Final[str] = "--constraint"
+
+#: Short editable-install directive.
+EDITABLE_DIRECTIVE: Final[str] = "-e"
+
+#: Long editable-install directive.
+EDITABLE_DIRECTIVE_LONG: Final[str] = "--editable"
+
+#: Hash-checking directive.
+HASH_DIRECTIVE: Final[str] = "--hash"
+
+# ---------------------------------------------------------------------------
+# Security constraints
+# ---------------------------------------------------------------------------
+
+#: Maximum allowed file size (in bytes) when reading requirement files.
+MAX_FILE_SIZE: Final[int] = 10 * 1024 * 1024  # 10 MB
+
+# ---------------------------------------------------------------------------
+# Logging configuration
+# ---------------------------------------------------------------------------
+
+#: Timestamp format for verbose logging.
+LOG_DATE_FORMAT: Final[str] = "%Y-%m-%d %H:%M:%S"
+
+#: Default log format (non-verbose).
+LOG_DEFAULT_FORMAT: Final[str] = "%(levelname)s: %(message)s"
+
+#: Verbose log format including timestamp and logger name.
+LOG_VERBOSE_FORMAT: Final[str] = "%(asctime)s - %(name)s - %(levelname)s - %(message)s"

depkeeper-0.1.0.dev1/depkeeper/context.py

@@ -0,0 +1,37 @@
+"""
+Shared context object for depkeeper CLI commands.
+
+This module defines the global Click context used to share configuration
+and runtime options across CLI subcommands.
+"""
+
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Optional
+
+import click
+
+
+class DepKeeperContext:
+    """Global context object for depkeeper CLI commands.
+
+    An instance of this class is created once per CLI invocation and
+    passed to commands using Click's context mechanism.
+
+    Attributes:
+        config_path: Path to the depkeeper configuration file, if provided.
+        verbose: Verbosity level (0=WARNING, 1=INFO, 2+=DEBUG).
+        color: Whether colored terminal output is enabled.
+    """
+
+    __slots__ = ("config_path", "verbose", "color")
+
+    def __init__(self) -> None:
+        self.config_path: Optional[Path] = None
+        self.verbose: int = 0
+        self.color: bool = True
+
+
+#: Click decorator for injecting :class:`DepKeeperContext` into commands.
+pass_context = click.make_pass_decorator(DepKeeperContext, ensure=True)

depkeeper-0.1.0.dev1/depkeeper/exceptions.py

@@ -0,0 +1,189 @@
+"""
+Custom exception hierarchy for depkeeper.
+
+This module defines structured exception types used across depkeeper.
+All exceptions inherit from :class:`DepKeeperError` and support optional
+structured metadata via the ``details`` attribute to improve diagnostics
+and logging.
+"""
+
+from __future__ import annotations
+
+from typing import Any, Mapping, MutableMapping, Optional
+
+
+class DepKeeperError(Exception):
+    """Base exception for all depkeeper errors.
+
+    All depkeeper-specific exceptions should inherit from this class.
+    It supports structured metadata via ``details`` for richer error
+    reporting and debugging.
+
+    Args:
+        message: Human-readable error message.
+        details: Optional structured metadata describing the error.
+    """
+
+    __slots__ = ("message", "details")
+
+    def __init__(
+        self,
+        message: str,
+        details: Optional[Mapping[str, Any]] = None,
+    ) -> None:
+        self.message: str = message
+        # Internally normalize to a mutable dict
+        self.details: MutableMapping[str, Any] = dict(details) if details else {}
+        super().__init__(message)
+
+    def __str__(self) -> str:
+        if not self.details:
+            return self.message
+        formatted = ", ".join(f"{k}={v}" for k, v in self.details.items())
+        return f"{self.message} ({formatted})"
+
+    def __repr__(self) -> str:
+        return (
+            f"{self.__class__.__name__}("
+            f"message={self.message!r}, details={dict(self.details)!r})"
+        )
+
+
+def _add_if(details: MutableMapping[str, Any], key: str, value: Any) -> None:
+    """Add a key to ``details`` only if ``value`` is not ``None``."""
+    if value is not None:
+        details[key] = value
+
+
+def _truncate(text: str, max_length: int = 200) -> str:
+    """Truncate long text for safe logging or error reporting."""
+    if len(text) <= max_length:
+        return text
+    return text[:max_length] + "..."
+
+
+class ParseError(DepKeeperError):
+    """Raised when a requirements file cannot be parsed.
+
+    Args:
+        message: Error description.
+        line_number: Line number where parsing failed.
+        line_content: Raw content of the problematic line.
+        file_path: Path to the file being parsed.
+    """
+
+    __slots__ = ("line_number", "line_content", "file_path")
+
+    def __init__(
+        self,
+        message: str,
+        *,
+        line_number: Optional[int] = None,
+        line_content: Optional[str] = None,
+        file_path: Optional[str] = None,
+    ) -> None:
+        details: MutableMapping[str, Any] = {}
+        _add_if(details, "line", line_number)
+        _add_if(details, "content", line_content)
+        _add_if(details, "file", file_path)
+
+        super().__init__(message, details)
+
+        self.line_number = line_number
+        self.line_content = line_content
+        self.file_path = file_path
+
+
+class NetworkError(DepKeeperError):
+    """Raised when HTTP or network operations fail.
+
+    Args:
+        message: Error description.
+        url: URL being accessed.
+        status_code: HTTP status code, if available.
+        response_body: Raw response body, truncated for safety.
+    """
+
+    __slots__ = ("url", "status_code", "response_body")
+
+    def __init__(
+        self,
+        message: str,
+        *,
+        url: Optional[str] = None,
+        status_code: Optional[int] = None,
+        response_body: Optional[str] = None,
+    ) -> None:
+        details: MutableMapping[str, Any] = {}
+        _add_if(details, "url", url)
+        _add_if(details, "status_code", status_code)
+
+        if response_body is not None:
+            details["response"] = _truncate(response_body)
+
+        super().__init__(message, details)
+
+        self.url = url
+        self.status_code = status_code
+        self.response_body = response_body
+
+
+class PyPIError(NetworkError):
+    """Raised for failures related to the PyPI API.
+
+    Args:
+        message: Error description.
+        package_name: Name of the package involved.
+        **kwargs: Additional arguments forwarded to ``NetworkError``.
+    """
+
+    __slots__ = ("package_name",)
+
+    def __init__(
+        self,
+        message: str,
+        *,
+        package_name: Optional[str] = None,
+        **kwargs: Any,
+    ) -> None:
+        super().__init__(message, **kwargs)
+
+        self.package_name = package_name
+        if package_name is not None:
+            self.details["package"] = package_name
+
+
+class FileOperationError(DepKeeperError):
+    """Raised when file system operations fail.
+
+    Args:
+        message: Error description.
+        file_path: Path to the file involved.
+        operation: Operation being performed (read/write/delete).
+        original_error: Original exception that triggered this error.
+    """
+
+    __slots__ = ("file_path", "operation", "original_error")
+
+    def __init__(
+        self,
+        message: str,
+        *,
+        file_path: Optional[str] = None,
+        operation: Optional[str] = None,
+        original_error: Optional[Exception] = None,
+    ) -> None:
+        details: MutableMapping[str, Any] = {}
+        _add_if(details, "path", file_path)
+        _add_if(details, "operation", operation)
+        _add_if(
+            details,
+            "original_error",
+            str(original_error) if original_error else None,
+        )
+
+        super().__init__(message, details)
+
+        self.file_path = file_path
+        self.operation = operation
+        self.original_error = original_error

{depkeeper-0.1.0.dev0 → depkeeper-0.1.0.dev1}/depkeeper.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: depkeeper
-Version: 0.1.0.dev0
+Version: 0.1.0.dev1
 Summary: Modern Python dependency management for requirements.txt files
 Author: depkeeper Contributors
 License: Apache-2.0
@@ -25,18 +25,16 @@ 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: click>=8.1.8
+Requires-Dist: packaging>=23.2
 Requires-Dist: httpx>=0.24.0
-Requires-Dist: rich>=13.0.0
-Requires-Dist: pydantic>=2.0.0
+Requires-Dist: rich>=13.9.4
 Provides-Extra: dev
 Requires-Dist: pytest>=7.4.0; 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-httpx>=0.22.0; extra == "dev"
-Requires-Dist: ruff>=0.1.0; extra == "dev"
 Requires-Dist: mypy>=1.5.0; extra == "dev"
 Requires-Dist: types-setuptools; extra == "dev"
 Requires-Dist: pre-commit>=3.4.0; extra == "dev"
@@ -47,9 +45,9 @@ Requires-Dist: pytest-asyncio>=0.21.0; extra == "test"
 Requires-Dist: pytest-mock>=3.11.0; 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 🛡️🐍
 
@@ -167,7 +165,6 @@ This project is licensed under the **Apache-2.0 License** — see the [LICENSE](
 
 ## ❤️ 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)
 

{depkeeper-0.1.0.dev0 → depkeeper-0.1.0.dev1}/depkeeper.egg-info/SOURCES.txt

@@ -4,6 +4,10 @@ pyproject.toml
 depkeeper/__init__.py
 depkeeper/__main__.py
 depkeeper/__version__.py
+depkeeper/cli.py
+depkeeper/constants.py
+depkeeper/context.py
+depkeeper/exceptions.py
 depkeeper.egg-info/PKG-INFO
 depkeeper.egg-info/SOURCES.txt
 depkeeper.egg-info/dependency_links.txt

{depkeeper-0.1.0.dev0 → depkeeper-0.1.0.dev1}/depkeeper.egg-info/requires.txt

@@ -1,8 +1,7 @@
-click>=8.1.0
-packaging>=23.0
+click>=8.1.8
+packaging>=23.2
 httpx>=0.24.0
-rich>=13.0.0
-pydantic>=2.0.0
+rich>=13.9.4
 
 [dev]
 pytest>=7.4.0
@@ -10,15 +9,14 @@ pytest-cov>=4.1.0
 pytest-asyncio>=0.21.0
 pytest-mock>=3.11.0
 pytest-httpx>=0.22.0
-ruff>=0.1.0
 mypy>=1.5.0
 types-setuptools
 pre-commit>=3.4.0
 
 [docs]
-mkdocs>=1.5.0
-mkdocs-material>=9.4.0
-mkdocstrings[python]>=0.23.0
+mkdocs>=1.6.1
+mkdocs-material>=9.7.1
+mkdocstrings[python]>=0.26.1
 
 [test]
 pytest>=7.4.0

{depkeeper-0.1.0.dev0 → depkeeper-0.1.0.dev1}/pyproject.toml

@@ -13,7 +13,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "depkeeper"
-version = "0.1.0.dev0"
+version = "0.1.0.dev1"
 description = "Modern Python dependency management for requirements.txt files"
 readme = "README.md"
 requires-python = ">=3.8"
@@ -49,11 +49,10 @@ classifiers = [
 
 # Library dependencies (minimum versions only)
 dependencies = [
-    "click>=8.1.0",
-    "packaging>=23.0",
+    "click>=8.1.8",
+    "packaging>=23.2",
     "httpx>=0.24.0",
-    "rich>=13.0.0",
-    "pydantic>=2.0.0",
+    "rich>=13.9.4",
 ]
 
 
@@ -69,7 +68,6 @@ dev = [
     "pytest-asyncio>=0.21.0",
     "pytest-mock>=3.11.0",
     "pytest-httpx>=0.22.0",
-    "ruff>=0.1.0",
     "mypy>=1.5.0",
     "types-setuptools",
     "pre-commit>=3.4.0",
@@ -82,9 +80,9 @@ test = [
     "pytest-httpx>=0.22.0",
 ]
 docs = [
-    "mkdocs>=1.5.0",
-    "mkdocs-material>=9.4.0",
-    "mkdocstrings[python]>=0.23.0",
+    "mkdocs>=1.6.1",
+    "mkdocs-material>=9.7.1",
+    "mkdocstrings[python]>=0.26.1",
 ]
 
 
@@ -119,39 +117,6 @@ packages = ["depkeeper"]
 depkeeper = ["py.typed"]
 
 
-# ============================================================
-# Ruff (formatter + linter)
-# ============================================================
-
-[tool.ruff]
-line-length = 100
-target-version = "py38"
-
-[tool.ruff.lint]
-select = [
-    "E","W","F","I","N","UP","B","C4","DTZ","T10","EM","ISC",
-    "ICN","G","PIE","T20","PT","Q","RSE","RET","SIM","TID",
-    "TCH","ARG","PTH","ERA","PL","TRY","RUF"
-]
-ignore = [
-    "E501",      # line too long (handled by formatter)
-    "ERA001",    # commented-out code
-    "PLC0415",   # import at top-level (allow lazy imports)
-    "PLR0913",   # too many arguments
-    "TRY003",    # avoid long exception messages
-]
-
-[tool.ruff.lint.per-file-ignores]
-"tests/**/*.py" = [
-    "PLR2004",   # magic numbers in tests
-    "S101",      # assert usage
-    "ARG",       # unused args OK in fixtures
-]
-
-[tool.ruff.lint.isort]
-known-first-party = ["depkeeper"]
-
-
 # ============================================================
 # Mypy configuration
 # ============================================================
@@ -201,6 +166,7 @@ markers = [
     "integration: integration tests",
     "e2e: end-to-end tests",
     "network: tests requiring network",
+    "asyncio: asyncio tests",
 ]
 
 asyncio_mode = "auto"

depkeeper-0.1.0.dev0/depkeeper/__init__.py

@@ -1,43 +0,0 @@
-"""
-depkeeper — Modern Python Dependency Management Tool
-
-depkeeper is an intelligent, safety-focused dependency manager that helps
-developers keep their Python environments up-to-date, secure, and
-reproducible.
-
-Features include:
-    • Smart dependency updates with semantic versioning
-    • Security vulnerability scanning (OSV / PyPA)
-    • Lock file generation for reproducible builds
-    • Dependency health scoring
-    • Multi-format support (requirements.txt, pyproject.toml, Pipfile, etc.)
-    • CI/CD integration and automation
-
-For documentation, examples, and API reference:
-    https://docs.depkeeper.dev
-"""
-
-from __future__ import annotations
-
-from depkeeper.__version__ import __version__
-
-# ---------------------------------------------------------------------------
-# Package Metadata
-# ---------------------------------------------------------------------------
-
-__author__ = "depkeeper Contributors"
-__license__ = "Apache-2.0"
-__url__ = "https://github.com/rahulkaushal04/depkeeper"
-__description__ = "Modern Python dependency management for requirements.txt and beyond."
-
-# ---------------------------------------------------------------------------
-# Public API (Phase 1+)
-#
-# Only expose stable, documented interfaces here.
-# Once core API classes are implemented, they should be exported via __all__.
-# ---------------------------------------------------------------------------
-
-__all__ = [
-    "__version__",
-    # "DepKeeperClient",   # Example (future)
-]

depkeeper-0.1.0.dev0/depkeeper/__main__.py

@@ -1,50 +0,0 @@
-"""
-Executable module for depkeeper.
-
-Running:
-    python -m depkeeper
-
-is equivalent to:
-    depkeeper
-
-This module simply forwards execution to the CLI entrypoint defined in
-`depkeeper.cli`.
-"""
-
-from __future__ import annotations
-
-import sys
-
-
-def main() -> int:
-    """
-    Main entrypoint when executing `python -m depkeeper`.
-
-    Returns:
-        Exit code returned by the CLI.
-    """
-    try:
-        # Import lazily so dependencies are only loaded during CLI use
-        from depkeeper.cli import main as cli_main
-    except ImportError as exc:
-        # CLI not implemented yet (Phase 0) or import error during development
-        sys.stderr.write("depkeeper CLI is not available yet.")
-        sys.stderr.write("This is expected during early development (Phase 0).")
-        sys.stderr.write()
-        sys.stderr.write(f"Python version : {sys.version}")
-        try:
-            from depkeeper.__version__ import __version__
-
-            sys.stderr.write(f"depkeeper version: {__version__}")
-        except Exception:
-            sys.stderr.write("depkeeper version: <unknown>")
-        sys.stderr.write()
-        sys.stderr.write(f"ImportError: {exc}")
-        return 0
-
-    # Execute the CLI handler
-    return cli_main()
-
-
-if __name__ == "__main__":
-    sys.exit(main())

depkeeper-0.1.0.dev0/depkeeper/__version__.py

@@ -1,72 +0,0 @@
-"""
-depkeeper version information.
-
-This module provides a single source of truth for the package version.
-It follows Semantic Versioning: https://semver.org/
-
-Version format:
-    MAJOR.MINOR.PATCH[-PRERELEASE][+BUILD]
-
-Examples:
-    0.1.0
-    0.1.0.dev0
-    1.0.0-rc1
-"""
-
-from __future__ import annotations
-
-import re
-
-# ---------------------------------------------------------------------------
-# Main version (single source of truth)
-# ---------------------------------------------------------------------------
-
-__version__ = "0.1.0.dev0"
-
-
-# ---------------------------------------------------------------------------
-# Structured version metadata
-# ---------------------------------------------------------------------------
-
-
-def _parse_version(version: str):
-    """
-    Internal helper to break a semantic version into components.
-    Avoids manual duplication and mistakes.
-
-    Returns:
-        dict: {
-            "major": int,
-            "minor": int,
-            "patch": int,
-            "prerelease": str | None,
-            "is_dev": bool,
-        }
-    """
-
-    pattern = r"^(\d+)\.(\d+)\.(\d+)(?:[.-]([a-zA-Z0-9]+))?$"
-    match = re.match(pattern, version)
-
-    if not match:
-        error_message = f"Invalid version string: {version}"
-        raise ValueError(error_message)
-
-    major, minor, patch, pre = match.groups()
-
-    return {
-        "major": int(major),
-        "minor": int(minor),
-        "patch": int(patch),
-        "prerelease": pre,
-        "is_dev": pre is not None and pre.startswith("dev"),
-    }
-
-
-VERSION_INFO = _parse_version(__version__)
-
-
-# ---------------------------------------------------------------------------
-# Human-readable version (for CLI)
-# ---------------------------------------------------------------------------
-
-VERSION_STRING = f"depkeeper {__version__}"