?HAMA

Navigation

Breadcrumbs

Create

Edit File Size: 1.27 KB

/opt/alt/alt-nodejs9/root/lib/node_modules/npm/node_modules/node-gyp/node_modules/tar/README.md

Text Base64

# node-tar

Tar for Node.js.

[![NPM](https://nodei.co/npm/tar.png)](https://nodei.co/npm/tar/)

## API

See `examples/` for usage examples.

### var tar = require('tar')

Returns an object with `.Pack`, `.Extract` and `.Parse` methods.

### tar.Pack([properties])

Returns a through stream. Use
[fstream](https://npmjs.org/package/fstream) to write files into the
pack stream and you will receive tar archive data from the pack
stream.

This only works with directories, it does not work with individual files.

The optional `properties` object are used to set properties in the tar
'Global Extended Header'. If the `fromBase` property is set to true,
the tar will contain files relative to the path passed, and not with
the path included.

### tar.Extract([options])

Returns a through stream. Write tar data to the stream and the files
in the tarball will be extracted onto the filesystem.

`options` can be:

```js
{
  path: '/path/to/extract/tar/into',
  strip: 0, // how many path segments to strip from the root when extracting
}
```

`options` also get passed to the `fstream.Writer` instance that `tar`
uses internally.

### tar.Parse()

Returns a writable stream. Write tar data to it and it will emit
`entry` events for each entry parsed from the tarball. This is used by
`tar.Extract`.

Exit & Reset Text mode: syntax highlighting auto-detects file type.

Name	Size	Perms	Modified	Actions
examples DIR	-	drwxr-xr-x	2024-03-03 22:42:04	Edit Download recursive recursive
lib DIR	-	drwxr-xr-x	2024-03-03 22:42:04	Edit Download recursive recursive
node_modules DIR	-	drwxr-xr-x	2024-03-03 22:42:03	Edit Download recursive recursive
.npmignore	63 B	lrw-r--r--	2021-09-28 11:28:48	Edit Download recursive recursive
.travis.yml	45 B	lrw-r--r--	2021-09-28 11:28:48	Edit Download recursive recursive
LICENSE	762 B	lrw-r--r--	2021-09-28 11:28:48	Edit Download recursive recursive
package.json	1.34 KB	lrw-r--r--	2021-09-28 11:28:48	Edit Download recursive recursive
README.md	1.27 KB	lrw-r--r--	2021-09-28 11:28:48	Edit Download recursive recursive
tar.js	4.02 KB	lrw-r--r--	2021-09-28 11:28:48	Edit Download recursive recursive

Directory Contents