txtar
packagestandard libraryThis package is not in the latest version of its module.
Details
Validgo.mod file
The Go module system was introduced in Go 1.11 and is the official dependency management solution for Go.
Redistributable license
Redistributable licenses place minimal restrictions on how software can be used, modified, and redistributed.
Tagged version
Modules with tagged versions give importers more predictable builds.
Stable version
When a project reaches major version v1 it is considered stable.
- Learn more about best practices
Repository
Links
Documentation¶
Overview¶
Package txtar implements a trivial text-based file archive format.
The goals for the format are:
- be trivial enough to create and edit by hand.
- be able to store trees of text files describing go command test cases.
- diff nicely in git history and code reviews.
Non-goals include being a completely general archive format,storing binary data, storing file modes, storing special files likesymbolic links, and so on.
Txtar format¶
A txtar archive is zero or more comment lines and then a sequence of file entries.Each file entry begins with a file marker line of the form "-- FILENAME --"and is followed by zero or more file content lines making up the file data.The comment or file content ends at the next file marker line.The file marker line must begin with the three-byte sequence "-- "and end with the three-byte sequence " --", but the enclosedfile name can be surrounding by additional white space,all of which is stripped.
If the txtar file is missing a trailing newline on the final line,parsers should consider a final newline to be present anyway.
There are no possible syntax errors in a txtar archive.
Index¶
Constants¶
This section is empty.
Variables¶
This section is empty.