/ 
ObjectTools-1
/ Object::new

NAME

Object::new - Pragma to implement constructor methods

VERSION 1.0

Included in ObjectTools 1.0 distribution.

SYNOPSIS

Class

package MyClass ;

# implement constructor without options
use Object::new ;

# this will be called by default if defined
sub _init
{
  my ($s, @args) = @_
  ....
}

# with options
use Object::new  name  => 'new_object'
                 init  => [ qw( init1 init2 ) ] ;

Usage

my $object = MyClass->new(digits => '123');

DESCRIPTION

This pragma easily implements lvalue constructor methods for your class.

You can completely avoid to write the constructor by just using it and eventually declaring the name and the init methods to call.

INSTALLATION

Prerequisites
Perl version >= 5.6.1
CPAN
perl -MCPAN -e 'install ObjectTools'
Standard installation

From the directory where this file is located, type:

perl Makefile.PL
make
make test
make install

OPTIONS

name

The name of the constructor method. If you omit this option the 'new' name will be used by default.

init

use this option if you want to call other method in your class to further initialize the object. You can group method by passing a reference to an array containing the methods names.

After the assignation and validation of the properties, the initialization methods in the init option will be called. Each init method will receive the blessed object passed in $_[0] and the other (original) parameter in the remaining @_.

BUGS

None known, but the module is not completely tested.

CREDITS

Thanks to Juerd Waalboer (http://search.cpan.org/author/JUERD) that with its Attribute::Property inspired the creation of this distribution.