Fix changes for recipe 9
[gitmo/Moose.git] / Changes
1 Revision history for Perl extension Moose
2
3 0.44
4     * Moose::Cookbook::Recipe7
5       - added new recipe for immutable functionality (Dave Rolsky)
6     * Moose::Cookbook::Recipe9
7       - added new recipe for builder and lazy_build (Dave Rolsky)
8
9 0.43 Wed. April, 30, 2008
10     * NOTE TO SELF:
11         drink more coffee before 
12         doing release engineering
13       
14     - whoops, forgot to do the smolder tests, 
15       and we broke some of the custom meta-attr
16       modules. This fixes that.
17
18 0.42 Mon. April 28, 2008
19     - some bad tests slipped by, nothing else 
20       changed in this release (cpantesters++)
21       
22     - upped the Class::MOP dependency to 0.55 
23       since we have tests which need the C3 
24       support
25
26 0.41 Mon. April 28, 2008
27     ~~ numerous documentation updates ~~
28     
29     - Changed all usage of die to Carp::croak for better
30       error reporting (initial patch by Tod Hagan)
31
32     ** IMPORTANT NOTE **
33     - the make_immutable keyword is now deprecated, don't
34       use it in any new code and please fix your old code
35       as well. There will be 2 releases, and then it will
36       be removed.
37
38     * Moose
39       Moose::Role
40       Moose::Meta::Class
41       - refactored the way inner and super work to avoid
42         any method/@ISA cache penalty (nothingmuch)
43
44     * Moose::Meta::Class
45       - fixing &new_object to make sure trigger gets the 
46         coerced value (spotted by Charles Alderman on the 
47         mailing list)
48         - added test for this
49
50     * Moose::Meta::Method::Constructor
51       - immutable classes which had non-lazy attributes were calling
52         the default generating sub twice in the constructor. (bug
53         found by Jesse Luehrs, fixed by Dave Rolsky)
54         - added tests for this (Dave Rolsky)
55       - fix typo in initialize_body method (nothingmuch)
56       
57     * Moose::Meta::Method::Destructor
58       - fix typo in initialize_body method (nothingmuch)
59
60     * Moose::Meta::Method::Overriden
61       Moose::Meta::Method::Augmented
62       - moved the logic for these into their own 
63         classes (nothingmuch)
64
65     * Moose::Meta::Attribute
66       - inherited attributes may now be extended without 
67         restriction on the type ('isa', 'does') (Sartak)
68         - added tests for this (Sartak)
69       - when an attribute property is malformed (such as lazy without 
70         a default), give the name of the attribute in the error 
71         message (Sartak)
72       - added the &applied_traits and &has_applied_traits methods 
73         to allow introspection of traits
74         - added tests for this
75       - moved 'trait' and 'metaclass' argument handling to here from
76         Moose::Meta::Class
77       - clone_and_inherit_options now handles 'trait' and 'metaclass' (has
78         '+foo' syntax) (nothingmuch)
79         - added tests for this (t0m)
80      
81     * Moose::Object 
82       - localize $@ inside DEMOLISHALL to avoid it 
83         eating $@ (found by Ernesto)
84         - added test for this (thanks to Ernesto)
85
86     * Moose::Util::TypeConstraints
87       - &find_type_constraint now DWIMs when given an 
88         type constraint object or name (nothingmuch)
89       - &find_or_create_type_constraint superseded with a number of more
90         specific functions:
91         - find_or_create_{isa,does}_type_constraint
92         - find_or_parse_type_constraint
93
94     * Moose::Meta::TypeConstraint
95       Moose::Meta::TypeConstraint::Class
96       Moose::Meta::TypeConstraint::Role
97       Moose::Meta::TypeConstraint::Enum
98       Moose::Meta::TypeConstraint::Union
99       Moose::Meta::TypeConstraint::Parameterized
100         - added the &equals method for comparing two type 
101           constraints (nothingmuch)
102           - added tests for this (nothingmuch)
103
104     * Moose::Meta::TypeConstraint
105       - add the &parents method, which is just an alias to &parent. 
106         Useful for polymorphism with TC::{Class,Role,Union} (nothingmuch)
107
108     * Moose::Meta::TypeConstraint::Class
109       - added the class attribute for introspection purposes
110         (nothingmuch)
111         - added tests for this
112         
113     * Moose::Meta::TypeConstraint::Enum
114       Moose::Meta::TypeConstraint::Role
115       - broke these out into their own classes (nothingmuch)
116
117     * Moose::Cookbook::Recipe*
118       - fixed references to test file locations in the POD
119         and updated up some text for new Moose features
120         (Sartak)
121
122     * Moose::Util
123       - Added &resolve_metaclass_alias, a helper function for finding an actual
124         class for a short name (e.g. in the traits list)
125
126 0.40 Fri. March 14, 2008
127     - I hate Pod::Coverage
128
129 0.39 Fri. March 14, 2008
130     * Moose
131       - documenting the use of '+name' with attributes 
132         that come from recently composed roles. It makes
133         sense, people are using it, and so why not just 
134         officially support it.
135       - fixing the 'extends' keyword so that it will not 
136         trigger Ovid's bug (http://use.perl.org/~Ovid/journal/35763)
137       
138     * oose
139       - added the perl -Moose=+Class::Name feature to allow 
140         monkeypatching of classes in one liners
141       
142     * Moose::Util
143       - fixing the 'apply_all_roles' keyword so that it will not 
144         trigger Ovid's bug (http://use.perl.org/~Ovid/journal/35763)    
145     
146     * Moose::Meta::Class
147       - added ->create method which now supports roles (thanks to jrockway)
148         - added tests for this
149       - added ->create_anon_class which now supports roles and caching of 
150         the results (thanks to jrockway)
151         - added tests for this
152       - made ->does_role a little more forgiving when it is
153         checking a Class::MOP era metaclasses.
154     
155     * Moose::Meta::Role::Application::ToInstance
156       - it is now possible to pass extra params to be used when 
157         a role is applied to an the instance (rebless_params)
158         - added tests for this
159     
160     * Moose::Util::TypeConstraints
161       - class_type now accepts an optional second argument for a
162         custom message. POD anotated accordingly (groditi)
163         - added tests for this 
164       - it is now possible to make anon-enums by passing 'enum' an 
165         ARRAY ref instead of the $name => @values. Everything else 
166         works as before.
167         - added tests for this
168     
169     * t/
170       - making test for using '+name' on attributes consumed 
171         from a role, it works and makes sense too.    
172
173     * Moose::Meta::Attribute 
174       - fix handles so that it doesn't return nothing 
175         when the method cannot be found, not sure why 
176         it ever did this originally, this means we now
177         have slightly better support for AUTOLOADed 
178         objects
179         - added more delegation tests
180       - adding ->does method to this so as to better 
181         support traits and their introspection.
182         - added tests for this
183     
184     * Moose::Object
185       - localizing the Data::Dumper configurations so 
186         that it does not pollute others (RT #33509)
187       - made ->does a little more forgiving when it is
188         passed Class::MOP era metaclasses.
189
190 0.38 Fri. Feb. 15, 2008
191     * Moose::Meta::Attribute 
192       - fixed initializer to correctly do 
193         type checking and coercion in the 
194         callback 
195         - added tests for this
196
197     * t/
198       - fixed some finicky tests (thanks to konobi)
199
200 0.37 Thurs. Feb. 14, 2008
201     * Moose
202       - fixed some details in Moose::init_meta 
203         and its superclass handling (thanks thepler)
204         - added tests for this (thanks thepler)
205       - 'has' now dies if you don't pass in name 
206         value pairs
207       - added the 'make_immutable' keyword as a shortcut
208         to make_immutable
209
210     * Moose::Meta::Class
211       Moose::Meta::Method::Constructor
212       Moose::Meta::Attribute        
213       - making (init_arg => undef) work here too
214         (thanks to nothingmuch)
215         
216     * Moose::Meta::Attribute        
217       Moose::Meta::Method::Constructor
218       Moose::Meta::Method::Accessor                
219       - make lazy attributes respect attr initializers (rjbs)
220         - added tests for this
221     
222     * Moose::Util::TypeConstraints
223       Moose::Util::TypeConstraints::OptimizedConstraints
224       Moose::Meta::TypeConstraints
225       Moose::Meta::Attribute
226       Moose::Meta::Method::Constructor
227       Moose::Meta::Method::Accessor            
228       - making type errors use the 
229         assigned message (thanks to Sartak)
230         - added tests for this
231
232     * Moose::Meta::Method::Destructor
233       - making sure DESTROY gets inlined properly 
234         with successive DEMOLISH calls (thanks to manito)
235
236     * Moose::Meta::Attribute  
237       Moose::Meta::Method::Accessor 
238       - fixed handling of undef with type constraints 
239         (thanks to Ernesto)               
240         - added tests for this
241     
242     * Moose::Util
243       - added &get_all_init_args and &get_all_attribute_values 
244         (thanks to Sartak and nothingmuch)
245
246 0.36 Sat. Jan. 26, 2008
247     * Moose::Role
248       Moose::Meta::Attribute
249       - role type tests now support when roles are 
250         applied to non-Moose classes (found by ash)
251         - added tests for this (thanks to ash)
252       - couple extra tests to boost code coverage
253
254     * Moose::Meta::Method::Constructor    
255       - improved fix for handling Class::MOP attributes
256         - added test for this        
257       
258     * Moose::Meta::Class
259       - handled the add_attribute($attribute_meta_object)
260         case correctly
261         - added test for this
262
263 0.35 Tues. Jan. 22, 2008
264     * Moose::Meta::Method::Constructor
265       - fix to make sure even Class::MOP attributes 
266         are handled correctly (Thanks to Dave Rolsky)
267         - added test for this (also Dave Rolsky)
268     
269     * Moose::Meta::Class
270       - improved error message on _apply_all_roles, 
271         you should now use Moose::Util::apply_all_roles
272         and you shouldnt have been using a _ prefixed
273         method in the first place ;)
274
275 0.34 Mon. Jan. 21, 2008
276     ~~~ more misc. doc. fixes ~~~
277     ~~ updated copyright dates ~~
278
279     Moose is now a postmodern object system :)
280       - (see the POD for details)
281       
282     * <<Role System Refactoring>>    
283     - this release contains a major reworking and 
284       cleanup of the role system     
285       - 100% backwards compat.
286       - Role application now restructured into seperate
287         classes based on type of applicants
288       - Role summation (combining of more than one role)
289         is much cleaner and anon-classes are no longer 
290         used in this process
291       - new Composite role metaclass    
292       - runtime application of roles to instances
293         is now more efficient and re-uses generated
294         classes when applicable
295         
296     * <<New Role composition features>>
297       - methods can now be excluded from a given role 
298         during composition
299       - methods can now be aliased to another name (and 
300         still retain the original as well)        
301     
302     * Moose::Util::TypeConstraints::OptimizedConstraints
303       - added this module (see above)
304
305     * Moose::Meta::Class
306       - fixed the &_process_attribute method to be called
307         by &add_attribute, so that the API is now correct
308
309     * Moose::Meta::Method::Accessor
310       - fixed bug when passing a list of values to
311         an accessor would get (incorrectly) ignored.
312         Thanks to Sartak for finding this ;)
313         - added tests for this (Sartak again)
314
315     * Moose::Meta::Method::Accessor
316       Moose::Meta::Method::Constructor
317       Moose::Meta::Attribute
318       Moose::Meta::TypeConstraint      
319       Moose::Meta::TypeCoercion      
320       - lots of cleanup of such things as: 
321         - generated methods
322         - type constraint handling
323         - error handling/messages 
324         (thanks to nothingmuch)   
325     
326     * Moose::Meta::TypeConstraint::Parameterizable
327       - added this module to support the refactor 
328         in Moose::Meta::TypeConstraint::Parameterized
329
330     * Moose::Meta::TypeConstraint::Parameterized
331       - refactored how these types are handled so they 
332         are more generic and not confined to ArrayRef
333         and HashRef only
334
335     * t/
336       - shortened some file names for better VMS support (RT #32381)
337
338 0.33 Fri. Dec. 14, 2007
339     !! Moose now loads 2 x faster !!
340     !!  with new Class::MOP 0.49  !!
341
342     ++ new oose.pm module to make command line
343        Moose-ness easier (see POD docs for more)
344
345     * Moose::Meta::Class
346     * Moose::Meta::Role
347       - several tweaks to take advantage of the
348         new method map caching in Class::MOP
349
350     * Moose::Meta::TypeConstraint::Parameterized
351       - allow subtypes of ArrayRef and HashRef to
352         be used as a container (sartak)
353         - added tests for this
354       - basic support for coercion to ArrayRef and
355         HashRef for containers (sartak)
356         - added tests for this
357
358     * Moose::Meta::TypeCoercion
359       - coercions will now create subtypes as needed
360         so you can now add coercions to parameterized
361         types without having to explictly define them
362         - added tests for this
363
364     * Moose::Meta::Method::Accessor
365       - allow subclasses to decide whether we need
366         to copy the value into a new variable (sartak)
367
368 0.32 Tues. Dec. 4, 2007
369     * Moose::Util::TypeConstraints
370       - fixing how subtype aliases of unions work
371         they should inherit the parent's coercion
372         - added tests for this
373       - you can now define multiple coercions on
374         a single type at different times instead of
375         having to do it all in one place
376         - added tests for this
377
378     * Moose::Meta::TypeConstraint
379       - there is now a default constraint of sub { 1 }
380         instead of Moose::Util::TypeConstraints setting
381         this for us
382
383     * Moose::Meta::TypeCoercion
384     * Moose::Meta::TypeCoercion::Union
385       - added the &has_coercion_for_type and
386         &add_type_coercions methods to support the
387         new features above (although you cannot add
388         more type coercions for Union types)
389
390 0.31 Mon. Nov. 26, 2007
391     * Moose::Meta::Attribute
392       - made the +attr syntax handle extending types with
393         parameters. So "has '+foo' => (isa => 'ArrayRef[Int]')"
394         now works if the original foo is an ArrayRef.
395         - added tests for this.
396       - delegation now works even if the attribute does not
397         have a reader method using the get_read_method_ref
398         method from Class::MOP::Attribute.
399         - added tests for this
400         - added docs for this
401
402     * Moose::Util::TypeConstraints
403       - passing no "additional attribute info" to
404         &find_or_create_type_constraint will no longer
405         attempt to create an __ANON__ type for you,
406         instead it will just return undef.
407         - added docs for this
408
409 0.30 Fri. Nov. 23, 2007
410     * Moose::Meta::Method::Constructor
411       -builder related bug in inlined constructor. (groditi)
412
413     * Moose::Meta::Method::Accessor
414       - genereate unnecessary calls to predicates and refactor
415         code generation for runtime speed (groditi)
416
417     * Moose::Util::TypeConstraints
418       - fix ClassName constraint to introspect symbol table (mst)
419         - added more tests for this (mst)
420       - fixed it so that subtype 'Foo' => as 'HashRef[Int]' ...
421         with work correctly.
422         - added tests for this
423
424     * Moose::Cookbook
425       - adding the link to Recipie 11 (written by Sartak)
426         - adding test for SYNOPSIS code
427
428     * t/
429       - New tests for builder bug. Upon instantiation, if an
430         attribute had a builder, no value and was not lazy the
431         builder default was not getting run, oops. (groditi)
432
433 0.29 Tues. Nov. 13, 2007
434     * Moose::Meta::Attribute
435       - Fix error message on missing builder method (groditi)
436
437     * Moose::Meta::Method::Accessor
438       - Fix error message on missing builder method (groditi)
439
440     * t/
441       - Add test to check for the correct error message when
442         builder method is missing (groditi)
443
444 0.28 Tues. Nov. 13, 2007
445     - 0.27 packaged incorrectly (groditi)
446
447 0.27 Tues. Nov. 13, 2007
448     * Moose::Meta::Attribute
449       - Added support for the new builder option (groditi)
450       - Added support for lazy_build option (groditi)
451       - Changed slot initialization for predicate changes (groditi)
452
453     * Moose::Meta::Method::Accessor
454       - Added support for lazy_build option (groditi)
455       - Fix inline methods to work with corrected predicate
456         behavior (groditi)
457
458     * Moose::Meta::Method::Constructor
459       - Added support for lazy_build option (groditi)
460
461     * t/
462       - tests for builder and lazy_build (groditi)
463
464     * fixing some misc. bits in the docs that
465       got mentioned on CPAN Forum & perlmonks
466
467     * Moose::Meta::Role
468       - fixed how required methods are handled
469         when they encounter overriden or modified
470         methods from a class (thanks to confound).
471         - added tests for this
472
473     * Moose::Util::TypeConstraint
474       - fixed the type notation parser so that
475         the | always creates a union and so is
476         no longer a valid type char (thanks to
477         konobi, mugwump and #moose for working
478         this one out.)
479         - added more tests for this
480
481 0.26 Thurs. Sept. 27, 2007
482     == New Features ==
483
484     * Parameterized Types
485       We now support parameterized collection types, such as:
486           ArrayRef[Int]    # array or integers
487           HashRef[Object]  # a hash with object values
488       They can also be nested:
489           ArrayRef[HashRef[RegExpr]] # an array of hashes with regexpr values
490       And work with the type unions as well:
491           ArrayRef[Int | Str]  # array of integers of strings
492
493     * Better Framework Extendability
494       Moose.pm is now "extendable" such that it is now much
495       easier to extend the framework and add your own keywords
496       and customizations. See the "EXTENDING AND EMBEDDING MOOSE"
497       section of the Moose.pm docs.
498
499     * Moose Snacks!
500       In an effort to begin documenting some of the various
501       details of Moose as well as some common idioms, we have
502       created Moose::Cookbook::Snacks as a place to find
503       small (easily digestable) nuggets of Moose code.
504
505     ====
506     ~ Several doc updates/cleanup thanks to castaway ~
507
508     - converted build system to use Module::Install instead of
509       Module::Build (thanks to jrockway)
510
511     * Moose
512       - added all the meta classes to the immutable list and
513         set it to inline the accessors
514       - fix import to allow Sub::Exporter like { into => }
515             and { into_level => } (perigrin)
516       - exposed and documented init_meta() to allow better
517             embedding and extending of Moose (perigrin)
518
519         * t/
520           - complete re-organization of the test suite
521           - added some new tests as well
522           - finally re-enabled the Moose::POOP test since
523             the new version of DBM::Deep now works again
524             (thanks rob)
525
526     * Moose::Meta::Class
527       - fixed very odd and very nasty recursion bug with
528         inner/augment (mst)
529         - added tests for this (eilara)
530
531     * Moose::Meta::Attribute
532       Moose::Meta::Method::Constructor
533       Moose::Meta::Method::Accessor
534       - fixed issue with overload::Overloaded getting called
535         on non-blessed items. (RT #29269)
536         - added tests for this
537
538     * Moose::Meta::Method::Accessor
539       - fixed issue with generated accessor code making
540         assumptions about hash based classes (thanks to dexter)
541
542     * Moose::Coookbook::Snacks
543       - these are bits of documentation, not quite as big as
544         Recipes but which have no clear place in the module docs.
545         So they are Snacks! (horray for castaway++)
546
547     * Moose::Cookbook::Recipe4
548       - updated it to use the new ArrayRef[MyType] construct
549         - updated the accompanying test as well
550
551     +++ Major Refactor of the Type Constraint system +++
552     +++       with new features added as well        +++
553
554     * Moose::Util::TypeConstraint
555       - no longer uses package variable to keep track of
556         the type constraints, now uses the an instance of
557         Moose::Meta::TypeConstraint::Registry to do it
558       - added more sophisticated type notation parsing
559         (thanks to mugwump)
560         - added tests for this
561
562     * Moose::Meta::TypeConstraint
563       - some minor adjustments to make subclassing easier
564       - added the package_defined_in attribute so that we
565         can track where the type constraints are created
566
567     * Moose::Meta::TypeConstraint::Union
568       - this is now been refactored to be a subclass of
569         Moose::Meta::TypeConstraint
570
571     * Moose::Meta::TypeCoercion::Union
572       - this has been added to service the newly refactored
573         Moose::Meta::TypeConstraint::Union and is itself
574         a subclass of Moose::Meta::TypeCoercion
575
576     * Moose::Meta::TypeConstraint::Parameterized
577       - added this module (taken from MooseX::AttributeHelpers)
578         to help construct nested collection types
579         - added tests for this
580
581     * Moose::Meta::TypeConstraint::Registry
582       - added this class to keep track of type constraints
583
584 0.25 Mon. Aug. 13, 2007
585     * Moose
586       - Documentation update to reference Moose::Util::TypeConstraints
587         under 'isa' in 'has' for how to define a new type
588         (thanks to shlomif).
589
590     * Moose::Meta::Attribute
591       - required attributes now will no longer accept undef
592         from the constructor, even if there is a default and lazy
593         - added tests for this
594       - default subroutines must return a value which passes the
595         type constraint
596         - added tests for this
597
598     * Moose::Meta::Attribute
599     * Moose::Meta::Method::Constructor
600     * Moose::Meta::Method::Accessor
601       - type-constraint tests now handle overloaded objects correctly
602         in the error message
603         - added tests for this (thanks to EvanCarroll)
604
605     * Moose::Meta::TypeConstraint::Union
606       - added (has_)hand_optimized_constraint to this class so that
607         it behaves as the regular Moose::Meta::TypeConstraint does.
608
609     * Moose::Meta::Role
610       - large refactoring of this code
611       - added several more tests
612         - tests for subtle conflict resolition issues
613           added, but not currently running
614           (thanks to kolibre)
615
616     * Moose::Cookbook::Recipe7
617       - added new recipe for augment/inner functionality
618         (still in progress)
619         - added test for this
620
621     * Moose::Spec::Role
622       - a formal definition of roles (still in progress)
623
624     * Moose::Util
625       - utilities for easier working with Moose classes
626         - added tests for these
627
628     * Test::Moose
629       - This contains Moose specific test functions
630         - added tests for these
631
632 0.24 Tues. July 3, 2007
633     ~ Some doc updates/cleanup ~
634
635     * Moose::Meta::Attribute
636       - added support for roles to be given as parameters
637         to the 'handles' option.
638         - added tests and docs for this
639       - the has '+foo' attribute form now accepts changes to
640         the lazy option, and the addition of a handles option
641         (but not changing the handles option)
642         - added tests and docs for this
643
644     * Moose::Meta::Role
645       - required methods are now fetched using find_method_by_name
646         so that required methods can come from superclasses
647         - adjusted tests for this
648
649 0.23 Mon. June 18, 2007
650     * Moose::Meta::Method::Constructor
651       - fix inlined constructor for hierarchy with multiple BUILD methods (mst)
652     * Moose::Meta::Class
653       - Modify make_immutable to work with the new Class::MOP immutable
654         mechanism + POD + very basic test (groditi)
655     * Moose::Meta::Attribute
656       - Fix handles to use goto() so that caller() comes out properly on
657         the other side (perigrin)
658
659 0.22 Thurs. May 31, 2007
660     * Moose::Util::TypeConstraints
661       - fix for prototype undeclared issue when Moose::Util::TypeConstraints
662         loaded before consumers (e.g. Moose::Meta::Attribute) by predeclaring
663         prototypes for functions
664       - added the ClassName type constraint, this checks for strings
665         which will respond true to ->isa(UNIVERSAL).
666         - added tests and docs for this
667       - subtyping just in name now works correctly by making the
668         default for where be { 1 }
669         - added test for this
670
671     * Moose::Meta::Method::Accessor
672       - coerce and lazy now work together correctly, thanks to
673         merlyn for finding this bug
674         - tests added for this
675       - fix reader presedence bug in Moose::Meta::Attribute + tests
676
677     * Moose::Object
678       - Foo->new(undef) now gets ignored, it is assumed you meant to pass
679         a HASH-ref and missed. This produces better error messages then
680         having it die cause undef is not a HASH.
681         - added tests for this
682
683 0.21 Thursday, May 2nd, 2007
684     * Moose
685       - added SUPER_SLOT and INNER_SLOT class hashes to support unimport
686       - modified unimport to remove super and inner along with the rest
687         - altered unimport tests to handle this
688
689     * Moose::Role
690       - altered super export to populate SUPER_SLOT
691
692     * Moose::Meta::Class
693       - altered augment and override modifier application to use *_SLOT
694         - modified tests for these to unimport one test class each to test
695
696     * Moose::Meta::Role
697       - fixed issue where custom attribute metaclasses
698         where not handled correctly in roles
699         - added tests for this
700
701     * Moose::Meta::Class
702       - fixed issue where extending metaclasses with
703         roles would blow up. Thanks to Aankhen`` for
704         finding this insidious error, and it's solution.
705
706     ~~ lots of spelling and grammer fixes in the docs,
707        many many thanks to rlb3 and Aankhen for these :)
708
709 0.20 Friday, April 6th, 2007
710     >> I messed up the SKIP logic in one test
711        so this release is just to fix that.
712
713     * Moose
714       - 'has' now also accepts an ARRAY ref
715         to create multiple attrs (see docs)
716         (thanks to konobi for this)
717          - added tests and docs
718
719 0.19 Thurs. April 5th, 2007
720     ~~ More documentation updates ~~
721
722     * Moose::Util::TypeConstraints
723       - 'type' now supports messages as well
724         thanks to phaylon for finding this
725         - added tests for this
726       - added &list_all_type_constraints and
727         &list_all_builtin_type_constraints
728         functions to facilitate introspection.
729
730     * Moose::Meta::Attribute
731       - fixed regexp 'handles' declarations
732         to build the list of delegated methods
733         correctly (and not override important
734         things like &new) thanks to ashleyb
735         for finding this
736         - added tests and docs for this
737       - added the 'documentation' attributes
738         so that you can actually document your
739         attributes and inspect them through the
740         meta-object.
741         - added tests and docs for this
742
743     * Moose::Meta::Class
744       - when loading custom attribute metaclasses
745         it will first look in for the class in the
746         Moose::Meta::Attribute::Custom::$name, and
747         then default to just loading $name.
748         - added tests and docs for this
749
750     * Moose::Meta::TypeConstraint
751       - type constraints now stringify to their names.
752         - added test for this
753
754     * misc.
755       - added tests to assure we work with Module::Refresh
756       - added stricter test skip logic in the Moose POOP
757         test, ask Rob Kinyon why.
758         - *cough* DBM::Deep 1.0 backwards compatability sucks *cough* ;)
759
760 0.18 Sat. March 10, 2007
761     ~~ Many, many documentation updates ~~
762
763     * misc.
764       - We now use Class::MOP::load_class to
765         load all classes.
766       - added tests to show types and subtypes
767         working with Declare::Constraints::Simple
768         and Test::Deep as constraint engines.
769
770 0.18_001
771     !! You must have Class::MOP 0.37_001  !!
772     !! for this developer release to work !!
773
774     This release was primarily adding the immutable
775     feature to Moose. An immutable class is one which
776     you promise not to alter. When you set the class
777     as immutable it will perform various bits of
778     memoization and inline certain part of the code
779     (constructors, destructors and accessors). This
780     minimizes (and in some cases totally eliminates)
781     one of Moose's biggest performance hits. This
782     feature is not on by default, and is 100% optional.
783     It has several configurable bits as well, so you
784     can pick and choose to your specific needs.
785
786     The changes involved in this were fairly wide and
787     highly specific, but 100% backwards compatible, so
788     I am not going to enumerate them here. If you are
789     truely interested in what was changed, please do
790     a diff :)
791
792 0.17 Tues. Nov. 14, 2006
793     * Moose::Meta::Method::Accessor
794       - bugfix for read-only accessors which
795         are have a type constraint and lazy.
796         Thanks to chansen for finding it.
797
798 0.16 Tues. Nov. 14, 2006
799     ++ NOTE ++
800     There are some speed improvements in this release,
801     but they are only the begining, so stay tuned.
802
803     * Moose::Object
804       - BUILDALL and DEMOLISHALL no longer get
805         called unless they actually need to be.
806         This gave us a signifigant speed boost
807         for the cases when there is no BUILD or
808         DEMOLISH method present.
809
810     * Moose::Util::TypeConstraints
811     * Moose::Meta::TypeConstraint
812       - added an 'optimize_as' option to the
813         type constraint, which allows for a
814         hand optimized version of the type
815         constraint to be used when possible.
816       - Any internally created type constraints
817         now provide an optimized version as well.
818
819 0.15 Sun. Nov. 5, 2006
820     ++ NOTE ++
821     This version of Moose *must* have Class::MOP 0.36 in order
822     to work correctly. A number of small internal tweaks have
823     been made in order to be compatible with that release.
824
825     * Moose::Util::TypeConstraints
826       - added &unimport so that you can clean out
827         your class namespace of these exported
828         keywords
829
830     * Moose::Meta::Class
831       - fixed minor issue which occasionally
832         comes up during global destruction
833         (thanks omega)
834       - moved Moose::Meta::Method::Overriden into
835         its own file.
836
837     * Moose::Meta::Role
838       - moved Moose::Meta::Role::Method into
839         its own file.
840
841     * Moose::Meta::Attribute
842       - changed how we do type checks so that
843         we reduce the overall cost, but still
844         retain correctness.
845        *** API CHANGE ***
846       - moved accessor generation methods to
847         Moose::Meta::Method::Accessor to
848         conform to the API changes from
849         Class::MOP 0.36
850
851     * Moose::Meta::TypeConstraint
852       - changed how constraints are compiled
853         so that we do less recursion and more
854         iteration. This makes the type check
855         faster :)
856       - moved Moose::Meta::TypeConstraint::Union
857         into its own file
858
859     * Moose::Meta::Method::Accessor
860       - created this from methods formerly found in
861         Moose::Meta::Attribute
862
863     * Moose::Meta::Role::Method
864       - moved this from Moose::Meta::Role
865
866     * Moose::Meta::Method::Overriden
867       - moved this from Moose::Meta::Class
868
869     * Moose::Meta::TypeConstraint::Union
870       - moved this from Moose::Meta::TypeConstraint
871
872 0.14 Mon. Oct. 9, 2006
873
874     * Moose::Meta::Attribute
875       - fixed lazy attributes which were not getting
876         checked with the type constraint (thanks ashley)
877         - added tests for this
878       - removed the over-enthusiastic DWIMery of the
879         automatic ArrayRef and HashRef defaults, it
880         broke predicates in an ugly way.
881         - removed tests for this
882
883 0.13 Sat. Sept. 30, 2006
884     ++ NOTE ++
885     This version of Moose *must* have Class::MOP 0.35 in order
886     to work correctly. A number of small internal tweaks have
887     been made in order to be compatible with that release.
888
889     * Moose
890       - Removed the use of UNIVERSAL::require to be a better
891         symbol table citizen and remove a dependency
892         (thanks Adam Kennedy)
893
894       **~~ removed experimental & undocumented feature ~~**
895       - commented out the 'method' and 'self' keywords, see the
896         comments for more info.
897
898     * Moose::Cookbook
899       - added a FAQ and WTF files to document frequently
900         asked questions and common problems
901
902     * Moose::Util::TypeConstraints
903       - added GlobRef and FileHandle type constraint
904         - added tests for this
905
906     * Moose::Meta::Attribute
907       - if your attribute 'isa' ArrayRef of HashRef, and you have
908         not explicitly set a default, then make the default DWIM.
909         This will also work for subtypes of ArrayRef and HashRef
910         as well.
911       - you can now auto-deref subtypes of ArrayRef or HashRef too.
912         - new test added for this (thanks to ashley)
913
914     * Moose::Meta::Role
915       - added basic support for runtime role composition
916         but this is still *highly experimental*, so feedback
917         is much appreciated :)
918         - added tests for this
919
920     * Moose::Meta::TypeConstraint
921       - the type constraint now handles the coercion process
922         through delegation, this is to support the coercion
923         of unions
924
925     * Moose::Meta::TypeConstraint::Union
926       - it is now possible for coercions to be performed
927         on a type union
928         - added tests for this (thanks to konobi)
929
930     * Moose::Meta::TypeCoercion
931       - properly capturing error when type constraint
932         is not found
933
934     * Build.PL
935       - Scalar::Util 1.18 is bad on Win32, so temporarily
936         only require version 1.17 for Win32 and cygwin.
937         (thanks Adam Kennedy)
938
939 0.12 Sat. Sept. 1, 2006
940     * Moose::Cookbook
941       - Recipe5 (subtypes & coercion) has been written
942
943     * Moose
944       - fixed "bad meta" error message to be more descriptive
945       - fixed &unimport to not remove the &inner and &super
946         keywords because we need to localize them.
947       - fixed number of spelling/grammer issues, thanks Theory :)
948
949       **~~ experimental & undocumented feature ~~**
950       - added the method and self keywords, they are basically
951         just sugar, and they may not stay around.
952
953     * Moose::Object
954       - added &dump method to easily Data::Dumper
955         an object
956
957     * Moose::Meta::TypeConstraint
958       - added the &is_a_type_of method to check both the current
959         and the subtype of a method (similar to &isa with classes)
960
961     * Moose::Meta::Role
962       - this is now a subclass of Class::MOP::Module, and no longer
963         creates the _role_meta ugliness of before.
964         - fixed tests to reflect this change
965
966 0.11 Wed. July 12, 2006
967     * Moose
968       - added an &unimport method to remove all the keywords
969         that Moose will import, simply add 'no Moose' to the
970         bottom of your class file.
971
972     * t/
973       - fixed some test failures caused by a forgotten test
974         dependency.
975
976 0.10 Thurs. July 6, 2006
977     * Moose
978       - improved error message when loading modules so
979         it is less confusing when you load a role.
980       - added &calculate_all_roles method to
981         Moose::Meta::Class and Moose::Meta::Role
982
983     NOTE:
984     This module has been tested against Class::MOP 0.30
985     but it does not yet utilize the optimizations
986     it makes available. Stay tuned for that ;)
987
988 0.09_03 Fri. June 23, 2006
989     ++ DEVELOPER RELEASE ++
990     * Moose
991       - 'use strict' and 'use warnings' are no longer
992          needed in Moose classes, Moose itself will
993          turn them on for you.
994          - added tests for this
995       - moved code from exported subs to private methods
996         in Moose::Meta::Class
997
998     * Moose::Role
999       - as with Moose, strict and warnings are
1000         automatically turned on for you.
1001          - added tests for this
1002
1003     * Moose::Meta::Role
1004       - now handles an edge case for override errors
1005         - added tests for this
1006       - added some more edge case tests
1007
1008 0.09_02 Tues. May 16, 2006
1009     ++ DEVELOPER RELEASE ++
1010     * Moose
1011       - added prototypes to the exported subs
1012       - updated docs
1013
1014     * Moose::Role
1015       - added prototypes to the exported subs
1016       - updated docs
1017
1018     * Moose::Util::TypeConstraints
1019       - cleaned up prototypes for the subs
1020       - updated docs
1021
1022 0.09_01 Fri. May 12, 2006
1023     ++ DEVELOPER RELEASE ++
1024       - This release works in combination with
1025         Class::MOP 0.29_01, it is a developer
1026         release because it uses the a new
1027         instance sub-protocol and a fairly
1028         complete Role implementation. It has
1029         not yet been optimized, so it slower
1030         the the previous CPAN version. This
1031         release also lacks good updated docs,
1032         the official release will have updated docs.
1033
1034     * Moose
1035       - refactored the keyword exports
1036         - 'with' now checks Role validaity and
1037           accepts more than one Role at a time
1038         - 'extends' makes metaclass adjustments as
1039            needed to ensure metaclass compatability
1040
1041     * Moose::Role
1042       - refactored the keyword exports
1043         - 'with' now checks Role validaity and
1044           accepts more than one Role at a time
1045
1046     * Moose::Util::TypeConstraints
1047       - added the 'enum' keyword for simple
1048         string enumerations which can be used as
1049         type constraints
1050         - see example of usage in t/202_example.t
1051
1052     * Moose::Object
1053       - more careful checking of params to new()
1054
1055     * Moose::Meta::Role
1056       - much work done on the role composition
1057         - many new tests for conflict detection
1058           and composition edge cases
1059         - not enough documentation, I suggest
1060           looking at the tests
1061
1062     * Moose::Meta::Instance
1063       - added new Instance metaclass to support
1064         the new Class::MOP instance protocol
1065
1066     * Moose::Meta::Class
1067       - some small changes to support the new
1068         instance protocol
1069       - some small additions to support Roles
1070
1071     * Moose::Meta::Attribute
1072       - some improvements to the accessor generation code
1073         by nothingmuch
1074       - some small changes to support the new
1075         instance protocol
1076       - (still somewhat) experimental delegation support
1077         with the 'handles' option
1078         - added several tests for this
1079         - no docs for this yet
1080
1081 0.05 Thurs. April 27, 2006
1082     * Moose
1083       - keywords are now exported with Sub::Exporter
1084         thanks to chansen for this commit
1085       - has keyword now takes a 'metaclass' option
1086         to support custom attribute meta-classes
1087         on a per-attribute basis
1088         - added tests for this
1089       - the 'has' keyword not accepts inherited slot
1090         specifications (has '+foo'). This is still an
1091         experimental feature and probably not finished
1092         see t/038_attribute_inherited_slot_specs.t for
1093         more details, or ask about it on #moose
1094         - added tests for this
1095
1096     * Moose::Role
1097       - keywords are now exported with Sub::Exporter
1098
1099     * Moose::Utils::TypeConstraints
1100       - reorganized the type constraint hierarchy, thanks
1101         to nothingmuch and chansen for his help and advice
1102         on this
1103         - added some tests for this
1104       - keywords are now exported with Sub::Exporter
1105         thanks to chansen for this commit
1106
1107     * Moose::Meta::Class
1108       - due to changes in Class::MOP, we had to change
1109         construct_instance (for the better)
1110
1111     * Moose::Meta::Attribute
1112       - due to changes in Class::MOP, we had to add the
1113         initialize_instance_slot method (it's a good thing)
1114
1115     * Moose::Meta::TypeConstraint
1116       - added type constraint unions
1117         - added tests for this
1118       - added the is_subtype_of predicate method
1119         - added tests for this
1120
1121 0.04 Sun. April 16th, 2006
1122     * Moose::Role
1123       - Roles can now consume other roles
1124         - added tests for this
1125       - Roles can specify required methods now with
1126         the requires() keyword
1127         - added tests for this
1128
1129     * Moose::Meta::Role
1130       - ripped out much of it's guts ,.. much cleaner now
1131       - added required methods and correct handling of
1132         them in apply() for both classes and roles
1133         - added tests for this
1134       - no longer adds a does() method to consuming classes
1135         it relys on the one in Moose::Object
1136       - added roles attribute and some methods to support
1137         roles consuming roles
1138
1139     * Moose::Meta::Attribute
1140       - added support for triggers on attributes
1141         - added tests for this
1142       - added support for does option on an attribute
1143         - added tests for this
1144
1145     * Moose::Meta::Class
1146       - added support for attribute triggers in the
1147         object construction
1148         - added tests for this
1149
1150     * Moose
1151       - Moose no longer creates a subtype for your class
1152         if a subtype of the same name already exists, this
1153         should DWIM in 99.9999% of all cases
1154
1155     * Moose::Util::TypeConstraints
1156       - fixed bug where incorrect subtype conflicts were
1157         being reported
1158         - added test for this
1159
1160     * Moose::Object
1161       - this class can now be extended with 'use base' if
1162         you need it, it properly loads the metaclass class now
1163         - added test for this
1164
1165 0.03_02 Wed. April 12, 2006
1166     * Moose
1167       - you must now explictly use Moose::Util::TypeConstraints
1168         it no longer gets exported for you automatically
1169
1170     * Moose::Object
1171       - new() now accepts hash-refs as well as key/value lists
1172       - added does() method to check for Roles
1173         - added tests for this
1174
1175     * Moose::Meta::Class
1176       - added roles attribute along with the add_role() and
1177         does_role() methods
1178         - added tests for this
1179
1180     * Moose::Meta::Role
1181       - now adds a does() method to consuming classes
1182         which tests the class's hierarchy for roles
1183         - added tests for this
1184
1185 0.03_01 Mon. April 10, 2006
1186     * Moose::Cookbook
1187       - added new Role recipe (no content yet, only code)
1188
1189     * Moose
1190       - added 'with' keyword for Role support
1191         - added test and docs for this
1192       - fixed subtype quoting bug
1193         - added test for this
1194
1195     * Moose::Role
1196       - Roles for Moose
1197         - added test and docs
1198
1199     * Moose::Util::TypeConstraints
1200       - added the message keyword to add custom
1201         error messages to type constraints
1202
1203     * Moose::Meta::Role
1204       - the meta role to support Moose::Role
1205         - added tests and docs
1206
1207     * Moose::Meta::Class
1208       - moved a number of things from Moose.pm
1209         to here, they should have been here
1210         in the first place
1211
1212     * Moose::Meta::Attribute
1213       - moved the attribute option macros here
1214         instead of putting them in Moose.pm
1215
1216     * Moose::Meta::TypeConstraint
1217       - added the message attributes and the
1218         validate method
1219         - added tests and docs for this
1220
1221 0.03 Thurs. March 30, 2006
1222     * Moose::Cookbook
1223       - added the Moose::Cookbook with 5 recipes,
1224         describing all the stuff Moose can do.
1225
1226     * Moose
1227       - fixed an issue with &extends super class loading
1228         it now captures errors and deals with inline
1229         packages correctly (bug found by mst, solution
1230         stolen from alias)
1231       - added super/override & inner/augment features
1232         - added tests and docs for these
1233
1234     * Moose::Object
1235       - BUILDALL now takes a reference of the %params
1236         that are passed to &new, and passes that to
1237         each BUILD as well.
1238
1239     * Moose::Util::TypeConstraints
1240       - Type constraints now survive runtime reloading
1241         - added test for this
1242
1243         * Moose::Meta::Class
1244           - fixed the way attribute defaults are handled
1245             during instance construction (bug found by chansen)
1246
1247     * Moose::Meta::Attribute
1248       - read-only attributes now actually enforce their
1249         read-only-ness (this corrected in Class::MOP as
1250         well)
1251
1252 0.02 Tues. March 21, 2006
1253     * Moose
1254       - many more tests, fixing some bugs and
1255         edge cases
1256       - &extends now loads the base module with
1257         UNIVERSAL::require
1258         - added UNIVERSAL::require to the
1259           dependencies list
1260       ** API CHANGES **
1261       - each new Moose class will also create
1262         and register a subtype of Object which
1263         correspond to the new Moose class.
1264       - the 'isa' option in &has now only
1265         accepts strings, and will DWIM in
1266         almost all cases
1267
1268     * Moose::Util::TypeConstraints
1269       - added type coercion features
1270         - added tests for this
1271         - added support for this in attributes
1272           and instance construction
1273       ** API CHANGES **
1274       - type construction no longer creates a
1275         function, it registers the type instead.
1276         - added several functions to get the
1277           registered types
1278
1279     * Moose::Object
1280       - BUILDALL and DEMOLISHALL were broken
1281         because of a mis-named hash key, Whoops :)
1282
1283     * Moose::Meta::Attribute
1284       - adding support for coercion in the
1285         autogenerated accessors
1286
1287     * Moose::Meta::Class
1288       - adding support for coercion in the
1289         instance construction
1290
1291     * Moose::Meta::TypeConstraint
1292     * Moose::Meta::TypeCoercion
1293           - type constraints and coercions are now
1294             full fledges meta-objects
1295
1296 0.01 Wed. March 15, 2006
1297     - Moooooooooooooooooose!!!