/ 
MooseX-SetOnce-0.203
River stage three • 6 direct dependents • 731 total dependents
/ MooseX::SetOnce

NAME

MooseX::SetOnce - write-once, read-many attributes for Moose

VERSION

version 0.203

SYNOPSIS

Add the "SetOnce" trait to attributes:

package Class;
use Moose;
use MooseX::SetOnce;

has some_attr => (
  is     => 'rw',
  traits => [ qw(SetOnce) ],
);

...and then you can only set them once:

my $object = Class->new;

$object->some_attr(10);  # works fine
$object->some_attr(20);  # throws an exception: it's already set!

DESCRIPTION

The 'SetOnce' attribute lets your class have attributes that are not lazy and not set, but that cannot be altered once set.

The logic is very simple: if you try to alter the value of an attribute with the SetOnce trait, either by accessor or writer, and the attribute has a value, it will throw an exception.

If the attribute has a clearer, you may clear the attribute and set it again.

PERL VERSION

This library should run on perls released even a long time ago. It should work on any version of perl released in the last five years.

Although it may work on older versions of perl, no guarantee is made that the minimum required version will not be increased. The version may be increased for any reason, and there is no promise that patches will be accepted to lower the minimum required perl.

AUTHOR

Ricardo SIGNES <cpan@semiotic.systems>

CONTRIBUTORS

  • Jesse Luehrs <doy@tozt.net>

  • Karen Etheridge <ether@cpan.org>

  • Kent Fredric <kentfredric@gmail.com>

  • Ricardo Signes <rjbs@semiotic.systems>

COPYRIGHT AND LICENSE

This software is copyright (c) 2022 by Ricardo SIGNES.

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