Type::Tiny::Manual - an overview of Type::Tiny
Type::Tiny is a small class for writing type constraints, inspired by Moose's type constraint API. It has only one non-core dependency (and even that is simply a module that was previously distributed as part of Type::Tiny but has since been spun off), and can be used with Moose, Mouse and Moo (or none of the above).
Type::Tiny is bundled with Type::Library a framework for organizing type constraints into collections.
Also bundled is Types::Standard, a Moose-inspired library of useful type constraints.
Type::Params is also provided, to allow very fast checking and coercion of function and method parameters.
Type::Tiny requires at least Perl 5.6.1, though certain Unicode-related features (e.g. non-ASCII type constraint names) may work better in newer versions of Perl.
Type::Tiny requires Exporter::Tiny, a module that was previously bundled in this distribution, but has since been spun off as a separate distribution. Don't worry - it's quick and easy to install.
At run-time, Type::Tiny also requires the following modules: B, B::Deparse, Data::Dumper, Scalar::Util, Text::Balanced, base, mro, overload, strict and warnings. All of these come bundled with Perl itself. Prior to Perl 5.8, Scalar::Util and Text::Balanced do not come bundled with Perl and will need installing separately from the CPAN. Prior to Perl 5.10, Class::ISA is used instead of mro; this is bundled with Perl 5.8 and above, and available from CPAN for earlier versions of Perl.
Certain features require additional modules.
Tying a variable to a type constraint (e.g.
tie my $count,
Int) requires Type::Tie; stack traces on exceptions require Devel::StackTrace.
The Reply::Plugin::TypeTiny plugin for Reply requires Reply (obviously).
Devel::LexAlias may slightly increase the speed of some of Type::Tiny's compiled coderefs.
The test suite additionally requires Test::More,
Test::Fatal and Test::Requires.
Test::More comes bundled with Perl,
but if you are using a version of Perl older than 5.14,
you will need to upgrade to at least Test::More version 0.96.
Test::Requires and Test::Fatal (plus Try::Tiny which Test::Fatal depends on) are bundled with Type::Tiny in the
so you do not need to install them separately.
Perl 5.6.x support is not well tested; if it proves too burdensome to maintain, it may be dropped in a future release.
Type::Tiny is similar in aim to Specio. The major differences are
Type::Tiny is faster and supports coercions.
Scalar::Does is somewhat of a precursor to Type::Tiny, but has now been rewritten to use Type::Tiny internally.
It gives you a
$type) function that is roughly equivalent to
$type->check($value) except that
$type may be one of a list of pre-defined strings (instead of a Type::Tiny type constraint); or may be a package name in which case it will be assumed to be a role and checked with
The following stability policy is planned for Type::Tiny 1.000 and above. This milestone has not yet been reached.
Type::Tiny 1.000 is considered stable. Any changes to the API that are big enough to require changes to the test suite will be preceded by a six month notice period, with the following exceptions:
Please report any bugs to http://rt.cpan.org/Dist/Display.html?Queue=Type-Tiny.
IRC: support is available through in the #moose channel on irc.perl.org. If Type::Tiny discussion there becomes overwhelming (unlikely) then I'll move it to a separate channel.
Toby Inkster <email@example.com>.
This software is copyright (c) 2013 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.
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.