cpdocs 0.3.6__tar.gz → 0.3.7__tar.gz

{cpdocs-0.3.6 → cpdocs-0.3.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: cpdocs
-Version: 0.3.6
+Version: 0.3.7
 Summary: Semantic, versioned API documentation for C, C++, CUDA, HIP, Fortran, Python and Rust projects
 Project-URL: Source, https://github.com/ambhora/cpdocs
 Author-email: Jayesh Badwaik <j.badwaik@fz-juelich.de>

{cpdocs-0.3.6 → cpdocs-0.3.7}/src/cpdocs/__init__.py

@@ -4,4 +4,4 @@
 # --------------------------------------------------------------------------------------------------
 """Language-neutral semantic API documentation generator."""
 
-__version__ = "0.3.6"
+__version__ = "0.3.7"

{cpdocs-0.3.6 → cpdocs-0.3.7}/src/cpdocs/contract.py

@@ -149,7 +149,7 @@ class UnitManifest:
 @dataclass(frozen=True)
 class Manifest:
     units: tuple[UnitManifest, ...]
-    # Optional BESA metadata; feature-set enumeration depends only on features.
+    # Optional build-system metadata; feature-set enumeration depends only on features.
     options: tuple[dict[str, Any], ...] = ()
 
 

{cpdocs-0.3.6 → cpdocs-0.3.7}/src/cpdocs/languages/fortran/extract.py

@@ -35,7 +35,7 @@ _ROUTINE = re.compile(
 _END_ROUTINE = re.compile(r"^\s*end\s*(?:function|subroutine)\b", re.IGNORECASE)
 _VISIBILITY = re.compile(r"^\s*(public|private)\s*(?:::\s*(.*))?$", re.IGNORECASE)
 _DECL = re.compile(r"^\s*([^!]+?)\s*::\s*(.+)$")
-_DOC = re.compile(r"^\s*!+[>]?[ ]?(.*)$")
+_DOC = re.compile(r"^\s*(?:!>|!!)[ ]?(.*)$")
 
 
 def _source_files(roots: list[Path]) -> list[Path]:

{cpdocs-0.3.6 → cpdocs-0.3.7}/test/test_examples.py

@@ -16,6 +16,7 @@ import pytest
 from conftest import EXAMPLES, REPOSITORY, copy_example, git, init_repository, require
 from cpdocs.build import build_current
 from cpdocs.config import load_config
+from cpdocs.languages.fortran.extract import extract_fortran_graph
 from cpdocs.model import stable_entity_id
 
 
@@ -150,6 +151,30 @@ def test_mixed_example_merges_cpp_and_python_units(tmp_path: Path) -> None:
     assert stable_entity_id("python", "function", "pygeom.dot") in graph.entities
 
 
+def test_fortran_doc_comments_ignore_license_preamble(tmp_path: Path) -> None:
+    source = tmp_path / "geometry.f90"
+    source.write_text(
+        "! --------------------------------------------------\n"
+        "! SPDX-License-Identifier: Apache-2.0\n"
+        "! SPDX-FileCopyrightText: 2026 cpdocs developers\n"
+        "! --------------------------------------------------\n"
+        "!> Geometry primitives.\n"
+        "!! Additional detail.\n"
+        "module geometry\n"
+        "end module geometry\n",
+        encoding="utf-8",
+    )
+    graph = extract_fortran_graph(
+        project="example",
+        version="0",
+        project_root=tmp_path,
+        api_roots=[source],
+        feature_set="default",
+    )
+    module = graph.entities[stable_entity_id("fortran", "module", "geometry")]
+    assert module.documentation == "Geometry primitives.\nAdditional detail."
+
+
 def test_fortran_example_and_implementation_file_browser(tmp_path: Path) -> None:
     require("cmake", "ninja")
     project, graph = _build(tmp_path, "fortran-basic")