git-cache
v1.0.1
Published
It is useful for creating a template by git clone. It saved the template to local cached folder to avoid run `git clone` every time creating template. It could significantly improve the speed of installing template.
Downloads
2
Maintainers
Readme
git-cache
It is useful for creating a template by git clone. It saved the template to local cached folder to avoid run git clone
every time creating template. It could significantly improve the speed of installing template.
install
$ npm install git-cache
Usage
const path = require('path');
const os = require('os');
const gitCache = require('git-cache');
gitCache({
git: 'pspgbhu/git-cache',
target: 'project',
cacheDir: path.join(os.homedir(), '.git-cache', 'template'),
}).then(() => {
console.log('Generated template success!');
});
gitCache(options)
- options.git
<string>
The URL of git repository. If this is a github repository, you just input as"<username>/<repo>"
, else must input the whole URL. - options.target
<string>
Create the template to this folder. - options.cacheDir
<string>
Default:path.join(os.homedir(), '.git-cache', hash)
(same options.git have same hash). The template repository will be cached in this folder. - options.branch
<string>
Default:'master'
. The branch of the repository. - options.offline
<boolean>
Default:false
. If this value istrue
, it would copied files directly to target folder, rather than executegit pull
before copy files. Must pay attenation to that it dependent on the local cached files, if there are not cached files, it will executegit clone
before copy. It currently only work with the situation thatoptions.way
equal to'git'
- options.way
<string>
Default:'git'
. The way of downloading template. The valid value are'git'
or'zip'
.'git'
means by git clone,'zip'
means by downloading zip and extracting. - options.zip
<string>
Ifoptions.way
is'zip'
, and the value ofoptions.git
is a whole URL, you must input a zip download URL in this property. Ifoptions.git
is same as'<username>/<repo>'
, you could ignore this item, and it will automatic generated zip download URL.