pyi matching

docforge/__init__.pyi

@@ -1,10 +1,11 @@
-from .loader import GriffeLoader
+from .loader import GriffeLoader, discover_module_paths
 from .renderers import MkDocsRenderer
 from .cli import main
 from . import model
 
 __all__ = [
     "GriffeLoader",
+    "discover_module_paths",
     "MkDocsRenderer",
     "model",
     "main",

docforge/cli/main.pyi

@@ -28,8 +28,7 @@ def tree(
 
 @cli.command()
 @click.option(
-    "--modules",
+    "--module",
-    multiple=True,
     help="Python module import paths to document",
 )
 @click.option(
@@ -42,7 +41,7 @@ def tree(
     default=Path("docs"),
 )
 def generate(
-    modules: Sequence[str],
+    module: str,
     project_name: str | None,
     docs_dir: Path,
 ) -> None:

docforge/nav/mkdocs.pyi

@@ -27,7 +27,7 @@ class MkDocsNavEmitter:
         """
         ...
 
-    def _to_relative(self, path: Path) -> str:
+    def _to_relative(self, path: Path, docs_root: Path | None) -> str:
         """
         Convert a filesystem path to a docs-relative path.
         """

docforge/nav/resolver.pyi

@@ -15,15 +15,14 @@ class ResolvedNav:
 
     home: Optional[str]
     groups: Dict[str, List[Path]]
+    _docs_root: Optional[Path]
 
     def __init__(
         self,
         home: str | None,
         groups: Dict[str, List[Path]],
-        docs_root: Path | None = None,
+        docs_root: Path | None = ...,
-    ) -> None:
+    ) -> None: ...
-        self._docs_root = None
-        ...
 
     def all_files(self) -> Iterable[Path]:
         """