tar-iterator

Extract contents from tar archive type using an iterator API using streams or paths. Use stream interface and pipe transforms to add decompression algorithms

MIT 113 个版本

extract iterator asyncIterator Symbol.asyncIterator extract-tar extract-bz2 extract-gz extract-xz extract-tgz decompress decompress-tar decompress-bz2 decompress-gz decompress-xz decompress-tgz .tar tar .tar.bz2 tar.bz2 .tar.gz tar.gz .tar.xz tar.xz .tgz tgz tar-stream stream

主页

仓库

提交 Issue

安装

npm install tar-iterator

yarn add tar-iterator

pnpm add tar-iterator

bun add tar-iterator

README

tar-iterator

Extract contents from tar archive type using an iterator API using streams or paths. Use stream interface and pipe transforms to add decompression algorithms.

// asyncIterator

var assert = require('assert');
var fs = require('fs');
var TarIterator = require('tar-iterator');


(async function() {
  let iterator = new TarIterator('/path/to/archive');

  try {
    const links = [];
    for await (const entry of iterator) {
      if (entry.type === 'link') links.unshift(entry);
      else if (entry.type === 'symlink') links.push(entry);
      else await entry.create(dest, options);
    }

    // create links after directories and files
    for (const entry of links) await entry.create(dest, options);
  } catch (err) {
    }

  iterator.destroy();
  iterator = null;
})();

(async function() {
  let iterator = new TarIterator(fs.createReadStream('/path/to/archive'));

  try {
    const links = [];
    for await (const entry of iterator) {
      if (entry.type === 'link') links.unshift(entry);
      else if (entry.type === 'symlink') links.push(entry);
      else await entry.create(dest, options);
    }

    // create links after directories and files
    for (const entry of links) await entry.create(dest, options);
  } catch (err) {
    }

  iterator.destroy();
  iterator = null;
})();

// Async / Await

var assert = require('assert');
var TarIterator = require('tar-iterator');

// one by one
(async function() {
  let iterator = new TarIterator('/path/to/archive');

  try {
    const links = [];
    for await (const entry of iterator) {
      if (entry.type === 'link') links.unshift(entry);
      else if (entry.type === 'symlink') links.push(entry);
      else await entry.create(dest, options);
    }

    // create links after directories and files
    for (const entry of links) await entry.create(dest, options);
  } catch (err) {
    }

  iterator.destroy();
  iterator = null;
})();

// infinite concurrency
(async function() {
  let iterator = new TarIterator('/path/to/archive');

  try {
    const links = [];
    await iterator.forEach(
      async function (entry) {
        if (entry.type === 'link') links.unshift(entry);
        else if (entry.type === 'symlink') links.push(entry);
        else await entry.create(dest, options);
      },
      { concurrency: Infinity }
    );

    // create links after directories and files
    for (const entry of links) await entry.create(dest, options);
  } catch (err) {
    aseert.ok(!err);
  }

  iterator.destroy();
  iterator = null;
})();

// Callbacks

var assert = require('assert');
var Queue = require('queue-cb');
var TarIterator = require('tar-iterator');

var iterator = new TarIterator('/path/to/archive');

// one by one
var links = [];
iterator.forEach(
  function (entry, callback) {
    if (entry.type === 'link') {
      links.unshift(entry);
      callback();
    } else if (entry.type === 'symlink') {
      links.push(entry);
      callback();
    } else entry.create(dest, options, callback);
  },
  { callbacks: true, concurrency: 1 },
  function (err) {
  
    // create links after directories and files
    var queue = new Queue();
    for (var index = 0; index < links.length; index++) {
      var entry = links[index];
      queue.defer(entry.create.bind(entry, dest, options));
    }
    queue.await(callback);

    iterator.destroy();
    iterator = null;
  }
);

版本列表

3.3.9 2026-05-26

3.3.8 2026-05-26

3.3.7 2026-05-22

3.3.6 2025-12-27

3.3.5 2025-12-25

3.3.4 2025-12-25

3.3.3 2025-12-24

3.3.2 2025-12-22

3.3.1 2025-12-20

3.3.0 2025-12-18

3.2.0 2025-12-16

3.1.11 2025-12-15

3.1.10 2025-12-14

3.1.9 2025-12-12

3.1.8 2025-12-12

3.1.7 2025-12-12

3.1.6 2025-12-06

3.1.5 2025-12-04

3.1.4 2025-12-04

3.1.3 2025-12-04

3.1.2 2025-12-03

3.1.1 2025-12-03

3.1.0 2025-12-02

3.0.2 2025-12-01

3.0.1 2025-12-01

3.0.0 2025-12-01

2.2.9 2025-11-06

2.2.8 2025-10-21

2.2.7 2025-10-21

2.2.6 2025-07-08

2.2.5 2025-06-30

2.2.4 2025-06-29

2.2.3 2025-06-29

2.2.2 2025-06-28

2.2.1 2025-06-28

2.2.0 2025-06-28

2.1.0 2025-06-22

2.0.4 2025-06-21

2.0.3 2025-06-20

2.0.2 2025-06-18

2.0.1 2025-06-18

2.0.0 2025-06-17

1.3.11 2025-06-16

1.3.10 2025-06-15

1.3.9 2025-06-15

1.3.8 2025-06-15

1.3.7 2025-06-14

1.3.6 2025-06-14

1.3.5 2025-05-24

1.3.4 2025-05-20

1.3.3 2025-05-19

1.3.2 2025-05-19

1.3.1 2025-05-19

1.3.0 2025-05-19

1.2.27 2025-05-18

1.2.26 2025-05-18

1.2.25 2025-01-23

1.2.24 2025-01-23

1.2.23 2025-01-23

1.2.22 2025-01-23

1.2.21 2025-01-23

1.2.20 2025-01-23

1.2.19 2025-01-23

1.2.18 2025-01-23

1.2.17 2025-01-15

1.2.16 2025-01-15

1.2.15 2025-01-15

1.2.14 2025-01-14

1.2.13 2025-01-14

1.2.12 2025-01-12

1.2.11 2025-01-12

1.2.10 2025-01-12

1.2.9 2025-01-04

1.2.8 2025-01-04

1.2.7 2025-01-04

1.2.6 2025-01-04

1.2.5 2025-01-04

1.2.4 2025-01-04

1.2.3 2025-01-04

1.2.2 2024-12-28

1.2.0 2024-12-25

1.1.8 2024-12-25

1.1.6 2024-12-21

1.1.5 2024-12-16

1.1.4 2024-12-16

1.1.3 2024-12-16

1.1.2 2024-11-30

1.1.1 2024-11-29

1.1.0 2024-11-23

1.0.1 2024-02-20

1.0.0 2024-02-18

0.3.2 2024-02-18

0.3.1 2024-02-17

0.3.0 2024-02-17

0.2.9 2022-08-15

0.2.8 2022-08-15

0.2.7 2022-08-15

0.2.6 2022-08-14

0.2.5 2022-08-14

0.2.4 2022-06-29

0.2.3 2021-10-25

0.2.2 2021-10-25

0.2.1 2021-10-25

0.2.0 2021-07-26

0.1.10 2020-07-06

0.1.9 2020-06-21

0.1.8 2020-06-21

0.1.6 2020-06-20

0.1.5 2020-06-18

0.1.4 2020-06-17

0.1.3 2020-06-17

0.1.1 2020-06-15

0.1.0 2020-06-15