The Perl Advent Calendar needs more articles for 2022. Submit your idea today!

NAME

Data::Object::Role::Buildable

ABSTRACT

Buildable Role for Perl 5

SYNOPSIS

package Vehicle;

use Moo;

with 'Data::Object::Role::Buildable';

has name => (
  is => 'rw'
);

1;

DESCRIPTION

This package provides methods for hooking into object construction of the consuming class, e.g. handling single-arg object construction.

SCENARIOS

This package supports the following scenarios:

buildarg

package Car;

use Moo;

extends 'Vehicle';

sub build_arg {
  my ($class, $name) = @_;

  # do something with $name or $class ...

  return { name => $name };
}

package main;

my $car = Car->new('tesla');

This package supports handling a build_arg method, as a hook into object construction, which is called and passed a single argument if a single argument is passed to the constructor.

buildargs

package Sedan;

use Moo;

extends 'Car';

sub build_args {
  my ($class, $args) = @_;

  # do something with $args or $class ...

  $args->{name} = ucfirst $args->{name};

  return $args;
}

package main;

my $sedan = Sedan->new('tesla');

This package supports handling a build_args method, as a hook into object construction, which is called and passed a hashref during object construction.

buildself

package Taxicab;

use Moo;

extends 'Sedan';

sub build_self {
  my ($self, $args) = @_;

  # do something with $self or $args ...

  $args->{name} = 'Toyota';

  return;
}

package main;

my $taxicab = Taxicab->new('tesla');

This package supports handling a build_self method, as a hook into object construction, which is called and passed a hashref during object construction. Note: Manipulating the arguments doesn't effect object's construction or properties.

AUTHOR

Al Newkirk, awncorp@cpan.org

LICENSE

Copyright (C) 2011-2019, Al Newkirk, et al.

This is free software; you can redistribute it and/or modify it under the terms of the The Apache License, Version 2.0, as elucidated in the "license file".

PROJECT

Wiki

Project

Initiatives

Milestones

Contributing

Issues