=pod

=for comment
DO NOT EDIT. This Pod was generated by Swim v0.1.48.
See http://github.com/ingydotnet/swim-pm#readme

=encoding utf8

=head1 Name

Test::More - TAP Testing for Bash

=for html
<a href="https://travis-ci.org/ingydotnet/test-more-bash"><img src="https://travis-ci.org/ingydotnet/test-more-bash.png" alt="test-more-bash"></a>

=head1 Synopsis

Write a test file like this. Maybe call it C<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 C<prove> like this:

    prove test/test.t

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

=head1 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.

=head1 Methods

This is the basic usage:

=over

=item * C<plan tests $count>

=item * C<ok $status_code "$label">

=item * C<pass "$label">

=item * C<fail "$label">

=item * C<is "$got" "$want" "label">

=item * C<isnt "$got" "$unwanted" "$label">

=item * C<like "$got" "$regex" "$label">

=item * C<unlike "$got" "$regex" "$label">

=item * C<diag "$message">

=item * C<note "$message">

=item * C<done_testing $count>

=item * C<plan skip_all "$reason">

=item * C<BAIL_OUT "$reason">

=item * `cmp-array output expected "message"

=back

More detailed info coming soon.

=head1 Author

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

=head1 Copyright & License

Copyright 2013-2020. Ingy döt Net.

The MIT License (MIT)

=cut
