phi-complexity 0.1.0__tar.gz

phi_complexity-0.1.0/LICENSE

@@ -0,0 +1,28 @@
+MIT License
+
+Copyright (c) 2026 Tomy Verreault
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+This software is anchored in the Bibliothèque Céleste — Morphic Phi Framework (φ-Meta).
+The mathematical foundations are derived from the work of Tomy Verreault (2026),
+integrating principles from the Quasicrystal Axioms (AX-A0–AX-A58) and the
+Antifragility Protocol (EQ-AFR-BMAD).

phi_complexity-0.1.0/PKG-INFO

@@ -0,0 +1,195 @@
+Metadata-Version: 2.4
+Name: phi-complexity
+Version: 0.1.0
+Summary: Code quality metrics based on Golden Ratio (φ) mathematical invariants
+Author-email: Tomy Verreault <contact@phidelia.dev>
+License: MIT
+Project-URL: Homepage, https://github.com/spockoo/phi-complexity
+Project-URL: Repository, https://github.com/spockoo/phi-complexity
+Project-URL: Documentation, https://github.com/spockoo/phi-complexity/blob/main/docs/GUIDE.md
+Project-URL: Bug Tracker, https://github.com/spockoo/phi-complexity/issues
+Keywords: code-quality,complexity,golden-ratio,fibonacci,static-analysis,ast,phi,metrics,entropy
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# phi-complexity
+
+> *Code quality metrics based on Golden Ratio (φ) mathematical invariants*
+
+[![PyPI version](https://img.shields.io/pypi/v/phi-complexity.svg)](https://pypi.org/project/phi-complexity/)
+[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Tests](https://img.shields.io/badge/tests-26%20passed-brightgreen)](tests/)
+
+`phi-complexity` is the **first code quality library** that measures the health of your Python code using **universal mathematical invariants** derived from the Golden Ratio (φ = 1.618...).
+
+Unlike `pylint` (cultural rules) or `radon` (McCabe metrics), `phi-complexity` answers:
+
+> *"Is this code in resonance with the natural laws of order, or is it collapsing under its own entropy?"*
+
+---
+
+## ⚡ Quick Start
+
+```bash
+pip install phi-complexity
+```
+
+```bash
+# Audit a file
+phi check my_script.py
+
+# Audit a folder
+phi check ./src/
+
+# Generate a Markdown report
+phi report my_script.py --output report.md
+
+# CI/CD strict mode (exit 1 if radiance < 75)
+phi check ./src/ --min-radiance 75
+```
+
+### Python API
+
+```python
+from phi_complexity import auditer, rapport_console, rapport_markdown
+
+# Get metrics as a dict
+metrics = auditer("my_script.py")
+print(metrics["radiance"])          # → 82.4
+print(metrics["statut_gnostique"])  # → "EN ÉVEIL ◈"
+print(metrics["oudjat"])            # → {"nom": "process_data", "ligne": 42, ...}
+
+# Print console report
+print(rapport_console("my_script.py"))
+
+# Save Markdown report
+rapport_markdown("my_script.py", sortie="report.md")
+```
+
+---
+
+## 📊 Metrics
+
+| Metric | Description | Mathematical basis |
+|---|---|---|
+| **Radiance Score** | Global quality score (0–100) | `100 - f(Lilith) - g(H) - h(Anomalies) - i(Fib)` |
+| **Variance de Lilith** | Structural instability | Population variance of function complexities |
+| **Shannon Entropy** | Information density | `H = -Σ p·log₂(p)` |
+| **φ-Ratio** | Dominant function ratio | `max_complexity / mean` → should tend toward φ |
+| **Fibonacci Distance** | Natural size alignment | `Σ|n_i - Fib_k| / φ` |
+| **Zeta-Score** | Global resonance | `ζ_meta(functions, φ)` converging series |
+
+### Gnostic Status Levels
+
+| Score | Status | Meaning |
+|---|---|---|
+| ≥ 85 | **HERMÉTIQUE ✦** | Stable, harmonious, production-ready |
+| 60–84 | **EN ÉVEIL ◈** | Potential exists, some entropy zones |
+| < 60 | **DORMANT ░** | Deep restructuring recommended |
+
+---
+
+## 🔍 Sample Output
+
+```
+╔══════════════════════════════════════════════════╗
+║      PHI-COMPLEXITY — AUDIT DE RADIANCE          ║
+╚══════════════════════════════════════════════════╝
+
+  📄 Fichier : my_script.py
+  📅 Date    : 2026-04-08 17:11
+
+  ☼  RADIANCE     : ██████████████░░░░░░  72.6 / 100
+  ⚖  LILITH       : 11221.9  (Structural variance)
+  🌊 ENTROPIE     : 2.48 bits  (Shannon)
+  ◈  PHI-RATIO    : 3.43  (ideal: φ = 1.618, Δ=1.81)
+  ζ  ZETA-SCORE   : 0.3656  (Global resonance)
+
+  STATUT : EN ÉVEIL ◈
+
+  🔎 OUDJAT : 'process_data' (Line 42, Complexity: 376)
+
+  ⚠  SUTURES IDENTIFIED (2):
+  🟡 Line 18 [LILITH] : Nested loop (depth 2). Consider a helper function.
+     >> for j in range(b):
+  🔵 Line 67 [SOUVERAINETE] : 'load_data' receives 6 arguments. Encapsulate in an object.
+     >> def load_data(path, sep, enc, cols, dtype, na):
+```
+
+---
+
+## 🧮 Mathematical Foundations
+
+The **Radiance Formula** is derived from:
+
+- **φ-Meta Framework** (Tomy Verreault, 2026) — Axioms AX-A0 through AX-A58
+- **Law of Antifragility** (EQ-AFR-BMAD): `φ_{t+1} = P_φ(φ_t + k·Var(E_t)·E_t)`
+- **Cybernetics** (Korchounov, Mir, 1975) — Feedback and variance as control metrics
+- **Shannon Information Theory** — Code as an information channel
+
+The **Sovereign Coding Rules** are derived from:
+- **The C Book** (Banahan, Brady, Doran) — Scope hermeticity, resource lifecycle
+- **JaCaMo / Multi-Agent Programming** — Agent independence and encapsulation
+
+Full mathematical proof: [docs/MATHEMATIQUES.md](docs/MATHEMATIQUES.md)
+
+---
+
+## 🏗 Sovereign Architecture
+
+```
+Zero external dependencies.
+Pure Python standard library (ast, math, json).
+```
+
+```
+phi_complexity/
+├── core.py        ← Golden constants (PHI, TAXE_SUTURE, ETA_GOLDEN...)
+├── analyseur.py   ← AST fractal dissection
+├── metriques.py   ← Radiance Index calculation
+├── rapport.py     ← Console / Markdown / JSON rendering
+└── cli.py         ← phi check / phi report
+```
+
+---
+
+## 🔗 Integration
+
+### Pre-commit Hook
+```yaml
+repos:
+  - repo: https://github.com/spockoo/phi-complexity
+    rev: v0.1.0
+    hooks:
+      - id: phi-check
+        args: [--min-radiance, "70"]
+```
+
+### GitHub Action
+```yaml
+- name: Phi-Complexity Audit
+  run: |
+    pip install phi-complexity
+    phi check ./src/ --min-radiance 75
+```
+
+---
+
+## 📜 License
+
+MIT — Tomy Verreault, 2026
+
+*Anchored in the Bibliothèque Céleste — Morphic Phi Framework (φ-Meta)*

phi_complexity-0.1.0/README.md

@@ -0,0 +1,169 @@
+# phi-complexity
+
+> *Code quality metrics based on Golden Ratio (φ) mathematical invariants*
+
+[![PyPI version](https://img.shields.io/pypi/v/phi-complexity.svg)](https://pypi.org/project/phi-complexity/)
+[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Tests](https://img.shields.io/badge/tests-26%20passed-brightgreen)](tests/)
+
+`phi-complexity` is the **first code quality library** that measures the health of your Python code using **universal mathematical invariants** derived from the Golden Ratio (φ = 1.618...).
+
+Unlike `pylint` (cultural rules) or `radon` (McCabe metrics), `phi-complexity` answers:
+
+> *"Is this code in resonance with the natural laws of order, or is it collapsing under its own entropy?"*
+
+---
+
+## ⚡ Quick Start
+
+```bash
+pip install phi-complexity
+```
+
+```bash
+# Audit a file
+phi check my_script.py
+
+# Audit a folder
+phi check ./src/
+
+# Generate a Markdown report
+phi report my_script.py --output report.md
+
+# CI/CD strict mode (exit 1 if radiance < 75)
+phi check ./src/ --min-radiance 75
+```
+
+### Python API
+
+```python
+from phi_complexity import auditer, rapport_console, rapport_markdown
+
+# Get metrics as a dict
+metrics = auditer("my_script.py")
+print(metrics["radiance"])          # → 82.4
+print(metrics["statut_gnostique"])  # → "EN ÉVEIL ◈"
+print(metrics["oudjat"])            # → {"nom": "process_data", "ligne": 42, ...}
+
+# Print console report
+print(rapport_console("my_script.py"))
+
+# Save Markdown report
+rapport_markdown("my_script.py", sortie="report.md")
+```
+
+---
+
+## 📊 Metrics
+
+| Metric | Description | Mathematical basis |
+|---|---|---|
+| **Radiance Score** | Global quality score (0–100) | `100 - f(Lilith) - g(H) - h(Anomalies) - i(Fib)` |
+| **Variance de Lilith** | Structural instability | Population variance of function complexities |
+| **Shannon Entropy** | Information density | `H = -Σ p·log₂(p)` |
+| **φ-Ratio** | Dominant function ratio | `max_complexity / mean` → should tend toward φ |
+| **Fibonacci Distance** | Natural size alignment | `Σ|n_i - Fib_k| / φ` |
+| **Zeta-Score** | Global resonance | `ζ_meta(functions, φ)` converging series |
+
+### Gnostic Status Levels
+
+| Score | Status | Meaning |
+|---|---|---|
+| ≥ 85 | **HERMÉTIQUE ✦** | Stable, harmonious, production-ready |
+| 60–84 | **EN ÉVEIL ◈** | Potential exists, some entropy zones |
+| < 60 | **DORMANT ░** | Deep restructuring recommended |
+
+---
+
+## 🔍 Sample Output
+
+```
+╔══════════════════════════════════════════════════╗
+║      PHI-COMPLEXITY — AUDIT DE RADIANCE          ║
+╚══════════════════════════════════════════════════╝
+
+  📄 Fichier : my_script.py
+  📅 Date    : 2026-04-08 17:11
+
+  ☼  RADIANCE     : ██████████████░░░░░░  72.6 / 100
+  ⚖  LILITH       : 11221.9  (Structural variance)
+  🌊 ENTROPIE     : 2.48 bits  (Shannon)
+  ◈  PHI-RATIO    : 3.43  (ideal: φ = 1.618, Δ=1.81)
+  ζ  ZETA-SCORE   : 0.3656  (Global resonance)
+
+  STATUT : EN ÉVEIL ◈
+
+  🔎 OUDJAT : 'process_data' (Line 42, Complexity: 376)
+
+  ⚠  SUTURES IDENTIFIED (2):
+  🟡 Line 18 [LILITH] : Nested loop (depth 2). Consider a helper function.
+     >> for j in range(b):
+  🔵 Line 67 [SOUVERAINETE] : 'load_data' receives 6 arguments. Encapsulate in an object.
+     >> def load_data(path, sep, enc, cols, dtype, na):
+```
+
+---
+
+## 🧮 Mathematical Foundations
+
+The **Radiance Formula** is derived from:
+
+- **φ-Meta Framework** (Tomy Verreault, 2026) — Axioms AX-A0 through AX-A58
+- **Law of Antifragility** (EQ-AFR-BMAD): `φ_{t+1} = P_φ(φ_t + k·Var(E_t)·E_t)`
+- **Cybernetics** (Korchounov, Mir, 1975) — Feedback and variance as control metrics
+- **Shannon Information Theory** — Code as an information channel
+
+The **Sovereign Coding Rules** are derived from:
+- **The C Book** (Banahan, Brady, Doran) — Scope hermeticity, resource lifecycle
+- **JaCaMo / Multi-Agent Programming** — Agent independence and encapsulation
+
+Full mathematical proof: [docs/MATHEMATIQUES.md](docs/MATHEMATIQUES.md)
+
+---
+
+## 🏗 Sovereign Architecture
+
+```
+Zero external dependencies.
+Pure Python standard library (ast, math, json).
+```
+
+```
+phi_complexity/
+├── core.py        ← Golden constants (PHI, TAXE_SUTURE, ETA_GOLDEN...)
+├── analyseur.py   ← AST fractal dissection
+├── metriques.py   ← Radiance Index calculation
+├── rapport.py     ← Console / Markdown / JSON rendering
+└── cli.py         ← phi check / phi report
+```
+
+---
+
+## 🔗 Integration
+
+### Pre-commit Hook
+```yaml
+repos:
+  - repo: https://github.com/spockoo/phi-complexity
+    rev: v0.1.0
+    hooks:
+      - id: phi-check
+        args: [--min-radiance, "70"]
+```
+
+### GitHub Action
+```yaml
+- name: Phi-Complexity Audit
+  run: |
+    pip install phi-complexity
+    phi check ./src/ --min-radiance 75
+```
+
+---
+
+## 📜 License
+
+MIT — Tomy Verreault, 2026
+
+*Anchored in the Bibliothèque Céleste — Morphic Phi Framework (φ-Meta)*

phi_complexity-0.1.0/phi_complexity/__init__.py

@@ -0,0 +1,65 @@
+"""
+__init__.py — API publique de phi-complexity.
+Expose les fonctions de haut niveau pour une utilisation simple.
+"""
+from .core import PHI, TAXE_SUTURE, ETA_GOLDEN, VERSION, AUTEUR, FRAMEWORK
+from .analyseur import AnalyseurPhi
+from .metriques import CalculateurRadiance
+from .rapport import GenerateurRapport
+
+
+def auditer(fichier: str) -> dict:
+    """
+    Lance un audit complet sur un fichier Python.
+    Retourne un dictionnaire de métriques.
+
+    Usage:
+        from phi_complexity import auditer
+        result = auditer("mon_script.py")
+        print(result["radiance"])  # → 82.4
+    """
+    analyseur = AnalyseurPhi(fichier)
+    resultat = analyseur.analyser()
+    calculateur = CalculateurRadiance(resultat)
+    return calculateur.calculer()
+
+
+def rapport_console(fichier: str) -> str:
+    """Retourne le rapport ASCII formaté pour le terminal."""
+    metriques = auditer(fichier)
+    return GenerateurRapport(metriques).console()
+
+
+def rapport_markdown(fichier: str, sortie: str = None) -> str:
+    """
+    Génère un rapport Markdown.
+    Si `sortie` est spécifié, sauvegarde dans ce fichier.
+    Retourne le contenu Markdown.
+    """
+    metriques = auditer(fichier)
+    gen = GenerateurRapport(metriques)
+    if sortie:
+        gen.sauvegarder_markdown(sortie)
+    return gen.markdown()
+
+
+def rapport_json(fichier: str) -> str:
+    """Retourne le rapport JSON pour CI/CD."""
+    metriques = auditer(fichier)
+    return GenerateurRapport(metriques).json()
+
+
+__version__ = VERSION
+__author__ = AUTEUR
+__all__ = [
+    "auditer",
+    "rapport_console",
+    "rapport_markdown",
+    "rapport_json",
+    "PHI",
+    "TAXE_SUTURE",
+    "ETA_GOLDEN",
+    "AnalyseurPhi",
+    "CalculateurRadiance",
+    "GenerateurRapport",
+]

phi_complexity-0.1.0/phi_complexity/__main__.py

@@ -0,0 +1,3 @@
+"""Point d'entrée pour python -m phi_complexity"""
+from phi_complexity.cli import main
+main()