Test::TypeTiny(3) User Contributed Perl Documentation Test::TypeTiny(3)

# [NAME](#NAME)

Test::TypeTiny - useful functions for testing the efficacy of type constraints

# [SYNOPSIS](#SYNOPSIS)

```
   use strict;
   use warnings;
   use Test::More;
   use Test::TypeTiny;
   
   use Types::Mine qw(Integer Number);
   
   should_pass(1, Integer);
   should_pass(-1, Integer);
   should_pass(0, Integer);
   should_fail(2.5, Integer);
   
   ok_subtype(Number, Integer);
   
   done_testing;
```

# [STATUS](#STATUS)

This module is covered by the Type-Tiny stability policy.

# [DESCRIPTION](#DESCRIPTION)

Test::TypeTiny provides a few handy functions for testing type constraints.

## [Functions](#Functions)

"should\_pass($value, $type, $test\_name)"

"should\_pass($value, $type)"

Test that passes iff $value passes "$type->check".

"should\_fail($value, $type, $test\_name)"

"should\_fail($value, $type)"

Test that passes iff $value fails "$type->check".

"ok\_subtype($type, @subtypes)"

Test that passes iff all @subtypes are subtypes of $type.

"EXTENDED\_TESTING"

Exportable boolean constant.

[matchfor(@things)](#matchfor%28@things%29)

Assistant for matching exceptions. Not exported by default. See also Test::Fatal::matchfor.

# [ENVIRONMENT](#ENVIRONMENT)

If the "EXTENDED\_TESTING" environment variable is set to true, this module will promote each "should\_pass" or "should\_fail" test into a subtest block and test the type constraint in both an inlined and non-inlined manner.

This variable must be set at compile time (i.e. before this module is loaded).

# [BUGS](#BUGS)

Please report any bugs to <https://github.com/tobyink/p5-type-tiny/issues>.

# [SEE ALSO](#SEE_ALSO)

Type::Tiny.

For an alternative to "should\_pass", see Test::Deep::Type which will happily accept a Type::Tiny type constraint instead of a MooseX::Types one.

# [AUTHOR](#AUTHOR)

Toby Inkster <tobyink@cpan.org>.

# [COPYRIGHT AND LICENCE](#COPYRIGHT_AND_LICENCE)

This software is copyright (c) 2013-2014, 2017-2025 by Toby Inkster.

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

# [DISCLAIMER OF WARRANTIES](#DISCLAIMER_OF_WARRANTIES)

THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.

2026-10-26 perl v5.44.0

---

Document: Test::TypeTiny(3pm) from perl-type-tiny 2.010001-r5 (Chainguard OS)
Source: https://github.com/tobyink/p5-type-tiny