download-tarball

Download a tarball (optionally gzipped) to a folder & extract it in the process. Uses the wonderful & super quick tar-fs & gunzip-maybe srcraries.

Installation

This is a Node.js module available through the npm registry. It can be installed using the npm or yarn command line tools.

1npm install download-tarball --save

Usage

1/* eslint-disable import/no-extraneous-dependencies */
2
3import download from 'download-tarball';
4
5download({
6  url: 'http://link-to-tarball/file.tar.gz',
7  dir: '/dir/where/file/will/be/downloaded'
8}).then(() => {
9  console.log('file is now downloaded!');
10}).catch(err => {
11  console.log('oh crap the file could not be downloaded properly');
12  console.log(err);
13});
14
15download({
16  url: 'http://link-to-tarball/file.tar.gz',
17  dir: '/dir/where/file/will/be/downloaded',
18  // custom options that will be forwarded to got.stream(..., opts) can also be set
19  gotOpts: {
20    headers: {
21      beep: 'boop'
22    }
23  }
24}).then(() => {
25  console.log('file is now downloaded!');
26}).catch(err => {
27  console.log('oh crap the file could not be downloaded properly');
28  console.log(err);
29});
30
31download({
32  // neat, tar files works as well!
33  url: 'http://link-to-tarball/file.tar',
34  dir: '/dir/where/file/will/be/downloaded'
35}).then(() => {
36  console.log('file is now downloaded!');
37}).catch(err => {
38  console.log('oh crap the file could not be downloaded properly');
39  console.log(err);
40});
41

Tests

1npm install
2npm test

Dependencies

• gunzip-maybe: Transform stream that gunzips its input if it is gzipped and just echoes it if not
• pump: pipe streams together and close all of them if one of them closes
• tar-fs: filesystem bindings for tar-stream

License

MIT