An automatic commenter for Python code.
Project description
Commentator
Commentator is a Python program that generates comments and optional translations for Python code. It uses OpenAI's GPT-3 language model to add high-level explanatory comments and docstrings to Python code.
Usage
To use Commentator, you must first set up an OpenAI API key. If you
already have an API key, you can set it as an environment variable
called OPENAI_API_KEY
. Otherwise, you can pass your API key as an
argument to the commentator
command. (If you do not have one yet,
you can get a key here: https://openai.com/api/.)
$ export OPENAI_API_KEY=<your-api-key>
or
$ commentator <file> <api-key>
Commentator takes a path to a Python file and an optional language parameter. If language is specified, Commentator translates each docstring and comment in the code to the specified language and includes the translated text in the output. If language is not specified, Commentator does not include any translations in the output.
Installation
To install Commentator, you can use pip:
$ pip install python-commentator
Example
Suppose you have a file called example.py
with the following code:
def absolutely(n):
if n < 0:
return -n
else:
return n
Run Commentator on this file to add comments and type annotations:
$ commentator example.py
The resulting code will be:
def absolutely(n: int):
"""
Return the absolute value of an integer.
Args:
n(int): Integer number.
Returns:
An absolute integer value of the input.
"""
if n < 0:
return -n
else:
return n
Note that Commentator has added a docstring and type annotations.
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
Built Distribution
Hashes for python_commentator-0.0.5-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 30bed798d4ed536e82513c410a369d949417e803facdd0b7802b1f7b8d064d67 |
|
MD5 | 3584f68b201945c7cb38943e01ded476 |
|
BLAKE2b-256 | 37a128545543fe09c08da769af213f4821a07a419bd8e2b4f15809baba3e6aff |