<!-- GENERATED by docs/sphinx/bin/20-reference (p5) from reference/bundled/Test2/Tools/Tiny.md. Do not edit. -->

```{index} single: Test2::Tools::Tiny
```

# Test2::Tools::Tiny

Tiny set of tools for unfortunate souls who cannot use
[Test2::Suite](../Suite.md).

## DESCRIPTION

You should really look at [Test2::Suite](../Suite.md). This package is some very basic
essential tools implemented using [Test2](../../Test2.md). This exists only so that [Test2](../../Test2.md)
and other tools required by [Test2::Suite](../Suite.md) can be tested. This is the package
[Test2](../../Test2.md) uses to test itself.

## USE Test2::Suite INSTEAD

Use [Test2::Suite](../Suite.md) if at all possible.

## EXPORTS

- ok($bool, $name)
- ok($bool, $name, @diag)

    Run a simple assertion.

- is($got, $want, $name)
- is($got, $want, $name, @diag)

    Assert that 2 strings are the same.

- isnt($got, $do\_not\_want, $name)
- isnt($got, $do\_not\_want, $name, @diag)

    Assert that 2 strings are not the same.

- like($got, $regex, $name)
- like($got, $regex, $name, @diag)

    Check that the input string matches the regex.

- unlike($got, $regex, $name)
- unlike($got, $regex, $name, @diag)

    Check that the input string does not match the regex.

- is\_deeply($got, $want, $name)
- is\_deeply($got, $want, $name, @diag)

    Check 2 data structures. Please note that this is a _DUMB_ implementation that
    compares the output of [Data::Dumper](../../Data/Dumper.md) against both structures.

- diag($msg)

    Issue a diagnostics message to STDERR.

- note($msg)

    Issue a diagnostics message to STDOUT.

- skip\_all($reason)

    Skip all tests.

- todo $reason => sub { ... }

    Run a block in TODO mode.

- plan($count)

    Set the plan.

- done\_testing()

    Set the plan to the current test count.

- $warnings = warnings { ... }

    Capture an arrayref of warnings from the block.

- $exception = exception { ... }

    Capture an exception.

- tests $name => sub { ... }

    Run a subtest.

- $output = capture { ... }

    Capture STDOUT and STDERR output.

    Result looks like this:

    ```perl
    {
        STDOUT => "...",
        STDERR => "...",
    }
    ```

## SOURCE

The source code repository for Test2 can be found at
[https://github.com/Test-More/test-more/](https://github.com/Test-More/test-more/).

## MAINTAINERS

- Chad Granum <exodist@cpan.org>

## AUTHORS

- Chad Granum <exodist@cpan.org>

## COPYRIGHT

Copyright Chad Granum <exodist@cpan.org>.

This program is free software; you can redistribute it and/or
modify it under the same terms as Perl itself.

See [https://dev.perl.org/licenses/](https://dev.perl.org/licenses/)