Tapper - turn your bash scripts into TAP test scripts (with optional Tapper support)
Shell
Switch branches/tags
Nothing to show
Pull request Compare This branch is 232 commits ahead of gnu-user:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
bash-test-utils.hooks/tapper
examples
LICENSE
README.md
autoreport-manual.md
autoreport-selftest
autoreport-utils
bash-test-utils
bash-test-utils.md
bash-test-utils.txt
cpb-disable-naive.sh
example-01-most-simple-use.sh
example-02-single-test.sh
example-03-meta-only.sh
example-04-skip-all.sh
tapper-autoreport

README.md

tapper-autoreport

ABOUT

tapper-autoreport is a "bash include file" you can add ("source") at the end of your own bash script.

It then magically turns your bash script into a "Tapper test suite".

It also allows your bash script to be executed locally via the prove command, a standard tool to run test scripts that produce TAP output ("Test Anything Protocol") -- without requiring an actual Tapper framework.

Due to that and no other external dependecies it's a good starting point to write actual function tests that are reusable.

It collects meta information from system, reports test results and can upload logs and other files over network to a Tapper server.

SYNOPSIS

An autoreport based script

 #! /bin/bash
 . /tapper-autoreport --import-utils
 # your own stuff here ...
 . /tapper-autoreport

Run via 'prove' (a standard test utility)

The tool prove is a standard tool available in every Linux distribution. This executes the script locally and reports success:

 $ prove ./trivial-example-1.sh
 ./trivial-example-1.sh .. ok
 All tests successful.
 Files=1, Tests=5, 20 wallclock secs
 Result: PASS

Run directly to report to Tapper

This runs the test script which then sends test report to a Tapper server:

 $ ./trivial-example-1.sh
 # http://tapper/tapper/reports/id/129218
 # - upload ./trivial-example-1.sh ...
 # - upload /boot/config-2.6.32-22-generic ...
 # - upload /proc/cpuinfo ...
 # - upload /proc/devices ...
 # - upload /proc/version ...

More info

For more info please read autoreport manual.