NAME

Class::Tiny::Immutable - Minimalist class construction, with read-only attributes

SYNOPSIS

In Person.pm:

package Person;

use Class::Tiny::Immutable qw( name );

1;

In Employee.pm:

package Employee;
use parent 'Person';

use Class::Tiny::Immutable qw( ssn ), {
  timestamp => sub { time }   # lazy attribute with default
};

1;

In example.pl:

use Employee;

my $obj = Employee->new; # dies, name and ssn attributes are required
my $obj = Employee->new( name => "Larry", ssn => "111-22-3333" );

my $name = $obj->name;
my $timestamp = $obj->timestamp;

# no attributes can be set
$obj->ssn("222-33-4444"); # dies
$obj->timestamp(time); # dies

DESCRIPTION

Class::Tiny::Immutable is a wrapper around Class::Tiny which makes the generated attributes read-only, and required to be set in the object constructor if they do not have a lazy default defined. In other words, attributes are either "lazy" or "required".

METHODS

In addition to methods inherited from Class::Tiny, Class::Tiny::Immutable defines the following additional introspection method:

get_all_required_attributes_for

my @required = Class::Tiny::Immutable->get_all_required_attributes_for($class);

Returns an unsorted list of required attributes known to Class::Tiny::Immutable for a class and its superclasses.

BUGS

Report any issues on the public bugtracker.

AUTHOR

Dan Book <dbook@cpan.org>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2017 by Dan Book.

This is free software, licensed under:

The Artistic License 2.0 (GPL Compatible)

SEE ALSO

Moo, MooseX::AttributeShortcuts