code2docs 3.0.34__tar.gz → 3.0.35__tar.gz

{code2docs-3.0.34 → code2docs-3.0.35}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code2docs
-Version: 3.0.34
+Version: 3.0.35
 Summary: Auto-generate and sync project documentation from source code analysis
 Author-email: Tom Sapletta <tom@sapletta.com>
 License-Expression: Apache-2.0
@@ -11,14 +11,13 @@ Keywords: documentation,auto-docs,readme-generator,api-reference,code-analysis,s
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 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: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Documentation
 Classifier: Topic :: Software Development :: Code Generators
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: code2llm>=0.5.0
@@ -44,24 +43,24 @@ Requires-Dist: ruff>=0.1; extra == "dev"
 Requires-Dist: mypy>=1.0; extra == "dev"
 Requires-Dist: build>=1.0; extra == "dev"
 Requires-Dist: twine>=5.0; extra == "dev"
-Requires-Dist: goal>=2.1.0; extra == "dev"
 Requires-Dist: costs>=0.1.20; extra == "dev"
-Requires-Dist: pfix>=0.1.60; extra == "dev"
 Provides-Extra: all
 Requires-Dist: code2docs[git,llm,mkdocs,watch]; extra == "all"
 Dynamic: license-file
 
 ## AI Cost Tracking
 
