https://github.com/nodef/extra-download
Download and extract files (with progress).
https://github.com/nodef/extra-download
cli console download extra extract file http https progress shell
Last synced: 10 months ago
JSON representation
Download and extract files (with progress).
- Host: GitHub
- URL: https://github.com/nodef/extra-download
- Owner: nodef
- License: mit
- Created: 2018-11-08T10:08:22.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2020-09-14T06:20:18.000Z (over 5 years ago)
- Last Synced: 2025-01-26T09:15:56.814Z (12 months ago)
- Topics: cli, console, download, extra, extract, file, http, https, progress, shell
- Language: JavaScript
- Homepage: https://www.npmjs.com/package/extra-download
- Size: 26.4 KB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[Download] and extract files (with [progress]).
## console
```bash
$ download [options]
# --help: show help
# -o | --out: Where to place the downloaded files
# -e | --extract: Try decompressing the file
# -s | --strip : Strip leading paths from file names on extraction
# --filename : Name of the saved file
# --proxy : Proxy endpoint
# --header : HTTP header. Can be set multiple times
$ download http://foo.com/file.zip
$ download http://foo.com/cat.png > dog.png
$ download --extract --strip 1 --out dest http://foo.com/file.zip
$ download --header 'authorization: Basic foo:bar' http://foo.com/file.zip
```
## package
```js
const fs = require('fs');
const download = require('extra-download');
// download(, [out], [options])
// -> Promise & with additional events
// [options]: {
// extract: false, // try decompressing the file?
// filename: null, // name of the saved file
// proxy: null, // proxy endpoint
// progress: new Progress(...), // progress object (null to disable)
// onresponse: /* handler */ // download stream response handler
// }
await download('http://unicorn.com/foo.jpg', 'dist');
console.log('done!');
var data = await download('http://unicorn.com/foo.jpg');
fs.writeFileSync('dist/foo.jpg', data);
var stream = download('unicorn.com/foo.jpg');
stream.pipe(fs.createWriteStream('dist/foo.jpg'));
var urls = [
'unicorn.com/foo.jpg',
'cats.com/dancing.gif'
];
await Promise.all(urls.map(url => download(url, 'dist')));
console.log('files downloaded!');
```
[](https://merferry.github.io)
> See about [Duplex stream], and [additional events].
> See the original modules: [download], [download-cli].
[Duplex stream]: https://nodejs.org/api/stream.html#stream_class_stream_duplex
[additional events]: https://github.com/sindresorhus/got#streams-1
[Download]: https://www.npmjs.com/package/download
[download]: https://www.npmjs.com/package/download
[download-cli]: https://www.npmjs.com/package/download-cli
[progress]: https://www.npmjs.com/package/progress