38 lines
892 B
Python
38 lines
892 B
Python
from pathlib import Path
|
|
|
|
class NavSpec:
|
|
"""
|
|
Parsed representation of `docforge.nav.yml`.
|
|
|
|
This object represents *semantic intent* and is independent
|
|
of filesystem structure or MkDocs specifics.
|
|
"""
|
|
|
|
home: str | None
|
|
groups: dict[str, list[str]]
|
|
|
|
def __init__(
|
|
self,
|
|
home: str | None,
|
|
groups: dict[str, list[str]],
|
|
) -> None: ...
|
|
@classmethod
|
|
def load(cls, path: Path) -> NavSpec:
|
|
"""
|
|
Load and validate a nav specification from YAML.
|
|
|
|
Raises:
|
|
FileNotFoundError: if the file does not exist
|
|
ValueError: if the schema is invalid
|
|
"""
|
|
...
|
|
|
|
def all_patterns(self) -> list[str]:
|
|
"""
|
|
Return all path patterns referenced by the spec
|
|
(including home and group entries).
|
|
"""
|
|
...
|
|
|
|
def load_nav_spec(path: Path) -> NavSpec: ...
|