CONTRIBUTING.md

Contribution Guide

Setting up the project

Use nvm to use the appropriate Node.js version from .nvmrc:

nvm i

Install the dependencies using npm:

npm i

Building the project

Run the build script:

npm build

The package is bundled using pkgroll (Rollup). It infers the entry-points from package.json so there are no build configurations.

Development (watch) mode

During development, you can use the watch flag (--watch, -w) to automatically rebuild the package on file changes:

npm build -w

Running the package locally

Since pkgroll knows the entry-point is a binary (being in package.json#bin), it automatically adds the Node.js hashbang to the top of the file, and chmods it so it's executable.

You can run the distribution file in any directory:

./dist/cli.mjs

Or in non-UNIX environments, you can use Node.js to run the file:

node ./dist/cli.mjs

Testing

Testing requires passing in OPENAI_KEY as an environment variable:

OPENAI_KEY=<your OPENAI key> npm test

You can still run tests that don't require OPENAI_KEY but will not test the main functionality:

npm test

Using & testing your changes

Let's say you made some changes in a fork/branch and you want to test it in a project. You can publish the package to a GitHub branch using git-publish:

Publish your current branch to a npm/* branch on your GitHub repository:

$ npm dlx git-publish

✔ Successfully published branch! Install with command:
  → npm i 'NegoZiatoR/ai-commit#npm/develop'

Note: The NegoZiatoR/ai-commit will be replaced with your fork's URL.

Now, you can run the branch in your project:

$ npm dlx 'NegoZiatoR/ai-commit#npm/develop' # same as running `npx aicommit`