The twig tool is a low-level plumbing utility.
It provides access to various utilities that do not fit in the other tools.
It can be seen as a small brother to branch (hence the name).
Twig works using subcommands, of which the following are available:
Tip
Twig assumes the acacia directory to exist at the current user's home (~/.acacia).
This behavior can be changed by using the --home <ACACIA_HOME> option to steer twig to another acacia directory.
Tip
Normally, twig will not print much information about the inner workings, this can be changed by the -v {0;1;2;3} flag, where increasing numbers increase the verbosity of the program.
The twig odb command has the following subcommands:
-
twig odb get: Get the contents of an object from the object database -
twig odb put: Put a new object into the object database -
twig odb pull: Pull objects from another object database
This subcommand facilitates retrieving object contents from the object database.
twig odb get [--output <FILE>] <OID>
Tip
By default, this command outputs the contents of the objects to STDOUT.
This behavior can be changed by using the --output <FILE> option.
This puts the contents of the object into <FILE>.
This subcommand facilitates inserting new objects into the object database.
twig odb put [--compression {none;xz}] [--force] <PATH>
Tip
Normally, twig checks for an already existing object in the database.
The --force flag will force twig to overwrite the existing object.
This subcommand allows a user to pull (fetch) objects from another object database into the current local one.
twig odb pull [OPTIONS] --other <OTHER> <OBJECT>Tip
Normally, twig will not fetch dependencies, but using the --recursive/-r this can be achieved