1.2.0 • Published 1 year ago

octoherd-script-get-files v1.2.0

Weekly downloads
-
License
ISC
Repository
github
Last release
1 year ago

octoherd-script-get-files

The easiest way to download files from GitHub.

@latest Build Status

Usage

Minimal usage

npx octoherd-script-get-files \
  --source README.md \
  --output ./out

Pass all options as CLI flags to avoid user prompts

npx octoherd-script-get-files \
  -T ghp_0123456789abcdefghjklmnopqrstuvwxyzA \
  -R "octolinker/*" \
  --source README.md \
  --output ./out

Options

optiontypedescription
--sourcestringRequired. File to download. This can also be a Glob see example.
--outputstringRequired. Specify a path to place the downloaded file or directory (instead of using the current working directory). Directories specified in the path will be created by this command.
--ignore-archived or --no-ignore-archivedbooleanDefault true. Ignores archive repositories
--ignore-forks or --no-ignore-forksbooleanDefault true. Ignores forked repositories
--ignore-public or --no-ignore-publicbooleanDefault false. Ignores public repositories
--ignore-private or --no-ignore-privatebooleanDefault false. Ignores private repositories
--octoherd-token, -TstringA personal access token (create). Script will create one if option is not set
--octoherd-repos, -Rarray of stringsOne or multiple space-separated repositories in the form of repo-owner/repo-name. repo-owner/* will find all repositories for one owner. * will find all repositories the user has access to. Will prompt for repositories if not set
--octoherd-bypass-confirmsbooleanBypass prompts to confirm mutating requests

Examples

Download a single file

npx octoherd-script-get-files -R octolinker/octolinker --source=README.md --output=./out

Download a single file by full path

npx octoherd-script-get-files -R octolinker/octolinker --source=.github/PULL_REQUEST_TEMPLATE.md --output=./out

Download recursively all files with a certain file extension

npx octoherd-script-get-files -R octolinker/octolinker --source='**/*.html' --output=./out

Download recursively all files from a specific folder

npx octoherd-script-get-files -R octolinker/octolinker --source='.github/**/*' --output=./out

Download everything

npx octoherd-script-get-files -R octolinker/octolinker --source='**/*' --output=./out

Don't know how to write Glob? Check out DigitalOcean's amazing Glob testing tool.

Contributing

See CONTRIBUTING.md

About Octoherd

@octoherd is project to help you keep your GitHub repositories in line.

License

ISC