NAME

Catmandu::Fix::Has - helper class for creating Fix-es with (optional) parameters

SYNOPSIS

    package Catmandu::Fix::foo;
    use Moo;
    use Catmandu::Fix::Has;
    has greeting => (fix_arg => 1);   # required parameter 1
    has message  => (fix_arg => 1);   # required parameter 2
    has eol      => (fix_opt => 1 , default => sub {'!'} ); # optional parameter 'eol' with default '!'
    sub fix {
        my ($self,$data) = @_;
        print STDERR $self->greeting . ", " . $self->message . $self->eol . "\n";
        $data;
    }
    1;

PARAMETERS

fix_arg

Required argument when set to 1. The Fix containing the code fragment below needs two arguments.

    use Catmandu::Fix::Has;
    has message => (fix_arg => 1); # required parameter 1
    has number  => (fix_arg => 1); # required parameter 2
    

When the fix_arg is set to 'collect', then all arguments are read into an array. The Fix containing the code fragment below needs at least 1 or more arguments. All arguments will get collected into the "messages" array:

    use Catmandu::Fix::Has;
    has messages => (fix_arg => 'collect'); # required parameter
    

fix_opt

Optional named argument when set to 1. The Fix containing the code fragment below can have two optional arguments "message: ...", "number: ...":

    use Catmandu::Fix::Has;
    has message => (fix_opt => 1); # optional parameter 1
    has number  => (fix_opt => 1); # optional parameter 2
    

When the fix_opt is set to 'collect', then all optional argument are read into an array. The Fix containing the code fragment below needs at least 1 or more arguments. All arguments will get collected into the "options" array:

    use Catmandu::Fix::Has;
    has options => (fix_opt => 'collect'); # optional parameter
    

SEE ALSO

Catmandu::Fix