-
-
31 Jul 2021 20:34:49 UTC
- Distribution: Type-Tiny
- Module version: 1.012004
- Source (raw)
- Browse (raw)
- Changes
- Homepage
- How to Contribute
- Repository
- Issues
- Testers (4154 / 3 / 6)
- Kwalitee
Bus factor: 1- 86.67% Coverage
- License: perl_5
- Perl: v5.6.1
- Activity
24 month- Tools
- Download (453.29KB)
- MetaCPAN Explorer
- Permissions
- Subscribe to distribution
- Permalinks
- This version
- Latest version
and 30 contributors-
Diab Jerius (DJERIUS)
-
Vyacheslav Matyukhin (MMCLERIC)
-
Peter Flanigan (PJFL)
- Pierre Masci
-
Mark Stosberg (MARKSTOS)
-
David Steinbrunner
-
Samuel Kaufman (SKAUFMAN)
-
Graham Knop (HAARG)
-
Peter Karman (KARMAN)
-
Alexander Hartmaier (ABRAXXA)
-
Dagfinn Ilmari Mannsåker (ILMARI)
-
Gianni Ceccarelli (DAKKAR)
-
Karen Etheridge (ETHER)
-
Thomas Sibley (TSIBLEY)
-
Peter Valdemar Mørch
-
Zoffix Znet
-
Denis Ibaev
-
Lucas Buchala (LSBUCHALA)
-
Alexandr Ciornii
-
Philippe Bruhat (BOOK)
-
Robert Rothenberg (RRWO)
- Nelo Onyiah
-
Jonas B Nielsen (JONASBN)
-
Benct Philip Jonsson
-
Hauke D (HAUKEX)
-
Meredith Howard (MHOWARD)
-
Andrew Ruder (AERUDER)
-
Sandor Patocs (SPATOCS)
- Windymelt
-
Lucas Tiago de Moraes (LUCAS)
- Dependencies
- Exporter::Tiny
- and possibly others
- Reverse dependencies
- CPAN Testers List
- Dependency graph
- NAME
- SYNOPSIS
- STATUS
- DESCRIPTION
- CAVEATS
- BUGS
- SEE ALSO
- AUTHOR
- COPYRIGHT AND LICENCE
- DISCLAIMER OF WARRANTIES
NAME
Error::TypeTiny - exceptions for Type::Tiny and friends
SYNOPSIS
use Data::Dumper; use Try::Tiny; use Types::Standard qw(Str); try { Str->assert_valid(undef); } catch { my $exception = shift; warn "Encountered Error: $exception"; warn Dumper($exception->explain) if $exception->isa("Error::TypeTiny::Assertion"); };
STATUS
This module is covered by the Type-Tiny stability policy.
DESCRIPTION
When Type::Tiny and its related modules encounter an error, they throw an exception object. These exception objects inherit from Error::TypeTiny.
Constructors
new(%attributes)
-
Moose-style constructor function.
throw(%attributes)
-
Constructs an exception and passes it to
die
.Automatically populates
context
andstack_trace
if appropriate.
Attributes
message
-
The error message.
context
-
Hashref containing the package, file and line that generated the error.
stack_trace
-
A more complete stack trace. This feature requires Devel::StackTrace; use the
$StackTrace
package variable to switch it on.
Methods
to_string
-
Returns the message, followed by the context if it is set.
Functions
Error::TypeTiny::croak($format, @args)
-
Functional-style shortcut to
throw
method. Takes ansprintf
-style format string and optional arguments to construct themessage
.
Overloading
Stringification is overloaded to call
to_string
.
Package Variables
%Error::TypeTiny::CarpInternal
-
Serves a similar purpose to
%Carp::CarpInternal
. $Error::TypeTiny::StackTrace
-
Boolean to toggle stack trace generation.
$Error::TypeTiny::LastError
-
A reference to the last exception object thrown.
CAVEATS
Although Error::TypeTiny objects are thrown for errors produced by Type::Tiny, that doesn't mean every time you use Type::Tiny you'll get Error::TypeTinys whenever you want.
For example, if you use a Type::Tiny type constraint in a Moose attribute, Moose will not call the constraint's
assert_valid
method (which throws an exception). Instead it will callcheck
andget_message
(which do not), and willconfess
an error message of its own. (The$LastError
package variable may save your bacon.)BUGS
Please report any bugs to https://github.com/tobyink/p5-type-tiny/issues.
SEE ALSO
Error::TypeTiny::Assertion, Error::TypeTiny::WrongNumberOfParameters.
Try::Tiny, Try::Tiny::ByClass.
AUTHOR
Toby Inkster <tobyink@cpan.org>.
COPYRIGHT AND LICENCE
This software is copyright (c) 2013-2014, 2017-2021 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
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.
Module Install Instructions
To install Type::Tiny, copy and paste the appropriate command in to your terminal.
cpanm Type::Tiny
perl -MCPAN -e shell install Type::Tiny
For more information on module installation, please visit the detailed CPAN module installation guide.