shahhet195/Release Changelog Builder

A GitHub action that builds your release notes / changelog fast, easy and exactly the way you want.

View on GitHub

Trust Signals

Scorecard Score
not yet scored
Maintenance Recency
Stale
License
None
namedescriptionrequireddefault
configurationJsonDefines the configuration json. If provided, will be prefered over `configuration`.
configurationDefines the relative path to the configuration file.
pathDefines the directory the repo is located in (checkout directory)
ownerDefines the owner of the repository to create the changelog for
repoDefines the repository to create the changelog for
fromTagDefines the previous tag to compare against
toTagDefines the newly tag created
includeOpenDefines if the changelog should include open PRsfalse
ignorePreReleasesDefines if the action will only use full releases to compare against (Only used if fromTag is not defined). E.g. for 1.0.1... 1.0.0-rc02 <- ignore, 1.0.0 <- pickfalse
failOnErrorDefines if the action should result in a build failure, if an error was discoveredfalse
fetchViaCommitsDefines if PRs are fetched via the commits identified. This will do 1 API request per commit -> Best for scenarios with squash merges | Or shorter from-to diffs (< 10 commits) | Also effective for shorters diffs for very old PRsfalse
fetchReviewersWill enable fetching the users/reviewers who approved the PRfalse
fetchReleaseInformationWill enable fetching release information for the tags. E.g. creation datefalse
fetchReviewsWill enable fetching the reviews (comments) attached to the PRfalse
modeDefines the mode used to retrieve the information. Available options: [`PR`, `COMMIT`, `HYBRID`]. Defaults to `PR`.
commitMode[Deprecated] Enables the commit based mode. This mode generates changelogs based on the commits. Please note that this lacks a lot of features only possible with PRs.false
outputFileIf defined, the changelog will get written to this file. (relative to the checkout dir)
tokenDefines the token to use to execute the git API requests with, uses `env.GITHUB_TOKEN` by default${{ github.token }}
baseUrlDefines the base url for GitHub Enterprise authentication, uses `https://api.github.com` by default
exportCacheIf enabled, the action will export the collected data to the cache. This is disabled by default. Can be passed to a follow up run via `cache`.false
exportOnlyIf enabled, the action will only collect the data and terminate afterwards. Data can then be consumed by steps afterwards. This requires `exportCache` to be enabledfalse
cacheProvide the cache of a previous run. Allows to re-use collected information multiple times to generate different release notes. Requires `exportCache` to be enabled for the previous run.
platformDefines the platform the action is run on. Available options: [`github`, `gitea`]. Defaults to `github`.github
namedescription
changelogThe built release changelog built from the merged pull requests
pull_requestsA comma seperated list of PR numbers that were merged
ownerSpecifies the owner of the repository processed
repoDescribes the repository name, which was processed
fromTagDefines the `fromTag` which describes the lower bound to process pull requests for
toTagDefines the `toTag` which describes the upper bound to process pull request for
failedDefines if there was an issue with the action run, and the changelog may not have been generated correctly. [true, false]
categorized_prsCount of categorized pull requests
uncategorized_prsCount of uncategorized pull requests
open_prsCount of open pull requests. Only fetched if `includeOpen` is enabled.
cacheCache containing this runs data. Allows to re-use collected information multiple times to generate different release notes.