package b0

  1. Overview
  2. Docs
Software construction and deployment kit

Install 

dune-project
 Dependency

erratique.ch Readme Changelog ISC; BSD-2-Clause License Edit opam file Versions (2)

Authors

  1. T
    The b0 programmers

Maintainers

  1. Daniel Bünzli

Sources

b0-0.0.6.tbz
sha512=e9aa779e66c08fc763019f16d4706f465d16c05d6400b58fbd0313317ef33ddea51952e2b058db28e65f7ddb7012f328c8bf02d8f1da17bb543348541a2587f0

doc/b0.std/B0_tar/index.html

Module B0_tarSource

tar file archives.

For making reproducible tar archives, an (us)tar archiver OCaml implementation is provided. Unarchiving and compression support occurs via shell outs.

References.

Ustar encoder

Sourcetype ptime = int

The type for POSIX times in seconds since the epoch.

Sourcetype member = [
  1. | `Dir
    (*

    Directory.

    *)
  2. | `File of string
    (*

    File with given content.

    *)
]

The type for archive member.

Sourcetype t

The type for ustar archives.

Sourceval empty : t

empty is the empty ustar archive.

Sourceval add : t -> B0_std.Fpath.t -> mode:int -> mtime:ptime -> member -> (t, string) result

add a path ~mode ~mtime member adds member to archive a with file path path, permission mode mode and modificaton time mtime.

Sourceval to_string : t -> string

to_string a is the byte serialization of the archive a.

Sourceval of_dir : dir:B0_std.Fpath.t -> exclude_paths:B0_std.Fpath.Set.t -> root:B0_std.Fpath.t -> mtime:int -> (string, string) result

of_dir ~dir ~exclude_paths ~root ~mtime is a (us)tar archive that contains the file hierarchy dir except the relative hierarchies and files present in exclude_paths. Symbolic links are followed.

In the archive, members of dir are rerooted at root and sorted according to B0_std.Fpath.compare (for determinism). They have their modification time set to mtime and their file permissions are 0o775 for directories and files executable by the user and 0o664 for other files. No other file metadata is preserved.

Compressing

Sourceval compress : ?search:B0_std.Cmd.tool_search -> force:bool -> make_path:bool -> B0_std.Fpath.t -> archive:string -> (unit, string) result

compress ~force ~make_path file ~archive compresses archive archive to file. For force and make_path see B0_std.Os.Cmd.out_file.

The compression algorithm and tool looked up with search (defaults to Os.Cmd.get ?search) depends on the file extension of file:

  • For .tar no tool is used.
  • For .tgz or .gz the Cmd.tool "gzip" tool is used.
  • For .tbz or .bzip2 the Cmd.tool "bzip2" tool is used.
  • For .xz then the Cmd.tool "lzma" tool is used.
  • For .zst then the Cmt.tool "zstd" tool is used.
  • Otherwise the function errors.

Unarchiving

Sourceval unarchive : ?search:B0_std.Cmd.tool_search -> make_path:bool -> verbose:bool -> src:B0_std.Fpath.t -> in_dir:B0_std.Fpath.t -> unit -> (unit, string) result

unarchive ~make_path ~src ~in_dir unarchives src in directory in_dir which is created if it doesn't exist. For make_path see B0_std.Os.Dir.create. If verbose is true -v is passed to tar.

The compression algorithm and tool is to use is looked up with search like in compress.