1 Also see Moose::Manual::Delta for more details of, and workarounds
2 for, noteworthy changes.
5 * Moose::Meta::Attribute::Native::Trait::Code no longer creates reader
6 methods by default. (Florian Ragwitz)
9 * Improve various parts of the documentation and fix many typos.
10 (Dave Rolsky, Mateu Hunter, Graham Knop, Robin V, Jay Hannah, Jesse Luehrs)
16 * New method find_type_for in Moose::Meta::TypeConstraint::Union, for finding
17 which member of the union a given value validates for. (Cory Watson)
21 * DEMOLISH methods in mutable subclasses of immutable classes are now called
22 properly (Chia-liang Kao, Jesse Luehrs)
26 * Added Moose::Manual::Support that defines the support, compatiblity, and
27 release policies for Moose. (Chris Prather)
29 0.98 Wed, Feb 10, 2010
33 * An internals change in 0.97 broke role application to an instance in some
34 cases. The bug occurred when two different roles were applied to different
35 instances of the same class. (Rafael Kitover)
42 * Calling ->reinitialize on a cached anonymous class effectively uncached
43 the metaclass object, causing the metaclass to go out of scope
44 unexpectedly. This could easily happen at a distance by applying a
45 metarole to an anonymous class. (Dave Rolsky).
51 * ScalarRef is now a parameterized type. You can now specify a type
52 constraint for whatever the reference points to. (Closes RT#50857)
53 (Michael G. Schwern, Florian Ragwitz)
57 * ScalarRef now accepts references to other references. (Closes RT#50934)
64 * Moose::Meta::Attribute::Native::Trait::Code now provides execute_method as
65 a delegation option. This allows the code reference to be called as a
66 method on the object. (Florian Ragwitz)
70 * Moose::Object::does no longer checks the entire inheritance tree, since
71 Moose::Meta::Class::does_role already does this. (doy)
73 * Moose::Util::add_method_modifier (and subsequently the sugar functions
74 Moose::before, Moose::after, and Moose::around) can now accept arrayrefs,
75 with the same behavior as lists. Types other than arrayref and regexp
76 result in an error. (Dylan Hardison)
78 0.94 Mon, Jan 18, 2010
82 * Please see the changes listed for 0.93_01 and Moose::Manual::Delta.
86 * Improved support for anonymous roles by changing various APIs to take
87 Moose::Meta::Role objects as well as role names. This included
89 - Moose::Meta::Class->does_role
90 - Moose::Meta::Role->does_role
91 - Moose::Util::does_role
92 - Moose::Util::apply_all_roles
93 - Moose::Util::ensure_all_roles
94 - Moose::Util::search_class_by_role
96 Requested by Shawn Moore. Addresses RT #51143 (and then some). (Dave Rolsky)
100 * Fix handling of non-alphanumeric attributes names like '@foo'. This should
101 work as long as the accessor method names are explicitly set to valid Perl
102 method names. Reported by Doug Treder. RT #53731. (Dave Rolsky)
105 0.93_03 Tue, Jan 5, 2010
109 * Portability fixes to our XS code so we compile with 5.8.8 and Visual
110 C++. Fixes RT #53391. Reported by Taro Nishino. (rafl)
113 0.93_02 Tue, Jan 5, 2010
117 * Depend on Class::MOP 0.97_01 so we can get useful results from CPAN
118 testers. (Dave Rolsky)
121 0.93_01 Mon, Jan 4, 2010
125 See Moose::Manual::Delta for more details on backwards compatiblity issues.
127 * Role attributes are now objects of the Moose::Meta::Role::Attribute
128 class. (Dave Rolsky).
130 * There were major changes to how metaroles are applied. We now distinguish
131 between metaroles for classes vs those for roles. See the
132 Moose::Util::MetaRole docs for details. (Dave Rolsky)
134 * The old MetaRole API has been deprecated, but will continue to
135 work. However, if you are applying an attribute metaclass role, this may
136 break because of the fact that roles now have an attribute metaclass
139 * Moose::Util::MetaRole::apply_metaclass_roles is now called
140 apply_metaroles. The old name is deprecated. Dave Rolsky>
142 * The unimport subs created by Moose::Exporter now clean up re-exported
143 functions like blessed and confess, unless the caller imported them from
144 somewhere else too. See Moose::Manua::Delta for backcompat details. (rafl)
146 [ENHANCEMENTS AND BUG FIXES]
148 * Changed the Str constraint to accept magic lvalue strings like one gets from
149 substr et al, again. (sorear)
151 * Sped up the type constraint parsing regex. (Sam Vilain)
153 * The Moose::Cookbook::Extending::Recipe2 recipe was broken. Fix suggested by
156 * Added Moose::Util::TypeConstraints exports when using oose.pm to allow
157 easier testing of TypeConstraints from the command line. (perigrin)
159 * Added a with_immutable test function to Test::Moose, to run a block of tests
160 with and without certain classes being immutable. (doy)
162 * We now use Module::Install extensions explicitly to avoid confusing errors
163 if they're not installed. We use Module::Install::AuthorRequires to stop
164 test extraction and general failures if you don't have the author side
165 dependencies installed.
167 * Fixed a grammar error in Moose::Cookbook::Basics::Recipe4. rt.cpan.org
168 #51791. (Amir E. Aharoni)
171 0.93 Thu, Nov 19, 2009
173 - Calling $object->new() is no longer deprecated, and no longer
177 - The get_attribute_map method is now deprecated. (Dave Rolsky)
179 * Moose::Meta::Method::Delegation
180 - Preserve variable aliasing in @_ for delegated methods, so that
181 altering @_ affects the passed value. (doy)
183 * Moose::Util::TypeConstraints
184 - Allow array refs for non-anonymous form of enum and duck_type, not
185 just anonymous. The non-arrayref forms may be removed in the
187 - Changed Str constraint to not accept globs (*STDIN or *FOO). (chansen)
188 - Properly document Int being a subtype of Str. (doy)
191 - Moose::Exporter using modules can now export their functions to the
192 main package. This applied to Moose and Moose::Role, among
193 others. (nothingmuch)
195 * Moose::Meta::Attribute
196 - Don't remove attribute accessors we never installed, during
197 remove_accessors. (doy)
199 * Moose::Meta::Attribute::Native::Trait::Array
200 - Don't bypass prototype checking when calling List::Util::first, to
201 avoid a segfault when it is called with a non-code argument. (doy)
203 * Moose::Meta::Attribute::Native::Trait::Code
204 - Fix passing arguments to code execute helpers. (doy)
206 0.92 Tue, Sep 22, 2009
207 * Moose::Util::TypeConstraints
208 - added the match_on_type operator (Stevan)
209 - added tests and docs for this (Stevan)
212 - Metaclass compat fixing should already happen recursively, there's no
213 need to explicitly walk up the inheritance tree. (doy)
215 * Moose::Meta::Attribute
216 - Add tests for set_raw_value and get_raw_value. (nothingmuch)
218 0.91 Thu, Sep 17, 2009
220 - Don't import any functions, in order to avoid polluting our namespace
221 with things that can look like methods (blessed, try, etc)
224 * Moose::Meta::Method::Constructor
225 - The generated code needs to called Scalar::Util::blessed by its
226 fully-qualified name or else Perl can interpret the call to blessed as
227 an indirect method call. This broke Search::GIN, which in turn broke
228 KiokuDB. (nothingmuch)
230 0.90 Tue, Sep 15, 2009
231 * Moose::Meta::Attribute::Native::Trait::Counter
232 * Moose::Meta::Attribute::Native::Trait::String
233 - For these two traits, an attribute which did not explicitly provide
234 methods to handles magically ended up delegating *all* the helper
235 methods. This has been removed. You must be explicit in your handles
236 declaration for all Native Traits. (Dave Rolsky)
239 - DEMOLISHALL behavior has changed. If any DEMOLISH method dies, we make
240 sure to rethrow its error message. However, we also localize $@ before
241 this so that if all the DEMOLISH methods success, the value of $@ will
242 be preserved. (nothingmuch and Dave Rolsky)
243 - We now also localize $? during object destruction. (nothingmuch and
245 - The handling of DEMOLISH methods was broken for immutablized classes,
246 which were not receiving the value of
247 Devel::GlobalDestruction::in_global_destruction.
248 - These two fixes address some of RT #48271, reported by Zefram.
249 - This is all now documented in Moose::Manual::Construction.
250 - Calling $object->new() is now deprecated. A warning will be
254 - Added more hooks to customize how roles are applied. The role
255 summation class, used to create composite roles, can now be changed
256 and/or have meta-roles applied to it. (rafl)
257 - The get_method_list method no longer explicitly excludes the "meta"
258 method. This was a hack that has been replaced by better hacks. (Dave
261 * Moose::Meta::Method::Delegation
262 - fixed delegated methods to make sure that any modifiers attached to
263 the accessor being delegated on will be called (Stevan)
264 - added tests for this (Stevan)
267 - Moose no longer warns when a class that is being made immutable has
268 mutable ancestors. While in theory this is a good thing to warn about,
269 we found so many exceptions to this that doing this properly became
272 0.89_02 Thu, Sep 10, 2009
273 * Moose::Meta::Attribute::Native
274 - Fix Hash, which still had 'empty' instead of 'is_empty'. (hdp)
276 * Moose::Meta::Attribute::Native::Trait::Array
277 - Added a number of functions from List::Util and List::MoreUtils,
278 including reduce, shuffle, uniq, and natatime. (doy)
281 - This module will now generate an init_meta method for your exporting
282 class if you pass it options for
283 Moose::Util::MetaRole::apply_metaclass_roles or
284 apply_base_class_roles. This eliminates a lot of repetitive
285 boilerplate for typical MooseX modules. (doy).
286 - Documented the with_meta feature, which is a replacement for
287 with_caller. This feature was added by josh a while ago.
288 - The with_caller feature is now deprecated, but will not issue a
289 warning yet. (Dave Rolsky)
290 - If you try to wrap/export a subroutine which doesn't actually exist,
291 Moose::Exporter will warn you about this. (doy)
293 * Moose::Meta::Role::Application::ToRole
294 - When a role aliased a method from another role, it was only getting
295 the new (aliased) name, not the original name. This differed from what
296 happens when a class aliases a role's methods. If you _only_ want the
297 aliased name, make sure to also exclue the original name. (Dave
300 0.89_01 Wed Sep 2, 2009
301 * Moose::Meta::Attribute
302 - Added the currying syntax for delegation from AttributeHelpers to the
303 existing delegation API. (hdp)
305 * Moose::Meta::Attribute::Native
306 - We have merged the functionality of MooseX::AttributeHelpers into the
307 Moose core with some API tweaks. You can continue to use
308 MooseX::AttributeHelpers, but it will not be maintained except
309 (perhaps) for critical bug fixes in the future. See
310 Moose::Manual::Delta for details. (hdp, jhannah, rbuels, Sartak,
313 * Moose::Error::Croak
314 * Moose::Error::Confess
315 - Clarify documentation on how to use different error-throwing
316 modules. (Curtis Jewell)
319 - Correct POD for builder to point to Recipe8, not 9. (gphat)
322 - When a nonexistent sub name is passed to as_is, with_caller, or
323 with_meta, throw a warning and skip the exporting, rather than
324 installing a broken sub. (doy)
327 - Moose now warns if you call C<make_immutable> for a class with mutable
330 0.89 Thu Aug 13, 2009
331 * Moose::Manual::Attributes
332 - Clarify "is", include discussion of "bare". (Sartak)
334 * Moose::Meta::Role::Method::Conflicting
335 * Moose::Meta::Role::Application::ToClass
336 - For the first set of roles involved in a conflict, report all
337 unresolved method conflicts, not just the first method. Fixes #47210
338 reported by Ovid. (Sartak)
340 * Moose::Meta::TypeConstraint
341 - Add assert_valid method to use a TypeConstraint for assertion (rjbs)
344 - Make "use Moose -metaclass => 'Foo'" do alias resolution, like -traits
346 - Allow specifying role options (alias, excludes, MXRP stuff) in the
347 arrayref passed to "use Moose -traits" (doy)
350 - Add functions meta_class_alias and meta_attribute_alias for creating
351 aliases for class and attribute metaclasses and metatraits. (doy)
353 * Moose::Meta::Attribute
354 * Moose::Meta::Method::Accessor
355 - A trigger now receives the old value as a second argument, if the
356 attribute had one. (Dave Rolsky)
358 * Moose::Meta::Method::Constructor
359 - Fix a bug with $obj->new when $obj has stringify overloading.
360 Reported by Andrew Suffield [rt.cpan.org #47882] (Sartak)
361 - However, we will probably deprecate $obj->new, so please don't start
362 using it for new code!
364 * Moose::Meta::Role::Application
365 * Moose::Meta::Role::Application::RoleSummation
366 - Rename alias and excludes to -alias and -excludes (but keep the old
367 names for now, for backcompat) (doy)
369 0.88 Fri Jul 24, 2009
370 * Moose::Manual::Contributing
371 - Re-write the Moose::Manual::Contributing document to reflect
372 the new layout and methods of work for the Git repository. All
373 work now should be done in topic branches and reviewed by a
374 core committer before being applied to master. All releases
375 are done by a cabal member and merged from master to
376 stable. This plan was devised by Yuval, blame him. (perigrin)
379 - Create metaclass attributes for the different role application
382 * Moose::Util::MetaRole
383 - Allow applying roles to a meta role's role application
386 * Moose::Meta::Attribute
387 - Add weak_ref to allowed options for "has '+foo'" (mst)
389 * Moose::Meta::Method::Accessor
390 - No longer uses inline_slot_access in accessors, to support
391 non-lvalue-based meta instances. (sorear)
394 * Moose::Meta::Method::Delegation
395 - Once again allow class names as well as objects for
396 delegation. This was changed in 0.86.
399 * Moose::Meta::Class::Immutable::Trait
400 - Fixes to work with the latest Class::MOP.
402 * Moose::Meta::Method::Delegation
403 - Delegation now dies with a more useful error message if the
404 attribute's accessor returns something defined but
407 0.85 Fri, Jun 26, 2009
408 * Moose::Meta::Attribute
409 - The warning for 'no associated methods' is now split out into
410 the _check_associated_methods method, so that extensions can
411 safely call 'after install_accessors => ...'. This fixes a
412 warning from MooseX::AttributeHelpers. (hdp)
414 0.84 Fri, Jun 26, 2009
416 - has now sets definition_context for attributes defined in
419 * Moose::Meta::Attribute
420 - When adding an attribute to a metaclass, if the attribute has
421 no associated methods, it will give a deprecation
423 - Methods generated by delegation were not being added to
424 associated_methods. (hdp)
425 - Attribute accessors (reader, writer, accessor, predicate,
426 clearer) now warn if they overwrite an existing method. (doy)
427 - Attribute constructors now warn very noisily about unknown (or
428 misspelled) arguments
430 * Moose::Util::TypeConstraints
431 - Deprecated the totally useless Role type name, which just
432 checked if $object->can('does'). Note that this is _not_ the
433 same as a type created by calling role_type('RoleName').
435 * Moose::Util::TypeConstraints
436 * Moose::Meta::TypeConstraint::DuckType
437 - Reify duck type from a regular subtype into an actual class
439 - Document this because Sartak did all my work for me
442 * Moose::Meta::Attribute
443 - Allow Moose::Meta::TypeConstraint::DuckType in handles, since
444 it is just a list of methods (Sartak)
447 - The get_*_method_modifiers methods would die if the role had
448 no modifiers of the given type (Robert Buels).
450 0.83 Tue, Jun 23, 2009
452 - Fix _construct_instance not setting the special __MOP__ object
453 key in instances of anon classes. (doy)
455 0.82 Sun, Jun 21, 2009
456 * Moose::Manual::Types
457 - Mention MooseX::Types early to avoid users falling down the
458 string parsing rathole (mst)
460 * Moose::Manual::MooseX
461 - Add warnings about class-level extensions and mention considering
462 using plain objects instead
464 0.81 Sun, Jun 7, 2009
465 * Bumped our Class::MOP prereq to the latest version (0.85), since
468 0.80 Sat, Jun 6, 2009
470 - Add FAQ about the coercion change from 0.76 because it came up
471 three times today (perigrin)
472 - Win doy $10 dollars because Sartak didn't think anybody
473 would document this fast enough (perigrin)
475 * Moose::Meta::Method::Destructor
476 - Inline a DESTROY method even if there are no DEMOLISH methods
477 to prevent unnecessary introspection in
478 Moose::Object::DEMOLISHALL
481 - A role's required methods are now represented by
482 Moose::Meta::Role::Method::Required objects. Conflicts are now
483 represented by Moose::Meta::Role::Method::Conflicting
484 objects. The benefit for end-users in that unresolved
485 conflicts generate different, more instructive, errors,
486 resolving Ovid's #44895. (Sartak)
489 - Improve the error message of "extends" as suggested by Adam
490 Kennedy and confound (Sartak)
491 - Link to Moose::Manual::Roles from Moose::Role as we now have
492 excellent documentation (Adam Kennedy)
495 - Update test suite for subname change in Class::MOP
497 - Add TODO test for infinite recursion in Moose::Meta::Class
500 0.79 Wed, May 13, 2009
502 - More fixes for Win32 problems. Reported by Robert Krimen.
505 - The DEMOLISHALL method could still blow up in some cases
506 during global destruction. This method has been made more
507 resilient in the face of global destruction's random garbage
511 - If you "also" a module that isn't loaded, the error message
512 now acknowledges that (Sartak)
515 - When your ->meta method does not return a Moose::Meta::Class,
516 the error message gave the wrong output (Sartak)
518 0.78 Tue, May 12, 2009
519 * Moose::Cookbook::FAQ and Moose::Cookbook::WTF
520 - Merged these documents into what is now Moose::Manual::FAQ
523 - Moved to Moose::Manual::Unsweetened
525 * Moose::Cookbook::Basics::Recipes 9-12
526 - Renamed to be 8-11, since recipe 8 did not exist
529 - Make Moose::Exporter import strict and warnings into packages
533 - Fix DEMOLISHALL sometimes not being able to find DEMOLISH
534 methods during global destruction (doy)
537 * Moose::Meta::Role::Application::ToClass
538 - Track the Role::Application objects created during class-role
542 - Fix metaclass incompatibility errors when extending a vanilla perl
543 class which isa Moose class with a metaclass role applied (t0m)
546 - Add a role-combination hook, _role_for_combination, for the
547 benefit of MooseX::Role::Parameterized (Sartak)
550 - Some tests were failing on Win32 because they explicit checked
551 warning output for newlines. Reported by Nickolay Platonov.
553 0.77 Sat, May 2, 2009
555 - Add explicit use of Devel::GlobalDestruction and Sub::Name
559 - Pass a boolean to DEMOLISHALL and DEMOLISH indicating whether
560 or not we are currently in global destruction (doy)
561 - Add explicit use of Devel::GlobalDestruction and Sub::Name
564 * Moose::Cookbook::FAQ
565 - Reworked much of the existing content to be more useful to
566 modern Moose hackers (Sartak)
569 - Depend on Class::MOP 0.83 instead of 0.82_01.
571 0.76 Mon, April 27, 2009
572 * Moose::Meta::TypeConstraint
573 - Do not run coercions in coerce() if the value already passes the type
576 * Moose::Meta::TypeConstraint::Class
577 - In validation error messages, specifically say that the value is not
578 an instance of the class. This should alleviate some frustrating
579 forgot-to-load-my-type bugs. rt.cpan.org #44639 (Sartak)
581 * Moose::Meta::Role::Application::ToClass
582 - Revert the class-overrides-role warning in favor of a solution outside
583 of the Moose core (Sartak)
586 - Make Test::Output optional again, since it's only used in a few files
589 0.75_01 Thu, April 23, 2009
590 * Moose::Meta::Role::Application::ToClass
591 - Moose now warns about each class overriding methods from roles it
595 - Warnings tests have standardized on Test::Output which is now an
596 unconditionally dependency (Sartak)
599 - Changes to immutabilization to work with Class::MOP 0.82_01+.
601 0.75 Mon, April 20, 2009
604 - Move validation of not inheriting from roles from Moose::extends to
605 Moose::Meta::Class::superclasses (doy)
608 - add ensure_all_roles() function to encapsulate the common "apply this
609 role unless the object already does it" pattern (hdp)
612 - Users can now select a different metaclass with the "-metaclass"
613 option to import, for classes and roles (Sartak)
616 - Make method_metaclass an attr so that it can accept a metarole
619 0.74 Tue, April 7, 2009
621 * Moose::Meta::Method::Destructor
622 - Include stack traces in the deprecation warnings.
626 - Removed the long-deprecated _apply_all_roles method.
628 * Moose::Meta::TypeConstraint
629 - Removed the long-deprecated union method.
632 0.73_02 Mon, April 6, 2009
633 * More deprecations and renamings
634 - Moose::Meta::Method::Constructor
635 - initialize_body => _initialize_body (this is always called
636 when an object is constructed)
639 - The DEMOLISHALL method could throw an exception during global
640 destruction, meaning that your class's DEMOLISH methods would
641 not be properly called. Reported by t0m.
643 * Moose::Meta::Method::Destructor
644 - Destructor inlining was totally broken by the change to the
645 is_needed method in 0.72_01. Now there is a test for this
646 feature, and it works again.
649 - Bold the word 'not' in the POD for find_meta (t0m)
651 0.73_01 Sun, April 5, 2009
653 - Call user_class->meta in fewer places, with the eventual goal
654 of allowing the user to rename or exclude ->meta
655 altogether. Instead uses Class::MOP::class_of. (Sartak)
657 * Moose::Meta::Method::Accessor
658 - If an attribute had a lazy default, and that value did not
659 pass the attribute's type constraint, it did not get the
660 message from the type constraint, instead using a generic
661 message. Test provided by perigrin.
663 * Moose::Util::TypeConstraints
664 - Add duck_type keyword. It's sugar over making sure an object
665 can() a list of methods. This is easier than jrockway's
666 suggestion to fork all of CPAN. (perigrin)
667 - add tests and documentation (perigrin)
670 - Document the fact that init_meta() returns the target class's
671 metaclass object. (hdp)
673 * Moose::Cookbook::Extending::Recipe1
674 * Moose::Cookbook::Extending::Recipe2
675 * Moose::Cookbook::Extending::Recipe3
676 * Moose::Cookbook::Extending::Recipe4
677 - Make init_meta() examples explicitly return the metaclass and
678 point out this fact. (hdp)
680 * Moose::Cookbook::Basics::Recipe12
681 - A new recipe, creating a custom meta-method class.
683 * Moose::Cookbook::Meta::Recipe6
684 - A new recipe, creating a custom meta-method class.
687 * Moose::Meta::Method::Constructor
688 - Attribute triggers no longer receive the meta-attribute object
689 as an argument in any circumstance. Previously, triggers
690 called during instance construction were passed the
691 meta-attribute, but triggers called by normal accessors were
692 not. Fixes RT#44429, reported by Mark Swayne. (hdp)
694 * Moose::Manual::Attributes
695 - Remove references to triggers receving the meta-attribute object as an
698 * Moose::Cookbook::FAQ
699 - Remove recommendation for deprecated Moose::Policy and
700 Moose::Policy::FollowPBP; recommend MooseX::FollowPBP
703 * Many methods have been renamed with a leading underscore, and a
704 few have been deprecated entirely. The methods with a leading
705 underscore are consider "internals only". People writing
706 subclasses or extensions to Moose should feel free to override
707 them, but they are not for "public" use.
710 - check_metaclass_compatibility => _check_metaclass_compatibility
712 - Moose::Meta::Method::Accessor
713 - initialize_body => _initialize_body (this is always called
714 when an object is constructed)
715 - /(generate_.*_method(?:_inline)?)/ => '_' . $1
717 - Moose::Meta::Method::Constructor
718 - initialize_body => _initialize_body (this is always called
719 when an object is constructed)
720 - /(generate_constructor_method(?:_inline)?)/ => '_' . $1
721 - attributes => _attributes (now inherited from parent)
722 - meta_instance => _meta_instance (now inherited from parent)
725 - alias_method is deprecated. Use add_method
727 0.73 Fri, March 29, 2009
728 * No changes from 0.72_01.
730 0.72_01 Thu, March 26, 2009
732 - Almost every module has complete API documentation. A few
733 methods (and even whole classes) have been intentionally
734 excluded pending some rethinking of their APIs.
736 * Moose::Util::TypeConstraints
737 - Calling subtype with a name as the only argument is now an
738 exception. If you want an anonymous subtype do:
740 my $subtype = subtype as 'Foo';
742 * Moose::Cookbook::Meta::Recipe7
743 - A new recipe, creating a custom meta-instance class.
745 * Moose::Cookbook::Basics::Recipe5
746 - Fix various typos and mistakes. Includes a patch from Radu
749 * Moose::Cookbook::Basics::Recipe9
750 - Link to this recipe from Moose.pm's builder blurb
753 - When wrapping a function with a prototype, Moose::Exporter now
754 makes sure the wrapped function still has the same
755 prototype. (Daisuke Maki)
757 * Moose::Meta::Attribute
758 - Allow a subclass to set lazy_build for an inherited
762 - Explicitly depend on Data::OptList. We already had this dependency
763 via Sub::Exporter, but since we're using it directly we're
764 better off with it listed. (Sartak)
766 * Moose::Meta::Method::Constructor
767 - Make it easier to subclass the inlining behaviour. (Ash
770 * Moose::Manual::Delta
771 - Details significant changes in the history of Moose, along
772 with recommended workarounds.
774 * Moose::Manual::Contributing
775 - Contributor's guide to Moose.
777 * Moose::Meta::Method::Constructor
778 - The long-deprecated intialize_body method has been removed
779 (yes, spelled like that).
781 * Moose::Meta::Method::Destructor
782 - This is_needed method is now always a class method.
785 - Changes to the internals of how make_immutable works to match
786 changes in latest Class::MOP.
788 0.72 Mon, February 23, 2009
790 * Moose::Meta::Method::Constructor
791 - A mutable class accepted Foo->new(undef) without complaint,
792 while an immutable class would blow up with an unhelpful
793 error. Now, in both cases we throw a helpful error
794 instead. Reported by doy.
796 0.71_01 Sun, February 22, 2009
798 - Hopefully fixed some POD errors in a few recipes that caused
799 them to display weird on search.cpan.org.
801 * Moose::Util::TypeConstraints
802 - Calling type or subtype without the sugar helpers (as, where,
803 message) is now deprecated.
804 - The subtype function tried hard to guess what you meant, but
805 often got it wrong. For example:
807 my $subtype = subtype as 'ArrayRef[Object]';
809 This caused an error in the past, but now works as you'd
813 - Make sure Moose.pm is loaded before calling
814 Moose->throw_error. This wasn't normally an issue, but could
815 bite you in weird cases.
817 0.71 Thu, February 19, 2009
818 * Moose::Cookbook::Basics::Recipe11
819 - A new recipe which demonstrates the use of BUILDARGS and
822 * Moose::Cookbook::Roles::Recipe3
823 - A new recipe, applying a role to an object instance. (Dave
827 - Allow overriding specific keywords from "also" packages. (doy)
830 - Replace hardcoded cookbook tests with Test::Inline to ensure
831 the tests match the actual code in the recipes. (Dave Rolsky)
834 - Working on the above turned up a number of little bugs in the
835 recipe code. (Dave Rolsky)
837 * Moose::Util::TypeConstraints::Optimized
838 - Just use Class::MOP for the optimized ClassName check. (Dave
841 0.70 Sat, February 14, 2009
842 * Moose::Util::TypeConstraints
843 - Added the RoleName type (stevan)
844 - added tests for this (stevan)
846 * Moose::Cookbook::Basics::Recipe3
847 - Updated the before qw[left right] sub to be a little more
848 defensive about what it accepts (stevan)
849 - added more tests to t/000_recipies/basics/003_binary_tree.t
853 - We now always call DEMOLISHALL, even if a class does not
854 define DEMOLISH. This makes sure that method modifiers on
855 DEMOLISHALL work as expected. (doy)
856 - added tests for this (EvanCarroll)
858 * Moose::Util::MetaRole
859 - Accept roles for the wrapped_method_metaclass (rafl)
860 - added tests for this (rafl)
862 * Moose::Meta::Attribute
863 - We no longer pass the meta-attribute object as a final
864 argument to triggers. This actually changed for inlined code a
865 while back, but the non-inlined version and the docs were
869 - Some tests tried to use Test::Warn 0.10, which had bugs. Now
870 they require 0.11. (Dave Rolsky)
873 - Lots of small changes to the manual, cookbook, and
874 elsewhere. These were based on feedback from various
875 users, too many to list here. (Dave Rolsky)
877 0.69 Thu, February 12, 2009
879 - Make some keyword errors use throw_error instead of croak
880 since Moose::Exporter wraps keywords now (Sartak)
883 - Revised every recipe for style and clarity. Also moved some
884 documentation out of cookbook recipes and into Moose::Manual
885 pages. This work was funded as part of the Moose docs grant
886 from TPF. (Dave Rolsky)
888 * Moose::Meta::Method::Delegation
889 - If the attribute doing the delegation was not populated, the
890 error message did not specify the attribute name
893 0.68 Wed, February 4, 2009
895 - Many spelling, typo, and formatting fixes by daxim.
897 * Moose::Manual::Attributes
898 - The NAME section in the POD used "Attribute" so search.cpan
899 didn't resolve links from other documents properly.
901 * Moose::Meta::Method::Overriden
902 - Now properly spelled as Overridden. Thanks to daxim for
905 0.67 Tue, February 3, 2009
907 - Lots of little typo fixes and a few clarifications. Several
908 pages didn't have proper titles, and so weren't actually
909 visible on search.cpan.org. Thanks to hanekomu for a variety
910 of fixes and formatting improvements.
912 0.66 Tue, February 3, 2009
914 - This is a brand new, extensive manual for Moose. This aims to
915 provide a complete introduction to all of Moose's
916 features. This work was funded as part of the Moose docs grant
917 from TPF. (Dave Rolsky)
919 * Moose::Meta::Attribute
920 - Added a delegation_metaclass method to replace a hard-coded
921 use of Moose::Meta::Method::Delegation. (Dave Rolsky)
923 * Moose::Util::TypeConstraints
924 - If you created a subtype and passed a parent that Moose didn't
925 know about, it simply ignored the parent. Now it automatically
926 creates the parent as a class type. This may not be what you
927 want, but is less broken than before. (Dave Rolsky)
929 * Moose::Util::TypeConstraints
930 - This module tried throw errors by calling Moose->throw_error,
931 but it did not ensure that Moose was loaded first. This could
932 cause very unhelpful errors when it tried to throw an error
933 before Moose was loaded. (Dave Rolsky)
935 * Moose::Util::TypeConstraints
936 - You could declare a name with subtype such as "Foo!Bar" that
937 would be allowed, but if you used it in a parameterized type
938 such as "ArrayRef[Foo!Bar]" it wouldn't work. We now do some
939 vetting on names created via the sugar functions, so that they
940 can only contain alphanumerics, ":", and ".". (Dave Rolsky)
942 0.65 Thu, January 22, 2008
943 * Moose and Moose::Meta::Method::Overridden
944 - If an overridden method called super(), and then the
945 superclass's method (not overridden) _also_ called super(),
946 Moose went into an endless recursion loop. Test provided by
947 Chris Prather. (Dave Rolsky)
949 * Moose::Meta::TypeConstraint
950 - All methods are now documented. (gphat)
952 * t/100_bugs/011_DEMOLISH_eats_exceptions.t
953 - Fixed some bogus failures that occurred because we tried to
954 validate filesystem paths in a very ad-hoc and
955 not-quite-correct way. (Dave Rolsky)
957 * Moose::Util::TypeConstraints
958 - Added maybe_type to exports. See docs for details. (rjbs)
961 - Added Moose::Util::TypeConstraints to the SEE ALSO
965 - Methods created via an attribute can now fulfill a "requires"
966 declaration for a role. (nothingmuch)
968 * Moose::Meta::Method::*
969 - Stack traces from inlined code will now report its line and
970 file as being in your class, as opposed to in Moose
973 0.64 Wed, December 31, 2008
974 * Moose::Meta::Method::Accessor
975 - Always inline predicate and clearer methods (Sartak)
977 * Moose::Meta::Attribute
978 - Support for parameterized traits (Sartak)
979 - verify_against_type_constraint method to avoid duplication
980 and enhance extensibility (Sartak)
983 - Tests (but no support yet) for parameterized traits (Sartak)
986 - Require Class::MOP 0.75+, which has the side effect of making
987 sure we work on Win32. (Dave Rolsky)
989 0.63 Mon, December 8, 2008
991 - Some small grammar tweaks and bug fixes in non-Moose example
994 0.62_02 Fri, December 5, 2008
995 * Moose::Meta::Role::Application::ToClass
996 - When a class does not provide all of a role's required
997 methods, the error thrown now mentions all of the missing
998 methods, as opposed to just the first one found. Requested by
999 Curtis Poe (RT #41119). (Dave Rolsky)
1001 * Moose::Meta::Method::Constructor
1002 - Moose will no longer inline a constructor for your class
1003 unless it inherits its constructor from Moose::Object, and
1004 will warn when it doesn't inline. If you want to force
1005 inlining anyway, pass "replace_constructor => 1" to
1006 make_immutable. Addresses RT #40968, reported by Jon
1007 Swartz. (Dave Rolsky)
1008 - The quoting of default values could be broken if the default
1009 contained a single quote ('). Now we use quotemeta to escape
1010 anything potentially dangerous in the defaults. (Dave Rolsky)
1012 0.62_01 Wed, December 3, 2008
1014 - use the method->execute API for BUILDALL
1015 and DEMOLISHALL (Sartak)
1017 * Moose::Util::TypeConstraints
1018 - We now make all the type constraint meta classes immutable
1019 before creating the default types provided by Moose. This
1020 should make loading Moose a little faster. (Dave Rolsky)
1022 0.62 Wed November 26, 2008
1023 * Moose::Meta::Role::Application::ToClass
1024 Moose::Meta::Role::Application::ToRole
1025 - fixed issues where excluding and aliasing the
1026 same methods for a single role did not work
1027 right (worked just fine with multiple
1029 - added test for this (stevan)
1031 * Moose::Meta::Role::Application::RoleSummation
1032 - fixed the error message when trying to compose
1033 a role with a role it excludes (Sartak)
1036 - Catch another case where recursion caused the value
1037 of $CALLER to be stamped on (t0m)
1038 - added test for this (t0m)
1041 - Remove the make_immutable keyword, which has been
1042 deprecated since April. It breaks metaclasses that
1043 use Moose without no Moose (Sartak)
1045 * Moose::Meta::Attribute
1046 - Removing an attribute from a class now also removes delegation
1047 (handles) methods installed for that attribute (t0m)
1048 - added test for this (t0m)
1050 * Moose::Meta::Method::Constructor
1051 - An attribute with a default that looked like a number (but was
1052 really a string) would accidentally be treated as a number
1053 when the constructor was made immutable (perigrin)
1054 - added test for this (perigrin)
1057 - create method for constructing a role
1058 dynamically (Sartak)
1059 - added test for this (Sartak)
1060 - anonymous roles! (Sartak)
1061 - added test for this (Sartak)
1064 - more consistent error messages (Sartak)
1066 * Moose::Cookbook::Roles::Recipe1
1067 - attempt to explain why a role that just requires
1068 methods is useful (Sartak)
1070 0.61 Fri November 7, 2008
1071 * Moose::Meta::Attribute
1072 - When passing a role to handles, it will be loaded if necessary
1075 * Moose::Meta::Class
1076 - Method objects returned by get_method (and other methods)
1077 Could end up being returned without an associated_metaclass
1078 attribute. Removing get_method_map, which is provided by
1079 Class::MOP::Class, fixed this. The Moose version did nothing
1080 different from its parent except introduce a bug. (Dave Rolsky)
1081 - added tests for this (jdv79)
1084 - Added a $VERSION to all .pm files which didn't have one. Fixes
1085 RT #40049, reported by Adam Kennedy. (Dave Rolsky)
1087 * Moose::Cookbook::Basics::Recipe4
1088 * Moose::Cookbook::Basics::Recipe6
1089 - These files had spaces on the first line of the SYNOPSIS, as
1090 opposed to a totally empty line. According to RT #40432, this
1091 confuses POD parsers. (Dave Rolsky)
1093 0.60 Fri October 24, 2008
1095 - Passing "-traits" when loading Moose caused the Moose.pm
1096 exports to be broken. Reported by t0m. (Dave Rolsky)
1097 - Tests for this bug. (t0m)
1100 - Change resolve_metaclass alias to use the new
1101 load_first_existing_class function. This makes it a lot
1102 simpler, and also around 5 times faster. (t0m)
1103 - Add caching to resolve_metaclass_alias, which gives an order
1104 of magnitude speedup to things which repeatedly call the
1105 Moose::Meta::Attribute->does method, notably MooseX::Storage
1108 * Moose::Util::TypeConstraint
1109 - Put back the changes for parameterized constraints that
1110 shouldn't have been removed in 0.59. We still cannot parse
1111 them, but MooseX modules can create them in some other
1112 way. See the 0.58 changes for more details. (jnapiorkowski)
1113 - Changed the way subtypes are created so that the job is
1114 delegated to a type constraint parent. This clears up some
1115 hardcoded checking and should allow correct subtypes of
1116 Moose::Meta::Type::Constraint. Don't rely on this new API too
1117 much (create_child_type) because it may go away in the
1118 future. (jnapiorkowski)
1120 * Moose::Meta::TypeConstraint::Union
1121 - Type constraint names are sorted as strings, not numbers.
1124 * Moose::Meta::TypeConstraint::Parameterizable
1125 - New parameterize method. This can be used as a factory method
1126 to make a new type constraint with a given parameterized
1127 type. (jnapiorkowski)
1128 - added tests (jnapiorkowski)
1130 0.59 Tue October 14, 2008
1132 - Add abridged documentation for builder/default/initializer/
1133 predicate, and link to more details sections in
1134 Class::MOP::Attribute. (t0m)
1136 * Moose::Util::TypeConstraints
1137 - removed prototypes from all but the &-based stuff (mst)
1139 * Moose::Util::TypeConstraints
1140 - Creating a anonymous subtype with both a constraint and a
1141 message failed with a very unhelpful error, but should just
1142 work. Reported by t0m. (Dave Rolsky)
1145 - Some tests that used Test::Warn if it was available failed
1146 with older versions of Test::Warn. Reported by Fayland. (Dave
1148 - Test firing behavior of triggers in relation to builder/default/
1150 - Test behavior of equals/is_a_type_of/is_a_subtype_of for all
1151 kinds of supported type. (t0m)
1153 * Moose::Meta::Class
1154 - In create(), do not pass "roles" option to the superclass
1155 - added related test that creates an anon metaclass with
1156 a required attribute
1158 * Moose::Meta::TypeConstraint::Class
1159 * Moose::Meta::TypeConstraint::Role
1160 - Unify behavior of equals/is_a_type_of/is_a_subtype_of with
1161 other types (as per change in 0.55_02). (t0m)
1163 * Moose::Meta::TypeConstraint::Registry
1164 - Fix warning when dealing with unknown type names (t0m)
1166 * Moose::Util::TypeConstraints
1167 - Reverted changes from 0.58 related to handle parameterized
1168 types. This caused random failures on BSD and Win32 systems,
1169 apparently related to the regex engine. This means that Moose
1170 can no longer parse structured type constraints like
1171 ArrayRef[Int,Int] or HashRef[name=>Str]. This will be
1172 supported in a slightly different way via MooseX::Types some
1173 time in the future. (Dave Rolsky)
1175 0.58 Sat September 20, 2008
1176 !! This release has an incompatible change regarding !!
1177 !! how roles add methods to a class !!
1179 * Roles and role application
1180 ! Roles now add methods by calling add_method, not
1181 alias_method. They make sure to always provide a method
1182 object, which will be cloned internally. This means that it is
1183 now possible to track the source of a method provided by a
1184 role, and even follow its history through intermediate roles.
1186 This means that methods added by a role now show up when
1187 looking at a class's method list/map. (Dave Rolsky)
1190 - From this release on, we'll try to maintain a list of
1191 conflicting modules, and warn you if you have one
1192 installed. For example, this release conflicts with ...
1193 - MooseX::Singleton <= 0.11
1194 - MooseX::Params::Validate <= 0.05
1197 In general, we try to not break backwards compatibility for
1198 most Moose users, but MooseX modules and other code which
1199 extends Moose's metaclasses is often affected by very small
1200 changes in the Moose internals.
1202 * Moose::Meta::Method::Delegation
1203 * Moose::Meta::Attribute
1204 - Delegation methods now have their own method class. (Dave
1207 * Moose::Meta::TypeConstraint::Parameterizable
1208 - Added a new method 'parameterize' which is basically a factory
1209 for the containing constraint. This makes it easier to create
1210 new types of parameterized constraints. (jnapiorkowski)
1212 * Moose::Meta::TypeConstraint::Union
1213 - Changed the way Union types canonicalize their names to follow
1214 the normalized TC naming rules, which means we strip all
1215 whitespace. (jnapiorkowski)
1217 * Moose::Util::TypeConstraints
1218 - Parameter and Union args are now sorted, this makes Int|Str
1219 the same constraint as Str|Int. (jnapiorkowski)
1220 - Changes to the way Union types are parsed to more correctly
1221 stringify their names. (jnapiorkowski)
1222 - When creating a parameterized type, we now use the new
1223 parameterize method. (jnapiorkowski)
1224 - Incoming type constraint strings are now normalized to remove
1225 all whitespace differences. (jnapiorkowski)
1226 - Changed the way we parse type constraint strings so that we now
1227 match TC[Int,Int,...] and TC[name=>Str] as parameterized type
1228 constraints. This lays the foundation for more flexible type
1229 constraint implementations.
1231 * Tests and docs for all the above. (jnapiorkowski)
1235 - Moose::Exporter will no longer remove a subroutine that the
1236 exporting package re-exports. Moose re-exports the
1237 Carp::confess function, among others. The reasoning is that we
1238 cannot know whether you have also explicitly imported those
1239 functions for your own use, so we err on the safe side and
1240 always keep them. (Dave Rolsky)
1241 - added tests for this (rafl)
1243 * Moose::Meta::Class
1244 - Changes to how we fix metaclass compatibility that are much
1245 too complicated to go into. The summary is that Moose is much
1246 less likely to complain about metaclass incompatibility
1247 now. In particular, if two metaclasses differ because
1248 Moose::Util::MetaRole was used on the two corresponding
1249 classes, then the difference in roles is reconciled for the
1250 subclass's metaclass. (Dave Rolsky)
1251 - Squashed an warning in _process_attribute (thepler)
1254 - throw exceptions (sooner) for invalid attribute names (thepler)
1255 - added tests for this (thepler)
1257 * Moose::Util::MetaRole
1258 - If you explicitly set a constructor or destructor class for a
1259 metaclass object, and then applied roles to the metaclass,
1260 that explicitly set class would be lost and replaced with the
1263 * Moose::Meta::Class
1264 * Moose::Meta::Attribute
1265 * Moose::Meta::Method
1268 * Moose::Error::Default
1269 * Moose::Error::Croak
1270 * Moose::Error::Confess
1271 - All instances of confess() changed to use overridable
1272 C<throw_error> method. This method ultimately calls a class
1273 constructor, and you can change the class being called. In
1274 addition, errors now pass more information than just a string.
1275 The default C<error_class> behaves like C<Carp::confess>, so
1276 the behavior is not visibly different for end users.
1278 0.57 Wed September 3, 2008
1280 - A new bit of doc intended to introduce folks familiar with
1281 "standard" Perl 5 OO to Moose concepts. (Dave Rolsky)
1283 * Moose::Unsweetened
1284 - Shows examples of two classes, each done first with and then
1285 without Moose. This makes a nice parallel to
1286 Moose::Intro. (Dave Rolsky)
1288 * Moose::Util::TypeConstraints
1289 - Fixed a bug in find_or_parse_type_constraint so that it
1290 accepts a Moose::Meta::TypeConstraint object as the parent
1291 type, not just a name (jnapiorkowski)
1292 - added tests (jnapiorkowski)
1295 - If Sub::Name was not present, unimporting failed to actually
1296 remove some sugar subs, causing test failures (Dave Rolsky)
1298 0.56 Mon September 1, 2008
1299 For those not following the series of dev releases, there are
1300 several major changes in this release of Moose.
1301 ! Moose::init_meta should now be called as a method. See the
1304 - Major performance improvements by nothingmuch.
1306 - New modules for extension writers, Moose::Exporter and
1307 Moose::Util::MetaRole by Dave Rolsky.
1309 - Lots of doc improvements and additions, especially in the
1312 - Various bug fixes.
1314 * Removed all references to the experimental-but-no-longer-needed
1315 Moose::Meta::Role::Application::ToMetaclassInstance.
1317 * Require Class::MOP 0.65.
1319 0.55_04 Sat August 30, 2008
1320 * Moose::Util::MetaRole
1321 * Moose::Cookbook::Extending::Recipe2
1322 - This simplifies the application of roles to any meta class, as
1323 well as the base object class. Reimplemented metaclass traits
1324 using this module. (Dave Rolsky)
1326 * Moose::Cookbook::Extending::Recipe1
1327 - This a new recipe, an overview of various ways to write Moose
1328 extensions (Dave Rolsky)
1330 * Moose::Cookbook::Extending::Recipe3
1331 * Moose::Cookbook::Extending::Recipe4
1332 - These used to be Extending::Recipe1 and Extending::Recipe2,
1335 0.55_03 Fri August 29, 2008
1336 * No changes from 0.55_02 except increasing the Class::MOP
1337 dependency to 0.64_07.
1339 0.55_02 Fri August 29, 2008
1340 * Makefile.PL and Moose.pm
1341 - explicitly require Perl 5.8.0+ (Dave Rolsky)
1343 * Moose::Util::TypeConstraints
1344 - Fix warnings from find_type_constraint if the type is not
1347 * Moose::Meta::TypeConstraint
1348 - Predicate methods (equals/is_a_type_of/is_subtype_of) now
1349 return false if the type you specify cannot be found in the
1350 type registry, rather than throwing an unhelpful and
1351 coincidental exception. (t0m).
1352 - added docs & test for this (t0m)
1354 * Moose::Meta::TypeConstraint::Registry
1355 - add_type_constraint now throws an exception if a parameter is
1357 - added docs & test for this (t0m)
1359 * Moose::Cookbook::FAQ
1360 - Added a faq entry on the difference between "role" and "trait"
1364 - Fixed a bug that caused role composition to not see a required
1365 method when that method was provided by another role being
1366 composed at the same time. (Dave Rolsky)
1367 - test and bug finding (tokuhirom)
1369 0.55_01 Wed August 20, 2008
1371 !! Calling Moose::init_meta as a function is now !!
1372 !! deprecated. Please see the Moose.pm docs for details. !!
1374 * Moose::Meta::Method::Constructor
1375 - Fix inlined constructor so that values produced by default
1376 or builder methods are coerced as required. (t0m)
1377 - added test for this (t0m)
1379 * Moose::Meta::Attribute
1380 - A lazy attribute with a default or builder did not attempt to
1381 coerce the default value. The immutable code _did_
1383 - added test for this (t0m)
1386 - This is a new helper module for writing "Moose-alike"
1387 modules. This should make the lives of MooseX module authors
1388 much easier. (Dave Rolsky)
1391 * Moose::Cookbook::Meta::Recipe5
1392 - Implemented metaclass traits (and wrote a recipe for it):
1394 use Moose -traits => 'Foo'
1396 This should make writing small Moose extensions a little
1397 easier (Dave Rolsky)
1399 * Moose::Cookbook::Basics::Recipe1
1400 - Removed any examples of direct hashref access, and applied an
1401 editorial axe to reduce verbosity. (Dave Rolsky)
1403 * Moose::Cookbook::Basics::Recipe1
1404 - Also applied an editorial axe here. (Dave Rolsky)
1407 * Moose::Cookbook::Extending::Recipe1
1408 * Moose::Cookbook::Extending::Recipe2
1409 - Rewrote extending and embedding moose documentation and
1410 recipes to use Moose::Exporter (Dave Rolsky)
1414 - These two modules now warn when you load them from the main
1415 package "main" package, because we will not export sugar to
1416 main. Previously it just did nothing. (Dave Rolsky)
1419 - Now provide an init_meta method just like Moose.pm, and you
1420 can call this to provide an alternate role metaclass. (Dave
1421 Rolsky and nothingmuch)
1422 - get_method_map now respects the package cache flag (nothingmuch)
1425 - Two new methods - add_method and wrap_method_body
1429 - Optimizations including allowing constructors to accept hash
1430 refs, making many more classes immutable, and making
1431 constructors immutable. (nothingmuch)
1433 0.55 Sun August 3, 2008
1434 * Moose::Meta::Attribute
1435 - breaking down the way 'handles' methods are
1436 created so that the process can be more easily
1437 overridden by subclasses (stevan)
1439 * Moose::Meta::TypeConstraint
1440 - fixing what is passed into a ->message with
1441 the type constraints (RT #37569)
1442 - added tests for this (Charles Alderman)
1444 * Moose::Util::TypeConstraints
1445 - fix coerce to accept anon types like subtype can (mst)
1448 - reorganized the recipes into sections - Basics, Roles, Meta,
1449 Extending - and wrote abstracts for each section (Dave Rolsky)
1451 * Moose::Cookbook::Basics::Recipe10
1452 - A new recipe that demonstrates operator overloading
1453 in combination with Moose. (bluefeet)
1455 * Moose::Cookbook::Meta::Recipe1
1456 - an introduction to what meta is and why you'd want to make
1457 your own metaclass extensions (Dave Rolsky)
1459 * Moose::Cookbook::Meta::Recipe4
1460 - a very simple metaclass example (Dave Rolsky)
1462 * Moose::Cookbook::Extending::Recipe1
1463 - how to write a Moose-alike module to use your own object base
1466 * Moose::Cookbook::Extending::Recipe2
1467 - how to write modules with an API just like C<Moose.pm> (Dave
1471 - Tons of fixes, both syntactical and grammatical (Dave
1472 Rolsky, Paul Fenwick)
1474 0.54 Thurs. July 3, 2008
1475 ... this is not my day today ...
1477 * Moose::Meta::Attribute
1478 - fixed legal_options_for_inheritance such that
1479 clone_and_inherit options still works for
1480 Class::MOP::Attribute objects and therefore
1481 does not break MooseX::AttributeHelpers
1484 0.53 Thurs. July 3, 2008
1485 * Whoops, I guess I should run 'make manifest' before
1486 actually releasing the module. No actual changes
1487 in this release, except the fact that it includes
1488 the changes that I didn't include in the last
1491 0.52 Thurs. July 3, 2008
1493 - added "FEATURE REQUESTS" section to the Moose docs
1494 to properly direct people (stevan) (RT #34333)
1495 - making 'extends' croak if it is passed a Role since
1496 this is not ever something you want to do
1497 (fixed by stevan, found by obra)
1498 - added tests for this (stevan)
1501 - adding support for DOES (as in UNIVERSAL::DOES)
1503 - added test for this
1505 * Moose::Meta::Attribute
1506 - added legal_options_for_inheritance (wreis)
1507 - added tests for this (wreis)
1509 * Moose::Cookbook::Snacks::*
1510 - removed some of the unfinished snacks that should
1511 not have been released yet. Added some more examples
1512 to the 'Keywords' snack. (stevan)
1514 * Moose::Cookbook::Style
1515 - added general Moose "style guide" of sorts to the
1516 cookbook (nothingmuch) (RT #34335)
1519 - added more BUILDARGS tests (stevan)
1521 0.51 Thurs. Jun 26, 2008
1523 - add unimport so "no Moose::Role" actually does
1526 * Moose::Meta::Role::Application::ToRole
1527 - when RoleA did RoleB, and RoleA aliased a method from RoleB in
1528 order to provide its own implementation, that method still got
1529 added to the list of required methods for consumers of
1530 RoleB. Now an aliased method is only added to the list of
1531 required methods if the role doing the aliasing does not
1532 provide its own implementation. See Recipe 11 for an example
1533 of all this. (Dave Rolsky)
1534 - added tests for this
1536 * Moose::Meta::Method::Constructor
1537 - when a single argument that wasn't a hashref was provided to
1538 an immutabilized constructor, the error message was very
1539 unhelpful, as opposed to the non-immutable error. Reported by
1541 - added test for this (Dave Rolsky)
1543 * Moose::Meta::Attribute
1544 - added support for meta_attr->does("ShortAlias") (sartak)
1545 - added tests for this (sartak)
1546 - moved the bulk of the `handles` handling to the new
1547 install_delegation method (Stevan)
1550 - Added BUILDARGS, a new step in new()
1552 * Moose::Meta::Role::Application::RoleSummation
1553 - fix typos no one ever sees (sartak)
1555 * Moose::Util::TypeConstraints
1556 * Moose::Meta::TypeConstraint
1557 * Moose::Meta::TypeCoercion
1558 - Attempt to work around the ??{ } vs. threads issue
1560 - Some null_constraint optimizations
1562 0.50 Thurs. Jun 11, 2008
1563 - Fixed a version number issue by bumping all modules
1566 0.49 Thurs. Jun 11, 2008
1567 !! This version now approx. 20-25% !!
1568 !! faster with new Class::MOP 0.59 !!
1570 * Moose::Meta::Attribute
1571 - fixed how the is => (ro|rw) works with
1572 custom defined reader, writer and accessor
1574 - added docs for this (TODO).
1575 - added tests for this (Thanks to Penfold)
1576 - added the custom attribute alias for regular
1577 Moose attributes which is "Moose"
1578 - fix builder and default both being used
1583 Moose::Meta::Attribute
1585 Moose::Meta::Role::Composite
1586 Moose::Util::TypeConstraints
1587 - switched usage of reftype to ref because
1591 - changing add_package_symbol to use the new
1595 - fixed how DEMOLISHALL is called so that it
1596 can be overrided in subclasses (thanks to Sartak)
1597 - added test for this (thanks to Sartak)
1599 * Moose::Util::TypeConstraints
1600 - move the ClassName type check code to
1601 Class::MOP::is_class_loaded (thanks to Sartak)
1603 * Moose::Cookbook::Recipe11
1604 - add tests for this (thanks to tokuhirom)
1606 0.48 Thurs. May 29, 2008
1607 (early morning release engineering)--
1609 - fixing the version in Moose::Meta::Method::Destructor
1610 which was causing the indexer to choke
1612 0.47 Thurs. May 29, 2008
1613 (late night release engineering)--
1615 - fixing the version is META.yml, no functional
1616 changes in this release
1618 0.46 Wed. May 28, 2008
1619 !! This version now approx. 20-25% !!
1620 !! faster with new Class::MOP 0.57 !!
1622 * Moose::Meta::Class
1623 - some optimizations of the &initialize method
1624 since it is called so often by &meta
1626 * Moose::Meta::Class
1628 - now use the get_all_package_symbols from the
1629 updated Class::MOP, test suite is now 10 seconds
1632 * Moose::Meta::Method::Destructor
1633 - is_needed can now also be called as a class
1634 method for immutablization to check if the
1635 destructor object even needs to be created
1638 * Moose::Meta::Method::Destructor
1639 Moose::Meta::Method::Constructor
1640 - added more descriptive error message to help
1641 keep people from wasting time tracking an error
1642 that is easily fixed by upgrading.
1644 0.45 Saturday, May 24, 2008
1646 - Because of work in Class::MOP 0.57, all
1647 XS based functionality is now optional
1648 and a Pure Perl version is supplied
1649 - the CLASS_MOP_NO_XS environment variable
1650 can now be used to force non-XS versions
1652 - several of the packages have been tweaked
1653 to take care of this, mostly we added
1654 support for the package_name and name
1655 variables in all the Method metaclasses
1656 - before/around/after method modifiers now
1657 support regexp matching of names
1658 (thanks to Takatoshi Kitano)
1659 - tests added for this
1660 - NOTE: this only works for classes, it
1661 is currently not supported in roles,
1662 but, ... patches welcome
1663 - All usage of Carp::confess have been replaced
1664 by Carp::croak in the "keyword" functions since
1665 the stack trace is usually not helpful
1668 - All usage of Carp::confess have been replaced
1669 by Carp::croak in the "keyword" functions since
1670 the stack trace is usually not helpful
1671 - The 'has' keyword for roles now accepts the
1672 same array ref form that Moose.pm does
1673 (has [qw/foo bar/] => (is => 'rw', ...))
1674 - added test for this
1676 * Moose::Meta::Attribute
1677 - trigger on a ro-attribute is no longer an
1678 error, as it's useful to trigger off of the
1681 * Moose::Meta::Class
1682 - added same 'add_package_symbol' fix as in
1686 - does_role now handles non-Moose classes
1688 - added tests for this
1689 - added the 'add_method_modifier' function
1690 (thanks to Takatoshi Kitano)
1692 * Moose::Util::TypeConstraints
1693 - subtypes of parameterizable types now are
1694 themselves parameterizable types
1696 * Moose::Meta::Method::Constructor
1697 - fixed bug where trigger was not being
1698 called by the inlined immutable
1700 - added test for this (thanks to Caelum)
1702 * Moose::Meta::Role::Application::ToInstance
1703 - now uses the metaclass of the instance
1704 (if possible) to create the anon-class
1705 (thanks Jonathan Rockway)
1707 * Moose::Cookbook::Recipe22
1708 - added the meta-attribute trait recipe
1712 - fixed hash-ordering test bug that was
1713 causing occasional cpantester failures
1714 - renamed the t/000_recipe/*.t tests to be
1715 more descriptive (thanks to Sartak)
1717 0.44 Sat. May 10, 2008
1719 - made make_immutable warning cluck to
1720 show where the error is (thanks mst)
1723 - BUILDALL and DEMOLISHALL now call
1724 ->body when looping through the
1725 methods, to avoid the overloaded
1727 - fixed issue where DEMOLISHALL was
1728 eating the $@ values, and so not
1729 working correctly, it still kind of
1730 eats them, but so does vanilla perl
1731 - added tests for this
1733 * Moose::Cookbook::Recipe7
1734 - added new recipe for immutable
1735 functionality (thanks Dave Rolsky)
1737 * Moose::Cookbook::Recipe9
1738 - added new recipe for builder and
1739 lazy_build (thanks Dave Rolsky)
1741 * Moose::Cookbook::Recipe11
1742 - added new recipe for method aliasing
1743 and exclusion with Roles (thanks Dave Rolsky)
1746 - fixed Win32 test failure (thanks spicyjack)
1748 ~ removed Build.PL and Module::Build compat
1749 since Module::Install has done that.
1751 0.43 Wed. April, 30, 2008
1753 drink more coffee before
1754 doing release engineering
1756 - whoops, forgot to do the smolder tests,
1757 and we broke some of the custom meta-attr
1758 modules. This fixes that.
1760 0.42 Mon. April 28, 2008
1761 - some bad tests slipped by, nothing else
1762 changed in this release (cpantesters++)
1764 - upped the Class::MOP dependency to 0.55
1765 since we have tests which need the C3
1768 0.41 Mon. April 28, 2008
1769 ~~ numerous documentation updates ~~
1771 - Changed all usage of die to Carp::croak for better
1772 error reporting (initial patch by Tod Hagan)
1774 ** IMPORTANT NOTE **
1775 - the make_immutable keyword is now deprecated, don't
1776 use it in any new code and please fix your old code
1777 as well. There will be 2 releases, and then it will
1783 - refactored the way inner and super work to avoid
1784 any method/@ISA cache penalty (nothingmuch)
1786 * Moose::Meta::Class
1787 - fixing &new_object to make sure trigger gets the
1788 coerced value (spotted by Charles Alderman on the
1790 - added test for this
1792 * Moose::Meta::Method::Constructor
1793 - immutable classes which had non-lazy attributes were calling
1794 the default generating sub twice in the constructor. (bug
1795 found by Jesse Luehrs, fixed by Dave Rolsky)
1796 - added tests for this (Dave Rolsky)
1797 - fix typo in initialize_body method (nothingmuch)
1799 * Moose::Meta::Method::Destructor
1800 - fix typo in initialize_body method (nothingmuch)
1802 * Moose::Meta::Method::Overriden
1803 Moose::Meta::Method::Augmented
1804 - moved the logic for these into their own
1805 classes (nothingmuch)
1807 * Moose::Meta::Attribute
1808 - inherited attributes may now be extended without
1809 restriction on the type ('isa', 'does') (Sartak)
1810 - added tests for this (Sartak)
1811 - when an attribute property is malformed (such as lazy without
1812 a default), give the name of the attribute in the error
1814 - added the &applied_traits and &has_applied_traits methods
1815 to allow introspection of traits
1816 - added tests for this
1817 - moved 'trait' and 'metaclass' argument handling to here from
1819 - clone_and_inherit_options now handles 'trait' and 'metaclass' (has
1820 '+foo' syntax) (nothingmuch)
1821 - added tests for this (t0m)
1824 - localize $@ inside DEMOLISHALL to avoid it
1825 eating $@ (found by Ernesto)
1826 - added test for this (thanks to Ernesto)
1828 * Moose::Util::TypeConstraints
1829 - &find_type_constraint now DWIMs when given an
1830 type constraint object or name (nothingmuch)
1831 - &find_or_create_type_constraint superseded with a number of more
1833 - find_or_create_{isa,does}_type_constraint
1834 - find_or_parse_type_constraint
1836 * Moose::Meta::TypeConstraint
1837 Moose::Meta::TypeConstraint::Class
1838 Moose::Meta::TypeConstraint::Role
1839 Moose::Meta::TypeConstraint::Enum
1840 Moose::Meta::TypeConstraint::Union
1841 Moose::Meta::TypeConstraint::Parameterized
1842 - added the &equals method for comparing two type
1843 constraints (nothingmuch)
1844 - added tests for this (nothingmuch)
1846 * Moose::Meta::TypeConstraint
1847 - add the &parents method, which is just an alias to &parent.
1848 Useful for polymorphism with TC::{Class,Role,Union} (nothingmuch)
1850 * Moose::Meta::TypeConstraint::Class
1851 - added the class attribute for introspection purposes
1853 - added tests for this
1855 * Moose::Meta::TypeConstraint::Enum
1856 Moose::Meta::TypeConstraint::Role
1857 - broke these out into their own classes (nothingmuch)
1859 * Moose::Cookbook::Recipe*
1860 - fixed references to test file locations in the POD
1861 and updated up some text for new Moose features
1865 - Added &resolve_metaclass_alias, a helper function for finding an actual
1866 class for a short name (e.g. in the traits list)
1868 0.40 Fri. March 14, 2008
1869 - I hate Pod::Coverage
1871 0.39 Fri. March 14, 2008
1873 - documenting the use of '+name' with attributes
1874 that come from recently composed roles. It makes
1875 sense, people are using it, and so why not just
1876 officially support it.
1877 - fixing the 'extends' keyword so that it will not
1878 trigger Ovid's bug (http://use.perl.org/~Ovid/journal/35763)
1881 - added the perl -Moose=+Class::Name feature to allow
1882 monkeypatching of classes in one liners
1885 - fixing the 'apply_all_roles' keyword so that it will not
1886 trigger Ovid's bug (http://use.perl.org/~Ovid/journal/35763)
1888 * Moose::Meta::Class
1889 - added ->create method which now supports roles (thanks to jrockway)
1890 - added tests for this
1891 - added ->create_anon_class which now supports roles and caching of
1892 the results (thanks to jrockway)
1893 - added tests for this
1894 - made ->does_role a little more forgiving when it is
1895 checking a Class::MOP era metaclasses.
1897 * Moose::Meta::Role::Application::ToInstance
1898 - it is now possible to pass extra params to be used when
1899 a role is applied to an the instance (rebless_params)
1900 - added tests for this
1902 * Moose::Util::TypeConstraints
1903 - class_type now accepts an optional second argument for a
1904 custom message. POD anotated accordingly (groditi)
1905 - added tests for this
1906 - it is now possible to make anon-enums by passing 'enum' an
1907 ARRAY ref instead of the $name => @values. Everything else
1909 - added tests for this
1912 - making test for using '+name' on attributes consumed
1913 from a role, it works and makes sense too.
1915 * Moose::Meta::Attribute
1916 - fix handles so that it doesn't return nothing
1917 when the method cannot be found, not sure why
1918 it ever did this originally, this means we now
1919 have slightly better support for AUTOLOADed
1921 - added more delegation tests
1922 - adding ->does method to this so as to better
1923 support traits and their introspection.
1924 - added tests for this
1927 - localizing the Data::Dumper configurations so
1928 that it does not pollute others (RT #33509)
1929 - made ->does a little more forgiving when it is
1930 passed Class::MOP era metaclasses.
1932 0.38 Fri. Feb. 15, 2008
1933 * Moose::Meta::Attribute
1934 - fixed initializer to correctly do
1935 type checking and coercion in the
1937 - added tests for this
1940 - fixed some finicky tests (thanks to konobi)
1942 0.37 Thurs. Feb. 14, 2008
1944 - fixed some details in Moose::init_meta
1945 and its superclass handling (thanks thepler)
1946 - added tests for this (thanks thepler)
1947 - 'has' now dies if you don't pass in name
1949 - added the 'make_immutable' keyword as a shortcut
1952 * Moose::Meta::Class
1953 Moose::Meta::Method::Constructor
1954 Moose::Meta::Attribute
1955 - making (init_arg => undef) work here too
1956 (thanks to nothingmuch)
1958 * Moose::Meta::Attribute
1959 Moose::Meta::Method::Constructor
1960 Moose::Meta::Method::Accessor
1961 - make lazy attributes respect attr initializers (rjbs)
1962 - added tests for this
1964 * Moose::Util::TypeConstraints
1965 Moose::Util::TypeConstraints::OptimizedConstraints
1966 Moose::Meta::TypeConstraints
1967 Moose::Meta::Attribute
1968 Moose::Meta::Method::Constructor
1969 Moose::Meta::Method::Accessor
1970 - making type errors use the
1971 assigned message (thanks to Sartak)
1972 - added tests for this
1974 * Moose::Meta::Method::Destructor
1975 - making sure DESTROY gets inlined properly
1976 with successive DEMOLISH calls (thanks to manito)
1978 * Moose::Meta::Attribute
1979 Moose::Meta::Method::Accessor
1980 - fixed handling of undef with type constraints
1982 - added tests for this
1985 - added &get_all_init_args and &get_all_attribute_values
1986 (thanks to Sartak and nothingmuch)
1988 0.36 Sat. Jan. 26, 2008
1990 Moose::Meta::Attribute
1991 - role type tests now support when roles are
1992 applied to non-Moose classes (found by ash)
1993 - added tests for this (thanks to ash)
1994 - couple extra tests to boost code coverage
1996 * Moose::Meta::Method::Constructor
1997 - improved fix for handling Class::MOP attributes
1998 - added test for this
2000 * Moose::Meta::Class
2001 - handled the add_attribute($attribute_meta_object)
2003 - added test for this
2005 0.35 Tues. Jan. 22, 2008
2006 * Moose::Meta::Method::Constructor
2007 - fix to make sure even Class::MOP attributes
2008 are handled correctly (Thanks to Dave Rolsky)
2009 - added test for this (also Dave Rolsky)
2011 * Moose::Meta::Class
2012 - improved error message on _apply_all_roles,
2013 you should now use Moose::Util::apply_all_roles
2014 and you shouldnt have been using a _ prefixed
2015 method in the first place ;)
2017 0.34 Mon. Jan. 21, 2008
2018 ~~~ more misc. doc. fixes ~~~
2019 ~~ updated copyright dates ~~
2021 Moose is now a postmodern object system :)
2022 - (see the POD for details)
2024 * <<Role System Refactoring>>
2025 - this release contains a major reworking and
2026 cleanup of the role system
2027 - 100% backwards compat.
2028 - Role application now restructured into seperate
2029 classes based on type of applicants
2030 - Role summation (combining of more than one role)
2031 is much cleaner and anon-classes are no longer
2032 used in this process
2033 - new Composite role metaclass
2034 - runtime application of roles to instances
2035 is now more efficient and re-uses generated
2036 classes when applicable
2038 * <<New Role composition features>>
2039 - methods can now be excluded from a given role
2041 - methods can now be aliased to another name (and
2042 still retain the original as well)
2044 * Moose::Util::TypeConstraints::OptimizedConstraints
2045 - added this module (see above)
2047 * Moose::Meta::Class
2048 - fixed the &_process_attribute method to be called
2049 by &add_attribute, so that the API is now correct
2051 * Moose::Meta::Method::Accessor
2052 - fixed bug when passing a list of values to
2053 an accessor would get (incorrectly) ignored.
2054 Thanks to Sartak for finding this ;)
2055 - added tests for this (Sartak again)
2057 * Moose::Meta::Method::Accessor
2058 Moose::Meta::Method::Constructor
2059 Moose::Meta::Attribute
2060 Moose::Meta::TypeConstraint
2061 Moose::Meta::TypeCoercion
2062 - lots of cleanup of such things as:
2064 - type constraint handling
2065 - error handling/messages
2066 (thanks to nothingmuch)
2068 * Moose::Meta::TypeConstraint::Parameterizable
2069 - added this module to support the refactor
2070 in Moose::Meta::TypeConstraint::Parameterized
2072 * Moose::Meta::TypeConstraint::Parameterized
2073 - refactored how these types are handled so they
2074 are more generic and not confined to ArrayRef
2078 - shortened some file names for better VMS support (RT #32381)
2080 0.33 Fri. Dec. 14, 2007
2081 !! Moose now loads 2 x faster !!
2082 !! with new Class::MOP 0.49 !!
2084 ++ new oose.pm module to make command line
2085 Moose-ness easier (see POD docs for more)
2087 * Moose::Meta::Class
2089 - several tweaks to take advantage of the
2090 new method map caching in Class::MOP
2092 * Moose::Meta::TypeConstraint::Parameterized
2093 - allow subtypes of ArrayRef and HashRef to
2094 be used as a container (sartak)
2095 - added tests for this
2096 - basic support for coercion to ArrayRef and
2097 HashRef for containers (sartak)
2098 - added tests for this
2100 * Moose::Meta::TypeCoercion
2101 - coercions will now create subtypes as needed
2102 so you can now add coercions to parameterized
2103 types without having to explictly define them
2104 - added tests for this
2106 * Moose::Meta::Method::Accessor
2107 - allow subclasses to decide whether we need
2108 to copy the value into a new variable (sartak)
2110 0.32 Tues. Dec. 4, 2007
2111 * Moose::Util::TypeConstraints
2112 - fixing how subtype aliases of unions work
2113 they should inherit the parent's coercion
2114 - added tests for this
2115 - you can now define multiple coercions on
2116 a single type at different times instead of
2117 having to do it all in one place
2118 - added tests for this
2120 * Moose::Meta::TypeConstraint
2121 - there is now a default constraint of sub { 1 }
2122 instead of Moose::Util::TypeConstraints setting
2125 * Moose::Meta::TypeCoercion
2126 * Moose::Meta::TypeCoercion::Union
2127 - added the &has_coercion_for_type and
2128 &add_type_coercions methods to support the
2129 new features above (although you cannot add
2130 more type coercions for Union types)
2132 0.31 Mon. Nov. 26, 2007
2133 * Moose::Meta::Attribute
2134 - made the +attr syntax handle extending types with
2135 parameters. So "has '+foo' => (isa => 'ArrayRef[Int]')"
2136 now works if the original foo is an ArrayRef.
2137 - added tests for this.
2138 - delegation now works even if the attribute does not
2139 have a reader method using the get_read_method_ref
2140 method from Class::MOP::Attribute.
2141 - added tests for this
2142 - added docs for this
2144 * Moose::Util::TypeConstraints
2145 - passing no "additional attribute info" to
2146 &find_or_create_type_constraint will no longer
2147 attempt to create an __ANON__ type for you,
2148 instead it will just return undef.
2149 - added docs for this
2151 0.30 Fri. Nov. 23, 2007
2152 * Moose::Meta::Method::Constructor
2153 -builder related bug in inlined constructor. (groditi)
2155 * Moose::Meta::Method::Accessor
2156 - genereate unnecessary calls to predicates and refactor
2157 code generation for runtime speed (groditi)
2159 * Moose::Util::TypeConstraints
2160 - fix ClassName constraint to introspect symbol table (mst)
2161 - added more tests for this (mst)
2162 - fixed it so that subtype 'Foo' => as 'HashRef[Int]' ...
2163 with work correctly.
2164 - added tests for this
2167 - adding the link to Recipie 11 (written by Sartak)
2168 - adding test for SYNOPSIS code
2171 - New tests for builder bug. Upon instantiation, if an
2172 attribute had a builder, no value and was not lazy the
2173 builder default was not getting run, oops. (groditi)
2175 0.29 Tues. Nov. 13, 2007
2176 * Moose::Meta::Attribute
2177 - Fix error message on missing builder method (groditi)
2179 * Moose::Meta::Method::Accessor
2180 - Fix error message on missing builder method (groditi)
2183 - Add test to check for the correct error message when
2184 builder method is missing (groditi)
2186 0.28 Tues. Nov. 13, 2007
2187 - 0.27 packaged incorrectly (groditi)
2189 0.27 Tues. Nov. 13, 2007
2190 * Moose::Meta::Attribute
2191 - Added support for the new builder option (groditi)
2192 - Added support for lazy_build option (groditi)
2193 - Changed slot initialization for predicate changes (groditi)
2195 * Moose::Meta::Method::Accessor
2196 - Added support for lazy_build option (groditi)
2197 - Fix inline methods to work with corrected predicate
2200 * Moose::Meta::Method::Constructor
2201 - Added support for lazy_build option (groditi)
2204 - tests for builder and lazy_build (groditi)
2206 * fixing some misc. bits in the docs that
2207 got mentioned on CPAN Forum & perlmonks
2210 - fixed how required methods are handled
2211 when they encounter overriden or modified
2212 methods from a class (thanks to confound).
2213 - added tests for this
2215 * Moose::Util::TypeConstraint
2216 - fixed the type notation parser so that
2217 the | always creates a union and so is
2218 no longer a valid type char (thanks to
2219 konobi, mugwump and #moose for working
2221 - added more tests for this
2223 0.26 Thurs. Sept. 27, 2007
2226 * Parameterized Types
2227 We now support parameterized collection types, such as:
2228 ArrayRef[Int] # array or integers
2229 HashRef[Object] # a hash with object values
2230 They can also be nested:
2231 ArrayRef[HashRef[RegexpRef]] # an array of hashes with regex values
2232 And work with the type unions as well:
2233 ArrayRef[Int | Str] # array of integers of strings
2235 * Better Framework Extendability
2236 Moose.pm is now "extendable" such that it is now much
2237 easier to extend the framework and add your own keywords
2238 and customizations. See the "EXTENDING AND EMBEDDING MOOSE"
2239 section of the Moose.pm docs.
2242 In an effort to begin documenting some of the various
2243 details of Moose as well as some common idioms, we have
2244 created Moose::Cookbook::Snacks as a place to find
2245 small (easily digestable) nuggets of Moose code.
2248 ~ Several doc updates/cleanup thanks to castaway ~
2250 - converted build system to use Module::Install instead of
2251 Module::Build (thanks to jrockway)
2254 - added all the meta classes to the immutable list and
2255 set it to inline the accessors
2256 - fix import to allow Sub::Exporter like { into => }
2257 and { into_level => } (perigrin)
2258 - exposed and documented init_meta() to allow better
2259 embedding and extending of Moose (perigrin)
2262 - complete re-organization of the test suite
2263 - added some new tests as well
2264 - finally re-enabled the Moose::POOP test since
2265 the new version of DBM::Deep now works again
2268 * Moose::Meta::Class
2269 - fixed very odd and very nasty recursion bug with
2271 - added tests for this (eilara)
2273 * Moose::Meta::Attribute
2274 Moose::Meta::Method::Constructor
2275 Moose::Meta::Method::Accessor
2276 - fixed issue with overload::Overloaded getting called
2277 on non-blessed items. (RT #29269)
2278 - added tests for this
2280 * Moose::Meta::Method::Accessor
2281 - fixed issue with generated accessor code making
2282 assumptions about hash based classes (thanks to dexter)
2284 * Moose::Coookbook::Snacks
2285 - these are bits of documentation, not quite as big as
2286 Recipes but which have no clear place in the module docs.
2287 So they are Snacks! (horray for castaway++)
2289 * Moose::Cookbook::Recipe4
2290 - updated it to use the new ArrayRef[MyType] construct
2291 - updated the accompanying test as well
2293 +++ Major Refactor of the Type Constraint system +++
2294 +++ with new features added as well +++
2296 * Moose::Util::TypeConstraint
2297 - no longer uses package variable to keep track of
2298 the type constraints, now uses the an instance of
2299 Moose::Meta::TypeConstraint::Registry to do it
2300 - added more sophisticated type notation parsing
2302 - added tests for this
2304 * Moose::Meta::TypeConstraint
2305 - some minor adjustments to make subclassing easier
2306 - added the package_defined_in attribute so that we
2307 can track where the type constraints are created
2309 * Moose::Meta::TypeConstraint::Union
2310 - this is now been refactored to be a subclass of
2311 Moose::Meta::TypeConstraint
2313 * Moose::Meta::TypeCoercion::Union
2314 - this has been added to service the newly refactored
2315 Moose::Meta::TypeConstraint::Union and is itself
2316 a subclass of Moose::Meta::TypeCoercion
2318 * Moose::Meta::TypeConstraint::Parameterized
2319 - added this module (taken from MooseX::AttributeHelpers)
2320 to help construct nested collection types
2321 - added tests for this
2323 * Moose::Meta::TypeConstraint::Registry
2324 - added this class to keep track of type constraints
2326 0.25 Mon. Aug. 13, 2007
2328 - Documentation update to reference Moose::Util::TypeConstraints
2329 under 'isa' in 'has' for how to define a new type
2330 (thanks to shlomif).
2332 * Moose::Meta::Attribute
2333 - required attributes now will no longer accept undef
2334 from the constructor, even if there is a default and lazy
2335 - added tests for this
2336 - default subroutines must return a value which passes the
2338 - added tests for this
2340 * Moose::Meta::Attribute
2341 * Moose::Meta::Method::Constructor
2342 * Moose::Meta::Method::Accessor
2343 - type-constraint tests now handle overloaded objects correctly
2344 in the error message
2345 - added tests for this (thanks to EvanCarroll)
2347 * Moose::Meta::TypeConstraint::Union
2348 - added (has_)hand_optimized_constraint to this class so that
2349 it behaves as the regular Moose::Meta::TypeConstraint does.
2352 - large refactoring of this code
2353 - added several more tests
2354 - tests for subtle conflict resolition issues
2355 added, but not currently running
2358 * Moose::Cookbook::Recipe7
2359 - added new recipe for augment/inner functionality
2361 - added test for this
2364 - a formal definition of roles (still in progress)
2367 - utilities for easier working with Moose classes
2368 - added tests for these
2371 - This contains Moose specific test functions
2372 - added tests for these
2374 0.24 Tues. July 3, 2007
2375 ~ Some doc updates/cleanup ~
2377 * Moose::Meta::Attribute
2378 - added support for roles to be given as parameters
2379 to the 'handles' option.
2380 - added tests and docs for this
2381 - the has '+foo' attribute form now accepts changes to
2382 the lazy option, and the addition of a handles option
2383 (but not changing the handles option)
2384 - added tests and docs for this
2387 - required methods are now fetched using find_method_by_name
2388 so that required methods can come from superclasses
2389 - adjusted tests for this
2391 0.23 Mon. June 18, 2007
2392 * Moose::Meta::Method::Constructor
2393 - fix inlined constructor for hierarchy with multiple BUILD methods (mst)
2394 * Moose::Meta::Class
2395 - Modify make_immutable to work with the new Class::MOP immutable
2396 mechanism + POD + very basic test (groditi)
2397 * Moose::Meta::Attribute
2398 - Fix handles to use goto() so that caller() comes out properly on
2399 the other side (perigrin)
2401 0.22 Thurs. May 31, 2007
2402 * Moose::Util::TypeConstraints
2403 - fix for prototype undeclared issue when Moose::Util::TypeConstraints
2404 loaded before consumers (e.g. Moose::Meta::Attribute) by predeclaring
2405 prototypes for functions
2406 - added the ClassName type constraint, this checks for strings
2407 which will respond true to ->isa(UNIVERSAL).
2408 - added tests and docs for this
2409 - subtyping just in name now works correctly by making the
2410 default for where be { 1 }
2411 - added test for this
2413 * Moose::Meta::Method::Accessor
2414 - coerce and lazy now work together correctly, thanks to
2415 merlyn for finding this bug
2416 - tests added for this
2417 - fix reader presedence bug in Moose::Meta::Attribute + tests
2420 - Foo->new(undef) now gets ignored, it is assumed you meant to pass
2421 a HASH-ref and missed. This produces better error messages then
2422 having it die cause undef is not a HASH.
2423 - added tests for this
2425 0.21 Thursday, May 2nd, 2007
2427 - added SUPER_SLOT and INNER_SLOT class hashes to support unimport
2428 - modified unimport to remove super and inner along with the rest
2429 - altered unimport tests to handle this
2432 - altered super export to populate SUPER_SLOT
2434 * Moose::Meta::Class
2435 - altered augment and override modifier application to use *_SLOT
2436 - modified tests for these to unimport one test class each to test
2439 - fixed issue where custom attribute metaclasses
2440 where not handled correctly in roles
2441 - added tests for this
2443 * Moose::Meta::Class
2444 - fixed issue where extending metaclasses with
2445 roles would blow up. Thanks to Aankhen`` for
2446 finding this insidious error, and it's solution.
2448 ~~ lots of spelling and grammer fixes in the docs,
2449 many many thanks to rlb3 and Aankhen for these :)
2451 0.20 Friday, April 6th, 2007
2452 >> I messed up the SKIP logic in one test
2453 so this release is just to fix that.
2456 - 'has' now also accepts an ARRAY ref
2457 to create multiple attrs (see docs)
2458 (thanks to konobi for this)
2459 - added tests and docs
2461 0.19 Thurs. April 5th, 2007
2462 ~~ More documentation updates ~~
2464 * Moose::Util::TypeConstraints
2465 - 'type' now supports messages as well
2466 thanks to phaylon for finding this
2467 - added tests for this
2468 - added &list_all_type_constraints and
2469 &list_all_builtin_type_constraints
2470 functions to facilitate introspection.
2472 * Moose::Meta::Attribute
2473 - fixed regexp 'handles' declarations
2474 to build the list of delegated methods
2475 correctly (and not override important
2476 things like &new) thanks to ashleyb
2478 - added tests and docs for this
2479 - added the 'documentation' attributes
2480 so that you can actually document your
2481 attributes and inspect them through the
2483 - added tests and docs for this
2485 * Moose::Meta::Class
2486 - when loading custom attribute metaclasses
2487 it will first look in for the class in the
2488 Moose::Meta::Attribute::Custom::$name, and
2489 then default to just loading $name.
2490 - added tests and docs for this
2492 * Moose::Meta::TypeConstraint
2493 - type constraints now stringify to their names.
2494 - added test for this
2497 - added tests to assure we work with Module::Refresh
2498 - added stricter test skip logic in the Moose POOP
2499 test, ask Rob Kinyon why.
2500 - *cough* DBM::Deep 1.0 backwards compatibility sucks *cough* ;)
2502 0.18 Sat. March 10, 2007
2503 ~~ Many, many documentation updates ~~
2506 - We now use Class::MOP::load_class to
2508 - added tests to show types and subtypes
2509 working with Declare::Constraints::Simple
2510 and Test::Deep as constraint engines.
2513 !! You must have Class::MOP 0.37_001 !!
2514 !! for this developer release to work !!
2516 This release was primarily adding the immutable
2517 feature to Moose. An immutable class is one which
2518 you promise not to alter. When you set the class
2519 as immutable it will perform various bits of
2520 memoization and inline certain part of the code
2521 (constructors, destructors and accessors). This
2522 minimizes (and in some cases totally eliminates)
2523 one of Moose's biggest performance hits. This
2524 feature is not on by default, and is 100% optional.
2525 It has several configurable bits as well, so you
2526 can pick and choose to your specific needs.
2528 The changes involved in this were fairly wide and
2529 highly specific, but 100% backwards compatible, so
2530 I am not going to enumerate them here. If you are
2531 truely interested in what was changed, please do
2534 0.17 Tues. Nov. 14, 2006
2535 * Moose::Meta::Method::Accessor
2536 - bugfix for read-only accessors which
2537 are have a type constraint and lazy.
2538 Thanks to chansen for finding it.
2540 0.16 Tues. Nov. 14, 2006
2542 There are some speed improvements in this release,
2543 but they are only the begining, so stay tuned.
2546 - BUILDALL and DEMOLISHALL no longer get
2547 called unless they actually need to be.
2548 This gave us a signifigant speed boost
2549 for the cases when there is no BUILD or
2550 DEMOLISH method present.
2552 * Moose::Util::TypeConstraints
2553 * Moose::Meta::TypeConstraint
2554 - added an 'optimize_as' option to the
2555 type constraint, which allows for a
2556 hand optimized version of the type
2557 constraint to be used when possible.
2558 - Any internally created type constraints
2559 now provide an optimized version as well.
2561 0.15 Sun. Nov. 5, 2006
2563 This version of Moose *must* have Class::MOP 0.36 in order
2564 to work correctly. A number of small internal tweaks have
2565 been made in order to be compatible with that release.
2567 * Moose::Util::TypeConstraints
2568 - added &unimport so that you can clean out
2569 your class namespace of these exported
2572 * Moose::Meta::Class
2573 - fixed minor issue which occasionally
2574 comes up during global destruction
2576 - moved Moose::Meta::Method::Overriden into
2580 - moved Moose::Meta::Role::Method into
2583 * Moose::Meta::Attribute
2584 - changed how we do type checks so that
2585 we reduce the overall cost, but still
2588 - moved accessor generation methods to
2589 Moose::Meta::Method::Accessor to
2590 conform to the API changes from
2593 * Moose::Meta::TypeConstraint
2594 - changed how constraints are compiled
2595 so that we do less recursion and more
2596 iteration. This makes the type check
2598 - moved Moose::Meta::TypeConstraint::Union
2601 * Moose::Meta::Method::Accessor
2602 - created this from methods formerly found in
2603 Moose::Meta::Attribute
2605 * Moose::Meta::Role::Method
2606 - moved this from Moose::Meta::Role
2608 * Moose::Meta::Method::Overriden
2609 - moved this from Moose::Meta::Class
2611 * Moose::Meta::TypeConstraint::Union
2612 - moved this from Moose::Meta::TypeConstraint
2614 0.14 Mon. Oct. 9, 2006
2616 * Moose::Meta::Attribute
2617 - fixed lazy attributes which were not getting
2618 checked with the type constraint (thanks ashley)
2619 - added tests for this
2620 - removed the over-enthusiastic DWIMery of the
2621 automatic ArrayRef and HashRef defaults, it
2622 broke predicates in an ugly way.
2623 - removed tests for this
2625 0.13 Sat. Sept. 30, 2006
2627 This version of Moose *must* have Class::MOP 0.35 in order
2628 to work correctly. A number of small internal tweaks have
2629 been made in order to be compatible with that release.
2632 - Removed the use of UNIVERSAL::require to be a better
2633 symbol table citizen and remove a dependency
2634 (thanks Adam Kennedy)
2636 **~~ removed experimental & undocumented feature ~~**
2637 - commented out the 'method' and 'self' keywords, see the
2638 comments for more info.
2641 - added a FAQ and WTF files to document frequently
2642 asked questions and common problems
2644 * Moose::Util::TypeConstraints
2645 - added GlobRef and FileHandle type constraint
2646 - added tests for this
2648 * Moose::Meta::Attribute
2649 - if your attribute 'isa' ArrayRef of HashRef, and you have
2650 not explicitly set a default, then make the default DWIM.
2651 This will also work for subtypes of ArrayRef and HashRef
2653 - you can now auto-deref subtypes of ArrayRef or HashRef too.
2654 - new test added for this (thanks to ashley)
2657 - added basic support for runtime role composition
2658 but this is still *highly experimental*, so feedback
2659 is much appreciated :)
2660 - added tests for this
2662 * Moose::Meta::TypeConstraint
2663 - the type constraint now handles the coercion process
2664 through delegation, this is to support the coercion
2667 * Moose::Meta::TypeConstraint::Union
2668 - it is now possible for coercions to be performed
2670 - added tests for this (thanks to konobi)
2672 * Moose::Meta::TypeCoercion
2673 - properly capturing error when type constraint
2677 - Scalar::Util 1.18 is bad on Win32, so temporarily
2678 only require version 1.17 for Win32 and cygwin.
2679 (thanks Adam Kennedy)
2681 0.12 Sat. Sept. 1, 2006
2683 - Recipe5 (subtypes & coercion) has been written
2686 - fixed "bad meta" error message to be more descriptive
2687 - fixed &unimport to not remove the &inner and &super
2688 keywords because we need to localize them.
2689 - fixed number of spelling/grammer issues, thanks Theory :)
2691 **~~ experimental & undocumented feature ~~**
2692 - added the method and self keywords, they are basically
2693 just sugar, and they may not stay around.
2696 - added &dump method to easily Data::Dumper
2699 * Moose::Meta::TypeConstraint
2700 - added the &is_a_type_of method to check both the current
2701 and the subtype of a method (similar to &isa with classes)
2704 - this is now a subclass of Class::MOP::Module, and no longer
2705 creates the _role_meta ugliness of before.
2706 - fixed tests to reflect this change
2708 0.11 Wed. July 12, 2006
2710 - added an &unimport method to remove all the keywords
2711 that Moose will import, simply add 'no Moose' to the
2712 bottom of your class file.
2715 - fixed some test failures caused by a forgotten test
2718 0.10 Thurs. July 6, 2006
2720 - improved error message when loading modules so
2721 it is less confusing when you load a role.
2722 - added &calculate_all_roles method to
2723 Moose::Meta::Class and Moose::Meta::Role
2726 This module has been tested against Class::MOP 0.30
2727 but it does not yet utilize the optimizations
2728 it makes available. Stay tuned for that ;)
2730 0.09_03 Fri. June 23, 2006
2731 ++ DEVELOPER RELEASE ++
2733 - 'use strict' and 'use warnings' are no longer
2734 needed in Moose classes, Moose itself will
2735 turn them on for you.
2736 - added tests for this
2737 - moved code from exported subs to private methods
2738 in Moose::Meta::Class
2741 - as with Moose, strict and warnings are
2742 automatically turned on for you.
2743 - added tests for this
2746 - now handles an edge case for override errors
2747 - added tests for this
2748 - added some more edge case tests
2750 0.09_02 Tues. May 16, 2006
2751 ++ DEVELOPER RELEASE ++
2753 - added prototypes to the exported subs
2757 - added prototypes to the exported subs
2760 * Moose::Util::TypeConstraints
2761 - cleaned up prototypes for the subs
2764 0.09_01 Fri. May 12, 2006
2765 ++ DEVELOPER RELEASE ++
2766 - This release works in combination with
2767 Class::MOP 0.29_01, it is a developer
2768 release because it uses the a new
2769 instance sub-protocol and a fairly
2770 complete Role implementation. It has
2771 not yet been optimized, so it slower
2772 the the previous CPAN version. This
2773 release also lacks good updated docs,
2774 the official release will have updated docs.
2777 - refactored the keyword exports
2778 - 'with' now checks Role validaity and
2779 accepts more than one Role at a time
2780 - 'extends' makes metaclass adjustments as
2781 needed to ensure metaclass compatibility
2784 - refactored the keyword exports
2785 - 'with' now checks Role validaity and
2786 accepts more than one Role at a time
2788 * Moose::Util::TypeConstraints
2789 - added the 'enum' keyword for simple
2790 string enumerations which can be used as
2792 - see example of usage in t/202_example.t
2795 - more careful checking of params to new()
2798 - much work done on the role composition
2799 - many new tests for conflict detection
2800 and composition edge cases
2801 - not enough documentation, I suggest
2802 looking at the tests
2804 * Moose::Meta::Instance
2805 - added new Instance metaclass to support
2806 the new Class::MOP instance protocol
2808 * Moose::Meta::Class
2809 - some small changes to support the new
2811 - some small additions to support Roles
2813 * Moose::Meta::Attribute
2814 - some improvements to the accessor generation code
2816 - some small changes to support the new
2818 - (still somewhat) experimental delegation support
2819 with the 'handles' option
2820 - added several tests for this
2821 - no docs for this yet
2823 0.05 Thurs. April 27, 2006
2825 - keywords are now exported with Sub::Exporter
2826 thanks to chansen for this commit
2827 - has keyword now takes a 'metaclass' option
2828 to support custom attribute meta-classes
2829 on a per-attribute basis
2830 - added tests for this
2831 - the 'has' keyword not accepts inherited slot
2832 specifications (has '+foo'). This is still an
2833 experimental feature and probably not finished
2834 see t/038_attribute_inherited_slot_specs.t for
2835 more details, or ask about it on #moose
2836 - added tests for this
2839 - keywords are now exported with Sub::Exporter
2841 * Moose::Utils::TypeConstraints
2842 - reorganized the type constraint hierarchy, thanks
2843 to nothingmuch and chansen for his help and advice
2845 - added some tests for this
2846 - keywords are now exported with Sub::Exporter
2847 thanks to chansen for this commit
2849 * Moose::Meta::Class
2850 - due to changes in Class::MOP, we had to change
2851 construct_instance (for the better)
2853 * Moose::Meta::Attribute
2854 - due to changes in Class::MOP, we had to add the
2855 initialize_instance_slot method (it's a good thing)
2857 * Moose::Meta::TypeConstraint
2858 - added type constraint unions
2859 - added tests for this
2860 - added the is_subtype_of predicate method
2861 - added tests for this
2863 0.04 Sun. April 16th, 2006
2865 - Roles can now consume other roles
2866 - added tests for this
2867 - Roles can specify required methods now with
2868 the requires() keyword
2869 - added tests for this
2872 - ripped out much of it's guts ,.. much cleaner now
2873 - added required methods and correct handling of
2874 them in apply() for both classes and roles
2875 - added tests for this
2876 - no longer adds a does() method to consuming classes
2877 it relys on the one in Moose::Object
2878 - added roles attribute and some methods to support
2879 roles consuming roles
2881 * Moose::Meta::Attribute
2882 - added support for triggers on attributes
2883 - added tests for this
2884 - added support for does option on an attribute
2885 - added tests for this
2887 * Moose::Meta::Class
2888 - added support for attribute triggers in the
2890 - added tests for this
2893 - Moose no longer creates a subtype for your class
2894 if a subtype of the same name already exists, this
2895 should DWIM in 99.9999% of all cases
2897 * Moose::Util::TypeConstraints
2898 - fixed bug where incorrect subtype conflicts were
2900 - added test for this
2903 - this class can now be extended with 'use base' if
2904 you need it, it properly loads the metaclass class now
2905 - added test for this
2907 0.03_02 Wed. April 12, 2006
2909 - you must now explictly use Moose::Util::TypeConstraints
2910 it no longer gets exported for you automatically
2913 - new() now accepts hash-refs as well as key/value lists
2914 - added does() method to check for Roles
2915 - added tests for this
2917 * Moose::Meta::Class
2918 - added roles attribute along with the add_role() and
2920 - added tests for this
2923 - now adds a does() method to consuming classes
2924 which tests the class's hierarchy for roles
2925 - added tests for this
2927 0.03_01 Mon. April 10, 2006
2929 - added new Role recipe (no content yet, only code)
2932 - added 'with' keyword for Role support
2933 - added test and docs for this
2934 - fixed subtype quoting bug
2935 - added test for this
2939 - added test and docs
2941 * Moose::Util::TypeConstraints
2942 - added the message keyword to add custom
2943 error messages to type constraints
2946 - the meta role to support Moose::Role
2947 - added tests and docs
2949 * Moose::Meta::Class
2950 - moved a number of things from Moose.pm
2951 to here, they should have been here
2954 * Moose::Meta::Attribute
2955 - moved the attribute option macros here
2956 instead of putting them in Moose.pm
2958 * Moose::Meta::TypeConstraint
2959 - added the message attributes and the
2961 - added tests and docs for this
2963 0.03 Thurs. March 30, 2006
2965 - added the Moose::Cookbook with 5 recipes,
2966 describing all the stuff Moose can do.
2969 - fixed an issue with &extends super class loading
2970 it now captures errors and deals with inline
2971 packages correctly (bug found by mst, solution
2973 - added super/override & inner/augment features
2974 - added tests and docs for these
2977 - BUILDALL now takes a reference of the %params
2978 that are passed to &new, and passes that to
2981 * Moose::Util::TypeConstraints
2982 - Type constraints now survive runtime reloading
2983 - added test for this
2985 * Moose::Meta::Class
2986 - fixed the way attribute defaults are handled
2987 during instance construction (bug found by chansen)
2989 * Moose::Meta::Attribute
2990 - read-only attributes now actually enforce their
2991 read-only-ness (this corrected in Class::MOP as
2994 0.02 Tues. March 21, 2006
2996 - many more tests, fixing some bugs and
2998 - &extends now loads the base module with
3000 - added UNIVERSAL::require to the
3003 - each new Moose class will also create
3004 and register a subtype of Object which
3005 correspond to the new Moose class.
3006 - the 'isa' option in &has now only
3007 accepts strings, and will DWIM in
3010 * Moose::Util::TypeConstraints
3011 - added type coercion features
3012 - added tests for this
3013 - added support for this in attributes
3014 and instance construction
3016 - type construction no longer creates a
3017 function, it registers the type instead.
3018 - added several functions to get the
3022 - BUILDALL and DEMOLISHALL were broken
3023 because of a mis-named hash key, Whoops :)
3025 * Moose::Meta::Attribute
3026 - adding support for coercion in the
3027 autogenerated accessors
3029 * Moose::Meta::Class
3030 - adding support for coercion in the
3031 instance construction
3033 * Moose::Meta::TypeConstraint
3034 * Moose::Meta::TypeCoercion
3035 - type constraints and coercions are now
3036 full fledges meta-objects
3038 0.01 Wed. March 15, 2006
3039 - Moooooooooooooooooose!!!