What is conventional-recommended-bump?
The conventional-recommended-bump npm package is a tool that analyzes conventional-style commit messages (like those used by AngularJS) to determine the type of version bump (major, minor, or patch) that should be recommended based on the changes made. It is often used in automated versioning and release workflows to ensure semantic versioning practices are followed.
What are conventional-recommended-bump's main functionalities?
Determining the type of version bump
This feature allows you to determine whether your next release should be a major, minor, or patch version. The code sample shows how to use the package with the Angular preset to get a recommendation.
const conventionalRecommendedBump = require('conventional-recommended-bump');
conventionalRecommendedBump({
preset: 'angular'
}, (error, recommendation) => {
console.log(recommendation.releaseType);
});
Customizable preset options
This feature allows you to customize the preset options for analyzing commit messages. The code sample demonstrates how to specify a custom header pattern and correspondence for the Angular preset.
const conventionalRecommendedBump = require('conventional-recommended-bump');
conventionalRecommendedBump({
preset: 'angular',
config: {
headerPattern: /^\[(.*)\] (.*)$/,
headerCorrespondence: ['type', 'subject']
}
}, (error, recommendation) => {
console.log(recommendation.releaseType);
});
Using a custom parser
This feature allows you to use a custom parser for commit messages. The code sample shows how to pass custom parser options to the package.
const conventionalRecommendedBump = require('conventional-recommended-bump');
const customParserOpts = require('./custom-parser-opts');
conventionalRecommendedBump({
parserOpts: customParserOpts
}, (error, recommendation) => {
console.log(recommendation.releaseType);
});
Other packages similar to conventional-recommended-bump
semantic-release
semantic-release is an npm package that automates the versioning and package publishing process based on semantic versioning and conventional commit messages. It is more comprehensive than conventional-recommended-bump as it includes the entire release workflow, not just the recommendation for version bumps.
standard-version
standard-version is an automated versioning tool that adheres to Semantic Versioning and uses conventional commit messages to determine version bumps. It is similar to conventional-recommended-bump but also handles the generation of changelogs and tagging of releases.
release-it
release-it is a generic CLI tool for automating versioning and package publishing. It supports conventional commits and can determine version bumps, but it also includes a wide range of release-related tasks, making it more versatile than conventional-recommended-bump.
conventional-recommended-bump
Get a recommended version bump based on conventional commits.
Got the idea from https://github.com/conventional-changelog/conventional-changelog/pull/29
Install
•
Usage
•
API
•
CLI
Install
pnpm add conventional-recommended-bump
yarn add conventional-recommended-bump
npm i conventional-recommended-bump
Usage
import { Bumper } from 'conventional-recommended-bump'
const bumper = new Bumper(process.cwd()).loadPreset('angular')
const recommendation = await bumper.bump()
console.log(recommendation.releaseType)
API
new Bumper(cwdOrGitClient: string | ConventionalGitClient = process.cwd())
Create a new Bumper instance. cwdOrGitClient
is the current working directory or a ConventionalGitClient
instance.
bumper.tag(paramsOrTag: GetSemverTagsParams & Params | string): this
Set params to get the last semver tag or set the tag directly.
bumper.commits(params: GetCommitsParams & Params, parserOptions?: ParserStreamOptions): this
Set params to get the commits.
bumper.commits(commits: Iterable<Commit> | AsyncIterable<Commit>): this
Set the commits directly.
bumper.loadPreset(preset: PresetParams): this
Load and set necessary params from a preset.
bumper.bump(whatBump?: (commits: Commit[]) => Promise<BumperRecommendation | null | undefined>): Promise<BumperRecommendation>
Get a recommended version bump based on conventional commits. whatBump
function is required if preset is not loaded.
CLI
$ conventional-recommended-bump --help
License
MIT © Steve Mao