Skip to content

Git

Module to generate git related entries.

Overview

commitEntry() generates a random commit entry as printed by git log. This includes a commit hash commitSha(), author, date commitDate(), and commit message commitMessage(). You can also generate a random branch name with branch().

branch

Generates a random branch name.

Available since v5.0.0

Returns: string

ts
function branch(): string;

Examples

ts
faker.git.branch() // 'feed-parse'

commitDate

Generates a date string for a git commit using the same format as git log.

Available since v8.0.0

Parameters

NameTypeDefaultDescription
options{ ... }{}

The optional options object.

options.refDate?string | number | Datefaker.defaultRefDate()

The date to use as reference point for the commit.

Returns: string

ts
function commitDate(
  options: {
    refDate?: string | Date | number;
  } = {}
): string;

Examples

ts
faker.git.commitDate() // 'Mon Nov 7 14:40:58 2022 +0600'
faker.git.commitDate({ refDate: '2020-01-01' }) // 'Tue Dec 31 05:40:59 2019 -0400'

commitEntry

Generates a random commit entry as printed by git log.

Available since v5.0.0

Parameters

NameTypeDefaultDescription
options{ ... }{}

Options for the commit entry.

options.eol?'LF' | 'CRLF''CRLF'

Choose the end of line character to use.

  • 'LF' = '\n',
  • 'CRLF' = '\r\n'
options.merge?booleanfaker.datatype.boolean({ probability: 0.2 })

Set to true to generate a merge message line.

options.refDate?string | number | Datenew Date()

The date to use as reference point for the commit.

Returns: string

ts
function commitEntry(
  options: {
    merge?: boolean;
    eol?: 'LF' | 'CRLF';
    refDate?: string | Date | number;
  } = {}
): string;

Examples

ts
faker.git.commitEntry()
// commit fe8c38a965d13d9794eb36918cb24cebe49a45c2
// Author: Marion Becker <Marion_Becker49@gmail.com>
// Date: Mon Nov 7 05:38:37 2022 -0600
//
//     generate open-source system

commitMessage

Generates a random commit message.

Available since v5.0.0

Returns: string

ts
function commitMessage(): string;

Examples

ts
faker.git.commitMessage() // 'reboot cross-platform driver'

commitSha

Generates a random commit sha.

By default, the length of the commit sha is 40 characters.

For a shorter commit sha, use the length option.

Usual short commit sha length is:

  • 7 for GitHub
  • 8 for GitLab

Available since v5.0.0

Parameters

NameTypeDefaultDescription
options{ ... }{}

Options for the commit sha.

options.length?number40

The length of the commit sha.

Returns: string

ts
function commitSha(
  options: {
    length?: number;
  } = {}
): string;

Examples

ts
faker.git.commitSha() // '2c6e3880fd94ddb7ef72d34e683cdc0c47bec6e6'
faker.git.commitSha({ length: 7 }) // 'dbee57b'
faker.git.commitSha({ length: 8 }) // '0e52376a'

Released under the MIT License.