NAME

Data::Object::Role

ABSTRACT

Role Builder for Perl 5

SYNOPSIS

  package Identity;

  use Data::Object::Role;

  package Example;

  use Moo;

  with 'Identity';

  package main;

  my $example = Example->new;

DESCRIPTION

This package modifies the consuming package making it a role.

INHERITS

This package inherits behaviors from:

Moo

SCENARIOS

This package supports the following scenarios:

has

  package HasIdentity;

  use Data::Object::Role;

  has id => (
    is => 'ro'
  );

  package HasExample;

  use Moo;

  with 'HasIdentity';

  package main;

  my $example = HasExample->new;

This package supports the "has" keyword, which is used to declare role attributes, which can be accessed and assigned to using the built-in getter/setter or by the object constructor. See Moo for more information.

requires

  package EntityRequires;

  use Data::Object::Role;

  requires 'execute';

  package RequiresExample;

  use Moo;

  with 'EntityRequires';

  sub execute {

    # does something ...
  }

  package main;

  my $example = RequiresExample->new;

This package supports the "requires" keyword, which is used to declare methods which must exist in the consuming package. See Moo for more information.

with

  package WithEntity;

  use Data::Object::Role;

  package WithIdentity;

  use Data::Object::Role;

  with 'WithEntity';

  package WithExample;

  use Moo;

  with 'WithIdentity';

  package main;

  my $example = WithExample->new;

This package supports the "with" keyword, which is used to declare roles to be used and compose into your role. See Moo for more information.

AUTHOR

Al Newkirk, "awncorp@cpan.org"

LICENSE

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" <https://github.com/iamalnewkirk/data-object-role/blob/master/LICENSE>.

PROJECT

Wiki <https://github.com/iamalnewkirk/data-object-role/wiki>

Project <https://github.com/iamalnewkirk/data-object-role>

Initiatives <https://github.com/iamalnewkirk/data-object-role/projects>

Milestones <https://github.com/iamalnewkirk/data-object-role/milestones>

Contributing <https://github.com/iamalnewkirk/data-object-role/blob/master/CONTRIBUTE.md>

Issues <https://github.com/iamalnewkirk/data-object-role/issues>