ls-archive

Node Module for archive files

Showing:

Popularity

Downloads/wk

2.7K

GitHub Stars

13

Maintenance

Last Commit

2yrs ago

Contributors

10

Package

Dependencies

6

License

Type Definitions

Tree-Shakeable

No?

Categories

Readme

Node Ls Archive Module Build Status

List or read the files and folders inside archive files.

Supported file extensions:

  • .epub
  • .jar
  • .love
  • .nupkg
  • .tar
  • .tar.gz
  • .tgz
  • .tar.bz2
  • .tbz
  • .tbz2
  • .war
  • .zip
  • .egg
  • .whl
  • .xpi

Installing

npm install ls-archive

Building

  • Clone the repository
  • Run npm install
  • Run grunt to compile CoffeeScript code
  • Run grunt test to run the specs

Using

archive = require 'ls-archive'

archive.list(archivePath, callback)

List the files and folders inside the archive file path. The callback gets two arguments (error, archiveEntries).

archivePath - The string path to the archive file.

callback - The function to call after reading completes with an error or an array of ArchiveEntry objects.

archive.readFile(archivePath, filePath, callback)

Read the contents of the file path in the archive path and invoke the callback with those contents. The callback gets two arguments (error, filePathContents).

archivePath - The string path to the archive file.

filePath - The string path inside the archive to read.

callback - The function to call after reading completes with an error or the Buffer contents.

archive.readGzip(gzipArchivePath, callback)

Read the contents of the gzipped archive path and invoke the callback with the Buffer contents of the uncompressed paths. The callback gets two arguments (error, pathContents).

gzipArchivePath - The string path to the gzipped archive file.

callback - The function to call after reading completes with an error or the Buffer contents.

archive.readBzip(bzipArchivePath, callback)

Read the contents of the bzipped archive path and invoke the callback with the Buffer contents of the uncompressed paths. The callback gets two arguments (error, pathContents).

bzipArchivePath - The string path to the bzipped archive file.

callback - The function to call after reading completes with an error or the Buffer contents.

ArchiveEntry

Class representing a path entry inside an archive file.

.isFile()

Is the entry a file?

Returns true if a file, false otherwise.

.isFolder()

Is the entry a folder?

Returns true if a folder, false otherwise.

Is the entry a symbolic link?

Returns true if a symbolic link, false otherwise.

.getPath()

Get the path of this entry.

Returns the string path.

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100
No reviews found
Be the first to rate

Alternatives

No alternatives found

Tutorials

No tutorials found
Add a tutorial