chore(release): 0.0.7

Squash-merge lib-standardisation: adopt repo standards across packaging,
tooling, docs, and CI.

- standardize pyproject.toml (canonical packaging, lint config, extras, GSDFC pydoclint)
- add py.typed marker, modernize type hints and Google-style docstrings
- nest generated docs under docs/lib and docs/mcp; add hand-written wiki
- adopt standard Type A PyPI CI pipeline (tag==version guard + quality gate)
- promote generated CHANGELOG.md; bump version to 0.0.7
This commit is contained in:
2026-10-17 02:16:44 +05:30
parent 8253c25928
commit 06ffd2febd
149 changed files with 7132 additions and 4594 deletions

View File

@@ -2,7 +2,7 @@ import json
from pathlib import Path
from docforge import MCPRenderer
from docforge.models import Project, Module
from docforge.models import Module, Project
def test_mcp_file_content(tmp_path: Path):

View File

@@ -1,7 +1,7 @@
from pathlib import Path
from docforge import MCPRenderer
from docforge.models import Project, Module
from docforge.models import Module, Project
def test_mcp_idempotent(tmp_path: Path):

View File

@@ -1,7 +1,7 @@
from pathlib import Path
from docforge.loaders import GriffeLoader, discover_module_paths
from docforge import MCPRenderer
from docforge.loaders import GriffeLoader, discover_module_paths
def test_mcp_emits_all_modules(tmp_path: Path) -> None:
@@ -22,10 +22,7 @@ def test_mcp_emits_all_modules(tmp_path: Path) -> None:
for p in (tmp_path / "modules").rglob("*.json")
}
expected = {
f"modules/{m.path}.json"
for m in project.get_all_modules()
}
expected = {f"modules/{m.path}.json" for m in project.get_all_modules()}
missing = expected - emitted
assert not missing, f"Missing MCP module JSON files: {missing}"

View File

@@ -0,0 +1,73 @@
import json
from pathlib import Path
from docforge import MCPRenderer
from docforge.loaders import GriffeLoader, discover_module_paths
def _load_docforge_bundle(tmp_path: Path) -> Path:
project_root = Path(__file__).resolve().parents[3]
loader = GriffeLoader()
paths = discover_module_paths("docforge", project_root=project_root)
project = loader.load_project(paths)
out_dir = tmp_path / "mcp"
MCPRenderer().generate_sources(project, out_dir)
return out_dir
def test_mcp_signatures_are_clean(tmp_path: Path) -> None:
out_dir = _load_docforge_bundle(tmp_path)
object_payload = json.loads(
(out_dir / "modules" / "docforge.models.object.json").read_text(
encoding="utf-8"
)
)
cls = object_payload["content"]["objects"]["DocObject"]
assert isinstance(cls["signature"], str)
assert "bound method" not in cls["signature"]
assert cls["signature"].startswith("DocObject(")
renderer_payload = json.loads(
(out_dir / "modules" / "docforge.renderers.mcp_renderer.json").read_text(
encoding="utf-8"
)
)
method = renderer_payload["content"]["objects"]["MCPRenderer"]["members"][
"generate_sources"
]
assert isinstance(method["signature"], str)
assert "bound method" not in method["signature"]
assert method["signature"].startswith("generate_sources(")
def test_mcp_skips_unresolvable_import_aliases(tmp_path: Path) -> None:
out_dir = _load_docforge_bundle(tmp_path)
renderer_payload = json.loads(
(out_dir / "modules" / "docforge.renderers.mcp_renderer.json").read_text(
encoding="utf-8"
)
)
object_names = set(renderer_payload["content"]["objects"])
assert "json" not in object_names
assert "Path" not in object_names
def test_mcp_keeps_resolvable_package_reexports(tmp_path: Path) -> None:
out_dir = _load_docforge_bundle(tmp_path)
root_payload = json.loads(
(out_dir / "modules" / "docforge.json").read_text(encoding="utf-8")
)
discover = root_payload["content"]["objects"]["discover_module_paths"]
assert discover["name"] == "discover_module_paths"
assert isinstance(discover["signature"], str)
assert "bound method" not in discover["signature"]
assert discover["signature"].startswith("discover_module_paths(")
assert discover["docstring"] is not None

View File

@@ -1,7 +1,7 @@
from pathlib import Path
from docforge import MCPRenderer
from docforge.models import Project, Module
from docforge.models import Module, Project
def test_mcp_directory_structure(tmp_path: Path):