Boxer is a tool that creates archive files based on instructions provided in a boxerfile. Uses CMake and Ninja for its build system.
Boxer is a tool that creates archive files based on instructions provided in a boxerfile. It uses CMake and Ninja for its build system.
Building:
To build Boxer, use CMake and Ninja. For the first time setup, run:
cmake -B build -GNinja
ninja -C build
For subsequent compilations:
ninja -C build
Commands:
Boxer uses a boxerfile to define archiving operations with the following commands:
ARCHIVE_NAME [NAME]: Sets the name of the archive, appending.tar.gz.ADD_DIR [AS <OUTPUT_DIR>]: Adds a directory to the archive, optionally renaming it.ADD_FILE [AS <OUTPUT_FILENAME>]: Adds a file to the archive, optionally renaming it.ADD_FILE_MATCHING <REGEX> IN <DIR> GET <OPTION> [AS <OUTPUT_FILENAME>] TO <DEST_DIR>: Adds files matching a regular expression.<REGEX>: Regular expression to match files.<DIR>: Directory to search in.<OPTION>: Specifies which matching files to add (ALL,LATEST,FIRST,LAST).<DEST_DIR>: Destination directory within the archive.<OUTPUT_FILENAME>: Optional, renames the matched file.
Warnings:
Users should be cautious of leading / in archive filenames (when using AS).
Tests:
Example boxerfiles are located in the test-files directory. To run tests, execute:
build/boxer -f test-files/.boxerfile