refactoring

Author: tom-sapletta-com

.env.example

@@ -3,8 +3,8 @@
 # If no LLM is configured, code2docs falls back to algorithm-based generation.
 
 # LLM model identifier (litellm format)
-# Examples: openai/gpt-4o-mini, anthropic/claude-3-haiku, ollama/llama3, groq/llama-3.1-8b
-CODE2DOCS_LLM_MODEL=openai/gpt-4o-mini
+# Examples: openai/gpt-5.4-mini, anthropic/claude-3-haiku, ollama/llama3, groq/llama-3.1-8b
+CODE2DOCS_LLM_MODEL=openai/gpt-5.4-mini
 
 # API key for the LLM provider
 # Not needed for local models (ollama, etc.)

.gitignore

@@ -1,3 +1,4 @@
+.env.example
 .idea
 
 # Byte-compiled / optimized / DLL files

README.md

@@ -3,13 +3,13 @@
 
 ## AI Cost Tracking
 
-![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-3.0.26-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
+![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-0.1.31-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
 ![AI Cost](https://img.shields.io/badge/AI%20Cost-$7.50-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-18.6h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
-- 🤖 **LLM usage:** $7.5000 (58 commits)
+- 🤖 **LLM usage:** $7.5000 (59 commits)
 - 👤 **Human dev:** ~$1857 (18.6h @ $100/h, 30min dedup)
 
-Generated on 2026-04-08 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
+Generated on 2026-04-09 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
 
 ---
 

code2docs/cli.py

@@ -32,7 +32,7 @@ def main() -> None:
 @click.option('--output', '-o', default=None, help='Output directory for docs')
 @click.option('--verbose', '-v', is_flag=True, help='Verbose output')
 @click.option('--dry-run', is_flag=True, help='Show what would be generated without writing')
-@click.option('--llm', 'llm_model', default=None, help='Enable LLM-assisted generation (e.g. openai/gpt-4o-mini, ollama/llama3)')
+@click.option('--llm', 'llm_model', default=None, help='Enable LLM-assisted generation (e.g. openai/gpt-5.4-mini, ollama/llama3)')
 @click.option('--org-name', default=None, help='Organization name for org-mode README generation')
 def generate(project_path, config_path, readme_only, sections, output, verbose, dry_run, llm_model, org_name) -> None:
     """Generate documentation (default command)."""

code2docs/docs/configuration.md

@@ -57,7 +57,7 @@
 | Option | Type | Default | Description |
 |--------|------|---------|-------------|
 | `enabled` | `bool` | false | Enable LLM-assisted documentation generation |
-| `model` | `str` | "" | LLM model identifier (litellm format, e.g. `openai/gpt-4o-mini`, `ollama/llama3`) |
+| `model` | `str` | "" | LLM model identifier (litellm format, e.g. `openai/gpt-5.4-mini`, `ollama/llama3`) |
 | `api_key` | `str` | "" | API key for the LLM provider (use `.env` or env var `CODE2DOCS_LLM_API_KEY`) |
 | `api_base` | `str` | "" | Custom API base URL (for self-hosted or proxy endpoints) |
 | `max_tokens` | `int` | 1024 | Maximum tokens per LLM call |

code2docs/generators/api_reference_gen.py

@@ -2,7 +2,7 @@
 
 from collections import defaultdict
 from pathlib import Path
-from typing import Dict, List, Optional
+from typing import Dict, List
 
 from code2llm.api import AnalysisResult, FunctionInfo, ClassInfo, ModuleInfo
 

code2docs/generators/config_docs_gen.py

@@ -55,7 +55,7 @@ def generate(self) -> str:
         "watch": "Enable file watcher for auto-resync",
         "ignore": "Glob patterns to ignore during sync",
         "enabled": "Enable LLM-assisted documentation generation",
-        "model": "LLM model identifier (litellm format, e.g. `openai/gpt-4o-mini`, `ollama/llama3`)",
+        "model": "LLM model identifier (litellm format, e.g. `openai/gpt-5.4-mini`, `ollama/llama3`)",
         "api_key": "API key for the LLM provider (use `.env` or env var `CODE2DOCS_LLM_API_KEY`)",
         "api_base": "Custom API base URL (for self-hosted or proxy endpoints)",
         "max_tokens": "Maximum tokens per LLM call",

code2docs/generators/examples_gen.py

@@ -1,26 +1,17 @@
-
-
-PORT_4 = 4
-CONSTANT_5 = 5
-CONSTANT_50 = 50
-
-PORT_4 = 4
-CONSTANT_5 = 5
-CONSTANT_50 = 50
-
 """Auto-generate usage examples from public signatures and entry points."""
 
 from pathlib import Path
-from typing import Dict, List, Optional, Set
+from typing import Dict, List, Optional, Set, Type
 
 from code2llm.api import AnalysisResult, FunctionInfo, ClassInfo
 
 from ..config import Code2DocsConfig
 
-# Default type hints → example values
+# Constants
+CONSTANT_50 = 50
 
-if __name__ == "__main__":
-    _TYPE_EXAMPLES = {
+# Default type hints → example values
+_TYPE_EXAMPLES = {
     "str": '"./my-project"',
     "Path": 'Path("./my-project")',
     "int": "10",
@@ -35,7 +26,7 @@
 }
 
 # Arg name → realistic example value
-    _ARG_EXAMPLES = {
+_ARG_EXAMPLES = {
     "project_path": '"./my-project"',
     "path": '"./my-project"',
     "source": '"./src"',