github-download

2019-08-15

github-download是什么

什么是github-download,Easily download Github repos without any external dependencies such as Git, Tar, Unzip, etc.

github-download使用教程帮助文档

Node.js - github-download

build status

Easily download Github repos without any external dependencies such as Git, Tar, Unzip, etc.

Why?

I really like the concept of managing user defined projects, repos, file structures (package management) on Github like the way that Component does package management. I have a package management system Rock that I use to create skeleton/templates of projects. I wanted Rock to use Github as a package management system. I also didn't want any dependencies amongst any 3rd party programs like Git, Tar, or Unzip. Pure Node.js JavaScript is what I wanted.

Installation

npm install github-download

Usage

ghdownload(params, dir)

Downloads the latest copy of some Github reference (branch, tag, or commit), or the master branch by default (specifically the master branch, it does not honor Github's default branch configuration). This will still work even if the Github API limit has been reached.

  • params: Can either be:
    • a Github URL string such as:
      • https://github.com/jprichardson/node-vcsurl.git
      • git@github.com:jprichardson/node-vcsurl.git
      • git://github.com/jprichardson/node-vcsurl.git
      • and even including a reference, e.g. https://github.com/jprichardson/node-vcsurl.git#master
    • or an object like so: {user: 'jprichardson', repo: 'vcsurl', ref: 'master'}
  • dir: The output directory. Uses the current working directory if nothing is specified.

Returns a GithubDownloader object that emits events on dir, file, and end.

Example:

var ghdownload = require('github-download')
  , exec = require('exec')

ghdownload({user: 'jprichardson', repo: 'node-batchflow', ref: 'master'}, process.cwd())
.on('dir', function(dir) {
  console.log(dir)
})
.on('file', function(file) {
  console.log(file)
})
.on('zip', function(zipUrl) { //only emitted if Github API limit is reached and the zip file is downloaded
  console.log(zipUrl)
})
.on('error', function(err) {
  console.error(err)
})
.on('end', function() {
  exec('tree', function(err, stdout, sderr) {
    console.log(stdout)
  })
})

Outputs:

.
├── CHANGELOG.md
├── LICENSE
├── README.md
├── lib
│   └── batchflow.js
├── package.json
└── test
    ├── batchflow-par-array.test.js
    ├── batchflow-par-limit.test.js
    ├── batchflow-par-object.test.js
    ├── batchflow-seq-array.test.js
    ├── batchflow-seq-object.test.js
    ├── batchflow.test.js
    ├── mocha.opts
    └── resources

3 directories, 12 files

License

(MIT License)

Copyright 2013-2016, JP Richardson jprichardson@gmail.com


上一篇:truffle-core
下一篇:vcsurl
相关文章

首次访问,人机识别验证

扫描下方二维码回复 1024 获取验证码,验证完毕后 永久 无须验证

操作步骤:[打开微信]->[扫描上侧二维码]->[关注 FedJavaScript 的微信] 输入 1024 获取验证码

验证码有误,请重新输入