Test::More
==========

TAP Testing for Bash

<badge travis ingydotnet/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"

  output=( $(ls) )
  expected=(README lib bin)
  cmp-array output expected "list files"

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"`
* `cmp-array output expected "message"

More detailed info coming soon.

= Author

Ingy döt Net <ingy@ingy.net>

= Copyright & License

Copyright 2013-2020. Ingy döt Net.

The MIT License (MIT)
