@commitlint/load

What is @commitlint/load?

The @commitlint/load package is part of the commitlint toolchain, which is used to enforce consistent commit message formats according to various configurable rules. This package specifically handles the loading of commitlint configuration from various sources, allowing users to define rules that commit messages should adhere to in their projects.

What are @commitlint/load's main functionalities?

Load Configuration

This feature allows the loading of commitlint configuration files. It supports loading from a specified path or from node_modules. The example shows how to load a common configuration that extends '@commitlint/config-conventional'.

const { load } = require('@commitlint/load');

async function loadConfig() {
  const config = await load({extends: ['@commitlint/config-conventional']});
  console.log(config);
}

loadConfig();

Merge Configurations

This feature demonstrates how to merge custom rules with existing configurations. The example merges a custom rule that restricts commit types to 'feat', 'fix', and 'docs' into the project's commitlint configuration.

const { load } = require('@commitlint/load');

async function mergeConfigs() {
  const config = await load({
    rules: {
      'type-enum': [2, 'always', ['feat', 'fix', 'docs']]
    }
  }, {cwd: '/path/to/project'});
  console.log(config);
}

mergeConfigs();

Other packages similar to @commitlint/load

husky

Husky is a tool for managing Git hooks. It can be used alongside commitlint by triggering linting on commits. While husky itself does not provide commit message linting, it is commonly used to run commitlint checks before commits are allowed. This makes it a complementary tool rather than a direct alternative.

README

@commitlint/load

Load shared commitlint configuration

Getting started

npm install --save-dev @commitlint/load

Documentation

Consult API docs for comprehensive documentation.

Documentation generated from docs folder.

Changelog

19.8.0 (2025-03-07)

Bug Fixes

• config-lerna-scopes: remove deprecated @lerna/project dependency (#4284) (f2f78f1)
• update dependency semver to v7.7.1 (#4272) (6148587)

Features

• config-workspace-scopes: add config preset for npm and yarn workspaces (#4269) (67ff9e8)

Performance Improvements

• use node: prefix to bypass require.cache call for builtins (#4302) (0cd8f41)

Reverts

• Revert "fix: improve security validation regex in is-ignored function (#4258)" (#4314) (b27024a), closes #4258 #4314