#!/usr/bin/env python3 """Generate API documentation using pydoc-markdown.""" import subprocess import sys from pathlib import Path def main(): """Generate documentation and build MkDocs site.""" project_root = Path(__file__).parent.parent print("šŸ“ Generating API documentation...") result = subprocess.run( ["pydoc-markdown"], cwd=project_root, capture_output=False, ) if result.returncode != 0: print("āŒ Failed to generate documentation") return 1 print("āœ… Documentation generated: docs/api_reference.md") print("šŸ—ļø Building MkDocs site...") result = subprocess.run( ["mkdocs", "build", "--quiet"], cwd=project_root, capture_output=False, ) if result.returncode != 0: print("āŒ Failed to build MkDocs site") return 1 print("āœ… Site built: site/") print("\n✨ Done! Run 'mkdocs serve' to preview locally.") return 0 if __name__ == "__main__": sys.exit(main())