Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/forbeslindesay/gethub

Download a github repository to a folder using the .tar.gz bundle
https://github.com/forbeslindesay/gethub

Last synced: 16 days ago
JSON representation

Download a github repository to a folder using the .tar.gz bundle

Awesome Lists containing this project

README

        

[![Build Status](https://img.shields.io/travis/ForbesLindesay/gethub/master.svg)](https://travis-ci.org/ForbesLindesay/gethub) [![Dependency Status](https://img.shields.io/david/ForbesLindesay/gethub.svg)](https://david-dm.org/ForbesLindesay/gethub)
# GetHub

Download a github repository to a folder using the .tar.gz bundle

## Installation

$ npm install gethub

## Usage

### Command Line

The following command downloads `gethub` at the `master` tag into the `gethub` folder

$ gethub ForbesLindesay/gethub

### API

```javascript
var join = require('path').join;
var download = require('gethub');

download('ForbesLindesay', 'gethub', 'master', join(__dirname, 'gethub'), function (err) {
if (err) throw err;
console.log('downloaded ForbesLindesay/gethub@master into: ' + join(__dirname, 'gethub'));
});
```

### Promise API

If you omit the callback, a promise is returned.

```javascript
var join = require('path').join;
var download = require('gethub');

download('ForbesLindesay', 'gethub', 'master', join(__dirname, 'gethub'))
.then(function (err) {
console.log('downloaded into: ' + join(__dirname, 'gethub'));
}, function (err) {
console.warn(err.stack);
});
```

## License

MIT