tar and zip

The tar and zip modules adapt Go's archive/tar and archive/zip packages to complete in-memory archives.

Both modules provide write_all(files) and read_all(data). files is a dictionary whose string keys are archive paths and whose values are Bytes or Str. write_all returns archive Bytes; read_all returns a dictionary of file names to Bytes. Directory and other non-regular entries are skipped when reading.

write_all also accepts dest=: the archive then streams into any writer object — an object with a write(data) method, such as an open fs file — and the function returns unit instead of Bytes:

import "x/archive/tar"
import "fs"

var file = fs.create("backup.tar")
tar.write_all({"notes.txt": "remember"}, dest=file)
file.close()

zip.write_all accepts method=zip.DEFLATE and also supports zip.STORE. Malformed archives raise ParseError.

import "x/archive/zip"

var archive = zip.write_all({
    "README.txt": "Goblin archive",
    "data/raw.bin": Bytes("abc"),
})
var files = zip.read_all(archive)
print(files["README.txt"].decode())

Use method=zip.STORE when entries are already compressed or must be stored verbatim; the default zip.DEFLATE generally produces smaller archives. tar.write_all(files) has the same dictionary input but no compression-method argument.

Archive paths are taken from the dictionary keys. Validate untrusted names before writing returned entries to disk: read_all() keeps archive names and does not choose a safe extraction directory for the application. Duplicate entry names collapse to one dictionary key when reading.

These whole-archive operations correspond to iterating Go Reader and Writer entries. Entry contents are still assembled in memory even with dest=; a future streaming reader protocol can add incremental access without changing the archive format or these convenience operations.