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 changes

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
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