Skip to content

internetguru/butt

Repository files navigation

NAME

Bash Unit Testing Tool

SYNOPSIS

butt [-hlsvVw] [--color[=WHEN]] FILE

DESCRIPTION

Bash Unit Testing Tool runs and evaluates a set of commands according to expected results. It can serve as a CI testing component of Bash scrip development.

The 'butt' command is an alternative to the 'bats' command, offering the following improvements:

  • Predefined comparison (assert) functions
  • Distinguish standard and error output
  • Verbose mode
  • Advanced user functions

OPTIONS

--color[=WHEN], --colour[=WHEN]

Use markers to highlight command status; WHEN is 'always', 'never', or 'auto'.

-h, --help

Print help.

-l NUM, --limit=NUM

Limit the number of running tests.

-s NUM, --skip=NUM

Skip the number of tests.

-v, --verbose

Verbose mode.

-V, --version

Print version number.

-w PATH, --working-dir=PATH

Run tests in specific PATH (and do not remove it).

INSTALLATION

From a dist package

./install, resp. ./uninstall

Tip: Specify destination directories

E.g. MANPATH=/usr/share/man/man1 ./install

From the source

./configure && make && compiled/install

Make dist package from source

./configure && make dist

Tip: Specify variables

E.g. ./configure && PREFIX=/usr SYSTEM=babun make dist

Tip: Install rst2man

apt-get install python-docutils or pip install docutils

HISTORY

Actual version

see the VERSION file

Actual changes

see the CHANGELOG file

EXIT CODES

0

No problems occurred.

1

Generic error code.

2

Parse or invalid option error.

REPOSITORY

Bash Unit Testing Tool

REPORTING BUGS

Issue tracker

AUTHOR

Written by Pavel Petrzela and George J. Pavelka.

COPYRIGHT

Copyright © 2016 Internet Guru

License GPLv3+: GNU GPL version 3 or later

This is free software: you are free to change and redistribute it.

There is NO WARRANTY, to the extent permitted by law.

DONATION

If you find this script useful, please consider making a donation to support its developers. We appreciate any contributions, no matter how small. Donations help us to dedicate more time and resources to this project, including covering our infrastructure expenses.

PayPal Donation

Please note that we are not a tax-exempt organization and cannot provide tax deductions for your donation. However, for donations exceeding $500, we would like to acknowledge your contribution on project's page and in this file (including the man page).

Thank you for your continued support!

HONORED DONORS

Czech Technical University in Prague