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