doc changes
This commit is contained in:
@@ -64,7 +64,11 @@ def tree(
|
|||||||
|
|
||||||
def _print_object(obj, indent: str) -> None:
|
def _print_object(obj, indent: str) -> None:
|
||||||
"""
|
"""
|
||||||
Recursive helper to print doc objects.
|
Recursive helper to print doc objects and their members to the console.
|
||||||
|
|
||||||
|
Args:
|
||||||
|
obj: The DocObject to print.
|
||||||
|
indent: The current line indentation string.
|
||||||
"""
|
"""
|
||||||
click.echo(f"{indent}├── {obj.name}")
|
click.echo(f"{indent}├── {obj.name}")
|
||||||
for member in obj.get_all_members():
|
for member in obj.get_all_members():
|
||||||
@@ -262,7 +266,7 @@ def serve(mkdocs_yml: Path) -> None:
|
|||||||
|
|
||||||
def main() -> None:
|
def main() -> None:
|
||||||
"""
|
"""
|
||||||
CLI Entry point.
|
CLI Entry point. Boots the click application.
|
||||||
"""
|
"""
|
||||||
cli()
|
cli()
|
||||||
|
|
||||||
|
|||||||
@@ -134,6 +134,15 @@ class GriffeLoader:
|
|||||||
# -------------------------
|
# -------------------------
|
||||||
|
|
||||||
def _convert_module(self, obj: Object) -> Module:
|
def _convert_module(self, obj: Object) -> Module:
|
||||||
|
"""
|
||||||
|
Convert a Griffe Object (module) into a docforge Module.
|
||||||
|
|
||||||
|
Args:
|
||||||
|
obj: The Griffe Object representing the module.
|
||||||
|
|
||||||
|
Returns:
|
||||||
|
A populated Module instance.
|
||||||
|
"""
|
||||||
module = Module(
|
module = Module(
|
||||||
path=obj.path,
|
path=obj.path,
|
||||||
docstring=self._safe_docstring(obj),
|
docstring=self._safe_docstring(obj),
|
||||||
@@ -148,6 +157,15 @@ class GriffeLoader:
|
|||||||
return module
|
return module
|
||||||
|
|
||||||
def _convert_object(self, obj: Object) -> DocObject:
|
def _convert_object(self, obj: Object) -> DocObject:
|
||||||
|
"""
|
||||||
|
Recursively convert a Griffe Object into a DocObject hierarchy.
|
||||||
|
|
||||||
|
Args:
|
||||||
|
obj: The Griffe Object to convert.
|
||||||
|
|
||||||
|
Returns:
|
||||||
|
A DocObject instance.
|
||||||
|
"""
|
||||||
kind = obj.kind.value
|
kind = obj.kind.value
|
||||||
signature = self._safe_signature(obj)
|
signature = self._safe_signature(obj)
|
||||||
|
|
||||||
@@ -174,12 +192,30 @@ class GriffeLoader:
|
|||||||
# -------------------------
|
# -------------------------
|
||||||
|
|
||||||
def _safe_docstring(self, obj: Object) -> Optional[str]:
|
def _safe_docstring(self, obj: Object) -> Optional[str]:
|
||||||
|
"""
|
||||||
|
Safely retrieve the docstring value from a Griffe object.
|
||||||
|
|
||||||
|
Args:
|
||||||
|
obj: The Griffe Object to inspect.
|
||||||
|
|
||||||
|
Returns:
|
||||||
|
The raw docstring string, or None if missing or unresolvable.
|
||||||
|
"""
|
||||||
try:
|
try:
|
||||||
return obj.docstring.value if obj.docstring else None
|
return obj.docstring.value if obj.docstring else None
|
||||||
except AliasResolutionError:
|
except AliasResolutionError:
|
||||||
return None
|
return None
|
||||||
|
|
||||||
def _safe_signature(self, obj: Object) -> Optional[str]:
|
def _safe_signature(self, obj: Object) -> Optional[str]:
|
||||||
|
"""
|
||||||
|
Safely retrieve the signature string from a Griffe object.
|
||||||
|
|
||||||
|
Args:
|
||||||
|
obj: The Griffe Object to inspect.
|
||||||
|
|
||||||
|
Returns:
|
||||||
|
The string representation of the signature, or None.
|
||||||
|
"""
|
||||||
try:
|
try:
|
||||||
if hasattr(obj, "signature") and obj.signature:
|
if hasattr(obj, "signature") and obj.signature:
|
||||||
return str(obj.signature)
|
return str(obj.signature)
|
||||||
|
|||||||
@@ -78,6 +78,18 @@ def resolve_nav(
|
|||||||
raise FileNotFoundError(docs_root)
|
raise FileNotFoundError(docs_root)
|
||||||
|
|
||||||
def resolve_pattern(pattern: str) -> List[Path]:
|
def resolve_pattern(pattern: str) -> List[Path]:
|
||||||
|
"""
|
||||||
|
Resolve a single glob pattern relative to the docs_root.
|
||||||
|
|
||||||
|
Args:
|
||||||
|
pattern: The glob pattern to resolve.
|
||||||
|
|
||||||
|
Returns:
|
||||||
|
A sorted list of matching Path objects.
|
||||||
|
|
||||||
|
Raises:
|
||||||
|
FileNotFoundError: If the pattern doesn't match any files.
|
||||||
|
"""
|
||||||
full = docs_root / pattern
|
full = docs_root / pattern
|
||||||
matches = sorted(
|
matches = sorted(
|
||||||
Path(p) for p in glob.glob(str(full), recursive=True)
|
Path(p) for p in glob.glob(str(full), recursive=True)
|
||||||
|
|||||||
@@ -13,6 +13,13 @@ class MCPServer:
|
|||||||
"""
|
"""
|
||||||
|
|
||||||
def __init__(self, mcp_root: Path, name: str) -> None:
|
def __init__(self, mcp_root: Path, name: str) -> None:
|
||||||
|
"""
|
||||||
|
Initialize the MCPServer.
|
||||||
|
|
||||||
|
Args:
|
||||||
|
mcp_root: Path to the directory containing pre-built MCP JSON resources.
|
||||||
|
name: Name of the MCP server.
|
||||||
|
"""
|
||||||
self.mcp_root = mcp_root
|
self.mcp_root = mcp_root
|
||||||
self.app = FastMCP(name)
|
self.app = FastMCP(name)
|
||||||
|
|
||||||
@@ -24,6 +31,15 @@ class MCPServer:
|
|||||||
# ------------------------------------------------------------------
|
# ------------------------------------------------------------------
|
||||||
|
|
||||||
def _read_json(self, path: Path) -> Any:
|
def _read_json(self, path: Path) -> Any:
|
||||||
|
"""
|
||||||
|
Read and parse a JSON file, returning diagnostic errors if missing.
|
||||||
|
|
||||||
|
Args:
|
||||||
|
path: Path to the JSON file.
|
||||||
|
|
||||||
|
Returns:
|
||||||
|
The parsed JSON data or an error dictionary.
|
||||||
|
"""
|
||||||
if not path.exists():
|
if not path.exists():
|
||||||
return {
|
return {
|
||||||
"error": "not_found",
|
"error": "not_found",
|
||||||
@@ -36,6 +52,9 @@ class MCPServer:
|
|||||||
# ------------------------------------------------------------------
|
# ------------------------------------------------------------------
|
||||||
|
|
||||||
def _register_resources(self) -> None:
|
def _register_resources(self) -> None:
|
||||||
|
"""
|
||||||
|
Register MCP resources for index, nav, and individual modules.
|
||||||
|
"""
|
||||||
@self.app.resource("docs://index")
|
@self.app.resource("docs://index")
|
||||||
def index():
|
def index():
|
||||||
return self._read_json(self.mcp_root / "index.json")
|
return self._read_json(self.mcp_root / "index.json")
|
||||||
@@ -55,6 +74,9 @@ class MCPServer:
|
|||||||
# ------------------------------------------------------------------
|
# ------------------------------------------------------------------
|
||||||
|
|
||||||
def _register_tools(self) -> None:
|
def _register_tools(self) -> None:
|
||||||
|
"""
|
||||||
|
Register high-level MCP tools for diagnostics.
|
||||||
|
"""
|
||||||
@self.app.tool()
|
@self.app.tool()
|
||||||
def ping() -> str:
|
def ping() -> str:
|
||||||
return "pong"
|
return "pong"
|
||||||
|
|||||||
@@ -140,43 +140,43 @@
|
|||||||
"name": "generate",
|
"name": "generate",
|
||||||
"kind": "function",
|
"kind": "function",
|
||||||
"path": "docforge.cli.main.generate",
|
"path": "docforge.cli.main.generate",
|
||||||
"signature": "<bound method Function.signature of Function('generate', 78, 118)>",
|
"signature": "<bound method Function.signature of Function('generate', 82, 122)>",
|
||||||
"docstring": "Generate Markdown source files for the specified module.\n\nArgs:\n module: The primary module path to document.\n project_name: Optional project name override.\n docs_dir: Directory where documentation sources will be written."
|
"docstring": "Generate Markdown source files for the specified module.\n\nArgs:\n module: The primary module path to document.\n project_name: Optional project name override.\n docs_dir: Directory where documentation sources will be written."
|
||||||
},
|
},
|
||||||
"generate_mcp": {
|
"generate_mcp": {
|
||||||
"name": "generate_mcp",
|
"name": "generate_mcp",
|
||||||
"kind": "function",
|
"kind": "function",
|
||||||
"path": "docforge.cli.main.generate_mcp",
|
"path": "docforge.cli.main.generate_mcp",
|
||||||
"signature": "<bound method Function.signature of Function('generate_mcp', 125, 164)>",
|
"signature": "<bound method Function.signature of Function('generate_mcp', 129, 168)>",
|
||||||
"docstring": "Generate MCP-compatible documentation resources for the specified module.\n\nArgs:\n module: The primary module path to document.\n project_name: Optional project name override.\n out_dir: Directory where MCP resources will be written."
|
"docstring": "Generate MCP-compatible documentation resources for the specified module.\n\nArgs:\n module: The primary module path to document.\n project_name: Optional project name override.\n out_dir: Directory where MCP resources will be written."
|
||||||
},
|
},
|
||||||
"build": {
|
"build": {
|
||||||
"name": "build",
|
"name": "build",
|
||||||
"kind": "function",
|
"kind": "function",
|
||||||
"path": "docforge.cli.main.build",
|
"path": "docforge.cli.main.build",
|
||||||
"signature": "<bound method Function.signature of Function('build', 171, 192)>",
|
"signature": "<bound method Function.signature of Function('build', 175, 196)>",
|
||||||
"docstring": "Build the documentation site using MkDocs.\n\nArgs:\n mkdocs_yml: Path to the mkdocs.yml configuration file."
|
"docstring": "Build the documentation site using MkDocs.\n\nArgs:\n mkdocs_yml: Path to the mkdocs.yml configuration file."
|
||||||
},
|
},
|
||||||
"serve_mcp": {
|
"serve_mcp": {
|
||||||
"name": "serve_mcp",
|
"name": "serve_mcp",
|
||||||
"kind": "function",
|
"kind": "function",
|
||||||
"path": "docforge.cli.main.serve_mcp",
|
"path": "docforge.cli.main.serve_mcp",
|
||||||
"signature": "<bound method Function.signature of Function('serve_mcp', 199, 226)>",
|
"signature": "<bound method Function.signature of Function('serve_mcp', 203, 230)>",
|
||||||
"docstring": "Serve MCP documentation from the local mcp_docs directory."
|
"docstring": "Serve MCP documentation from the local mcp_docs directory."
|
||||||
},
|
},
|
||||||
"serve": {
|
"serve": {
|
||||||
"name": "serve",
|
"name": "serve",
|
||||||
"kind": "function",
|
"kind": "function",
|
||||||
"path": "docforge.cli.main.serve",
|
"path": "docforge.cli.main.serve",
|
||||||
"signature": "<bound method Function.signature of Function('serve', 233, 256)>",
|
"signature": "<bound method Function.signature of Function('serve', 237, 260)>",
|
||||||
"docstring": "Serve the documentation site with live-reload using MkDocs.\n\nArgs:\n mkdocs_yml: Path to the mkdocs.yml configuration file."
|
"docstring": "Serve the documentation site with live-reload using MkDocs.\n\nArgs:\n mkdocs_yml: Path to the mkdocs.yml configuration file."
|
||||||
},
|
},
|
||||||
"main": {
|
"main": {
|
||||||
"name": "main",
|
"name": "main",
|
||||||
"kind": "function",
|
"kind": "function",
|
||||||
"path": "docforge.cli.main.main",
|
"path": "docforge.cli.main.main",
|
||||||
"signature": "<bound method Function.signature of Function('main', 263, 267)>",
|
"signature": "<bound method Function.signature of Function('main', 267, 271)>",
|
||||||
"docstring": "CLI Entry point."
|
"docstring": "CLI Entry point. Boots the click application."
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
|
|||||||
@@ -133,43 +133,43 @@
|
|||||||
"name": "generate",
|
"name": "generate",
|
||||||
"kind": "function",
|
"kind": "function",
|
||||||
"path": "docforge.cli.main.generate",
|
"path": "docforge.cli.main.generate",
|
||||||
"signature": "<bound method Function.signature of Function('generate', 78, 118)>",
|
"signature": "<bound method Function.signature of Function('generate', 82, 122)>",
|
||||||
"docstring": "Generate Markdown source files for the specified module.\n\nArgs:\n module: The primary module path to document.\n project_name: Optional project name override.\n docs_dir: Directory where documentation sources will be written."
|
"docstring": "Generate Markdown source files for the specified module.\n\nArgs:\n module: The primary module path to document.\n project_name: Optional project name override.\n docs_dir: Directory where documentation sources will be written."
|
||||||
},
|
},
|
||||||
"generate_mcp": {
|
"generate_mcp": {
|
||||||
"name": "generate_mcp",
|
"name": "generate_mcp",
|
||||||
"kind": "function",
|
"kind": "function",
|
||||||
"path": "docforge.cli.main.generate_mcp",
|
"path": "docforge.cli.main.generate_mcp",
|
||||||
"signature": "<bound method Function.signature of Function('generate_mcp', 125, 164)>",
|
"signature": "<bound method Function.signature of Function('generate_mcp', 129, 168)>",
|
||||||
"docstring": "Generate MCP-compatible documentation resources for the specified module.\n\nArgs:\n module: The primary module path to document.\n project_name: Optional project name override.\n out_dir: Directory where MCP resources will be written."
|
"docstring": "Generate MCP-compatible documentation resources for the specified module.\n\nArgs:\n module: The primary module path to document.\n project_name: Optional project name override.\n out_dir: Directory where MCP resources will be written."
|
||||||
},
|
},
|
||||||
"build": {
|
"build": {
|
||||||
"name": "build",
|
"name": "build",
|
||||||
"kind": "function",
|
"kind": "function",
|
||||||
"path": "docforge.cli.main.build",
|
"path": "docforge.cli.main.build",
|
||||||
"signature": "<bound method Function.signature of Function('build', 171, 192)>",
|
"signature": "<bound method Function.signature of Function('build', 175, 196)>",
|
||||||
"docstring": "Build the documentation site using MkDocs.\n\nArgs:\n mkdocs_yml: Path to the mkdocs.yml configuration file."
|
"docstring": "Build the documentation site using MkDocs.\n\nArgs:\n mkdocs_yml: Path to the mkdocs.yml configuration file."
|
||||||
},
|
},
|
||||||
"serve_mcp": {
|
"serve_mcp": {
|
||||||
"name": "serve_mcp",
|
"name": "serve_mcp",
|
||||||
"kind": "function",
|
"kind": "function",
|
||||||
"path": "docforge.cli.main.serve_mcp",
|
"path": "docforge.cli.main.serve_mcp",
|
||||||
"signature": "<bound method Function.signature of Function('serve_mcp', 199, 226)>",
|
"signature": "<bound method Function.signature of Function('serve_mcp', 203, 230)>",
|
||||||
"docstring": "Serve MCP documentation from the local mcp_docs directory."
|
"docstring": "Serve MCP documentation from the local mcp_docs directory."
|
||||||
},
|
},
|
||||||
"serve": {
|
"serve": {
|
||||||
"name": "serve",
|
"name": "serve",
|
||||||
"kind": "function",
|
"kind": "function",
|
||||||
"path": "docforge.cli.main.serve",
|
"path": "docforge.cli.main.serve",
|
||||||
"signature": "<bound method Function.signature of Function('serve', 233, 256)>",
|
"signature": "<bound method Function.signature of Function('serve', 237, 260)>",
|
||||||
"docstring": "Serve the documentation site with live-reload using MkDocs.\n\nArgs:\n mkdocs_yml: Path to the mkdocs.yml configuration file."
|
"docstring": "Serve the documentation site with live-reload using MkDocs.\n\nArgs:\n mkdocs_yml: Path to the mkdocs.yml configuration file."
|
||||||
},
|
},
|
||||||
"main": {
|
"main": {
|
||||||
"name": "main",
|
"name": "main",
|
||||||
"kind": "function",
|
"kind": "function",
|
||||||
"path": "docforge.cli.main.main",
|
"path": "docforge.cli.main.main",
|
||||||
"signature": "<bound method Function.signature of Function('main', 263, 267)>",
|
"signature": "<bound method Function.signature of Function('main', 267, 271)>",
|
||||||
"docstring": "CLI Entry point."
|
"docstring": "CLI Entry point. Boots the click application."
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -252,7 +252,7 @@
|
|||||||
"kind": "function",
|
"kind": "function",
|
||||||
"path": "docforge.main.main",
|
"path": "docforge.main.main",
|
||||||
"signature": "<bound method Alias.signature of Alias('main', 'docforge.cli.main.main')>",
|
"signature": "<bound method Alias.signature of Alias('main', 'docforge.cli.main.main')>",
|
||||||
"docstring": "CLI Entry point."
|
"docstring": "CLI Entry point. Boots the click application."
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
@@ -399,43 +399,43 @@
|
|||||||
"name": "generate",
|
"name": "generate",
|
||||||
"kind": "function",
|
"kind": "function",
|
||||||
"path": "docforge.cli.main.generate",
|
"path": "docforge.cli.main.generate",
|
||||||
"signature": "<bound method Function.signature of Function('generate', 78, 118)>",
|
"signature": "<bound method Function.signature of Function('generate', 82, 122)>",
|
||||||
"docstring": "Generate Markdown source files for the specified module.\n\nArgs:\n module: The primary module path to document.\n project_name: Optional project name override.\n docs_dir: Directory where documentation sources will be written."
|
"docstring": "Generate Markdown source files for the specified module.\n\nArgs:\n module: The primary module path to document.\n project_name: Optional project name override.\n docs_dir: Directory where documentation sources will be written."
|
||||||
},
|
},
|
||||||
"generate_mcp": {
|
"generate_mcp": {
|
||||||
"name": "generate_mcp",
|
"name": "generate_mcp",
|
||||||
"kind": "function",
|
"kind": "function",
|
||||||
"path": "docforge.cli.main.generate_mcp",
|
"path": "docforge.cli.main.generate_mcp",
|
||||||
"signature": "<bound method Function.signature of Function('generate_mcp', 125, 164)>",
|
"signature": "<bound method Function.signature of Function('generate_mcp', 129, 168)>",
|
||||||
"docstring": "Generate MCP-compatible documentation resources for the specified module.\n\nArgs:\n module: The primary module path to document.\n project_name: Optional project name override.\n out_dir: Directory where MCP resources will be written."
|
"docstring": "Generate MCP-compatible documentation resources for the specified module.\n\nArgs:\n module: The primary module path to document.\n project_name: Optional project name override.\n out_dir: Directory where MCP resources will be written."
|
||||||
},
|
},
|
||||||
"build": {
|
"build": {
|
||||||
"name": "build",
|
"name": "build",
|
||||||
"kind": "function",
|
"kind": "function",
|
||||||
"path": "docforge.cli.main.build",
|
"path": "docforge.cli.main.build",
|
||||||
"signature": "<bound method Function.signature of Function('build', 171, 192)>",
|
"signature": "<bound method Function.signature of Function('build', 175, 196)>",
|
||||||
"docstring": "Build the documentation site using MkDocs.\n\nArgs:\n mkdocs_yml: Path to the mkdocs.yml configuration file."
|
"docstring": "Build the documentation site using MkDocs.\n\nArgs:\n mkdocs_yml: Path to the mkdocs.yml configuration file."
|
||||||
},
|
},
|
||||||
"serve_mcp": {
|
"serve_mcp": {
|
||||||
"name": "serve_mcp",
|
"name": "serve_mcp",
|
||||||
"kind": "function",
|
"kind": "function",
|
||||||
"path": "docforge.cli.main.serve_mcp",
|
"path": "docforge.cli.main.serve_mcp",
|
||||||
"signature": "<bound method Function.signature of Function('serve_mcp', 199, 226)>",
|
"signature": "<bound method Function.signature of Function('serve_mcp', 203, 230)>",
|
||||||
"docstring": "Serve MCP documentation from the local mcp_docs directory."
|
"docstring": "Serve MCP documentation from the local mcp_docs directory."
|
||||||
},
|
},
|
||||||
"serve": {
|
"serve": {
|
||||||
"name": "serve",
|
"name": "serve",
|
||||||
"kind": "function",
|
"kind": "function",
|
||||||
"path": "docforge.cli.main.serve",
|
"path": "docforge.cli.main.serve",
|
||||||
"signature": "<bound method Function.signature of Function('serve', 233, 256)>",
|
"signature": "<bound method Function.signature of Function('serve', 237, 260)>",
|
||||||
"docstring": "Serve the documentation site with live-reload using MkDocs.\n\nArgs:\n mkdocs_yml: Path to the mkdocs.yml configuration file."
|
"docstring": "Serve the documentation site with live-reload using MkDocs.\n\nArgs:\n mkdocs_yml: Path to the mkdocs.yml configuration file."
|
||||||
},
|
},
|
||||||
"main": {
|
"main": {
|
||||||
"name": "main",
|
"name": "main",
|
||||||
"kind": "function",
|
"kind": "function",
|
||||||
"path": "docforge.cli.main.main",
|
"path": "docforge.cli.main.main",
|
||||||
"signature": "<bound method Function.signature of Function('main', 263, 267)>",
|
"signature": "<bound method Function.signature of Function('main', 267, 271)>",
|
||||||
"docstring": "CLI Entry point."
|
"docstring": "CLI Entry point. Boots the click application."
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
@@ -828,7 +828,7 @@
|
|||||||
"name": "GriffeLoader",
|
"name": "GriffeLoader",
|
||||||
"kind": "class",
|
"kind": "class",
|
||||||
"path": "docforge.loaders.griffe_loader.GriffeLoader",
|
"path": "docforge.loaders.griffe_loader.GriffeLoader",
|
||||||
"signature": "<bound method Class.signature of Class('GriffeLoader', 65, 188)>",
|
"signature": "<bound method Class.signature of Class('GriffeLoader', 65, 224)>",
|
||||||
"docstring": "Loads Python modules and extracts documentation using the Griffe introspection engine.",
|
"docstring": "Loads Python modules and extracts documentation using the Griffe introspection engine.",
|
||||||
"members": {
|
"members": {
|
||||||
"load_project": {
|
"load_project": {
|
||||||
@@ -1714,7 +1714,7 @@
|
|||||||
"name": "resolve_nav",
|
"name": "resolve_nav",
|
||||||
"kind": "function",
|
"kind": "function",
|
||||||
"path": "docforge.nav.resolver.resolve_nav",
|
"path": "docforge.nav.resolver.resolve_nav",
|
||||||
"signature": "<bound method Function.signature of Function('resolve_nav', 59, 112)>",
|
"signature": "<bound method Function.signature of Function('resolve_nav', 59, 124)>",
|
||||||
"docstring": "Create a ResolvedNav by processing a NavSpec against the filesystem.\nThis expands globs and validates the existence of referenced files.\n\nArgs:\n spec: The navigation specification to resolve.\n docs_root: The root directory for documentation files.\n\nReturns:\n A ResolvedNav instance.\n\nRaises:\n FileNotFoundError: If a pattern doesn't match any files or the docs_root doesn't exist."
|
"docstring": "Create a ResolvedNav by processing a NavSpec against the filesystem.\nThis expands globs and validates the existence of referenced files.\n\nArgs:\n spec: The navigation specification to resolve.\n docs_root: The root directory for documentation files.\n\nReturns:\n A ResolvedNav instance.\n\nRaises:\n FileNotFoundError: If a pattern doesn't match any files or the docs_root doesn't exist."
|
||||||
},
|
},
|
||||||
"Optional": {
|
"Optional": {
|
||||||
@@ -2463,7 +2463,7 @@
|
|||||||
"name": "MCPServer",
|
"name": "MCPServer",
|
||||||
"kind": "class",
|
"kind": "class",
|
||||||
"path": "docforge.servers.mcp_server.MCPServer",
|
"path": "docforge.servers.mcp_server.MCPServer",
|
||||||
"signature": "<bound method Class.signature of Class('MCPServer', 10, 73)>",
|
"signature": "<bound method Class.signature of Class('MCPServer', 10, 95)>",
|
||||||
"docstring": "MCP server for serving a pre-built MCP documentation bundle.",
|
"docstring": "MCP server for serving a pre-built MCP documentation bundle.",
|
||||||
"members": {
|
"members": {
|
||||||
"mcp_root": {
|
"mcp_root": {
|
||||||
@@ -2484,7 +2484,7 @@
|
|||||||
"name": "run",
|
"name": "run",
|
||||||
"kind": "function",
|
"kind": "function",
|
||||||
"path": "docforge.servers.mcp_server.MCPServer.run",
|
"path": "docforge.servers.mcp_server.MCPServer.run",
|
||||||
"signature": "<bound method Function.signature of Function('run', 66, 73)>",
|
"signature": "<bound method Function.signature of Function('run', 88, 95)>",
|
||||||
"docstring": "Start the MCP server.\n\nArgs:\n transport: MCP transport (default: streamable-http)"
|
"docstring": "Start the MCP server.\n\nArgs:\n transport: MCP transport (default: streamable-http)"
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -252,7 +252,7 @@
|
|||||||
"name": "GriffeLoader",
|
"name": "GriffeLoader",
|
||||||
"kind": "class",
|
"kind": "class",
|
||||||
"path": "docforge.loaders.griffe_loader.GriffeLoader",
|
"path": "docforge.loaders.griffe_loader.GriffeLoader",
|
||||||
"signature": "<bound method Class.signature of Class('GriffeLoader', 65, 188)>",
|
"signature": "<bound method Class.signature of Class('GriffeLoader', 65, 224)>",
|
||||||
"docstring": "Loads Python modules and extracts documentation using the Griffe introspection engine.",
|
"docstring": "Loads Python modules and extracts documentation using the Griffe introspection engine.",
|
||||||
"members": {
|
"members": {
|
||||||
"load_project": {
|
"load_project": {
|
||||||
|
|||||||
@@ -289,7 +289,7 @@
|
|||||||
"name": "GriffeLoader",
|
"name": "GriffeLoader",
|
||||||
"kind": "class",
|
"kind": "class",
|
||||||
"path": "docforge.loaders.griffe_loader.GriffeLoader",
|
"path": "docforge.loaders.griffe_loader.GriffeLoader",
|
||||||
"signature": "<bound method Class.signature of Class('GriffeLoader', 65, 188)>",
|
"signature": "<bound method Class.signature of Class('GriffeLoader', 65, 224)>",
|
||||||
"docstring": "Loads Python modules and extracts documentation using the Griffe introspection engine.",
|
"docstring": "Loads Python modules and extracts documentation using the Griffe introspection engine.",
|
||||||
"members": {
|
"members": {
|
||||||
"load_project": {
|
"load_project": {
|
||||||
|
|||||||
@@ -297,7 +297,7 @@
|
|||||||
"name": "resolve_nav",
|
"name": "resolve_nav",
|
||||||
"kind": "function",
|
"kind": "function",
|
||||||
"path": "docforge.nav.resolver.resolve_nav",
|
"path": "docforge.nav.resolver.resolve_nav",
|
||||||
"signature": "<bound method Function.signature of Function('resolve_nav', 59, 112)>",
|
"signature": "<bound method Function.signature of Function('resolve_nav', 59, 124)>",
|
||||||
"docstring": "Create a ResolvedNav by processing a NavSpec against the filesystem.\nThis expands globs and validates the existence of referenced files.\n\nArgs:\n spec: The navigation specification to resolve.\n docs_root: The root directory for documentation files.\n\nReturns:\n A ResolvedNav instance.\n\nRaises:\n FileNotFoundError: If a pattern doesn't match any files or the docs_root doesn't exist."
|
"docstring": "Create a ResolvedNav by processing a NavSpec against the filesystem.\nThis expands globs and validates the existence of referenced files.\n\nArgs:\n spec: The navigation specification to resolve.\n docs_root: The root directory for documentation files.\n\nReturns:\n A ResolvedNav instance.\n\nRaises:\n FileNotFoundError: If a pattern doesn't match any files or the docs_root doesn't exist."
|
||||||
},
|
},
|
||||||
"Optional": {
|
"Optional": {
|
||||||
|
|||||||
@@ -110,7 +110,7 @@
|
|||||||
"name": "resolve_nav",
|
"name": "resolve_nav",
|
||||||
"kind": "function",
|
"kind": "function",
|
||||||
"path": "docforge.nav.resolver.resolve_nav",
|
"path": "docforge.nav.resolver.resolve_nav",
|
||||||
"signature": "<bound method Function.signature of Function('resolve_nav', 59, 112)>",
|
"signature": "<bound method Function.signature of Function('resolve_nav', 59, 124)>",
|
||||||
"docstring": "Create a ResolvedNav by processing a NavSpec against the filesystem.\nThis expands globs and validates the existence of referenced files.\n\nArgs:\n spec: The navigation specification to resolve.\n docs_root: The root directory for documentation files.\n\nReturns:\n A ResolvedNav instance.\n\nRaises:\n FileNotFoundError: If a pattern doesn't match any files or the docs_root doesn't exist."
|
"docstring": "Create a ResolvedNav by processing a NavSpec against the filesystem.\nThis expands globs and validates the existence of referenced files.\n\nArgs:\n spec: The navigation specification to resolve.\n docs_root: The root directory for documentation files.\n\nReturns:\n A ResolvedNav instance.\n\nRaises:\n FileNotFoundError: If a pattern doesn't match any files or the docs_root doesn't exist."
|
||||||
},
|
},
|
||||||
"Optional": {
|
"Optional": {
|
||||||
|
|||||||
@@ -87,7 +87,7 @@
|
|||||||
"name": "MCPServer",
|
"name": "MCPServer",
|
||||||
"kind": "class",
|
"kind": "class",
|
||||||
"path": "docforge.servers.mcp_server.MCPServer",
|
"path": "docforge.servers.mcp_server.MCPServer",
|
||||||
"signature": "<bound method Class.signature of Class('MCPServer', 10, 73)>",
|
"signature": "<bound method Class.signature of Class('MCPServer', 10, 95)>",
|
||||||
"docstring": "MCP server for serving a pre-built MCP documentation bundle.",
|
"docstring": "MCP server for serving a pre-built MCP documentation bundle.",
|
||||||
"members": {
|
"members": {
|
||||||
"mcp_root": {
|
"mcp_root": {
|
||||||
@@ -108,7 +108,7 @@
|
|||||||
"name": "run",
|
"name": "run",
|
||||||
"kind": "function",
|
"kind": "function",
|
||||||
"path": "docforge.servers.mcp_server.MCPServer.run",
|
"path": "docforge.servers.mcp_server.MCPServer.run",
|
||||||
"signature": "<bound method Function.signature of Function('run', 66, 73)>",
|
"signature": "<bound method Function.signature of Function('run', 88, 95)>",
|
||||||
"docstring": "Start the MCP server.\n\nArgs:\n transport: MCP transport (default: streamable-http)"
|
"docstring": "Start the MCP server.\n\nArgs:\n transport: MCP transport (default: streamable-http)"
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -50,7 +50,7 @@
|
|||||||
"name": "MCPServer",
|
"name": "MCPServer",
|
||||||
"kind": "class",
|
"kind": "class",
|
||||||
"path": "docforge.servers.mcp_server.MCPServer",
|
"path": "docforge.servers.mcp_server.MCPServer",
|
||||||
"signature": "<bound method Class.signature of Class('MCPServer', 10, 73)>",
|
"signature": "<bound method Class.signature of Class('MCPServer', 10, 95)>",
|
||||||
"docstring": "MCP server for serving a pre-built MCP documentation bundle.",
|
"docstring": "MCP server for serving a pre-built MCP documentation bundle.",
|
||||||
"members": {
|
"members": {
|
||||||
"mcp_root": {
|
"mcp_root": {
|
||||||
@@ -71,7 +71,7 @@
|
|||||||
"name": "run",
|
"name": "run",
|
||||||
"kind": "function",
|
"kind": "function",
|
||||||
"path": "docforge.servers.mcp_server.MCPServer.run",
|
"path": "docforge.servers.mcp_server.MCPServer.run",
|
||||||
"signature": "<bound method Function.signature of Function('run', 66, 73)>",
|
"signature": "<bound method Function.signature of Function('run', 88, 95)>",
|
||||||
"docstring": "Start the MCP server.\n\nArgs:\n transport: MCP transport (default: streamable-http)"
|
"docstring": "Start the MCP server.\n\nArgs:\n transport: MCP transport (default: streamable-http)"
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
Reference in New Issue
Block a user