[gitmo/Moose.git] / lib / Moose / Manual / BestPractices.pod


=head1 RECOMMENDATIONS

=head2 No Moose and Immutabilize

We recommend that you end your Moose class definitions by removing the
Moose sugar and making your class immutable.

  package Person;

  use Moose;

  # extends, roles, attributes, etc.

  # methods

  no Moose;

  __PACKAGE__->meta->make_immutable;

  1;

=head2 Always call SUPER::BUILDARGS

=head2 No complex subs for a default, use a builder

builders can be inherited, show up more cleanly in profile

=head2 use default for simple scalar, and empty refs

=head2 use builder for everything else

don't use initializer

=head2 use lazy_build

keep builders private

consider keeping clearers & predicates private

consider keeping writers private

=head2 Think Twice Before Changing an Attribute's Type in a Subclass

=head2 use MX::AH instead of auto_deref

=head2 Namespace Your Types

and don't use "::"

=head2 Coercion Instead of Unions

=head2 Define All Your Types in One Module
Commit	Line	Data
fd8a7262	1
	2	=head1 RECOMMENDATIONS
	3
	4	=head2 No Moose and Immutabilize
	5
	6	We recommend that you end your Moose class definitions by removing the
	7	Moose sugar and making your class immutable.
	8
	9	package Person;
	10
	11	use Moose;
	12
	13	# extends, roles, attributes, etc.
	14
	15	# methods
	16
	17	no Moose;
	18
	19	__PACKAGE__->meta->make_immutable;
	20
	21	1;
	22
	23	=head2 Always call SUPER::BUILDARGS
	24
	25	=head2 No complex subs for a default, use a builder
	26
	27	builders can be inherited, show up more cleanly in profile
	28
	29	=head2 use default for simple scalar, and empty refs
	30
	31	=head2 use builder for everything else
	32
b6477964	33	don't use initializer
b6477964	34
fd8a7262	35	=head2 use lazy_build
	36
	37	keep builders private
	38
	39	consider keeping clearers & predicates private
	40
	41	consider keeping writers private
b6477964	42
541027c5	43	=head2 Think Twice Before Changing an Attribute's Type in a Subclass
541027c5	44
b6477964	45	=head2 use MX::AH instead of auto_deref
541027c5	46
	47	=head2 Namespace Your Types
	48
	49	and don't use "::"
	50
	51	=head2 Coercion Instead of Unions
	52
	53	=head2 Define All Your Types in One Module