Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

moosex::meta::typeconstraint::structured5.18(3pm) [mojave man page]

MooseX::Meta::TypeConstraint::Structured(3pm)		User Contributed Perl Documentation	     MooseX::Meta::TypeConstraint::Structured(3pm)

NAME

       MooseX::Meta::TypeConstraint::Structured - Structured type constraints.

VERSION

       version 0.30

DESCRIPTION

       A structure is a set of Moose::Meta::TypeConstraint that are 'aggregated' in such a way as that they are all applied to an incoming list of
       arguments.  The idea here is that a Type Constraint could be something like, "An "Int" followed by an "Int" and then a "Str"" and that this
       could be done so with a declaration like:

	   Tuple[Int,Int,Str]; ## Example syntax

       So a structure is a list of type constraints (the "Int,Int,Str" in the above example) which are intended to function together.

ATTRIBUTES

   type_constraints
       A list of Moose::Meta::TypeConstraint objects.

   constraint_generator
METHODS

   validate
       Messing with validate so that we can support nicer error messages.

   generate_constraint_for ($type_constraints)
       Given some type constraints, use them to generate validation rules for an ref of values (to be passed at check time)

   parameterize (@type_constraints)
       Given a ref of type constraints, create a structured type.

   __infer_constraint_generator
   compile_type_constraint
       hook into compile_type_constraint so we can set the correct validation rules.

   create_child_type
       modifier to make sure we get the constraint_generator

   is_a_type_of
   is_subtype_of
   equals
       Override the base class behavior.

   type_constraints_equals
       Checks to see if the internal type constraints are equal.

   get_message
       Give you a better peek into what's causing the error.  For now we stringify the incoming deep value with Devel::PartialDump and pass that
       on to either your custom error message or the default one.  In the future we'll try to provide a more complete stack trace of the actual
       offending elements

       A subref or closure that contains the way we validate incoming values against a set of type constraints.

       This returns a CODEREF which generates a suitable constraint generator.	Not user servicable, you'll never call this directly.

SEE ALSO

       The following modules or resources may be of interest.

       Moose, Moose::Meta::TypeConstraint

AUTHORS

       o   John Napiorkowski <jjnapiork@cpan.org>

       o   Florian Ragwitz <rafl@debian.org>

       o   XXXX XXX'XX (Yuval Kogman) <nothingmuch@woobling.org>

       o   Tomas (t0m) Doran <bobtfish@bobtfish.net>

       o   Robert Sedlacek <rs@474.at>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2008 by John Napiorkowski.

       This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

perl v5.18.2							    2013-12-19			     MooseX::Meta::TypeConstraint::Structured(3pm)

Check Out this Related Man Page

MooseX::Meta::TypeConstraint::ForceCoercion(3pm)	User Contributed Perl Documentation	  MooseX::Meta::TypeConstraint::ForceCoercion(3pm)

NAME

       MooseX::Meta::TypeConstraint::ForceCoercion - Force coercion when validating type constraints

VERSION

       version 0.01

SYNOPSIS

	   use MooseX::Types:::Moose qw/Str Any/;
	   use Moose::Util::TypeConstraints;
	   use MooseX::Meta::TypeConstraint::ForceCoercion;

	   # get any type constraint
	   my $tc = Str;

	   # declare one or more coercions for it
	   coerce $tc,
	       from Any,
	       via { ... };

	   # wrap the $tc to force coercion
	   my $coercing_tc = MooseX::Meta::TypeConstraint::ForceCoercion->new(
	       type_constraint => $tc,
	   );

	   # check a value against new type constraint. this will run the type
	   # coercions for the wrapped type, even if the value already passes
	   # validation before coercion. it will fail if the value couldn't be
	   # coerced
	   $coercing_tc->check('Affe');

DESCRIPTION

       This class allows to wrap any "Moose::Meta::TypeConstraint" in a way that will force coercion of the value when checking or validating a
       value against it.

ATTRIBUTES

   type_constraint
       The type constraint to wrap. All methods except for "validate" and "check" are delegated to the value of this attribute.

METHODS

   check ($value)
       Same as "Moose::Meta::TypeConstraint::check", except it will always try to coerce $value before checking it against the actual type
       constraint. If coercing fails the check will fail, too.

   validate ($value, $coerced_ref?)
       Same as "Moose::Meta::TypeConstraint::validate", except it will always try to coerce $value before validating it against the actual type
       constraint. If coercing fails the validation will fail, too.

       If coercion was successful and a $coerced_ref references was passed, the coerced value will be stored in that.

AUTHOR

	 Florian Ragwitz <rafl@debian.org>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2009 by Florian Ragwitz.

       This is free software; you can redistribute it and/or modify it under the same terms as perl itself.

perl v5.10.0							    2009-04-13			  MooseX::Meta::TypeConstraint::ForceCoercion(3pm)
Man Page