No project description provided
Project description
Focus on writing your code, let AI write the documentation for you. With just a few keystrokes in your terminal.
✨ Features
- 📝 Create documentation comment blocks for all methods in a file
- e.g. Javadoc, JSDoc, Docstring, Rustdoc
- ✍️ Create inline documentation comments in method bodies
- 🌳 Treesitter integration
[!NOTE] Documentations will only be added to files without unstaged changes, so that nothing is overwritten.
🚀 Usage
aicomments <RELATIVE_FILE_PATH>
: Create documentations for any method in the file which doesn't have any yet.aicomments <RELATIVE_FILE_PATH> --inline
: Create also documentation comments in the method body.aicomments <RELATIVE_FILE_PATH> --gpt4
: Use GPT-4 model (Default is GPT-3.5).aicomments <RELATIVE_FILE_PATH> --guided
: Guided mode, confirm documentation generation for each method.
⚙️ Supported Languages
- Python
- Typescript
- Javascript
- Java
- Rust
- Kotlin
- Go
- C++
- C
- Scala
📋 Requirements
- Python >= 3.9
🔧 Installation
Create your personal OpenAI Api key and add it as $OPENAI_API_KEY
to your environment with:
export OPENAI_API_KEY=<YOUR_API_KEY>
Install with pipx
:
pipx install doc-comments-ai
[!NOTE] It is recommended to use
pipx
for installation, nonetheless it is also possible to usepip
.
🚨 Disclaimer
Your code won't be stored, but your code does leave your machine.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
doc_comments_ai-0.1.7.tar.gz
(8.7 kB
view hashes)
Built Distribution
Close
Hashes for doc_comments_ai-0.1.7-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5a921528b54355e6186eba40daf8cb51895db08af4b389e5ca1f3404c5779c5d |
|
MD5 | 8bc2eb430e74a9dbf7c055e910ee6716 |
|
BLAKE2b-256 | 0f823f6911a044ad30cc8dd4e97edc503f93f761f65b52abeb1b670e238818a4 |