Commit | Line | Data |
471c4f09 |
1 | |
2 | =pod |
3 | |
4 | =head1 NAME |
5 | |
6 | Moose::Cookbook - How to cook a Moose |
7 | |
8 | =head1 DESCRIPTION |
9 | |
4711f5f7 |
10 | The Moose cookbook is a series of recipes taken from the Moose |
471c4f09 |
11 | test suite. Each recipe presents some code, which demonstrates |
12 | some of the features of Moose, and then proceeds to explain the |
13 | details of the code. |
14 | |
734d1752 |
15 | We also provide a L<Moose::Cookbook::FAQ> and a L<Moose::Cookbook::WTF> |
16 | for common questions and problems people have with Moose. |
17 | |
471c4f09 |
18 | =head1 RECIPES |
19 | |
496b74ab |
20 | =head2 Basic Moose |
21 | |
471c4f09 |
22 | =over 4 |
23 | |
3824830b |
24 | =item L<Moose::Cookbook::Recipe1> - The (always classic) B<Point> example |
471c4f09 |
25 | |
f7f3648d |
26 | A simple Moose-based class. Demonstrated Moose attributes and subclassing. |
cb2478d4 |
27 | |
3824830b |
28 | =item L<Moose::Cookbook::Recipe2> - A simple B<BankAccount> example |
471c4f09 |
29 | |
f7f3648d |
30 | A slightly more complex Moose class. Demonstrates using a method |
31 | modifier in a subclass. |
cb2478d4 |
32 | |
3824830b |
33 | =item L<Moose::Cookbook::Recipe3> - A lazy B<BinaryTree> example |
471c4f09 |
34 | |
f7f3648d |
35 | Demonstrates several attribute features, including types, weak |
36 | references, predicates ("does this object have a foo?"), defaults, and |
37 | lazy attribute construction. |
cb2478d4 |
38 | |
3824830b |
39 | =item L<Moose::Cookbook::Recipe4> - Subtypes, and modeling a simple B<Company> class hierarchy |
471c4f09 |
40 | |
f7f3648d |
41 | Introduces the creation and use of custom types, a C<BUILD> method, |
42 | and the use of C<override> in a subclass. |
cb2478d4 |
43 | |
3824830b |
44 | =item L<Moose::Cookbook::Recipe5> - More subtypes, coercion in a B<Request> class |
471c4f09 |
45 | |
f7f3648d |
46 | More type examples, including the use of type coercions. |
cb2478d4 |
47 | |
496b74ab |
48 | =item L<Moose::Cookbook::Recipe6> - The augment/inner example |
49 | |
f7f3648d |
50 | Demonstrates the use of C<augment> method modifiers, a way of turning |
51 | the usual method overriding style "inside-out". |
cb2478d4 |
52 | |
5de2944f |
53 | =item L<Moose::Cookbook::Recipe7> - Making Moose fast with immutable |
496b74ab |
54 | |
5de2944f |
55 | Making a class immutable greatly increases the speed of accessors and |
56 | object construction. |
cb2478d4 |
57 | |
2be55428 |
58 | =item L<Moose::Cookbook::Recipe8> - Managing complex relations with trigger (TODO) |
496b74ab |
59 | |
cb2478d4 |
60 | I<abstract goes here> |
61 | |
2be55428 |
62 | Work off of this http://code2.0beta.co.uk/moose/svn/Moose/trunk/t/200_examples/007_Child_Parent_attr_inherit.t |
63 | |
ceb8945d |
64 | =item L<Moose::Cookbook::Recipe9> - Builder methods and lazy_build |
496b74ab |
65 | |
fbd7ad7a |
66 | The builder feature provides an inheritable and role-composable way to |
67 | provide a default attribute value. |
cb2478d4 |
68 | |
c2a0627f |
69 | =item L<Moose::Cookbook::Recipe12> - Create Humans and their Spawn |
70 | |
71 | Shows how operator overloading, coercion, and sub types can be used |
72 | to mimmick the human reproductive system (well, the selection of genes |
73 | at least). Assumes a basic understanding of Moose. |
74 | |
496b74ab |
75 | =back |
76 | |
77 | =head2 Moose Roles |
78 | |
79 | =over 4 |
80 | |
81 | =item L<Moose::Cookbook::Recipe10> - The Moose::Role example |
82 | |
f7f3648d |
83 | Demonstrates roles, which are also sometimes known as traits or |
84 | mix-ins. Roles provide a method of code re-use which is orthogonal to |
85 | subclassing. |
cb2478d4 |
86 | |
2e3d0a0a |
87 | =item L<Moose::Cookbook::Recipe11> - Advanced Role Composition - method exclusion and aliasing |
496b74ab |
88 | |
2e3d0a0a |
89 | Sometimes you just want to include part of a role in your |
90 | class. Sometimes you want the whole role but one if its methods |
91 | conflicts with one in your class. With method exclusion and aliasing, |
92 | you can work around these problems. |
cb2478d4 |
93 | |
104379bc |
94 | =item L<Moose::Cookbook::Recipe12> - Runtime Role Composition (TODO) |
95 | |
cb2478d4 |
96 | I<abstract goes here> |
97 | |
496b74ab |
98 | =back |
99 | |
100 | =head2 Meta Moose |
101 | |
102 | =over 4 |
103 | |
104 | =item L<Moose::Cookbook::Recipe20> - Welcome to the meta-world (TODO) |
105 | |
cb2478d4 |
106 | I<abstract goes here> |
107 | |
496b74ab |
108 | =item L<Moose::Cookbook::Recipe21> - The meta-attribute example |
109 | |
f7f3648d |
110 | One way to extend Moose is to provide your own attribute |
111 | metaclasses. Attribute metaclasses let you extend attribute |
112 | declarations (with C<has>) and behavior to provide additional |
113 | attribute functionality. |
cb2478d4 |
114 | |
aff0421c |
115 | =item L<Moose::Cookbook::Recipe22> - The meta-attribute trait example |
a7d0cd00 |
116 | |
aff0421c |
117 | Extending Moose's attribute metaclass is a great way to add |
118 | functionality. However, attributes can only have one metaclass. |
119 | Applying roles to the attribute metaclass lets you provide |
120 | composable attribute functionality. |
cb2478d4 |
121 | |
496b74ab |
122 | =item L<Moose::Cookbook::Recipe23> - The meta-instance example (TODO) |
24a8fe99 |
123 | |
cb2478d4 |
124 | I<abstract goes here> |
125 | |
496b74ab |
126 | =item L<Moose::Cookbook::Recipe24> - The meta-class example (TODO) |
1edfdf1c |
127 | |
cb2478d4 |
128 | I<abstract goes here> |
129 | |
130 | =back |
131 | |
132 | =head1 SNACKS |
133 | |
134 | =over 4 |
135 | |
136 | =item L<Moose::Cookbook::Snack::Types> |
137 | |
471c4f09 |
138 | =back |
139 | |
140 | =head1 SEE ALSO |
141 | |
142 | =over 4 |
143 | |
8bdc7f13 |
144 | =item L<http://www.gsph.com/index.php?Lang=En&ID=291> |
471c4f09 |
145 | |
146 | =back |
147 | |
148 | =head1 AUTHOR |
149 | |
150 | Stevan Little E<lt>stevan@iinteractive.comE<gt> |
151 | |
152 | =head1 COPYRIGHT AND LICENSE |
153 | |
778db3ac |
154 | Copyright 2006-2008 by Infinity Interactive, Inc. |
471c4f09 |
155 | |
156 | L<http://www.iinteractive.com> |
157 | |
158 | This library is free software; you can redistribute it and/or modify |
159 | it under the same terms as Perl itself. |
160 | |
f7f3648d |
161 | =cut |