@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

Load shared commitlint configuration

@commitlint/load

Getting started

npm install --save-dev @commitlint/load

Example

const load = require('@commitlint/load').default;

load({extends: ['./package']}).then((config) => console.log(config));
// => { extends: ['./package', './package-b'], rules: {} }

Consult docs/api for comprehensive documentation.

Changelog

17.8.1 (2023-10-20)

Note: Version bump only for package @commitlint/root