codedd-cli 0.1.1__py3-none-any.whl

codedd_cli/__init__.py

@@ -0,0 +1,3 @@
+"""CodeDD CLI — run code audits from your terminal."""
+
+__version__ = "0.1.1"

codedd_cli/__main__.py

@@ -0,0 +1,19 @@
+"""Allow running via ``python -m codedd_cli``."""
+
+import sys
+
+from codedd_cli.api.exceptions import CodeDDConnectionError
+from codedd_cli.cli import app
+from codedd_cli.utils.display import print_error
+
+
+def main() -> None:
+    try:
+        app()
+    except CodeDDConnectionError as e:
+        print_error(str(e))
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

codedd_cli/api/__init__.py

@@ -0,0 +1,4 @@
+from codedd_cli.api.client import CodeDDClient
+from codedd_cli.api.endpoints import Endpoints
+
+__all__ = ["CodeDDClient", "Endpoints"]

codedd_cli/api/client.py

@@ -0,0 +1,120 @@
+"""
+HTTP client for communicating with the CodeDD API.
+
+Wraps ``httpx`` with:
+    - Automatic ``X-CLI-Token`` header injection
+    - Configurable base URL from ``~/.codedd/config.toml``
+    - Retry logic with exponential back-off
+    - TLS certificate verification (enforced)
+    - Descriptive User-Agent header
+"""
+
+import time
+from typing import Any
+
+import httpx
+
+from codedd_cli import __version__
+from codedd_cli.api.exceptions import CodeDDConnectionError
+from codedd_cli.auth.token_manager import TokenManager
+from codedd_cli.config.constants import (
+    MAX_RETRIES,
+    REQUEST_TIMEOUT_SECONDS,
+    USER_AGENT_PREFIX,
+)
+from codedd_cli.config.settings import ConfigManager
+
+
+class CodeDDClient:
+    """
+    Thin HTTP client that authenticates via the ``X-CLI-Token`` header.
+
+    Usage::
+
+        client = CodeDDClient()
+        resp = client.get("/api/cli/audits/", params={"limit": 20})
+        data = resp.json()
+    """
+
+    def __init__(self, config: ConfigManager | None = None) -> None:
+        self._config = config or ConfigManager()
+        self._base_url = self._config.api_url.rstrip("/")
+        self._token = TokenManager.retrieve()
+
+        # For localhost HTTP, disable TLS verification (not applicable anyway)
+        # For HTTPS, always verify certificates
+        verify_tls = not self._base_url.startswith("http://localhost") and not self._base_url.startswith(
+            "http://127.0.0.1"
+        )
+
+        self._client = httpx.Client(
+            base_url=self._base_url,
+            headers=self._build_headers(),
+            timeout=REQUEST_TIMEOUT_SECONDS,
+            verify=verify_tls,
+            follow_redirects=True,
+        )
+
+    def _build_headers(self) -> dict[str, str]:
+        headers: dict[str, str] = {
+            "User-Agent": f"{USER_AGENT_PREFIX}/{__version__}",
+            "Accept": "application/json",
+        }
+        if self._token:
+            headers["X-CLI-Token"] = self._token
+        return headers
+
+    # ---- HTTP verbs with retry ----
+
+    def get(self, path: str, **kwargs: Any) -> httpx.Response:
+        return self._request("GET", path, **kwargs)
+
+    def post(self, path: str, **kwargs: Any) -> httpx.Response:
+        return self._request("POST", path, **kwargs)
+
+    # ---- internal ----
+
+    def _request(self, method: str, path: str, **kwargs: Any) -> httpx.Response:
+        """
+        Execute an HTTP request with automatic retries on transient errors.
+
+        Retries on 5xx responses and connection errors using exponential
+        back-off (1s, 2s, 4s …).
+        """
+        last_exc: Exception | None = None
+
+        for attempt in range(1, MAX_RETRIES + 1):
+            try:
+                resp = self._client.request(method, path, **kwargs)
+
+                # Don't retry client errors (4xx)
+                if resp.status_code < 500:
+                    return resp
+
+                # Retry on server errors
+                if attempt < MAX_RETRIES:
+                    time.sleep(2 ** (attempt - 1))
+                    continue
+
+                return resp
+
+            except httpx.RequestError as exc:
+                last_exc = exc
+                if attempt < MAX_RETRIES:
+                    time.sleep(2 ** (attempt - 1))
+                    continue
+                raise CodeDDConnectionError() from None
+
+        # Should not normally reach here, but satisfy the type checker
+        if last_exc:
+            raise CodeDDConnectionError() from None
+        raise RuntimeError("Request failed after retries")  # pragma: no cover
+
+    def close(self) -> None:
+        self._client.close()
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, *args):
+        self.close()

