perldoc > Specio::Exception

man perldoc info pydoc3 ri search

📛 NAME

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

🚀 Quick Reference

Use Case	Command	Description
Catch a Specio exception	$_->isa('Specio::Exception')	Check if caught exception is a type constraint failure
Get error message	$exception->message	Retrieve the human-readable error message
Get failing type name	$exception->type->name	Name of the type constraint that failed
Get the invalid value	$exception->value	The actual value that failed validation
Full exception string	$exception->as_string	Message + stack trace as a string

🏷️ 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 AT urth.org>

©️ COPYRIGHT AND LICENSE

This software is Copyright (c) 2012 - 2021 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.

📛 NAME 🚀 Quick Reference 🏷️ VERSION 📋 SYNOPSIS 📖 DESCRIPTION 🛠️ API 🔄 OVERLOADING 🆘 SUPPORT 📂 SOURCE 👤 AUTHOR ©️ COPYRIGHT AND LICENSE