async-git
👾 Retrieve data from current git repository
* Getter properties are async (getters) more on async properties
const git = require('async-git');
`${await git.author} committed ${await git.message}`
Getters
Property | Type | Description | Example |
---|
author | string | Author name of the last commit | await git.author |
body | string | Most recent commit message body | await git.body |
branch | string | Current branch name | await git.branch |
changed | string[] | List of files changed in last commit | await git.changed |
comitter | string | Comitter name of the last commit | await git.comitter |
date | Date | Date of the last change | await git.date |
email | string | Author email of the last commit | await git.email |
message | string | Most recent commit full message (subject and body) | await git.message |
name | string | Project name | await git.name |
origin | string | Remote origin URL | await git.origin |
sha | string | Unique identifier of the last commit | await git.sha |
short | string | 7 Character Unique identifier of the last commit | await git.short |
staged | string[] | List of staged files | await git.staged |
subject | string | Most recent commit subject | await git.subject |
unstaged | string[] | List of unstaged files | await git.unstaged |
untracked | string[] | List of untracked files | await git.untracked |
version | string | Get git version (semver) | await git.version |
Functions
modified
Get the last modified date of a file
await modified('./index.js')
Argument | Return value |
---|
{string} Path to file | {Date} Last modified date |
reset
Reset current HEAD to the specified destination
await git.reset(1)
await git.reset('f5db755')
Argument | Return value |
---|
{string|number} State ID | {void} nothing |
tag
Create a tag using the last commit message
await git.tag('1.2.3')
Argument | Return value |
---|
{string} Version | {void} nothing |