tardex 0.1.0

Access tarball contents by path
Documentation

tardex

A Rust crate to access a file's contents and metadata in a tarball using its path. It's a "tarball index".

Why?

The tar crate provides an extensive API but randomly accessing tarball entries by path is slightly awkward, because it:

  • requires mutable access to the Archive.
  • requires accessing the entries in order each time, not randomly.

Tardex is just a less featureful alternative interface tuned for a particular use case, built atop it.

Anticipated features

  • Support hard and symbolic link tarball entries
  • Support directory tarball entries
  • Support Tardex<File>, which will require exclusive access to the underlying reader (File is not Clone) when reading an Entry and therefore will need a different API.

License

Tardex is licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in Tardex by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.