⬇️ Download directory from a GitHub repo.
MIT License
⬇️ Download directory from a GitHub repo.
npm install dgh
import dgh from "dgh";
dgh({
owner: "lencx",
repo: "download-github",
name: "test-dgh",
ref: "main", // default `HEAD`
overwrite: true, // default `true`
root: "./", // default `process.cwd()`
});
/* *** repo subdir & file overwrite *** */
import dgh from "dgh";
dgh({
owner: "lencx",
repo: "download-github",
name: "test-dgh",
ref: "HEAD", // github branch, default 'HEAD'
subdir: "src",
})
.on("info", (msg) => {
console.log(msg);
})
.on("overwrite", (files, fs) => {
files.forEach((file) => {
if (/\/utils.ts$/.test(file)) {
// @see https://github.com/jprichardson/node-fs-extra
fs.appendFileSync(file, `\nexport const DGH = 'DGH';\n`);
}
});
})
.on("end", () => {
console.log("dgh end");
});
Options | Required | Description |
---|---|---|
owner |
Y | github username or organization |
repo |
Y | github repository |
name |
Y | app name |
root |
N | app path, default process.cwd()
|
ref |
N | github branch, default HEAD
|
subdir |
N | repository subdirectory |
overwrite |
N | rewrite file content, default true
|
on('overwrite', (files, fs) => void))
- rewrite file content, the options overwrite
must be true
on('end', () => void))
- download complete callback eventon('info', () => void))
- debug logsnpx dgh \
--owner=<github_owner> \
--repo=<github_repo> \
--name=<app_name> \
--subdir=<repo_subdir> \
--root=<app_path>
npm install -g dgh
Args | Required | Description |
---|---|---|
-h or --help
|
dgh command help | |
--owner |
Y | github username or organization |
--repo |
Y | github repository |
--name |
Y | app name |
--root |
N | app path, default process.cwd()
|
--ref |
N | github branch, default HEAD
|
--subdir |
N | repository subdirectory |
# test command 1
npx dgh \
--owner=lencx \
--repo="learn-wasm" \
--name="dgh-test-download" \
--root="my/path"
# test command 2
npx dgh \
--owner=lencx \
--repo="learn-wasm" \
--name="dgh-test-download-2" \
--ref="gh-pages" \
--root="my/path"
# test command 3
npx dgh \
--owner=lencx \
--repo="learn-wasm" \
--name="dgh-test-download-3" \
--ref="gh-pages" \
--subdir="assets" \
--root="my/path"