ponzu

command module
v0.0.0-...-2b7ea9d Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jan 29, 2024 License: CC-BY-SA-4.0, MIT, MIT-0 Imports: 4 Imported by: 0

README

Ponzu: The new standard linear archive

This repository contains the specification for Ponzu, a linear archive format, and Parc, the Ponzu ARChiver reference implementation.

For information on the format itself, see the spec.

Why?

Because tar Sucks. The full details are included in the spec rationale, but short form is that Tar has a lot of extensions that were meant to unify the standard but only ended up making it worse.

Worse, different implementations of the Tar archive format have different and bad caveats, pitfalls, etc.

Additionally, because it has no concept of compression, Tar fails to handle large, sparse datasets that are spread across multiple files.

Building

To build the reference archiver, run

make clean
make all

This will compile the parc binary in bin/.

Testing

To run the test suite, run

make test

Spewstat

During development, I needed a mechanism to print the OS-specific stat information. spewstat (make spewstat) dumps the internal Go representation of

  • stat
  • stat.Sys()

and Xattrs.

License

The text of the Ponzu spec is given CC-BY-SA 4.0 The ponzu library in Go is MIT. The reference archiver implementation is given MIT-0.

for more information, see LICENSE.md

Documentation

The Go Gopher

There is no documentation for this package.

Directories

Path Synopsis
cmd
ponzu
format
The Format package describes the strucutres of the underlying Ponzu archive.
The Format package describes the strucutres of the underlying Ponzu archive.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL