A VS Code extension that generates thorough documentation for Python files using AST parsing. It works fully offline.
Features
- AST Parsing: Uses Python's built-in
astmodule to understand code structure. - Natural Language Generation: Converts code steps into readable English sentences.
- Context-Aware: Infers purpose and parameter details from code usage.
- Markdown Output: Generates a clean
documentation.mdfile next to your source.
Requirements
- Python 3: Must be installed and available in your PATH as
pythonorpython3.
Usage
- Open a
.pyfile in VS Code. - Right-click in the editor and select Generate Documentation.
- Alternatively, use the Command Palette (
Ctrl+Shift+P) and search for Code Doc Generator: Generate Documentation. - A
documentation.mdfile will be created in the same directory.
Installation for Development
- Clone the repository.
- Run
npm install. - Open the project in VS Code.
- Press
F5to launch the extension development host. - Open any file in the
test-filesfolder to test.
License
MIT