NAME
Data::Object::Class::Syntax - DSL for Declaring Classes for Perl 5
VERSION
version 0.33
SYNOPSIS
package Person;
use Data::Object::Class;
use Data::Object::Class::Syntax;
has firstname => is required, ro;
has lastname => is required, ro;
has address1 => is required, rw;
has address2 => is optional, rw;
has ['city', 'state', 'zip'] => is required, rw;
def city => 'San Franscisco';
def state => 'CA';
has telephone => is optional, rw;
has occupation => is optional, rw, default 'Unassigned';
1;DESCRIPTION
Data::Object::Class::Syntax exports a collection of functions that provide a DSL (syntactic sugar) for declaring and describing Data::Object::Class classes.
FUNCTIONS
alt
alt attr => (is => 'ro');
# equivalent to
has '+attr' => (..., is => 'ro');The alt function alters the preexisting attribute definition for the attribute specified.
builder
builder;
builder '_build_attr';
# equivalent to
has attr => ..., builder => '_build_attr';The builder function returns a list suitable for configuring the builder portion of the attribute declaration.
clearer
clearer;
clearer '_clear_attr';
# equivalent to
has attr => ..., clearer => '_clean_attr';The clearer function returns a list suitable for configuring the clearer portion of the attribute declaration.
coerce
coerce;
# equivalent to
has attr => ..., coerce => 1;The coerce function return a list suitable for configuring the coerce portion of the attribute declaration.
def
def attr => sub { 1 };
# equivalent to
has '+attr' => (..., default => sub { 1 });The def function alters the preexisting attribute definition setting and/or overriding the default value property.
default
default sub { ... };
# equivalent to
has attr => ..., default => sub { ... };The default function returns a list suitable for configuring the default portion of the attribute declaration.
handles
handles { ... };
# equivalent to
has attr => ..., handles => { ... };The handles function returns a list suitable for configuring the handles portion of the attribute declaration.
init_arg
init_arg;
init_arg 'altattr';
# equivalent to
has attr => ..., init_arg => 'altattr';The init_arg function returns a list suitable for configuring the init_arg portion of the attribute declaration.
is
is;The is function returns a list from a list, and acts merely as a pass-through, for the purpose of being a visual/descriptive aid.
isa
isa sub { ... };
# equivalent to
has attr => ..., isa => sub { ... };The isa function returns a list suitable for configuring the isa portion of the attribute declaration.
lazy
lazy;
# equivalent to
has attr => ..., lazy => 1;The lazy function returns a list suitable for configuring the lazy portion of the attribute declaration.
optional
optional;
# equivalent to
has attr => ..., required => 0;The optional function returns a list suitable for configuring the required portion of the attribute declaration.
predicate
predicate;
predicate '_has_attr';
# equivalent to
has attr => ..., predicate => '_has_attr';The predicate function returns a list suitable for configuring the predicate portion of the attribute declaration.
reader
reader;
reader '_get_attr';
# equivalent to
has attr => ..., reader => '_get_attr';The reader function returns a list suitable for configuring the reader portion of the attribute declaration.
required
required;
# equivalent to
has attr => ..., required => 1;The required function returns a list suitable for configuring the required portion of the attribute declaration.
ro
ro;
# equivalent to
has attr => ..., is => 'ro';The ro function returns a list suitable for configuring the is portion of the attribute declaration.
rw
rw;
# equivalent to
has attr => ..., is => 'rw';The rw function returns a list suitable for configuring the rw portion of the attribute declaration.
trigger
trigger;
trigger '_trigger_attr';
# equivalent to
has attr => ..., trigger => '_trigger_attr';The trigger function returns a list suitable for configuring the trigger portion of the attribute declaration.
weak_ref
weak_ref;
# equivalent to
has attr => ..., weak_ref => 1;The weak_ref function returns a list suitable for configuring the weak_ref portion of the attribute declaration.
writer
writer;
writer '_set_attr';
# equivalent to
has attr => ..., writer => '_set_attr';The writer function returns a list suitable for configuring the writer portion of the attribute declaration.
SEE ALSO
AUTHOR
Al Newkirk <anewkirk@ana.io>
COPYRIGHT AND LICENSE
This software is copyright (c) 2014 by Al Newkirk.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.