NAME

Specio::Exception - A Throwable::Error subclass for type constraint failures

VERSION

version 0.40

SYNOPSIS

  use Try::Tiny;

  try {
      $type->validate_or_die($value);
  }
  catch {
      if ( $_->isa('Specio::Exception') ) {
          print $_->message, "\n";
          print $_->type->name, "\n";
          print $_->value, "\n";
      }
  };

DESCRIPTION

This exception class is thrown by Specio when a type check fails. It emulates the Throwable::Error API, but doesn't use that module to avoid adding a dependency on Moo.

API

This class provides the following methods:

$exception->message

The error message associated with the exception.

$exception->stack_trace

A Devel::StackTrace object for the exception.

$exception->type

The type constraint object against which the value failed.

$exception->value

The value that failed the type check.

$exception->as_string

The exception as a string. This includes the method and the stack trace.

OVERLOADING

This class overloads stringification to call the as_string method.

SUPPORT

Bugs may be submitted at https://github.com/houseabsolute/Specio/issues.

I am also usually active on IRC as 'autarch' on irc://irc.perl.org.

SOURCE

The source code repository for Specio can be found at https://github.com/houseabsolute/Specio.

AUTHOR

Dave Rolsky <autarch@urth.org>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2012 - 2017 by Dave Rolsky.

This is free software, licensed under:

  The Artistic License 2.0 (GPL Compatible)

The full text of the license can be found in the LICENSE file included with this distribution.

cpanm Specio

perl -MCPAN -e shell
install Specio