code2docs 0.1.6__tar.gz → 0.2.1__tar.gz

{code2docs-0.1.6 → code2docs-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code2docs
-Version: 0.1.6
+Version: 0.2.1
 Summary: Auto-generate and sync project documentation from source code analysis
 Author-email: Tom Sapletta <tom@sapletta.com>
 License-Expression: Apache-2.0
@@ -40,7 +40,7 @@ Dynamic: license-file
 
 # code2docs
 
-![version](https://img.shields.io/badge/version-0.1.6-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.1-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.
 
@@ -180,7 +180,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.1.6-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.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)
 > **153** functions | **30** classes | **28** files | CC̄ = 0.0
 
 ## Installation

{code2docs-0.1.6 → code2docs-0.2.1}/README.md

@@ -1,6 +1,6 @@
 # code2docs
 
-![version](https://img.shields.io/badge/version-0.1.6-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.1-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.1.6-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.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)
 > **153** functions | **30** classes | **28** files | CC̄ = 0.0
 
 ## Installation

{code2docs-0.1.6 → code2docs-0.2.1}/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__ = "0.1.6"
+__version__ = "0.2.1"
 __author__ = "Tom Sapletta"
 
 from .config import Code2DocsConfig

{code2docs-0.1.6 → code2docs-0.2.1}/code2docs/generators/depgraph_gen.py

@@ -1,5 +1,7 @@
 """Dependency graph generator — Mermaid diagram from coupling matrix."""
 
+import ast
+from pathlib import Path
 from typing import Dict, List, Set, Tuple
 
 from code2llm.api import AnalysisResult, ModuleInfo
@@ -37,16 +39,42 @@ class DepGraphGenerator:
         return "\n".join(lines)
 
     def _collect_edges(self) -> List[Tuple[str, str]]:
-        """Build directed edges from module imports."""
-        edges: List[Tuple[str, str]] = []
+        """Build directed edges from module imports.
+
+        Uses ModuleInfo.imports when available, otherwise extracts
+        imports from the source file via AST.
+        """
+        edges: Set[Tuple[str, str]] = set()
         module_names = set(self.result.modules.keys())
 
         for mod_name, mod_info in self.result.modules.items():
-            for imp in mod_info.imports:
+            imports = mod_info.imports
+            if not imports:
+                imports = self._extract_imports_from_file(mod_info.file)
+            for imp in imports:
                 for other in module_names:
                     if mod_name != other and self._import_matches(imp, other):
-                        edges.append((mod_name, other))
-        return sorted(set(edges))
+                        edges.add((mod_name, other))
+        return sorted(edges)
+
+    @staticmethod
+    def _extract_imports_from_file(file_path: str) -> List[str]:
+        """Parse source file AST to extract import targets."""
+        try:
+            source = Path(file_path).read_text(encoding="utf-8")
+            tree = ast.parse(source)
+        except Exception:
+            return []
+
+        imports: List[str] = []
+        for node in ast.walk(tree):
+            if isinstance(node, ast.Import):
+                for alias in node.names:
+                    imports.append(alias.name)
+            elif isinstance(node, ast.ImportFrom):
+                if node.module:
+                    imports.append(node.module)
+        return imports
 
     @staticmethod
     def _import_matches(imp: str, module: str) -> bool:

{code2docs-0.1.6 → code2docs-0.2.1}/code2docs.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code2docs
-Version: 0.1.6
+Version: 0.2.1
 Summary: Auto-generate and sync project documentation from source code analysis
 Author-email: Tom Sapletta <tom@sapletta.com>
 License-Expression: Apache-2.0
@@ -40,7 +40,7 @@ Dynamic: license-file
 
 # code2docs
 
-![version](https://img.shields.io/badge/version-0.1.6-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.1-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.
 
@@ -180,7 +180,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.1.6-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.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)
 > **153** functions | **30** classes | **28** files | CC̄ = 0.0
 
 ## Installation

{code2docs-0.1.6 → code2docs-0.2.1}/code2docs.egg-info/SOURCES.txt

@@ -42,6 +42,7 @@ code2docs/templates/index.md.j2
 code2docs/templates/module_doc.md.j2
 code2docs/templates/readme.md.j2
 tests/test_analyzers.py
+tests/test_cli.py
 tests/test_code2docs.py
 tests/test_config.py
 tests/test_formatters.py

{code2docs-0.1.6 → code2docs-0.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "code2docs"
-version = "0.1.6"
+version = "0.2.1"
 description = "Auto-generate and sync project documentation from source code analysis"
 readme = "README.md"
 requires-python = ">=3.9"

code2docs-0.2.1/tests/test_cli.py

@@ -0,0 +1,67 @@
+"""CLI smoke tests using Click's CliRunner."""
+
+import tempfile
+from pathlib import Path
+
+from click.testing import CliRunner
+
+from code2docs.cli import main
+
+
+class TestCLI:
+    def setup_method(self):
+        self.runner = CliRunner()
+
+    def test_help(self):
+        result = self.runner.invoke(main, ["--help"])
+        assert result.exit_code == 0
+        assert "code2docs" in result.output
+        assert "generate" in result.output
+        assert "sync" in result.output
+        assert "init" in result.output
+
+    def test_generate_help(self):
+        result = self.runner.invoke(main, ["generate", "--help"])
+        assert result.exit_code == 0
+        assert "--readme-only" in result.output
+        assert "--dry-run" in result.output
+        assert "--verbose" in result.output
+
+    def test_sync_help(self):
+        result = self.runner.invoke(main, ["sync", "--help"])
+        assert result.exit_code == 0
+        assert "Synchronize" in result.output
+
+    def test_init_creates_config(self):
+        with tempfile.TemporaryDirectory() as tmpdir:
+            result = self.runner.invoke(main, ["init", tmpdir])
+            assert result.exit_code == 0
+            assert (Path(tmpdir) / "code2docs.yaml").exists()
+
+    def test_generate_dry_run(self):
+        result = self.runner.invoke(main, [".", "--dry-run"])
+        assert result.exit_code == 0
+        assert "code2docs" in result.output
+        assert "README.md" in result.output
+        assert "dry-run" in result.output
+        assert "Done!" in result.output
+
+    def test_readme_only_dry_run(self):
+        result = self.runner.invoke(main, [".", "--readme-only", "--dry-run"])
+        assert result.exit_code == 0
+        assert "README.md" in result.output
+        # Should NOT have docs/api since --readme-only
+        assert "docs/api" not in result.output
+
+    def test_default_group_routes_path(self):
+        """Ensure bare path argument is routed to generate."""
+        result = self.runner.invoke(main, [".", "--dry-run"])
+        assert result.exit_code == 0
+        assert "Done!" in result.output
+
+    def test_verbose(self):
+        result = self.runner.invoke(main, [".", "--verbose", "--dry-run"])
+        assert result.exit_code == 0
+        assert "Functions:" in result.output
+        assert "Classes:" in result.output
+        assert "Modules:" in result.output