1 Also see Moose::Manual::Delta for more details of, and workarounds
2 for, noteworthy changes.
7 * Moose::Meta::Attribute::Native::Trait::Code no longer creates reader
8 methods by default. (Florian Ragwitz)
11 * Improve various parts of the documentation and fix many typos.
12 (Dave Rolsky, Mateu Hunter, Graham Knop, Robin V, Jay Hannah, Jesse Luehrs)
18 * New method find_type_for in Moose::Meta::TypeConstraint::Union, for finding
19 which member of the union a given value validates for. (Cory Watson)
23 * DEMOLISH methods in mutable subclasses of immutable classes are now called
24 properly (Chia-liang Kao, Jesse Luehrs)
28 * Added Moose::Manual::Support that defines the support, compatiblity, and
29 release policies for Moose. (Chris Prather)
31 0.98 Wed, Feb 10, 2010
35 * An internals change in 0.97 broke role application to an instance in some
36 cases. The bug occurred when two different roles were applied to different
37 instances of the same class. (Rafael Kitover)
44 * Calling ->reinitialize on a cached anonymous class effectively uncached
45 the metaclass object, causing the metaclass to go out of scope
46 unexpectedly. This could easily happen at a distance by applying a
47 metarole to an anonymous class. (Dave Rolsky).
53 * ScalarRef is now a parameterized type. You can now specify a type
54 constraint for whatever the reference points to. (Closes RT#50857)
55 (Michael G. Schwern, Florian Ragwitz)
59 * ScalarRef now accepts references to other references. (Closes RT#50934)
66 * Moose::Meta::Attribute::Native::Trait::Code now provides execute_method as
67 a delegation option. This allows the code reference to be called as a
68 method on the object. (Florian Ragwitz)
72 * Moose::Object::does no longer checks the entire inheritance tree, since
73 Moose::Meta::Class::does_role already does this. (doy)
75 * Moose::Util::add_method_modifier (and subsequently the sugar functions
76 Moose::before, Moose::after, and Moose::around) can now accept arrayrefs,
77 with the same behavior as lists. Types other than arrayref and regexp
78 result in an error. (Dylan Hardison)
80 0.94 Mon, Jan 18, 2010
84 * Please see the changes listed for 0.93_01 and Moose::Manual::Delta.
88 * Improved support for anonymous roles by changing various APIs to take
89 Moose::Meta::Role objects as well as role names. This included
91 - Moose::Meta::Class->does_role
92 - Moose::Meta::Role->does_role
93 - Moose::Util::does_role
94 - Moose::Util::apply_all_roles
95 - Moose::Util::ensure_all_roles
96 - Moose::Util::search_class_by_role
98 Requested by Shawn Moore. Addresses RT #51143 (and then some). (Dave Rolsky)
102 * Fix handling of non-alphanumeric attributes names like '@foo'. This should
103 work as long as the accessor method names are explicitly set to valid Perl
104 method names. Reported by Doug Treder. RT #53731. (Dave Rolsky)
107 0.93_03 Tue, Jan 5, 2010
111 * Portability fixes to our XS code so we compile with 5.8.8 and Visual
112 C++. Fixes RT #53391. Reported by Taro Nishino. (rafl)
115 0.93_02 Tue, Jan 5, 2010
119 * Depend on Class::MOP 0.97_01 so we can get useful results from CPAN
120 testers. (Dave Rolsky)
123 0.93_01 Mon, Jan 4, 2010
127 See Moose::Manual::Delta for more details on backwards compatiblity issues.
129 * Role attributes are now objects of the Moose::Meta::Role::Attribute
130 class. (Dave Rolsky).
132 * There were major changes to how metaroles are applied. We now distinguish
133 between metaroles for classes vs those for roles. See the
134 Moose::Util::MetaRole docs for details. (Dave Rolsky)
136 * The old MetaRole API has been deprecated, but will continue to
137 work. However, if you are applying an attribute metaclass role, this may
138 break because of the fact that roles now have an attribute metaclass
141 * Moose::Util::MetaRole::apply_metaclass_roles is now called
142 apply_metaroles. The old name is deprecated. Dave Rolsky>
144 * The unimport subs created by Moose::Exporter now clean up re-exported
145 functions like blessed and confess, unless the caller imported them from
146 somewhere else too. See Moose::Manua::Delta for backcompat details. (rafl)
148 [ENHANCEMENTS AND BUG FIXES]
150 * Changed the Str constraint to accept magic lvalue strings like one gets from
151 substr et al, again. (sorear)
153 * Sped up the type constraint parsing regex. (Sam Vilain)
155 * The Moose::Cookbook::Extending::Recipe2 recipe was broken. Fix suggested by
158 * Added Moose::Util::TypeConstraints exports when using oose.pm to allow
159 easier testing of TypeConstraints from the command line. (perigrin)
161 * Added a with_immutable test function to Test::Moose, to run a block of tests
162 with and without certain classes being immutable. (doy)
164 * We now use Module::Install extensions explicitly to avoid confusing errors
165 if they're not installed. We use Module::Install::AuthorRequires to stop
166 test extraction and general failures if you don't have the author side
167 dependencies installed.
169 * Fixed a grammar error in Moose::Cookbook::Basics::Recipe4. rt.cpan.org
170 #51791. (Amir E. Aharoni)
173 0.93 Thu, Nov 19, 2009
175 - Calling $object->new() is no longer deprecated, and no longer
179 - The get_attribute_map method is now deprecated. (Dave Rolsky)
181 * Moose::Meta::Method::Delegation
182 - Preserve variable aliasing in @_ for delegated methods, so that
183 altering @_ affects the passed value. (doy)
185 * Moose::Util::TypeConstraints
186 - Allow array refs for non-anonymous form of enum and duck_type, not
187 just anonymous. The non-arrayref forms may be removed in the
189 - Changed Str constraint to not accept globs (*STDIN or *FOO). (chansen)
190 - Properly document Int being a subtype of Str. (doy)
193 - Moose::Exporter using modules can now export their functions to the
194 main package. This applied to Moose and Moose::Role, among
195 others. (nothingmuch)
197 * Moose::Meta::Attribute
198 - Don't remove attribute accessors we never installed, during
199 remove_accessors. (doy)
201 * Moose::Meta::Attribute::Native::Trait::Array
202 - Don't bypass prototype checking when calling List::Util::first, to
203 avoid a segfault when it is called with a non-code argument. (doy)
205 * Moose::Meta::Attribute::Native::Trait::Code
206 - Fix passing arguments to code execute helpers. (doy)
208 0.92 Tue, Sep 22, 2009
209 * Moose::Util::TypeConstraints
210 - added the match_on_type operator (Stevan)
211 - added tests and docs for this (Stevan)
214 - Metaclass compat fixing should already happen recursively, there's no
215 need to explicitly walk up the inheritance tree. (doy)
217 * Moose::Meta::Attribute
218 - Add tests for set_raw_value and get_raw_value. (nothingmuch)
220 0.91 Thu, Sep 17, 2009
222 - Don't import any functions, in order to avoid polluting our namespace
223 with things that can look like methods (blessed, try, etc)
226 * Moose::Meta::Method::Constructor
227 - The generated code needs to called Scalar::Util::blessed by its
228 fully-qualified name or else Perl can interpret the call to blessed as
229 an indirect method call. This broke Search::GIN, which in turn broke
230 KiokuDB. (nothingmuch)
232 0.90 Tue, Sep 15, 2009
233 * Moose::Meta::Attribute::Native::Trait::Counter
234 * Moose::Meta::Attribute::Native::Trait::String
235 - For these two traits, an attribute which did not explicitly provide
236 methods to handles magically ended up delegating *all* the helper
237 methods. This has been removed. You must be explicit in your handles
238 declaration for all Native Traits. (Dave Rolsky)
241 - DEMOLISHALL behavior has changed. If any DEMOLISH method dies, we make
242 sure to rethrow its error message. However, we also localize $@ before
243 this so that if all the DEMOLISH methods success, the value of $@ will
244 be preserved. (nothingmuch and Dave Rolsky)
245 - We now also localize $? during object destruction. (nothingmuch and
247 - The handling of DEMOLISH methods was broken for immutablized classes,
248 which were not receiving the value of
249 Devel::GlobalDestruction::in_global_destruction.
250 - These two fixes address some of RT #48271, reported by Zefram.
251 - This is all now documented in Moose::Manual::Construction.
252 - Calling $object->new() is now deprecated. A warning will be
256 - Added more hooks to customize how roles are applied. The role
257 summation class, used to create composite roles, can now be changed
258 and/or have meta-roles applied to it. (rafl)
259 - The get_method_list method no longer explicitly excludes the "meta"
260 method. This was a hack that has been replaced by better hacks. (Dave
263 * Moose::Meta::Method::Delegation
264 - fixed delegated methods to make sure that any modifiers attached to
265 the accessor being delegated on will be called (Stevan)
266 - added tests for this (Stevan)
269 - Moose no longer warns when a class that is being made immutable has
270 mutable ancestors. While in theory this is a good thing to warn about,
271 we found so many exceptions to this that doing this properly became
274 0.89_02 Thu, Sep 10, 2009
275 * Moose::Meta::Attribute::Native
276 - Fix Hash, which still had 'empty' instead of 'is_empty'. (hdp)
278 * Moose::Meta::Attribute::Native::Trait::Array
279 - Added a number of functions from List::Util and List::MoreUtils,
280 including reduce, shuffle, uniq, and natatime. (doy)
283 - This module will now generate an init_meta method for your exporting
284 class if you pass it options for
285 Moose::Util::MetaRole::apply_metaclass_roles or
286 apply_base_class_roles. This eliminates a lot of repetitive
287 boilerplate for typical MooseX modules. (doy).
288 - Documented the with_meta feature, which is a replacement for
289 with_caller. This feature was added by josh a while ago.
290 - The with_caller feature is now deprecated, but will not issue a
291 warning yet. (Dave Rolsky)
292 - If you try to wrap/export a subroutine which doesn't actually exist,
293 Moose::Exporter will warn you about this. (doy)
295 * Moose::Meta::Role::Application::ToRole
296 - When a role aliased a method from another role, it was only getting
297 the new (aliased) name, not the original name. This differed from what
298 happens when a class aliases a role's methods. If you _only_ want the
299 aliased name, make sure to also exclue the original name. (Dave
302 0.89_01 Wed Sep 2, 2009
303 * Moose::Meta::Attribute
304 - Added the currying syntax for delegation from AttributeHelpers to the
305 existing delegation API. (hdp)
307 * Moose::Meta::Attribute::Native
308 - We have merged the functionality of MooseX::AttributeHelpers into the
309 Moose core with some API tweaks. You can continue to use
310 MooseX::AttributeHelpers, but it will not be maintained except
311 (perhaps) for critical bug fixes in the future. See
312 Moose::Manual::Delta for details. (hdp, jhannah, rbuels, Sartak,
315 * Moose::Error::Croak
316 * Moose::Error::Confess
317 - Clarify documentation on how to use different error-throwing
318 modules. (Curtis Jewell)
321 - Correct POD for builder to point to Recipe8, not 9. (gphat)
324 - When a nonexistent sub name is passed to as_is, with_caller, or
325 with_meta, throw a warning and skip the exporting, rather than
326 installing a broken sub. (doy)
329 - Moose now warns if you call C<make_immutable> for a class with mutable
332 0.89 Thu Aug 13, 2009
333 * Moose::Manual::Attributes
334 - Clarify "is", include discussion of "bare". (Sartak)
336 * Moose::Meta::Role::Method::Conflicting
337 * Moose::Meta::Role::Application::ToClass
338 - For the first set of roles involved in a conflict, report all
339 unresolved method conflicts, not just the first method. Fixes #47210
340 reported by Ovid. (Sartak)
342 * Moose::Meta::TypeConstraint
343 - Add assert_valid method to use a TypeConstraint for assertion (rjbs)
346 - Make "use Moose -metaclass => 'Foo'" do alias resolution, like -traits
348 - Allow specifying role options (alias, excludes, MXRP stuff) in the
349 arrayref passed to "use Moose -traits" (doy)
352 - Add functions meta_class_alias and meta_attribute_alias for creating
353 aliases for class and attribute metaclasses and metatraits. (doy)
355 * Moose::Meta::Attribute
356 * Moose::Meta::Method::Accessor
357 - A trigger now receives the old value as a second argument, if the
358 attribute had one. (Dave Rolsky)
360 * Moose::Meta::Method::Constructor
361 - Fix a bug with $obj->new when $obj has stringify overloading.
362 Reported by Andrew Suffield [rt.cpan.org #47882] (Sartak)
363 - However, we will probably deprecate $obj->new, so please don't start
364 using it for new code!
366 * Moose::Meta::Role::Application
367 * Moose::Meta::Role::Application::RoleSummation
368 - Rename alias and excludes to -alias and -excludes (but keep the old
369 names for now, for backcompat) (doy)
371 0.88 Fri Jul 24, 2009
372 * Moose::Manual::Contributing
373 - Re-write the Moose::Manual::Contributing document to reflect
374 the new layout and methods of work for the Git repository. All
375 work now should be done in topic branches and reviewed by a
376 core committer before being applied to master. All releases
377 are done by a cabal member and merged from master to
378 stable. This plan was devised by Yuval, blame him. (perigrin)
381 - Create metaclass attributes for the different role application
384 * Moose::Util::MetaRole
385 - Allow applying roles to a meta role's role application
388 * Moose::Meta::Attribute
389 - Add weak_ref to allowed options for "has '+foo'" (mst)
391 * Moose::Meta::Method::Accessor
392 - No longer uses inline_slot_access in accessors, to support
393 non-lvalue-based meta instances. (sorear)
396 * Moose::Meta::Method::Delegation
397 - Once again allow class names as well as objects for
398 delegation. This was changed in 0.86.
401 * Moose::Meta::Class::Immutable::Trait
402 - Fixes to work with the latest Class::MOP.
404 * Moose::Meta::Method::Delegation
405 - Delegation now dies with a more useful error message if the
406 attribute's accessor returns something defined but
409 0.85 Fri, Jun 26, 2009
410 * Moose::Meta::Attribute
411 - The warning for 'no associated methods' is now split out into
412 the _check_associated_methods method, so that extensions can
413 safely call 'after install_accessors => ...'. This fixes a
414 warning from MooseX::AttributeHelpers. (hdp)
416 0.84 Fri, Jun 26, 2009
418 - has now sets definition_context for attributes defined in
421 * Moose::Meta::Attribute
422 - When adding an attribute to a metaclass, if the attribute has
423 no associated methods, it will give a deprecation
425 - Methods generated by delegation were not being added to
426 associated_methods. (hdp)
427 - Attribute accessors (reader, writer, accessor, predicate,
428 clearer) now warn if they overwrite an existing method. (doy)
429 - Attribute constructors now warn very noisily about unknown (or
430 misspelled) arguments
432 * Moose::Util::TypeConstraints
433 - Deprecated the totally useless Role type name, which just
434 checked if $object->can('does'). Note that this is _not_ the
435 same as a type created by calling role_type('RoleName').
437 * Moose::Util::TypeConstraints
438 * Moose::Meta::TypeConstraint::DuckType
439 - Reify duck type from a regular subtype into an actual class
441 - Document this because Sartak did all my work for me
444 * Moose::Meta::Attribute
445 - Allow Moose::Meta::TypeConstraint::DuckType in handles, since
446 it is just a list of methods (Sartak)
449 - The get_*_method_modifiers methods would die if the role had
450 no modifiers of the given type (Robert Buels).
452 0.83 Tue, Jun 23, 2009
454 - Fix _construct_instance not setting the special __MOP__ object
455 key in instances of anon classes. (doy)
457 0.82 Sun, Jun 21, 2009
458 * Moose::Manual::Types
459 - Mention MooseX::Types early to avoid users falling down the
460 string parsing rathole (mst)
462 * Moose::Manual::MooseX
463 - Add warnings about class-level extensions and mention considering
464 using plain objects instead
466 0.81 Sun, Jun 7, 2009
467 * Bumped our Class::MOP prereq to the latest version (0.85), since
470 0.80 Sat, Jun 6, 2009
472 - Add FAQ about the coercion change from 0.76 because it came up
473 three times today (perigrin)
474 - Win doy $10 dollars because Sartak didn't think anybody
475 would document this fast enough (perigrin)
477 * Moose::Meta::Method::Destructor
478 - Inline a DESTROY method even if there are no DEMOLISH methods
479 to prevent unnecessary introspection in
480 Moose::Object::DEMOLISHALL
483 - A role's required methods are now represented by
484 Moose::Meta::Role::Method::Required objects. Conflicts are now
485 represented by Moose::Meta::Role::Method::Conflicting
486 objects. The benefit for end-users in that unresolved
487 conflicts generate different, more instructive, errors,
488 resolving Ovid's #44895. (Sartak)
491 - Improve the error message of "extends" as suggested by Adam
492 Kennedy and confound (Sartak)
493 - Link to Moose::Manual::Roles from Moose::Role as we now have
494 excellent documentation (Adam Kennedy)
497 - Update test suite for subname change in Class::MOP
499 - Add TODO test for infinite recursion in Moose::Meta::Class
502 0.79 Wed, May 13, 2009
504 - More fixes for Win32 problems. Reported by Robert Krimen.
507 - The DEMOLISHALL method could still blow up in some cases
508 during global destruction. This method has been made more
509 resilient in the face of global destruction's random garbage
513 - If you "also" a module that isn't loaded, the error message
514 now acknowledges that (Sartak)
517 - When your ->meta method does not return a Moose::Meta::Class,
518 the error message gave the wrong output (Sartak)
520 0.78 Tue, May 12, 2009
521 * Moose::Cookbook::FAQ and Moose::Cookbook::WTF
522 - Merged these documents into what is now Moose::Manual::FAQ
525 - Moved to Moose::Manual::Unsweetened
527 * Moose::Cookbook::Basics::Recipes 9-12
528 - Renamed to be 8-11, since recipe 8 did not exist
531 - Make Moose::Exporter import strict and warnings into packages
535 - Fix DEMOLISHALL sometimes not being able to find DEMOLISH
536 methods during global destruction (doy)
539 * Moose::Meta::Role::Application::ToClass
540 - Track the Role::Application objects created during class-role
544 - Fix metaclass incompatibility errors when extending a vanilla perl
545 class which isa Moose class with a metaclass role applied (t0m)
548 - Add a role-combination hook, _role_for_combination, for the
549 benefit of MooseX::Role::Parameterized (Sartak)
552 - Some tests were failing on Win32 because they explicit checked
553 warning output for newlines. Reported by Nickolay Platonov.
555 0.77 Sat, May 2, 2009
557 - Add explicit use of Devel::GlobalDestruction and Sub::Name
561 - Pass a boolean to DEMOLISHALL and DEMOLISH indicating whether
562 or not we are currently in global destruction (doy)
563 - Add explicit use of Devel::GlobalDestruction and Sub::Name
566 * Moose::Cookbook::FAQ
567 - Reworked much of the existing content to be more useful to
568 modern Moose hackers (Sartak)
571 - Depend on Class::MOP 0.83 instead of 0.82_01.
573 0.76 Mon, April 27, 2009
574 * Moose::Meta::TypeConstraint
575 - Do not run coercions in coerce() if the value already passes the type
578 * Moose::Meta::TypeConstraint::Class
579 - In validation error messages, specifically say that the value is not
580 an instance of the class. This should alleviate some frustrating
581 forgot-to-load-my-type bugs. rt.cpan.org #44639 (Sartak)
583 * Moose::Meta::Role::Application::ToClass
584 - Revert the class-overrides-role warning in favor of a solution outside
585 of the Moose core (Sartak)
588 - Make Test::Output optional again, since it's only used in a few files
591 0.75_01 Thu, April 23, 2009
592 * Moose::Meta::Role::Application::ToClass
593 - Moose now warns about each class overriding methods from roles it
597 - Warnings tests have standardized on Test::Output which is now an
598 unconditionally dependency (Sartak)
601 - Changes to immutabilization to work with Class::MOP 0.82_01+.
603 0.75 Mon, April 20, 2009
606 - Move validation of not inheriting from roles from Moose::extends to
607 Moose::Meta::Class::superclasses (doy)
610 - add ensure_all_roles() function to encapsulate the common "apply this
611 role unless the object already does it" pattern (hdp)
614 - Users can now select a different metaclass with the "-metaclass"
615 option to import, for classes and roles (Sartak)
618 - Make method_metaclass an attr so that it can accept a metarole
621 0.74 Tue, April 7, 2009
623 * Moose::Meta::Method::Destructor
624 - Include stack traces in the deprecation warnings.
628 - Removed the long-deprecated _apply_all_roles method.
630 * Moose::Meta::TypeConstraint
631 - Removed the long-deprecated union method.
634 0.73_02 Mon, April 6, 2009
635 * More deprecations and renamings
636 - Moose::Meta::Method::Constructor
637 - initialize_body => _initialize_body (this is always called
638 when an object is constructed)
641 - The DEMOLISHALL method could throw an exception during global
642 destruction, meaning that your class's DEMOLISH methods would
643 not be properly called. Reported by t0m.
645 * Moose::Meta::Method::Destructor
646 - Destructor inlining was totally broken by the change to the
647 is_needed method in 0.72_01. Now there is a test for this
648 feature, and it works again.
651 - Bold the word 'not' in the POD for find_meta (t0m)
653 0.73_01 Sun, April 5, 2009
655 - Call user_class->meta in fewer places, with the eventual goal
656 of allowing the user to rename or exclude ->meta
657 altogether. Instead uses Class::MOP::class_of. (Sartak)
659 * Moose::Meta::Method::Accessor
660 - If an attribute had a lazy default, and that value did not
661 pass the attribute's type constraint, it did not get the
662 message from the type constraint, instead using a generic
663 message. Test provided by perigrin.
665 * Moose::Util::TypeConstraints
666 - Add duck_type keyword. It's sugar over making sure an object
667 can() a list of methods. This is easier than jrockway's
668 suggestion to fork all of CPAN. (perigrin)
669 - add tests and documentation (perigrin)
672 - Document the fact that init_meta() returns the target class's
673 metaclass object. (hdp)
675 * Moose::Cookbook::Extending::Recipe1
676 * Moose::Cookbook::Extending::Recipe2
677 * Moose::Cookbook::Extending::Recipe3
678 * Moose::Cookbook::Extending::Recipe4
679 - Make init_meta() examples explicitly return the metaclass and
680 point out this fact. (hdp)
682 * Moose::Cookbook::Basics::Recipe12
683 - A new recipe, creating a custom meta-method class.
685 * Moose::Cookbook::Meta::Recipe6
686 - A new recipe, creating a custom meta-method class.
689 * Moose::Meta::Method::Constructor
690 - Attribute triggers no longer receive the meta-attribute object
691 as an argument in any circumstance. Previously, triggers
692 called during instance construction were passed the
693 meta-attribute, but triggers called by normal accessors were
694 not. Fixes RT#44429, reported by Mark Swayne. (hdp)
696 * Moose::Manual::Attributes
697 - Remove references to triggers receving the meta-attribute object as an
700 * Moose::Cookbook::FAQ
701 - Remove recommendation for deprecated Moose::Policy and
702 Moose::Policy::FollowPBP; recommend MooseX::FollowPBP
705 * Many methods have been renamed with a leading underscore, and a
706 few have been deprecated entirely. The methods with a leading
707 underscore are consider "internals only". People writing
708 subclasses or extensions to Moose should feel free to override
709 them, but they are not for "public" use.
712 - check_metaclass_compatibility => _check_metaclass_compatibility
714 - Moose::Meta::Method::Accessor
715 - initialize_body => _initialize_body (this is always called
716 when an object is constructed)
717 - /(generate_.*_method(?:_inline)?)/ => '_' . $1
719 - Moose::Meta::Method::Constructor
720 - initialize_body => _initialize_body (this is always called
721 when an object is constructed)
722 - /(generate_constructor_method(?:_inline)?)/ => '_' . $1
723 - attributes => _attributes (now inherited from parent)
724 - meta_instance => _meta_instance (now inherited from parent)
727 - alias_method is deprecated. Use add_method
729 0.73 Fri, March 29, 2009
730 * No changes from 0.72_01.
732 0.72_01 Thu, March 26, 2009
734 - Almost every module has complete API documentation. A few
735 methods (and even whole classes) have been intentionally
736 excluded pending some rethinking of their APIs.
738 * Moose::Util::TypeConstraints
739 - Calling subtype with a name as the only argument is now an
740 exception. If you want an anonymous subtype do:
742 my $subtype = subtype as 'Foo';
744 * Moose::Cookbook::Meta::Recipe7
745 - A new recipe, creating a custom meta-instance class.
747 * Moose::Cookbook::Basics::Recipe5
748 - Fix various typos and mistakes. Includes a patch from Radu
751 * Moose::Cookbook::Basics::Recipe9
752 - Link to this recipe from Moose.pm's builder blurb
755 - When wrapping a function with a prototype, Moose::Exporter now
756 makes sure the wrapped function still has the same
757 prototype. (Daisuke Maki)
759 * Moose::Meta::Attribute
760 - Allow a subclass to set lazy_build for an inherited
764 - Explicitly depend on Data::OptList. We already had this dependency
765 via Sub::Exporter, but since we're using it directly we're
766 better off with it listed. (Sartak)
768 * Moose::Meta::Method::Constructor
769 - Make it easier to subclass the inlining behaviour. (Ash
772 * Moose::Manual::Delta
773 - Details significant changes in the history of Moose, along
774 with recommended workarounds.
776 * Moose::Manual::Contributing
777 - Contributor's guide to Moose.
779 * Moose::Meta::Method::Constructor
780 - The long-deprecated intialize_body method has been removed
781 (yes, spelled like that).
783 * Moose::Meta::Method::Destructor
784 - This is_needed method is now always a class method.
787 - Changes to the internals of how make_immutable works to match
788 changes in latest Class::MOP.
790 0.72 Mon, February 23, 2009
792 * Moose::Meta::Method::Constructor
793 - A mutable class accepted Foo->new(undef) without complaint,
794 while an immutable class would blow up with an unhelpful
795 error. Now, in both cases we throw a helpful error
796 instead. Reported by doy.
798 0.71_01 Sun, February 22, 2009
800 - Hopefully fixed some POD errors in a few recipes that caused
801 them to display weird on search.cpan.org.
803 * Moose::Util::TypeConstraints
804 - Calling type or subtype without the sugar helpers (as, where,
805 message) is now deprecated.
806 - The subtype function tried hard to guess what you meant, but
807 often got it wrong. For example:
809 my $subtype = subtype as 'ArrayRef[Object]';
811 This caused an error in the past, but now works as you'd
815 - Make sure Moose.pm is loaded before calling
816 Moose->throw_error. This wasn't normally an issue, but could
817 bite you in weird cases.
819 0.71 Thu, February 19, 2009
820 * Moose::Cookbook::Basics::Recipe11
821 - A new recipe which demonstrates the use of BUILDARGS and
824 * Moose::Cookbook::Roles::Recipe3
825 - A new recipe, applying a role to an object instance. (Dave
829 - Allow overriding specific keywords from "also" packages. (doy)
832 - Replace hardcoded cookbook tests with Test::Inline to ensure
833 the tests match the actual code in the recipes. (Dave Rolsky)
836 - Working on the above turned up a number of little bugs in the
837 recipe code. (Dave Rolsky)
839 * Moose::Util::TypeConstraints::Optimized
840 - Just use Class::MOP for the optimized ClassName check. (Dave
843 0.70 Sat, February 14, 2009
844 * Moose::Util::TypeConstraints
845 - Added the RoleName type (stevan)
846 - added tests for this (stevan)
848 * Moose::Cookbook::Basics::Recipe3
849 - Updated the before qw[left right] sub to be a little more
850 defensive about what it accepts (stevan)
851 - added more tests to t/000_recipies/basics/003_binary_tree.t
855 - We now always call DEMOLISHALL, even if a class does not
856 define DEMOLISH. This makes sure that method modifiers on
857 DEMOLISHALL work as expected. (doy)
858 - added tests for this (EvanCarroll)
860 * Moose::Util::MetaRole
861 - Accept roles for the wrapped_method_metaclass (rafl)
862 - added tests for this (rafl)
864 * Moose::Meta::Attribute
865 - We no longer pass the meta-attribute object as a final
866 argument to triggers. This actually changed for inlined code a
867 while back, but the non-inlined version and the docs were
871 - Some tests tried to use Test::Warn 0.10, which had bugs. Now
872 they require 0.11. (Dave Rolsky)
875 - Lots of small changes to the manual, cookbook, and
876 elsewhere. These were based on feedback from various
877 users, too many to list here. (Dave Rolsky)
879 0.69 Thu, February 12, 2009
881 - Make some keyword errors use throw_error instead of croak
882 since Moose::Exporter wraps keywords now (Sartak)
885 - Revised every recipe for style and clarity. Also moved some
886 documentation out of cookbook recipes and into Moose::Manual
887 pages. This work was funded as part of the Moose docs grant
888 from TPF. (Dave Rolsky)
890 * Moose::Meta::Method::Delegation
891 - If the attribute doing the delegation was not populated, the
892 error message did not specify the attribute name
895 0.68 Wed, February 4, 2009
897 - Many spelling, typo, and formatting fixes by daxim.
899 * Moose::Manual::Attributes
900 - The NAME section in the POD used "Attribute" so search.cpan
901 didn't resolve links from other documents properly.
903 * Moose::Meta::Method::Overriden
904 - Now properly spelled as Overridden. Thanks to daxim for
907 0.67 Tue, February 3, 2009
909 - Lots of little typo fixes and a few clarifications. Several
910 pages didn't have proper titles, and so weren't actually
911 visible on search.cpan.org. Thanks to hanekomu for a variety
912 of fixes and formatting improvements.
914 0.66 Tue, February 3, 2009
916 - This is a brand new, extensive manual for Moose. This aims to
917 provide a complete introduction to all of Moose's
918 features. This work was funded as part of the Moose docs grant
919 from TPF. (Dave Rolsky)
921 * Moose::Meta::Attribute
922 - Added a delegation_metaclass method to replace a hard-coded
923 use of Moose::Meta::Method::Delegation. (Dave Rolsky)
925 * Moose::Util::TypeConstraints
926 - If you created a subtype and passed a parent that Moose didn't
927 know about, it simply ignored the parent. Now it automatically
928 creates the parent as a class type. This may not be what you
929 want, but is less broken than before. (Dave Rolsky)
931 * Moose::Util::TypeConstraints
932 - This module tried throw errors by calling Moose->throw_error,
933 but it did not ensure that Moose was loaded first. This could
934 cause very unhelpful errors when it tried to throw an error
935 before Moose was loaded. (Dave Rolsky)
937 * Moose::Util::TypeConstraints
938 - You could declare a name with subtype such as "Foo!Bar" that
939 would be allowed, but if you used it in a parameterized type
940 such as "ArrayRef[Foo!Bar]" it wouldn't work. We now do some
941 vetting on names created via the sugar functions, so that they
942 can only contain alphanumerics, ":", and ".". (Dave Rolsky)
944 0.65 Thu, January 22, 2008
945 * Moose and Moose::Meta::Method::Overridden
946 - If an overridden method called super(), and then the
947 superclass's method (not overridden) _also_ called super(),
948 Moose went into an endless recursion loop. Test provided by
949 Chris Prather. (Dave Rolsky)
951 * Moose::Meta::TypeConstraint
952 - All methods are now documented. (gphat)
954 * t/100_bugs/011_DEMOLISH_eats_exceptions.t
955 - Fixed some bogus failures that occurred because we tried to
956 validate filesystem paths in a very ad-hoc and
957 not-quite-correct way. (Dave Rolsky)
959 * Moose::Util::TypeConstraints
960 - Added maybe_type to exports. See docs for details. (rjbs)
963 - Added Moose::Util::TypeConstraints to the SEE ALSO
967 - Methods created via an attribute can now fulfill a "requires"
968 declaration for a role. (nothingmuch)
970 * Moose::Meta::Method::*
971 - Stack traces from inlined code will now report its line and
972 file as being in your class, as opposed to in Moose
975 0.64 Wed, December 31, 2008
976 * Moose::Meta::Method::Accessor
977 - Always inline predicate and clearer methods (Sartak)
979 * Moose::Meta::Attribute
980 - Support for parameterized traits (Sartak)
981 - verify_against_type_constraint method to avoid duplication
982 and enhance extensibility (Sartak)
985 - Tests (but no support yet) for parameterized traits (Sartak)
988 - Require Class::MOP 0.75+, which has the side effect of making
989 sure we work on Win32. (Dave Rolsky)
991 0.63 Mon, December 8, 2008
993 - Some small grammar tweaks and bug fixes in non-Moose example
996 0.62_02 Fri, December 5, 2008
997 * Moose::Meta::Role::Application::ToClass
998 - When a class does not provide all of a role's required
999 methods, the error thrown now mentions all of the missing
1000 methods, as opposed to just the first one found. Requested by
1001 Curtis Poe (RT #41119). (Dave Rolsky)
1003 * Moose::Meta::Method::Constructor
1004 - Moose will no longer inline a constructor for your class
1005 unless it inherits its constructor from Moose::Object, and
1006 will warn when it doesn't inline. If you want to force
1007 inlining anyway, pass "replace_constructor => 1" to
1008 make_immutable. Addresses RT #40968, reported by Jon
1009 Swartz. (Dave Rolsky)
1010 - The quoting of default values could be broken if the default
1011 contained a single quote ('). Now we use quotemeta to escape
1012 anything potentially dangerous in the defaults. (Dave Rolsky)
1014 0.62_01 Wed, December 3, 2008
1016 - use the method->execute API for BUILDALL
1017 and DEMOLISHALL (Sartak)
1019 * Moose::Util::TypeConstraints
1020 - We now make all the type constraint meta classes immutable
1021 before creating the default types provided by Moose. This
1022 should make loading Moose a little faster. (Dave Rolsky)
1024 0.62 Wed November 26, 2008
1025 * Moose::Meta::Role::Application::ToClass
1026 Moose::Meta::Role::Application::ToRole
1027 - fixed issues where excluding and aliasing the
1028 same methods for a single role did not work
1029 right (worked just fine with multiple
1031 - added test for this (stevan)
1033 * Moose::Meta::Role::Application::RoleSummation
1034 - fixed the error message when trying to compose
1035 a role with a role it excludes (Sartak)
1038 - Catch another case where recursion caused the value
1039 of $CALLER to be stamped on (t0m)
1040 - added test for this (t0m)
1043 - Remove the make_immutable keyword, which has been
1044 deprecated since April. It breaks metaclasses that
1045 use Moose without no Moose (Sartak)
1047 * Moose::Meta::Attribute
1048 - Removing an attribute from a class now also removes delegation
1049 (handles) methods installed for that attribute (t0m)
1050 - added test for this (t0m)
1052 * Moose::Meta::Method::Constructor
1053 - An attribute with a default that looked like a number (but was
1054 really a string) would accidentally be treated as a number
1055 when the constructor was made immutable (perigrin)
1056 - added test for this (perigrin)
1059 - create method for constructing a role
1060 dynamically (Sartak)
1061 - added test for this (Sartak)
1062 - anonymous roles! (Sartak)
1063 - added test for this (Sartak)
1066 - more consistent error messages (Sartak)
1068 * Moose::Cookbook::Roles::Recipe1
1069 - attempt to explain why a role that just requires
1070 methods is useful (Sartak)
1072 0.61 Fri November 7, 2008
1073 * Moose::Meta::Attribute
1074 - When passing a role to handles, it will be loaded if necessary
1077 * Moose::Meta::Class
1078 - Method objects returned by get_method (and other methods)
1079 Could end up being returned without an associated_metaclass
1080 attribute. Removing get_method_map, which is provided by
1081 Class::MOP::Class, fixed this. The Moose version did nothing
1082 different from its parent except introduce a bug. (Dave Rolsky)
1083 - added tests for this (jdv79)
1086 - Added a $VERSION to all .pm files which didn't have one. Fixes
1087 RT #40049, reported by Adam Kennedy. (Dave Rolsky)
1089 * Moose::Cookbook::Basics::Recipe4
1090 * Moose::Cookbook::Basics::Recipe6
1091 - These files had spaces on the first line of the SYNOPSIS, as
1092 opposed to a totally empty line. According to RT #40432, this
1093 confuses POD parsers. (Dave Rolsky)
1095 0.60 Fri October 24, 2008
1097 - Passing "-traits" when loading Moose caused the Moose.pm
1098 exports to be broken. Reported by t0m. (Dave Rolsky)
1099 - Tests for this bug. (t0m)
1102 - Change resolve_metaclass alias to use the new
1103 load_first_existing_class function. This makes it a lot
1104 simpler, and also around 5 times faster. (t0m)
1105 - Add caching to resolve_metaclass_alias, which gives an order
1106 of magnitude speedup to things which repeatedly call the
1107 Moose::Meta::Attribute->does method, notably MooseX::Storage
1110 * Moose::Util::TypeConstraint
1111 - Put back the changes for parameterized constraints that
1112 shouldn't have been removed in 0.59. We still cannot parse
1113 them, but MooseX modules can create them in some other
1114 way. See the 0.58 changes for more details. (jnapiorkowski)
1115 - Changed the way subtypes are created so that the job is
1116 delegated to a type constraint parent. This clears up some
1117 hardcoded checking and should allow correct subtypes of
1118 Moose::Meta::Type::Constraint. Don't rely on this new API too
1119 much (create_child_type) because it may go away in the
1120 future. (jnapiorkowski)
1122 * Moose::Meta::TypeConstraint::Union
1123 - Type constraint names are sorted as strings, not numbers.
1126 * Moose::Meta::TypeConstraint::Parameterizable
1127 - New parameterize method. This can be used as a factory method
1128 to make a new type constraint with a given parameterized
1129 type. (jnapiorkowski)
1130 - added tests (jnapiorkowski)
1132 0.59 Tue October 14, 2008
1134 - Add abridged documentation for builder/default/initializer/
1135 predicate, and link to more details sections in
1136 Class::MOP::Attribute. (t0m)
1138 * Moose::Util::TypeConstraints
1139 - removed prototypes from all but the &-based stuff (mst)
1141 * Moose::Util::TypeConstraints
1142 - Creating a anonymous subtype with both a constraint and a
1143 message failed with a very unhelpful error, but should just
1144 work. Reported by t0m. (Dave Rolsky)
1147 - Some tests that used Test::Warn if it was available failed
1148 with older versions of Test::Warn. Reported by Fayland. (Dave
1150 - Test firing behavior of triggers in relation to builder/default/
1152 - Test behavior of equals/is_a_type_of/is_a_subtype_of for all
1153 kinds of supported type. (t0m)
1155 * Moose::Meta::Class
1156 - In create(), do not pass "roles" option to the superclass
1157 - added related test that creates an anon metaclass with
1158 a required attribute
1160 * Moose::Meta::TypeConstraint::Class
1161 * Moose::Meta::TypeConstraint::Role
1162 - Unify behavior of equals/is_a_type_of/is_a_subtype_of with
1163 other types (as per change in 0.55_02). (t0m)
1165 * Moose::Meta::TypeConstraint::Registry
1166 - Fix warning when dealing with unknown type names (t0m)
1168 * Moose::Util::TypeConstraints
1169 - Reverted changes from 0.58 related to handle parameterized
1170 types. This caused random failures on BSD and Win32 systems,
1171 apparently related to the regex engine. This means that Moose
1172 can no longer parse structured type constraints like
1173 ArrayRef[Int,Int] or HashRef[name=>Str]. This will be
1174 supported in a slightly different way via MooseX::Types some
1175 time in the future. (Dave Rolsky)
1177 0.58 Sat September 20, 2008
1178 !! This release has an incompatible change regarding !!
1179 !! how roles add methods to a class !!
1181 * Roles and role application
1182 ! Roles now add methods by calling add_method, not
1183 alias_method. They make sure to always provide a method
1184 object, which will be cloned internally. This means that it is
1185 now possible to track the source of a method provided by a
1186 role, and even follow its history through intermediate roles.
1188 This means that methods added by a role now show up when
1189 looking at a class's method list/map. (Dave Rolsky)
1192 - From this release on, we'll try to maintain a list of
1193 conflicting modules, and warn you if you have one
1194 installed. For example, this release conflicts with ...
1195 - MooseX::Singleton <= 0.11
1196 - MooseX::Params::Validate <= 0.05
1199 In general, we try to not break backwards compatibility for
1200 most Moose users, but MooseX modules and other code which
1201 extends Moose's metaclasses is often affected by very small
1202 changes in the Moose internals.
1204 * Moose::Meta::Method::Delegation
1205 * Moose::Meta::Attribute
1206 - Delegation methods now have their own method class. (Dave
1209 * Moose::Meta::TypeConstraint::Parameterizable
1210 - Added a new method 'parameterize' which is basically a factory
1211 for the containing constraint. This makes it easier to create
1212 new types of parameterized constraints. (jnapiorkowski)
1214 * Moose::Meta::TypeConstraint::Union
1215 - Changed the way Union types canonicalize their names to follow
1216 the normalized TC naming rules, which means we strip all
1217 whitespace. (jnapiorkowski)
1219 * Moose::Util::TypeConstraints
1220 - Parameter and Union args are now sorted, this makes Int|Str
1221 the same constraint as Str|Int. (jnapiorkowski)
1222 - Changes to the way Union types are parsed to more correctly
1223 stringify their names. (jnapiorkowski)
1224 - When creating a parameterized type, we now use the new
1225 parameterize method. (jnapiorkowski)
1226 - Incoming type constraint strings are now normalized to remove
1227 all whitespace differences. (jnapiorkowski)
1228 - Changed the way we parse type constraint strings so that we now
1229 match TC[Int,Int,...] and TC[name=>Str] as parameterized type
1230 constraints. This lays the foundation for more flexible type
1231 constraint implementations.
1233 * Tests and docs for all the above. (jnapiorkowski)
1237 - Moose::Exporter will no longer remove a subroutine that the
1238 exporting package re-exports. Moose re-exports the
1239 Carp::confess function, among others. The reasoning is that we
1240 cannot know whether you have also explicitly imported those
1241 functions for your own use, so we err on the safe side and
1242 always keep them. (Dave Rolsky)
1243 - added tests for this (rafl)
1245 * Moose::Meta::Class
1246 - Changes to how we fix metaclass compatibility that are much
1247 too complicated to go into. The summary is that Moose is much
1248 less likely to complain about metaclass incompatibility
1249 now. In particular, if two metaclasses differ because
1250 Moose::Util::MetaRole was used on the two corresponding
1251 classes, then the difference in roles is reconciled for the
1252 subclass's metaclass. (Dave Rolsky)
1253 - Squashed an warning in _process_attribute (thepler)
1256 - throw exceptions (sooner) for invalid attribute names (thepler)
1257 - added tests for this (thepler)
1259 * Moose::Util::MetaRole
1260 - If you explicitly set a constructor or destructor class for a
1261 metaclass object, and then applied roles to the metaclass,
1262 that explicitly set class would be lost and replaced with the
1265 * Moose::Meta::Class
1266 * Moose::Meta::Attribute
1267 * Moose::Meta::Method
1270 * Moose::Error::Default
1271 * Moose::Error::Croak
1272 * Moose::Error::Confess
1273 - All instances of confess() changed to use overridable
1274 C<throw_error> method. This method ultimately calls a class
1275 constructor, and you can change the class being called. In
1276 addition, errors now pass more information than just a string.
1277 The default C<error_class> behaves like C<Carp::confess>, so
1278 the behavior is not visibly different for end users.
1280 0.57 Wed September 3, 2008
1282 - A new bit of doc intended to introduce folks familiar with
1283 "standard" Perl 5 OO to Moose concepts. (Dave Rolsky)
1285 * Moose::Unsweetened
1286 - Shows examples of two classes, each done first with and then
1287 without Moose. This makes a nice parallel to
1288 Moose::Intro. (Dave Rolsky)
1290 * Moose::Util::TypeConstraints
1291 - Fixed a bug in find_or_parse_type_constraint so that it
1292 accepts a Moose::Meta::TypeConstraint object as the parent
1293 type, not just a name (jnapiorkowski)
1294 - added tests (jnapiorkowski)
1297 - If Sub::Name was not present, unimporting failed to actually
1298 remove some sugar subs, causing test failures (Dave Rolsky)
1300 0.56 Mon September 1, 2008
1301 For those not following the series of dev releases, there are
1302 several major changes in this release of Moose.
1303 ! Moose::init_meta should now be called as a method. See the
1306 - Major performance improvements by nothingmuch.
1308 - New modules for extension writers, Moose::Exporter and
1309 Moose::Util::MetaRole by Dave Rolsky.
1311 - Lots of doc improvements and additions, especially in the
1314 - Various bug fixes.
1316 * Removed all references to the experimental-but-no-longer-needed
1317 Moose::Meta::Role::Application::ToMetaclassInstance.
1319 * Require Class::MOP 0.65.
1321 0.55_04 Sat August 30, 2008
1322 * Moose::Util::MetaRole
1323 * Moose::Cookbook::Extending::Recipe2
1324 - This simplifies the application of roles to any meta class, as
1325 well as the base object class. Reimplemented metaclass traits
1326 using this module. (Dave Rolsky)
1328 * Moose::Cookbook::Extending::Recipe1
1329 - This a new recipe, an overview of various ways to write Moose
1330 extensions (Dave Rolsky)
1332 * Moose::Cookbook::Extending::Recipe3
1333 * Moose::Cookbook::Extending::Recipe4
1334 - These used to be Extending::Recipe1 and Extending::Recipe2,
1337 0.55_03 Fri August 29, 2008
1338 * No changes from 0.55_02 except increasing the Class::MOP
1339 dependency to 0.64_07.
1341 0.55_02 Fri August 29, 2008
1342 * Makefile.PL and Moose.pm
1343 - explicitly require Perl 5.8.0+ (Dave Rolsky)
1345 * Moose::Util::TypeConstraints
1346 - Fix warnings from find_type_constraint if the type is not
1349 * Moose::Meta::TypeConstraint
1350 - Predicate methods (equals/is_a_type_of/is_subtype_of) now
1351 return false if the type you specify cannot be found in the
1352 type registry, rather than throwing an unhelpful and
1353 coincidental exception. (t0m).
1354 - added docs & test for this (t0m)
1356 * Moose::Meta::TypeConstraint::Registry
1357 - add_type_constraint now throws an exception if a parameter is
1359 - added docs & test for this (t0m)
1361 * Moose::Cookbook::FAQ
1362 - Added a faq entry on the difference between "role" and "trait"
1366 - Fixed a bug that caused role composition to not see a required
1367 method when that method was provided by another role being
1368 composed at the same time. (Dave Rolsky)
1369 - test and bug finding (tokuhirom)
1371 0.55_01 Wed August 20, 2008
1373 !! Calling Moose::init_meta as a function is now !!
1374 !! deprecated. Please see the Moose.pm docs for details. !!
1376 * Moose::Meta::Method::Constructor
1377 - Fix inlined constructor so that values produced by default
1378 or builder methods are coerced as required. (t0m)
1379 - added test for this (t0m)
1381 * Moose::Meta::Attribute
1382 - A lazy attribute with a default or builder did not attempt to
1383 coerce the default value. The immutable code _did_
1385 - added test for this (t0m)
1388 - This is a new helper module for writing "Moose-alike"
1389 modules. This should make the lives of MooseX module authors
1390 much easier. (Dave Rolsky)
1393 * Moose::Cookbook::Meta::Recipe5
1394 - Implemented metaclass traits (and wrote a recipe for it):
1396 use Moose -traits => 'Foo'
1398 This should make writing small Moose extensions a little
1399 easier (Dave Rolsky)
1401 * Moose::Cookbook::Basics::Recipe1
1402 - Removed any examples of direct hashref access, and applied an
1403 editorial axe to reduce verbosity. (Dave Rolsky)
1405 * Moose::Cookbook::Basics::Recipe1
1406 - Also applied an editorial axe here. (Dave Rolsky)
1409 * Moose::Cookbook::Extending::Recipe1
1410 * Moose::Cookbook::Extending::Recipe2
1411 - Rewrote extending and embedding moose documentation and
1412 recipes to use Moose::Exporter (Dave Rolsky)
1416 - These two modules now warn when you load them from the main
1417 package "main" package, because we will not export sugar to
1418 main. Previously it just did nothing. (Dave Rolsky)
1421 - Now provide an init_meta method just like Moose.pm, and you
1422 can call this to provide an alternate role metaclass. (Dave
1423 Rolsky and nothingmuch)
1424 - get_method_map now respects the package cache flag (nothingmuch)
1427 - Two new methods - add_method and wrap_method_body
1431 - Optimizations including allowing constructors to accept hash
1432 refs, making many more classes immutable, and making
1433 constructors immutable. (nothingmuch)
1435 0.55 Sun August 3, 2008
1436 * Moose::Meta::Attribute
1437 - breaking down the way 'handles' methods are
1438 created so that the process can be more easily
1439 overridden by subclasses (stevan)
1441 * Moose::Meta::TypeConstraint
1442 - fixing what is passed into a ->message with
1443 the type constraints (RT #37569)
1444 - added tests for this (Charles Alderman)
1446 * Moose::Util::TypeConstraints
1447 - fix coerce to accept anon types like subtype can (mst)
1450 - reorganized the recipes into sections - Basics, Roles, Meta,
1451 Extending - and wrote abstracts for each section (Dave Rolsky)
1453 * Moose::Cookbook::Basics::Recipe10
1454 - A new recipe that demonstrates operator overloading
1455 in combination with Moose. (bluefeet)
1457 * Moose::Cookbook::Meta::Recipe1
1458 - an introduction to what meta is and why you'd want to make
1459 your own metaclass extensions (Dave Rolsky)
1461 * Moose::Cookbook::Meta::Recipe4
1462 - a very simple metaclass example (Dave Rolsky)
1464 * Moose::Cookbook::Extending::Recipe1
1465 - how to write a Moose-alike module to use your own object base
1468 * Moose::Cookbook::Extending::Recipe2
1469 - how to write modules with an API just like C<Moose.pm> (Dave
1473 - Tons of fixes, both syntactical and grammatical (Dave
1474 Rolsky, Paul Fenwick)
1476 0.54 Thurs. July 3, 2008
1477 ... this is not my day today ...
1479 * Moose::Meta::Attribute
1480 - fixed legal_options_for_inheritance such that
1481 clone_and_inherit options still works for
1482 Class::MOP::Attribute objects and therefore
1483 does not break MooseX::AttributeHelpers
1486 0.53 Thurs. July 3, 2008
1487 * Whoops, I guess I should run 'make manifest' before
1488 actually releasing the module. No actual changes
1489 in this release, except the fact that it includes
1490 the changes that I didn't include in the last
1493 0.52 Thurs. July 3, 2008
1495 - added "FEATURE REQUESTS" section to the Moose docs
1496 to properly direct people (stevan) (RT #34333)
1497 - making 'extends' croak if it is passed a Role since
1498 this is not ever something you want to do
1499 (fixed by stevan, found by obra)
1500 - added tests for this (stevan)
1503 - adding support for DOES (as in UNIVERSAL::DOES)
1505 - added test for this
1507 * Moose::Meta::Attribute
1508 - added legal_options_for_inheritance (wreis)
1509 - added tests for this (wreis)
1511 * Moose::Cookbook::Snacks::*
1512 - removed some of the unfinished snacks that should
1513 not have been released yet. Added some more examples
1514 to the 'Keywords' snack. (stevan)
1516 * Moose::Cookbook::Style
1517 - added general Moose "style guide" of sorts to the
1518 cookbook (nothingmuch) (RT #34335)
1521 - added more BUILDARGS tests (stevan)
1523 0.51 Thurs. Jun 26, 2008
1525 - add unimport so "no Moose::Role" actually does
1528 * Moose::Meta::Role::Application::ToRole
1529 - when RoleA did RoleB, and RoleA aliased a method from RoleB in
1530 order to provide its own implementation, that method still got
1531 added to the list of required methods for consumers of
1532 RoleB. Now an aliased method is only added to the list of
1533 required methods if the role doing the aliasing does not
1534 provide its own implementation. See Recipe 11 for an example
1535 of all this. (Dave Rolsky)
1536 - added tests for this
1538 * Moose::Meta::Method::Constructor
1539 - when a single argument that wasn't a hashref was provided to
1540 an immutabilized constructor, the error message was very
1541 unhelpful, as opposed to the non-immutable error. Reported by
1543 - added test for this (Dave Rolsky)
1545 * Moose::Meta::Attribute
1546 - added support for meta_attr->does("ShortAlias") (sartak)
1547 - added tests for this (sartak)
1548 - moved the bulk of the `handles` handling to the new
1549 install_delegation method (Stevan)
1552 - Added BUILDARGS, a new step in new()
1554 * Moose::Meta::Role::Application::RoleSummation
1555 - fix typos no one ever sees (sartak)
1557 * Moose::Util::TypeConstraints
1558 * Moose::Meta::TypeConstraint
1559 * Moose::Meta::TypeCoercion
1560 - Attempt to work around the ??{ } vs. threads issue
1562 - Some null_constraint optimizations
1564 0.50 Thurs. Jun 11, 2008
1565 - Fixed a version number issue by bumping all modules
1568 0.49 Thurs. Jun 11, 2008
1569 !! This version now approx. 20-25% !!
1570 !! faster with new Class::MOP 0.59 !!
1572 * Moose::Meta::Attribute
1573 - fixed how the is => (ro|rw) works with
1574 custom defined reader, writer and accessor
1576 - added docs for this (TODO).
1577 - added tests for this (Thanks to Penfold)
1578 - added the custom attribute alias for regular
1579 Moose attributes which is "Moose"
1580 - fix builder and default both being used
1585 Moose::Meta::Attribute
1587 Moose::Meta::Role::Composite
1588 Moose::Util::TypeConstraints
1589 - switched usage of reftype to ref because
1593 - changing add_package_symbol to use the new
1597 - fixed how DEMOLISHALL is called so that it
1598 can be overrided in subclasses (thanks to Sartak)
1599 - added test for this (thanks to Sartak)
1601 * Moose::Util::TypeConstraints
1602 - move the ClassName type check code to
1603 Class::MOP::is_class_loaded (thanks to Sartak)
1605 * Moose::Cookbook::Recipe11
1606 - add tests for this (thanks to tokuhirom)
1608 0.48 Thurs. May 29, 2008
1609 (early morning release engineering)--
1611 - fixing the version in Moose::Meta::Method::Destructor
1612 which was causing the indexer to choke
1614 0.47 Thurs. May 29, 2008
1615 (late night release engineering)--
1617 - fixing the version is META.yml, no functional
1618 changes in this release
1620 0.46 Wed. May 28, 2008
1621 !! This version now approx. 20-25% !!
1622 !! faster with new Class::MOP 0.57 !!
1624 * Moose::Meta::Class
1625 - some optimizations of the &initialize method
1626 since it is called so often by &meta
1628 * Moose::Meta::Class
1630 - now use the get_all_package_symbols from the
1631 updated Class::MOP, test suite is now 10 seconds
1634 * Moose::Meta::Method::Destructor
1635 - is_needed can now also be called as a class
1636 method for immutablization to check if the
1637 destructor object even needs to be created
1640 * Moose::Meta::Method::Destructor
1641 Moose::Meta::Method::Constructor
1642 - added more descriptive error message to help
1643 keep people from wasting time tracking an error
1644 that is easily fixed by upgrading.
1646 0.45 Saturday, May 24, 2008
1648 - Because of work in Class::MOP 0.57, all
1649 XS based functionality is now optional
1650 and a Pure Perl version is supplied
1651 - the CLASS_MOP_NO_XS environment variable
1652 can now be used to force non-XS versions
1654 - several of the packages have been tweaked
1655 to take care of this, mostly we added
1656 support for the package_name and name
1657 variables in all the Method metaclasses
1658 - before/around/after method modifiers now
1659 support regexp matching of names
1660 (thanks to Takatoshi Kitano)
1661 - tests added for this
1662 - NOTE: this only works for classes, it
1663 is currently not supported in roles,
1664 but, ... patches welcome
1665 - All usage of Carp::confess have been replaced
1666 by Carp::croak in the "keyword" functions since
1667 the stack trace is usually not helpful
1670 - All usage of Carp::confess have been replaced
1671 by Carp::croak in the "keyword" functions since
1672 the stack trace is usually not helpful
1673 - The 'has' keyword for roles now accepts the
1674 same array ref form that Moose.pm does
1675 (has [qw/foo bar/] => (is => 'rw', ...))
1676 - added test for this
1678 * Moose::Meta::Attribute
1679 - trigger on a ro-attribute is no longer an
1680 error, as it's useful to trigger off of the
1683 * Moose::Meta::Class
1684 - added same 'add_package_symbol' fix as in
1688 - does_role now handles non-Moose classes
1690 - added tests for this
1691 - added the 'add_method_modifier' function
1692 (thanks to Takatoshi Kitano)
1694 * Moose::Util::TypeConstraints
1695 - subtypes of parameterizable types now are
1696 themselves parameterizable types
1698 * Moose::Meta::Method::Constructor
1699 - fixed bug where trigger was not being
1700 called by the inlined immutable
1702 - added test for this (thanks to Caelum)
1704 * Moose::Meta::Role::Application::ToInstance
1705 - now uses the metaclass of the instance
1706 (if possible) to create the anon-class
1707 (thanks Jonathan Rockway)
1709 * Moose::Cookbook::Recipe22
1710 - added the meta-attribute trait recipe
1714 - fixed hash-ordering test bug that was
1715 causing occasional cpantester failures
1716 - renamed the t/000_recipe/*.t tests to be
1717 more descriptive (thanks to Sartak)
1719 0.44 Sat. May 10, 2008
1721 - made make_immutable warning cluck to
1722 show where the error is (thanks mst)
1725 - BUILDALL and DEMOLISHALL now call
1726 ->body when looping through the
1727 methods, to avoid the overloaded
1729 - fixed issue where DEMOLISHALL was
1730 eating the $@ values, and so not
1731 working correctly, it still kind of
1732 eats them, but so does vanilla perl
1733 - added tests for this
1735 * Moose::Cookbook::Recipe7
1736 - added new recipe for immutable
1737 functionality (thanks Dave Rolsky)
1739 * Moose::Cookbook::Recipe9
1740 - added new recipe for builder and
1741 lazy_build (thanks Dave Rolsky)
1743 * Moose::Cookbook::Recipe11
1744 - added new recipe for method aliasing
1745 and exclusion with Roles (thanks Dave Rolsky)
1748 - fixed Win32 test failure (thanks spicyjack)
1750 ~ removed Build.PL and Module::Build compat
1751 since Module::Install has done that.
1753 0.43 Wed. April, 30, 2008
1755 drink more coffee before
1756 doing release engineering
1758 - whoops, forgot to do the smolder tests,
1759 and we broke some of the custom meta-attr
1760 modules. This fixes that.
1762 0.42 Mon. April 28, 2008
1763 - some bad tests slipped by, nothing else
1764 changed in this release (cpantesters++)
1766 - upped the Class::MOP dependency to 0.55
1767 since we have tests which need the C3
1770 0.41 Mon. April 28, 2008
1771 ~~ numerous documentation updates ~~
1773 - Changed all usage of die to Carp::croak for better
1774 error reporting (initial patch by Tod Hagan)
1776 ** IMPORTANT NOTE **
1777 - the make_immutable keyword is now deprecated, don't
1778 use it in any new code and please fix your old code
1779 as well. There will be 2 releases, and then it will
1785 - refactored the way inner and super work to avoid
1786 any method/@ISA cache penalty (nothingmuch)
1788 * Moose::Meta::Class
1789 - fixing &new_object to make sure trigger gets the
1790 coerced value (spotted by Charles Alderman on the
1792 - added test for this
1794 * Moose::Meta::Method::Constructor
1795 - immutable classes which had non-lazy attributes were calling
1796 the default generating sub twice in the constructor. (bug
1797 found by Jesse Luehrs, fixed by Dave Rolsky)
1798 - added tests for this (Dave Rolsky)
1799 - fix typo in initialize_body method (nothingmuch)
1801 * Moose::Meta::Method::Destructor
1802 - fix typo in initialize_body method (nothingmuch)
1804 * Moose::Meta::Method::Overriden
1805 Moose::Meta::Method::Augmented
1806 - moved the logic for these into their own
1807 classes (nothingmuch)
1809 * Moose::Meta::Attribute
1810 - inherited attributes may now be extended without
1811 restriction on the type ('isa', 'does') (Sartak)
1812 - added tests for this (Sartak)
1813 - when an attribute property is malformed (such as lazy without
1814 a default), give the name of the attribute in the error
1816 - added the &applied_traits and &has_applied_traits methods
1817 to allow introspection of traits
1818 - added tests for this
1819 - moved 'trait' and 'metaclass' argument handling to here from
1821 - clone_and_inherit_options now handles 'trait' and 'metaclass' (has
1822 '+foo' syntax) (nothingmuch)
1823 - added tests for this (t0m)
1826 - localize $@ inside DEMOLISHALL to avoid it
1827 eating $@ (found by Ernesto)
1828 - added test for this (thanks to Ernesto)
1830 * Moose::Util::TypeConstraints
1831 - &find_type_constraint now DWIMs when given an
1832 type constraint object or name (nothingmuch)
1833 - &find_or_create_type_constraint superseded with a number of more
1835 - find_or_create_{isa,does}_type_constraint
1836 - find_or_parse_type_constraint
1838 * Moose::Meta::TypeConstraint
1839 Moose::Meta::TypeConstraint::Class
1840 Moose::Meta::TypeConstraint::Role
1841 Moose::Meta::TypeConstraint::Enum
1842 Moose::Meta::TypeConstraint::Union
1843 Moose::Meta::TypeConstraint::Parameterized
1844 - added the &equals method for comparing two type
1845 constraints (nothingmuch)
1846 - added tests for this (nothingmuch)
1848 * Moose::Meta::TypeConstraint
1849 - add the &parents method, which is just an alias to &parent.
1850 Useful for polymorphism with TC::{Class,Role,Union} (nothingmuch)
1852 * Moose::Meta::TypeConstraint::Class
1853 - added the class attribute for introspection purposes
1855 - added tests for this
1857 * Moose::Meta::TypeConstraint::Enum
1858 Moose::Meta::TypeConstraint::Role
1859 - broke these out into their own classes (nothingmuch)
1861 * Moose::Cookbook::Recipe*
1862 - fixed references to test file locations in the POD
1863 and updated up some text for new Moose features
1867 - Added &resolve_metaclass_alias, a helper function for finding an actual
1868 class for a short name (e.g. in the traits list)
1870 0.40 Fri. March 14, 2008
1871 - I hate Pod::Coverage
1873 0.39 Fri. March 14, 2008
1875 - documenting the use of '+name' with attributes
1876 that come from recently composed roles. It makes
1877 sense, people are using it, and so why not just
1878 officially support it.
1879 - fixing the 'extends' keyword so that it will not
1880 trigger Ovid's bug (http://use.perl.org/~Ovid/journal/35763)
1883 - added the perl -Moose=+Class::Name feature to allow
1884 monkeypatching of classes in one liners
1887 - fixing the 'apply_all_roles' keyword so that it will not
1888 trigger Ovid's bug (http://use.perl.org/~Ovid/journal/35763)
1890 * Moose::Meta::Class
1891 - added ->create method which now supports roles (thanks to jrockway)
1892 - added tests for this
1893 - added ->create_anon_class which now supports roles and caching of
1894 the results (thanks to jrockway)
1895 - added tests for this
1896 - made ->does_role a little more forgiving when it is
1897 checking a Class::MOP era metaclasses.
1899 * Moose::Meta::Role::Application::ToInstance
1900 - it is now possible to pass extra params to be used when
1901 a role is applied to an the instance (rebless_params)
1902 - added tests for this
1904 * Moose::Util::TypeConstraints
1905 - class_type now accepts an optional second argument for a
1906 custom message. POD anotated accordingly (groditi)
1907 - added tests for this
1908 - it is now possible to make anon-enums by passing 'enum' an
1909 ARRAY ref instead of the $name => @values. Everything else
1911 - added tests for this
1914 - making test for using '+name' on attributes consumed
1915 from a role, it works and makes sense too.
1917 * Moose::Meta::Attribute
1918 - fix handles so that it doesn't return nothing
1919 when the method cannot be found, not sure why
1920 it ever did this originally, this means we now
1921 have slightly better support for AUTOLOADed
1923 - added more delegation tests
1924 - adding ->does method to this so as to better
1925 support traits and their introspection.
1926 - added tests for this
1929 - localizing the Data::Dumper configurations so
1930 that it does not pollute others (RT #33509)
1931 - made ->does a little more forgiving when it is
1932 passed Class::MOP era metaclasses.
1934 0.38 Fri. Feb. 15, 2008
1935 * Moose::Meta::Attribute
1936 - fixed initializer to correctly do
1937 type checking and coercion in the
1939 - added tests for this
1942 - fixed some finicky tests (thanks to konobi)
1944 0.37 Thurs. Feb. 14, 2008
1946 - fixed some details in Moose::init_meta
1947 and its superclass handling (thanks thepler)
1948 - added tests for this (thanks thepler)
1949 - 'has' now dies if you don't pass in name
1951 - added the 'make_immutable' keyword as a shortcut
1954 * Moose::Meta::Class
1955 Moose::Meta::Method::Constructor
1956 Moose::Meta::Attribute
1957 - making (init_arg => undef) work here too
1958 (thanks to nothingmuch)
1960 * Moose::Meta::Attribute
1961 Moose::Meta::Method::Constructor
1962 Moose::Meta::Method::Accessor
1963 - make lazy attributes respect attr initializers (rjbs)
1964 - added tests for this
1966 * Moose::Util::TypeConstraints
1967 Moose::Util::TypeConstraints::OptimizedConstraints
1968 Moose::Meta::TypeConstraints
1969 Moose::Meta::Attribute
1970 Moose::Meta::Method::Constructor
1971 Moose::Meta::Method::Accessor
1972 - making type errors use the
1973 assigned message (thanks to Sartak)
1974 - added tests for this
1976 * Moose::Meta::Method::Destructor
1977 - making sure DESTROY gets inlined properly
1978 with successive DEMOLISH calls (thanks to manito)
1980 * Moose::Meta::Attribute
1981 Moose::Meta::Method::Accessor
1982 - fixed handling of undef with type constraints
1984 - added tests for this
1987 - added &get_all_init_args and &get_all_attribute_values
1988 (thanks to Sartak and nothingmuch)
1990 0.36 Sat. Jan. 26, 2008
1992 Moose::Meta::Attribute
1993 - role type tests now support when roles are
1994 applied to non-Moose classes (found by ash)
1995 - added tests for this (thanks to ash)
1996 - couple extra tests to boost code coverage
1998 * Moose::Meta::Method::Constructor
1999 - improved fix for handling Class::MOP attributes
2000 - added test for this
2002 * Moose::Meta::Class
2003 - handled the add_attribute($attribute_meta_object)
2005 - added test for this
2007 0.35 Tues. Jan. 22, 2008
2008 * Moose::Meta::Method::Constructor
2009 - fix to make sure even Class::MOP attributes
2010 are handled correctly (Thanks to Dave Rolsky)
2011 - added test for this (also Dave Rolsky)
2013 * Moose::Meta::Class
2014 - improved error message on _apply_all_roles,
2015 you should now use Moose::Util::apply_all_roles
2016 and you shouldnt have been using a _ prefixed
2017 method in the first place ;)
2019 0.34 Mon. Jan. 21, 2008
2020 ~~~ more misc. doc. fixes ~~~
2021 ~~ updated copyright dates ~~
2023 Moose is now a postmodern object system :)
2024 - (see the POD for details)
2026 * <<Role System Refactoring>>
2027 - this release contains a major reworking and
2028 cleanup of the role system
2029 - 100% backwards compat.
2030 - Role application now restructured into seperate
2031 classes based on type of applicants
2032 - Role summation (combining of more than one role)
2033 is much cleaner and anon-classes are no longer
2034 used in this process
2035 - new Composite role metaclass
2036 - runtime application of roles to instances
2037 is now more efficient and re-uses generated
2038 classes when applicable
2040 * <<New Role composition features>>
2041 - methods can now be excluded from a given role
2043 - methods can now be aliased to another name (and
2044 still retain the original as well)
2046 * Moose::Util::TypeConstraints::OptimizedConstraints
2047 - added this module (see above)
2049 * Moose::Meta::Class
2050 - fixed the &_process_attribute method to be called
2051 by &add_attribute, so that the API is now correct
2053 * Moose::Meta::Method::Accessor
2054 - fixed bug when passing a list of values to
2055 an accessor would get (incorrectly) ignored.
2056 Thanks to Sartak for finding this ;)
2057 - added tests for this (Sartak again)
2059 * Moose::Meta::Method::Accessor
2060 Moose::Meta::Method::Constructor
2061 Moose::Meta::Attribute
2062 Moose::Meta::TypeConstraint
2063 Moose::Meta::TypeCoercion
2064 - lots of cleanup of such things as:
2066 - type constraint handling
2067 - error handling/messages
2068 (thanks to nothingmuch)
2070 * Moose::Meta::TypeConstraint::Parameterizable
2071 - added this module to support the refactor
2072 in Moose::Meta::TypeConstraint::Parameterized
2074 * Moose::Meta::TypeConstraint::Parameterized
2075 - refactored how these types are handled so they
2076 are more generic and not confined to ArrayRef
2080 - shortened some file names for better VMS support (RT #32381)
2082 0.33 Fri. Dec. 14, 2007
2083 !! Moose now loads 2 x faster !!
2084 !! with new Class::MOP 0.49 !!
2086 ++ new oose.pm module to make command line
2087 Moose-ness easier (see POD docs for more)
2089 * Moose::Meta::Class
2091 - several tweaks to take advantage of the
2092 new method map caching in Class::MOP
2094 * Moose::Meta::TypeConstraint::Parameterized
2095 - allow subtypes of ArrayRef and HashRef to
2096 be used as a container (sartak)
2097 - added tests for this
2098 - basic support for coercion to ArrayRef and
2099 HashRef for containers (sartak)
2100 - added tests for this
2102 * Moose::Meta::TypeCoercion
2103 - coercions will now create subtypes as needed
2104 so you can now add coercions to parameterized
2105 types without having to explictly define them
2106 - added tests for this
2108 * Moose::Meta::Method::Accessor
2109 - allow subclasses to decide whether we need
2110 to copy the value into a new variable (sartak)
2112 0.32 Tues. Dec. 4, 2007
2113 * Moose::Util::TypeConstraints
2114 - fixing how subtype aliases of unions work
2115 they should inherit the parent's coercion
2116 - added tests for this
2117 - you can now define multiple coercions on
2118 a single type at different times instead of
2119 having to do it all in one place
2120 - added tests for this
2122 * Moose::Meta::TypeConstraint
2123 - there is now a default constraint of sub { 1 }
2124 instead of Moose::Util::TypeConstraints setting
2127 * Moose::Meta::TypeCoercion
2128 * Moose::Meta::TypeCoercion::Union
2129 - added the &has_coercion_for_type and
2130 &add_type_coercions methods to support the
2131 new features above (although you cannot add
2132 more type coercions for Union types)
2134 0.31 Mon. Nov. 26, 2007
2135 * Moose::Meta::Attribute
2136 - made the +attr syntax handle extending types with
2137 parameters. So "has '+foo' => (isa => 'ArrayRef[Int]')"
2138 now works if the original foo is an ArrayRef.
2139 - added tests for this.
2140 - delegation now works even if the attribute does not
2141 have a reader method using the get_read_method_ref
2142 method from Class::MOP::Attribute.
2143 - added tests for this
2144 - added docs for this
2146 * Moose::Util::TypeConstraints
2147 - passing no "additional attribute info" to
2148 &find_or_create_type_constraint will no longer
2149 attempt to create an __ANON__ type for you,
2150 instead it will just return undef.
2151 - added docs for this
2153 0.30 Fri. Nov. 23, 2007
2154 * Moose::Meta::Method::Constructor
2155 -builder related bug in inlined constructor. (groditi)
2157 * Moose::Meta::Method::Accessor
2158 - genereate unnecessary calls to predicates and refactor
2159 code generation for runtime speed (groditi)
2161 * Moose::Util::TypeConstraints
2162 - fix ClassName constraint to introspect symbol table (mst)
2163 - added more tests for this (mst)
2164 - fixed it so that subtype 'Foo' => as 'HashRef[Int]' ...
2165 with work correctly.
2166 - added tests for this
2169 - adding the link to Recipie 11 (written by Sartak)
2170 - adding test for SYNOPSIS code
2173 - New tests for builder bug. Upon instantiation, if an
2174 attribute had a builder, no value and was not lazy the
2175 builder default was not getting run, oops. (groditi)
2177 0.29 Tues. Nov. 13, 2007
2178 * Moose::Meta::Attribute
2179 - Fix error message on missing builder method (groditi)
2181 * Moose::Meta::Method::Accessor
2182 - Fix error message on missing builder method (groditi)
2185 - Add test to check for the correct error message when
2186 builder method is missing (groditi)
2188 0.28 Tues. Nov. 13, 2007
2189 - 0.27 packaged incorrectly (groditi)
2191 0.27 Tues. Nov. 13, 2007
2192 * Moose::Meta::Attribute
2193 - Added support for the new builder option (groditi)
2194 - Added support for lazy_build option (groditi)
2195 - Changed slot initialization for predicate changes (groditi)
2197 * Moose::Meta::Method::Accessor
2198 - Added support for lazy_build option (groditi)
2199 - Fix inline methods to work with corrected predicate
2202 * Moose::Meta::Method::Constructor
2203 - Added support for lazy_build option (groditi)
2206 - tests for builder and lazy_build (groditi)
2208 * fixing some misc. bits in the docs that
2209 got mentioned on CPAN Forum & perlmonks
2212 - fixed how required methods are handled
2213 when they encounter overriden or modified
2214 methods from a class (thanks to confound).
2215 - added tests for this
2217 * Moose::Util::TypeConstraint
2218 - fixed the type notation parser so that
2219 the | always creates a union and so is
2220 no longer a valid type char (thanks to
2221 konobi, mugwump and #moose for working
2223 - added more tests for this
2225 0.26 Thurs. Sept. 27, 2007
2228 * Parameterized Types
2229 We now support parameterized collection types, such as:
2230 ArrayRef[Int] # array or integers
2231 HashRef[Object] # a hash with object values
2232 They can also be nested:
2233 ArrayRef[HashRef[RegexpRef]] # an array of hashes with regex values
2234 And work with the type unions as well:
2235 ArrayRef[Int | Str] # array of integers of strings
2237 * Better Framework Extendability
2238 Moose.pm is now "extendable" such that it is now much
2239 easier to extend the framework and add your own keywords
2240 and customizations. See the "EXTENDING AND EMBEDDING MOOSE"
2241 section of the Moose.pm docs.
2244 In an effort to begin documenting some of the various
2245 details of Moose as well as some common idioms, we have
2246 created Moose::Cookbook::Snacks as a place to find
2247 small (easily digestable) nuggets of Moose code.
2250 ~ Several doc updates/cleanup thanks to castaway ~
2252 - converted build system to use Module::Install instead of
2253 Module::Build (thanks to jrockway)
2256 - added all the meta classes to the immutable list and
2257 set it to inline the accessors
2258 - fix import to allow Sub::Exporter like { into => }
2259 and { into_level => } (perigrin)
2260 - exposed and documented init_meta() to allow better
2261 embedding and extending of Moose (perigrin)
2264 - complete re-organization of the test suite
2265 - added some new tests as well
2266 - finally re-enabled the Moose::POOP test since
2267 the new version of DBM::Deep now works again
2270 * Moose::Meta::Class
2271 - fixed very odd and very nasty recursion bug with
2273 - added tests for this (eilara)
2275 * Moose::Meta::Attribute
2276 Moose::Meta::Method::Constructor
2277 Moose::Meta::Method::Accessor
2278 - fixed issue with overload::Overloaded getting called
2279 on non-blessed items. (RT #29269)
2280 - added tests for this
2282 * Moose::Meta::Method::Accessor
2283 - fixed issue with generated accessor code making
2284 assumptions about hash based classes (thanks to dexter)
2286 * Moose::Coookbook::Snacks
2287 - these are bits of documentation, not quite as big as
2288 Recipes but which have no clear place in the module docs.
2289 So they are Snacks! (horray for castaway++)
2291 * Moose::Cookbook::Recipe4
2292 - updated it to use the new ArrayRef[MyType] construct
2293 - updated the accompanying test as well
2295 +++ Major Refactor of the Type Constraint system +++
2296 +++ with new features added as well +++
2298 * Moose::Util::TypeConstraint
2299 - no longer uses package variable to keep track of
2300 the type constraints, now uses the an instance of
2301 Moose::Meta::TypeConstraint::Registry to do it
2302 - added more sophisticated type notation parsing
2304 - added tests for this
2306 * Moose::Meta::TypeConstraint
2307 - some minor adjustments to make subclassing easier
2308 - added the package_defined_in attribute so that we
2309 can track where the type constraints are created
2311 * Moose::Meta::TypeConstraint::Union
2312 - this is now been refactored to be a subclass of
2313 Moose::Meta::TypeConstraint
2315 * Moose::Meta::TypeCoercion::Union
2316 - this has been added to service the newly refactored
2317 Moose::Meta::TypeConstraint::Union and is itself
2318 a subclass of Moose::Meta::TypeCoercion
2320 * Moose::Meta::TypeConstraint::Parameterized
2321 - added this module (taken from MooseX::AttributeHelpers)
2322 to help construct nested collection types
2323 - added tests for this
2325 * Moose::Meta::TypeConstraint::Registry
2326 - added this class to keep track of type constraints
2328 0.25 Mon. Aug. 13, 2007
2330 - Documentation update to reference Moose::Util::TypeConstraints
2331 under 'isa' in 'has' for how to define a new type
2332 (thanks to shlomif).
2334 * Moose::Meta::Attribute
2335 - required attributes now will no longer accept undef
2336 from the constructor, even if there is a default and lazy
2337 - added tests for this
2338 - default subroutines must return a value which passes the
2340 - added tests for this
2342 * Moose::Meta::Attribute
2343 * Moose::Meta::Method::Constructor
2344 * Moose::Meta::Method::Accessor
2345 - type-constraint tests now handle overloaded objects correctly
2346 in the error message
2347 - added tests for this (thanks to EvanCarroll)
2349 * Moose::Meta::TypeConstraint::Union
2350 - added (has_)hand_optimized_constraint to this class so that
2351 it behaves as the regular Moose::Meta::TypeConstraint does.
2354 - large refactoring of this code
2355 - added several more tests
2356 - tests for subtle conflict resolition issues
2357 added, but not currently running
2360 * Moose::Cookbook::Recipe7
2361 - added new recipe for augment/inner functionality
2363 - added test for this
2366 - a formal definition of roles (still in progress)
2369 - utilities for easier working with Moose classes
2370 - added tests for these
2373 - This contains Moose specific test functions
2374 - added tests for these
2376 0.24 Tues. July 3, 2007
2377 ~ Some doc updates/cleanup ~
2379 * Moose::Meta::Attribute
2380 - added support for roles to be given as parameters
2381 to the 'handles' option.
2382 - added tests and docs for this
2383 - the has '+foo' attribute form now accepts changes to
2384 the lazy option, and the addition of a handles option
2385 (but not changing the handles option)
2386 - added tests and docs for this
2389 - required methods are now fetched using find_method_by_name
2390 so that required methods can come from superclasses
2391 - adjusted tests for this
2393 0.23 Mon. June 18, 2007
2394 * Moose::Meta::Method::Constructor
2395 - fix inlined constructor for hierarchy with multiple BUILD methods (mst)
2396 * Moose::Meta::Class
2397 - Modify make_immutable to work with the new Class::MOP immutable
2398 mechanism + POD + very basic test (groditi)
2399 * Moose::Meta::Attribute
2400 - Fix handles to use goto() so that caller() comes out properly on
2401 the other side (perigrin)
2403 0.22 Thurs. May 31, 2007
2404 * Moose::Util::TypeConstraints
2405 - fix for prototype undeclared issue when Moose::Util::TypeConstraints
2406 loaded before consumers (e.g. Moose::Meta::Attribute) by predeclaring
2407 prototypes for functions
2408 - added the ClassName type constraint, this checks for strings
2409 which will respond true to ->isa(UNIVERSAL).
2410 - added tests and docs for this
2411 - subtyping just in name now works correctly by making the
2412 default for where be { 1 }
2413 - added test for this
2415 * Moose::Meta::Method::Accessor
2416 - coerce and lazy now work together correctly, thanks to
2417 merlyn for finding this bug
2418 - tests added for this
2419 - fix reader presedence bug in Moose::Meta::Attribute + tests
2422 - Foo->new(undef) now gets ignored, it is assumed you meant to pass
2423 a HASH-ref and missed. This produces better error messages then
2424 having it die cause undef is not a HASH.
2425 - added tests for this
2427 0.21 Thursday, May 2nd, 2007
2429 - added SUPER_SLOT and INNER_SLOT class hashes to support unimport
2430 - modified unimport to remove super and inner along with the rest
2431 - altered unimport tests to handle this
2434 - altered super export to populate SUPER_SLOT
2436 * Moose::Meta::Class
2437 - altered augment and override modifier application to use *_SLOT
2438 - modified tests for these to unimport one test class each to test
2441 - fixed issue where custom attribute metaclasses
2442 where not handled correctly in roles
2443 - added tests for this
2445 * Moose::Meta::Class
2446 - fixed issue where extending metaclasses with
2447 roles would blow up. Thanks to Aankhen`` for
2448 finding this insidious error, and it's solution.
2450 ~~ lots of spelling and grammer fixes in the docs,
2451 many many thanks to rlb3 and Aankhen for these :)
2453 0.20 Friday, April 6th, 2007
2454 >> I messed up the SKIP logic in one test
2455 so this release is just to fix that.
2458 - 'has' now also accepts an ARRAY ref
2459 to create multiple attrs (see docs)
2460 (thanks to konobi for this)
2461 - added tests and docs
2463 0.19 Thurs. April 5th, 2007
2464 ~~ More documentation updates ~~
2466 * Moose::Util::TypeConstraints
2467 - 'type' now supports messages as well
2468 thanks to phaylon for finding this
2469 - added tests for this
2470 - added &list_all_type_constraints and
2471 &list_all_builtin_type_constraints
2472 functions to facilitate introspection.
2474 * Moose::Meta::Attribute
2475 - fixed regexp 'handles' declarations
2476 to build the list of delegated methods
2477 correctly (and not override important
2478 things like &new) thanks to ashleyb
2480 - added tests and docs for this
2481 - added the 'documentation' attributes
2482 so that you can actually document your
2483 attributes and inspect them through the
2485 - added tests and docs for this
2487 * Moose::Meta::Class
2488 - when loading custom attribute metaclasses
2489 it will first look in for the class in the
2490 Moose::Meta::Attribute::Custom::$name, and
2491 then default to just loading $name.
2492 - added tests and docs for this
2494 * Moose::Meta::TypeConstraint
2495 - type constraints now stringify to their names.
2496 - added test for this
2499 - added tests to assure we work with Module::Refresh
2500 - added stricter test skip logic in the Moose POOP
2501 test, ask Rob Kinyon why.
2502 - *cough* DBM::Deep 1.0 backwards compatibility sucks *cough* ;)
2504 0.18 Sat. March 10, 2007
2505 ~~ Many, many documentation updates ~~
2508 - We now use Class::MOP::load_class to
2510 - added tests to show types and subtypes
2511 working with Declare::Constraints::Simple
2512 and Test::Deep as constraint engines.
2515 !! You must have Class::MOP 0.37_001 !!
2516 !! for this developer release to work !!
2518 This release was primarily adding the immutable
2519 feature to Moose. An immutable class is one which
2520 you promise not to alter. When you set the class
2521 as immutable it will perform various bits of
2522 memoization and inline certain part of the code
2523 (constructors, destructors and accessors). This
2524 minimizes (and in some cases totally eliminates)
2525 one of Moose's biggest performance hits. This
2526 feature is not on by default, and is 100% optional.
2527 It has several configurable bits as well, so you
2528 can pick and choose to your specific needs.
2530 The changes involved in this were fairly wide and
2531 highly specific, but 100% backwards compatible, so
2532 I am not going to enumerate them here. If you are
2533 truely interested in what was changed, please do
2536 0.17 Tues. Nov. 14, 2006
2537 * Moose::Meta::Method::Accessor
2538 - bugfix for read-only accessors which
2539 are have a type constraint and lazy.
2540 Thanks to chansen for finding it.
2542 0.16 Tues. Nov. 14, 2006
2544 There are some speed improvements in this release,
2545 but they are only the begining, so stay tuned.
2548 - BUILDALL and DEMOLISHALL no longer get
2549 called unless they actually need to be.
2550 This gave us a signifigant speed boost
2551 for the cases when there is no BUILD or
2552 DEMOLISH method present.
2554 * Moose::Util::TypeConstraints
2555 * Moose::Meta::TypeConstraint
2556 - added an 'optimize_as' option to the
2557 type constraint, which allows for a
2558 hand optimized version of the type
2559 constraint to be used when possible.
2560 - Any internally created type constraints
2561 now provide an optimized version as well.
2563 0.15 Sun. Nov. 5, 2006
2565 This version of Moose *must* have Class::MOP 0.36 in order
2566 to work correctly. A number of small internal tweaks have
2567 been made in order to be compatible with that release.
2569 * Moose::Util::TypeConstraints
2570 - added &unimport so that you can clean out
2571 your class namespace of these exported
2574 * Moose::Meta::Class
2575 - fixed minor issue which occasionally
2576 comes up during global destruction
2578 - moved Moose::Meta::Method::Overriden into
2582 - moved Moose::Meta::Role::Method into
2585 * Moose::Meta::Attribute
2586 - changed how we do type checks so that
2587 we reduce the overall cost, but still
2590 - moved accessor generation methods to
2591 Moose::Meta::Method::Accessor to
2592 conform to the API changes from
2595 * Moose::Meta::TypeConstraint
2596 - changed how constraints are compiled
2597 so that we do less recursion and more
2598 iteration. This makes the type check
2600 - moved Moose::Meta::TypeConstraint::Union
2603 * Moose::Meta::Method::Accessor
2604 - created this from methods formerly found in
2605 Moose::Meta::Attribute
2607 * Moose::Meta::Role::Method
2608 - moved this from Moose::Meta::Role
2610 * Moose::Meta::Method::Overriden
2611 - moved this from Moose::Meta::Class
2613 * Moose::Meta::TypeConstraint::Union
2614 - moved this from Moose::Meta::TypeConstraint
2616 0.14 Mon. Oct. 9, 2006
2618 * Moose::Meta::Attribute
2619 - fixed lazy attributes which were not getting
2620 checked with the type constraint (thanks ashley)
2621 - added tests for this
2622 - removed the over-enthusiastic DWIMery of the
2623 automatic ArrayRef and HashRef defaults, it
2624 broke predicates in an ugly way.
2625 - removed tests for this
2627 0.13 Sat. Sept. 30, 2006
2629 This version of Moose *must* have Class::MOP 0.35 in order
2630 to work correctly. A number of small internal tweaks have
2631 been made in order to be compatible with that release.
2634 - Removed the use of UNIVERSAL::require to be a better
2635 symbol table citizen and remove a dependency
2636 (thanks Adam Kennedy)
2638 **~~ removed experimental & undocumented feature ~~**
2639 - commented out the 'method' and 'self' keywords, see the
2640 comments for more info.
2643 - added a FAQ and WTF files to document frequently
2644 asked questions and common problems
2646 * Moose::Util::TypeConstraints
2647 - added GlobRef and FileHandle type constraint
2648 - added tests for this
2650 * Moose::Meta::Attribute
2651 - if your attribute 'isa' ArrayRef of HashRef, and you have
2652 not explicitly set a default, then make the default DWIM.
2653 This will also work for subtypes of ArrayRef and HashRef
2655 - you can now auto-deref subtypes of ArrayRef or HashRef too.
2656 - new test added for this (thanks to ashley)
2659 - added basic support for runtime role composition
2660 but this is still *highly experimental*, so feedback
2661 is much appreciated :)
2662 - added tests for this
2664 * Moose::Meta::TypeConstraint
2665 - the type constraint now handles the coercion process
2666 through delegation, this is to support the coercion
2669 * Moose::Meta::TypeConstraint::Union
2670 - it is now possible for coercions to be performed
2672 - added tests for this (thanks to konobi)
2674 * Moose::Meta::TypeCoercion
2675 - properly capturing error when type constraint
2679 - Scalar::Util 1.18 is bad on Win32, so temporarily
2680 only require version 1.17 for Win32 and cygwin.
2681 (thanks Adam Kennedy)
2683 0.12 Sat. Sept. 1, 2006
2685 - Recipe5 (subtypes & coercion) has been written
2688 - fixed "bad meta" error message to be more descriptive
2689 - fixed &unimport to not remove the &inner and &super
2690 keywords because we need to localize them.
2691 - fixed number of spelling/grammer issues, thanks Theory :)
2693 **~~ experimental & undocumented feature ~~**
2694 - added the method and self keywords, they are basically
2695 just sugar, and they may not stay around.
2698 - added &dump method to easily Data::Dumper
2701 * Moose::Meta::TypeConstraint
2702 - added the &is_a_type_of method to check both the current
2703 and the subtype of a method (similar to &isa with classes)
2706 - this is now a subclass of Class::MOP::Module, and no longer
2707 creates the _role_meta ugliness of before.
2708 - fixed tests to reflect this change
2710 0.11 Wed. July 12, 2006
2712 - added an &unimport method to remove all the keywords
2713 that Moose will import, simply add 'no Moose' to the
2714 bottom of your class file.
2717 - fixed some test failures caused by a forgotten test
2720 0.10 Thurs. July 6, 2006
2722 - improved error message when loading modules so
2723 it is less confusing when you load a role.
2724 - added &calculate_all_roles method to
2725 Moose::Meta::Class and Moose::Meta::Role
2728 This module has been tested against Class::MOP 0.30
2729 but it does not yet utilize the optimizations
2730 it makes available. Stay tuned for that ;)
2732 0.09_03 Fri. June 23, 2006
2733 ++ DEVELOPER RELEASE ++
2735 - 'use strict' and 'use warnings' are no longer
2736 needed in Moose classes, Moose itself will
2737 turn them on for you.
2738 - added tests for this
2739 - moved code from exported subs to private methods
2740 in Moose::Meta::Class
2743 - as with Moose, strict and warnings are
2744 automatically turned on for you.
2745 - added tests for this
2748 - now handles an edge case for override errors
2749 - added tests for this
2750 - added some more edge case tests
2752 0.09_02 Tues. May 16, 2006
2753 ++ DEVELOPER RELEASE ++
2755 - added prototypes to the exported subs
2759 - added prototypes to the exported subs
2762 * Moose::Util::TypeConstraints
2763 - cleaned up prototypes for the subs
2766 0.09_01 Fri. May 12, 2006
2767 ++ DEVELOPER RELEASE ++
2768 - This release works in combination with
2769 Class::MOP 0.29_01, it is a developer
2770 release because it uses the a new
2771 instance sub-protocol and a fairly
2772 complete Role implementation. It has
2773 not yet been optimized, so it slower
2774 the the previous CPAN version. This
2775 release also lacks good updated docs,
2776 the official release will have updated docs.
2779 - refactored the keyword exports
2780 - 'with' now checks Role validaity and
2781 accepts more than one Role at a time
2782 - 'extends' makes metaclass adjustments as
2783 needed to ensure metaclass compatibility
2786 - refactored the keyword exports
2787 - 'with' now checks Role validaity and
2788 accepts more than one Role at a time
2790 * Moose::Util::TypeConstraints
2791 - added the 'enum' keyword for simple
2792 string enumerations which can be used as
2794 - see example of usage in t/202_example.t
2797 - more careful checking of params to new()
2800 - much work done on the role composition
2801 - many new tests for conflict detection
2802 and composition edge cases
2803 - not enough documentation, I suggest
2804 looking at the tests
2806 * Moose::Meta::Instance
2807 - added new Instance metaclass to support
2808 the new Class::MOP instance protocol
2810 * Moose::Meta::Class
2811 - some small changes to support the new
2813 - some small additions to support Roles
2815 * Moose::Meta::Attribute
2816 - some improvements to the accessor generation code
2818 - some small changes to support the new
2820 - (still somewhat) experimental delegation support
2821 with the 'handles' option
2822 - added several tests for this
2823 - no docs for this yet
2825 0.05 Thurs. April 27, 2006
2827 - keywords are now exported with Sub::Exporter
2828 thanks to chansen for this commit
2829 - has keyword now takes a 'metaclass' option
2830 to support custom attribute meta-classes
2831 on a per-attribute basis
2832 - added tests for this
2833 - the 'has' keyword not accepts inherited slot
2834 specifications (has '+foo'). This is still an
2835 experimental feature and probably not finished
2836 see t/038_attribute_inherited_slot_specs.t for
2837 more details, or ask about it on #moose
2838 - added tests for this
2841 - keywords are now exported with Sub::Exporter
2843 * Moose::Utils::TypeConstraints
2844 - reorganized the type constraint hierarchy, thanks
2845 to nothingmuch and chansen for his help and advice
2847 - added some tests for this
2848 - keywords are now exported with Sub::Exporter
2849 thanks to chansen for this commit
2851 * Moose::Meta::Class
2852 - due to changes in Class::MOP, we had to change
2853 construct_instance (for the better)
2855 * Moose::Meta::Attribute
2856 - due to changes in Class::MOP, we had to add the
2857 initialize_instance_slot method (it's a good thing)
2859 * Moose::Meta::TypeConstraint
2860 - added type constraint unions
2861 - added tests for this
2862 - added the is_subtype_of predicate method
2863 - added tests for this
2865 0.04 Sun. April 16th, 2006
2867 - Roles can now consume other roles
2868 - added tests for this
2869 - Roles can specify required methods now with
2870 the requires() keyword
2871 - added tests for this
2874 - ripped out much of it's guts ,.. much cleaner now
2875 - added required methods and correct handling of
2876 them in apply() for both classes and roles
2877 - added tests for this
2878 - no longer adds a does() method to consuming classes
2879 it relys on the one in Moose::Object
2880 - added roles attribute and some methods to support
2881 roles consuming roles
2883 * Moose::Meta::Attribute
2884 - added support for triggers on attributes
2885 - added tests for this
2886 - added support for does option on an attribute
2887 - added tests for this
2889 * Moose::Meta::Class
2890 - added support for attribute triggers in the
2892 - added tests for this
2895 - Moose no longer creates a subtype for your class
2896 if a subtype of the same name already exists, this
2897 should DWIM in 99.9999% of all cases
2899 * Moose::Util::TypeConstraints
2900 - fixed bug where incorrect subtype conflicts were
2902 - added test for this
2905 - this class can now be extended with 'use base' if
2906 you need it, it properly loads the metaclass class now
2907 - added test for this
2909 0.03_02 Wed. April 12, 2006
2911 - you must now explictly use Moose::Util::TypeConstraints
2912 it no longer gets exported for you automatically
2915 - new() now accepts hash-refs as well as key/value lists
2916 - added does() method to check for Roles
2917 - added tests for this
2919 * Moose::Meta::Class
2920 - added roles attribute along with the add_role() and
2922 - added tests for this
2925 - now adds a does() method to consuming classes
2926 which tests the class's hierarchy for roles
2927 - added tests for this
2929 0.03_01 Mon. April 10, 2006
2931 - added new Role recipe (no content yet, only code)
2934 - added 'with' keyword for Role support
2935 - added test and docs for this
2936 - fixed subtype quoting bug
2937 - added test for this
2941 - added test and docs
2943 * Moose::Util::TypeConstraints
2944 - added the message keyword to add custom
2945 error messages to type constraints
2948 - the meta role to support Moose::Role
2949 - added tests and docs
2951 * Moose::Meta::Class
2952 - moved a number of things from Moose.pm
2953 to here, they should have been here
2956 * Moose::Meta::Attribute
2957 - moved the attribute option macros here
2958 instead of putting them in Moose.pm
2960 * Moose::Meta::TypeConstraint
2961 - added the message attributes and the
2963 - added tests and docs for this
2965 0.03 Thurs. March 30, 2006
2967 - added the Moose::Cookbook with 5 recipes,
2968 describing all the stuff Moose can do.
2971 - fixed an issue with &extends super class loading
2972 it now captures errors and deals with inline
2973 packages correctly (bug found by mst, solution
2975 - added super/override & inner/augment features
2976 - added tests and docs for these
2979 - BUILDALL now takes a reference of the %params
2980 that are passed to &new, and passes that to
2983 * Moose::Util::TypeConstraints
2984 - Type constraints now survive runtime reloading
2985 - added test for this
2987 * Moose::Meta::Class
2988 - fixed the way attribute defaults are handled
2989 during instance construction (bug found by chansen)
2991 * Moose::Meta::Attribute
2992 - read-only attributes now actually enforce their
2993 read-only-ness (this corrected in Class::MOP as
2996 0.02 Tues. March 21, 2006
2998 - many more tests, fixing some bugs and
3000 - &extends now loads the base module with
3002 - added UNIVERSAL::require to the
3005 - each new Moose class will also create
3006 and register a subtype of Object which
3007 correspond to the new Moose class.
3008 - the 'isa' option in &has now only
3009 accepts strings, and will DWIM in
3012 * Moose::Util::TypeConstraints
3013 - added type coercion features
3014 - added tests for this
3015 - added support for this in attributes
3016 and instance construction
3018 - type construction no longer creates a
3019 function, it registers the type instead.
3020 - added several functions to get the
3024 - BUILDALL and DEMOLISHALL were broken
3025 because of a mis-named hash key, Whoops :)
3027 * Moose::Meta::Attribute
3028 - adding support for coercion in the
3029 autogenerated accessors
3031 * Moose::Meta::Class
3032 - adding support for coercion in the
3033 instance construction
3035 * Moose::Meta::TypeConstraint
3036 * Moose::Meta::TypeCoercion
3037 - type constraints and coercions are now
3038 full fledges meta-objects
3040 0.01 Wed. March 15, 2006
3041 - Moooooooooooooooooose!!!