refactor(docs): configuration management system

changes:
  - file: api_reference_gen.py
    area: api
    modified: [_render_api_functions, ApiReferenceGenerator, _render_api_classes]
  - file: architecture_gen.py
    area: docs
    modified: [_generate_metrics_table, ArchitectureGenerator]
  - file: module_docs_gen.py
    area: docs
    modified: [_calc_module_avg_cc, _render_classes_section, ModuleDocsGenerator]
  - file: readme_gen.py
    area: docs
    modified: [_calc_avg_complexity, ReadmeGenerator]

stats:
  lines: "+9/-10 (net -1)"
  files: 6
  complexity: "Stable complexity"

Author: tom-sapletta-com

.gitignore

@@ -211,6 +211,4 @@ __marimo__/
 # code2docs generated outputs
 .code2docs.state
 .code2docs.api_snapshot.json
-docs/
-examples/
 mkdocs.yml

CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.2] - 2026-03-07
+
+### Other
+- Update .gitignore
+- Update code2docs/generators/api_reference_gen.py
+- Update code2docs/generators/architecture_gen.py
+- Update code2docs/generators/module_docs_gen.py
+- Update code2docs/generators/readme_gen.py
+- Update code2docs/templates/module_doc.md.j2
+
 ## [0.2.1] - 2026-03-07
 
 ### Docs

README.md

@@ -1,6 +1,6 @@
 # code2docs
 
-![version](https://img.shields.io/badge/version-0.2.1-blue) ![python](https://img.shields.io/badge/python-%3E%3D3.9-blue) ![docs](https://img.shields.io/badge/docs-auto--generated-blueviolet)
+![version](https://img.shields.io/badge/version-0.2.2-blue) ![python](https://img.shields.io/badge/python-%3E%3D3.9-blue) ![docs](https://img.shields.io/badge/docs-auto--generated-blueviolet)
 
 > Auto-generate and sync project documentation from source code analysis.
 
@@ -140,7 +140,7 @@ code2docs can update only specific sections of an existing README using markers:
 ```markdown
 <!-- code2docs:start --># code2docs
 
-![version](https://img.shields.io/badge/version-0.2.1-blue) ![python](https://img.shields.io/badge/python-%3E%3D3.9-blue) ![coverage](https://img.shields.io/badge/coverage-unknown-lightgrey) ![functions](https://img.shields.io/badge/functions-153-green)
+![version](https://img.shields.io/badge/version-0.2.2-blue) ![python](https://img.shields.io/badge/python-%3E%3D3.9-blue) ![coverage](https://img.shields.io/badge/coverage-unknown-lightgrey) ![functions](https://img.shields.io/badge/functions-153-green)
 > **153** functions | **30** classes | **28** files | CC̄ = 0.0
 
 ## Installation

VERSION

@@ -1 +1 @@
-0.2.1
+0.2.2

code2docs/__init__.py

@@ -5,7 +5,7 @@
 README.md, API references, module docs, examples, and architecture diagrams.
 """
 
-__version__ = "0.2.1"
+__version__ = "0.2.2"
 __author__ = "Tom Sapletta"
 
 from .config import Code2DocsConfig

code2docs/generators/api_reference_gen.py

@@ -97,7 +97,7 @@ def _render_api_classes(self, mod_name: str) -> str:
                     doc_line = ""
                     if method.docstring:
                         doc_line = f" — {method.docstring.splitlines()[0]}"
-                    cc = method.complexity.get("cyclomatic", 0)
+                    cc = method.complexity.get("cyclomatic_complexity", method.complexity.get("cyclomatic", 0))
                     cc_badge = f" ⚠️ CC={cc}" if cc > 10 else ""
                     lines.append(f"- `{sig}`{doc_line}{cc_badge}")
                 lines.append("")
@@ -118,7 +118,7 @@ def _render_api_functions(self, mod_name: str) -> str:
             lines.append(f"### `{sig}`\n")
             if func_info.docstring:
                 lines.append(f"{func_info.docstring.strip()}\n")
-            cc = func_info.complexity.get("cyclomatic", 0)
+            cc = func_info.complexity.get("cyclomatic_complexity", func_info.complexity.get("cyclomatic", 0))
             if cc:
                 lines.append(f"- Complexity: {cc}")
             if func_info.calls:

code2docs/generators/architecture_gen.py

@@ -177,9 +177,9 @@ def _generate_metrics_table(self) -> str:
 
         # Average complexity
         complexities = [
-            f.complexity.get("cyclomatic", 0)
+            f.complexity.get("cyclomatic_complexity", f.complexity.get("cyclomatic", 0))
             for f in self.result.functions.values()
-            if f.complexity.get("cyclomatic", 0) > 0
+            if f.complexity.get("cyclomatic_complexity", f.complexity.get("cyclomatic", 0)) > 0
         ]
         if complexities:
             avg = round(sum(complexities) / len(complexities), 1)

code2docs/generators/module_docs_gen.py

@@ -80,7 +80,7 @@ def _render_classes_section(self, mod_name: str) -> str:
                     if len(m.args) > 4:
                         args += ", ..."
                     ret = m.returns or "—"
-                    cc = m.complexity.get("cyclomatic", "—")
+                    cc = m.complexity.get("cyclomatic_complexity", m.complexity.get("cyclomatic", "—"))
                     warn = " ⚠️" if isinstance(cc, (int, float)) and cc > 10 else ""
                     lines.append(f"| `{m.name}` | `{args}` | `{ret}` | {cc}{warn} |")
                 lines.append("")
@@ -149,7 +149,7 @@ def _calc_module_avg_cc(self, mod_name: str) -> float:
         complexities = []
         for func in self.result.functions.values():
             if func.module == mod_name:
-                cc = func.complexity.get("cyclomatic", 0)
+                cc = func.complexity.get("cyclomatic_complexity", func.complexity.get("cyclomatic", 0))
                 if cc > 0:
                     complexities.append(cc)
         return round(sum(complexities) / len(complexities), 1) if complexities else 0.0

code2docs/generators/readme_gen.py

@@ -95,7 +95,8 @@ def _calc_avg_complexity(self) -> float:
         """Calculate average cyclomatic complexity."""
         complexities = []
         for func in self.result.functions.values():
-            cc = func.complexity.get("cyclomatic", 0)
+            cc = func.complexity.get("cyclomatic_complexity",
+                                     func.complexity.get("cyclomatic", 0))
             if cc > 0:
                 complexities.append(cc)
         return round(sum(complexities) / len(complexities), 1) if complexities else 0.0

code2docs/templates/module_doc.md.j2

@@ -30,7 +30,7 @@
 {% for m in methods[cls_name] %}
 {% set args = m.args[:4]|join(', ') %}
 {% set ret = m.returns or '—' %}
-{% set cc = m.complexity.get('cyclomatic', '—') %}
+{% set cc = m.complexity.get('cyclomatic_complexity', m.complexity.get('cyclomatic', '—')) %}
 | `{{ m.name }}` | `{{ args }}` | `{{ ret }}` | {{ cc }} |
 {% endfor %}