matiasvlevi/gptdoc

Generate documentation comments with OpenAI models.

Generate documentation comments with OpenAI models

Install • Documentation • License

Preview

Functions labeled with /** @gpt */ get an autogenerated doc comment

Before	After
/** @gpt */ function Greet(name) { console.log(`Hello ${name}`); }	/** * @autogenerated * @summary Generates a greeting to the passed in name * @param {string} name - The name to greet */ function Greet(name) { console.log(`Hello ${name}`); }

Install in project

Install gptdoc as a dev dependency

npm i --save-dev gptdoc 

Execute

node node_modules/gptdoc [args]

Config

You can specify a configuration file:

node node_modules/gptdoc -c .myconfig

If none provided, the script will look for .gptdoc

Sample Config file

{
    "DEBUG": false,
    "framework": "JSDOC",
    "language": "JS",
    "files": {
        "src": "./src",
        "dest": "./gpt"
    },
    "openai": {
        "temperature": 0.7,
        "top_p": 1,
        "max_tokens": 256,
        "model": "text-davinci-003"
    }
}

Find more info about the config here

API Key

Add a .env file in your root directory with OPENAI_API_KEY

or set the OPENAI_API_KEY as a system environement variable.

find your API key here

Document this project

Running docself in the cloned repo will document source files in ./src/

npm run docself

Running test in the cloned repo will document ./example/example.js

npm run test

Contributing

Constructive criticism, Issues and PRs are more than welcome!

---

License MIT

gptdoc's Issues

Nice idea, couple of small issues

Love the idea! Will test it out again when I have some more time.

Thought I'd leave a comment with a couple of issues in case you weren't aware of them.

1. There's an error if .gptdoc isn't present or explicitly define (which may be intentional) -- but it isn't included by default in the repo to run the docself task or tests, so I thought I'd mention it.

2. This seems to rely on built-in fetch API, so it doesn't work in Node < v18