feat: Add Rust documentation generation with dedicated parser and generator scripts, and integrate it into the CLI.

Author: MervinPraison

praisonai_tools/docs_generator/README.md

@@ -10,6 +10,31 @@ pip install praisonai-tools
 
 ## Quick Start
 
+### Generate Rust SDK Documentation (Standalone)
+
+The Rust documentation generator works without dependencies:
+
+```bash
+# Direct execution (recommended for Rust)
+cd praisonai_tools/docs_generator
+python3 __main__.py --package rust
+
+# Or use the standalone script
+python3 generate_rust_docs.py --rust-path /path/to/praisonai-rust
+
+# Dry run
+python3 __main__.py --package rust --dry-run
+```
+
+### Generate All SDK Documentation
+
+For Python/TypeScript docs, install the full package first:
+
+```bash
+pip install praisonaiagents
+python -m praisonai_tools.docs_generator --package all
+```
+
 ### Using CLI
 
 ```bash
@@ -23,16 +48,6 @@ praisonai-tools docs-generate --layout granular
 praisonai-tools docs-generate --output /path/to/docs
 ```
 
-### Using Python Module
-
-```bash
-# Run as module
-python -m praisonai_tools.docs_generator
-
-# With options
-python -m praisonai_tools.docs_generator --layout granular
-```
-
 ### Direct Script Execution
 
 ```bash
@@ -44,7 +59,9 @@ python generator.py --layout granular
 | Option | Description | Default |
 |--------|-------------|---------|
 | `--layout` | Documentation layout: `compact` or `granular` | `granular` |
-| `--output` | Output directory path | Auto-detected |
+| `--package` | Package to generate: `praisonaiagents`, `praisonai`, `typescript`, `rust`, `all` | `all` |
+| `--docs-root` | Root directory of the documentation repository | Auto-detected |
+| `--dry-run` | Show what would be generated without writing files | `false` |
 
 ## Layouts
 
@@ -64,12 +81,14 @@ python generator.py --layout granular
 - **MDX output**: Mintlify-compatible MDX format
 - **Navigation generation**: Auto-updates `docs.json` navigation
 - **Icon support**: Maps modules to Font Awesome icons
+- **Multi-language support**: Python, TypeScript, and Rust
 
 ## Supported Packages
 
 - `praisonaiagents` (Python Core SDK)
 - `praisonai` (Python Wrapper)
 - TypeScript SDK (`praisonai-ts`)
+- **Rust SDK** (`praisonai-rust`) - Agent, Tools, Workflows, Memory, LLM
 
 ## Output Structure
 
@@ -81,6 +100,10 @@ docs/sdk/reference/
 │   └── functions/    # Function pages
 ├── praisonai/
 │   └── ...
-└── typescript/
-    └── ...
+├── typescript/
+│   └── ...
+└── rust/
+    ├── modules/      # praisonai.agent, praisonai.tools, etc.
+    ├── classes/      # Agent, ToolRegistry, AgentTeam, etc.
+    └── functions/    # Standalone functions
 ```

praisonai_tools/docs_generator/__init__.py

@@ -0,0 +1,14 @@
+"""
+PraisonAI Documentation Generator.
+
+This module can be run standalone without requiring the praisonaiagents dependency.
+
+Usage:
+    python -m praisonai_tools.docs_generator --package rust
+    python -m praisonai_tools.docs_generator --package all
+"""
+
+# This file is intentionally minimal to allow standalone execution
+# without importing the parent package dependencies.
+
+__version__ = "0.1.0"

praisonai_tools/docs_generator/__main__.py

@@ -1,22 +1,60 @@
 """
 CLI entry point for praisonai_tools.docs_generator.
+
+This can be run in two ways:
+1. Directly: cd praisonai_tools/docs_generator && python __main__.py --package rust
+2. As module (requires praisonaiagents): python -m praisonai_tools.docs_generator --package rust
 """
 
 import argparse
 import sys
-from .generator import ReferenceDocsGenerator
+import os
 
 def main():
     parser = argparse.ArgumentParser(description="PraisonAI SDK Documentation Generator")
-    parser.add_argument("--package", choices=["praisonaiagents", "praisonai", "typescript", "all"], 
+    parser.add_argument("--package", choices=["praisonaiagents", "praisonai", "typescript", "rust", "all"], 
                         default="all", help="Package to generate docs for")
     parser.add_argument("--dry-run", action="store_true", help="Don't write files")
     parser.add_argument("--docs-root", default="/Users/praison/PraisonAIDocs", 
                         help="Root directory of the documentation repository")
+    parser.add_argument("--layout", choices=["legacy", "granular"], default="granular",
+                        help="Documentation layout type")
+    parser.add_argument("--rust-path", default="/Users/praison/praisonai-package/src/praisonai-rust",
+                        help="Path to Rust SDK workspace")
 
     args = parser.parse_args()
 
-    generator = ReferenceDocsGenerator(docs_root=args.docs_root)
+    # For Rust-only generation, use the standalone script to avoid praisonaiagents dependency
+    if args.package == "rust":
+        # Use the standalone Rust generator
+        from pathlib import Path
+        script_dir = Path(__file__).parent
+        sys.path.insert(0, str(script_dir))
+        
+        from generate_rust_docs import main as rust_main
+        # Patch sys.argv for the rust script
+        sys.argv = [
+            'generate_rust_docs.py',
+            '--rust-path', args.rust_path,
+            '--docs-root', args.docs_root,
+        ]
+        if args.dry_run:
+            sys.argv.append('--dry-run')
+        rust_main()
+        return 0
+    
+    # For other packages, use the full generator (requires praisonaiagents)
+    try:
+        from .generator import ReferenceDocsGenerator, LayoutType
+    except ImportError as e:
+        print(f"Error: {e}")
+        print("\nFor generating Python/TypeScript docs, install praisonaiagents:")
+        print("  pip install praisonaiagents")
+        print("\nFor Rust docs only, use: --package rust")
+        return 1
+    
+    layout = LayoutType.LEGACY if args.layout == "legacy" else LayoutType.GRANULAR
+    generator = ReferenceDocsGenerator(docs_root=args.docs_root, layout=layout)
 
     if args.package == "all":
         generator.generate_all(dry_run=args.dry_run)