Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tapper/Tapper-autoreport
Tapper - turn your bash scripts into TAP test scripts (with optional Tapper support)
https://github.com/tapper/Tapper-autoreport
Last synced: about 1 month ago
JSON representation
Tapper - turn your bash scripts into TAP test scripts (with optional Tapper support)
- Host: GitHub
- URL: https://github.com/tapper/Tapper-autoreport
- Owner: tapper
- License: bsd-2-clause
- Fork: true (gnu-user/Tapper-autoreport)
- Created: 2012-10-25T09:39:45.000Z (almost 12 years ago)
- Default Branch: master
- Last Pushed: 2015-12-18T12:49:01.000Z (almost 9 years ago)
- Last Synced: 2024-06-10T23:09:13.918Z (3 months ago)
- Language: Shell
- Homepage: http://tapper.github.com/Tapper
- Size: 184 KB
- Stars: 9
- Watchers: 5
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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](http://github.com/tapper/Tapper-Reports-Receiver).
## SYNOPSIS
### An autoreport based script
```bash
#! /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:
```bash
$ 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:
```bash
$ ./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](https://github.com/tapper/Tapper-autoreport/blob/master/autoreport-manual.md).