@commitlint/parse

What is @commitlint/parse?

The @commitlint/parse package is used to parse commit messages according to the conventions used by commitlint. It takes a raw commit message string and returns a promise that resolves to an object representing the parsed commit, which includes information such as the header, type, scope, subject, body, footer, and references. This package is typically used in the context of commit message linting to ensure that commit messages follow a certain format.

What are @commitlint/parse's main functionalities?

Parsing commit messages

This feature allows you to parse a commit message and obtain an object with structured information about the commit. The code sample demonstrates how to use the parse function to parse a commit message and log the result.

const parse = require('@commitlint/parse');
const message = 'feat(scope): add new feature';
parse(message).then(commit => {
  console.log(commit);
});

Other packages similar to @commitlint/parse

conventional-commits-parser

This package is similar to @commitlint/parse as it provides functionality to parse conventional commit messages. It can be used to extract metadata from commit messages following the Conventional Commits specification. It differs in its API and may offer different customization options.

README

Parse commit messages to structured data

@commitlint/parse

Install

npm install --save @commitlint/parse

Use

const parse = require('@commitlint/parse');

API

parse(message: string, parser: Function, parserOpts: Object)

• message: Commit message to parser
• parser: Sync parser function to use. Defaults to sync of conventional-commits-parser
• parserOpts: Options to pass to parser

  {
    commentChar: null, // character indicating comment lines
    issuePrefixes: ['#'] // prefix characters for issue references
  }
  

Changelog

19.5.0 (2024-09-11)

Features

• cli: use special errorCode for missing rules/config #4142 (#4143) (d7070d8)