Scolpta/pydocq
🛠 Query Python package documentation efficiently with pydocq, providing structured metadata for AI agents and seamless access to essential package insights.
What's novel
🛠 Query Python package documentation efficiently with pydocq, providing structured metadata for AI agents and seamless access to essential package insights.
Code Analysis
12 files read · 3 roundsA CLI tool that introspects installed Python packages (via inspect/importlib) or statically analyzes Python files (via AST) to produce structured documentation in multiple formats (JSON, markdown, YAML, LLM-optimized), with an optional SDK decorator system for adding custom metadata to code.
Strengths
Clean modular architecture with clear separation between resolution, inspection, formatting, and search; thoughtful security handling (AST-only analysis, path traversal prevention, dangerous module blacklists); the LLM-optimized output format is a genuinely useful differentiator for AI agent workflows.
Weaknesses
The README is entirely fabricated (describes a GUI desktop app that doesn't exist), which is a serious credibility issue; several functions are stubs (find_calls, resolve_forward_reference), format_yaml actually returns JSON, and cli.py has a malformed function definition.
Score Breakdown
Signal breakdown
Innovation
Craft
Traction
Scope
Evidence
Commits
39
Contributors
2
Files
97
Active weeks
3
Repository
Language
Python
Stars
1
Forks
0
License
MIT