MooseX::Has::Options - Succinct options for Moose

       Peter Shangov <pshangov@yahoo.com>

       This software is copyright (c) 2012 by Peter Shangov.

       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.36.0                                       2022-12-12                          MooseX::Has::Options(3pm)

       Previous versions of "MooseX::Has::Params" allowed you to specify during import the name of the  function
       too hook into, like so:

           use HTML::FormHandler::Moose;
           use MooseX::Has::Options qw(has_field);

           has_field 'name' => (
               qw(:required),
               type => 'Text',
           );

       This  behaviour  is deprecated as of version 0.003 as this syntax is now used for specifying handlers. If
       you need to hook into a different function see the implementation of "MooseX::Has::Options::import()" and
       "MooseX::Has::Options::import_into()".

       This module provides a succinct syntax for declaring options for Moose attributes.

       "MooseX::Has::Options"  hijacks  the  "has"  function  imported  by  Moose  and replaces it with one that
       understands the options syntax described above.  This  is  not  an  optimal  solution,  but  the  current
       implementation  of  "Moose::Meta::Attribute"  prevents  this  functionality from being provided as a meta
       trait.

       MooseX::Has::Options - Succinct options for Moose

       •   MooseX::Has::Sugar

           use Moose;
           use MooseX::Has::Options;

           has 'some_attribute' => (
               qw(:ro :required),
               isa => 'Str',
               ...
           );

           has 'another_attribute' => (
               qw(:ro :lazy_build),
               isa => 'Str',
               ...
           );

Declaringoptions
       "MooseX::Has::Params" works by checking the arguments to "has" for strings that look like options, i.e.
       alphanumeric strings preceded by a colon, and replaces them with a hash whose keys are the names of the
       options (sans the colon) and the values are 1's. Thus,

           has 'some_attribute', ':required';

       becomes:

           has 'some_attribute', required => 1;

       Options must come in the beginning of the argument list. MooseX::Has::Options will stop searching for
       options after the first alphanumeric string that does not start with a colon.

       The default behaviour can be customised per attribute. For example, here is how "ro", "rw" and "bare"
       work:

           has 'some_attribute', ':ro';

       becomes:

           has 'some_attribute', is => 'ro';

       See below for details.

   Handlers
       "MooseX::Has::Options" allows you to expand specific 'shortcut' arguments to arbitrary values via the
       handler interface. A 'handler' is a module in the MooseX::Has::Options::Handler namespace that provides a
       "handler" function. The handler function should return a hash whose keys are shortcut names, and the
       values are hashrefs with the values that the respective shortcuts should be expanded to. In order to
       enable the shortcuts supplied by a given handler you need to add it in the import statement:

           use MooseX::Has::Options qw(NativeTypes);

           has 'some_attribute', qw(:ro :hash), default => sub {{ foo => bar }};

       The following handlers ship with the default distribution:

       •   MooseX::Has::Options::Handler::Accessors (included by default when you import this module)

       •   MooseX::Has::Options::Handler::NativeTypes

       •   MooseX::Has::Options::Handler::NoInit

       version 0.003