codedd_cli/api/endpoints.py

@@ -0,0 +1,44 @@
+"""
+Server endpoint path constants.
+
+All paths are relative to the ``api_url`` stored in the CLI config
+"""
+
+
+class Endpoints:
+    """Centralised registry of API paths consumed by the CLI."""
+
+    # Authentication
+    VERIFY_TOKEN = "/api/cli/auth/verify/"
+
+    # Audits
+    LIST_AUDITS = "/api/cli/audits/"
+
+    # Scope
+    REGISTER_SCOPE = "/api/cli/scope/register/"
+    SCOPE_FILES = "/api/cli/scope/files/"
+
+    # Audit lifecycle
+    AUDIT_CAN_START = "/api/cli/audit/can-start/"
+    AUDIT_START = "/api/cli/audit/start/"
+    AUDIT_CHECKOUT = "/api/cli/audit/checkout/"
+    AUDIT_PAYMENT_STATUS = "/api/cli/audit/payment-status/"
+
+    # Local audit execution (CLI-side file auditing)
+    AUDIT_PLAN = "/api/cli/audit/plan/"
+    AUDIT_RESULTS = "/api/cli/audit/results/"
+    AUDIT_COMPLETE = "/api/cli/audit/complete/"
+
+    # Local complexity analysis results
+    AUDIT_COMPLEXITY = "/api/cli/audit/complexity/"
+
+    # Local dependency scanning
+    AUDIT_DEPENDENCY_CONFIG = "/api/cli/audit/dependency-config/"
+    AUDIT_DEPENDENCIES = "/api/cli/audit/dependencies/"
+
+    # Local git statistics (for CLI-driven audits; enables dashboards)
+    AUDIT_GIT_STATISTICS = "/api/cli/audit/git-statistics/"
+    AUDIT_VULNERABILITY_VALIDATION = "/api/cli/audit/vulnerability-validation/"
+
+    # Architecture analysis (Phase 1+2 run locally; server runs Phase 3 + storage)
+    AUDIT_ARCHITECTURE = "/api/cli/audit/architecture/"

codedd_cli/api/exceptions.py

@@ -0,0 +1,24 @@
+"""
+API-layer exceptions with user-facing messages.
+
+Raised when the CLI cannot reach the CodeDD server (connection refused,
+timeout, server disconnected, etc.). Handled at the CLI entry point to
+display a single, clear message instead of a full traceback.
+"""
+
+# Pre-defined message shown when the remote is not responding.
+CONNECTION_ERROR_MESSAGE = (
+    "Unable to reach CodeDD. "
+    "Check that the server is running and your network connection is available, "
+    "or try again later."
+)
+
+
+class CodeDDConnectionError(Exception):
+    """
+    Raised when a request to the CodeDD API fails due to connection
+    or transport errors (e.g. server not responding, timeout, disconnect).
+    """
+
+    def __init__(self, message: str | None = None) -> None:
+        super().__init__(message or CONNECTION_ERROR_MESSAGE)

codedd_cli/auditor/__init__.py

@@ -0,0 +1,6 @@
+"""
+Local audit execution package.
+
+Contains the logic for running file-level audits locally via LLM APIs,
+parsing structured responses, and submitting results to CodeDD.
+"""