Skip to content

csdb/Tapper-autoreport

 
 

Repository files navigation

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 an "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 [https://github.com/amd/Tapper-autoreport/blob/master/autoreport-manual.md](autoreport manual).

About

Tapper - turn your bash scripts into Tapper test scripts

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Shell 100.0%