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