Walks root_dirs recursively and returns a sorted (relpath, size, sha256) manifest.
Safe-asymmetric matching: honors exclude_dirs (exact resolved paths –
unambiguous) but deliberately does not replicate Doxygen’s
exclude_patterns/file_patterns wildcard matching – Doxygen interprets
those itself, and a client-side reimplementation risks silently diverging.
Over-including a file Doxygen ignores costs an occasional extra rebuild
(safe); under-including a file Doxygen actually uses risks silently stale
docs (unsafe).
Returns:
A list of (relpath, size, sha256) tuples, sorted by relpath, where
Methods
build_source_manifest
build_source_manifest(root_dirs: List, exclude_dirs: List, side_cache: Optional) -> List[Tuple[str, int, str]]
Walks root_dirs recursively and returns a sorted (relpath, size, sha256) manifest.
Safe-asymmetric matching: honors exclude_dirs (exact resolved paths –
unambiguous) but deliberately does not replicate Doxygen’s
exclude_patterns/file_patterns wildcard matching – Doxygen interprets
those itself, and a client-side reimplementation risks silently diverging.
Over-including a file Doxygen ignores costs an occasional extra rebuild
(safe); under-including a file Doxygen actually uses risks silently stale
docs (unsafe).
Returns:
A list of (relpath, size, sha256) tuples, sorted by relpath, where
| Parameter | Type | Description |
|---|---|---|
| root_dirs | List | Source directories to walk recursively. |
| exclude_dirs | List | Exact resolved file/directory paths to skip. |
| side_cache | Optional | Optional HashSideCache to skip re-hashing unchanged files. |
Generated with Flude
Copyright © 2026