1 Revision history for Perl extension Moose
4 * Moose::Meta::Attribute
5 - Added support for the new builder option (groditi)
6 - Added support for lazy_build option (groditi)
8 * Moose::Meta::Method::Accessor
9 - Added support for lazy_build option (groditi)
10 - Fix inline methods to work with corrected predicate
13 * Moose::Meta::Method::Constructor
14 - Added support for lazy_build option (groditi)
17 - tests for builder and lazy_build (groditi)
19 * fixing some misc. bits in the docs that
20 got mentioned on CPAN Forum & perlmonks
23 - fixed how required methods are handled
24 when they encounter overriden or modified
25 methods from a class (thanks to confound).
26 - added tests for this
28 * Moose::Util::TypeConstraint
29 - fixed the type notation parser so that
30 the | always creates a union and so is
31 no longer a valid type char (thanks to
32 konobi, mugwump and #moose for working
34 - added more tests for this
36 0.26 Thurs. Sept. 27, 2007
40 We now support parameterized collection types, such as:
41 ArrayRef[Int] # array or integers
42 HashRef[Object] # a hash with object values
43 They can also be nested:
44 ArrayRef[HashRef[RegExpr]] # an array of hashes with regexpr values
45 And work with the type unions as well:
46 ArrayRef[Int | Str] # array of integers of strings
48 * Better Framework Extendability
49 Moose.pm is now "extendable" such that it is now much
50 easier to extend the framework and add your own keywords
51 and customizations. See the "EXTENDING AND EMBEDDING MOOSE"
52 section of the Moose.pm docs.
55 In an effort to begin documenting some of the various
56 details of Moose as well as some common idioms, we have
57 created Moose::Cookbook::Snacks as a place to find
58 small (easily digestable) nuggets of Moose code.
61 ~ Several doc updates/cleanup thanks to castaway ~
63 - converted build system to use Module::Install instead of
64 Module::Build (thanks to jrockway)
67 - added all the meta classes to the immutable list and
68 set it to inline the accessors
69 - fix import to allow Sub::Exporter like { into => }
70 and { into_level => } (perigrin)
71 - exposed and documented init_meta() to allow better
72 embedding and extending of Moose (perigrin)
75 - complete re-organization of the test suite
76 - added some new tests as well
77 - finally re-enabled the Moose::POOP test since
78 the new version of DBM::Deep now works again
82 - fixed very odd and very nasty recursion bug with
84 - added tests for this (eilara)
86 * Moose::Meta::Attribute
87 Moose::Meta::Method::Constructor
88 Moose::Meta::Method::Accessor
89 - fixed issue with overload::Overloaded getting called
90 on non-blessed items. (RT #29269)
91 - added tests for this
93 * Moose::Meta::Method::Accessor
94 - fixed issue with generated accessor code making
95 assumptions about hash based classes (thanks to dexter)
97 * Moose::Coookbook::Snacks
98 - these are bits of documentation, not quite as big as
99 Recipes but which have no clear place in the module docs.
100 So they are Snacks! (horray for castaway++)
102 * Moose::Cookbook::Recipe4
103 - updated it to use the new ArrayRef[MyType] construct
104 - updated the accompanying test as well
106 +++ Major Refactor of the Type Constraint system +++
107 +++ with new features added as well +++
109 * Moose::Util::TypeConstraint
110 - no longer uses package variable to keep track of
111 the type constraints, now uses the an instance of
112 Moose::Meta::TypeConstraint::Registry to do it
113 - added more sophisticated type notation parsing
115 - added tests for this
117 * Moose::Meta::TypeConstraint
118 - some minor adjustments to make subclassing easier
119 - added the package_defined_in attribute so that we
120 can track where the type constraints are created
122 * Moose::Meta::TypeConstraint::Union
123 - this is now been refactored to be a subclass of
124 Moose::Meta::TypeConstraint
126 * Moose::Meta::TypeCoercion::Union
127 - this has been added to service the newly refactored
128 Moose::Meta::TypeConstraint::Union and is itself
129 a subclass of Moose::Meta::TypeCoercion
131 * Moose::Meta::TypeConstraint::Parameterized
132 - added this module (taken from MooseX::AttributeHelpers)
133 to help construct nested collection types
134 - added tests for this
136 * Moose::Meta::TypeConstraint::Registry
137 - added this class to keep track of type constraints
139 0.25 Mon. Aug. 13, 2007
141 - Documentation update to reference Moose::Util::TypeConstraints
142 under 'isa' in 'has' for how to define a new type
145 * Moose::Meta::Attribute
146 - required attributes now will no longer accept undef
147 from the constructor, even if there is a default and lazy
148 - added tests for this
149 - default subroutines must return a value which passes the
151 - added tests for this
153 * Moose::Meta::Attribute
154 * Moose::Meta::Method::Constructor
155 * Moose::Meta::Method::Accessor
156 - type-constraint tests now handle overloaded objects correctly
158 - added tests for this (thanks to EvanCarroll)
160 * Moose::Meta::TypeConstraint::Union
161 - added (has_)hand_optimized_constraint to this class so that
162 it behaves as the regular Moose::Meta::TypeConstraint does.
165 - large refactoring of this code
166 - added several more tests
167 - tests for subtle conflict resolition issues
168 added, but not currently running
171 * Moose::Cookbook::Recipe7
172 - added new recipe for augment/inner functionality
174 - added test for this
177 - a formal definition of roles (still in progress)
180 - utilities for easier working with Moose classes
181 - added tests for these
184 - This contains Moose specific test functions
185 - added tests for these
187 0.24 Tues. July 3, 2007
188 ~ Some doc updates/cleanup ~
190 * Moose::Meta::Attribute
191 - added support for roles to be given as parameters
192 to the 'handles' option.
193 - added tests and docs for this
194 - the has '+foo' attribute form now accepts changes to
195 the lazy option, and the addition of a handles option
196 (but not changing the handles option)
197 - added tests and docs for this
200 - required methods are now fetched using find_method_by_name
201 so that required methods can come from superclasses
202 - adjusted tests for this
204 0.23 Mon. June 18, 2007
205 * Moose::Meta::Method::Constructor
206 - fix inlined constructor for hierarchy with multiple BUILD methods (mst)
208 - Modify make_immutable to work with the new Class::MOP immutable
209 mechanism + POD + very basic test (groditi)
210 * Moose::Meta::Attribute
211 - Fix handles to use goto() so that caller() comes out properly on
212 the other side (perigrin)
214 0.22 Thurs. May 31, 2007
215 * Moose::Util::TypeConstraints
216 - fix for prototype undeclared issue when Moose::Util::TypeConstraints
217 loaded before consumers (e.g. Moose::Meta::Attribute) by predeclaring
218 prototypes for functions
219 - added the ClassName type constraint, this checks for strings
220 which will respond true to ->isa(UNIVERSAL).
221 - added tests and docs for this
222 - subtyping just in name now works correctly by making the
223 default for where be { 1 }
224 - added test for this
226 * Moose::Meta::Method::Accessor
227 - coerce and lazy now work together correctly, thanks to
228 merlyn for finding this bug
229 - tests added for this
230 - fix reader presedence bug in Moose::Meta::Attribute + tests
233 - Foo->new(undef) now gets ignored, it is assumed you meant to pass
234 a HASH-ref and missed. This produces better error messages then
235 having it die cause undef is not a HASH.
236 - added tests for this
238 0.21 Thursday, May 2nd, 2007
240 - added SUPER_SLOT and INNER_SLOT class hashes to support unimport
241 - modified unimport to remove super and inner along with the rest
242 - altered unimport tests to handle this
245 - altered super export to populate SUPER_SLOT
248 - altered augment and override modifier application to use *_SLOT
249 - modified tests for these to unimport one test class each to test
252 - fixed issue where custom attribute metaclasses
253 where not handled correctly in roles
254 - added tests for this
257 - fixed issue where extending metaclasses with
258 roles would blow up. Thanks to Aankhen`` for
259 finding this insidious error, and it's solution.
261 ~~ lots of spelling and grammer fixes in the docs,
262 many many thanks to rlb3 and Aankhen for these :)
264 0.20 Friday, April 6th, 2007
265 >> I messed up the SKIP logic in one test
266 so this release is just to fix that.
269 - 'has' now also accepts an ARRAY ref
270 to create multiple attrs (see docs)
271 (thanks to konobi for this)
272 - added tests and docs
274 0.19 Thurs. April 5th, 2007
275 ~~ More documentation updates ~~
277 * Moose::Util::TypeConstraints
278 - 'type' now supports messages as well
279 thanks to phaylon for finding this
280 - added tests for this
281 - added &list_all_type_constraints and
282 &list_all_builtin_type_constraints
283 functions to facilitate introspection.
285 * Moose::Meta::Attribute
286 - fixed regexp 'handles' declarations
287 to build the list of delegated methods
288 correctly (and not override important
289 things like &new) thanks to ashleyb
291 - added tests and docs for this
292 - added the 'documentation' attributes
293 so that you can actually document your
294 attributes and inspect them through the
296 - added tests and docs for this
299 - when loading custom attribute metaclasses
300 it will first look in for the class in the
301 Moose::Meta::Attribute::Custom::$name, and
302 then default to just loading $name.
303 - added tests and docs for this
305 * Moose::Meta::TypeConstraint
306 - type constraints now stringify to their names.
307 - added test for this
310 - added tests to assure we work with Module::Refresh
311 - added stricter test skip logic in the Moose POOP
312 test, ask Rob Kinyon why.
313 - *cough* DBM::Deep 1.0 backwards compatability sucks *cough* ;)
315 0.18 Sat. March 10, 2007
316 ~~ Many, many documentation updates ~~
319 - We now use Class::MOP::load_class to
321 - added tests to show types and subtypes
322 working with Declare::Constraints::Simple
323 and Test::Deep as constraint engines.
326 !! You must have Class::MOP 0.37_001 !!
327 !! for this developer release to work !!
329 This release was primarily adding the immutable
330 feature to Moose. An immutable class is one which
331 you promise not to alter. When you set the class
332 as immutable it will perform various bits of
333 memoization and inline certain part of the code
334 (constructors, destructors and accessors). This
335 minimizes (and in some cases totally eliminates)
336 one of Moose's biggest performance hits. This
337 feature is not on by default, and is 100% optional.
338 It has several configurable bits as well, so you
339 can pick and choose to your specific needs.
341 The changes involved in this were fairly wide and
342 highly specific, but 100% backwards compatible, so
343 I am not going to enumerate them here. If you are
344 truely interested in what was changed, please do
347 0.17 Tues. Nov. 14, 2006
348 * Moose::Meta::Method::Accessor
349 - bugfix for read-only accessors which
350 are have a type constraint and lazy.
351 Thanks to chansen for finding it.
353 0.16 Tues. Nov. 14, 2006
355 There are some speed improvements in this release,
356 but they are only the begining, so stay tuned.
359 - BUILDALL and DEMOLISHALL no longer get
360 called unless they actually need to be.
361 This gave us a signifigant speed boost
362 for the cases when there is no BUILD or
363 DEMOLISH method present.
365 * Moose::Util::TypeConstraints
366 * Moose::Meta::TypeConstraint
367 - added an 'optimize_as' option to the
368 type constraint, which allows for a
369 hand optimized version of the type
370 constraint to be used when possible.
371 - Any internally created type constraints
372 now provide an optimized version as well.
374 0.15 Sun. Nov. 5, 2006
376 This version of Moose *must* have Class::MOP 0.36 in order
377 to work correctly. A number of small internal tweaks have
378 been made in order to be compatible with that release.
380 * Moose::Util::TypeConstraints
381 - added &unimport so that you can clean out
382 your class namespace of these exported
386 - fixed minor issue which occasionally
387 comes up during global destruction
389 - moved Moose::Meta::Method::Overriden into
393 - moved Moose::Meta::Role::Method into
396 * Moose::Meta::Attribute
397 - changed how we do type checks so that
398 we reduce the overall cost, but still
401 - moved accessor generation methods to
402 Moose::Meta::Method::Accessor to
403 conform to the API changes from
406 * Moose::Meta::TypeConstraint
407 - changed how constraints are compiled
408 so that we do less recursion and more
409 iteration. This makes the type check
411 - moved Moose::Meta::TypeConstraint::Union
414 * Moose::Meta::Method::Accessor
415 - created this from methods formerly found in
416 Moose::Meta::Attribute
418 * Moose::Meta::Role::Method
419 - moved this from Moose::Meta::Role
421 * Moose::Meta::Method::Overriden
422 - moved this from Moose::Meta::Class
424 * Moose::Meta::TypeConstraint::Union
425 - moved this from Moose::Meta::TypeConstraint
427 0.14 Mon. Oct. 9, 2006
429 * Moose::Meta::Attribute
430 - fixed lazy attributes which were not getting
431 checked with the type constraint (thanks ashley)
432 - added tests for this
433 - removed the over-enthusiastic DWIMery of the
434 automatic ArrayRef and HashRef defaults, it
435 broke predicates in an ugly way.
436 - removed tests for this
438 0.13 Sat. Sept. 30, 2006
440 This version of Moose *must* have Class::MOP 0.35 in order
441 to work correctly. A number of small internal tweaks have
442 been made in order to be compatible with that release.
445 - Removed the use of UNIVERSAL::require to be a better
446 symbol table citizen and remove a dependency
447 (thanks Adam Kennedy)
449 **~~ removed experimental & undocumented feature ~~**
450 - commented out the 'method' and 'self' keywords, see the
451 comments for more info.
454 - added a FAQ and WTF files to document frequently
455 asked questions and common problems
457 * Moose::Util::TypeConstraints
458 - added GlobRef and FileHandle type constraint
459 - added tests for this
461 * Moose::Meta::Attribute
462 - if your attribute 'isa' ArrayRef of HashRef, and you have
463 not explicitly set a default, then make the default DWIM.
464 This will also work for subtypes of ArrayRef and HashRef
466 - you can now auto-deref subtypes of ArrayRef or HashRef too.
467 - new test added for this (thanks to ashley)
470 - added basic support for runtime role composition
471 but this is still *highly experimental*, so feedback
472 is much appreciated :)
473 - added tests for this
475 * Moose::Meta::TypeConstraint
476 - the type constraint now handles the coercion process
477 through delegation, this is to support the coercion
480 * Moose::Meta::TypeConstraint::Union
481 - it is now possible for coercions to be performed
483 - added tests for this (thanks to konobi)
485 * Moose::Meta::TypeCoercion
486 - properly capturing error when type constraint
490 - Scalar::Util 1.18 is bad on Win32, so temporarily
491 only require version 1.17 for Win32 and cygwin.
492 (thanks Adam Kennedy)
494 0.12 Sat. Sept. 1, 2006
496 - Recipe5 (subtypes & coercion) has been written
499 - fixed "bad meta" error message to be more descriptive
500 - fixed &unimport to not remove the &inner and &super
501 keywords because we need to localize them.
502 - fixed number of spelling/grammer issues, thanks Theory :)
504 **~~ experimental & undocumented feature ~~**
505 - added the method and self keywords, they are basically
506 just sugar, and they may not stay around.
509 - added &dump method to easily Data::Dumper
512 * Moose::Meta::TypeConstraint
513 - added the &is_a_type_of method to check both the current
514 and the subtype of a method (similar to &isa with classes)
517 - this is now a subclass of Class::MOP::Module, and no longer
518 creates the _role_meta ugliness of before.
519 - fixed tests to reflect this change
521 0.11 Wed. July 12, 2006
523 - added an &unimport method to remove all the keywords
524 that Moose will import, simply add 'no Moose' to the
525 bottom of your class file.
528 - fixed some test failures caused by a forgotten test
531 0.10 Thurs. July 6, 2006
533 - improved error message when loading modules so
534 it is less confusing when you load a role.
535 - added &calculate_all_roles method to
536 Moose::Meta::Class and Moose::Meta::Role
539 This module has been tested against Class::MOP 0.30
540 but it does not yet utilize the optimizations
541 it makes available. Stay tuned for that ;)
543 0.09_03 Fri. June 23, 2006
544 ++ DEVELOPER RELEASE ++
546 - 'use strict' and 'use warnings' are no longer
547 needed in Moose classes, Moose itself will
548 turn them on for you.
549 - added tests for this
550 - moved code from exported subs to private methods
551 in Moose::Meta::Class
554 - as with Moose, strict and warnings are
555 automatically turned on for you.
556 - added tests for this
559 - now handles an edge case for override errors
560 - added tests for this
561 - added some more edge case tests
563 0.09_02 Tues. May 16, 2006
564 ++ DEVELOPER RELEASE ++
566 - added prototypes to the exported subs
570 - added prototypes to the exported subs
573 * Moose::Util::TypeConstraints
574 - cleaned up prototypes for the subs
577 0.09_01 Fri. May 12, 2006
578 ++ DEVELOPER RELEASE ++
579 - This release works in combination with
580 Class::MOP 0.29_01, it is a developer
581 release because it uses the a new
582 instance sub-protocol and a fairly
583 complete Role implementation. It has
584 not yet been optimized, so it slower
585 the the previous CPAN version. This
586 release also lacks good updated docs,
587 the official release will have updated docs.
590 - refactored the keyword exports
591 - 'with' now checks Role validaity and
592 accepts more than one Role at a time
593 - 'extends' makes metaclass adjustments as
594 needed to ensure metaclass compatability
597 - refactored the keyword exports
598 - 'with' now checks Role validaity and
599 accepts more than one Role at a time
601 * Moose::Util::TypeConstraints
602 - added the 'enum' keyword for simple
603 string enumerations which can be used as
605 - see example of usage in t/202_example.t
608 - more careful checking of params to new()
611 - much work done on the role composition
612 - many new tests for conflict detection
613 and composition edge cases
614 - not enough documentation, I suggest
617 * Moose::Meta::Instance
618 - added new Instance metaclass to support
619 the new Class::MOP instance protocol
622 - some small changes to support the new
624 - some small additions to support Roles
626 * Moose::Meta::Attribute
627 - some improvements to the accessor generation code
629 - some small changes to support the new
631 - (still somewhat) experimental delegation support
632 with the 'handles' option
633 - added several tests for this
634 - no docs for this yet
636 0.05 Thurs. April 27, 2006
638 - keywords are now exported with Sub::Exporter
639 thanks to chansen for this commit
640 - has keyword now takes a 'metaclass' option
641 to support custom attribute meta-classes
642 on a per-attribute basis
643 - added tests for this
644 - the 'has' keyword not accepts inherited slot
645 specifications (has '+foo'). This is still an
646 experimental feature and probably not finished
647 see t/038_attribute_inherited_slot_specs.t for
648 more details, or ask about it on #moose
649 - added tests for this
652 - keywords are now exported with Sub::Exporter
654 * Moose::Utils::TypeConstraints
655 - reorganized the type constraint hierarchy, thanks
656 to nothingmuch and chansen for his help and advice
658 - added some tests for this
659 - keywords are now exported with Sub::Exporter
660 thanks to chansen for this commit
663 - due to changes in Class::MOP, we had to change
664 construct_instance (for the better)
666 * Moose::Meta::Attribute
667 - due to changes in Class::MOP, we had to add the
668 initialize_instance_slot method (it's a good thing)
670 * Moose::Meta::TypeConstraint
671 - added type constraint unions
672 - added tests for this
673 - added the is_subtype_of predicate method
674 - added tests for this
676 0.04 Sun. April 16th, 2006
678 - Roles can now consume other roles
679 - added tests for this
680 - Roles can specify required methods now with
681 the requires() keyword
682 - added tests for this
685 - ripped out much of it's guts ,.. much cleaner now
686 - added required methods and correct handling of
687 them in apply() for both classes and roles
688 - added tests for this
689 - no longer adds a does() method to consuming classes
690 it relys on the one in Moose::Object
691 - added roles attribute and some methods to support
692 roles consuming roles
694 * Moose::Meta::Attribute
695 - added support for triggers on attributes
696 - added tests for this
697 - added support for does option on an attribute
698 - added tests for this
701 - added support for attribute triggers in the
703 - added tests for this
706 - Moose no longer creates a subtype for your class
707 if a subtype of the same name already exists, this
708 should DWIM in 99.9999% of all cases
710 * Moose::Util::TypeConstraints
711 - fixed bug where incorrect subtype conflicts were
713 - added test for this
716 - this class can now be extended with 'use base' if
717 you need it, it properly loads the metaclass class now
718 - added test for this
720 0.03_02 Wed. April 12, 2006
722 - you must now explictly use Moose::Util::TypeConstraints
723 it no longer gets exported for you automatically
726 - new() now accepts hash-refs as well as key/value lists
727 - added does() method to check for Roles
728 - added tests for this
731 - added roles attribute along with the add_role() and
733 - added tests for this
736 - now adds a does() method to consuming classes
737 which tests the class's hierarchy for roles
738 - added tests for this
740 0.03_01 Mon. April 10, 2006
742 - added new Role recipe (no content yet, only code)
745 - added 'with' keyword for Role support
746 - added test and docs for this
747 - fixed subtype quoting bug
748 - added test for this
752 - added test and docs
754 * Moose::Util::TypeConstraints
755 - added the message keyword to add custom
756 error messages to type constraints
759 - the meta role to support Moose::Role
760 - added tests and docs
763 - moved a number of things from Moose.pm
764 to here, they should have been here
767 * Moose::Meta::Attribute
768 - moved the attribute option macros here
769 instead of putting them in Moose.pm
771 * Moose::Meta::TypeConstraint
772 - added the message attributes and the
774 - added tests and docs for this
776 0.03 Thurs. March 30, 2006
778 - added the Moose::Cookbook with 5 recipes,
779 describing all the stuff Moose can do.
782 - fixed an issue with &extends super class loading
783 it now captures errors and deals with inline
784 packages correctly (bug found by mst, solution
786 - added super/override & inner/augment features
787 - added tests and docs for these
790 - BUILDALL now takes a reference of the %params
791 that are passed to &new, and passes that to
794 * Moose::Util::TypeConstraints
795 - Type constraints now survive runtime reloading
796 - added test for this
799 - fixed the way attribute defaults are handled
800 during instance construction (bug found by chansen)
802 * Moose::Meta::Attribute
803 - read-only attributes now actually enforce their
804 read-only-ness (this corrected in Class::MOP as
807 0.02 Tues. March 21, 2006
809 - many more tests, fixing some bugs and
811 - &extends now loads the base module with
813 - added UNIVERSAL::require to the
816 - each new Moose class will also create
817 and register a subtype of Object which
818 correspond to the new Moose class.
819 - the 'isa' option in &has now only
820 accepts strings, and will DWIM in
823 * Moose::Util::TypeConstraints
824 - added type coercion features
825 - added tests for this
826 - added support for this in attributes
827 and instance construction
829 - type construction no longer creates a
830 function, it registers the type instead.
831 - added several functions to get the
835 - BUILDALL and DEMOLISHALL were broken
836 because of a mis-named hash key, Whoops :)
838 * Moose::Meta::Attribute
839 - adding support for coercion in the
840 autogenerated accessors
843 - adding support for coercion in the
844 instance construction
846 * Moose::Meta::TypeConstraint
847 * Moose::Meta::TypeCoercion
848 - type constraints and coercions are now
849 full fledges meta-objects
851 0.01 Wed. March 15, 2006
852 - Moooooooooooooooooose!!!