Node.js package to get information about the current status of a git working copy.

This package was created to be used in the context of Terraform. See terraform-ppwcode-modules.

Installation

To install, do

> npm install --save \@ppwcode/node-gitinfo

Usage in code

When used in other code, use

const GitInfo = require("@ppwcode/node-gitinfo)
 

You can tag with

const tagGitRepo = require("@ppwcode/node-gitinfo/tagGitRepo)

CLI

gitinfo.js is a CLI tool that uses this code. See

 > node ./bin/gitinfo.js -h
 

for help. This program is installed in npm as gitinfo.

 > node ./bin/gitinfo.js gi
 

is intended for use in a Terraform external data source provider. It returns JSON.

Compatibility

This library is intended to be compatible with Node 6, 8, and 10.

Development

Node version

Development is done in Node 10, via nvm.

Compatibility

The code does not use async / await, which was introduced in Node 8.

Also, we use Q as Promise library, instead of native Promises, since Node 6 does not yet support util.promisify(). We use Q.nfcall instead.

Style

This code uses Standard coding style.

TODO

Setup a CI

Move to ppwcode team. Request access from Travis. Create parallel builds for Node 6, 8 10, and back tag.

Test bin

Create integration tests for the bin/gitInfo.js with 100% coverage.