1 Revision history for Perl extension Moose
4 * fixing some misc. bits in the docs that
5 got mentioned on CPAN Forum
8 - fixed how required methods are handled
9 when they encounter overriden or modified
10 methods from a class (thanks to confound).
11 - added tests for this
13 0.26 Thurs. Sept. 27, 2007
17 We now support parameterized collection types, such as:
18 ArrayRef[Int] # array or integers
19 HashRef[Object] # a hash with object values
20 They can also be nested:
21 ArrayRef[HashRef[RegExpr]] # an array of hashes with regexpr values
22 And work with the type unions as well:
23 ArrayRef[Int | Str] # array of integers of strings
25 * Better Framework Extendability
26 Moose.pm is now "extendable" such that it is now much
27 easier to extend the framework and add your own keywords
28 and customizations. See the "EXTENDING AND EMBEDDING MOOSE"
29 section of the Moose.pm docs.
32 In an effort to begin documenting some of the various
33 details of Moose as well as some common idioms, we have
34 created Moose::Cookbook::Snacks as a place to find
35 small (easily digestable) nuggets of Moose code.
38 ~ Several doc updates/cleanup thanks to castaway ~
40 - converted build system to use Module::Install instead of
41 Module::Build (thanks to jrockway)
44 - added all the meta classes to the immutable list and
45 set it to inline the accessors
46 - fix import to allow Sub::Exporter like { into => }
47 and { into_level => } (perigrin)
48 - exposed and documented init_meta() to allow better
49 embedding and extending of Moose (perigrin)
52 - complete re-organization of the test suite
53 - added some new tests as well
54 - finally re-enabled the Moose::POOP test since
55 the new version of DBM::Deep now works again
59 - fixed very odd and very nasty recursion bug with
61 - added tests for this (eilara)
63 * Moose::Meta::Attribute
64 Moose::Meta::Method::Constructor
65 Moose::Meta::Method::Accessor
66 - fixed issue with overload::Overloaded getting called
67 on non-blessed items. (RT #29269)
68 - added tests for this
70 * Moose::Meta::Method::Accessor
71 - fixed issue with generated accessor code making
72 assumptions about hash based classes (thanks to dexter)
74 * Moose::Coookbook::Snacks
75 - these are bits of documentation, not quite as big as
76 Recipes but which have no clear place in the module docs.
77 So they are Snacks! (horray for castaway++)
79 * Moose::Cookbook::Recipe4
80 - updated it to use the new ArrayRef[MyType] construct
81 - updated the accompanying test as well
83 +++ Major Refactor of the Type Constraint system +++
84 +++ with new features added as well +++
86 * Moose::Util::TypeConstraint
87 - no longer uses package variable to keep track of
88 the type constraints, now uses the an instance of
89 Moose::Meta::TypeConstraint::Registry to do it
90 - added more sophisticated type notation parsing
92 - added tests for this
94 * Moose::Meta::TypeConstraint
95 - some minor adjustments to make subclassing easier
96 - added the package_defined_in attribute so that we
97 can track where the type constraints are created
99 * Moose::Meta::TypeConstraint::Union
100 - this is now been refactored to be a subclass of
101 Moose::Meta::TypeConstraint
103 * Moose::Meta::TypeCoercion::Union
104 - this has been added to service the newly refactored
105 Moose::Meta::TypeConstraint::Union and is itself
106 a subclass of Moose::Meta::TypeCoercion
108 * Moose::Meta::TypeConstraint::Parameterized
109 - added this module (taken from MooseX::AttributeHelpers)
110 to help construct nested collection types
111 - added tests for this
113 * Moose::Meta::TypeConstraint::Registry
114 - added this class to keep track of type constraints
116 0.25 Mon. Aug. 13, 2007
118 - Documentation update to reference Moose::Util::TypeConstraints
119 under 'isa' in 'has' for how to define a new type
122 * Moose::Meta::Attribute
123 - required attributes now will no longer accept undef
124 from the constructor, even if there is a default and lazy
125 - added tests for this
126 - default subroutines must return a value which passes the
128 - added tests for this
130 * Moose::Meta::Attribute
131 * Moose::Meta::Method::Constructor
132 * Moose::Meta::Method::Accessor
133 - type-constraint tests now handle overloaded objects correctly
135 - added tests for this (thanks to EvanCarroll)
137 * Moose::Meta::TypeConstraint::Union
138 - added (has_)hand_optimized_constraint to this class so that
139 it behaves as the regular Moose::Meta::TypeConstraint does.
142 - large refactoring of this code
143 - added several more tests
144 - tests for subtle conflict resolition issues
145 added, but not currently running
148 * Moose::Cookbook::Recipe7
149 - added new recipe for augment/inner functionality
151 - added test for this
154 - a formal definition of roles (still in progress)
157 - utilities for easier working with Moose classes
158 - added tests for these
161 - This contains Moose specific test functions
162 - added tests for these
164 0.24 Tues. July 3, 2007
165 ~ Some doc updates/cleanup ~
167 * Moose::Meta::Attribute
168 - added support for roles to be given as parameters
169 to the 'handles' option.
170 - added tests and docs for this
171 - the has '+foo' attribute form now accepts changes to
172 the lazy option, and the addition of a handles option
173 (but not changing the handles option)
174 - added tests and docs for this
177 - required methods are now fetched using find_method_by_name
178 so that required methods can come from superclasses
179 - adjusted tests for this
181 0.23 Mon. June 18, 2007
182 * Moose::Meta::Method::Constructor
183 - fix inlined constructor for hierarchy with multiple BUILD methods (mst)
185 - Modify make_immutable to work with the new Class::MOP immutable
186 mechanism + POD + very basic test (groditi)
187 * Moose::Meta::Attribute
188 - Fix handles to use goto() so that caller() comes out properly on
189 the other side (perigrin)
191 0.22 Thurs. May 31, 2007
192 * Moose::Util::TypeConstraints
193 - fix for prototype undeclared issue when Moose::Util::TypeConstraints
194 loaded before consumers (e.g. Moose::Meta::Attribute) by predeclaring
195 prototypes for functions
196 - added the ClassName type constraint, this checks for strings
197 which will respond true to ->isa(UNIVERSAL).
198 - added tests and docs for this
199 - subtyping just in name now works correctly by making the
200 default for where be { 1 }
201 - added test for this
203 * Moose::Meta::Method::Accessor
204 - coerce and lazy now work together correctly, thanks to
205 merlyn for finding this bug
206 - tests added for this
207 - fix reader presedence bug in Moose::Meta::Attribute + tests
210 - Foo->new(undef) now gets ignored, it is assumed you meant to pass
211 a HASH-ref and missed. This produces better error messages then
212 having it die cause undef is not a HASH.
213 - added tests for this
215 0.21 Thursday, May 2nd, 2007
217 - added SUPER_SLOT and INNER_SLOT class hashes to support unimport
218 - modified unimport to remove super and inner along with the rest
219 - altered unimport tests to handle this
222 - altered super export to populate SUPER_SLOT
225 - altered augment and override modifier application to use *_SLOT
226 - modified tests for these to unimport one test class each to test
229 - fixed issue where custom attribute metaclasses
230 where not handled correctly in roles
231 - added tests for this
234 - fixed issue where extending metaclasses with
235 roles would blow up. Thanks to Aankhen`` for
236 finding this insidious error, and it's solution.
238 ~~ lots of spelling and grammer fixes in the docs,
239 many many thanks to rlb3 and Aankhen for these :)
241 0.20 Friday, April 6th, 2007
242 >> I messed up the SKIP logic in one test
243 so this release is just to fix that.
246 - 'has' now also accepts an ARRAY ref
247 to create multiple attrs (see docs)
248 (thanks to konobi for this)
249 - added tests and docs
251 0.19 Thurs. April 5th, 2007
252 ~~ More documentation updates ~~
254 * Moose::Util::TypeConstraints
255 - 'type' now supports messages as well
256 thanks to phaylon for finding this
257 - added tests for this
258 - added &list_all_type_constraints and
259 &list_all_builtin_type_constraints
260 functions to facilitate introspection.
262 * Moose::Meta::Attribute
263 - fixed regexp 'handles' declarations
264 to build the list of delegated methods
265 correctly (and not override important
266 things like &new) thanks to ashleyb
268 - added tests and docs for this
269 - added the 'documentation' attributes
270 so that you can actually document your
271 attributes and inspect them through the
273 - added tests and docs for this
276 - when loading custom attribute metaclasses
277 it will first look in for the class in the
278 Moose::Meta::Attribute::Custom::$name, and
279 then default to just loading $name.
280 - added tests and docs for this
282 * Moose::Meta::TypeConstraint
283 - type constraints now stringify to their names.
284 - added test for this
287 - added tests to assure we work with Module::Refresh
288 - added stricter test skip logic in the Moose POOP
289 test, ask Rob Kinyon why.
290 - *cough* DBM::Deep 1.0 backwards compatability sucks *cough* ;)
292 0.18 Sat. March 10, 2007
293 ~~ Many, many documentation updates ~~
296 - We now use Class::MOP::load_class to
298 - added tests to show types and subtypes
299 working with Declare::Constraints::Simple
300 and Test::Deep as constraint engines.
303 !! You must have Class::MOP 0.37_001 !!
304 !! for this developer release to work !!
306 This release was primarily adding the immutable
307 feature to Moose. An immutable class is one which
308 you promise not to alter. When you set the class
309 as immutable it will perform various bits of
310 memoization and inline certain part of the code
311 (constructors, destructors and accessors). This
312 minimizes (and in some cases totally eliminates)
313 one of Moose's biggest performance hits. This
314 feature is not on by default, and is 100% optional.
315 It has several configurable bits as well, so you
316 can pick and choose to your specific needs.
318 The changes involved in this were fairly wide and
319 highly specific, but 100% backwards compatible, so
320 I am not going to enumerate them here. If you are
321 truely interested in what was changed, please do
324 0.17 Tues. Nov. 14, 2006
325 * Moose::Meta::Method::Accessor
326 - bugfix for read-only accessors which
327 are have a type constraint and lazy.
328 Thanks to chansen for finding it.
330 0.16 Tues. Nov. 14, 2006
332 There are some speed improvements in this release,
333 but they are only the begining, so stay tuned.
336 - BUILDALL and DEMOLISHALL no longer get
337 called unless they actually need to be.
338 This gave us a signifigant speed boost
339 for the cases when there is no BUILD or
340 DEMOLISH method present.
342 * Moose::Util::TypeConstraints
343 * Moose::Meta::TypeConstraint
344 - added an 'optimize_as' option to the
345 type constraint, which allows for a
346 hand optimized version of the type
347 constraint to be used when possible.
348 - Any internally created type constraints
349 now provide an optimized version as well.
351 0.15 Sun. Nov. 5, 2006
353 This version of Moose *must* have Class::MOP 0.36 in order
354 to work correctly. A number of small internal tweaks have
355 been made in order to be compatible with that release.
357 * Moose::Util::TypeConstraints
358 - added &unimport so that you can clean out
359 your class namespace of these exported
363 - fixed minor issue which occasionally
364 comes up during global destruction
366 - moved Moose::Meta::Method::Overriden into
370 - moved Moose::Meta::Role::Method into
373 * Moose::Meta::Attribute
374 - changed how we do type checks so that
375 we reduce the overall cost, but still
378 - moved accessor generation methods to
379 Moose::Meta::Method::Accessor to
380 conform to the API changes from
383 * Moose::Meta::TypeConstraint
384 - changed how constraints are compiled
385 so that we do less recursion and more
386 iteration. This makes the type check
388 - moved Moose::Meta::TypeConstraint::Union
391 * Moose::Meta::Method::Accessor
392 - created this from methods formerly found in
393 Moose::Meta::Attribute
395 * Moose::Meta::Role::Method
396 - moved this from Moose::Meta::Role
398 * Moose::Meta::Method::Overriden
399 - moved this from Moose::Meta::Class
401 * Moose::Meta::TypeConstraint::Union
402 - moved this from Moose::Meta::TypeConstraint
404 0.14 Mon. Oct. 9, 2006
406 * Moose::Meta::Attribute
407 - fixed lazy attributes which were not getting
408 checked with the type constraint (thanks ashley)
409 - added tests for this
410 - removed the over-enthusiastic DWIMery of the
411 automatic ArrayRef and HashRef defaults, it
412 broke predicates in an ugly way.
413 - removed tests for this
415 0.13 Sat. Sept. 30, 2006
417 This version of Moose *must* have Class::MOP 0.35 in order
418 to work correctly. A number of small internal tweaks have
419 been made in order to be compatible with that release.
422 - Removed the use of UNIVERSAL::require to be a better
423 symbol table citizen and remove a dependency
424 (thanks Adam Kennedy)
426 **~~ removed experimental & undocumented feature ~~**
427 - commented out the 'method' and 'self' keywords, see the
428 comments for more info.
431 - added a FAQ and WTF files to document frequently
432 asked questions and common problems
434 * Moose::Util::TypeConstraints
435 - added GlobRef and FileHandle type constraint
436 - added tests for this
438 * Moose::Meta::Attribute
439 - if your attribute 'isa' ArrayRef of HashRef, and you have
440 not explicitly set a default, then make the default DWIM.
441 This will also work for subtypes of ArrayRef and HashRef
443 - you can now auto-deref subtypes of ArrayRef or HashRef too.
444 - new test added for this (thanks to ashley)
447 - added basic support for runtime role composition
448 but this is still *highly experimental*, so feedback
449 is much appreciated :)
450 - added tests for this
452 * Moose::Meta::TypeConstraint
453 - the type constraint now handles the coercion process
454 through delegation, this is to support the coercion
457 * Moose::Meta::TypeConstraint::Union
458 - it is now possible for coercions to be performed
460 - added tests for this (thanks to konobi)
462 * Moose::Meta::TypeCoercion
463 - properly capturing error when type constraint
467 - Scalar::Util 1.18 is bad on Win32, so temporarily
468 only require version 1.17 for Win32 and cygwin.
469 (thanks Adam Kennedy)
471 0.12 Sat. Sept. 1, 2006
473 - Recipe5 (subtypes & coercion) has been written
476 - fixed "bad meta" error message to be more descriptive
477 - fixed &unimport to not remove the &inner and &super
478 keywords because we need to localize them.
479 - fixed number of spelling/grammer issues, thanks Theory :)
481 **~~ experimental & undocumented feature ~~**
482 - added the method and self keywords, they are basically
483 just sugar, and they may not stay around.
486 - added &dump method to easily Data::Dumper
489 * Moose::Meta::TypeConstraint
490 - added the &is_a_type_of method to check both the current
491 and the subtype of a method (similar to &isa with classes)
494 - this is now a subclass of Class::MOP::Module, and no longer
495 creates the _role_meta ugliness of before.
496 - fixed tests to reflect this change
498 0.11 Wed. July 12, 2006
500 - added an &unimport method to remove all the keywords
501 that Moose will import, simply add 'no Moose' to the
502 bottom of your class file.
505 - fixed some test failures caused by a forgotten test
508 0.10 Thurs. July 6, 2006
510 - improved error message when loading modules so
511 it is less confusing when you load a role.
512 - added &calculate_all_roles method to
513 Moose::Meta::Class and Moose::Meta::Role
516 This module has been tested against Class::MOP 0.30
517 but it does not yet utilize the optimizations
518 it makes available. Stay tuned for that ;)
520 0.09_03 Fri. June 23, 2006
521 ++ DEVELOPER RELEASE ++
523 - 'use strict' and 'use warnings' are no longer
524 needed in Moose classes, Moose itself will
525 turn them on for you.
526 - added tests for this
527 - moved code from exported subs to private methods
528 in Moose::Meta::Class
531 - as with Moose, strict and warnings are
532 automatically turned on for you.
533 - added tests for this
536 - now handles an edge case for override errors
537 - added tests for this
538 - added some more edge case tests
540 0.09_02 Tues. May 16, 2006
541 ++ DEVELOPER RELEASE ++
543 - added prototypes to the exported subs
547 - added prototypes to the exported subs
550 * Moose::Util::TypeConstraints
551 - cleaned up prototypes for the subs
554 0.09_01 Fri. May 12, 2006
555 ++ DEVELOPER RELEASE ++
556 - This release works in combination with
557 Class::MOP 0.29_01, it is a developer
558 release because it uses the a new
559 instance sub-protocol and a fairly
560 complete Role implementation. It has
561 not yet been optimized, so it slower
562 the the previous CPAN version. This
563 release also lacks good updated docs,
564 the official release will have updated docs.
567 - refactored the keyword exports
568 - 'with' now checks Role validaity and
569 accepts more than one Role at a time
570 - 'extends' makes metaclass adjustments as
571 needed to ensure metaclass compatability
574 - refactored the keyword exports
575 - 'with' now checks Role validaity and
576 accepts more than one Role at a time
578 * Moose::Util::TypeConstraints
579 - added the 'enum' keyword for simple
580 string enumerations which can be used as
582 - see example of usage in t/202_example.t
585 - more careful checking of params to new()
588 - much work done on the role composition
589 - many new tests for conflict detection
590 and composition edge cases
591 - not enough documentation, I suggest
594 * Moose::Meta::Instance
595 - added new Instance metaclass to support
596 the new Class::MOP instance protocol
599 - some small changes to support the new
601 - some small additions to support Roles
603 * Moose::Meta::Attribute
604 - some improvements to the accessor generation code
606 - some small changes to support the new
608 - (still somewhat) experimental delegation support
609 with the 'handles' option
610 - added several tests for this
611 - no docs for this yet
613 0.05 Thurs. April 27, 2006
615 - keywords are now exported with Sub::Exporter
616 thanks to chansen for this commit
617 - has keyword now takes a 'metaclass' option
618 to support custom attribute meta-classes
619 on a per-attribute basis
620 - added tests for this
621 - the 'has' keyword not accepts inherited slot
622 specifications (has '+foo'). This is still an
623 experimental feature and probably not finished
624 see t/038_attribute_inherited_slot_specs.t for
625 more details, or ask about it on #moose
626 - added tests for this
629 - keywords are now exported with Sub::Exporter
631 * Moose::Utils::TypeConstraints
632 - reorganized the type constraint hierarchy, thanks
633 to nothingmuch and chansen for his help and advice
635 - added some tests for this
636 - keywords are now exported with Sub::Exporter
637 thanks to chansen for this commit
640 - due to changes in Class::MOP, we had to change
641 construct_instance (for the better)
643 * Moose::Meta::Attribute
644 - due to changes in Class::MOP, we had to add the
645 initialize_instance_slot method (it's a good thing)
647 * Moose::Meta::TypeConstraint
648 - added type constraint unions
649 - added tests for this
650 - added the is_subtype_of predicate method
651 - added tests for this
653 0.04 Sun. April 16th, 2006
655 - Roles can now consume other roles
656 - added tests for this
657 - Roles can specify required methods now with
658 the requires() keyword
659 - added tests for this
662 - ripped out much of it's guts ,.. much cleaner now
663 - added required methods and correct handling of
664 them in apply() for both classes and roles
665 - added tests for this
666 - no longer adds a does() method to consuming classes
667 it relys on the one in Moose::Object
668 - added roles attribute and some methods to support
669 roles consuming roles
671 * Moose::Meta::Attribute
672 - added support for triggers on attributes
673 - added tests for this
674 - added support for does option on an attribute
675 - added tests for this
678 - added support for attribute triggers in the
680 - added tests for this
683 - Moose no longer creates a subtype for your class
684 if a subtype of the same name already exists, this
685 should DWIM in 99.9999% of all cases
687 * Moose::Util::TypeConstraints
688 - fixed bug where incorrect subtype conflicts were
690 - added test for this
693 - this class can now be extended with 'use base' if
694 you need it, it properly loads the metaclass class now
695 - added test for this
697 0.03_02 Wed. April 12, 2006
699 - you must now explictly use Moose::Util::TypeConstraints
700 it no longer gets exported for you automatically
703 - new() now accepts hash-refs as well as key/value lists
704 - added does() method to check for Roles
705 - added tests for this
708 - added roles attribute along with the add_role() and
710 - added tests for this
713 - now adds a does() method to consuming classes
714 which tests the class's hierarchy for roles
715 - added tests for this
717 0.03_01 Mon. April 10, 2006
719 - added new Role recipe (no content yet, only code)
722 - added 'with' keyword for Role support
723 - added test and docs for this
724 - fixed subtype quoting bug
725 - added test for this
729 - added test and docs
731 * Moose::Util::TypeConstraints
732 - added the message keyword to add custom
733 error messages to type constraints
736 - the meta role to support Moose::Role
737 - added tests and docs
740 - moved a number of things from Moose.pm
741 to here, they should have been here
744 * Moose::Meta::Attribute
745 - moved the attribute option macros here
746 instead of putting them in Moose.pm
748 * Moose::Meta::TypeConstraint
749 - added the message attributes and the
751 - added tests and docs for this
753 0.03 Thurs. March 30, 2006
755 - added the Moose::Cookbook with 5 recipes,
756 describing all the stuff Moose can do.
759 - fixed an issue with &extends super class loading
760 it now captures errors and deals with inline
761 packages correctly (bug found by mst, solution
763 - added super/override & inner/augment features
764 - added tests and docs for these
767 - BUILDALL now takes a reference of the %params
768 that are passed to &new, and passes that to
771 * Moose::Util::TypeConstraints
772 - Type constraints now survive runtime reloading
773 - added test for this
776 - fixed the way attribute defaults are handled
777 during instance construction (bug found by chansen)
779 * Moose::Meta::Attribute
780 - read-only attributes now actually enforce their
781 read-only-ness (this corrected in Class::MOP as
784 0.02 Tues. March 21, 2006
786 - many more tests, fixing some bugs and
788 - &extends now loads the base module with
790 - added UNIVERSAL::require to the
793 - each new Moose class will also create
794 and register a subtype of Object which
795 correspond to the new Moose class.
796 - the 'isa' option in &has now only
797 accepts strings, and will DWIM in
800 * Moose::Util::TypeConstraints
801 - added type coercion features
802 - added tests for this
803 - added support for this in attributes
804 and instance construction
806 - type construction no longer creates a
807 function, it registers the type instead.
808 - added several functions to get the
812 - BUILDALL and DEMOLISHALL were broken
813 because of a mis-named hash key, Whoops :)
815 * Moose::Meta::Attribute
816 - adding support for coercion in the
817 autogenerated accessors
820 - adding support for coercion in the
821 instance construction
823 * Moose::Meta::TypeConstraint
824 * Moose::Meta::TypeCoercion
825 - type constraints and coercions are now
826 full fledges meta-objects
828 0.01 Wed. March 15, 2006
829 - Moooooooooooooooooose!!!