repo-git-downloader

0.1.1 • Public • Published

repo-git-downloader

A tool to download git repository.

Install

    npm install repo-git-downloader --save
    # OR
    yarn add repo-git-downloader --save

API

download(url, options, callback)

You can customize the name and reference this package. Such as:

    const download = require('repo-git-downloader')

download receives 3 parameters:

  • url: Required
  • options: Optional
  • callback: Required

url

It identifies the repository link of git. Support the following types:

GitHub type url
  • owner/name
  • github:owner/name
  • git@github.com:owner/name.git
  • https://github.com/owner/name.git

If you want to get a branch(dev, etc.) or tag(v1.0.0, etc.) from git repository:

  • owner/name#checkout
  • github:owner/name#checkout
  • git@github.com:owner/name#checkout.git
  • https://github.com/owner#checkout/name.git
GitLab type url
  • gitlab:owner/name
  • git@gitlab.com:owner/name.git
  • https://gitlab.com/owner/name.git

You also can get a branch(dev, etc.) or tag(v1.0.0, etc.) from git repository same as above.

options

type

It identifies the download type of git. It provides 3 options:

  • ssh(defalut)
  • https
  • direct

The direct option allow to download a *.zip file of respository.

Notes: If you use ssh, you must generate ssh ECDSA key at git repository

dist

It identifies the location of the download. Default is current directory(./). You can define absolute paths and relative paths.

custom
  • Boolean: true|false(defalut)

It define a custom git url if you use the company's internal network or private repository.

callback

The callback when download complete or throw a error. Having a parameter: (err) => {}

Examples

  • simple download:
    download('mnichangxin/repo-git-downloader', (err) => {
        if (err) {
            // handle err
            return
        }
        // handle done
    })
  • Provide option type:

Although it is github https url, but using type: ssh to download by ssh type.

    download('https://github.com/mnichangxin/repo-git-downloader.git', {
        type: 'ssh'
    }, (err) {
        if (err) {
            // handle err
            return
        }
        // handle done
    })
  • checkout download:

It will download dev branch of repository.

    download('mnichangxin/repo-git-downloader#dev', (err) => {
        if (err) {
            // handle err
            return
        }
        // handle done
    })

License

MIT

Readme

Keywords

Package Sidebar

Install

npm i repo-git-downloader

Weekly Downloads

1

Version

0.1.1

License

MIT

Unpacked Size

19.5 kB

Total Files

14

Last publish

Collaborators

  • mnichangxin