a5fa13bee46ea4c709f62d0cd1669428de2a1e36
[gitmo/Moose.git] / Changes
1 Revision history for Perl extension Moose
2
3 0.26
4     * Moose
5       - added all the meta classes to the immutable list and 
6         set it to inline the accessors
7
8     * Moose::Meta::TypeConstraint
9       - some minor adjustments to make subclassing easier
10       
11     * Moose::Meta::TypeConstraint::Union
12       - this is not a subclass of Moose::Meta::TypeConstraint      
13         which is more correct
14       
15     * Moose::Meta::TypeConstraint::Container
16       - added this module (taken from MooseX::AttributeHelpers)
17         to help construct nested collection types
18         - added tests for this
19
20 0.25 Mon. Aug. 13, 2007
21     * Moose
22       - Documentation update to reference Moose::Util::TypeConstraints 
23         under 'isa' in 'has' for how to define a new type 
24         (thanks to shlomif).
25
26     * Moose::Meta::Attribute
27       - required attributes now will no longer accept undef 
28         from the constructor, even if there is a default and lazy
29         - added tests for this
30       - default subroutines must return a value which passes the 
31         type constraint
32         - added tests for this
33     
34     * Moose::Meta::Attribute
35     * Moose::Meta::Method::Constructor
36     * Moose::Meta::Method::Accessor        
37       - type-constraint tests now handle overloaded objects correctly
38         in the error message
39         - added tests for this (thanks to EvanCarroll) 
40
41     * Moose::Meta::TypeConstraint::Union
42       - added (has_)hand_optimized_constraint to this class so that 
43         it behaves as the regular Moose::Meta::TypeConstraint does.
44
45     * Moose::Meta::Role
46       - large refactoring of this code
47       - added several more tests 
48         - tests for subtle conflict resolition issues 
49           added, but not currently running
50           (thanks to kolibre)
51
52     * Moose::Cookbook::Recipe7 
53       - added new recipe for augment/inner functionality 
54         (still in progress)
55         - added test for this
56
57     * Moose::Spec::Role
58       - a formal definition of roles (still in progress)
59
60     * Moose::Util
61       - utilities for easier working with Moose classes
62         - added tests for these
63
64     * Test::Moose
65       - This contains Moose specific test functions
66         - added tests for these
67
68 0.24 Tues. July 3, 2007
69     ~ Some doc updates/cleanup ~
70
71     * Moose::Meta::Attribute
72       - added support for roles to be given as parameters 
73         to the 'handles' option.
74         - added tests and docs for this
75       - the has '+foo' attribute form now accepts changes to 
76         the lazy option, and the addition of a handles option
77         (but not changing the handles option)
78         - added tests and docs for this
79
80     * Moose::Meta::Role
81       - required methods are now fetched using find_method_by_name
82         so that required methods can come from superclasses
83         - adjusted tests for this
84
85 0.23 Mon. June 18, 2007
86     * Moose::Meta::Method::Constructor
87       - fix inlined constructor for hierarchy with multiple BUILD methods (mst)
88     * Moose::Meta::Class
89       - Modify make_immutable to work with the new Class::MOP immutable
90         mechanism + POD + very basic test (groditi)
91     * Moose::Meta::Attribute
92       - Fix handles to use goto() so that caller() comes out properly on 
93         the other side (perigrin)
94
95 0.22 Thurs. May 31, 2007
96     * Moose::Util::TypeConstraints
97       - fix for prototype undeclared issue when Moose::Util::TypeConstraints 
98         loaded before consumers (e.g. Moose::Meta::Attribute) by predeclaring
99         prototypes for functions
100       - added the ClassName type constraint, this checks for strings 
101         which will respond true to ->isa(UNIVERSAL). 
102         - added tests and docs for this
103       - subtyping just in name now works correctly by making the 
104         default for where be { 1 }
105         - added test for this 
106
107     * Moose::Meta::Method::Accessor
108       - coerce and lazy now work together correctly, thanks to 
109         merlyn for finding this bug
110         - tests added for this
111       - fix reader presedence bug in Moose::Meta::Attribute + tests
112
113     * Moose::Object
114       - Foo->new(undef) now gets ignored, it is assumed you meant to pass
115         a HASH-ref and missed. This produces better error messages then 
116         having it die cause undef is not a HASH.
117         - added tests for this
118
119 0.21 Thursday, May 2nd, 2007
120     * Moose
121       - added SUPER_SLOT and INNER_SLOT class hashes to support unimport
122       - modified unimport to remove super and inner along with the rest
123         - altered unimport tests to handle this
124
125     * Moose::Role
126       - altered super export to populate SUPER_SLOT
127
128     * Moose::Meta::Class
129       - altered augment and override modifier application to use *_SLOT
130         - modified tests for these to unimport one test class each to test
131
132     * Moose::Meta::Role
133       - fixed issue where custom attribute metaclasses
134         where not handled correctly in roles
135         - added tests for this
136     
137     * Moose::Meta::Class
138       - fixed issue where extending metaclasses with 
139         roles would blow up. Thanks to Aankhen`` for
140         finding this insidious error, and it's solution.
141         
142     ~~ lots of spelling and grammer fixes in the docs, 
143        many many thanks to rlb3 and Aankhen for these :)
144
145 0.20 Friday, April 6th, 2007
146     >> I messed up the SKIP logic in one test
147        so this release is just to fix that.
148
149     * Moose
150       - 'has' now also accepts an ARRAY ref
151         to create multiple attrs (see docs)
152         (thanks to konobi for this)
153          - added tests and docs 
154
155 0.19 Thurs. April 5th, 2007
156     ~~ More documentation updates ~~
157
158     * Moose::Util::TypeConstraints
159       - 'type' now supports messages as well
160         thanks to phaylon for finding this
161         - added tests for this
162       - added &list_all_type_constraints and 
163         &list_all_builtin_type_constraints
164         functions to facilitate introspection.
165     
166     * Moose::Meta::Attribute
167       - fixed regexp 'handles' declarations 
168         to build the list of delegated methods
169         correctly (and not override important 
170         things like &new) thanks to ashleyb 
171         for finding this
172         - added tests and docs for this
173       - added the 'documentation' attributes
174         so that you can actually document your 
175         attributes and inspect them through the 
176         meta-object.
177         - added tests and docs for this
178
179     * Moose::Meta::Class
180       - when loading custom attribute metaclasses
181         it will first look in for the class in the 
182         Moose::Meta::Attribute::Custom::$name, and 
183         then default to just loading $name.
184         - added tests and docs for this
185
186     * Moose::Meta::TypeConstraint
187       - type constraints now stringify to their names.
188         - added test for this
189
190     * misc.
191       - added tests to assure we work with Module::Refresh 
192       - added stricter test skip logic in the Moose POOP 
193         test, ask Rob Kinyon why.
194         - *cough* DBM::Deep 1.0 backwards compatability sucks *cough* ;)
195
196 0.18 Sat. March 10, 2007
197     ~~ Many, many documentation updates ~~
198
199     * misc.
200       - We now use Class::MOP::load_class to 
201         load all classes.    
202       - added tests to show types and subtypes 
203         working with Declare::Constraints::Simple
204         and Test::Deep as constraint engines.
205
206 0.18_001
207     !! You must have Class::MOP 0.37_001  !!
208     !! for this developer release to work !!
209
210     This release was primarily adding the immutable
211     feature to Moose. An immutable class is one which 
212     you promise not to alter. When you set the class 
213     as immutable it will perform various bits of 
214     memoization and inline certain part of the code
215     (constructors, destructors and accessors). This 
216     minimizes (and in some cases totally eliminates)
217     one of Moose's biggest performance hits. This 
218     feature is not on by default, and is 100% optional.
219     It has several configurable bits as well, so you 
220     can pick and choose to your specific needs.
221     
222     The changes involved in this were fairly wide and 
223     highly specific, but 100% backwards compatible, so 
224     I am not going to enumerate them here. If you are 
225     truely interested in what was changed, please do 
226     a diff :)
227
228 0.17 Tues. Nov. 14, 2006
229     * Moose::Meta::Method::Accessor
230       - bugfix for read-only accessors which 
231         are have a type constraint and lazy.
232         Thanks to chansen for finding it.
233
234 0.16 Tues. Nov. 14, 2006
235     ++ NOTE ++
236     There are some speed improvements in this release, 
237     but they are only the begining, so stay tuned.
238     
239     * Moose::Object
240       - BUILDALL and DEMOLISHALL no longer get 
241         called unless they actually need to be.
242         This gave us a signifigant speed boost
243         for the cases when there is no BUILD or 
244         DEMOLISH method present.
245         
246     * Moose::Util::TypeConstraints
247     * Moose::Meta::TypeConstraint
248       - added an 'optimize_as' option to the 
249         type constraint, which allows for a
250         hand optimized version of the type 
251         constraint to be used when possible.
252       - Any internally created type constraints
253         now provide an optimized version as well.
254
255 0.15 Sun. Nov. 5, 2006
256     ++ NOTE ++
257     This version of Moose *must* have Class::MOP 0.36 in order 
258     to work correctly. A number of small internal tweaks have 
259     been made in order to be compatible with that release.
260
261     * Moose::Util::TypeConstraints
262       - added &unimport so that you can clean out 
263         your class namespace of these exported 
264         keywords
265     
266     * Moose::Meta::Class
267       - fixed minor issue which occasionally 
268         comes up during global destruction 
269         (thanks omega)
270       - moved Moose::Meta::Method::Overriden into 
271         its own file.
272       
273     * Moose::Meta::Role      
274       - moved Moose::Meta::Role::Method into 
275         its own file.
276               
277     * Moose::Meta::Attribute
278       - changed how we do type checks so that 
279         we reduce the overall cost, but still 
280         retain correctness.
281        *** API CHANGE ***
282       - moved accessor generation methods to 
283         Moose::Meta::Method::Accessor to 
284         conform to the API changes from 
285         Class::MOP 0.36
286           
287     * Moose::Meta::TypeConstraint
288       - changed how constraints are compiled
289         so that we do less recursion and more
290         iteration. This makes the type check 
291         faster :)
292       - moved Moose::Meta::TypeConstraint::Union
293         into its own file
294     
295     * Moose::Meta::Method::Accessor
296       - created this from methods formerly found in 
297         Moose::Meta::Attribute
298     
299     * Moose::Meta::Role::Method
300       - moved this from Moose::Meta::Role
301           
302     * Moose::Meta::Method::Overriden
303       - moved this from Moose::Meta::Class
304       
305     * Moose::Meta::TypeConstraint::Union
306       - moved this from Moose::Meta::TypeConstraint
307
308 0.14 Mon. Oct. 9, 2006
309
310     * Moose::Meta::Attribute
311       - fixed lazy attributes which were not getting 
312         checked with the type constraint (thanks ashley)
313         - added tests for this
314       - removed the over-enthusiastic DWIMery of the 
315         automatic ArrayRef and HashRef defaults, it 
316         broke predicates in an ugly way.
317         - removed tests for this
318
319 0.13 Sat. Sept. 30, 2006
320     ++ NOTE ++
321     This version of Moose *must* have Class::MOP 0.35 in order 
322     to work correctly. A number of small internal tweaks have 
323     been made in order to be compatible with that release.
324
325     * Moose
326       - Removed the use of UNIVERSAL::require to be a better
327         symbol table citizen and remove a dependency 
328         (thanks Adam Kennedy)
329
330       **~~ removed experimental & undocumented feature ~~**
331       - commented out the 'method' and 'self' keywords, see the 
332         comments for more info.
333
334     * Moose::Cookbook
335       - added a FAQ and WTF files to document frequently 
336         asked questions and common problems
337         
338     * Moose::Util::TypeConstraints
339       - added GlobRef and FileHandle type constraint
340         - added tests for this
341         
342     * Moose::Meta::Attribute
343       - if your attribute 'isa' ArrayRef of HashRef, and you have
344         not explicitly set a default, then make the default DWIM.
345         This will also work for subtypes of ArrayRef and HashRef 
346         as well.
347       - you can now auto-deref subtypes of ArrayRef or HashRef too.
348         - new test added for this (thanks to ashley)
349         
350     * Moose::Meta::Role
351       - added basic support for runtime role composition
352         but this is still *highly experimental*, so feedback 
353         is much appreciated :)
354         - added tests for this
355
356     * Moose::Meta::TypeConstraint
357       - the type constraint now handles the coercion process
358         through delegation, this is to support the coercion 
359         of unions
360         
361     * Moose::Meta::TypeConstraint::Union
362       - it is now possible for coercions to be performed 
363         on a type union
364         - added tests for this (thanks to konobi)
365
366     * Moose::Meta::TypeCoercion
367       - properly capturing error when type constraint 
368         is not found
369
370     * Build.PL
371       - Scalar::Util 1.18 is bad on Win32, so temporarily
372         only require version 1.17 for Win32 and cygwin.
373         (thanks Adam Kennedy)        
374
375 0.12 Sat. Sept. 1, 2006
376     * Moose::Cookbook
377       - Recipe5 (subtypes & coercion) has been written
378       
379     * Moose
380       - fixed "bad meta" error message to be more descriptive      
381       - fixed &unimport to not remove the &inner and &super  
382         keywords because we need to localize them.
383       - fixed number of spelling/grammer issues, thanks Theory :)
384       
385       **~~ experimental & undocumented feature ~~**
386       - added the method and self keywords, they are basically 
387         just sugar, and they may not stay around.
388         
389     * Moose::Object
390       - added &dump method to easily Data::Dumper 
391         an object
392         
393     * Moose::Meta::TypeConstraint
394       - added the &is_a_type_of method to check both the current
395         and the subtype of a method (similar to &isa with classes)
396
397     * Moose::Meta::Role
398       - this is now a subclass of Class::MOP::Module, and no longer
399         creates the _role_meta ugliness of before. 
400         - fixed tests to reflect this change
401     
402 0.11 Wed. July 12, 2006
403     * Moose
404       - added an &unimport method to remove all the keywords
405         that Moose will import, simply add 'no Moose' to the 
406         bottom of your class file. 
407         
408     * t/
409       - fixed some test failures caused by a forgotten test 
410         dependency.
411
412 0.10 Thurs. July 6, 2006
413     * Moose
414       - improved error message when loading modules so
415         it is less confusing when you load a role.
416       - added &calculate_all_roles method to 
417         Moose::Meta::Class and Moose::Meta::Role
418         
419     NOTE:
420     This module has been tested against Class::MOP 0.30
421     but it does not yet utilize the optimizations 
422     it makes available. Stay tuned for that ;)
423     
424 0.09_03 Fri. June 23, 2006
425     ++ DEVELOPER RELEASE ++
426     * Moose
427       - 'use strict' and 'use warnings' are no longer
428          needed in Moose classes, Moose itself will 
429          turn them on for you.
430          - added tests for this
431       - moved code from exported subs to private methods
432         in Moose::Meta::Class
433          
434     * Moose::Role
435       - as with Moose, strict and warnings are 
436         automatically turned on for you.
437          - added tests for this        
438         
439     * Moose::Meta::Role
440       - now handles an edge case for override errors
441         - added tests for this
442       - added some more edge case tests
443
444 0.09_02 Tues. May 16, 2006
445     ++ DEVELOPER RELEASE ++
446     * Moose
447       - added prototypes to the exported subs
448       - updated docs
449       
450     * Moose::Role
451       - added prototypes to the exported subs      
452       - updated docs
453       
454     * Moose::Util::TypeConstraints
455       - cleaned up prototypes for the subs      
456       - updated docs      
457
458 0.09_01 Fri. May 12, 2006
459     ++ DEVELOPER RELEASE ++
460       - This release works in combination with 
461         Class::MOP 0.29_01, it is a developer 
462         release because it uses the a new 
463         instance sub-protocol and a fairly
464         complete Role implementation. It has 
465         not yet been optimized, so it slower
466         the the previous CPAN version. This 
467         release also lacks good updated docs, 
468         the official release will have updated docs.
469
470     * Moose 
471       - refactored the keyword exports
472         - 'with' now checks Role validaity and 
473           accepts more than one Role at a time
474         - 'extends' makes metaclass adjustments as 
475            needed to ensure metaclass compatability
476           
477     * Moose::Role
478       - refactored the keyword exports
479         - 'with' now checks Role validaity and 
480           accepts more than one Role at a time
481           
482     * Moose::Util::TypeConstraints
483       - added the 'enum' keyword for simple 
484         string enumerations which can be used as 
485         type constraints
486         - see example of usage in t/202_example.t
487         
488     * Moose::Object
489       - more careful checking of params to new()
490       
491     * Moose::Meta::Role
492       - much work done on the role composition
493         - many new tests for conflict detection 
494           and composition edge cases
495         - not enough documentation, I suggest 
496           looking at the tests    
497       
498     * Moose::Meta::Instance
499       - added new Instance metaclass to support 
500         the new Class::MOP instance protocol
501         
502     * Moose::Meta::Class
503       - some small changes to support the new 
504         instance protocol
505       - some small additions to support Roles
506         
507     * Moose::Meta::Attribute
508       - some improvements to the accessor generation code
509         by nothingmuch
510       - some small changes to support the new 
511         instance protocol
512       - (still somewhat) experimental delegation support 
513         with the 'handles' option
514         - added several tests for this
515         - no docs for this yet
516
517 0.05 Thurs. April 27, 2006
518     * Moose
519       - keywords are now exported with Sub::Exporter
520         thanks to chansen for this commit
521       - has keyword now takes a 'metaclass' option 
522         to support custom attribute meta-classes 
523         on a per-attribute basis
524         - added tests for this  
525       - the 'has' keyword not accepts inherited slot
526         specifications (has '+foo'). This is still an 
527         experimental feature and probably not finished
528         see t/038_attribute_inherited_slot_specs.t for 
529         more details, or ask about it on #moose
530         - added tests for this
531         
532     * Moose::Role
533       - keywords are now exported with Sub::Exporter
534
535     * Moose::Utils::TypeConstraints
536       - reorganized the type constraint hierarchy, thanks
537         to nothingmuch and chansen for his help and advice 
538         on this
539         - added some tests for this
540       - keywords are now exported with Sub::Exporter
541         thanks to chansen for this commit
542
543     * Moose::Meta::Class
544       - due to changes in Class::MOP, we had to change
545         construct_instance (for the better)
546         
547     * Moose::Meta::Attribute
548       - due to changes in Class::MOP, we had to add the 
549         initialize_instance_slot method (it's a good thing)
550         
551     * Moose::Meta::TypeConstraint
552       - added type constraint unions 
553         - added tests for this
554       - added the is_subtype_of predicate method
555         - added tests for this
556
557 0.04 Sun. April 16th, 2006
558     * Moose::Role
559       - Roles can now consume other roles
560         - added tests for this
561       - Roles can specify required methods now with 
562         the requires() keyword
563         - added tests for this
564
565     * Moose::Meta::Role
566       - ripped out much of it's guts ,.. much cleaner now
567       - added required methods and correct handling of 
568         them in apply() for both classes and roles
569         - added tests for this
570       - no longer adds a does() method to consuming classes 
571         it relys on the one in Moose::Object
572       - added roles attribute and some methods to support 
573         roles consuming roles
574
575     * Moose::Meta::Attribute
576       - added support for triggers on attributes
577         - added tests for this
578       - added support for does option on an attribute 
579         - added tests for this
580         
581     * Moose::Meta::Class
582       - added support for attribute triggers in the 
583         object construction
584         - added tests for this
585     
586     * Moose
587       - Moose no longer creates a subtype for your class 
588         if a subtype of the same name already exists, this 
589         should DWIM in 99.9999% of all cases
590         
591     * Moose::Util::TypeConstraints
592       - fixed bug where incorrect subtype conflicts were 
593         being reported
594         - added test for this
595         
596     * Moose::Object
597       - this class can now be extended with 'use base' if
598         you need it, it properly loads the metaclass class now
599         - added test for this
600
601 0.03_02 Wed. April 12, 2006
602     * Moose
603       - you must now explictly use Moose::Util::TypeConstraints
604         it no longer gets exported for you automatically
605         
606     * Moose::Object
607       - new() now accepts hash-refs as well as key/value lists
608       - added does() method to check for Roles
609         - added tests for this
610
611     * Moose::Meta::Class
612       - added roles attribute along with the add_role() and 
613         does_role() methods
614         - added tests for this 
615
616     * Moose::Meta::Role
617       - now adds a does() method to consuming classes 
618         which tests the class's hierarchy for roles
619         - added tests for this
620
621 0.03_01 Mon. April 10, 2006
622     * Moose::Cookbook
623       - added new Role recipe (no content yet, only code)
624       
625     * Moose
626       - added 'with' keyword for Role support
627         - added test and docs for this
628       - fixed subtype quoting bug
629         - added test for this 
630
631     * Moose::Role
632       - Roles for Moose
633         - added test and docs
634
635     * Moose::Util::TypeConstraints
636       - added the message keyword to add custom
637         error messages to type constraints        
638       
639     * Moose::Meta::Role
640       - the meta role to support Moose::Role
641         - added tests and docs
642         
643     * Moose::Meta::Class
644       - moved a number of things from Moose.pm 
645         to here, they should have been here 
646         in the first place
647
648     * Moose::Meta::Attribute
649       - moved the attribute option macros here
650         instead of putting them in Moose.pm
651
652     * Moose::Meta::TypeConstraint
653       - added the message attributes and the 
654         validate method
655         - added tests and docs for this
656
657 0.03 Thurs. March 30, 2006
658     * Moose::Cookbook
659       - added the Moose::Cookbook with 5 recipes, 
660         describing all the stuff Moose can do.
661
662     * Moose
663       - fixed an issue with &extends super class loading
664         it now captures errors and deals with inline 
665         packages correctly (bug found by mst, solution 
666         stolen from alias)
667       - added super/override & inner/augment features
668         - added tests and docs for these
669     
670     * Moose::Object
671       - BUILDALL now takes a reference of the %params 
672         that are passed to &new, and passes that to 
673         each BUILD as well.
674         
675     * Moose::Util::TypeConstraints
676       - Type constraints now survive runtime reloading
677         - added test for this
678
679         * Moose::Meta::Class
680           - fixed the way attribute defaults are handled 
681             during instance construction (bug found by chansen)
682
683     * Moose::Meta::Attribute
684       - read-only attributes now actually enforce their
685         read-only-ness (this corrected in Class::MOP as 
686         well)
687
688 0.02 Tues. March 21, 2006
689     * Moose
690       - many more tests, fixing some bugs and  
691         edge cases
692       - &extends now loads the base module with
693         UNIVERSAL::require 
694         - added UNIVERSAL::require to the 
695           dependencies list
696       ** API CHANGES **
697       - each new Moose class will also create 
698         and register a subtype of Object which 
699         correspond to the new Moose class.      
700       - the 'isa' option in &has now only 
701         accepts strings, and will DWIM in 
702         almost all cases
703     
704     * Moose::Util::TypeConstraints
705       - added type coercion features
706         - added tests for this
707         - added support for this in attributes 
708           and instance construction
709       ** API CHANGES **
710       - type construction no longer creates a 
711         function, it registers the type instead.
712         - added several functions to get the 
713           registered types 
714
715     * Moose::Object
716       - BUILDALL and DEMOLISHALL were broken 
717         because of a mis-named hash key, Whoops :)
718     
719     * Moose::Meta::Attribute
720       - adding support for coercion in the
721         autogenerated accessors
722         
723     * Moose::Meta::Class
724       - adding support for coercion in the
725         instance construction  
726
727     * Moose::Meta::TypeConstraint
728     * Moose::Meta::TypeCoercion
729           - type constraints and coercions are now 
730             full fledges meta-objects
731
732 0.01 Wed. March 15, 2006
733     - Moooooooooooooooooose!!!