An open API service indexing awesome lists of open source software.

https://github.com/pixelastic/gilmore

Glorious git and GitHub toolbox
https://github.com/pixelastic/gilmore

git github

Last synced: 11 months ago
JSON representation

Glorious git and GitHub toolbox

Awesome Lists containing this project

README

          

# gilmore

Gilmore is a toolbox for git and GitHub.

## Installation

```sh
yarn add gilmore
```

## Usage

You need to create an instance of Gilmore for a given repository. Then you can
call all of Gilmore methods on this instance:

```javascript
const Gilmore = require('gilmore');
const repo = new Gilmore('/path/to/repo');

(async () => {
const head = await repo.currentCommit();
console.info(`The HEAD hash is ${head}`);
})();
```

## Options

In addition to the repository root as first argument, you can also pass an
option object as the second argument.

The accepted options are as follow:

| Name | Default value | Description |
| -------------- | ------------- | ------------------------------------------------- |
| `globalConfig` | `true` | Set to `false` to not inherit from `~/.gitconfig` |

## Documentation

The complete documentation can be found on https://projects.pixelastic.com/gilmore/