complexipy 5.3.0__tar.gz → 5.4.1__tar.gz

{complexipy-5.3.0 → complexipy-5.4.1}/Cargo.lock

@@ -113,7 +113,7 @@ dependencies = [
 
 [[package]]
 name = "complexipy"
-version = "5.3.0"
+version = "5.4.1"
 dependencies = [
  "console_error_panic_hook",
  "csv",

{complexipy-5.3.0 → complexipy-5.4.1}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "complexipy"
-version = "5.3.0"
+version = "5.4.1"
 edition = "2024"
 authors = ["Robin Quintero <rohaquinlop301@gmail.com>"]
 license = "MIT"

{complexipy-5.3.0 → complexipy-5.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: complexipy
-Version: 5.3.0
+Version: 5.4.1
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
@@ -18,12 +18,9 @@ Classifier: Topic :: Software Development :: Testing
 Classifier: Topic :: Software Development :: Libraries
 Requires-Dist: tomli>=2.2.1
 Requires-Dist: typer>=0.12.5
-Requires-Dist: ruff>=0.9.0 ; extra == 'dev'
-Requires-Dist: ty>=0.0.1a1 ; extra == 'dev'
-Provides-Extra: dev
 License-File: LICENSE
 Summary: An extremely fast Python library to calculate the cognitive complexity of Python files, written in Rust.
-Keywords: cognitive,complexity,cognitive complexity,quality,quality assurance,testing,libraries,performance
+Keywords: maintainability,usability,DevEx tools,cognitive,complexity,cognitive complexity,quality,quality assurance,libraries,performance,static analysis,code quality,technical debt,refactoring,CI/CD,fast
 Home-Page: https://github.com/rohaquinlop/complexipy
 Author-email: Robin Quintero <rohaquinlop301@gmail.com>
 License: MIT
@@ -50,7 +47,8 @@ Project-URL: Repository, https://github.com/rohaquinlop/complexipy
     <a href="#installation">Installation</a> •
     <a href="#quick-start">Quick Start</a> •
     <a href="#integrations">Integrations</a> •
-    <a href="https://rohaquinlop.github.io/complexipy/">Documentation</a>
+    <a href="https://rohaquinlop.github.io/complexipy/">Documentation</a> •
+    <a href="https://www.complexipy-teams.com/">Complexipy Teams</a>
   </p>
 </div>
 
@@ -398,6 +396,7 @@ code_complexity(source: str, check_script: bool = False) -> CodeComplexity
 # Return types
 FileComplexity:
   ├─ path: str
+  ├─ file_name: str
   ├─ complexity: int
   └─ functions: List[FunctionComplexity]
 
@@ -405,7 +404,16 @@ FunctionComplexity:
   ├─ name: str
   ├─ complexity: int
   ├─ line_start: int
-  └─ line_end: int
+  ├─ line_end: int
+  └─ line_complexities: List[LineComplexity]
+
+LineComplexity:
+  ├─ line: int
+  └─ complexity: int
+
+CodeComplexity:
+  ├─ complexity: int
+  └─ functions: List[FunctionComplexity]
 ```
 
 ---

{complexipy-5.3.0 → complexipy-5.4.1}/README.md

@@ -15,7 +15,8 @@
     <a href="#installation">Installation</a> •
     <a href="#quick-start">Quick Start</a> •
     <a href="#integrations">Integrations</a> •
-    <a href="https://rohaquinlop.github.io/complexipy/">Documentation</a>
+    <a href="https://rohaquinlop.github.io/complexipy/">Documentation</a> •
+    <a href="https://www.complexipy-teams.com/">Complexipy Teams</a>
   </p>
 </div>
 
@@ -363,6 +364,7 @@ code_complexity(source: str, check_script: bool = False) -> CodeComplexity
 # Return types
 FileComplexity:
   ├─ path: str
+  ├─ file_name: str
   ├─ complexity: int
   └─ functions: List[FunctionComplexity]
 
@@ -370,7 +372,16 @@ FunctionComplexity:
   ├─ name: str
   ├─ complexity: int
   ├─ line_start: int
-  └─ line_end: int
+  ├─ line_end: int
+  └─ line_complexities: List[LineComplexity]
+
+LineComplexity:
+  ├─ line: int
+  └─ complexity: int
+
+CodeComplexity:
+  ├─ complexity: int
+  └─ functions: List[FunctionComplexity]
 ```
 
 ---

{complexipy-5.3.0 → complexipy-5.4.1}/complexipy/_complexipy.pyi

@@ -262,7 +262,10 @@ class CodeComplexity:
     ) -> None: ...
 
 def main(
-    paths: List[str], quiet: bool, exclude: List[str], check_script: bool = False
+    paths: List[str],
+    quiet: bool,
+    exclude: List[str],
+    check_script: bool = False,
 ) -> Tuple[List[FileComplexity], List[str]]:
     """
     Analyze cognitive complexity of Python files and directories.
@@ -355,7 +358,9 @@ def code_complexity(code: str, check_script: bool = False) -> CodeComplexity:
     """
     ...
 
-def file_complexity(file_path: str, base_path: str, check_script: bool = False) -> FileComplexity:
+def file_complexity(
+    file_path: str, base_path: str, check_script: bool = False
+) -> FileComplexity:
     """
     Analyze cognitive complexity of a single Python source file.
 

{complexipy-5.3.0 → complexipy-5.4.1}/complexipy/main.py

@@ -23,56 +23,48 @@ from complexipy import (
 )
 from complexipy._complexipy import FileComplexity
 
-from .types import (
+from complexipy.types import (
     ColorTypes,
     OutputFormat,
     Sort,
 )
-from .utils.cache import remember_previous_functions
-from .utils.csv import store_csv
-from .utils.diff import DiffEntry, compute_diff, format_diff, has_regressions
-from .utils.gitlab import store_gitlab
-from .utils.json import store_json
-from .utils.output import (
+from complexipy.utils.cache import remember_previous_functions
+from complexipy.utils.csv import store_csv
+from complexipy.utils.diff import (
+    DiffEntry,
+    compute_diff,
+    format_diff,
+    has_regressions,
+)
+from complexipy.utils.gitlab import store_gitlab
+from complexipy.utils.json import store_json
+from complexipy.utils.output import (
     has_success_functions,
     output_summary,
     print_invalid_paths,
 )
-from .utils.sarif import store_sarif
-from .utils.snapshot import (
+from complexipy.utils.sarif import store_sarif
+from complexipy.utils.snapshot import (
     build_snapshot_map,
     handle_snapshot_file_creation,
     handle_snapshot_functions_load,
     handle_snapshot_watermark,
 )
-from .utils.toml import (
+from complexipy.utils.toml import (
     get_argument_value,
     get_arguments_value,
     get_complexipy_toml_config,
 )
+from complexipy.utils.constants import (
+    DEFAULT_OUTPUT_FILENAMES,
+    LEGACY_OUTPUT_CONFIG_KEYS,
+    LEGACY_OUTPUT_FLAGS,
+)
 
 app = typer.Typer(name="complexipy")
 console = Console(color_system="auto")
 INVOCATION_PATH = os.getcwd()
 TOML_CONFIG = get_complexipy_toml_config(INVOCATION_PATH)
-DEFAULT_OUTPUT_FILENAMES = {
-    OutputFormat.csv: "complexipy-results.csv",
-    OutputFormat.json: "complexipy-results.json",
-    OutputFormat.gitlab: "complexipy-results.gitlab.json",
-    OutputFormat.sarif: "complexipy-results.sarif",
-}
-LEGACY_OUTPUT_FLAGS = {
-    OutputFormat.csv: "--output-csv",
-    OutputFormat.json: "--output-json",
-    OutputFormat.gitlab: "--output-gitlab",
-    OutputFormat.sarif: "--output-sarif",
-}
-LEGACY_OUTPUT_CONFIG_KEYS = {
-    OutputFormat.csv: "output-csv",
-    OutputFormat.json: "output-json",
-    OutputFormat.gitlab: "output-gitlab",
-    OutputFormat.sarif: "output-sarif",
-}
 
 
 def _version_callback(value: bool):
@@ -164,18 +156,18 @@ def main(
         None,
         "--output-csv",
         "-c",
-        help="Output the results to a CSV file.",
+        help="Deprecated. Use `--output-format csv` instead. Output the results to a CSV file.",
     ),
     output_json: Optional[bool] = typer.Option(
         None,
         "--output-json",
         "-j",
-        help="Output the results to a JSON file.",
+        help="Deprecated. Use `--output-format json` instead. Output the results to a JSON file.",
     ),
     output_gitlab: Optional[bool] = typer.Option(
         None,
         "--output-gitlab",
-        help="Output the results as a GitLab Code Quality JSON report.",
+        help="Deprecated. Use `--output-format gitlab` instead. Output the results as a GitLab Code Quality JSON report.",
     ),
     diff: Optional[str] = typer.Option(
         None,
@@ -281,8 +273,6 @@ def main(
     ratchet = bool(get_argument_value(TOML_CONFIG, "ratchet", ratchet, False))
     validate_ratchet(ratchet, diff)
 
-    # --plain is intentionally CLI-only (not resolved via TOML) because it is
-    # a session-level display preference, not a project-wide default.
     if plain is None:
         plain = False
 
@@ -364,9 +354,6 @@ def main(
         watermark_success,
     )
     if should_run_snapshot_watermark:
-        # When the snapshot watermark is active, it is the authoritative
-        # success check. Functions exceeding the threshold that are already
-        # in the snapshot (and haven't regressed) should not cause a failure.
         has_success = snapshot_result
     else:
         has_success = has_success and snapshot_result
@@ -505,8 +492,8 @@ def emit_deprecated_output_warnings(
         if legacy_cli_output_flags[output_format]:
             console.print(
                 f"[yellow]Deprecated:[/yellow] {flag_name} will be removed "
-                f"in a future release. Use --output-format "
-                f"{output_format.value} instead."
+                f"in a future release. Use `--output-format "
+                f"{output_format.value}` instead."
             )
 
     if toml_config is None:

complexipy-5.4.1/complexipy/utils/constants.py

@@ -0,0 +1,20 @@
+from complexipy.types import OutputFormat
+
+DEFAULT_OUTPUT_FILENAMES = {
+    OutputFormat.csv: "complexipy-results.csv",
+    OutputFormat.json: "complexipy-results.json",
+    OutputFormat.gitlab: "complexipy-results.gitlab.json",
+    OutputFormat.sarif: "complexipy-results.sarif",
+}
+LEGACY_OUTPUT_FLAGS = {
+    OutputFormat.csv: "--output-csv",
+    OutputFormat.json: "--output-json",
+    OutputFormat.gitlab: "--output-gitlab",
+    OutputFormat.sarif: "--output-sarif",
+}
+LEGACY_OUTPUT_CONFIG_KEYS = {
+    OutputFormat.csv: "output-csv",
+    OutputFormat.json: "output-json",
+    OutputFormat.gitlab: "output-gitlab",
+    OutputFormat.sarif: "output-sarif",
+}

{complexipy-5.3.0 → complexipy-5.4.1}/docs/es/index.md

@@ -15,7 +15,8 @@
     <a href="#instalación">Instalación</a> •
     <a href="#inicio-rápido">Inicio Rápido</a> •
     <a href="#integraciones">Integraciones</a> •
-    <a href="https://rohaquinlop.github.io/complexipy/">Documentación</a>
+    <a href="https://rohaquinlop.github.io/complexipy/">Documentación</a> •
+    <a href="https://www.complexipy-teams.com/">Complexipy Teams</a>
   </p>
 </div>
 
@@ -321,6 +322,7 @@ code_complexity(source: str, check_script: bool = False) -> CodeComplexity
 # Tipos de retorno
 FileComplexity:
   ├─ path: str
+  ├─ file_name: str
   ├─ complexity: int
   └─ functions: List[FunctionComplexity]
 
@@ -328,7 +330,16 @@ FunctionComplexity:
   ├─ name: str
   ├─ complexity: int
   ├─ line_start: int
-  └─ line_end: int
+  ├─ line_end: int
+  └─ line_complexities: List[LineComplexity]
+
+LineComplexity:
+  ├─ line: int
+  └─ complexity: int
+
+CodeComplexity:
+  ├─ complexity: int
+  └─ functions: List[FunctionComplexity]
 ```
 
 ---

{complexipy-5.3.0 → complexipy-5.4.1}/docs/es/usage-guide.md

@@ -65,7 +65,7 @@ complexipy . --top 10
 Cuando se usa `--top`, los resultados se reordenan globalmente por complejidad
 descendente antes de truncarse.
 
-Suprimir toda la salida (útil para pipelines de CI):
+Suprimir la salida del análisis (útil para pipelines de CI):
 
 ```bash
 complexipy . --quiet
@@ -104,7 +104,7 @@ complexipy . --exclude src/legacy/old_code.py
 
 ### Formatos de Salida
 
-Guarda los resultados en JSON o CSV:
+Guarda los resultados en JSON, CSV, GitLab Code Quality o SARIF:
 
 ```bash
 # Salida JSON (guardada en complexipy-results.json)
@@ -198,25 +198,18 @@ fuera de las funciones.
 **Estructura de Salida JSON:**
 
 ```json
-{
-    "files": [
-        {
-            "path": "src/main.py",
-            "complexity": 42,
-            "functions": [
-                {
-                    "name": "process_data",
-                    "complexity": 18,
-                    "line_start": 10,
-                    "line_end": 45
-                }
-            ]
-        }
-    ],
-    "total_complexity": 42
-}
+[
+    {
+        "path": "src",
+        "file_name": "main.py",
+        "function_name": "process_data",
+        "complexity": 18
+    }
+]
 ```
 
+Las salidas JSON y CSV contienen una entrada por cada función emitida. Los rangos de líneas están disponibles mediante la API de Python (`line_start`, `line_end`), pero no se incluyen en las salidas JSON/CSV legibles por máquina de la CLI.
+
 ### Salida en Color
 
 Controla la salida en color:
@@ -487,19 +480,22 @@ complexipy . --snapshot-ignore
 ### Formato del Archivo de snapshot
 
 ```json
-{
-    "version": "1.0",
-    "threshold": 15,
-    "functions": {
-        "src/legacy.py::old_function": {
-            "complexity": 23,
-            "line_start": 10,
-            "line_end": 50
-        }
+[
+    {
+        "path": "src",
+        "file_name": "legacy.py",
+        "functions": [
+            {
+                "name": "old_function",
+                "complexity": 23
+            }
+        ]
     }
-}
+]
 ```
 
+Los snapshots se guardan como un arreglo JSON de archivos analizados. Cada entrada contiene solo las funciones por encima del umbral cuando se escribió el snapshot. El archivo se reescribe después de verificaciones de snapshot exitosas, así que las funciones que mejoran se eliminan automáticamente. Es posible que los snapshots creados por versiones anteriores de complexipy deban regenerarse con `--snapshot-create`.
+
 ## Ignorar en Línea
 
 Suprime las advertencias de complejidad para funciones específicas usando el comentario `# complexipy: ignore`:
@@ -546,7 +542,7 @@ Usa la acción oficial:
   with:
       paths: src tests
       max_complexity_allowed: 15
-      output_json: true
+      output_format: json
 ```
 
 O ejecuta directamente:

{complexipy-5.3.0 → complexipy-5.4.1}/docs/index.md

@@ -15,7 +15,8 @@
     <a href="#installation">Installation</a> •
     <a href="#quick-start">Quick Start</a> •
     <a href="#integrations">Integrations</a> •
-    <a href="https://rohaquinlop.github.io/complexipy/">Documentation</a>
+    <a href="https://rohaquinlop.github.io/complexipy/">Documentation</a> •
+    <a href="https://www.complexipy-teams.com/">Complexipy Teams</a>
   </p>
 </div>
 
@@ -321,6 +322,7 @@ code_complexity(source: str, check_script: bool = False) -> CodeComplexity
 # Return types
 FileComplexity:
   ├─ path: str
+  ├─ file_name: str
   ├─ complexity: int
   └─ functions: List[FunctionComplexity]
 
@@ -328,7 +330,16 @@ FunctionComplexity:
   ├─ name: str
   ├─ complexity: int
   ├─ line_start: int
-  └─ line_end: int
+  ├─ line_end: int
+  └─ line_complexities: List[LineComplexity]
+
+LineComplexity:
+  ├─ line: int
+  └─ complexity: int
+
+CodeComplexity:
+  ├─ complexity: int
+  └─ functions: List[FunctionComplexity]
 ```
 
 ---

{complexipy-5.3.0 → complexipy-5.4.1}/docs/usage-guide.md

@@ -65,7 +65,7 @@ complexipy . --top 10
 When `--top` is set, results are globally re-sorted by complexity descending
 before truncation.
 
-Suppress all output (useful for CI pipelines):
+Suppress analysis output (useful for CI pipelines):
 
 ```bash
 complexipy . --quiet
@@ -201,25 +201,18 @@ functions.
 **JSON Output Structure:**
 
 ```json
-{
-    "files": [
-        {
-            "path": "src/main.py",
-            "complexity": 42,
-            "functions": [
-                {
-                    "name": "process_data",
-                    "complexity": 18,
-                    "line_start": 10,
-                    "line_end": 45
-                }
-            ]
-        }
-    ],
-    "total_complexity": 42
-}
+[
+    {
+        "path": "src",
+        "file_name": "main.py",
+        "function_name": "process_data",
+        "complexity": 18
+    }
+]
 ```
 
+The JSON and CSV outputs contain one entry per emitted function. Line ranges are available through the Python API (`line_start`, `line_end`), but are not included in the machine-readable CLI JSON/CSV outputs.
+
 ### Color Output
 
 Control color output:
@@ -490,19 +483,22 @@ Use this when:
 ### Snapshot File Format
 
 ```json
-{
-    "version": "1.0",
-    "threshold": 15,
-    "functions": {
-        "src/legacy.py::old_function": {
-            "complexity": 23,
-            "line_start": 10,
-            "line_end": 50
-        }
+[
+    {
+        "path": "src",
+        "file_name": "legacy.py",
+        "functions": [
+            {
+                "name": "old_function",
+                "complexity": 23
+            }
+        ]
     }
-}
+]
 ```
 
+Snapshots are stored as a JSON array of analyzed files. Each entry contains only functions above the threshold at the time the snapshot was written. The file is rewritten after successful snapshot checks, so improved functions are removed automatically. Snapshots created by older complexipy versions may need to be regenerated with `--snapshot-create`.
+
 ## Inline Ignores
 
 Suppress complexity warnings for specific functions using the `# complexipy: ignore` comment:
@@ -549,7 +545,7 @@ Use the official action:
   with:
       paths: src tests
       max_complexity_allowed: 15
-      output_json: true
+      output_format: json
 ```
 
 Or run directly:

{complexipy-5.3.0 → complexipy-5.4.1}/pyproject.toml

@@ -9,14 +9,22 @@ readme = "README.md"
 license = { text = "MIT" }
 authors = [{name = "Robin Quintero", email = "rohaquinlop301@gmail.com"}]
 keywords = [
+    "maintainability",
+    "usability",
+    "DevEx tools",
     "cognitive",
     "complexity",
     "cognitive complexity",
     "quality",
     "quality assurance",
-    "testing",
     "libraries",
     "performance",
+    "static analysis",
+    "code quality",
+    "technical debt",
+    "refactoring",
+    "CI/CD",
+    "fast",
 ]
 requires-python = ">=3.8"
 classifiers = [
@@ -74,12 +82,6 @@ indent-width = 4
 [tool.ty.src]
 exclude = ["tests"]
 
-[project.optional-dependencies]
-dev = [
-    "ruff>=0.9.0",
-    "ty>=0.0.1a1",
-]
-
 [dependency-groups]
 dev = [
     "maturin>=1.8.3",
@@ -89,3 +91,9 @@ dev = [
     "ruff>=0.9.0",
     "ty>=0.0.1a1",
 ]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py", "main.py"]
+python_functions = ["test_*"]
+norecursedirs = ["tests/src"]

{complexipy-5.3.0 → complexipy-5.4.1}/src/classes.rs

@@ -24,21 +24,24 @@ pub struct LineComplexity {
 pub struct FunctionComplexity {
     pub name: String,
     pub complexity: u64,
+    #[cfg_attr(feature = "python", serde(skip))]
     pub line_start: u64,
+    #[cfg_attr(feature = "python", serde(skip))]
     pub line_end: u64,
+    #[cfg_attr(feature = "python", serde(skip))]
     pub line_complexities: Vec<LineComplexity>,
 }
 
-#[cfg_attr(feature = "python", pyclass(module = "complexipy", get_all))]
 #[cfg_attr(
-    any(feature = "python", feature = "wasm"),
-    derive(Serialize, Deserialize)
+    feature = "python",
+    pyclass(module = "complexipy", get_all),
+    derive(Serialize, Deserialize, Clone)
 )]
-#[derive(Clone)]
 pub struct FileComplexity {
     pub path: String,
     pub file_name: String,
     pub functions: Vec<FunctionComplexity>,
+    #[cfg_attr(feature = "python", serde(skip))]
     pub complexity: u64,
 }
 
@@ -51,4 +54,6 @@ pub struct FileComplexity {
 pub struct CodeComplexity {
     pub functions: Vec<FunctionComplexity>,
     pub complexity: u64,
+    #[cfg(feature = "wasm")]
+    pub version: String,
 }