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}` // Omri committed Some changesGetters
| 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 |
owner |
string | Remote repository owner | await git.owner |
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 |
tags |
string[] | List of tags | await git.tags |
unadded |
string[] | List of files that would be added or removed by 'git add' | await git.unadded |
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) // reset number of commit back
await git.reset('f5db755') // reset to specific SHA ID| 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 |