-![AI Cost](https://img.shields.io/badge/AI%20Cost-$7.50-yellow) ![AI Model](https://img.shields.io/badge/AI%20Model-openrouter%2Fqwen%2Fqwen3-coder-next-lightgrey)
+![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-3.0.35-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-$5.36-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-45.9h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
-This project uses AI-generated code. Total cost: **$7.5000** with **77** AI commits.
+- 🤖 **LLM usage:** $5.3635 (99 commits)
+- 👤 **Human dev:** ~$4589 (45.9h @ $100/h, 30min dedup)
 
-Generated on 2026-06-29 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/models/openrouter/qwen/qwen3-coder-next)
+Generated on 2026-10-04 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
 
 ---
 
-![version](https://img.shields.io/badge/version-3.0.34-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-3.0.35-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.
 
@@ -198,7 +197,7 @@ code2docs can update only specific sections of an existing README using markers:
 ```markdown
 <!-- code2docs:start --># code2docs
 
-![version](https://img.shields.io/badge/version-3.0.34-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-276-green)
+![version](https://img.shields.io/badge/version-3.0.35-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-276-green)
 > **276** functions | **57** classes | **51** files | CC̄ = 3.8
 
 > Auto-generated project documentation from source code analysis.

{code2docs-3.0.34 → code2docs-3.0.35}/README.md

@@ -1,14 +1,16 @@
 ## AI Cost Tracking
 
-![AI Cost](https://img.shields.io/badge/AI%20Cost-$7.50-yellow) ![AI Model](https://img.shields.io/badge/AI%20Model-openrouter%2Fqwen%2Fqwen3-coder-next-lightgrey)
+![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-3.0.35-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-$5.36-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-45.9h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
-This project uses AI-generated code. Total cost: **$7.5000** with **77** AI commits.
+- 🤖 **LLM usage:** $5.3635 (99 commits)
+- 👤 **Human dev:** ~$4589 (45.9h @ $100/h, 30min dedup)
 
-Generated on 2026-06-29 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/models/openrouter/qwen/qwen3-coder-next)
+Generated on 2026-10-04 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
 
 ---
 
-![version](https://img.shields.io/badge/version-3.0.34-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-3.0.35-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.
 
@@ -145,7 +147,7 @@ code2docs can update only specific sections of an existing README using markers:
 ```markdown
 <!-- code2docs:start --># code2docs
 
-![version](https://img.shields.io/badge/version-3.0.34-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-276-green)
+![version](https://img.shields.io/badge/version-3.0.35-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-276-green)
 > **276** functions | **57** classes | **51** files | CC̄ = 3.8
 
 > Auto-generated project documentation from source code analysis.

{code2docs-3.0.34 → code2docs-3.0.35}/code2docs/__init__.py

@@ -5,7 +5,7 @@ Uses code2llm's AnalysisResult to produce human-readable documentation:
 README.md, API references, module docs, examples, and architecture diagrams.
 """
 
-__version__ = "3.0.34"
+__version__ = "3.0.35"
 __author__ = "Tom Sapletta"
 __all__ = ["Code2DocsConfig", "generate_readme", "generate_docs", "analyze_and_document"]
 

{code2docs-3.0.34 → code2docs-3.0.35}/code2docs/analyzers/endpoint_detector.py

@@ -1,5 +1,6 @@
 """Detect web framework endpoints (Flask, FastAPI, Django) from AST analysis."""
 
+import os
 import re
 from dataclasses import dataclass, field
 from pathlib import Path
@@ -23,6 +24,36 @@ class Endpoint:
     return_type: Optional[str] = None
 
 
+# Directories never searched for Django urls.py: virtualenvs, vendored packages,
+# VCS/worktree copies and build output. Walking them dominated runtime (~40s on
+# a workspace with vendored site-packages). Any dot-directory is skipped too.
+_SKIP_DIRS = frozenset(
+    {
+        "venv",
+        "env",
+        "node_modules",
+        "site-packages",
+        "__pycache__",
+        "dist",
+        "build",
+        "target",
+        "bower_components",
+    }
+)
+
+
+def _iter_urls_files(root: Path):
+    """Yield ``urls.py`` files under *root*, pruning irrelevant directories."""
+    for dirpath, dirnames, filenames in os.walk(root):
+        dirnames[:] = [
+            d
+            for d in dirnames
+            if d not in _SKIP_DIRS and not d.startswith(".") and not d.endswith(".egg-info")
+        ]
+        if "urls.py" in filenames:
+            yield Path(dirpath) / "urls.py"
+
+
 class EndpointDetector:
     """Detects web endpoints from decorator patterns in source code."""
 
@@ -91,7 +122,7 @@ class EndpointDetector:
         endpoints: List[Endpoint] = []
         project = Path(project_path)
 
-        for urls_file in project.rglob("urls.py"):
+        for urls_file in _iter_urls_files(project):
             try:
                 source = urls_file.read_text(encoding="utf-8")
                 for match in self.DJANGO_URL_PATTERN.finditer(source):

{code2docs-3.0.34 → code2docs-3.0.35}/code2docs/llm_helper.py

@@ -4,6 +4,7 @@ If litellm is not installed or LLM is not configured, all methods return None
 and generators fall back to algorithm-based template output.
 """
 
+import importlib.util
 import logging
 from typing import Optional
 
@@ -29,6 +30,18 @@ def _get_litellm():
     return _litellm if _litellm is not False else None
 
 
+def _litellm_installed() -> bool:
+    """Cheap availability check: locate litellm without importing it.
+
+    Importing litellm costs ~10s, so it must only happen when a completion is
+    actually requested (see ``_get_litellm`` in ``LLMHelper.complete``).
+    """
+    try:
+        return importlib.util.find_spec("litellm") is not None
+    except (ImportError, ValueError):
+        return False
+
+
 class LLMHelper:
     """Thin wrapper around litellm for documentation generation.
 
@@ -45,7 +58,7 @@ class LLMHelper:
         """Check if LLM is configured and litellm is installed."""
         if self._available is None:
             self._available = (
-                self.config.enabled and bool(self.config.model) and _get_litellm() is not None
+                self.config.enabled and bool(self.config.model) and _litellm_installed()
             )
             if self._available:
                 logger.info("LLM enabled: model=%s", self.config.model)
@@ -54,7 +67,7 @@ class LLMHelper:
                     "LLM disabled (enabled=%s, model=%s, litellm=%s)",
                     self.config.enabled,
                     bool(self.config.model),
-                    _get_litellm() is not None,
+                    _litellm_installed(),
                 )
         return self._available
 

{code2docs-3.0.34 → code2docs-3.0.35}/code2docs.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code2docs
-Version: 3.0.34
+Version: 3.0.35
 Summary: Auto-generate and sync project documentation from source code analysis
 Author-email: Tom Sapletta <tom@sapletta.com>
 License-Expression: Apache-2.0
@@ -11,14 +11,13 @@ Keywords: documentation,auto-docs,readme-generator,api-reference,code-analysis,s
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 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: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Documentation
 Classifier: Topic :: Software Development :: Code Generators
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: code2llm>=0.5.0
@@ -44,24 +43,24 @@ Requires-Dist: ruff>=0.1; extra == "dev"
 Requires-Dist: mypy>=1.0; extra == "dev"
 Requires-Dist: build>=1.0; extra == "dev"
 Requires-Dist: twine>=5.0; extra == "dev"
-Requires-Dist: goal>=2.1.0; extra == "dev"
 Requires-Dist: costs>=0.1.20; extra == "dev"
-Requires-Dist: pfix>=0.1.60; extra == "dev"
 Provides-Extra: all
 Requires-Dist: code2docs[git,llm,mkdocs,watch]; extra == "all"
 Dynamic: license-file
 
 ## AI Cost Tracking
 
-![AI Cost](https://img.shields.io/badge/AI%20Cost-$7.50-yellow) ![AI Model](https://img.shields.io/badge/AI%20Model-openrouter%2Fqwen%2Fqwen3-coder-next-lightgrey)
+![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-3.0.35-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-$5.36-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-45.9h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
-This project uses AI-generated code. Total cost: **$7.5000** with **77** AI commits.
+- 🤖 **LLM usage:** $5.3635 (99 commits)
+- 👤 **Human dev:** ~$4589 (45.9h @ $100/h, 30min dedup)
 
-Generated on 2026-06-29 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/models/openrouter/qwen/qwen3-coder-next)
+Generated on 2026-10-04 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
 
 ---
 
-![version](https://img.shields.io/badge/version-3.0.34-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-3.0.35-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.
 
@@ -198,7 +197,7 @@ code2docs can update only specific sections of an existing README using markers:
 ```markdown
 <!-- code2docs:start --># code2docs
 
-![version](https://img.shields.io/badge/version-3.0.34-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-276-green)
+![version](https://img.shields.io/badge/version-3.0.35-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-276-green)
 > **276** functions | **57** classes | **51** files | CC̄ = 3.8
 
 > Auto-generated project documentation from source code analysis.

{code2docs-3.0.34 → code2docs-3.0.35}/code2docs.egg-info/requires.txt

@@ -15,9 +15,7 @@ ruff>=0.1
 mypy>=1.0
 build>=1.0
 twine>=5.0
-goal>=2.1.0
 costs>=0.1.20
-pfix>=0.1.60
 
 [git]
 gitpython>=3.1

{code2docs-3.0.34 → code2docs-3.0.35}/pyproject.toml

@@ -4,10 +4,10 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "code2docs"
-version = "3.0.34"
+version = "3.0.35"
 description = "Auto-generate and sync project documentation from source code analysis"
 readme = "README.md"
-requires-python = ">=3.9"
+requires-python = ">=3.10"
 license = "Apache-2.0"
 authors = [
     {name = "Tom Sapletta", email = "tom@sapletta.com"},
@@ -25,7 +25,6 @@ classifiers = [
     "Development Status :: 3 - Alpha",
     "Intended Audience :: Developers",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
@@ -54,9 +53,7 @@ dev = [
     "mypy>=1.0",
     "build>=1.0",
     "twine>=5.0",
-    "goal>=2.1.0",
     "costs>=0.1.20",
-    "pfix>=0.1.60",
 ]
 all = ["code2docs[llm,git,watch,mkdocs]"]
 
@@ -90,22 +87,6 @@ include = ["code2docs*"]
 [tool.setuptools.package-data]
 code2docs = ["templates/*.j2"]
 
-[tool.pfix]
-# Self-healing Python configuration
-model = "openrouter/qwen/qwen3-coder-next"
-auto_apply = true
-auto_install_deps = true
-auto_restart = false
-max_retries = 3
-create_backups = false
-git_auto_commit = false
-
-[tool.pfix.runtime_todo]
-enabled = true
-todo_file = "TODO.md"
-min_severity = "low"
-deduplicate = true
-
 [tool.costs]
 # AI Cost tracking configuration
 badge = true
@@ -118,3 +99,9 @@ max_commits = 500
 
 # Cost thresholds for badge colors (USD)
 badge_color_thresholds = { low = 1.0, medium = 5.0, high = 10.0, critical = 50.0 }
+
+[tool.uv.dependency-groups.automation]
+requires-python = ">=3.12"
+
+[dependency-groups]
+automation = ["goal>=2.1.302"]

{code2docs-3.0.34 → code2docs-3.0.35}/tests/test_analyzers.py

@@ -136,3 +136,17 @@ class TestEndpointDetector:
         )
         ep = detector._parse_decorator(func.decorators[0], func)
         assert ep is None
+
+
+def test_endpoint_detector_skips_vendored_and_hidden_dirs(tmp_path):
+    from code2docs.analyzers.endpoint_detector import EndpointDetector
+
+    (tmp_path / "app").mkdir()
+    (tmp_path / "app" / "urls.py").write_text("urlpatterns = [path('real/', v)]\n")
+    for skipped in (".subactor/lib/site-packages/x", "venv/lib", "node_modules/y", ".worktrees/t1"):
+        d = tmp_path / skipped
+        d.mkdir(parents=True)
+        (d / "urls.py").write_text("urlpatterns = [path('vendored/', v)]\n")
+
+    paths = [e.path for e in EndpointDetector()._scan_django_urls(str(tmp_path))]
+    assert paths == ["real/"]

{code2docs-3.0.34 → code2docs-3.0.35}/tests/test_llm_helper.py

@@ -270,3 +270,27 @@ class TestGeneratorFallback:
         content = gen.generate()
         assert "Getting Started" in content
         assert "Installation" in content
+
+
+# ── Performance regression tests ─────────────────────────────────────────
+
+
+class TestLazyLitellmImport:
+    """Availability checks must not import litellm (~10s)."""
+
+    def test_disabled_helper_never_imports_litellm(self):
+        from code2docs import llm_helper
+        from code2docs.config import LLMConfig
+
+        with patch("code2docs.llm_helper._get_litellm") as get_litellm:
+            assert LLMHelper(LLMConfig(enabled=False)).available is False
+        get_litellm.assert_not_called()
+
+    def test_enabled_availability_uses_find_spec_not_import(self):
+        from code2docs.config import LLMConfig
+
+        with patch("code2docs.llm_helper._litellm_installed", return_value=True), patch(
+            "code2docs.llm_helper._get_litellm"
+        ) as get_litellm:
+            assert LLMHelper(LLMConfig(enabled=True, model="x")).available is True
+        get_litellm.assert_not_called()