1 Revision history for Perl extension Moose
3 0.26 Thurs. Sept. 27, 2007
7 We now support parameterized collection types, such as:
8 ArrayRef[Int] # array or integers
9 HashRef[Object] # a hash with object values
10 They can also be nested:
11 ArrayRef[HashRef[RegExpr]] # an array of hashes with regexpr values
12 And work with the type unions as well:
13 ArrayRef[Int | Str] # array of integers of strings
15 * Better Framework Extendability
16 Moose.pm is now "extendable" such that it is now much
17 easier to extend the framework and add your own keywords
18 and customizations. See the "EXTENDING AND EMBEDDING MOOSE"
19 section of the Moose.pm docs.
22 In an effort to begin documenting some of the various
23 details of Moose as well as some common idioms, we have
24 created Moose::Cookbook::Snacks as a place to find
25 small (easily digestable) nuggets of Moose code.
28 ~ Several doc updates/cleanup thanks to castaway ~
30 - converted build system to use Module::Install instead of
31 Module::Build (thanks to jrockway)
34 - added all the meta classes to the immutable list and
35 set it to inline the accessors
36 - fix import to allow Sub::Exporter like { into => }
37 and { into_level => } (perigrin)
38 - exposed and documented init_meta() to allow better
39 embedding and extending of Moose (perigrin)
42 - complete re-organization of the test suite
43 - added some new tests as well
44 - finally re-enabled the Moose::POOP test since
45 the new version of DBM::Deep now works again
49 - fixed very odd and very nasty recursion bug with
51 - added tests for this (eilara)
53 * Moose::Meta::Attribute
54 Moose::Meta::Method::Constructor
55 Moose::Meta::Method::Accessor
56 - fixed issue with overload::Overloaded getting called
57 on non-blessed items. (RT #29269)
58 - added tests for this
60 * Moose::Meta::Method::Accessor
61 - fixed issue with generated accessor code making
62 assumptions about hash based classes (thanks to dexter)
64 * Moose::Coookbook::Snacks
65 - these are bits of documentation, not quite as big as
66 Recipes but which have no clear place in the module docs.
67 So they are Snacks! (horray for castaway++)
69 * Moose::Cookbook::Recipe4
70 - updated it to use the new ArrayRef[MyType] construct
71 - updated the accompanying test as well
73 +++ Major Refactor of the Type Constraint system +++
74 +++ with new features added as well +++
76 * Moose::Util::TypeConstraint
77 - no longer uses package variable to keep track of
78 the type constraints, now uses the an instance of
79 Moose::Meta::TypeConstraint::Registry to do it
80 - added more sophisticated type notation parsing
82 - added tests for this
84 * Moose::Meta::TypeConstraint
85 - some minor adjustments to make subclassing easier
86 - added the package_defined_in attribute so that we
87 can track where the type constraints are created
89 * Moose::Meta::TypeConstraint::Union
90 - this is now been refactored to be a subclass of
91 Moose::Meta::TypeConstraint
93 * Moose::Meta::TypeCoercion::Union
94 - this has been added to service the newly refactored
95 Moose::Meta::TypeConstraint::Union and is itself
96 a subclass of Moose::Meta::TypeCoercion
98 * Moose::Meta::TypeConstraint::Parameterized
99 - added this module (taken from MooseX::AttributeHelpers)
100 to help construct nested collection types
101 - added tests for this
103 * Moose::Meta::TypeConstraint::Registry
104 - added this class to keep track of type constraints
106 0.25 Mon. Aug. 13, 2007
108 - Documentation update to reference Moose::Util::TypeConstraints
109 under 'isa' in 'has' for how to define a new type
112 * Moose::Meta::Attribute
113 - required attributes now will no longer accept undef
114 from the constructor, even if there is a default and lazy
115 - added tests for this
116 - default subroutines must return a value which passes the
118 - added tests for this
120 * Moose::Meta::Attribute
121 * Moose::Meta::Method::Constructor
122 * Moose::Meta::Method::Accessor
123 - type-constraint tests now handle overloaded objects correctly
125 - added tests for this (thanks to EvanCarroll)
127 * Moose::Meta::TypeConstraint::Union
128 - added (has_)hand_optimized_constraint to this class so that
129 it behaves as the regular Moose::Meta::TypeConstraint does.
132 - large refactoring of this code
133 - added several more tests
134 - tests for subtle conflict resolition issues
135 added, but not currently running
138 * Moose::Cookbook::Recipe7
139 - added new recipe for augment/inner functionality
141 - added test for this
144 - a formal definition of roles (still in progress)
147 - utilities for easier working with Moose classes
148 - added tests for these
151 - This contains Moose specific test functions
152 - added tests for these
154 0.24 Tues. July 3, 2007
155 ~ Some doc updates/cleanup ~
157 * Moose::Meta::Attribute
158 - added support for roles to be given as parameters
159 to the 'handles' option.
160 - added tests and docs for this
161 - the has '+foo' attribute form now accepts changes to
162 the lazy option, and the addition of a handles option
163 (but not changing the handles option)
164 - added tests and docs for this
167 - required methods are now fetched using find_method_by_name
168 so that required methods can come from superclasses
169 - adjusted tests for this
171 0.23 Mon. June 18, 2007
172 * Moose::Meta::Method::Constructor
173 - fix inlined constructor for hierarchy with multiple BUILD methods (mst)
175 - Modify make_immutable to work with the new Class::MOP immutable
176 mechanism + POD + very basic test (groditi)
177 * Moose::Meta::Attribute
178 - Fix handles to use goto() so that caller() comes out properly on
179 the other side (perigrin)
181 0.22 Thurs. May 31, 2007
182 * Moose::Util::TypeConstraints
183 - fix for prototype undeclared issue when Moose::Util::TypeConstraints
184 loaded before consumers (e.g. Moose::Meta::Attribute) by predeclaring
185 prototypes for functions
186 - added the ClassName type constraint, this checks for strings
187 which will respond true to ->isa(UNIVERSAL).
188 - added tests and docs for this
189 - subtyping just in name now works correctly by making the
190 default for where be { 1 }
191 - added test for this
193 * Moose::Meta::Method::Accessor
194 - coerce and lazy now work together correctly, thanks to
195 merlyn for finding this bug
196 - tests added for this
197 - fix reader presedence bug in Moose::Meta::Attribute + tests
200 - Foo->new(undef) now gets ignored, it is assumed you meant to pass
201 a HASH-ref and missed. This produces better error messages then
202 having it die cause undef is not a HASH.
203 - added tests for this
205 0.21 Thursday, May 2nd, 2007
207 - added SUPER_SLOT and INNER_SLOT class hashes to support unimport
208 - modified unimport to remove super and inner along with the rest
209 - altered unimport tests to handle this
212 - altered super export to populate SUPER_SLOT
215 - altered augment and override modifier application to use *_SLOT
216 - modified tests for these to unimport one test class each to test
219 - fixed issue where custom attribute metaclasses
220 where not handled correctly in roles
221 - added tests for this
224 - fixed issue where extending metaclasses with
225 roles would blow up. Thanks to Aankhen`` for
226 finding this insidious error, and it's solution.
228 ~~ lots of spelling and grammer fixes in the docs,
229 many many thanks to rlb3 and Aankhen for these :)
231 0.20 Friday, April 6th, 2007
232 >> I messed up the SKIP logic in one test
233 so this release is just to fix that.
236 - 'has' now also accepts an ARRAY ref
237 to create multiple attrs (see docs)
238 (thanks to konobi for this)
239 - added tests and docs
241 0.19 Thurs. April 5th, 2007
242 ~~ More documentation updates ~~
244 * Moose::Util::TypeConstraints
245 - 'type' now supports messages as well
246 thanks to phaylon for finding this
247 - added tests for this
248 - added &list_all_type_constraints and
249 &list_all_builtin_type_constraints
250 functions to facilitate introspection.
252 * Moose::Meta::Attribute
253 - fixed regexp 'handles' declarations
254 to build the list of delegated methods
255 correctly (and not override important
256 things like &new) thanks to ashleyb
258 - added tests and docs for this
259 - added the 'documentation' attributes
260 so that you can actually document your
261 attributes and inspect them through the
263 - added tests and docs for this
266 - when loading custom attribute metaclasses
267 it will first look in for the class in the
268 Moose::Meta::Attribute::Custom::$name, and
269 then default to just loading $name.
270 - added tests and docs for this
272 * Moose::Meta::TypeConstraint
273 - type constraints now stringify to their names.
274 - added test for this
277 - added tests to assure we work with Module::Refresh
278 - added stricter test skip logic in the Moose POOP
279 test, ask Rob Kinyon why.
280 - *cough* DBM::Deep 1.0 backwards compatability sucks *cough* ;)
282 0.18 Sat. March 10, 2007
283 ~~ Many, many documentation updates ~~
286 - We now use Class::MOP::load_class to
288 - added tests to show types and subtypes
289 working with Declare::Constraints::Simple
290 and Test::Deep as constraint engines.
293 !! You must have Class::MOP 0.37_001 !!
294 !! for this developer release to work !!
296 This release was primarily adding the immutable
297 feature to Moose. An immutable class is one which
298 you promise not to alter. When you set the class
299 as immutable it will perform various bits of
300 memoization and inline certain part of the code
301 (constructors, destructors and accessors). This
302 minimizes (and in some cases totally eliminates)
303 one of Moose's biggest performance hits. This
304 feature is not on by default, and is 100% optional.
305 It has several configurable bits as well, so you
306 can pick and choose to your specific needs.
308 The changes involved in this were fairly wide and
309 highly specific, but 100% backwards compatible, so
310 I am not going to enumerate them here. If you are
311 truely interested in what was changed, please do
314 0.17 Tues. Nov. 14, 2006
315 * Moose::Meta::Method::Accessor
316 - bugfix for read-only accessors which
317 are have a type constraint and lazy.
318 Thanks to chansen for finding it.
320 0.16 Tues. Nov. 14, 2006
322 There are some speed improvements in this release,
323 but they are only the begining, so stay tuned.
326 - BUILDALL and DEMOLISHALL no longer get
327 called unless they actually need to be.
328 This gave us a signifigant speed boost
329 for the cases when there is no BUILD or
330 DEMOLISH method present.
332 * Moose::Util::TypeConstraints
333 * Moose::Meta::TypeConstraint
334 - added an 'optimize_as' option to the
335 type constraint, which allows for a
336 hand optimized version of the type
337 constraint to be used when possible.
338 - Any internally created type constraints
339 now provide an optimized version as well.
341 0.15 Sun. Nov. 5, 2006
343 This version of Moose *must* have Class::MOP 0.36 in order
344 to work correctly. A number of small internal tweaks have
345 been made in order to be compatible with that release.
347 * Moose::Util::TypeConstraints
348 - added &unimport so that you can clean out
349 your class namespace of these exported
353 - fixed minor issue which occasionally
354 comes up during global destruction
356 - moved Moose::Meta::Method::Overriden into
360 - moved Moose::Meta::Role::Method into
363 * Moose::Meta::Attribute
364 - changed how we do type checks so that
365 we reduce the overall cost, but still
368 - moved accessor generation methods to
369 Moose::Meta::Method::Accessor to
370 conform to the API changes from
373 * Moose::Meta::TypeConstraint
374 - changed how constraints are compiled
375 so that we do less recursion and more
376 iteration. This makes the type check
378 - moved Moose::Meta::TypeConstraint::Union
381 * Moose::Meta::Method::Accessor
382 - created this from methods formerly found in
383 Moose::Meta::Attribute
385 * Moose::Meta::Role::Method
386 - moved this from Moose::Meta::Role
388 * Moose::Meta::Method::Overriden
389 - moved this from Moose::Meta::Class
391 * Moose::Meta::TypeConstraint::Union
392 - moved this from Moose::Meta::TypeConstraint
394 0.14 Mon. Oct. 9, 2006
396 * Moose::Meta::Attribute
397 - fixed lazy attributes which were not getting
398 checked with the type constraint (thanks ashley)
399 - added tests for this
400 - removed the over-enthusiastic DWIMery of the
401 automatic ArrayRef and HashRef defaults, it
402 broke predicates in an ugly way.
403 - removed tests for this
405 0.13 Sat. Sept. 30, 2006
407 This version of Moose *must* have Class::MOP 0.35 in order
408 to work correctly. A number of small internal tweaks have
409 been made in order to be compatible with that release.
412 - Removed the use of UNIVERSAL::require to be a better
413 symbol table citizen and remove a dependency
414 (thanks Adam Kennedy)
416 **~~ removed experimental & undocumented feature ~~**
417 - commented out the 'method' and 'self' keywords, see the
418 comments for more info.
421 - added a FAQ and WTF files to document frequently
422 asked questions and common problems
424 * Moose::Util::TypeConstraints
425 - added GlobRef and FileHandle type constraint
426 - added tests for this
428 * Moose::Meta::Attribute
429 - if your attribute 'isa' ArrayRef of HashRef, and you have
430 not explicitly set a default, then make the default DWIM.
431 This will also work for subtypes of ArrayRef and HashRef
433 - you can now auto-deref subtypes of ArrayRef or HashRef too.
434 - new test added for this (thanks to ashley)
437 - added basic support for runtime role composition
438 but this is still *highly experimental*, so feedback
439 is much appreciated :)
440 - added tests for this
442 * Moose::Meta::TypeConstraint
443 - the type constraint now handles the coercion process
444 through delegation, this is to support the coercion
447 * Moose::Meta::TypeConstraint::Union
448 - it is now possible for coercions to be performed
450 - added tests for this (thanks to konobi)
452 * Moose::Meta::TypeCoercion
453 - properly capturing error when type constraint
457 - Scalar::Util 1.18 is bad on Win32, so temporarily
458 only require version 1.17 for Win32 and cygwin.
459 (thanks Adam Kennedy)
461 0.12 Sat. Sept. 1, 2006
463 - Recipe5 (subtypes & coercion) has been written
466 - fixed "bad meta" error message to be more descriptive
467 - fixed &unimport to not remove the &inner and &super
468 keywords because we need to localize them.
469 - fixed number of spelling/grammer issues, thanks Theory :)
471 **~~ experimental & undocumented feature ~~**
472 - added the method and self keywords, they are basically
473 just sugar, and they may not stay around.
476 - added &dump method to easily Data::Dumper
479 * Moose::Meta::TypeConstraint
480 - added the &is_a_type_of method to check both the current
481 and the subtype of a method (similar to &isa with classes)
484 - this is now a subclass of Class::MOP::Module, and no longer
485 creates the _role_meta ugliness of before.
486 - fixed tests to reflect this change
488 0.11 Wed. July 12, 2006
490 - added an &unimport method to remove all the keywords
491 that Moose will import, simply add 'no Moose' to the
492 bottom of your class file.
495 - fixed some test failures caused by a forgotten test
498 0.10 Thurs. July 6, 2006
500 - improved error message when loading modules so
501 it is less confusing when you load a role.
502 - added &calculate_all_roles method to
503 Moose::Meta::Class and Moose::Meta::Role
506 This module has been tested against Class::MOP 0.30
507 but it does not yet utilize the optimizations
508 it makes available. Stay tuned for that ;)
510 0.09_03 Fri. June 23, 2006
511 ++ DEVELOPER RELEASE ++
513 - 'use strict' and 'use warnings' are no longer
514 needed in Moose classes, Moose itself will
515 turn them on for you.
516 - added tests for this
517 - moved code from exported subs to private methods
518 in Moose::Meta::Class
521 - as with Moose, strict and warnings are
522 automatically turned on for you.
523 - added tests for this
526 - now handles an edge case for override errors
527 - added tests for this
528 - added some more edge case tests
530 0.09_02 Tues. May 16, 2006
531 ++ DEVELOPER RELEASE ++
533 - added prototypes to the exported subs
537 - added prototypes to the exported subs
540 * Moose::Util::TypeConstraints
541 - cleaned up prototypes for the subs
544 0.09_01 Fri. May 12, 2006
545 ++ DEVELOPER RELEASE ++
546 - This release works in combination with
547 Class::MOP 0.29_01, it is a developer
548 release because it uses the a new
549 instance sub-protocol and a fairly
550 complete Role implementation. It has
551 not yet been optimized, so it slower
552 the the previous CPAN version. This
553 release also lacks good updated docs,
554 the official release will have updated docs.
557 - refactored the keyword exports
558 - 'with' now checks Role validaity and
559 accepts more than one Role at a time
560 - 'extends' makes metaclass adjustments as
561 needed to ensure metaclass compatability
564 - refactored the keyword exports
565 - 'with' now checks Role validaity and
566 accepts more than one Role at a time
568 * Moose::Util::TypeConstraints
569 - added the 'enum' keyword for simple
570 string enumerations which can be used as
572 - see example of usage in t/202_example.t
575 - more careful checking of params to new()
578 - much work done on the role composition
579 - many new tests for conflict detection
580 and composition edge cases
581 - not enough documentation, I suggest
584 * Moose::Meta::Instance
585 - added new Instance metaclass to support
586 the new Class::MOP instance protocol
589 - some small changes to support the new
591 - some small additions to support Roles
593 * Moose::Meta::Attribute
594 - some improvements to the accessor generation code
596 - some small changes to support the new
598 - (still somewhat) experimental delegation support
599 with the 'handles' option
600 - added several tests for this
601 - no docs for this yet
603 0.05 Thurs. April 27, 2006
605 - keywords are now exported with Sub::Exporter
606 thanks to chansen for this commit
607 - has keyword now takes a 'metaclass' option
608 to support custom attribute meta-classes
609 on a per-attribute basis
610 - added tests for this
611 - the 'has' keyword not accepts inherited slot
612 specifications (has '+foo'). This is still an
613 experimental feature and probably not finished
614 see t/038_attribute_inherited_slot_specs.t for
615 more details, or ask about it on #moose
616 - added tests for this
619 - keywords are now exported with Sub::Exporter
621 * Moose::Utils::TypeConstraints
622 - reorganized the type constraint hierarchy, thanks
623 to nothingmuch and chansen for his help and advice
625 - added some tests for this
626 - keywords are now exported with Sub::Exporter
627 thanks to chansen for this commit
630 - due to changes in Class::MOP, we had to change
631 construct_instance (for the better)
633 * Moose::Meta::Attribute
634 - due to changes in Class::MOP, we had to add the
635 initialize_instance_slot method (it's a good thing)
637 * Moose::Meta::TypeConstraint
638 - added type constraint unions
639 - added tests for this
640 - added the is_subtype_of predicate method
641 - added tests for this
643 0.04 Sun. April 16th, 2006
645 - Roles can now consume other roles
646 - added tests for this
647 - Roles can specify required methods now with
648 the requires() keyword
649 - added tests for this
652 - ripped out much of it's guts ,.. much cleaner now
653 - added required methods and correct handling of
654 them in apply() for both classes and roles
655 - added tests for this
656 - no longer adds a does() method to consuming classes
657 it relys on the one in Moose::Object
658 - added roles attribute and some methods to support
659 roles consuming roles
661 * Moose::Meta::Attribute
662 - added support for triggers on attributes
663 - added tests for this
664 - added support for does option on an attribute
665 - added tests for this
668 - added support for attribute triggers in the
670 - added tests for this
673 - Moose no longer creates a subtype for your class
674 if a subtype of the same name already exists, this
675 should DWIM in 99.9999% of all cases
677 * Moose::Util::TypeConstraints
678 - fixed bug where incorrect subtype conflicts were
680 - added test for this
683 - this class can now be extended with 'use base' if
684 you need it, it properly loads the metaclass class now
685 - added test for this
687 0.03_02 Wed. April 12, 2006
689 - you must now explictly use Moose::Util::TypeConstraints
690 it no longer gets exported for you automatically
693 - new() now accepts hash-refs as well as key/value lists
694 - added does() method to check for Roles
695 - added tests for this
698 - added roles attribute along with the add_role() and
700 - added tests for this
703 - now adds a does() method to consuming classes
704 which tests the class's hierarchy for roles
705 - added tests for this
707 0.03_01 Mon. April 10, 2006
709 - added new Role recipe (no content yet, only code)
712 - added 'with' keyword for Role support
713 - added test and docs for this
714 - fixed subtype quoting bug
715 - added test for this
719 - added test and docs
721 * Moose::Util::TypeConstraints
722 - added the message keyword to add custom
723 error messages to type constraints
726 - the meta role to support Moose::Role
727 - added tests and docs
730 - moved a number of things from Moose.pm
731 to here, they should have been here
734 * Moose::Meta::Attribute
735 - moved the attribute option macros here
736 instead of putting them in Moose.pm
738 * Moose::Meta::TypeConstraint
739 - added the message attributes and the
741 - added tests and docs for this
743 0.03 Thurs. March 30, 2006
745 - added the Moose::Cookbook with 5 recipes,
746 describing all the stuff Moose can do.
749 - fixed an issue with &extends super class loading
750 it now captures errors and deals with inline
751 packages correctly (bug found by mst, solution
753 - added super/override & inner/augment features
754 - added tests and docs for these
757 - BUILDALL now takes a reference of the %params
758 that are passed to &new, and passes that to
761 * Moose::Util::TypeConstraints
762 - Type constraints now survive runtime reloading
763 - added test for this
766 - fixed the way attribute defaults are handled
767 during instance construction (bug found by chansen)
769 * Moose::Meta::Attribute
770 - read-only attributes now actually enforce their
771 read-only-ness (this corrected in Class::MOP as
774 0.02 Tues. March 21, 2006
776 - many more tests, fixing some bugs and
778 - &extends now loads the base module with
780 - added UNIVERSAL::require to the
783 - each new Moose class will also create
784 and register a subtype of Object which
785 correspond to the new Moose class.
786 - the 'isa' option in &has now only
787 accepts strings, and will DWIM in
790 * Moose::Util::TypeConstraints
791 - added type coercion features
792 - added tests for this
793 - added support for this in attributes
794 and instance construction
796 - type construction no longer creates a
797 function, it registers the type instead.
798 - added several functions to get the
802 - BUILDALL and DEMOLISHALL were broken
803 because of a mis-named hash key, Whoops :)
805 * Moose::Meta::Attribute
806 - adding support for coercion in the
807 autogenerated accessors
810 - adding support for coercion in the
811 instance construction
813 * Moose::Meta::TypeConstraint
814 * Moose::Meta::TypeCoercion
815 - type constraints and coercions are now
816 full fledges meta-objects
818 0.01 Wed. March 15, 2006
819 - Moooooooooooooooooose!!!