generate_xref_index.py File Reference

Go to the source code of this file.

Namespaces
namespace	generate_xref_index

Functions
list[Path]	generate_xref_index.source_files (Path repo_root)
	Discover source inputs whose dirty bytes determine cross-reference freshness.
str	generate_xref_index.digest_files (Path repo_root, list[Path] paths)
	Hash path names and current file bytes deterministically.
str	generate_xref_index.file_digest (Path path)
	Hash one configuration file.
str	generate_xref_index.repository_path (Path repo_root, str raw)
	Normalize a Doxygen location to a repository-relative POSIX path when possible.
dict[str, dict]	generate_xref_index.parse_xml (Path repo_root, Path xml_dir)
	Extract definition locations and Doxygen reference edges from XML output.
dict[str, dict]	generate_xref_index.distill_symbols (dict[str, dict] symbols)
	Keep production definitions and remap header references to source definitions.
str	generate_xref_index.command_output (list[str] command, Path cwd)
	Return the first line from an orientation-only metadata command.
None	generate_xref_index.generate (Path repo_root, Path xml_dir, Path output)
	Generate the stamped JSON cross-reference index.
argparse.Namespace	generate_xref_index.parse_args (list[str] argv)
	Parse generator command-line arguments.
int	generate_xref_index.main (list[str]|None argv=None)
	Generate the optional index and report actionable failures.

Variables
int	generate_xref_index.SCHEMA_VERSION = 1
tuple	generate_xref_index.SOURCE_ROOTS = ("include", "src", "picurv_cli", "generators")
dict	generate_xref_index.SOURCE_SUFFIXES = {".c", ".cc", ".cpp", ".h", ".hpp", ".py", ".sh", ".flow"}