No description, website, or topics provided.
Shell Other Makefile
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
doc
ext
lib/test
man/man3
test
.travis.yml
Changes
License
Makefile
Meta
ReadMe.pod

ReadMe.pod

Name

Test::More - TAP Testing for Bash

test-more-bash

Synopsis

Write a test file like this. Maybe call it test/test.t:

#!/usr/bin/env bash

TEST_MORE_PATH="/path/to/test-more-bash"
BASHLIB="`
    find $TEST_MORE_PATH -type d |
    grep -E '/(bin|lib)$' |
    xargs -n1 printf "%s:"`"
PATH="$BASHLIB$PATH"

source bash+ :std

use Test::More

plan tests 8

some-command
ok $? 'some-command is ok'

# or:
ok "`some-command`" 'some-command is ok'

pass 'This will always pass'

fail 'This will always fail'

is `echo foo` 'foo' 'foo is foo'

isnt foo bar "foo isn't bar"

like food foo 'food is like foo'

unlike team I "There's no 'I' in 'team'"

diag "A message for stderr"

note "A message for stdout"

Run the test with prove like this:

prove test/test.t

Prove knows it's Bash from the first line (the hashbang), and it just works.

Description

Test::More is the tried and true testing library for Perl. It uses TAP (the Test Anything Protocol). This is the same thing for Bash. For the most part it should work exactly the same.

Methods

This is the basic usage:

  • plan tests $count

  • ok $status_code "$label"

  • pass "$label"

  • fail "$label"

  • is "$got" "$want" "label"

  • isnt "$got" "$unwanted" "$label"

  • like "$got" "$regex" "$label"

  • unlike "$got" "$regex" "$label"

  • diag "$message"

  • note "$message"

  • done_testing $count

  • plan skip_all "$reason"

  • BAIL_OUT "$reason"

More detailed info coming soon.

Author

Ingy döt Net <ingy@bpan.org>

Copyright & License

Copyright 2013-2016. Ingy döt Net.

The MIT License (MIT)