Final change log updates before 0.60. Just cleaning up some existing text.
[gitmo/Moose.git] / Changes
1 Revision history for Perl extension Moose
2
3 0.60 Fri October 25, 2008
4     * Moose::Exporter
5       - Passing "-traits" when loading Moose caused the Moose.pm
6         exports to be broken. Reported by t0m. (Dave Rolsky)
7         - Tests for this bug. (t0m)
8     
9     * Moose::Util
10       - Change resolve_metaclass alias to use the new
11         load_first_existing_class function. This makes it a lot
12         simpler, and also around 5 times faster. (t0m)
13       - Add caching to resolve_metaclass_alias, which gives an order
14         of magnitude speedup to things which repeatedly call the
15         Moose::Meta::Attribute->does method, notably MooseX::Storage
16         (t0m)
17
18     * Moose::Exporter
19       - Passing "-traits" when loading Moose caused the Moose.pm
20         exports to be broken. Reported by t0m. (Dave Rolsky)
21         - Tests for this bug. (t0m)
22
23     * Moose::Util::TypeConstraint
24       - Put back the changes for parameterized constraints that
25         shouldn't have been removed in 0.59. We still cannot parse
26         them, but MooseX modules can create them in some other
27         way. See the 0.58 changes for more details. (jnapiorkowski)
28       - Changed the way subtypes are created so that the job is
29         delegated to a type constraint parent.  This clears up some
30         hardcoded checking and should allow correct subtypes of
31         Moose::Meta::Type::Constraint. Don't rely on this new API too
32         much (create_child_type) because it may go away in the
33         future. (jnapiorkowski)
34
35     * Moose::Meta::TypeConstraint::Union
36       - Type constraint names are sorted as strings, not numbers.
37         (jnapiorkowski)
38       
39     * Moose::Meta::TypeConstraint::Parameterizable
40       - New parameterize method. This can be used as a factory method
41         to make a new type constraint with a given parameterized
42         type. (jnapiorkowski)
43         - added tests (jnapiorkowski)
44
45 0.59 Tue October 14, 2008
46     * Moose
47       - Add abridged documentation for builder/default/initializer/
48         predicate, and link to more details sections in 
49         Class::MOP::Attribute. (t0m)
50
51     * Moose::Util::TypeConstraints
52       - removed prototypes from all but the &-based stuff (mst)
53
54     * Moose::Util::TypeConstraints
55       - Creating a anonymous subtype with both a constraint and a
56         message failed with a very unhelpful error, but should just
57         work. Reported by t0m. (Dave Rolsky)
58
59     * Tests
60       - Some tests that used Test::Warn if it was available failed
61         with older versions of Test::Warn. Reported by Fayland. (Dave
62         Rolsky)
63       - Test firing behavior of triggers in relation to builder/default/
64         lazy_build. (t0m)
65       - Test behavior of equals/is_a_type_of/is_a_subtype_of for all
66         kinds of supported type. (t0m)
67
68     * Moose::Meta::Class
69       - In create(), do not pass "roles" option to the superclass
70         - added related test that creates an anon metaclass with
71           a required attribute
72
73     * Moose::Meta::TypeConstraint::Class
74     * Moose::Meta::TypeConstraint::Role
75       - Unify behavior of equals/is_a_type_of/is_a_subtype_of with
76         other types (as per change in 0.55_02). (t0m)
77
78     * Moose::Meta::TypeConstraint::Registry
79       - Fix warning when dealing with unknown type names (t0m)
80
81     * Moose::Util::TypeConstraints
82       - Reverted changes from 0.58 related to handle parameterized
83         types. This caused random failures on BSD and Win32 systems,
84         apparently related to the regex engine. This means that Moose
85         can no longer parse structured type constraints like
86         ArrayRef[Int,Int] or HashRef[name=>Str]. This will be
87         supported in a slightly different way via MooseX::Types some
88         time in the future. (Dave Rolsky)
89
90 0.58 Sat September 20, 2008
91     !! This release has an incompatible change regarding !!
92     !! how roles add methods to a class !!
93
94     * Roles and role application
95       ! Roles now add methods by calling add_method, not
96         alias_method. They make sure to always provide a method
97         object, which will be cloned internally. This means that it is
98         now possible to track the source of a method provided by a
99         role, and even follow its history through intermediate roles.
100
101         This means that methods added by a role now show up when
102         looking at a class's method list/map. (Dave Rolsky)
103
104     * Makefile.PL
105       - From this release on, we'll try to maintain a list of
106         conflicting modules, and warn you if you have one
107         installed. For example, this release conflicts with ...
108         - MooseX::Singleton        <= 0.11
109         - MooseX::Params::Validate <= 0.05
110         - Fey::ORM                 <= 0.10
111
112         In general, we try to not break backwards compatibility for
113         most Moose users, but MooseX modules and other code which
114         extends Moose's metaclasses is often affected by very small
115         changes in the Moose internals.
116
117     * Moose::Meta::Method::Delegation
118     * Moose::Meta::Attribute
119       - Delegation methods now have their own method class. (Dave
120         Rolsky)
121
122     * Moose::Meta::TypeConstraint::Parameterizable
123       - Added a new method 'parameterize' which is basically a factory
124         for the containing constraint.  This makes it easier to create
125         new types of parameterized constraints. (jnapiorkowski)
126
127     * Moose::Meta::TypeConstraint::Union
128       - Changed the way Union types canonicalize their names to follow
129         the normalized TC naming rules, which means we strip all
130         whitespace. (jnapiorkowski)
131
132     * Moose::Util::TypeConstraints
133       - Parameter and Union args are now sorted, this makes Int|Str
134         the same constraint as Str|Int. (jnapiorkowski)
135       - Changes to the way Union types are parsed to more correctly
136         stringify their names. (jnapiorkowski)
137       - When creating a parameterized type, we now use the new
138         parameterize method. (jnapiorkowski)
139       - Incoming type constraint strings are now normalized to remove
140         all whitespace differences. (jnapiorkowski)
141       - Changed the way we parse type constraint strings so that we now
142         match TC[Int,Int,...] and TC[name=>Str] as parameterized type
143         constraints.  This lays the foundation for more flexible type
144         constraint implementations.
145
146     * Tests and docs for all the above. (jnapiorkowski)
147
148     * Moose::Exporter
149     * Moose
150       - Moose::Exporter will no longer remove a subroutine that the
151         exporting package re-exports. Moose re-exports the
152         Carp::confess function, among others. The reasoning is that we
153         cannot know whether you have also explicitly imported those
154         functions for your own use, so we err on the safe side and
155         always keep them. (Dave Rolsky)
156         - added tests for this (rafl)
157
158     * Moose::Meta::Class
159       - Changes to how we fix metaclass compatibility that are much
160         too complicated to go into. The summary is that Moose is much
161         less likely to complain about metaclass incompatibility
162         now. In particular, if two metaclasses differ because
163         Moose::Util::MetaRole was used on the two corresponding
164         classes, then the difference in roles is reconciled for the
165         subclass's metaclass. (Dave Rolsky)
166       - Squashed an warning in _process_attribute (thepler)
167
168     * Moose::Meta::Role
169       - throw exceptions (sooner) for invalid attribute names (thepler)
170         - added tests for this (thepler)
171
172     * Moose::Util::MetaRole
173       - If you explicitly set a constructor or destructor class for a
174         metaclass object, and then applied roles to the metaclass,
175         that explicitly set class would be lost and replaced with the
176         default.
177
178     * Moose::Meta::Class
179     * Moose::Meta::Attribute
180     * Moose::Meta::Method
181     * Moose
182     * Moose::Object
183     * Moose::Error::Default
184     * Moose::Error::Croak
185     * Moose::Error::Confess
186       - All instances of confess() changed to use overridable
187         C<throw_error> method. This method ultimately calls a class
188         constructor, and you can change the class being called. In
189         addition, errors now pass more information than just a string.
190         The default C<error_class> behaves like C<Carp::confess>, so
191         the behavior is not visibly different for end users.
192
193 0.57 Wed September 3, 2008
194     * Moose::Intro
195       - A new bit of doc intended to introduce folks familiar with
196         "standard" Perl 5 OO to Moose concepts. (Dave Rolsky)
197
198     * Moose::Unsweetened
199       - Shows examples of two classes, each done first with and then
200         without Moose. This makes a nice parallel to
201         Moose::Intro. (Dave Rolsky)
202
203     * Moose::Util::TypeConstraints
204       - Fixed a bug in find_or_parse_type_constraint so that it
205         accepts a Moose::Meta::TypeConstraint object as the parent
206         type, not just a name (jnapiorkowski)
207         - added tests (jnapiorkowski)
208
209     * Moose::Exporter
210       - If Sub::Name was not present, unimporting failed to actually
211         remove some sugar subs, causing test failures (Dave Rolsky)
212
213 0.56 Mon September 1, 2008
214     For those not following the series of dev releases, there are
215     several major changes in this release of Moose.
216       ! Moose::init_meta should now be called as a method. See the
217         docs for details.
218
219       - Major performance improvements by nothingmuch.
220
221       - New modules for extension writers, Moose::Exporter and
222         Moose::Util::MetaRole by Dave Rolsky.
223
224       - Lots of doc improvements and additions, especially in the
225         cookbook sections.
226
227       - Various bug fixes.
228
229     * Removed all references to the experimental-but-no-longer-needed
230       Moose::Meta::Role::Application::ToMetaclassInstance.
231
232     * Require Class::MOP 0.65.
233
234 0.55_04 Sat August 30, 2008
235     * Moose::Util::MetaRole
236     * Moose::Cookbook::Extending::Recipe2
237       - This simplifies the application of roles to any meta class, as
238         well as the base object class. Reimplemented metaclass traits
239         using this module. (Dave Rolsky)
240
241     * Moose::Cookbook::Extending::Recipe1
242       - This a new recipe, an overview of various ways to write Moose
243         extensions (Dave Rolsky)
244
245     * Moose::Cookbook::Extending::Recipe3
246     * Moose::Cookbook::Extending::Recipe4
247       - These used to be Extending::Recipe1 and Extending::Recipe2,
248         respectively.
249
250 0.55_03 Fri August 29, 2008
251     * No changes from 0.55_02 except increasing the Class::MOP
252       dependency to 0.64_07.
253
254 0.55_02 Fri August 29, 2008
255     * Makefile.PL and Moose.pm
256       - explicitly require Perl 5.8.0+ (Dave Rolsky)
257
258     * Moose::Util::TypeConstraints
259       - Fix warnings from find_type_constraint if the type is not 
260         found (t0m).
261       
262     * Moose::Meta::TypeConstraint
263       - Predicate methods (equals/is_a_type_of/is_subtype_of) now
264         return false if the type you specify cannot be found in the
265         type registry, rather than throwing an unhelpful and
266         coincidental exception. (t0m).
267         - added docs & test for this (t0m)
268     
269     * Moose::Meta::TypeConstraint::Registry
270       - add_type_constraint now throws an exception if a parameter is
271         not supplied (t0m).
272         - added docs & test for this (t0m)
273
274     * Moose::Cookbook::FAQ
275       - Added a faq entry on the difference between "role" and "trait"
276         (t0m)
277
278     * Moose::Meta::Role
279       - Fixed a bug that caused role composition to not see a required
280         method when that method was provided by another role being
281         composed at the same time. (Dave Rolsky)
282         - test and bug finding (tokuhirom)
283         
284 0.55_01 Wed August 20, 2008
285
286     !! Calling Moose::init_meta as a function is now         !!
287     !! deprecated. Please see the Moose.pm docs for details. !!
288
289     * Moose::Meta::Method::Constructor
290       - Fix inlined constructor so that values produced by default
291         or builder methods are coerced as required. (t0m)
292         - added test for this (t0m)
293
294     * Moose::Meta::Attribute
295       - A lazy attribute with a default or builder did not attempt to
296         coerce the default value. The immutable code _did_
297         coerce. (t0m)
298         - added test for this (t0m)
299
300     * Moose::Exporter
301       - This is a new helper module for writing "Moose-alike"
302         modules. This should make the lives of MooseX module authors
303         much easier. (Dave Rolsky)
304
305     * Moose
306     * Moose::Cookbook::Meta::Recipe5
307       - Implemented metaclass traits (and wrote a recipe for it):
308
309           use Moose -traits => 'Foo'
310
311         This should make writing small Moose extensions a little
312         easier (Dave Rolsky)
313
314     * Moose::Cookbook::Basics::Recipe1
315       - Removed any examples of direct hashref access, and applied an
316         editorial axe to reduce verbosity. (Dave Rolsky)
317
318     * Moose::Cookbook::Basics::Recipe1
319       - Also applied an editorial axe here. (Dave Rolsky)
320
321     * Moose
322     * Moose::Cookbook::Extending::Recipe1
323     * Moose::Cookbook::Extending::Recipe2
324       - Rewrote extending and embedding moose documentation and
325         recipes to use Moose::Exporter (Dave Rolsky)
326
327     * Moose
328     * Moose::Role
329       - These two modules now warn when you load them from the main
330         package "main" package, because we will not export sugar to
331         main. Previously it just did nothing. (Dave Rolsky)
332
333     * Moose::Role
334       - Now provide an init_meta method just like Moose.pm, and you
335         can call this to provide an alternate role metaclass. (Dave
336         Rolsky and nothingmuch)
337       - get_method_map now respects the package cache flag (nothingmuch)
338
339     * Moose::Meta::Role
340       - Two new methods - add_method and wrap_method_body
341         (nothingmuch)
342
343     * many modules
344       - Optimizations including allowing constructors to accept hash
345         refs, making many more classes immutable, and making
346         constructors immutable. (nothingmuch)
347
348 0.55 Sun August 3, 2008
349     * Moose::Meta::Attribute
350       - breaking down the way 'handles' methods are
351         created so that the process can be more easily
352         overridden by subclasses (stevan)
353
354     * Moose::Meta::TypeConstraint
355       - fixing what is passed into a ->message with
356         the type constraints (RT #37569)
357         - added tests for this (Charles Alderman)
358
359     * Moose::Util::TypeConstraints
360       - fix coerce to accept anon types like subtype can (mst)
361
362     * Moose::Cookbook
363       - reorganized the recipes into sections - Basics, Roles, Meta,
364         Extending - and wrote abstracts for each section (Dave Rolsky)
365
366     * Moose::Cookbook::Basics::Recipe10
367       - A new recipe that demonstrates operator overloading
368         in combination with Moose. (bluefeet)
369
370     * Moose::Cookbook::Meta::Recipe1
371       - an introduction to what meta is and why you'd want to make
372         your own metaclass extensions (Dave Rolsky)
373
374     * Moose::Cookbook::Meta::Recipe4
375       - a very simple metaclass example (Dave Rolsky)
376
377     * Moose::Cookbook::Extending::Recipe1
378       - how to write a Moose-alike module to use your own object base
379         class (Dave Rolsky)
380
381     * Moose::Cookbook::Extending::Recipe2
382       - how to write modules with an API just like C<Moose.pm> (Dave
383         Rolsky)
384
385     * all documentation
386       - Tons of fixes, both syntactical and grammatical (Dave
387         Rolsky, Paul Fenwick)
388
389 0.54 Thurs. July 3, 2008
390     ... this is not my day today ...
391     
392     * Moose::Meta::Attribute
393       - fixed legal_options_for_inheritance such that 
394         clone_and_inherit options still works for 
395         Class::MOP::Attribute objects and therefore 
396         does not break MooseX::AttributeHelpers
397         (stevan)
398
399 0.53 Thurs. July 3, 2008
400     * Whoops, I guess I should run 'make manifest' before 
401       actually releasing the module. No actual changes 
402       in this release, except the fact that it includes
403       the changes that I didn't include in the last 
404       release. (stevan--)
405
406 0.52 Thurs. July 3, 2008
407     * Moose
408       - added "FEATURE REQUESTS" section to the Moose docs
409         to properly direct people (stevan) (RT #34333)
410       - making 'extends' croak if it is passed a Role since 
411         this is not ever something you want to do 
412         (fixed by stevan, found by obra)
413         - added tests for this (stevan)
414
415     * Moose::Object
416       - adding support for DOES (as in UNIVERSAL::DOES) 
417         (nothingmuch)
418         - added test for this
419
420     * Moose::Meta::Attribute
421       - added legal_options_for_inheritance (wreis)
422         - added tests for this (wreis)
423
424     * Moose::Cookbook::Snacks::*
425       - removed some of the unfinished snacks that should 
426         not have been released yet. Added some more examples
427         to the 'Keywords' snack. (stevan)
428
429     * Moose::Cookbook::Style
430       - added general Moose "style guide" of sorts to the 
431         cookbook (nothingmuch) (RT #34335)
432
433     * t/
434       - added more BUILDARGS tests (stevan)
435
436 0.51 Thurs. Jun 26, 2008
437     * Moose::Role
438       - add unimport so "no Moose::Role" actually does
439         something (sartak)
440
441     * Moose::Meta::Role::Application::ToRole
442       - when RoleA did RoleB, and RoleA aliased a method from RoleB in
443         order to provide its own implementation, that method still got
444         added to the list of required methods for consumers of
445         RoleB. Now an aliased method is only added to the list of
446         required methods if the role doing the aliasing does not
447         provide its own implementation. See Recipe 11 for an example
448         of all this. (Dave Rolsky)
449         - added tests for this
450
451     * Moose::Meta::Method::Constructor
452       - when a single argument that wasn't a hashref was provided to
453         an immutabilized constructor, the error message was very
454         unhelpful, as opposed to the non-immutable error. Reported by
455         dew. (Dave Rolsky)
456         - added test for this (Dave Rolsky)
457
458     * Moose::Meta::Attribute
459       - added support for meta_attr->does("ShortAlias") (sartak)
460         - added tests for this (sartak)
461       - moved the bulk of the `handles` handling to the new
462         install_delegation method (Stevan)
463
464     * Moose::Object
465       - Added BUILDARGS, a new step in new()
466
467     * Moose::Meta::Role::Application::RoleSummation
468       - fix typos no one ever sees (sartak)
469
470     * Moose::Util::TypeConstraints
471     * Moose::Meta::TypeConstraint
472     * Moose::Meta::TypeCoercion
473       - Attempt to work around the ??{ } vs. threads issue
474         (not yet fixed)
475       - Some null_constraint optimizations
476
477 0.50 Thurs. Jun 11, 2008
478     - Fixed a version number issue by bumping all modules
479       to 0.50.
480
481 0.49 Thurs. Jun 11, 2008
482     !! This version now approx. 20-25% !!
483     !! faster with new Class::MOP 0.59 !!
484
485     * Moose::Meta::Attribute
486       - fixed how the is => (ro|rw) works with 
487         custom defined reader, writer and accessor
488         options. 
489         - added docs for this (TODO).
490         - added tests for this (Thanks to Penfold)
491       - added the custom attribute alias for regular
492         Moose attributes which is "Moose"
493       - fix builder and default both being used
494         (groditi)
495
496     * Moose
497       Moose::Meta::Class
498       Moose::Meta::Attribute
499       Moose::Meta::Role
500       Moose::Meta::Role::Composite
501       Moose::Util::TypeConstraints
502       - switched usage of reftype to ref because 
503         it is much faster
504         
505     * Moose::Meta::Role
506       - changing add_package_symbol to use the new
507         HASH ref form
508     
509     * Moose::Object
510       - fixed how DEMOLISHALL is called so that it 
511         can be overrided in subclasses (thanks to Sartak)
512         - added test for this (thanks to Sartak)
513
514     * Moose::Util::TypeConstraints
515       - move the ClassName type check code to
516         Class::MOP::is_class_loaded (thanks to Sartak)
517
518     * Moose::Cookbook::Recipe11
519       - add tests for this (thanks to tokuhirom)
520
521 0.48 Thurs. May 29, 2008
522     (early morning release engineering)--
523
524     - fixing the version in Moose::Meta::Method::Destructor
525       which was causing the indexer to choke
526
527 0.47 Thurs. May 29, 2008
528     (late night release engineering)--
529
530     - fixing the version is META.yml, no functional 
531       changes in this release
532
533 0.46 Wed. May 28, 2008
534     !! This version now approx. 20-25% !!
535     !! faster with new Class::MOP 0.57 !!
536
537     * Moose::Meta::Class
538       - some optimizations of the &initialize method
539         since it is called so often by &meta    
540         
541     * Moose::Meta::Class
542       Moose::Meta::Role
543       - now use the get_all_package_symbols from the 
544         updated Class::MOP, test suite is now 10 seconds 
545         faster
546     
547     * Moose::Meta::Method::Destructor
548       - is_needed can now also be called as a class 
549         method for immutablization to check if the 
550         destructor object even needs to be created 
551         at all
552     
553     * Moose::Meta::Method::Destructor
554       Moose::Meta::Method::Constructor
555       - added more descriptive error message to help 
556         keep people from wasting time tracking an error
557         that is easily fixed by upgrading.
558
559 0.45 Saturday, May 24, 2008
560     * Moose
561       - Because of work in Class::MOP 0.57, all 
562         XS based functionality is now optional
563         and a Pure Perl version is supplied
564         - the CLASS_MOP_NO_XS environment variable
565           can now be used to force non-XS versions 
566           to always be used   
567         - several of the packages have been tweaked
568           to take care of this, mostly we added
569           support for the package_name and name 
570           variables in all the Method metaclasses
571       - before/around/after method modifiers now 
572         support regexp matching of names
573         (thanks to Takatoshi Kitano)
574         - tests added for this
575         - NOTE: this only works for classes, it 
576           is currently not supported in roles, 
577           but, ... patches welcome
578       - All usage of Carp::confess have been replaced
579         by Carp::croak in the "keyword" functions since
580         the stack trace is usually not helpful
581       
582     * Moose::Role
583       - All usage of Carp::confess have been replaced
584         by Carp::croak in the "keyword" functions since
585         the stack trace is usually not helpful  
586       - The 'has' keyword for roles now accepts the 
587         same array ref form that Moose.pm does 
588         (has [qw/foo bar/] => (is => 'rw', ...))
589         - added test for this
590       
591     * Moose::Meta::Attribute
592       - trigger on a ro-attribute is no longer an
593         error, as it's useful to trigger off of the
594         constructor
595
596     * Moose::Meta::Class
597       - added same 'add_package_symbol' fix as in 
598         Class::MOP 0.57
599
600     * Moose::Util
601       - does_role now handles non-Moose classes 
602         more gracefully
603         - added tests for this
604       - added the 'add_method_modifier' function 
605         (thanks to Takatoshi Kitano)
606
607     * Moose::Util::TypeConstraints
608       - subtypes of parameterizable types now are 
609         themselves parameterizable types
610
611     * Moose::Meta::Method::Constructor
612       - fixed bug where trigger was not being 
613         called by the inlined immutable 
614         constructors 
615         - added test for this (thanks to Caelum)
616     
617     * Moose::Meta::Role::Application::ToInstance
618       - now uses the metaclass of the instance
619         (if possible) to create the anon-class
620         (thanks Jonathan Rockway)
621     
622     * Moose::Cookbook::Recipe22
623       - added the meta-attribute trait recipe
624         (thanks to Sartak)
625     
626     * t/
627       - fixed hash-ordering test bug that was 
628         causing occasional cpantester failures
629       - renamed the t/000_recipe/*.t tests to be 
630         more descriptive (thanks to Sartak) 
631
632 0.44 Sat. May 10, 2008
633     * Moose
634       - made make_immutable warning cluck to 
635         show where the error is (thanks mst)
636     
637     * Moose::Object
638       - BUILDALL and DEMOLISHALL now call 
639         ->body when looping through the 
640         methods, to avoid the overloaded
641         method call.
642       - fixed issue where DEMOLISHALL was
643         eating the $@ values, and so not 
644         working correctly, it still kind of
645         eats them, but so does vanilla perl 
646         - added tests for this
647       
648     * Moose::Cookbook::Recipe7
649       - added new recipe for immutable 
650         functionality (thanks Dave Rolsky)
651       
652     * Moose::Cookbook::Recipe9
653       - added new recipe for builder and 
654         lazy_build (thanks Dave Rolsky)
655       
656     * Moose::Cookbook::Recipe11
657       - added new recipe for method aliasing 
658         and exclusion with Roles (thanks Dave Rolsky)
659
660     * t/
661       - fixed Win32 test failure (thanks spicyjack)
662
663     ~ removed Build.PL and Module::Build compat 
664       since Module::Install has done that.
665
666 0.43 Wed. April, 30, 2008
667     * NOTE TO SELF:
668         drink more coffee before 
669         doing release engineering
670       
671     - whoops, forgot to do the smolder tests, 
672       and we broke some of the custom meta-attr
673       modules. This fixes that.
674
675 0.42 Mon. April 28, 2008
676     - some bad tests slipped by, nothing else 
677       changed in this release (cpantesters++)
678       
679     - upped the Class::MOP dependency to 0.55 
680       since we have tests which need the C3 
681       support
682
683 0.41 Mon. April 28, 2008
684     ~~ numerous documentation updates ~~
685     
686     - Changed all usage of die to Carp::croak for better
687       error reporting (initial patch by Tod Hagan)
688
689     ** IMPORTANT NOTE **
690     - the make_immutable keyword is now deprecated, don't
691       use it in any new code and please fix your old code
692       as well. There will be 2 releases, and then it will
693       be removed.
694
695     * Moose
696       Moose::Role
697       Moose::Meta::Class
698       - refactored the way inner and super work to avoid
699         any method/@ISA cache penalty (nothingmuch)
700
701     * Moose::Meta::Class
702       - fixing &new_object to make sure trigger gets the 
703         coerced value (spotted by Charles Alderman on the 
704         mailing list)
705         - added test for this
706
707     * Moose::Meta::Method::Constructor
708       - immutable classes which had non-lazy attributes were calling
709         the default generating sub twice in the constructor. (bug
710         found by Jesse Luehrs, fixed by Dave Rolsky)
711         - added tests for this (Dave Rolsky)
712       - fix typo in initialize_body method (nothingmuch)
713       
714     * Moose::Meta::Method::Destructor
715       - fix typo in initialize_body method (nothingmuch)
716
717     * Moose::Meta::Method::Overriden
718       Moose::Meta::Method::Augmented
719       - moved the logic for these into their own 
720         classes (nothingmuch)
721
722     * Moose::Meta::Attribute
723       - inherited attributes may now be extended without 
724         restriction on the type ('isa', 'does') (Sartak)
725         - added tests for this (Sartak)
726       - when an attribute property is malformed (such as lazy without 
727         a default), give the name of the attribute in the error 
728         message (Sartak)
729       - added the &applied_traits and &has_applied_traits methods 
730         to allow introspection of traits
731         - added tests for this
732       - moved 'trait' and 'metaclass' argument handling to here from
733         Moose::Meta::Class
734       - clone_and_inherit_options now handles 'trait' and 'metaclass' (has
735         '+foo' syntax) (nothingmuch)
736         - added tests for this (t0m)
737      
738     * Moose::Object 
739       - localize $@ inside DEMOLISHALL to avoid it 
740         eating $@ (found by Ernesto)
741         - added test for this (thanks to Ernesto)
742
743     * Moose::Util::TypeConstraints
744       - &find_type_constraint now DWIMs when given an 
745         type constraint object or name (nothingmuch)
746       - &find_or_create_type_constraint superseded with a number of more
747         specific functions:
748         - find_or_create_{isa,does}_type_constraint
749         - find_or_parse_type_constraint
750
751     * Moose::Meta::TypeConstraint
752       Moose::Meta::TypeConstraint::Class
753       Moose::Meta::TypeConstraint::Role
754       Moose::Meta::TypeConstraint::Enum
755       Moose::Meta::TypeConstraint::Union
756       Moose::Meta::TypeConstraint::Parameterized
757         - added the &equals method for comparing two type 
758           constraints (nothingmuch)
759           - added tests for this (nothingmuch)
760
761     * Moose::Meta::TypeConstraint
762       - add the &parents method, which is just an alias to &parent. 
763         Useful for polymorphism with TC::{Class,Role,Union} (nothingmuch)
764
765     * Moose::Meta::TypeConstraint::Class
766       - added the class attribute for introspection purposes
767         (nothingmuch)
768         - added tests for this
769         
770     * Moose::Meta::TypeConstraint::Enum
771       Moose::Meta::TypeConstraint::Role
772       - broke these out into their own classes (nothingmuch)
773
774     * Moose::Cookbook::Recipe*
775       - fixed references to test file locations in the POD
776         and updated up some text for new Moose features
777         (Sartak)
778
779     * Moose::Util
780       - Added &resolve_metaclass_alias, a helper function for finding an actual
781         class for a short name (e.g. in the traits list)
782
783 0.40 Fri. March 14, 2008
784     - I hate Pod::Coverage
785
786 0.39 Fri. March 14, 2008
787     * Moose
788       - documenting the use of '+name' with attributes 
789         that come from recently composed roles. It makes
790         sense, people are using it, and so why not just 
791         officially support it.
792       - fixing the 'extends' keyword so that it will not 
793         trigger Ovid's bug (http://use.perl.org/~Ovid/journal/35763)
794       
795     * oose
796       - added the perl -Moose=+Class::Name feature to allow 
797         monkeypatching of classes in one liners
798       
799     * Moose::Util
800       - fixing the 'apply_all_roles' keyword so that it will not 
801         trigger Ovid's bug (http://use.perl.org/~Ovid/journal/35763)    
802     
803     * Moose::Meta::Class
804       - added ->create method which now supports roles (thanks to jrockway)
805         - added tests for this
806       - added ->create_anon_class which now supports roles and caching of 
807         the results (thanks to jrockway)
808         - added tests for this
809       - made ->does_role a little more forgiving when it is
810         checking a Class::MOP era metaclasses.
811     
812     * Moose::Meta::Role::Application::ToInstance
813       - it is now possible to pass extra params to be used when 
814         a role is applied to an the instance (rebless_params)
815         - added tests for this
816     
817     * Moose::Util::TypeConstraints
818       - class_type now accepts an optional second argument for a
819         custom message. POD anotated accordingly (groditi)
820         - added tests for this 
821       - it is now possible to make anon-enums by passing 'enum' an 
822         ARRAY ref instead of the $name => @values. Everything else 
823         works as before.
824         - added tests for this
825     
826     * t/
827       - making test for using '+name' on attributes consumed 
828         from a role, it works and makes sense too.    
829
830     * Moose::Meta::Attribute 
831       - fix handles so that it doesn't return nothing 
832         when the method cannot be found, not sure why 
833         it ever did this originally, this means we now
834         have slightly better support for AUTOLOADed 
835         objects
836         - added more delegation tests
837       - adding ->does method to this so as to better 
838         support traits and their introspection.
839         - added tests for this
840     
841     * Moose::Object
842       - localizing the Data::Dumper configurations so 
843         that it does not pollute others (RT #33509)
844       - made ->does a little more forgiving when it is
845         passed Class::MOP era metaclasses.
846
847 0.38 Fri. Feb. 15, 2008
848     * Moose::Meta::Attribute 
849       - fixed initializer to correctly do 
850         type checking and coercion in the 
851         callback 
852         - added tests for this
853
854     * t/
855       - fixed some finicky tests (thanks to konobi)
856
857 0.37 Thurs. Feb. 14, 2008
858     * Moose
859       - fixed some details in Moose::init_meta 
860         and its superclass handling (thanks thepler)
861         - added tests for this (thanks thepler)
862       - 'has' now dies if you don't pass in name 
863         value pairs
864       - added the 'make_immutable' keyword as a shortcut
865         to make_immutable
866
867     * Moose::Meta::Class
868       Moose::Meta::Method::Constructor
869       Moose::Meta::Attribute        
870       - making (init_arg => undef) work here too
871         (thanks to nothingmuch)
872         
873     * Moose::Meta::Attribute        
874       Moose::Meta::Method::Constructor
875       Moose::Meta::Method::Accessor                
876       - make lazy attributes respect attr initializers (rjbs)
877         - added tests for this
878     
879     * Moose::Util::TypeConstraints
880       Moose::Util::TypeConstraints::OptimizedConstraints
881       Moose::Meta::TypeConstraints
882       Moose::Meta::Attribute
883       Moose::Meta::Method::Constructor
884       Moose::Meta::Method::Accessor            
885       - making type errors use the 
886         assigned message (thanks to Sartak)
887         - added tests for this
888
889     * Moose::Meta::Method::Destructor
890       - making sure DESTROY gets inlined properly 
891         with successive DEMOLISH calls (thanks to manito)
892
893     * Moose::Meta::Attribute  
894       Moose::Meta::Method::Accessor 
895       - fixed handling of undef with type constraints 
896         (thanks to Ernesto)               
897         - added tests for this
898     
899     * Moose::Util
900       - added &get_all_init_args and &get_all_attribute_values 
901         (thanks to Sartak and nothingmuch)
902
903 0.36 Sat. Jan. 26, 2008
904     * Moose::Role
905       Moose::Meta::Attribute
906       - role type tests now support when roles are 
907         applied to non-Moose classes (found by ash)
908         - added tests for this (thanks to ash)
909       - couple extra tests to boost code coverage
910
911     * Moose::Meta::Method::Constructor    
912       - improved fix for handling Class::MOP attributes
913         - added test for this        
914       
915     * Moose::Meta::Class
916       - handled the add_attribute($attribute_meta_object)
917         case correctly
918         - added test for this
919
920 0.35 Tues. Jan. 22, 2008
921     * Moose::Meta::Method::Constructor
922       - fix to make sure even Class::MOP attributes 
923         are handled correctly (Thanks to Dave Rolsky)
924         - added test for this (also Dave Rolsky)
925     
926     * Moose::Meta::Class
927       - improved error message on _apply_all_roles, 
928         you should now use Moose::Util::apply_all_roles
929         and you shouldnt have been using a _ prefixed
930         method in the first place ;)
931
932 0.34 Mon. Jan. 21, 2008
933     ~~~ more misc. doc. fixes ~~~
934     ~~ updated copyright dates ~~
935
936     Moose is now a postmodern object system :)
937       - (see the POD for details)
938       
939     * <<Role System Refactoring>>    
940     - this release contains a major reworking and 
941       cleanup of the role system     
942       - 100% backwards compat.
943       - Role application now restructured into seperate
944         classes based on type of applicants
945       - Role summation (combining of more than one role)
946         is much cleaner and anon-classes are no longer 
947         used in this process
948       - new Composite role metaclass    
949       - runtime application of roles to instances
950         is now more efficient and re-uses generated
951         classes when applicable
952         
953     * <<New Role composition features>>
954       - methods can now be excluded from a given role 
955         during composition
956       - methods can now be aliased to another name (and 
957         still retain the original as well)        
958     
959     * Moose::Util::TypeConstraints::OptimizedConstraints
960       - added this module (see above)
961
962     * Moose::Meta::Class
963       - fixed the &_process_attribute method to be called
964         by &add_attribute, so that the API is now correct
965
966     * Moose::Meta::Method::Accessor
967       - fixed bug when passing a list of values to
968         an accessor would get (incorrectly) ignored.
969         Thanks to Sartak for finding this ;)
970         - added tests for this (Sartak again)
971
972     * Moose::Meta::Method::Accessor
973       Moose::Meta::Method::Constructor
974       Moose::Meta::Attribute
975       Moose::Meta::TypeConstraint      
976       Moose::Meta::TypeCoercion      
977       - lots of cleanup of such things as: 
978         - generated methods
979         - type constraint handling
980         - error handling/messages 
981         (thanks to nothingmuch)   
982     
983     * Moose::Meta::TypeConstraint::Parameterizable
984       - added this module to support the refactor 
985         in Moose::Meta::TypeConstraint::Parameterized
986
987     * Moose::Meta::TypeConstraint::Parameterized
988       - refactored how these types are handled so they 
989         are more generic and not confined to ArrayRef
990         and HashRef only
991
992     * t/
993       - shortened some file names for better VMS support (RT #32381)
994
995 0.33 Fri. Dec. 14, 2007
996     !! Moose now loads 2 x faster !!
997     !!  with new Class::MOP 0.49  !!
998
999     ++ new oose.pm module to make command line
1000        Moose-ness easier (see POD docs for more)
1001
1002     * Moose::Meta::Class
1003     * Moose::Meta::Role
1004       - several tweaks to take advantage of the
1005         new method map caching in Class::MOP
1006
1007     * Moose::Meta::TypeConstraint::Parameterized
1008       - allow subtypes of ArrayRef and HashRef to
1009         be used as a container (sartak)
1010         - added tests for this
1011       - basic support for coercion to ArrayRef and
1012         HashRef for containers (sartak)
1013         - added tests for this
1014
1015     * Moose::Meta::TypeCoercion
1016       - coercions will now create subtypes as needed
1017         so you can now add coercions to parameterized
1018         types without having to explictly define them
1019         - added tests for this
1020
1021     * Moose::Meta::Method::Accessor
1022       - allow subclasses to decide whether we need
1023         to copy the value into a new variable (sartak)
1024
1025 0.32 Tues. Dec. 4, 2007
1026     * Moose::Util::TypeConstraints
1027       - fixing how subtype aliases of unions work
1028         they should inherit the parent's coercion
1029         - added tests for this
1030       - you can now define multiple coercions on
1031         a single type at different times instead of
1032         having to do it all in one place
1033         - added tests for this
1034
1035     * Moose::Meta::TypeConstraint
1036       - there is now a default constraint of sub { 1 }
1037         instead of Moose::Util::TypeConstraints setting
1038         this for us
1039
1040     * Moose::Meta::TypeCoercion
1041     * Moose::Meta::TypeCoercion::Union
1042       - added the &has_coercion_for_type and
1043         &add_type_coercions methods to support the
1044         new features above (although you cannot add
1045         more type coercions for Union types)
1046
1047 0.31 Mon. Nov. 26, 2007
1048     * Moose::Meta::Attribute
1049       - made the +attr syntax handle extending types with
1050         parameters. So "has '+foo' => (isa => 'ArrayRef[Int]')"
1051         now works if the original foo is an ArrayRef.
1052         - added tests for this.
1053       - delegation now works even if the attribute does not
1054         have a reader method using the get_read_method_ref
1055         method from Class::MOP::Attribute.
1056         - added tests for this
1057         - added docs for this
1058
1059     * Moose::Util::TypeConstraints
1060       - passing no "additional attribute info" to
1061         &find_or_create_type_constraint will no longer
1062         attempt to create an __ANON__ type for you,
1063         instead it will just return undef.
1064         - added docs for this
1065
1066 0.30 Fri. Nov. 23, 2007
1067     * Moose::Meta::Method::Constructor
1068       -builder related bug in inlined constructor. (groditi)
1069
1070     * Moose::Meta::Method::Accessor
1071       - genereate unnecessary calls to predicates and refactor
1072         code generation for runtime speed (groditi)
1073
1074     * Moose::Util::TypeConstraints
1075       - fix ClassName constraint to introspect symbol table (mst)
1076         - added more tests for this (mst)
1077       - fixed it so that subtype 'Foo' => as 'HashRef[Int]' ...
1078         with work correctly.
1079         - added tests for this
1080
1081     * Moose::Cookbook
1082       - adding the link to Recipie 11 (written by Sartak)
1083         - adding test for SYNOPSIS code
1084
1085     * t/
1086       - New tests for builder bug. Upon instantiation, if an
1087         attribute had a builder, no value and was not lazy the
1088         builder default was not getting run, oops. (groditi)
1089
1090 0.29 Tues. Nov. 13, 2007
1091     * Moose::Meta::Attribute
1092       - Fix error message on missing builder method (groditi)
1093
1094     * Moose::Meta::Method::Accessor
1095       - Fix error message on missing builder method (groditi)
1096
1097     * t/
1098       - Add test to check for the correct error message when
1099         builder method is missing (groditi)
1100
1101 0.28 Tues. Nov. 13, 2007
1102     - 0.27 packaged incorrectly (groditi)
1103
1104 0.27 Tues. Nov. 13, 2007
1105     * Moose::Meta::Attribute
1106       - Added support for the new builder option (groditi)
1107       - Added support for lazy_build option (groditi)
1108       - Changed slot initialization for predicate changes (groditi)
1109
1110     * Moose::Meta::Method::Accessor
1111       - Added support for lazy_build option (groditi)
1112       - Fix inline methods to work with corrected predicate
1113         behavior (groditi)
1114
1115     * Moose::Meta::Method::Constructor
1116       - Added support for lazy_build option (groditi)
1117
1118     * t/
1119       - tests for builder and lazy_build (groditi)
1120
1121     * fixing some misc. bits in the docs that
1122       got mentioned on CPAN Forum & perlmonks
1123
1124     * Moose::Meta::Role
1125       - fixed how required methods are handled
1126         when they encounter overriden or modified
1127         methods from a class (thanks to confound).
1128         - added tests for this
1129
1130     * Moose::Util::TypeConstraint
1131       - fixed the type notation parser so that
1132         the | always creates a union and so is
1133         no longer a valid type char (thanks to
1134         konobi, mugwump and #moose for working
1135         this one out.)
1136         - added more tests for this
1137
1138 0.26 Thurs. Sept. 27, 2007
1139     == New Features ==
1140
1141     * Parameterized Types
1142       We now support parameterized collection types, such as:
1143           ArrayRef[Int]    # array or integers
1144           HashRef[Object]  # a hash with object values
1145       They can also be nested:
1146           ArrayRef[HashRef[RegExpr]] # an array of hashes with regexpr values
1147       And work with the type unions as well:
1148           ArrayRef[Int | Str]  # array of integers of strings
1149
1150     * Better Framework Extendability
1151       Moose.pm is now "extendable" such that it is now much
1152       easier to extend the framework and add your own keywords
1153       and customizations. See the "EXTENDING AND EMBEDDING MOOSE"
1154       section of the Moose.pm docs.
1155
1156     * Moose Snacks!
1157       In an effort to begin documenting some of the various
1158       details of Moose as well as some common idioms, we have
1159       created Moose::Cookbook::Snacks as a place to find
1160       small (easily digestable) nuggets of Moose code.
1161
1162     ====
1163     ~ Several doc updates/cleanup thanks to castaway ~
1164
1165     - converted build system to use Module::Install instead of
1166       Module::Build (thanks to jrockway)
1167
1168     * Moose
1169       - added all the meta classes to the immutable list and
1170         set it to inline the accessors
1171       - fix import to allow Sub::Exporter like { into => }
1172             and { into_level => } (perigrin)
1173       - exposed and documented init_meta() to allow better
1174             embedding and extending of Moose (perigrin)
1175
1176         * t/
1177           - complete re-organization of the test suite
1178           - added some new tests as well
1179           - finally re-enabled the Moose::POOP test since
1180             the new version of DBM::Deep now works again
1181             (thanks rob)
1182
1183     * Moose::Meta::Class
1184       - fixed very odd and very nasty recursion bug with
1185         inner/augment (mst)
1186         - added tests for this (eilara)
1187
1188     * Moose::Meta::Attribute
1189       Moose::Meta::Method::Constructor
1190       Moose::Meta::Method::Accessor
1191       - fixed issue with overload::Overloaded getting called
1192         on non-blessed items. (RT #29269)
1193         - added tests for this
1194
1195     * Moose::Meta::Method::Accessor
1196       - fixed issue with generated accessor code making
1197         assumptions about hash based classes (thanks to dexter)
1198
1199     * Moose::Coookbook::Snacks
1200       - these are bits of documentation, not quite as big as
1201         Recipes but which have no clear place in the module docs.
1202         So they are Snacks! (horray for castaway++)
1203
1204     * Moose::Cookbook::Recipe4
1205       - updated it to use the new ArrayRef[MyType] construct
1206         - updated the accompanying test as well
1207
1208     +++ Major Refactor of the Type Constraint system +++
1209     +++       with new features added as well        +++
1210
1211     * Moose::Util::TypeConstraint
1212       - no longer uses package variable to keep track of
1213         the type constraints, now uses the an instance of
1214         Moose::Meta::TypeConstraint::Registry to do it
1215       - added more sophisticated type notation parsing
1216         (thanks to mugwump)
1217         - added tests for this
1218
1219     * Moose::Meta::TypeConstraint
1220       - some minor adjustments to make subclassing easier
1221       - added the package_defined_in attribute so that we
1222         can track where the type constraints are created
1223
1224     * Moose::Meta::TypeConstraint::Union
1225       - this is now been refactored to be a subclass of
1226         Moose::Meta::TypeConstraint
1227
1228     * Moose::Meta::TypeCoercion::Union
1229       - this has been added to service the newly refactored
1230         Moose::Meta::TypeConstraint::Union and is itself
1231         a subclass of Moose::Meta::TypeCoercion
1232
1233     * Moose::Meta::TypeConstraint::Parameterized
1234       - added this module (taken from MooseX::AttributeHelpers)
1235         to help construct nested collection types
1236         - added tests for this
1237
1238     * Moose::Meta::TypeConstraint::Registry
1239       - added this class to keep track of type constraints
1240
1241 0.25 Mon. Aug. 13, 2007
1242     * Moose
1243       - Documentation update to reference Moose::Util::TypeConstraints
1244         under 'isa' in 'has' for how to define a new type
1245         (thanks to shlomif).
1246
1247     * Moose::Meta::Attribute
1248       - required attributes now will no longer accept undef
1249         from the constructor, even if there is a default and lazy
1250         - added tests for this
1251       - default subroutines must return a value which passes the
1252         type constraint
1253         - added tests for this
1254
1255     * Moose::Meta::Attribute
1256     * Moose::Meta::Method::Constructor
1257     * Moose::Meta::Method::Accessor
1258       - type-constraint tests now handle overloaded objects correctly
1259         in the error message
1260         - added tests for this (thanks to EvanCarroll)
1261
1262     * Moose::Meta::TypeConstraint::Union
1263       - added (has_)hand_optimized_constraint to this class so that
1264         it behaves as the regular Moose::Meta::TypeConstraint does.
1265
1266     * Moose::Meta::Role
1267       - large refactoring of this code
1268       - added several more tests
1269         - tests for subtle conflict resolition issues
1270           added, but not currently running
1271           (thanks to kolibre)
1272
1273     * Moose::Cookbook::Recipe7
1274       - added new recipe for augment/inner functionality
1275         (still in progress)
1276         - added test for this
1277
1278     * Moose::Spec::Role
1279       - a formal definition of roles (still in progress)
1280
1281     * Moose::Util
1282       - utilities for easier working with Moose classes
1283         - added tests for these
1284
1285     * Test::Moose
1286       - This contains Moose specific test functions
1287         - added tests for these
1288
1289 0.24 Tues. July 3, 2007
1290     ~ Some doc updates/cleanup ~
1291
1292     * Moose::Meta::Attribute
1293       - added support for roles to be given as parameters
1294         to the 'handles' option.
1295         - added tests and docs for this
1296       - the has '+foo' attribute form now accepts changes to
1297         the lazy option, and the addition of a handles option
1298         (but not changing the handles option)
1299         - added tests and docs for this
1300
1301     * Moose::Meta::Role
1302       - required methods are now fetched using find_method_by_name
1303         so that required methods can come from superclasses
1304         - adjusted tests for this
1305
1306 0.23 Mon. June 18, 2007
1307     * Moose::Meta::Method::Constructor
1308       - fix inlined constructor for hierarchy with multiple BUILD methods (mst)
1309     * Moose::Meta::Class
1310       - Modify make_immutable to work with the new Class::MOP immutable
1311         mechanism + POD + very basic test (groditi)
1312     * Moose::Meta::Attribute
1313       - Fix handles to use goto() so that caller() comes out properly on
1314         the other side (perigrin)
1315
1316 0.22 Thurs. May 31, 2007
1317     * Moose::Util::TypeConstraints
1318       - fix for prototype undeclared issue when Moose::Util::TypeConstraints
1319         loaded before consumers (e.g. Moose::Meta::Attribute) by predeclaring
1320         prototypes for functions
1321       - added the ClassName type constraint, this checks for strings
1322         which will respond true to ->isa(UNIVERSAL).
1323         - added tests and docs for this
1324       - subtyping just in name now works correctly by making the
1325         default for where be { 1 }
1326         - added test for this
1327
1328     * Moose::Meta::Method::Accessor
1329       - coerce and lazy now work together correctly, thanks to
1330         merlyn for finding this bug
1331         - tests added for this
1332       - fix reader presedence bug in Moose::Meta::Attribute + tests
1333
1334     * Moose::Object
1335       - Foo->new(undef) now gets ignored, it is assumed you meant to pass
1336         a HASH-ref and missed. This produces better error messages then
1337         having it die cause undef is not a HASH.
1338         - added tests for this
1339
1340 0.21 Thursday, May 2nd, 2007
1341     * Moose
1342       - added SUPER_SLOT and INNER_SLOT class hashes to support unimport
1343       - modified unimport to remove super and inner along with the rest
1344         - altered unimport tests to handle this
1345
1346     * Moose::Role
1347       - altered super export to populate SUPER_SLOT
1348
1349     * Moose::Meta::Class
1350       - altered augment and override modifier application to use *_SLOT
1351         - modified tests for these to unimport one test class each to test
1352
1353     * Moose::Meta::Role
1354       - fixed issue where custom attribute metaclasses
1355         where not handled correctly in roles
1356         - added tests for this
1357
1358     * Moose::Meta::Class
1359       - fixed issue where extending metaclasses with
1360         roles would blow up. Thanks to Aankhen`` for
1361         finding this insidious error, and it's solution.
1362
1363     ~~ lots of spelling and grammer fixes in the docs,
1364        many many thanks to rlb3 and Aankhen for these :)
1365
1366 0.20 Friday, April 6th, 2007
1367     >> I messed up the SKIP logic in one test
1368        so this release is just to fix that.
1369
1370     * Moose
1371       - 'has' now also accepts an ARRAY ref
1372         to create multiple attrs (see docs)
1373         (thanks to konobi for this)
1374          - added tests and docs
1375
1376 0.19 Thurs. April 5th, 2007
1377     ~~ More documentation updates ~~
1378
1379     * Moose::Util::TypeConstraints
1380       - 'type' now supports messages as well
1381         thanks to phaylon for finding this
1382         - added tests for this
1383       - added &list_all_type_constraints and
1384         &list_all_builtin_type_constraints
1385         functions to facilitate introspection.
1386
1387     * Moose::Meta::Attribute
1388       - fixed regexp 'handles' declarations
1389         to build the list of delegated methods
1390         correctly (and not override important
1391         things like &new) thanks to ashleyb
1392         for finding this
1393         - added tests and docs for this
1394       - added the 'documentation' attributes
1395         so that you can actually document your
1396         attributes and inspect them through the
1397         meta-object.
1398         - added tests and docs for this
1399
1400     * Moose::Meta::Class
1401       - when loading custom attribute metaclasses
1402         it will first look in for the class in the
1403         Moose::Meta::Attribute::Custom::$name, and
1404         then default to just loading $name.
1405         - added tests and docs for this
1406
1407     * Moose::Meta::TypeConstraint
1408       - type constraints now stringify to their names.
1409         - added test for this
1410
1411     * misc.
1412       - added tests to assure we work with Module::Refresh
1413       - added stricter test skip logic in the Moose POOP
1414         test, ask Rob Kinyon why.
1415         - *cough* DBM::Deep 1.0 backwards compatibility sucks *cough* ;)
1416
1417 0.18 Sat. March 10, 2007
1418     ~~ Many, many documentation updates ~~
1419
1420     * misc.
1421       - We now use Class::MOP::load_class to
1422         load all classes.
1423       - added tests to show types and subtypes
1424         working with Declare::Constraints::Simple
1425         and Test::Deep as constraint engines.
1426
1427 0.18_001
1428     !! You must have Class::MOP 0.37_001  !!
1429     !! for this developer release to work !!
1430
1431     This release was primarily adding the immutable
1432     feature to Moose. An immutable class is one which
1433     you promise not to alter. When you set the class
1434     as immutable it will perform various bits of
1435     memoization and inline certain part of the code
1436     (constructors, destructors and accessors). This
1437     minimizes (and in some cases totally eliminates)
1438     one of Moose's biggest performance hits. This
1439     feature is not on by default, and is 100% optional.
1440     It has several configurable bits as well, so you
1441     can pick and choose to your specific needs.
1442
1443     The changes involved in this were fairly wide and
1444     highly specific, but 100% backwards compatible, so
1445     I am not going to enumerate them here. If you are
1446     truely interested in what was changed, please do
1447     a diff :)
1448
1449 0.17 Tues. Nov. 14, 2006
1450     * Moose::Meta::Method::Accessor
1451       - bugfix for read-only accessors which
1452         are have a type constraint and lazy.
1453         Thanks to chansen for finding it.
1454
1455 0.16 Tues. Nov. 14, 2006
1456     ++ NOTE ++
1457     There are some speed improvements in this release,
1458     but they are only the begining, so stay tuned.
1459
1460     * Moose::Object
1461       - BUILDALL and DEMOLISHALL no longer get
1462         called unless they actually need to be.
1463         This gave us a signifigant speed boost
1464         for the cases when there is no BUILD or
1465         DEMOLISH method present.
1466
1467     * Moose::Util::TypeConstraints
1468     * Moose::Meta::TypeConstraint
1469       - added an 'optimize_as' option to the
1470         type constraint, which allows for a
1471         hand optimized version of the type
1472         constraint to be used when possible.
1473       - Any internally created type constraints
1474         now provide an optimized version as well.
1475
1476 0.15 Sun. Nov. 5, 2006
1477     ++ NOTE ++
1478     This version of Moose *must* have Class::MOP 0.36 in order
1479     to work correctly. A number of small internal tweaks have
1480     been made in order to be compatible with that release.
1481
1482     * Moose::Util::TypeConstraints
1483       - added &unimport so that you can clean out
1484         your class namespace of these exported
1485         keywords
1486
1487     * Moose::Meta::Class
1488       - fixed minor issue which occasionally
1489         comes up during global destruction
1490         (thanks omega)
1491       - moved Moose::Meta::Method::Overriden into
1492         its own file.
1493
1494     * Moose::Meta::Role
1495       - moved Moose::Meta::Role::Method into
1496         its own file.
1497
1498     * Moose::Meta::Attribute
1499       - changed how we do type checks so that
1500         we reduce the overall cost, but still
1501         retain correctness.
1502        *** API CHANGE ***
1503       - moved accessor generation methods to
1504         Moose::Meta::Method::Accessor to
1505         conform to the API changes from
1506         Class::MOP 0.36
1507
1508     * Moose::Meta::TypeConstraint
1509       - changed how constraints are compiled
1510         so that we do less recursion and more
1511         iteration. This makes the type check
1512         faster :)
1513       - moved Moose::Meta::TypeConstraint::Union
1514         into its own file
1515
1516     * Moose::Meta::Method::Accessor
1517       - created this from methods formerly found in
1518         Moose::Meta::Attribute
1519
1520     * Moose::Meta::Role::Method
1521       - moved this from Moose::Meta::Role
1522
1523     * Moose::Meta::Method::Overriden
1524       - moved this from Moose::Meta::Class
1525
1526     * Moose::Meta::TypeConstraint::Union
1527       - moved this from Moose::Meta::TypeConstraint
1528
1529 0.14 Mon. Oct. 9, 2006
1530
1531     * Moose::Meta::Attribute
1532       - fixed lazy attributes which were not getting
1533         checked with the type constraint (thanks ashley)
1534         - added tests for this
1535       - removed the over-enthusiastic DWIMery of the
1536         automatic ArrayRef and HashRef defaults, it
1537         broke predicates in an ugly way.
1538         - removed tests for this
1539
1540 0.13 Sat. Sept. 30, 2006
1541     ++ NOTE ++
1542     This version of Moose *must* have Class::MOP 0.35 in order
1543     to work correctly. A number of small internal tweaks have
1544     been made in order to be compatible with that release.
1545
1546     * Moose
1547       - Removed the use of UNIVERSAL::require to be a better
1548         symbol table citizen and remove a dependency
1549         (thanks Adam Kennedy)
1550
1551       **~~ removed experimental & undocumented feature ~~**
1552       - commented out the 'method' and 'self' keywords, see the
1553         comments for more info.
1554
1555     * Moose::Cookbook
1556       - added a FAQ and WTF files to document frequently
1557         asked questions and common problems
1558
1559     * Moose::Util::TypeConstraints
1560       - added GlobRef and FileHandle type constraint
1561         - added tests for this
1562
1563     * Moose::Meta::Attribute
1564       - if your attribute 'isa' ArrayRef of HashRef, and you have
1565         not explicitly set a default, then make the default DWIM.
1566         This will also work for subtypes of ArrayRef and HashRef
1567         as well.
1568       - you can now auto-deref subtypes of ArrayRef or HashRef too.
1569         - new test added for this (thanks to ashley)
1570
1571     * Moose::Meta::Role
1572       - added basic support for runtime role composition
1573         but this is still *highly experimental*, so feedback
1574         is much appreciated :)
1575         - added tests for this
1576
1577     * Moose::Meta::TypeConstraint
1578       - the type constraint now handles the coercion process
1579         through delegation, this is to support the coercion
1580         of unions
1581
1582     * Moose::Meta::TypeConstraint::Union
1583       - it is now possible for coercions to be performed
1584         on a type union
1585         - added tests for this (thanks to konobi)
1586
1587     * Moose::Meta::TypeCoercion
1588       - properly capturing error when type constraint
1589         is not found
1590
1591     * Build.PL
1592       - Scalar::Util 1.18 is bad on Win32, so temporarily
1593         only require version 1.17 for Win32 and cygwin.
1594         (thanks Adam Kennedy)
1595
1596 0.12 Sat. Sept. 1, 2006
1597     * Moose::Cookbook
1598       - Recipe5 (subtypes & coercion) has been written
1599
1600     * Moose
1601       - fixed "bad meta" error message to be more descriptive
1602       - fixed &unimport to not remove the &inner and &super
1603         keywords because we need to localize them.
1604       - fixed number of spelling/grammer issues, thanks Theory :)
1605
1606       **~~ experimental & undocumented feature ~~**
1607       - added the method and self keywords, they are basically
1608         just sugar, and they may not stay around.
1609
1610     * Moose::Object
1611       - added &dump method to easily Data::Dumper
1612         an object
1613
1614     * Moose::Meta::TypeConstraint
1615       - added the &is_a_type_of method to check both the current
1616         and the subtype of a method (similar to &isa with classes)
1617
1618     * Moose::Meta::Role
1619       - this is now a subclass of Class::MOP::Module, and no longer
1620         creates the _role_meta ugliness of before.
1621         - fixed tests to reflect this change
1622
1623 0.11 Wed. July 12, 2006
1624     * Moose
1625       - added an &unimport method to remove all the keywords
1626         that Moose will import, simply add 'no Moose' to the
1627         bottom of your class file.
1628
1629     * t/
1630       - fixed some test failures caused by a forgotten test
1631         dependency.
1632
1633 0.10 Thurs. July 6, 2006
1634     * Moose
1635       - improved error message when loading modules so
1636         it is less confusing when you load a role.
1637       - added &calculate_all_roles method to
1638         Moose::Meta::Class and Moose::Meta::Role
1639
1640     NOTE:
1641     This module has been tested against Class::MOP 0.30
1642     but it does not yet utilize the optimizations
1643     it makes available. Stay tuned for that ;)
1644
1645 0.09_03 Fri. June 23, 2006
1646     ++ DEVELOPER RELEASE ++
1647     * Moose
1648       - 'use strict' and 'use warnings' are no longer
1649          needed in Moose classes, Moose itself will
1650          turn them on for you.
1651          - added tests for this
1652       - moved code from exported subs to private methods
1653         in Moose::Meta::Class
1654
1655     * Moose::Role
1656       - as with Moose, strict and warnings are
1657         automatically turned on for you.
1658          - added tests for this
1659
1660     * Moose::Meta::Role
1661       - now handles an edge case for override errors
1662         - added tests for this
1663       - added some more edge case tests
1664
1665 0.09_02 Tues. May 16, 2006
1666     ++ DEVELOPER RELEASE ++
1667     * Moose
1668       - added prototypes to the exported subs
1669       - updated docs
1670
1671     * Moose::Role
1672       - added prototypes to the exported subs
1673       - updated docs
1674
1675     * Moose::Util::TypeConstraints
1676       - cleaned up prototypes for the subs
1677       - updated docs
1678
1679 0.09_01 Fri. May 12, 2006
1680     ++ DEVELOPER RELEASE ++
1681       - This release works in combination with
1682         Class::MOP 0.29_01, it is a developer
1683         release because it uses the a new
1684         instance sub-protocol and a fairly
1685         complete Role implementation. It has
1686         not yet been optimized, so it slower
1687         the the previous CPAN version. This
1688         release also lacks good updated docs,
1689         the official release will have updated docs.
1690
1691     * Moose
1692       - refactored the keyword exports
1693         - 'with' now checks Role validaity and
1694           accepts more than one Role at a time
1695         - 'extends' makes metaclass adjustments as
1696            needed to ensure metaclass compatibility
1697
1698     * Moose::Role
1699       - refactored the keyword exports
1700         - 'with' now checks Role validaity and
1701           accepts more than one Role at a time
1702
1703     * Moose::Util::TypeConstraints
1704       - added the 'enum' keyword for simple
1705         string enumerations which can be used as
1706         type constraints
1707         - see example of usage in t/202_example.t
1708
1709     * Moose::Object
1710       - more careful checking of params to new()
1711
1712     * Moose::Meta::Role
1713       - much work done on the role composition
1714         - many new tests for conflict detection
1715           and composition edge cases
1716         - not enough documentation, I suggest
1717           looking at the tests
1718
1719     * Moose::Meta::Instance
1720       - added new Instance metaclass to support
1721         the new Class::MOP instance protocol
1722
1723     * Moose::Meta::Class
1724       - some small changes to support the new
1725         instance protocol
1726       - some small additions to support Roles
1727
1728     * Moose::Meta::Attribute
1729       - some improvements to the accessor generation code
1730         by nothingmuch
1731       - some small changes to support the new
1732         instance protocol
1733       - (still somewhat) experimental delegation support
1734         with the 'handles' option
1735         - added several tests for this
1736         - no docs for this yet
1737
1738 0.05 Thurs. April 27, 2006
1739     * Moose
1740       - keywords are now exported with Sub::Exporter
1741         thanks to chansen for this commit
1742       - has keyword now takes a 'metaclass' option
1743         to support custom attribute meta-classes
1744         on a per-attribute basis
1745         - added tests for this
1746       - the 'has' keyword not accepts inherited slot
1747         specifications (has '+foo'). This is still an
1748         experimental feature and probably not finished
1749         see t/038_attribute_inherited_slot_specs.t for
1750         more details, or ask about it on #moose
1751         - added tests for this
1752
1753     * Moose::Role
1754       - keywords are now exported with Sub::Exporter
1755
1756     * Moose::Utils::TypeConstraints
1757       - reorganized the type constraint hierarchy, thanks
1758         to nothingmuch and chansen for his help and advice
1759         on this
1760         - added some tests for this
1761       - keywords are now exported with Sub::Exporter
1762         thanks to chansen for this commit
1763
1764     * Moose::Meta::Class
1765       - due to changes in Class::MOP, we had to change
1766         construct_instance (for the better)
1767
1768     * Moose::Meta::Attribute
1769       - due to changes in Class::MOP, we had to add the
1770         initialize_instance_slot method (it's a good thing)
1771
1772     * Moose::Meta::TypeConstraint
1773       - added type constraint unions
1774         - added tests for this
1775       - added the is_subtype_of predicate method
1776         - added tests for this
1777
1778 0.04 Sun. April 16th, 2006
1779     * Moose::Role
1780       - Roles can now consume other roles
1781         - added tests for this
1782       - Roles can specify required methods now with
1783         the requires() keyword
1784         - added tests for this
1785
1786     * Moose::Meta::Role
1787       - ripped out much of it's guts ,.. much cleaner now
1788       - added required methods and correct handling of
1789         them in apply() for both classes and roles
1790         - added tests for this
1791       - no longer adds a does() method to consuming classes
1792         it relys on the one in Moose::Object
1793       - added roles attribute and some methods to support
1794         roles consuming roles
1795
1796     * Moose::Meta::Attribute
1797       - added support for triggers on attributes
1798         - added tests for this
1799       - added support for does option on an attribute
1800         - added tests for this
1801
1802     * Moose::Meta::Class
1803       - added support for attribute triggers in the
1804         object construction
1805         - added tests for this
1806
1807     * Moose
1808       - Moose no longer creates a subtype for your class
1809         if a subtype of the same name already exists, this
1810         should DWIM in 99.9999% of all cases
1811
1812     * Moose::Util::TypeConstraints
1813       - fixed bug where incorrect subtype conflicts were
1814         being reported
1815         - added test for this
1816
1817     * Moose::Object
1818       - this class can now be extended with 'use base' if
1819         you need it, it properly loads the metaclass class now
1820         - added test for this
1821
1822 0.03_02 Wed. April 12, 2006
1823     * Moose
1824       - you must now explictly use Moose::Util::TypeConstraints
1825         it no longer gets exported for you automatically
1826
1827     * Moose::Object
1828       - new() now accepts hash-refs as well as key/value lists
1829       - added does() method to check for Roles
1830         - added tests for this
1831
1832     * Moose::Meta::Class
1833       - added roles attribute along with the add_role() and
1834         does_role() methods
1835         - added tests for this
1836
1837     * Moose::Meta::Role
1838       - now adds a does() method to consuming classes
1839         which tests the class's hierarchy for roles
1840         - added tests for this
1841
1842 0.03_01 Mon. April 10, 2006
1843     * Moose::Cookbook
1844       - added new Role recipe (no content yet, only code)
1845
1846     * Moose
1847       - added 'with' keyword for Role support
1848         - added test and docs for this
1849       - fixed subtype quoting bug
1850         - added test for this
1851
1852     * Moose::Role
1853       - Roles for Moose
1854         - added test and docs
1855
1856     * Moose::Util::TypeConstraints
1857       - added the message keyword to add custom
1858         error messages to type constraints
1859
1860     * Moose::Meta::Role
1861       - the meta role to support Moose::Role
1862         - added tests and docs
1863
1864     * Moose::Meta::Class
1865       - moved a number of things from Moose.pm
1866         to here, they should have been here
1867         in the first place
1868
1869     * Moose::Meta::Attribute
1870       - moved the attribute option macros here
1871         instead of putting them in Moose.pm
1872
1873     * Moose::Meta::TypeConstraint
1874       - added the message attributes and the
1875         validate method
1876         - added tests and docs for this
1877
1878 0.03 Thurs. March 30, 2006
1879     * Moose::Cookbook
1880       - added the Moose::Cookbook with 5 recipes,
1881         describing all the stuff Moose can do.
1882
1883     * Moose
1884       - fixed an issue with &extends super class loading
1885         it now captures errors and deals with inline
1886         packages correctly (bug found by mst, solution
1887         stolen from alias)
1888       - added super/override & inner/augment features
1889         - added tests and docs for these
1890
1891     * Moose::Object
1892       - BUILDALL now takes a reference of the %params
1893         that are passed to &new, and passes that to
1894         each BUILD as well.
1895
1896     * Moose::Util::TypeConstraints
1897       - Type constraints now survive runtime reloading
1898         - added test for this
1899
1900         * Moose::Meta::Class
1901           - fixed the way attribute defaults are handled
1902             during instance construction (bug found by chansen)
1903
1904     * Moose::Meta::Attribute
1905       - read-only attributes now actually enforce their
1906         read-only-ness (this corrected in Class::MOP as
1907         well)
1908
1909 0.02 Tues. March 21, 2006
1910     * Moose
1911       - many more tests, fixing some bugs and
1912         edge cases
1913       - &extends now loads the base module with
1914         UNIVERSAL::require
1915         - added UNIVERSAL::require to the
1916           dependencies list
1917       ** API CHANGES **
1918       - each new Moose class will also create
1919         and register a subtype of Object which
1920         correspond to the new Moose class.
1921       - the 'isa' option in &has now only
1922         accepts strings, and will DWIM in
1923         almost all cases
1924
1925     * Moose::Util::TypeConstraints
1926       - added type coercion features
1927         - added tests for this
1928         - added support for this in attributes
1929           and instance construction
1930       ** API CHANGES **
1931       - type construction no longer creates a
1932         function, it registers the type instead.
1933         - added several functions to get the
1934           registered types
1935
1936     * Moose::Object
1937       - BUILDALL and DEMOLISHALL were broken
1938         because of a mis-named hash key, Whoops :)
1939
1940     * Moose::Meta::Attribute
1941       - adding support for coercion in the
1942         autogenerated accessors
1943
1944     * Moose::Meta::Class
1945       - adding support for coercion in the
1946         instance construction
1947
1948     * Moose::Meta::TypeConstraint
1949     * Moose::Meta::TypeCoercion
1950           - type constraints and coercions are now
1951             full fledges meta-objects
1952
1953 0.01 Wed. March 15, 2006
1954     - Moooooooooooooooooose!!!