cpdocs 0.3.5__tar.gz → 0.3.6__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: cpdocs
-Version: 0.3.5
+Version: 0.3.6
 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.5 → cpdocs-0.3.6}/src/cpdocs/__init__.py

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

{cpdocs-0.3.5 → cpdocs-0.3.6}/src/cpdocs/build.py

@@ -46,7 +46,7 @@ class Layout:
     @classmethod
     def for_output(cls, output: Path, *, tmp_directory: Path | None = None) -> Layout:
         root = (output / "cpdocs").resolve()
-        work_root = (tmp_directory.resolve() / "cpdocs" if tmp_directory else root)
+        work_root = tmp_directory.resolve() / "cpdocs" if tmp_directory else root
         return cls(root=root, work_root=work_root)
 
     @property
@@ -61,7 +61,6 @@ class Layout:
         return self.work_root / "work" / ref.replace("/", "__")
 
 
-
 # --------------------------------------------------------------------------------------------------
 # Extraction
 # --------------------------------------------------------------------------------------------------
@@ -139,7 +138,11 @@ def _api_display_paths(
                 root_relative = path.name
             project_relative = relative_source_path(path, project_root)
             logical = next(
-                (candidate for candidate in (root_relative, project_relative) if candidate in graph.sources),
+                (
+                    candidate
+                    for candidate in (root_relative, project_relative)
+                    if candidate in graph.sources
+                ),
                 None,
             )
             if logical is not None:
@@ -619,9 +622,7 @@ def build_versions(
                 )
             ref_config = _config_for_checkout(config, checkout) if ref.checkout else config
             work = layout.work(ref.name)
-            graph = build_graph(
-                ref_config, source=checkout, work=work, version=ref.name
-            )
+            graph = build_graph(ref_config, source=checkout, work=work, version=ref.name)
             _render(
                 graph,
                 ref_config,

{cpdocs-0.3.5 → cpdocs-0.3.6}/src/cpdocs/cli.py

@@ -55,7 +55,9 @@ def _parser() -> argparse.ArgumentParser:
     python_feature_sets = phases.add_parser("feature-sets", help="write feature-sets.json")
     python_feature_sets.add_argument("--source", type=_path, required=True)
     python_feature_sets.add_argument("--output", type=_path, required=True)
-    python_manifest = phases.add_parser("build", help="build one feature set and write manifest.json")
+    python_manifest = phases.add_parser(
+        "build", help="build one feature set and write manifest.json"
+    )
     python_manifest.add_argument("--source", type=_path, required=True)
     python_manifest.add_argument("--feature-set", type=_path, required=True)
     python_manifest.add_argument("--output", type=_path, required=True)

{cpdocs-0.3.5 → cpdocs-0.3.6}/src/cpdocs/config.py

@@ -66,7 +66,6 @@ def _strings(value: object, name: str, *, default: tuple[str, ...] = ()) -> tupl
     return result
 
 
-
 def _versions(value: object) -> tuple[str, ...]:
     versions = _strings(value, "versions", default=("main",))
     if not versions:

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

@@ -160,7 +160,9 @@ def read_manifest(path: Path, *, source: Path) -> Manifest:
     if raw.get("cpdocs-manifest") != CONTRACT_VERSION:
         raise ContractError(f"{path}: unsupported cpdocs-manifest {raw.get('cpdocs-manifest')!r}")
     option_metadata = raw.get("options", [])
-    if not isinstance(option_metadata, list) or any(not isinstance(x, dict) for x in option_metadata):
+    if not isinstance(option_metadata, list) or any(
+        not isinstance(x, dict) for x in option_metadata
+    ):
         raise ContractError(f"{path}: options must be a list of objects")
     declarations = _units(raw.get("units"), path)
     units: list[UnitManifest] = []
@@ -202,8 +204,7 @@ def read_manifest(path: Path, *, source: Path) -> Manifest:
                 )
             options = _mapping(data.get("parse", {}), f"{where}.parse", path)
             parser_language = str(
-                options.get("language")
-                or ("c" if declaration.language == "c" else "cpp")
+                options.get("language") or ("c" if declaration.language == "c" else "cpp")
             )
             if parser_language not in PARSER_LANGUAGES:
                 raise ContractError(
@@ -238,9 +239,7 @@ def read_manifest(path: Path, *, source: Path) -> Manifest:
             # Fortran modules carry their public declarations in source files rather than headers.
             # Build-system manifests expose module roots through the semantic ``modules`` field.
             if not api and not modules:
-                raise ContractError(
-                    f"{path}: {where}: a Fortran unit needs an API or modules root"
-                )
+                raise ContractError(f"{path}: {where}: a Fortran unit needs an API or modules root")
 
         units.append(
             UnitManifest(

{cpdocs-0.3.5 → cpdocs-0.3.6}/src/cpdocs/languages/cpp/render.py

@@ -45,7 +45,9 @@ def entity_declaration(entity: ApiEntity) -> str:
 
 def signature_spelling(entity: ApiEntity, signature: ApiSignature) -> str:
     attribute_spellings = list(
-        dict.fromkeys(attribute.spelling for attribute in signature.attributes if attribute.spelling)
+        dict.fromkeys(
+            attribute.spelling for attribute in signature.attributes if attribute.spelling
+        )
     )
     attribute_prefix = " ".join(attribute_spellings)
     if signature.spelling:

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

@@ -259,7 +259,9 @@ def extract_fortran_graph(
                         for value in arguments
                     )
                     kind = "function" if kind_text.casefold() == "function" else "subroutine"
-                    returns = _declaration_type(prefix) if kind_text.casefold() == "function" else ""
+                    returns = (
+                        _declaration_type(prefix) if kind_text.casefold() == "function" else ""
+                    )
                     qualified = f"{module_name}::{name}"
                     signature = ApiSignature(
                         parameters=parameters,

{cpdocs-0.3.5 → cpdocs-0.3.6}/src/cpdocs/languages/fortran/render.py

@@ -54,7 +54,9 @@ RENDERING = LanguageRendering(
     type_like_kinds=frozenset({"derived_type"}),
     function_kinds=frozenset({"function", "subroutine"}),
     member_value_kinds=frozenset({"variable", "attribute", "constant"}),
-    source_suffixes=frozenset({".f", ".for", ".ftn", ".f77", ".f90", ".f95", ".f03", ".f08", ".f18"}),
+    source_suffixes=frozenset(
+        {".f", ".for", ".ftn", ".f77", ".f90", ".f95", ".f03", ".f08", ".f18"}
+    ),
     kind_markers={
         "module": "M",
         "derived_type": "T",

{cpdocs-0.3.5 → cpdocs-0.3.6}/src/cpdocs/languages/rust/extract.py

@@ -249,6 +249,7 @@ def _ownership(index: dict[str, object]) -> tuple[dict[str, str], set[str], set[
 
     return owners, inherent_impl_items, trait_impl_items
 
+
 def build_rust_graph(
     *, rustdoc_json: Path, project: str, version: str = "main", project_root: Path | None = None
 ) -> ApiGraph:

{cpdocs-0.3.5 → cpdocs-0.3.6}/src/cpdocs/languages/rust/render.py

@@ -29,7 +29,9 @@ def signature_spelling(entity: ApiEntity, signature: ApiSignature) -> str:
     modifiers = [value for value in entity.properties if value != "pub"]
     visibility = "pub " if "pub" in entity.properties else ""
     modifier_prefix = (" ".join(modifiers) + " ") if modifiers else ""
-    value = f"{visibility}{modifier_prefix}fn {entity.qualified_name}({parameter_spelling(signature)})"
+    value = (
+        f"{visibility}{modifier_prefix}fn {entity.qualified_name}({parameter_spelling(signature)})"
+    )
     if signature.returns:
         value += f" -> {signature.returns}"
     return value

{cpdocs-0.3.5 → cpdocs-0.3.6}/src/cpdocs/model.py

@@ -110,7 +110,9 @@ class ApiGraph:
             existing.signature_feature_sets.append([])
         for index, signature in enumerate(entity.signatures):
             incoming = (
-                entity.signature_feature_sets[index] if index < len(entity.signature_feature_sets) else []
+                entity.signature_feature_sets[index]
+                if index < len(entity.signature_feature_sets)
+                else []
             )
             if signature not in existing.signatures:
                 existing.signatures.append(signature)

{cpdocs-0.3.5 → cpdocs-0.3.6}/src/cpdocs/plugins/properdocs/plugin.py

@@ -164,9 +164,7 @@ class CpdocsPlugin(BasePlugin):
     def _fingerprint(self) -> _Fingerprint:
         return self._fingerprint_paths(self._watched_files())
 
-    def _subsite_fingerprint(
-        self, project: Path, watched_files: list[Path]
-    ) -> _Fingerprint:
+    def _subsite_fingerprint(self, project: Path, watched_files: list[Path]) -> _Fingerprint:
         """Fingerprint one subsite and cpdocs itself, but not unrelated project docs."""
 
         assert self._project_root is not None
@@ -367,8 +365,7 @@ class CpdocsPlugin(BasePlugin):
         )
         if result.returncode != 0:
             raise PluginError(
-                f"cpdocs: ProperDocs subsite build failed for {mount.as_posix()}:\n"
-                f"{result.stdout}"
+                f"cpdocs: ProperDocs subsite build failed for {mount.as_posix()}:\n{result.stdout}"
             )
         _LOG.info("Built ProperDocs subsite %s", mount.as_posix())
 

{cpdocs-0.3.5 → cpdocs-0.3.6}/src/cpdocs/providers/cargo.py

@@ -75,7 +75,9 @@ def _package(metadata: dict[str, Any], source: Path, package: str | None) -> dic
     if package:
         matches = [item for item in packages if item.get("name") == package]
         if len(matches) != 1:
-            raise RuntimeError(f"cpdocs rust: Cargo package {package!r} is not unique in the workspace")
+            raise RuntimeError(
+                f"cpdocs rust: Cargo package {package!r} is not unique in the workspace"
+            )
         return matches[0]
 
     root_manifest = (source / "Cargo.toml").resolve()
@@ -186,8 +188,10 @@ def _browse_roots(source: Path, package: dict[str, Any], target: dict[str, Any])
     src_path = target.get("src_path")
     if isinstance(src_path, str):
         src = Path(src_path)
-        if src.exists() and src not in roots and not any(
-            root.is_dir() and root in src.parents for root in roots
+        if (
+            src.exists()
+            and src not in roots
+            and not any(root.is_dir() and root in src.parents for root in roots)
         ):
             roots.append(src)
     return [_relative_or_absolute(root, source) for root in roots]
@@ -261,7 +265,7 @@ def write_manifest(
     rustdoc_json = target_dir / "doc" / f"{target_name}.json"
     if not rustdoc_json.is_file():
         raise RuntimeError(
-            "cpdocs rust: cargo rustdoc succeeded but did not produce " f"{rustdoc_json}"
+            f"cpdocs rust: cargo rustdoc succeeded but did not produce {rustdoc_json}"
         )
 
     manifest = {

{cpdocs-0.3.5 → cpdocs-0.3.6}/src/cpdocs/rendering/common.py

@@ -52,6 +52,7 @@ def split_qualified(name: str, separator: str) -> list[str]:
 def _segments(entity: ApiEntity) -> list[str]:
     return split_qualified(entity.qualified_name, rendering_for(entity.language).separator)
 
+
 # Operator names as words, longest spelling first, so that ``operator<<`` is not read as ``<``.
 _OPERATOR_WORDS = (
     ("<=>", "spaceship"),
@@ -482,7 +483,8 @@ def _preferred_type_target(name: str, entity: ApiEntity, graph: ApiGraph) -> Api
     candidates = [
         candidate
         for candidate in graph.entities.values()
-        if candidate.kind in rendering_for(candidate.language).type_like_kinds and candidate.name == name
+        if candidate.kind in rendering_for(candidate.language).type_like_kinds
+        and candidate.name == name
     ]
     if not candidates:
         return None

{cpdocs-0.3.5 → cpdocs-0.3.6}/src/cpdocs/rendering/html.py

@@ -176,7 +176,9 @@ def _kind_label(kind: str, language: str | None = None) -> str:
 
 def _kind_badge(kind: str, language: str | None = None) -> str:
     marker = html.escape(_kind_marker(kind, language))
-    return f'<span class="api-kind" title="{html.escape(_kind_label(kind, language))}">{marker}</span>'
+    return (
+        f'<span class="api-kind" title="{html.escape(_kind_label(kind, language))}">{marker}</span>'
+    )
 
 
 def _language_label(language: str) -> str:
@@ -209,7 +211,7 @@ def _feature_set_inline(graph: ApiGraph, key: str) -> str:
     features = _feature_set_features(graph, key)
     if not features:
         return '<span class="api-feature-set-empty">default (no features enabled)</span>'
-    return " ".join(f'<code>{html.escape(feature)}</code>' for feature in features)
+    return " ".join(f"<code>{html.escape(feature)}</code>" for feature in features)
 
 
 def _legend(graph: ApiGraph) -> str:
@@ -522,9 +524,7 @@ def _availability(
         )
     return (
         '<div class="api-availability"><strong>Available in feature sets</strong>'
-        '<ul class="api-availability-list">'
-        + "".join(rows)
-        + "</ul></div>"
+        '<ul class="api-availability-list">' + "".join(rows) + "</ul></div>"
     )
 
 
@@ -1030,19 +1030,20 @@ def _feature_sets_page(graph: ApiGraph, document: Path) -> tuple[str, list[tuple
             "</tbody></table></section>",
             '<section id="feature-sets" class="api-section"><h2>Feature Sets</h2>',
             '<table class="api-feature-set-table">',
-            '<thead><tr><th>Feature set</th><th>Enabled features</th></tr></thead>',
-            '<tbody>',
+            "<thead><tr><th>Feature set</th><th>Enabled features</th></tr></thead>",
+            "<tbody>",
         ]
     )
-    toc: list[tuple[str, str, int]] = [("Overview", "overview", 1), ("Feature Sets", "feature-sets", 1)]
+    toc: list[tuple[str, str, int]] = [
+        ("Overview", "overview", 1),
+        ("Feature Sets", "feature-sets", 1),
+    ]
     for index, key in enumerate(graph.feature_sets, 1):
         anchor = _feature_set_anchor(key)
         body.append(
             f'<tr id="{html.escape(anchor)}">'
             f'<th scope="row">{index}</th>'
-            '<td>'
-            + _feature_set_inline(graph, key)
-            + '</td></tr>'
+            "<td>" + _feature_set_inline(graph, key) + "</td></tr>"
         )
     body.append("</tbody></table></section>")
     # Option metadata are documentation of each resolved build, not extra feature axes.
@@ -1052,18 +1053,25 @@ def _feature_sets_page(graph: ApiGraph, document: Path) -> tuple[str, list[tuple
         first = next(iter(graph.feature_sets), None)
         options = configurations.get(first, [])
         if isinstance(options, list) and options:
-            body.extend([
-                '<section id="configuration-options" class="api-section">',
-                "<h2>Configuration options</h2>",
-                "<p>Effective CMake cache values from the first documented feature set. "
-                "Only project features determine the feature-set combinations above.</p>",
-                '<table><thead><tr><th>Group</th><th>Option</th><th>Value</th><th>Description</th></tr></thead><tbody>',
-            ])
+            body.extend(
+                [
+                    '<section id="configuration-options" class="api-section">',
+                    "<h2>Configuration options</h2>",
+                    "<p>Effective CMake cache values from the first documented feature set. "
+                    "Only project features determine the feature-set combinations above.</p>",
+                    "<table><thead><tr><th>Group</th><th>Option</th><th>Value</th><th>Description</th></tr></thead><tbody>",
+                ]
+            )
             for option in options:
                 if not isinstance(option, dict):
                     continue
-                cells = [str(option.get(field, "")) for field in ("group", "name", "value", "description")]
-                body.append("<tr>" + "".join(f"<td>{html.escape(value)}</td>" for value in cells) + "</tr>")
+                cells = [
+                    str(option.get(field, ""))
+                    for field in ("group", "name", "value", "description")
+                ]
+                body.append(
+                    "<tr>" + "".join(f"<td>{html.escape(value)}</td>" for value in cells) + "</tr>"
+                )
             body.append("</tbody></table></section>")
             toc.append(("Configuration options", "configuration-options", 1))
     return "".join(body), toc
@@ -1100,9 +1108,8 @@ def _source_page(
     display_path = _display_source_path(source_path, graph)
     generated_sources = graph.metadata.get("generated_sources", [])
     generated_files = graph.metadata.get("generated_files", [])
-    generated = (
-        (isinstance(generated_sources, list) and source_path in generated_sources)
-        or (isinstance(generated_files, list) and source_path in generated_files)
+    generated = (isinstance(generated_sources, list) and source_path in generated_sources) or (
+        isinstance(generated_files, list) and source_path in generated_files
     )
     note = (
         '<p class="api-section-intro">Generated by the build; not part of the repository.</p>'

{cpdocs-0.3.5 → cpdocs-0.3.6}/test/test_api_reference.py

@@ -293,7 +293,10 @@ def test_renderer_generates_standalone_code_oriented_html_site(tmp_path: Path) -
     graph.add(package)
     graph.add(macro)
     graph.sources["dice/version.hpp"] = "#pragma once\nnamespace dice { namespace meta {} }\n"
-    graph.feature_sets["feature-set-001"] = {"features": ["cpu"], "selection": {"features": ["cpu"]}}
+    graph.feature_sets["feature-set-001"] = {
+        "features": ["cpu"],
+        "selection": {"features": ["cpu"]},
+    }
     graph.metadata = {
         "units": [{"id": "dice", "language": "cpp"}],
         "generator": "test",
@@ -395,7 +398,10 @@ def test_renderer_generates_standalone_code_oriented_html_site(tmp_path: Path) -
     assert "grid-template-columns: 1.45rem minmax(0, 1fr) auto auto" in css
     assert ".api-outline-language { min-width: 0; justify-self: end; overflow: hidden; }" in css
     assert "text-overflow: ellipsis" in css
-    assert '<span class="api-outline-language"><span class="api-language-badge">C++</span></span>' in home_page
+    assert (
+        '<span class="api-outline-language"><span class="api-language-badge">C++</span></span>'
+        in home_page
+    )
     assert "border: 1px solid var(--api-border)" in css
     assert '"dice::foo"' in (site / "symbols.json").read_text(encoding="utf-8")
 

{cpdocs-0.3.5 → cpdocs-0.3.6}/test/test_build.py

@@ -40,7 +40,9 @@ def test_semantic_file_layout_flattens_manifest_roots(tmp_path: Path) -> None:
     source.write_text("// source\n", encoding="utf-8")
 
     assert _semantic_display_path(header, root=include, generated=False) == "include/kprof/cuda.hpp"
-    assert _semantic_display_path(source, root=library, generated=False) == "lib/kprof/synchronize.cu"
+    assert (
+        _semantic_display_path(source, root=library, generated=False) == "lib/kprof/synchronize.cu"
+    )
     assert (
         _semantic_display_path(header, root=include, generated=True)
         == "_generated/include/kprof/cuda.hpp"
@@ -86,7 +88,7 @@ def test_failing_build_command_reports_its_output(tmp_path: Path) -> None:
     (project / "docs" / "cpdocs.yml").write_text(
         "contract: 3\nbuild:\n"
         "  feature-sets: >-\n    python -c \"import sys; print('boom'); sys.exit(3)\"\n"
-        "  build: \"true\"\n",
+        '  build: "true"\n',
         encoding="utf-8",
     )
     with pytest.raises(RuntimeError, match="boom"):

{cpdocs-0.3.5 → cpdocs-0.3.6}/test/test_config.py

@@ -81,10 +81,22 @@ checks:
         ("build:\n  feature-sets: make\n  build: make\n", "contract must be 3"),
         ("contract: 3\n", "build.feature-sets"),
         ("contract: 3\nbuild:\n  feature-sets: [make]\n  build: make\n", "command string"),
-        ("contract: 3\nbuild:\n  feature-sets: make\n  build: make\n  manifest: make\n", "unknown build keys"),
-        ("contract: 3\nbuild:\n  feature-sets: make\n  build: make\nversions: {tags: all}\n", "versions must be a list"),
-        ("contract: 3\nbuild:\n  feature-sets: make\n  build: make\nversions: [main, main]\n", "duplicates"),
-        ("contract: 3\nbuild:\n  feature-sets: make\n  build: make\nversions: []\n", "at least one version"),
+        (
+            "contract: 3\nbuild:\n  feature-sets: make\n  build: make\n  manifest: make\n",
+            "unknown build keys",
+        ),
+        (
+            "contract: 3\nbuild:\n  feature-sets: make\n  build: make\nversions: {tags: all}\n",
+            "versions must be a list",
+        ),
+        (
+            "contract: 3\nbuild:\n  feature-sets: make\n  build: make\nversions: [main, main]\n",
+            "duplicates",
+        ),
+        (
+            "contract: 3\nbuild:\n  feature-sets: make\n  build: make\nversions: []\n",
+            "at least one version",
+        ),
     ],
 )
 def test_invalid_configs_are_rejected(tmp_path: Path, text: str, message: str) -> None:

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

@@ -50,14 +50,17 @@ def test_cpp_features_example_documents_every_feature_set(tmp_path: Path) -> Non
         return {tuple(graph.feature_sets[key]["features"]) for key in entity.feature_sets}
 
     assert feature_sets("struct", "demo::settings") == {(), ("mpi",), ("mpi", "cuda")}
-    assert feature_sets("struct", "demo::communicator") == {( "mpi",), ("mpi", "cuda")}
-    assert feature_sets("struct", "demo::device") == {( "mpi", "cuda")}
+    assert feature_sets("struct", "demo::communicator") == {("mpi",), ("mpi", "cuda")}
+    assert feature_sets("struct", "demo::device") == {("mpi", "cuda")}
     solve = graph.entities[stable_entity_id("cpp", "function", "demo::solve")]
     assert len(solve.signatures) == 3
     by_parameters = {
         signature.compact: (set(feature_sets), signature.documentation)
-        for signature, feature_sets in zip(solve.signatures, solve.signature_feature_sets, strict=True)
+        for signature, feature_sets in zip(
+            solve.signatures, solve.signature_feature_sets, strict=True
+        )
     }
+
     def resolved(keys: set[str]) -> set[tuple[str, ...]]:
         return {tuple(graph.feature_sets[key]["features"]) for key in keys}
 
@@ -74,13 +77,7 @@ def test_cpp_features_example_documents_every_feature_set(tmp_path: Path) -> Non
 
     feature_sets = json.loads(
         (
-            project
-            / "build"
-            / "cpdocs"
-            / "work"
-            / "current"
-            / "feature-sets"
-            / "feature-sets.json"
+            project / "build" / "cpdocs" / "work" / "current" / "feature-sets" / "feature-sets.json"
         ).read_text()
     )
     selected = [item["features"] for item in feature_sets["feature-sets"]]
@@ -202,14 +199,7 @@ def test_cpp_file_hierarchy_includes_implementation_sources(tmp_path: Path) -> N
     project, graph = _build(tmp_path, "basic-cpp")
     assert "src/math.cpp" in graph.files
     implementation = (
-        project
-        / "build"
-        / "cpdocs"
-        / "current"
-        / "_sources"
-        / "src"
-        / "math.cpp"
-        / "index.html"
+        project / "build" / "cpdocs" / "current" / "_sources" / "src" / "math.cpp" / "index.html"
     )
     assert implementation.is_file()
     assert "File: src/math.cpp" in implementation.read_text(encoding="utf-8")

{cpdocs-0.3.5 → cpdocs-0.3.6}/test/test_feature_set_signatures.py

@@ -16,7 +16,7 @@ from cpdocs.config import load_config
 from cpdocs.model import stable_entity_id
 from cpdocs.rendering.common import entity_document
 
-PROVIDER = r'''
+PROVIDER = r"""
 import json, pathlib, sys
 
 command = sys.argv[1]
@@ -48,7 +48,7 @@ else:
     }
 output.parent.mkdir(parents=True, exist_ok=True)
 output.write_text(json.dumps(value), encoding="utf-8")
-'''
+"""
 
 
 def test_same_function_can_have_cpp_and_cuda_definitions(tmp_path: Path) -> None:

{cpdocs-0.3.5 → cpdocs-0.3.6}/test/test_properdocs_core.py

@@ -135,9 +135,7 @@ def test_serve_reuses_cached_subsites_until_their_inputs_change(
         del project_arg, mount, strict
         builds.append(destination)
         destination.mkdir(parents=True, exist_ok=True)
-        (destination / "index.html").write_text(
-            f"build {len(builds)}\n", encoding="utf-8"
-        )
+        (destination / "index.html").write_text(f"build {len(builds)}\n", encoding="utf-8")
 
     monkeypatch.setattr(plugin, "_run_subsite_build", fake_build)
 

{cpdocs-0.3.5 → cpdocs-0.3.6}/test/test_rust_example.py

@@ -44,39 +44,28 @@ def test_rust_example_uses_disjoint_cargo_features_and_rustdoc_json(tmp_path: Pa
         ["checked"],
     ]
 
-    vector = graph.entities[
-        stable_entity_id("rust", "struct", "rust_geometry::geometry::Vector3")
-    ]
+    vector = graph.entities[stable_entity_id("rust", "struct", "rust_geometry::geometry::Vector3")]
     assert vector.documentation == "A three-dimensional vector."
-    dot = graph.entities[
-        stable_entity_id("rust", "function", "rust_geometry::geometry::dot")
-    ]
+    dot = graph.entities[stable_entity_id("rust", "function", "rust_geometry::geometry::dot")]
     assert dot.documentation == "Return the dot product of two vectors."
 
     dot_many = graph.entities[
         stable_entity_id("rust", "function", "rust_geometry::geometry::dot_many")
     ]
-    assert {
-        tuple(graph.feature_sets[key]["features"]) for key in dot_many.feature_sets
-    } == {("batch",)}
+    assert {tuple(graph.feature_sets[key]["features"]) for key in dot_many.feature_sets} == {
+        ("batch",)
+    }
     checked_dot = graph.entities[
         stable_entity_id("rust", "function", "rust_geometry::geometry::checked_dot")
     ]
-    assert {
-        tuple(graph.feature_sets[key]["features"]) for key in checked_dot.feature_sets
-    } == {("checked",)}
+    assert {tuple(graph.feature_sets[key]["features"]) for key in checked_dot.feature_sets} == {
+        ("checked",)
+    }
 
     assert "src/internal.rs" in graph.files
     assert not any(entity.name == "norm_squared" for entity in graph.entities.values())
     source_page = (
-        project
-        / "build"
-        / "cpdocs"
-        / "current"
-        / "_sources"
-        / "src"
-        / "internal.rs"
-        / "index.html"
+        project / "build" / "cpdocs" / "current" / "_sources" / "src" / "internal.rs" / "index.html"
     )
     assert source_page.is_file()
     assert "norm_squared" in source_page.read_text(encoding="utf-8")