Skip to content
You're viewing an older version of this GitHub Action. Do you want to see the latest version instead?
git-pull-request

GitHub Action

Commit Meaning

0.1.0

Commit Meaning

git-pull-request

Commit Meaning

In a paragraph, describe the commits for a PR

Installation

Copy and paste the following snippet into your .yml file.

              

- name: Commit Meaning

uses: Tincre/commit-meaning@0.1.0

Learn more about this action in Tincre/commit-meaning

Choose a version

commit-meaning

Extract meaning from your verbose git commits into a succinct paragraph within your pull requests.

Simply add this as a step in your CI/CD process and your PRs will be annotated with a single paragraph describing the git commits involved.

Inputs

OPENAI_API_KEY

Required An environment variable containing your OpenAI api key.

GITHUB_TOKEN

Required Your Github token with read/write permissions.

Example usage

uses: actions/commit-meaning
with:
  openai-api-key: "$OPENAI_API_KEY"
  github-token: "$GITHUB_TOKEN"

Options

You can fully customize the behavior of this action.

  • temperature: The OpenAI temperature parameter
  • tokens: The OpenAI tokens paremter (number of tokens)
  • frequency-penalty: The OpenAI frequency_penalty parameter
  • presence-penalty: The OpenAI presence_penalty parameter
  • prompt-instructions: Additional input instructions for the prompt

Default prompt-instructions

We employ the use of gitmoji at Tincre to annotate our commit messages with rich categorization.

This action by default uses the following prompt by default:

  • 🐞 and 🐛 "refers to a bug fix"
  • ♻️ "means to refactor code or content"
  • ✨ "means something is new in the code"
  • 🔧 "refers to code that is configuration or low-level in nature"
  • 🔥 "means to remove code or remove content"
  • 🚧 "references a commit considered to be work in-progress", and
  • 📓 "references changes to documentation."

Contributions

We ❤️ contributions! File an issue, PR, or suggestion to improve this action.

License

This action is liberally licensed under the MIT license.

And we at Tincre would love attribution, if you feel so inclined.