cartograph-python 0.2.0__cp38-abi3-win_amd64.whl

cartograph/__init__.py

@@ -0,0 +1,69 @@
+"""Cartograph: High-performance code graph engine and graph data science SDK."""
+from __future__ import annotations
+
+from cartograph.aio import AsyncCodeGraph
+from cartograph.codegraph import CodeGraph
+from cartograph.models import (
+    AnalysisError,
+    BoundaryViolation,
+    BusinessRule,
+    CartographError,
+    ComplexityRecord,
+    ComplexityReport,
+    DatabaseError,
+    DeadCodeReport,
+    DeadSymbolItem,
+    DependencyCycle,
+    DiagnosisReport,
+    DiagramResult,
+    Edge,
+    FaultCandidate,
+    GraphStats,
+    GraphStreamer,
+    ImpactResult,
+    ImpactRoot,
+    IndexStats,
+    LintArchReport,
+    LocateResult,
+    LogicReport,
+    Node,
+    RouteTrace,
+    SelectedTest,
+    SymbolNotFoundError,
+    TestSelectorResult,
+)
+
+__version__ = "0.2.0"
+
+__all__ = [
+    "__version__",
+    "CodeGraph",
+    "AsyncCodeGraph",
+    "CartographError",
+    "SymbolNotFoundError",
+    "DatabaseError",
+    "AnalysisError",
+    "Node",
+    "Edge",
+    "GraphStats",
+    "GraphStreamer",
+    "IndexStats",
+    "LocateResult",
+    "ImpactResult",
+    "ImpactRoot",
+    "TestSelectorResult",
+    "SelectedTest",
+    "RouteTrace",
+    "LintArchReport",
+    "BoundaryViolation",
+    "DependencyCycle",
+    "ComplexityReport",
+    "ComplexityRecord",
+    "DeadCodeReport",
+    "DeadSymbolItem",
+    "LogicReport",
+    "BusinessRule",
+    "DiagnosisReport",
+    "FaultCandidate",
+    "DiagramResult",
+]

cartograph/__init__.pyi

