You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
isaacs 33a9ac6087 Upgrade npm to 1.1.21 13 years ago
..
lib Upgrade npm to 1.1.21 13 years ago
.npmignore npm 1.1.0-beta-2 13 years ago
.travis.yml npm 1.1.0-beta-2 13 years ago
README.md Include NPM, update .pkg to install it. 13 years ago
package.json Upgrade npm to 1.1.21 13 years ago
tar.js Include NPM, update .pkg to install it. 13 years ago

README.md

node-tar

Tar for Node.js.

Goals of this project

  1. Be able to parse and reasonably extract the contents of any tar file created by any program that creates tar files, period.

    At least, this includes every version of:

    • bsdtar
    • gnutar
    • solaris posix tar
    • Joerg Schilling's star ("Schilly tar")
  2. Create tar files that can be extracted by any of the following tar programs:

    • bsdtar/libarchive version 2.6.2
    • gnutar 1.15 and above
    • SunOS Posix tar
    • Joerg Schilling's star ("Schilly tar")
  3. 100% test coverage. Speed is important. Correctness is slightly more important.

  4. Create the kind of tar interface that Node users would want to use.

  5. Satisfy npm's needs for a portable tar implementation with a JavaScript interface.

  6. No excuses. No complaining. No tolerance for failure.

But isn't there already a tar.js?

Yes, there are a few. This one is going to be better, and it will be fanatically maintained, because npm will depend on it.

That's why I need to write it from scratch. Creating and extracting tarballs is such a large part of what npm does, I simply can't have it be a black box any longer.

Didn't you have something already? Where'd it go?

It's in the "old" folder. It's not functional. Don't use it.

It was a useful exploration to learn the issues involved, but like most software of any reasonable complexity, node-tar won't be useful until it's been written at least 3 times.