Skip to content

Checks whether a semantic release should be run for a repository. πŸ’‚

License

Notifications You must be signed in to change notification settings

JoshuaKGoldberg/should-semantic-release

This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

65a274c Β· Nov 17, 2023
Oct 26, 2023
Sep 5, 2023
Sep 5, 2023
Feb 5, 2023
Oct 2, 2023
Oct 2, 2023
Sep 5, 2023
Oct 2, 2023
Sep 5, 2023
Jan 17, 2023
Jan 17, 2023
Sep 5, 2023
Oct 27, 2023
Oct 2, 2023
Sep 5, 2023
Oct 2, 2023
Jan 17, 2023
Jan 17, 2023
Jan 17, 2023
Oct 2, 2023
Sep 5, 2023
Sep 5, 2023
Nov 17, 2023
Nov 17, 2023
Sep 5, 2023
Oct 2, 2023
Sep 5, 2023
Sep 5, 2023

Repository files navigation

Should Semantic Release

Checks whether a semantic release should be run for a repository. πŸ’‚

All Contributors: 2 πŸ‘ͺ Codecov Test Coverage Contributor Covenant License: MIT Sponsor: On GitHub Style: Prettier TypeScript: Strict npm package version

Usage

This function determines whether a semantic release should occur for a package based on Git history. It returns true if a "meaningful" commit has come since the most recent release commit.

if npx should-semantic-release ; then npx release-it ; fi

This can be useful, for example, to prevent a release-it release.

should-semantic-release accepts the following CLI flag:

  • -v/--verbose (default: false): Whether to log debug information to the console
$ npx should-semantic-release --verbose

Checking up to 123 commits for release readiness...
Checking commit: chore: an example chore (#101)
Found type chore.
Checking commit: chore: another example chore (#100)
Found type chore.
Checking commit: chore: release v1.27.31
This is a release commit. Returning false.

Commit Purposes

Based on a commit's conventional commit message type:

  1. If the type is feat fix, or perf, it's considered "meaningful"
  2. If the type is docs, refactor, style, or test, it's ignored
  3. If the message looks like v1.2.3, chore: release 1.2.3, or similar, it's considered a "release"

See getCommitMeaning for the exact logic used.

Node API

Alternately, you can call this import asynchronous shouldSemanticRelease function into Node scripts:

import { shouldSemanticRelease } from "should-semantic-release";

if (await shouldSemanticRelease()) {
	console.log("Let's release! πŸš€");
}

shouldSemanticRelease accepts an optional options object with the following parameter:

  • verbose (default: false)
import { shouldSemanticRelease } from "should-semantic-release";

await shouldSemanticRelease({ verbose: true });

Development

See .github/CONTRIBUTING.md. Thanks! πŸ’–

Contributors

Josh Goldberg
Josh Goldberg

πŸ’» 🚧 πŸš‡
Katya Pavlenko
Katya Pavlenko

πŸ’»

πŸ’™ This package is based on @JoshuaKGoldberg's create-typescript-app.