@@ -0,0 +1,483 @@
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Any, Literal, Mapping
+
+import networkx as nx
+import igraph as ig
+import pandas as pd
+import polars as pl
+
+__version__: str
+
+class CartographError(Exception): ...
+class SymbolNotFoundError(CartographError): ...
+class DatabaseError(CartographError): ...
+class AnalysisError(CartographError): ...
+
+class Node:
+    @property
+    def id(self) -> str: ...
+    @property
+    def name(self) -> str: ...
+    @property
+    def kind(self) -> str: ...
+    @property
+    def filepath(self) -> str: ...
+    @property
+    def scope(self) -> str: ...
+    @property
+    def start_line(self) -> int | None: ...
+    @property
+    def end_line(self) -> int | None: ...
+    @property
+    def signature(self) -> str | None: ...
+    def to_dict(self) -> dict[str, Any]: ...
+
+class Edge:
+    @property
+    def source(self) -> str: ...
+    @property
+    def target(self) -> str: ...
+    @property
+    def kind(self) -> str: ...
+    @property
+    def confidence(self) -> float: ...
+    def to_dict(self) -> dict[str, Any]: ...
+
+class GraphStats:
+    @property
+    def total_nodes(self) -> int: ...
+    @property
+    def total_edges(self) -> int: ...
+    @property
+    def file_count(self) -> int: ...
+    @property
+    def node_kinds(self) -> dict[str, int]: ...
+    @property
+    def edge_kinds(self) -> dict[str, int]: ...
+    def to_dict(self) -> dict[str, Any]: ...
+
+class IndexStats:
+    @property
+    def files_indexed(self) -> int: ...
+    @property
+    def nodes_added(self) -> int: ...
+    @property
+    def edges_added(self) -> int: ...
+    @property
+    def elapsed_ms(self) -> float: ...
+    def to_dict(self) -> dict[str, Any]: ...
+
+class LocateResult:
+    @property
+    def nodes(self) -> list[Node]: ...
+    @property
+    def edges(self) -> list[Edge]: ...
+    @property
+    def root_id(self) -> str: ...
+    @property
+    def rendered_output(self) -> str: ...
+    @property
+    def elapsed_ms(self) -> float: ...
+    def to_dict(self) -> dict[str, Any]: ...
+
+class ImpactRoot:
+    @property
+    def target(self) -> str: ...
+    @property
+    def node_id(self) -> str: ...
+    @property
+    def upstream_nodes(self) -> list[Node]: ...
+    @property
+    def affected_files(self) -> list[str]: ...
+    @property
+    def risk_score(self) -> float: ...
+    @property
+    def risk_level(self) -> str: ...
+    def to_dict(self) -> dict[str, Any]: ...
+
+class ImpactResult:
+    @property
+    def roots(self) -> list[ImpactRoot]: ...
+    @property
+    def total_affected_files(self) -> int: ...
+    @property
+    def overall_risk_score(self) -> float: ...
+    @property
+    def overall_risk_level(self) -> str: ...
+    def to_dict(self) -> dict[str, Any]: ...
+
+class SelectedTest:
+    @property
+    def test_id(self) -> str: ...
+    @property
+    def test_name(self) -> str: ...
+    @property
+    def test_file(self) -> str: ...
+    @property
+    def confidence(self) -> float: ...
+    @property
+    def hop_distance(self) -> int: ...
+    def to_dict(self) -> dict[str, Any]: ...
+
+class TestSelectorResult:
+    @property
+    def tests(self) -> list[SelectedTest]: ...
+    @property
+    def total_tests_selected(self) -> int: ...
+    @property
+    def affected_targets(self) -> list[str]: ...
+    def to_dict(self) -> dict[str, Any]: ...
+
+class RouteTrace:
+    @property
+    def method(self) -> str: ...
+    @property
+    def path(self) -> str: ...
+    @property
+    def route_id(self) -> str: ...
+    @property
+    def downstream_hops(self) -> int: ...
+    @property
+    def auth_kind(self) -> str | None: ...
+    def to_dict(self) -> dict[str, Any]: ...
+
+class BoundaryViolation:
+    @property
+    def source_module(self) -> str: ...
+    @property
+    def target_module(self) -> str: ...
+    @property
+    def rule_name(self) -> str: ...
+    @property
+    def severity(self) -> str: ...
+    @property
+    def message(self) -> str: ...
+    def to_dict(self) -> dict[str, Any]: ...
+
+class DependencyCycle:
+    @property
+    def cycle_length(self) -> int: ...
+    @property
+    def path(self) -> list[str]: ...
+    def to_dict(self) -> dict[str, Any]: ...
+
+class LintArchReport:
+    @property
+    def passed(self) -> bool: ...
+    @property
+    def violations(self) -> list[BoundaryViolation]: ...
+    @property
+    def cycles(self) -> list[DependencyCycle]: ...
+    @property
+    def total_violations(self) -> int: ...
+    def to_dict(self) -> dict[str, Any]: ...
+
+class ComplexityRecord:
+    @property
+    def name(self) -> str: ...
+    @property
+    def filepath(self) -> str: ...
+    @property
+    def start_line(self) -> int | None: ...
+    @property
+    def end_line(self) -> int | None: ...
+    @property
+    def cyclomatic(self) -> u32: ...
+    @property
+    def cognitive(self) -> u32: ...
+    @property
+    def loc(self) -> usize: ...
+    @property
+    def hotspot_score(self) -> float: ...
+    @property
+    def is_danger_zone(self) -> bool: ...
+    def to_dict(self) -> dict[str, Any]: ...
+
+class ComplexityReport:
+    @property
+    def top_hotspots(self) -> list[ComplexityRecord]: ...
+    @property
+    def danger_zone_count(self) -> int: ...
+    @property
+    def total_analyzed_symbols(self) -> int: ...
+    def to_dict(self) -> dict[str, Any]: ...
+
+class DeadSymbolItem:
+    @property
+    def symbol_id(self) -> str: ...
+    @property
+    def name(self) -> str: ...
+    @property
+    def filepath(self) -> str: ...
+    @property
+    def kind(self) -> str: ...
+    @property
+    def confidence(self) -> float: ...
+    def to_dict(self) -> dict[str, Any]: ...
+
+class DeadCodeReport:
+    @property
+    def dead_symbols(self) -> list[DeadSymbolItem]: ...
+    @property
+    def ghost_dependencies(self) -> list[str]: ...
+    @property
+    def total_dead_loc(self) -> int: ...
+    def to_dict(self) -> dict[str, Any]: ...
+
+class BusinessRule:
+    @property
+    def name(self) -> str: ...
+    @property
+    def description(self) -> str: ...
+    @property
+    def rule_type(self) -> str: ...
+    @property
+    def target_symbol(self) -> str: ...
+    @property
+    def confidence(self) -> float: ...
+    def to_dict(self) -> dict[str, Any]: ...
+
+class LogicReport:
+    @property
+    def rules(self) -> list[BusinessRule]: ...
+    @property
+    def total_rules(self) -> int: ...
+    def to_dict(self) -> dict[str, Any]: ...
+
+class FaultCandidate:
+    @property
+    def rank(self) -> int: ...
+    @property
+    def score(self) -> float: ...
+    @property
+    def function_name(self) -> str: ...
+    @property
+    def file_path(self) -> str: ...
+    @property
+    def line_number(self) -> int: ...
+    @property
+    def explanation(self) -> str: ...
+    def to_dict(self) -> dict[str, Any]: ...
+
+class DiagnosisReport:
+    @property
+    def crash_type(self) -> str: ...
+    @property
+    def crash_message(self) -> str: ...
+    @property
+    def candidates(self) -> list[FaultCandidate]: ...
+    @property
+    def execution_mode(self) -> str: ...
+    @property
+    def execution_time_ms(self) -> float: ...
+    def to_dict(self) -> dict[str, Any]: ...
+
+class DiagramResult:
+    @property
+    def content(self) -> str: ...
+    @property
+    def format(self) -> str: ...
+    @property
+    def diagram_type(self) -> str: ...
+    @property
+    def node_count(self) -> int: ...
+    @property
+    def edge_count(self) -> int: ...
+    def to_dict(self) -> dict[str, Any]: ...
+    def _repr_html_(self) -> str: ...
+
+class CodeGraph:
+    def __init__(
+        self,
+        path: str | Path | None = ...,
+        profile: str = ...,
+        in_memory: bool = ...,
+    ) -> None: ...
+    @classmethod
+    def open(
+        cls,
+        path: str | Path | None = ...,
+        profile: str = ...,
+        in_memory: bool = ...,
+    ) -> CodeGraph: ...
+    def __enter__(self) -> CodeGraph: ...
+    def __exit__(self, exc_type: Any, exc_val: Any, exc_tb: Any) -> None: ...
+    def close(self) -> None: ...
+    @property
+    def is_open(self) -> bool: ...
+    @property
+    def profile(self) -> str: ...
+    def index(
+        self,
+        force: bool = ...,
+        staged: bool = ...,
+        branch: str | None = ...,
+        threads: int | None = ...,
+    ) -> IndexStats: ...
+    def status(self) -> GraphStats: ...
+    def locate(
+        self,
+        query: str,
+        code: bool = ...,
+        limit: int = ...,
+    ) -> LocateResult: ...
+    def impact(
+        self,
+        target: str,
+        branch: str | None = ...,
+        staged: bool = ...,
+        depth: int = ...,
+    ) -> ImpactResult: ...
+    def test_selector(
+        self,
+        target: str,
+        branch: str | None = ...,
+    ) -> TestSelectorResult: ...
+    def routes(
+        self,
+        filter_query: str | None = ...,
+    ) -> list[RouteTrace]: ...
+    def lint_arch(
+        self,
+        strict: bool = ...,
+    ) -> LintArchReport: ...
+    def complexity(
+        self,
+        top: int = ...,
+        danger_zone: bool = ...,
+    ) -> ComplexityReport: ...
+    def deadcode(
+        self,
+        min_lines: int = ...,
+    ) -> DeadCodeReport: ...
+    def extract_logic(
+        self,
+        query: str | None = ...,
+        symbol: str | None = ...,
+        concept: str | None = ...,
+        deep: bool = ...,
+    ) -> LogicReport: ...
+    def diagnose(
+        self,
+        trace_or_log: str,
+        file_path: str | None = ...,
+        deep: bool = ...,
+        offline: bool = ...,
+    ) -> DiagnosisReport: ...
+    def diagram(
+        self,
+        symbol_or_concept: str | None = ...,
+        diagram_type: str = ...,
+        format: str = ...,
+        depth: int = ...,
+        direction: str = ...,
+        max_nodes: int = ...,
+        collapse_modules: bool = ...,
+        theme: str = ...,
+    ) -> DiagramResult: ...
+    def to_networkx(self) -> nx.DiGraph: ...
+    def to_igraph(self) -> ig.Graph: ...
+    def nodes_df(self, engine: Literal["polars", "pandas"] = ...) -> Any: ...
+    def edges_df(self, engine: Literal["polars", "pandas"] = ...) -> Any: ...
+    def complexity_df(self, engine: Literal["polars", "pandas"] = ...) -> Any: ...
+    def to_polars(self) -> dict[str, pl.DataFrame]: ...
+    def to_pandas(self) -> dict[str, pd.DataFrame]: ...
+
+class AsyncCodeGraph:
+    def __init__(
+        self,
+        path: str | Path | None = ...,
+        profile: str = ...,
+        in_memory: bool = ...,
+    ) -> None: ...
+    @classmethod
+    async def open(
+        cls,
+        path: str | Path | None = ...,
+        profile: str = ...,
+        in_memory: bool = ...,
+    ) -> AsyncCodeGraph: ...
+    async def __aenter__(self) -> AsyncCodeGraph: ...
+    async def __aexit__(self, exc_type: Any, exc_val: Any, exc_tb: Any) -> None: ...
+    async def close(self) -> None: ...
+    @property
+    def is_open(self) -> bool: ...
+    @property
+    def profile(self) -> str: ...
+    async def index(
+        self,
+        force: bool = ...,
+        staged: bool = ...,
+        branch: str | None = ...,
+        threads: int | None = ...,
+    ) -> IndexStats: ...
+    async def status(self) -> GraphStats: ...
+    async def locate(
+        self,
+        query: str,
+        code: bool = ...,
+        limit: int = ...,
+    ) -> LocateResult: ...
+    async def impact(
+        self,
+        target: str,
+        branch: str | None = ...,
+        staged: bool = ...,
+        depth: int = ...,
+    ) -> ImpactResult: ...
+    async def test_selector(
+        self,
+        target: str,
+        branch: str | None = ...,
+    ) -> TestSelectorResult: ...
+    async def routes(
+        self,
+        filter_query: str | None = ...,
+    ) -> list[RouteTrace]: ...
+    async def lint_arch(
+        self,
+        strict: bool = ...,
+    ) -> LintArchReport: ...
+    async def complexity(
+        self,
+        top: int = ...,
+        danger_zone: bool = ...,
+    ) -> ComplexityReport: ...
+    async def deadcode(
+        self,
+        min_lines: int = ...,
+    ) -> DeadCodeReport: ...
+    async def extract_logic(
+        self,
+        query: str | None = ...,
+        symbol: str | None = ...,
+        concept: str | None = ...,
+        deep: bool = ...,
+    ) -> LogicReport: ...
+    async def diagnose(
+        self,
+        trace_or_log: str,
+        file_path: str | None = ...,
+        deep: bool = ...,
+        offline: bool = ...,
+    ) -> DiagnosisReport: ...
+    async def diagram(
+        self,
+        symbol_or_concept: str | None = ...,
+        diagram_type: str = ...,
+        format: str = ...,
+        depth: int = ...,
+        direction: str = ...,
+        max_nodes: int = ...,
+        collapse_modules: bool = ...,
+        theme: str = ...,
+    ) -> DiagramResult: ...
+    async def to_networkx(self) -> nx.DiGraph: ...
+    async def to_igraph(self) -> ig.Graph: ...
+    async def nodes_df(self, engine: Literal["polars", "pandas"] = ...) -> Any: ...
+    async def edges_df(self, engine: Literal["polars", "pandas"] = ...) -> Any: ...
+    async def complexity_df(self, engine: Literal["polars", "pandas"] = ...) -> Any: ...
+    async def to_polars(self) -> dict[str, pl.DataFrame]: ...
+    async def to_pandas(self) -> dict[str, pd.DataFrame]: ...