Specio::Exception

Section: User Contributed Perl Documentation (3)
Updated: 2021-01-31
Page Index

NAME

Specio::Exception - An exception class for type constraint failures

VERSION

version 0.47

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 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.