94 lines
3.0 KiB
Plaintext
94 lines
3.0 KiB
Plaintext
|
# Installation
|
||
|
> `npm install --save @types/tar-stream`
|
||
|
|
||
|
# Summary
|
||
|
This package contains type definitions for tar-stream (https://github.com/mafintosh/tar-stream).
|
||
|
|
||
|
# Details
|
||
|
Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/tar-stream.
|
||
|
## [index.d.ts](https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/tar-stream/index.d.ts)
|
||
|
````ts
|
||
|
/// <reference types="node" />
|
||
|
|
||
|
import stream = require("stream");
|
||
|
|
||
|
export type Callback = (err?: Error | null) => any;
|
||
|
|
||
|
// see https://github.com/mafintosh/tar-stream/blob/master/headers.js
|
||
|
export interface Headers {
|
||
|
name: string;
|
||
|
mode?: number | undefined;
|
||
|
uid?: number | undefined;
|
||
|
gid?: number | undefined;
|
||
|
size?: number | undefined;
|
||
|
mtime?: Date | undefined;
|
||
|
linkname?: string | null | undefined;
|
||
|
type?:
|
||
|
| "file"
|
||
|
| "link"
|
||
|
| "symlink"
|
||
|
| "character-device"
|
||
|
| "block-device"
|
||
|
| "directory"
|
||
|
| "fifo"
|
||
|
| "contiguous-file"
|
||
|
| "pax-header"
|
||
|
| "pax-global-header"
|
||
|
| "gnu-long-link-path"
|
||
|
| "gnu-long-path"
|
||
|
| null
|
||
|
| undefined;
|
||
|
uname?: string | undefined;
|
||
|
gname?: string | undefined;
|
||
|
devmajor?: number | undefined;
|
||
|
devminor?: number | undefined;
|
||
|
}
|
||
|
|
||
|
export interface Pack extends stream.Readable {
|
||
|
/**
|
||
|
* To create a pack stream use tar.pack() and call pack.entry(header, [callback]) to add tar entries.
|
||
|
*/
|
||
|
entry(headers: Headers, callback?: Callback): stream.Writable;
|
||
|
entry(headers: Headers, buffer?: string | Buffer, callback?: Callback): stream.Writable;
|
||
|
finalize(): void;
|
||
|
[Symbol.asyncIterator](): AsyncIterableIterator<Buffer>;
|
||
|
}
|
||
|
|
||
|
export interface Entry extends stream.Readable {
|
||
|
header: Headers;
|
||
|
[Symbol.asyncIterator](): AsyncIterableIterator<Buffer>;
|
||
|
}
|
||
|
|
||
|
export interface Extract extends stream.Writable {
|
||
|
on(event: string, listener: (...args: any[]) => void): this;
|
||
|
on(
|
||
|
event: "entry",
|
||
|
listener: (headers: Headers, stream: stream.PassThrough, next: (error?: unknown) => void) => void,
|
||
|
): this;
|
||
|
[Symbol.asyncIterator](): AsyncIterator<Entry>;
|
||
|
}
|
||
|
|
||
|
export interface ExtractOptions extends stream.WritableOptions {
|
||
|
/**
|
||
|
* Whether or not to attempt to extract a file that does not have an
|
||
|
* officially supported format in the `magic` header, such as `ustar`.
|
||
|
*/
|
||
|
allowUnknownFormat?: boolean | undefined;
|
||
|
/**
|
||
|
* The encoding of the file name header.
|
||
|
*/
|
||
|
filenameEncoding?: BufferEncoding | undefined;
|
||
|
}
|
||
|
export function extract(opts?: ExtractOptions): Extract;
|
||
|
|
||
|
export function pack(opts?: stream.ReadableOptions): Pack;
|
||
|
|
||
|
````
|
||
|
|
||
|
### Additional Details
|
||
|
* Last updated: Tue, 07 Nov 2023 20:08:00 GMT
|
||
|
* Dependencies: [@types/node](https://npmjs.com/package/@types/node)
|
||
|
|
||
|
# Credits
|
||
|
These definitions were written by [Guy Lichtman](https://github.com/glicht), [Piotr Błażejewicz](https://github.com/peterblazejewicz), [Kevin Lindsay](https://github.com/kevin-lindsay-1), and [Christian Rackerseder](https://github.com/screendriver).
|