1 Also see Moose::Manual::Delta for more details of, and workarounds
2 for, noteworthy changes.
8 * New method find_type_for in Moose::Meta::TypeConstraint::Union, for finding
9 which member of the union a given value validates for. (Cory Watson)
13 * Added Moose::Manual::Support that defines the support, compatiblity, and
14 release policies for Moose. (Chris Prather)
16 0.98 Wed, Feb 10, 2010
20 * An internals change in 0.97 broke role application to an instance in some
21 cases. The bug occurred when two different roles were applied to different
22 instances of the same class. (Rafael Kitover)
29 * Calling ->reinitialize on a cached anonymous class effectively uncached
30 the metaclass object, causing the metaclass to go out of scope
31 unexpectedly. This could easily happen at a distance by applying a
32 metarole to an anonymous class. (Dave Rolsky).
38 * ScalarRef is now a parameterized type. You can now specify a type
39 constraint for whatever the reference points to. (Closes RT#50857)
40 (Michael G. Schwern, Florian Ragwitz)
44 * ScalarRef now accepts references to other references. (Closes RT#50934)
51 * Moose::Meta::Attribute::Native::Trait::Code now provides execute_method as
52 a delegation option. This allows the code reference to be called as a
53 method on the object. (Florian Ragwitz)
57 * Moose::Object::does no longer checks the entire inheritance tree, since
58 Moose::Meta::Class::does_role already does this. (doy)
60 * Moose::Util::add_method_modifier (and subsequently the sugar functions
61 Moose::before, Moose::after, and Moose::around) can now accept arrayrefs,
62 with the same behavior as lists. Types other than arrayref and regexp
63 result in an error. (Dylan Hardison)
65 0.94 Mon, Jan 18, 2010
69 * Please see the changes listed for 0.93_01 and Moose::Manual::Delta.
73 * Improved support for anonymous roles by changing various APIs to take
74 Moose::Meta::Role objects as well as role names. This included
76 - Moose::Meta::Class->does_role
77 - Moose::Meta::Role->does_role
78 - Moose::Util::does_role
79 - Moose::Util::apply_all_roles
80 - Moose::Util::ensure_all_roles
81 - Moose::Util::search_class_by_role
83 Requested by Shawn Moore. Addresses RT #51143 (and then some). (Dave Rolsky)
87 * Fix handling of non-alphanumeric attributes names like '@foo'. This should
88 work as long as the accessor method names are explicitly set to valid Perl
89 method names. Reported by Doug Treder. RT #53731. (Dave Rolsky)
92 0.93_03 Tue, Jan 5, 2010
96 * Portability fixes to our XS code so we compile with 5.8.8 and Visual
97 C++. Fixes RT #53391. Reported by Taro Nishino. (rafl)
100 0.93_02 Tue, Jan 5, 2010
104 * Depend on Class::MOP 0.97_01 so we can get useful results from CPAN
105 testers. (Dave Rolsky)
108 0.93_01 Mon, Jan 4, 2010
112 See Moose::Manual::Delta for more details on backwards compatiblity issues.
114 * Role attributes are now objects of the Moose::Meta::Role::Attribute
115 class. (Dave Rolsky).
117 * There were major changes to how metaroles are applied. We now distinguish
118 between metaroles for classes vs those for roles. See the
119 Moose::Util::MetaRole docs for details. (Dave Rolsky)
121 * The old MetaRole API has been deprecated, but will continue to
122 work. However, if you are applying an attribute metaclass role, this may
123 break because of the fact that roles now have an attribute metaclass
126 * Moose::Util::MetaRole::apply_metaclass_roles is now called
127 apply_metaroles. The old name is deprecated. Dave Rolsky>
129 * The unimport subs created by Moose::Exporter now clean up re-exported
130 functions like blessed and confess, unless the caller imported them from
131 somewhere else too. See Moose::Manua::Delta for backcompat details. (rafl)
133 [ENHANCEMENTS AND BUG FIXES]
135 * Changed the Str constraint to accept magic lvalue strings like one gets from
136 substr et al, again. (sorear)
138 * Sped up the type constraint parsing regex. (Sam Vilain)
140 * The Moose::Cookbook::Extending::Recipe2 recipe was broken. Fix suggested by
143 * Added Moose::Util::TypeConstraints exports when using oose.pm to allow
144 easier testing of TypeConstraints from the command line. (perigrin)
146 * Added a with_immutable test function to Test::Moose, to run a block of tests
147 with and without certain classes being immutable. (doy)
149 * We now use Module::Install extensions explicitly to avoid confusing errors
150 if they're not installed. We use Module::Install::AuthorRequires to stop
151 test extraction and general failures if you don't have the author side
152 dependencies installed.
154 * Fixed a grammar error in Moose::Cookbook::Basics::Recipe4. rt.cpan.org
155 #51791. (Amir E. Aharoni)
158 0.93 Thu, Nov 19, 2009
160 - Calling $object->new() is no longer deprecated, and no longer
164 - The get_attribute_map method is now deprecated. (Dave Rolsky)
166 * Moose::Meta::Method::Delegation
167 - Preserve variable aliasing in @_ for delegated methods, so that
168 altering @_ affects the passed value. (doy)
170 * Moose::Util::TypeConstraints
171 - Allow array refs for non-anonymous form of enum and duck_type, not
172 just anonymous. The non-arrayref forms may be removed in the
174 - Changed Str constraint to not accept globs (*STDIN or *FOO). (chansen)
175 - Properly document Int being a subtype of Str. (doy)
178 - Moose::Exporter using modules can now export their functions to the
179 main package. This applied to Moose and Moose::Role, among
180 others. (nothingmuch)
182 * Moose::Meta::Attribute
183 - Don't remove attribute accessors we never installed, during
184 remove_accessors. (doy)
186 * Moose::Meta::Attribute::Native::Trait::Array
187 - Don't bypass prototype checking when calling List::Util::first, to
188 avoid a segfault when it is called with a non-code argument. (doy)
190 * Moose::Meta::Attribute::Native::Trait::Code
191 - Fix passing arguments to code execute helpers. (doy)
193 0.92 Tue, Sep 22, 2009
194 * Moose::Util::TypeConstraints
195 - added the match_on_type operator (Stevan)
196 - added tests and docs for this (Stevan)
199 - Metaclass compat fixing should already happen recursively, there's no
200 need to explicitly walk up the inheritance tree. (doy)
202 * Moose::Meta::Attribute
203 - Add tests for set_raw_value and get_raw_value. (nothingmuch)
205 0.91 Thu, Sep 17, 2009
207 - Don't import any functions, in order to avoid polluting our namespace
208 with things that can look like methods (blessed, try, etc)
211 * Moose::Meta::Method::Constructor
212 - The generated code needs to called Scalar::Util::blessed by its
213 fully-qualified name or else Perl can interpret the call to blessed as
214 an indirect method call. This broke Search::GIN, which in turn broke
215 KiokuDB. (nothingmuch)
217 0.90 Tue, Sep 15, 2009
218 * Moose::Meta::Attribute::Native::Trait::Counter
219 * Moose::Meta::Attribute::Native::Trait::String
220 - For these two traits, an attribute which did not explicitly provide
221 methods to handles magically ended up delegating *all* the helper
222 methods. This has been removed. You must be explicit in your handles
223 declaration for all Native Traits. (Dave Rolsky)
226 - DEMOLISHALL behavior has changed. If any DEMOLISH method dies, we make
227 sure to rethrow its error message. However, we also localize $@ before
228 this so that if all the DEMOLISH methods success, the value of $@ will
229 be preserved. (nothingmuch and Dave Rolsky)
230 - We now also localize $? during object destruction. (nothingmuch and
232 - The handling of DEMOLISH methods was broken for immutablized classes,
233 which were not receiving the value of
234 Devel::GlobalDestruction::in_global_destruction.
235 - These two fixes address some of RT #48271, reported by Zefram.
236 - This is all now documented in Moose::Manual::Construction.
237 - Calling $object->new() is now deprecated. A warning will be
241 - Added more hooks to customize how roles are applied. The role
242 summation class, used to create composite roles, can now be changed
243 and/or have meta-roles applied to it. (rafl)
244 - The get_method_list method no longer explicitly excludes the "meta"
245 method. This was a hack that has been replaced by better hacks. (Dave
248 * Moose::Meta::Method::Delegation
249 - fixed delegated methods to make sure that any modifiers attached to
250 the accessor being delegated on will be called (Stevan)
251 - added tests for this (Stevan)
254 - Moose no longer warns when a class that is being made immutable has
255 mutable ancestors. While in theory this is a good thing to warn about,
256 we found so many exceptions to this that doing this properly became
259 0.89_02 Thu, Sep 10, 2009
260 * Moose::Meta::Attribute::Native
261 - Fix Hash, which still had 'empty' instead of 'is_empty'. (hdp)
263 * Moose::Meta::Attribute::Native::Trait::Array
264 - Added a number of functions from List::Util and List::MoreUtils,
265 including reduce, shuffle, uniq, and natatime. (doy)
268 - This module will now generate an init_meta method for your exporting
269 class if you pass it options for
270 Moose::Util::MetaRole::apply_metaclass_roles or
271 apply_base_class_roles. This eliminates a lot of repetitive
272 boilerplate for typical MooseX modules. (doy).
273 - Documented the with_meta feature, which is a replacement for
274 with_caller. This feature was added by josh a while ago.
275 - The with_caller feature is now deprecated, but will not issue a
276 warning yet. (Dave Rolsky)
277 - If you try to wrap/export a subroutine which doesn't actually exist,
278 Moose::Exporter will warn you about this. (doy)
280 * Moose::Meta::Role::Application::ToRole
281 - When a role aliased a method from another role, it was only getting
282 the new (aliased) name, not the original name. This differed from what
283 happens when a class aliases a role's methods. If you _only_ want the
284 aliased name, make sure to also exclue the original name. (Dave
287 0.89_01 Wed Sep 2, 2009
288 * Moose::Meta::Attribute
289 - Added the currying syntax for delegation from AttributeHelpers to the
290 existing delegation API. (hdp)
292 * Moose::Meta::Attribute::Native
293 - We have merged the functionality of MooseX::AttributeHelpers into the
294 Moose core with some API tweaks. You can continue to use
295 MooseX::AttributeHelpers, but it will not be maintained except
296 (perhaps) for critical bug fixes in the future. See
297 Moose::Manual::Delta for details. (hdp, jhannah, rbuels, Sartak,
300 * Moose::Error::Croak
301 * Moose::Error::Confess
302 - Clarify documentation on how to use different error-throwing
303 modules. (Curtis Jewell)
306 - Correct POD for builder to point to Recipe8, not 9. (gphat)
309 - When a nonexistent sub name is passed to as_is, with_caller, or
310 with_meta, throw a warning and skip the exporting, rather than
311 installing a broken sub. (doy)
314 - Moose now warns if you call C<make_immutable> for a class with mutable
317 0.89 Thu Aug 13, 2009
318 * Moose::Manual::Attributes
319 - Clarify "is", include discussion of "bare". (Sartak)
321 * Moose::Meta::Role::Method::Conflicting
322 * Moose::Meta::Role::Application::ToClass
323 - For the first set of roles involved in a conflict, report all
324 unresolved method conflicts, not just the first method. Fixes #47210
325 reported by Ovid. (Sartak)
327 * Moose::Meta::TypeConstraint
328 - Add assert_valid method to use a TypeConstraint for assertion (rjbs)
331 - Make "use Moose -metaclass => 'Foo'" do alias resolution, like -traits
333 - Allow specifying role options (alias, excludes, MXRP stuff) in the
334 arrayref passed to "use Moose -traits" (doy)
337 - Add functions meta_class_alias and meta_attribute_alias for creating
338 aliases for class and attribute metaclasses and metatraits. (doy)
340 * Moose::Meta::Attribute
341 * Moose::Meta::Method::Accessor
342 - A trigger now receives the old value as a second argument, if the
343 attribute had one. (Dave Rolsky)
345 * Moose::Meta::Method::Constructor
346 - Fix a bug with $obj->new when $obj has stringify overloading.
347 Reported by Andrew Suffield [rt.cpan.org #47882] (Sartak)
348 - However, we will probably deprecate $obj->new, so please don't start
349 using it for new code!
351 * Moose::Meta::Role::Application
352 * Moose::Meta::Role::Application::RoleSummation
353 - Rename alias and excludes to -alias and -excludes (but keep the old
354 names for now, for backcompat) (doy)
356 0.88 Fri Jul 24, 2009
357 * Moose::Manual::Contributing
358 - Re-write the Moose::Manual::Contributing document to reflect
359 the new layout and methods of work for the Git repository. All
360 work now should be done in topic branches and reviewed by a
361 core committer before being applied to master. All releases
362 are done by a cabal member and merged from master to
363 stable. This plan was devised by Yuval, blame him. (perigrin)
366 - Create metaclass attributes for the different role application
369 * Moose::Util::MetaRole
370 - Allow applying roles to a meta role's role application
373 * Moose::Meta::Attribute
374 - Add weak_ref to allowed options for "has '+foo'" (mst)
376 * Moose::Meta::Method::Accessor
377 - No longer uses inline_slot_access in accessors, to support
378 non-lvalue-based meta instances. (sorear)
381 * Moose::Meta::Method::Delegation
382 - Once again allow class names as well as objects for
383 delegation. This was changed in 0.86.
386 * Moose::Meta::Class::Immutable::Trait
387 - Fixes to work with the latest Class::MOP.
389 * Moose::Meta::Method::Delegation
390 - Delegation now dies with a more useful error message if the
391 attribute's accessor returns something defined but
394 0.85 Fri, Jun 26, 2009
395 * Moose::Meta::Attribute
396 - The warning for 'no associated methods' is now split out into
397 the _check_associated_methods method, so that extensions can
398 safely call 'after install_accessors => ...'. This fixes a
399 warning from MooseX::AttributeHelpers. (hdp)
401 0.84 Fri, Jun 26, 2009
403 - has now sets definition_context for attributes defined in
406 * Moose::Meta::Attribute
407 - When adding an attribute to a metaclass, if the attribute has
408 no associated methods, it will give a deprecation
410 - Methods generated by delegation were not being added to
411 associated_methods. (hdp)
412 - Attribute accessors (reader, writer, accessor, predicate,
413 clearer) now warn if they overwrite an existing method. (doy)
414 - Attribute constructors now warn very noisily about unknown (or
415 misspelled) arguments
417 * Moose::Util::TypeConstraints
418 - Deprecated the totally useless Role type name, which just
419 checked if $object->can('does'). Note that this is _not_ the
420 same as a type created by calling role_type('RoleName').
422 * Moose::Util::TypeConstraints
423 * Moose::Meta::TypeConstraint::DuckType
424 - Reify duck type from a regular subtype into an actual class
426 - Document this because Sartak did all my work for me
429 * Moose::Meta::Attribute
430 - Allow Moose::Meta::TypeConstraint::DuckType in handles, since
431 it is just a list of methods (Sartak)
434 - The get_*_method_modifiers methods would die if the role had
435 no modifiers of the given type (Robert Buels).
437 0.83 Tue, Jun 23, 2009
439 - Fix _construct_instance not setting the special __MOP__ object
440 key in instances of anon classes. (doy)
442 0.82 Sun, Jun 21, 2009
443 * Moose::Manual::Types
444 - Mention MooseX::Types early to avoid users falling down the
445 string parsing rathole (mst)
447 * Moose::Manual::MooseX
448 - Add warnings about class-level extensions and mention considering
449 using plain objects instead
451 0.81 Sun, Jun 7, 2009
452 * Bumped our Class::MOP prereq to the latest version (0.85), since
455 0.80 Sat, Jun 6, 2009
457 - Add FAQ about the coercion change from 0.76 because it came up
458 three times today (perigrin)
459 - Win doy $10 dollars because Sartak didn't think anybody
460 would document this fast enough (perigrin)
462 * Moose::Meta::Method::Destructor
463 - Inline a DESTROY method even if there are no DEMOLISH methods
464 to prevent unnecessary introspection in
465 Moose::Object::DEMOLISHALL
468 - A role's required methods are now represented by
469 Moose::Meta::Role::Method::Required objects. Conflicts are now
470 represented by Moose::Meta::Role::Method::Conflicting
471 objects. The benefit for end-users in that unresolved
472 conflicts generate different, more instructive, errors,
473 resolving Ovid's #44895. (Sartak)
476 - Improve the error message of "extends" as suggested by Adam
477 Kennedy and confound (Sartak)
478 - Link to Moose::Manual::Roles from Moose::Role as we now have
479 excellent documentation (Adam Kennedy)
482 - Update test suite for subname change in Class::MOP
484 - Add TODO test for infinite recursion in Moose::Meta::Class
487 0.79 Wed, May 13, 2009
489 - More fixes for Win32 problems. Reported by Robert Krimen.
492 - The DEMOLISHALL method could still blow up in some cases
493 during global destruction. This method has been made more
494 resilient in the face of global destruction's random garbage
498 - If you "also" a module that isn't loaded, the error message
499 now acknowledges that (Sartak)
502 - When your ->meta method does not return a Moose::Meta::Class,
503 the error message gave the wrong output (Sartak)
505 0.78 Tue, May 12, 2009
506 * Moose::Cookbook::FAQ and Moose::Cookbook::WTF
507 - Merged these documents into what is now Moose::Manual::FAQ
510 - Moved to Moose::Manual::Unsweetened
512 * Moose::Cookbook::Basics::Recipes 9-12
513 - Renamed to be 8-11, since recipe 8 did not exist
516 - Make Moose::Exporter import strict and warnings into packages
520 - Fix DEMOLISHALL sometimes not being able to find DEMOLISH
521 methods during global destruction (doy)
524 * Moose::Meta::Role::Application::ToClass
525 - Track the Role::Application objects created during class-role
529 - Fix metaclass incompatibility errors when extending a vanilla perl
530 class which isa Moose class with a metaclass role applied (t0m)
533 - Add a role-combination hook, _role_for_combination, for the
534 benefit of MooseX::Role::Parameterized (Sartak)
537 - Some tests were failing on Win32 because they explicit checked
538 warning output for newlines. Reported by Nickolay Platonov.
540 0.77 Sat, May 2, 2009
542 - Add explicit use of Devel::GlobalDestruction and Sub::Name
546 - Pass a boolean to DEMOLISHALL and DEMOLISH indicating whether
547 or not we are currently in global destruction (doy)
548 - Add explicit use of Devel::GlobalDestruction and Sub::Name
551 * Moose::Cookbook::FAQ
552 - Reworked much of the existing content to be more useful to
553 modern Moose hackers (Sartak)
556 - Depend on Class::MOP 0.83 instead of 0.82_01.
558 0.76 Mon, April 27, 2009
559 * Moose::Meta::TypeConstraint
560 - Do not run coercions in coerce() if the value already passes the type
563 * Moose::Meta::TypeConstraint::Class
564 - In validation error messages, specifically say that the value is not
565 an instance of the class. This should alleviate some frustrating
566 forgot-to-load-my-type bugs. rt.cpan.org #44639 (Sartak)
568 * Moose::Meta::Role::Application::ToClass
569 - Revert the class-overrides-role warning in favor of a solution outside
570 of the Moose core (Sartak)
573 - Make Test::Output optional again, since it's only used in a few files
576 0.75_01 Thu, April 23, 2009
577 * Moose::Meta::Role::Application::ToClass
578 - Moose now warns about each class overriding methods from roles it
582 - Warnings tests have standardized on Test::Output which is now an
583 unconditionally dependency (Sartak)
586 - Changes to immutabilization to work with Class::MOP 0.82_01+.
588 0.75 Mon, April 20, 2009
591 - Move validation of not inheriting from roles from Moose::extends to
592 Moose::Meta::Class::superclasses (doy)
595 - add ensure_all_roles() function to encapsulate the common "apply this
596 role unless the object already does it" pattern (hdp)
599 - Users can now select a different metaclass with the "-metaclass"
600 option to import, for classes and roles (Sartak)
603 - Make method_metaclass an attr so that it can accept a metarole
606 0.74 Tue, April 7, 2009
608 * Moose::Meta::Method::Destructor
609 - Include stack traces in the deprecation warnings.
613 - Removed the long-deprecated _apply_all_roles method.
615 * Moose::Meta::TypeConstraint
616 - Removed the long-deprecated union method.
619 0.73_02 Mon, April 6, 2009
620 * More deprecations and renamings
621 - Moose::Meta::Method::Constructor
622 - initialize_body => _initialize_body (this is always called
623 when an object is constructed)
626 - The DEMOLISHALL method could throw an exception during global
627 destruction, meaning that your class's DEMOLISH methods would
628 not be properly called. Reported by t0m.
630 * Moose::Meta::Method::Destructor
631 - Destructor inlining was totally broken by the change to the
632 is_needed method in 0.72_01. Now there is a test for this
633 feature, and it works again.
636 - Bold the word 'not' in the POD for find_meta (t0m)
638 0.73_01 Sun, April 5, 2009
640 - Call user_class->meta in fewer places, with the eventual goal
641 of allowing the user to rename or exclude ->meta
642 altogether. Instead uses Class::MOP::class_of. (Sartak)
644 * Moose::Meta::Method::Accessor
645 - If an attribute had a lazy default, and that value did not
646 pass the attribute's type constraint, it did not get the
647 message from the type constraint, instead using a generic
648 message. Test provided by perigrin.
650 * Moose::Util::TypeConstraints
651 - Add duck_type keyword. It's sugar over making sure an object
652 can() a list of methods. This is easier than jrockway's
653 suggestion to fork all of CPAN. (perigrin)
654 - add tests and documentation (perigrin)
657 - Document the fact that init_meta() returns the target class's
658 metaclass object. (hdp)
660 * Moose::Cookbook::Extending::Recipe1
661 * Moose::Cookbook::Extending::Recipe2
662 * Moose::Cookbook::Extending::Recipe3
663 * Moose::Cookbook::Extending::Recipe4
664 - Make init_meta() examples explicitly return the metaclass and
665 point out this fact. (hdp)
667 * Moose::Cookbook::Basics::Recipe12
668 - A new recipe, creating a custom meta-method class.
670 * Moose::Cookbook::Meta::Recipe6
671 - A new recipe, creating a custom meta-method class.
674 * Moose::Meta::Method::Constructor
675 - Attribute triggers no longer receive the meta-attribute object
676 as an argument in any circumstance. Previously, triggers
677 called during instance construction were passed the
678 meta-attribute, but triggers called by normal accessors were
679 not. Fixes RT#44429, reported by Mark Swayne. (hdp)
681 * Moose::Manual::Attributes
682 - Remove references to triggers receving the meta-attribute object as an
685 * Moose::Cookbook::FAQ
686 - Remove recommendation for deprecated Moose::Policy and
687 Moose::Policy::FollowPBP; recommend MooseX::FollowPBP
690 * Many methods have been renamed with a leading underscore, and a
691 few have been deprecated entirely. The methods with a leading
692 underscore are consider "internals only". People writing
693 subclasses or extensions to Moose should feel free to override
694 them, but they are not for "public" use.
697 - check_metaclass_compatibility => _check_metaclass_compatibility
699 - Moose::Meta::Method::Accessor
700 - initialize_body => _initialize_body (this is always called
701 when an object is constructed)
702 - /(generate_.*_method(?:_inline)?)/ => '_' . $1
704 - Moose::Meta::Method::Constructor
705 - initialize_body => _initialize_body (this is always called
706 when an object is constructed)
707 - /(generate_constructor_method(?:_inline)?)/ => '_' . $1
708 - attributes => _attributes (now inherited from parent)
709 - meta_instance => _meta_instance (now inherited from parent)
712 - alias_method is deprecated. Use add_method
714 0.73 Fri, March 29, 2009
715 * No changes from 0.72_01.
717 0.72_01 Thu, March 26, 2009
719 - Almost every module has complete API documentation. A few
720 methods (and even whole classes) have been intentionally
721 excluded pending some rethinking of their APIs.
723 * Moose::Util::TypeConstraints
724 - Calling subtype with a name as the only argument is now an
725 exception. If you want an anonymous subtype do:
727 my $subtype = subtype as 'Foo';
729 * Moose::Cookbook::Meta::Recipe7
730 - A new recipe, creating a custom meta-instance class.
732 * Moose::Cookbook::Basics::Recipe5
733 - Fix various typos and mistakes. Includes a patch from Radu
736 * Moose::Cookbook::Basics::Recipe9
737 - Link to this recipe from Moose.pm's builder blurb
740 - When wrapping a function with a prototype, Moose::Exporter now
741 makes sure the wrapped function still has the same
742 prototype. (Daisuke Maki)
744 * Moose::Meta::Attribute
745 - Allow a subclass to set lazy_build for an inherited
749 - Explicitly depend on Data::OptList. We already had this dependency
750 via Sub::Exporter, but since we're using it directly we're
751 better off with it listed. (Sartak)
753 * Moose::Meta::Method::Constructor
754 - Make it easier to subclass the inlining behaviour. (Ash
757 * Moose::Manual::Delta
758 - Details significant changes in the history of Moose, along
759 with recommended workarounds.
761 * Moose::Manual::Contributing
762 - Contributor's guide to Moose.
764 * Moose::Meta::Method::Constructor
765 - The long-deprecated intialize_body method has been removed
766 (yes, spelled like that).
768 * Moose::Meta::Method::Destructor
769 - This is_needed method is now always a class method.
772 - Changes to the internals of how make_immutable works to match
773 changes in latest Class::MOP.
775 0.72 Mon, February 23, 2009
777 * Moose::Meta::Method::Constructor
778 - A mutable class accepted Foo->new(undef) without complaint,
779 while an immutable class would blow up with an unhelpful
780 error. Now, in both cases we throw a helpful error
781 instead. Reported by doy.
783 0.71_01 Sun, February 22, 2009
785 - Hopefully fixed some POD errors in a few recipes that caused
786 them to display weird on search.cpan.org.
788 * Moose::Util::TypeConstraints
789 - Calling type or subtype without the sugar helpers (as, where,
790 message) is now deprecated.
791 - The subtype function tried hard to guess what you meant, but
792 often got it wrong. For example:
794 my $subtype = subtype as 'ArrayRef[Object]';
796 This caused an error in the past, but now works as you'd
800 - Make sure Moose.pm is loaded before calling
801 Moose->throw_error. This wasn't normally an issue, but could
802 bite you in weird cases.
804 0.71 Thu, February 19, 2009
805 * Moose::Cookbook::Basics::Recipe11
806 - A new recipe which demonstrates the use of BUILDARGS and
809 * Moose::Cookbook::Roles::Recipe3
810 - A new recipe, applying a role to an object instance. (Dave
814 - Allow overriding specific keywords from "also" packages. (doy)
817 - Replace hardcoded cookbook tests with Test::Inline to ensure
818 the tests match the actual code in the recipes. (Dave Rolsky)
821 - Working on the above turned up a number of little bugs in the
822 recipe code. (Dave Rolsky)
824 * Moose::Util::TypeConstraints::Optimized
825 - Just use Class::MOP for the optimized ClassName check. (Dave
828 0.70 Sat, February 14, 2009
829 * Moose::Util::TypeConstraints
830 - Added the RoleName type (stevan)
831 - added tests for this (stevan)
833 * Moose::Cookbook::Basics::Recipe3
834 - Updated the before qw[left right] sub to be a little more
835 defensive about what it accepts (stevan)
836 - added more tests to t/000_recipies/basics/003_binary_tree.t
840 - We now always call DEMOLISHALL, even if a class does not
841 define DEMOLISH. This makes sure that method modifiers on
842 DEMOLISHALL work as expected. (doy)
843 - added tests for this (EvanCarroll)
845 * Moose::Util::MetaRole
846 - Accept roles for the wrapped_method_metaclass (rafl)
847 - added tests for this (rafl)
849 * Moose::Meta::Attribute
850 - We no longer pass the meta-attribute object as a final
851 argument to triggers. This actually changed for inlined code a
852 while back, but the non-inlined version and the docs were
856 - Some tests tried to use Test::Warn 0.10, which had bugs. Now
857 they require 0.11. (Dave Rolsky)
860 - Lots of small changes to the manual, cookbook, and
861 elsewhere. These were based on feedback from various
862 users, too many to list here. (Dave Rolsky)
864 0.69 Thu, February 12, 2009
866 - Make some keyword errors use throw_error instead of croak
867 since Moose::Exporter wraps keywords now (Sartak)
870 - Revised every recipe for style and clarity. Also moved some
871 documentation out of cookbook recipes and into Moose::Manual
872 pages. This work was funded as part of the Moose docs grant
873 from TPF. (Dave Rolsky)
875 * Moose::Meta::Method::Delegation
876 - If the attribute doing the delegation was not populated, the
877 error message did not specify the attribute name
880 0.68 Wed, February 4, 2009
882 - Many spelling, typo, and formatting fixes by daxim.
884 * Moose::Manual::Attributes
885 - The NAME section in the POD used "Attribute" so search.cpan
886 didn't resolve links from other documents properly.
888 * Moose::Meta::Method::Overriden
889 - Now properly spelled as Overridden. Thanks to daxim for
892 0.67 Tue, February 3, 2009
894 - Lots of little typo fixes and a few clarifications. Several
895 pages didn't have proper titles, and so weren't actually
896 visible on search.cpan.org. Thanks to hanekomu for a variety
897 of fixes and formatting improvements.
899 0.66 Tue, February 3, 2009
901 - This is a brand new, extensive manual for Moose. This aims to
902 provide a complete introduction to all of Moose's
903 features. This work was funded as part of the Moose docs grant
904 from TPF. (Dave Rolsky)
906 * Moose::Meta::Attribute
907 - Added a delegation_metaclass method to replace a hard-coded
908 use of Moose::Meta::Method::Delegation. (Dave Rolsky)
910 * Moose::Util::TypeConstraints
911 - If you created a subtype and passed a parent that Moose didn't
912 know about, it simply ignored the parent. Now it automatically
913 creates the parent as a class type. This may not be what you
914 want, but is less broken than before. (Dave Rolsky)
916 * Moose::Util::TypeConstraints
917 - This module tried throw errors by calling Moose->throw_error,
918 but it did not ensure that Moose was loaded first. This could
919 cause very unhelpful errors when it tried to throw an error
920 before Moose was loaded. (Dave Rolsky)
922 * Moose::Util::TypeConstraints
923 - You could declare a name with subtype such as "Foo!Bar" that
924 would be allowed, but if you used it in a parameterized type
925 such as "ArrayRef[Foo!Bar]" it wouldn't work. We now do some
926 vetting on names created via the sugar functions, so that they
927 can only contain alphanumerics, ":", and ".". (Dave Rolsky)
929 0.65 Thu, January 22, 2008
930 * Moose and Moose::Meta::Method::Overridden
931 - If an overridden method called super(), and then the
932 superclass's method (not overridden) _also_ called super(),
933 Moose went into an endless recursion loop. Test provided by
934 Chris Prather. (Dave Rolsky)
936 * Moose::Meta::TypeConstraint
937 - All methods are now documented. (gphat)
939 * t/100_bugs/011_DEMOLISH_eats_exceptions.t
940 - Fixed some bogus failures that occurred because we tried to
941 validate filesystem paths in a very ad-hoc and
942 not-quite-correct way. (Dave Rolsky)
944 * Moose::Util::TypeConstraints
945 - Added maybe_type to exports. See docs for details. (rjbs)
948 - Added Moose::Util::TypeConstraints to the SEE ALSO
952 - Methods created via an attribute can now fulfill a "requires"
953 declaration for a role. (nothingmuch)
955 * Moose::Meta::Method::*
956 - Stack traces from inlined code will now report its line and
957 file as being in your class, as opposed to in Moose
960 0.64 Wed, December 31, 2008
961 * Moose::Meta::Method::Accessor
962 - Always inline predicate and clearer methods (Sartak)
964 * Moose::Meta::Attribute
965 - Support for parameterized traits (Sartak)
966 - verify_against_type_constraint method to avoid duplication
967 and enhance extensibility (Sartak)
970 - Tests (but no support yet) for parameterized traits (Sartak)
973 - Require Class::MOP 0.75+, which has the side effect of making
974 sure we work on Win32. (Dave Rolsky)
976 0.63 Mon, December 8, 2008
978 - Some small grammar tweaks and bug fixes in non-Moose example
981 0.62_02 Fri, December 5, 2008
982 * Moose::Meta::Role::Application::ToClass
983 - When a class does not provide all of a role's required
984 methods, the error thrown now mentions all of the missing
985 methods, as opposed to just the first one found. Requested by
986 Curtis Poe (RT #41119). (Dave Rolsky)
988 * Moose::Meta::Method::Constructor
989 - Moose will no longer inline a constructor for your class
990 unless it inherits its constructor from Moose::Object, and
991 will warn when it doesn't inline. If you want to force
992 inlining anyway, pass "replace_constructor => 1" to
993 make_immutable. Addresses RT #40968, reported by Jon
994 Swartz. (Dave Rolsky)
995 - The quoting of default values could be broken if the default
996 contained a single quote ('). Now we use quotemeta to escape
997 anything potentially dangerous in the defaults. (Dave Rolsky)
999 0.62_01 Wed, December 3, 2008
1001 - use the method->execute API for BUILDALL
1002 and DEMOLISHALL (Sartak)
1004 * Moose::Util::TypeConstraints
1005 - We now make all the type constraint meta classes immutable
1006 before creating the default types provided by Moose. This
1007 should make loading Moose a little faster. (Dave Rolsky)
1009 0.62 Wed November 26, 2008
1010 * Moose::Meta::Role::Application::ToClass
1011 Moose::Meta::Role::Application::ToRole
1012 - fixed issues where excluding and aliasing the
1013 same methods for a single role did not work
1014 right (worked just fine with multiple
1016 - added test for this (stevan)
1018 * Moose::Meta::Role::Application::RoleSummation
1019 - fixed the error message when trying to compose
1020 a role with a role it excludes (Sartak)
1023 - Catch another case where recursion caused the value
1024 of $CALLER to be stamped on (t0m)
1025 - added test for this (t0m)
1028 - Remove the make_immutable keyword, which has been
1029 deprecated since April. It breaks metaclasses that
1030 use Moose without no Moose (Sartak)
1032 * Moose::Meta::Attribute
1033 - Removing an attribute from a class now also removes delegation
1034 (handles) methods installed for that attribute (t0m)
1035 - added test for this (t0m)
1037 * Moose::Meta::Method::Constructor
1038 - An attribute with a default that looked like a number (but was
1039 really a string) would accidentally be treated as a number
1040 when the constructor was made immutable (perigrin)
1041 - added test for this (perigrin)
1044 - create method for constructing a role
1045 dynamically (Sartak)
1046 - added test for this (Sartak)
1047 - anonymous roles! (Sartak)
1048 - added test for this (Sartak)
1051 - more consistent error messages (Sartak)
1053 * Moose::Cookbook::Roles::Recipe1
1054 - attempt to explain why a role that just requires
1055 methods is useful (Sartak)
1057 0.61 Fri November 7, 2008
1058 * Moose::Meta::Attribute
1059 - When passing a role to handles, it will be loaded if necessary
1062 * Moose::Meta::Class
1063 - Method objects returned by get_method (and other methods)
1064 Could end up being returned without an associated_metaclass
1065 attribute. Removing get_method_map, which is provided by
1066 Class::MOP::Class, fixed this. The Moose version did nothing
1067 different from its parent except introduce a bug. (Dave Rolsky)
1068 - added tests for this (jdv79)
1071 - Added a $VERSION to all .pm files which didn't have one. Fixes
1072 RT #40049, reported by Adam Kennedy. (Dave Rolsky)
1074 * Moose::Cookbook::Basics::Recipe4
1075 * Moose::Cookbook::Basics::Recipe6
1076 - These files had spaces on the first line of the SYNOPSIS, as
1077 opposed to a totally empty line. According to RT #40432, this
1078 confuses POD parsers. (Dave Rolsky)
1080 0.60 Fri October 24, 2008
1082 - Passing "-traits" when loading Moose caused the Moose.pm
1083 exports to be broken. Reported by t0m. (Dave Rolsky)
1084 - Tests for this bug. (t0m)
1087 - Change resolve_metaclass alias to use the new
1088 load_first_existing_class function. This makes it a lot
1089 simpler, and also around 5 times faster. (t0m)
1090 - Add caching to resolve_metaclass_alias, which gives an order
1091 of magnitude speedup to things which repeatedly call the
1092 Moose::Meta::Attribute->does method, notably MooseX::Storage
1095 * Moose::Util::TypeConstraint
1096 - Put back the changes for parameterized constraints that
1097 shouldn't have been removed in 0.59. We still cannot parse
1098 them, but MooseX modules can create them in some other
1099 way. See the 0.58 changes for more details. (jnapiorkowski)
1100 - Changed the way subtypes are created so that the job is
1101 delegated to a type constraint parent. This clears up some
1102 hardcoded checking and should allow correct subtypes of
1103 Moose::Meta::Type::Constraint. Don't rely on this new API too
1104 much (create_child_type) because it may go away in the
1105 future. (jnapiorkowski)
1107 * Moose::Meta::TypeConstraint::Union
1108 - Type constraint names are sorted as strings, not numbers.
1111 * Moose::Meta::TypeConstraint::Parameterizable
1112 - New parameterize method. This can be used as a factory method
1113 to make a new type constraint with a given parameterized
1114 type. (jnapiorkowski)
1115 - added tests (jnapiorkowski)
1117 0.59 Tue October 14, 2008
1119 - Add abridged documentation for builder/default/initializer/
1120 predicate, and link to more details sections in
1121 Class::MOP::Attribute. (t0m)
1123 * Moose::Util::TypeConstraints
1124 - removed prototypes from all but the &-based stuff (mst)
1126 * Moose::Util::TypeConstraints
1127 - Creating a anonymous subtype with both a constraint and a
1128 message failed with a very unhelpful error, but should just
1129 work. Reported by t0m. (Dave Rolsky)
1132 - Some tests that used Test::Warn if it was available failed
1133 with older versions of Test::Warn. Reported by Fayland. (Dave
1135 - Test firing behavior of triggers in relation to builder/default/
1137 - Test behavior of equals/is_a_type_of/is_a_subtype_of for all
1138 kinds of supported type. (t0m)
1140 * Moose::Meta::Class
1141 - In create(), do not pass "roles" option to the superclass
1142 - added related test that creates an anon metaclass with
1143 a required attribute
1145 * Moose::Meta::TypeConstraint::Class
1146 * Moose::Meta::TypeConstraint::Role
1147 - Unify behavior of equals/is_a_type_of/is_a_subtype_of with
1148 other types (as per change in 0.55_02). (t0m)
1150 * Moose::Meta::TypeConstraint::Registry
1151 - Fix warning when dealing with unknown type names (t0m)
1153 * Moose::Util::TypeConstraints
1154 - Reverted changes from 0.58 related to handle parameterized
1155 types. This caused random failures on BSD and Win32 systems,
1156 apparently related to the regex engine. This means that Moose
1157 can no longer parse structured type constraints like
1158 ArrayRef[Int,Int] or HashRef[name=>Str]. This will be
1159 supported in a slightly different way via MooseX::Types some
1160 time in the future. (Dave Rolsky)
1162 0.58 Sat September 20, 2008
1163 !! This release has an incompatible change regarding !!
1164 !! how roles add methods to a class !!
1166 * Roles and role application
1167 ! Roles now add methods by calling add_method, not
1168 alias_method. They make sure to always provide a method
1169 object, which will be cloned internally. This means that it is
1170 now possible to track the source of a method provided by a
1171 role, and even follow its history through intermediate roles.
1173 This means that methods added by a role now show up when
1174 looking at a class's method list/map. (Dave Rolsky)
1177 - From this release on, we'll try to maintain a list of
1178 conflicting modules, and warn you if you have one
1179 installed. For example, this release conflicts with ...
1180 - MooseX::Singleton <= 0.11
1181 - MooseX::Params::Validate <= 0.05
1184 In general, we try to not break backwards compatibility for
1185 most Moose users, but MooseX modules and other code which
1186 extends Moose's metaclasses is often affected by very small
1187 changes in the Moose internals.
1189 * Moose::Meta::Method::Delegation
1190 * Moose::Meta::Attribute
1191 - Delegation methods now have their own method class. (Dave
1194 * Moose::Meta::TypeConstraint::Parameterizable
1195 - Added a new method 'parameterize' which is basically a factory
1196 for the containing constraint. This makes it easier to create
1197 new types of parameterized constraints. (jnapiorkowski)
1199 * Moose::Meta::TypeConstraint::Union
1200 - Changed the way Union types canonicalize their names to follow
1201 the normalized TC naming rules, which means we strip all
1202 whitespace. (jnapiorkowski)
1204 * Moose::Util::TypeConstraints
1205 - Parameter and Union args are now sorted, this makes Int|Str
1206 the same constraint as Str|Int. (jnapiorkowski)
1207 - Changes to the way Union types are parsed to more correctly
1208 stringify their names. (jnapiorkowski)
1209 - When creating a parameterized type, we now use the new
1210 parameterize method. (jnapiorkowski)
1211 - Incoming type constraint strings are now normalized to remove
1212 all whitespace differences. (jnapiorkowski)
1213 - Changed the way we parse type constraint strings so that we now
1214 match TC[Int,Int,...] and TC[name=>Str] as parameterized type
1215 constraints. This lays the foundation for more flexible type
1216 constraint implementations.
1218 * Tests and docs for all the above. (jnapiorkowski)
1222 - Moose::Exporter will no longer remove a subroutine that the
1223 exporting package re-exports. Moose re-exports the
1224 Carp::confess function, among others. The reasoning is that we
1225 cannot know whether you have also explicitly imported those
1226 functions for your own use, so we err on the safe side and
1227 always keep them. (Dave Rolsky)
1228 - added tests for this (rafl)
1230 * Moose::Meta::Class
1231 - Changes to how we fix metaclass compatibility that are much
1232 too complicated to go into. The summary is that Moose is much
1233 less likely to complain about metaclass incompatibility
1234 now. In particular, if two metaclasses differ because
1235 Moose::Util::MetaRole was used on the two corresponding
1236 classes, then the difference in roles is reconciled for the
1237 subclass's metaclass. (Dave Rolsky)
1238 - Squashed an warning in _process_attribute (thepler)
1241 - throw exceptions (sooner) for invalid attribute names (thepler)
1242 - added tests for this (thepler)
1244 * Moose::Util::MetaRole
1245 - If you explicitly set a constructor or destructor class for a
1246 metaclass object, and then applied roles to the metaclass,
1247 that explicitly set class would be lost and replaced with the
1250 * Moose::Meta::Class
1251 * Moose::Meta::Attribute
1252 * Moose::Meta::Method
1255 * Moose::Error::Default
1256 * Moose::Error::Croak
1257 * Moose::Error::Confess
1258 - All instances of confess() changed to use overridable
1259 C<throw_error> method. This method ultimately calls a class
1260 constructor, and you can change the class being called. In
1261 addition, errors now pass more information than just a string.
1262 The default C<error_class> behaves like C<Carp::confess>, so
1263 the behavior is not visibly different for end users.
1265 0.57 Wed September 3, 2008
1267 - A new bit of doc intended to introduce folks familiar with
1268 "standard" Perl 5 OO to Moose concepts. (Dave Rolsky)
1270 * Moose::Unsweetened
1271 - Shows examples of two classes, each done first with and then
1272 without Moose. This makes a nice parallel to
1273 Moose::Intro. (Dave Rolsky)
1275 * Moose::Util::TypeConstraints
1276 - Fixed a bug in find_or_parse_type_constraint so that it
1277 accepts a Moose::Meta::TypeConstraint object as the parent
1278 type, not just a name (jnapiorkowski)
1279 - added tests (jnapiorkowski)
1282 - If Sub::Name was not present, unimporting failed to actually
1283 remove some sugar subs, causing test failures (Dave Rolsky)
1285 0.56 Mon September 1, 2008
1286 For those not following the series of dev releases, there are
1287 several major changes in this release of Moose.
1288 ! Moose::init_meta should now be called as a method. See the
1291 - Major performance improvements by nothingmuch.
1293 - New modules for extension writers, Moose::Exporter and
1294 Moose::Util::MetaRole by Dave Rolsky.
1296 - Lots of doc improvements and additions, especially in the
1299 - Various bug fixes.
1301 * Removed all references to the experimental-but-no-longer-needed
1302 Moose::Meta::Role::Application::ToMetaclassInstance.
1304 * Require Class::MOP 0.65.
1306 0.55_04 Sat August 30, 2008
1307 * Moose::Util::MetaRole
1308 * Moose::Cookbook::Extending::Recipe2
1309 - This simplifies the application of roles to any meta class, as
1310 well as the base object class. Reimplemented metaclass traits
1311 using this module. (Dave Rolsky)
1313 * Moose::Cookbook::Extending::Recipe1
1314 - This a new recipe, an overview of various ways to write Moose
1315 extensions (Dave Rolsky)
1317 * Moose::Cookbook::Extending::Recipe3
1318 * Moose::Cookbook::Extending::Recipe4
1319 - These used to be Extending::Recipe1 and Extending::Recipe2,
1322 0.55_03 Fri August 29, 2008
1323 * No changes from 0.55_02 except increasing the Class::MOP
1324 dependency to 0.64_07.
1326 0.55_02 Fri August 29, 2008
1327 * Makefile.PL and Moose.pm
1328 - explicitly require Perl 5.8.0+ (Dave Rolsky)
1330 * Moose::Util::TypeConstraints
1331 - Fix warnings from find_type_constraint if the type is not
1334 * Moose::Meta::TypeConstraint
1335 - Predicate methods (equals/is_a_type_of/is_subtype_of) now
1336 return false if the type you specify cannot be found in the
1337 type registry, rather than throwing an unhelpful and
1338 coincidental exception. (t0m).
1339 - added docs & test for this (t0m)
1341 * Moose::Meta::TypeConstraint::Registry
1342 - add_type_constraint now throws an exception if a parameter is
1344 - added docs & test for this (t0m)
1346 * Moose::Cookbook::FAQ
1347 - Added a faq entry on the difference between "role" and "trait"
1351 - Fixed a bug that caused role composition to not see a required
1352 method when that method was provided by another role being
1353 composed at the same time. (Dave Rolsky)
1354 - test and bug finding (tokuhirom)
1356 0.55_01 Wed August 20, 2008
1358 !! Calling Moose::init_meta as a function is now !!
1359 !! deprecated. Please see the Moose.pm docs for details. !!
1361 * Moose::Meta::Method::Constructor
1362 - Fix inlined constructor so that values produced by default
1363 or builder methods are coerced as required. (t0m)
1364 - added test for this (t0m)
1366 * Moose::Meta::Attribute
1367 - A lazy attribute with a default or builder did not attempt to
1368 coerce the default value. The immutable code _did_
1370 - added test for this (t0m)
1373 - This is a new helper module for writing "Moose-alike"
1374 modules. This should make the lives of MooseX module authors
1375 much easier. (Dave Rolsky)
1378 * Moose::Cookbook::Meta::Recipe5
1379 - Implemented metaclass traits (and wrote a recipe for it):
1381 use Moose -traits => 'Foo'
1383 This should make writing small Moose extensions a little
1384 easier (Dave Rolsky)
1386 * Moose::Cookbook::Basics::Recipe1
1387 - Removed any examples of direct hashref access, and applied an
1388 editorial axe to reduce verbosity. (Dave Rolsky)
1390 * Moose::Cookbook::Basics::Recipe1
1391 - Also applied an editorial axe here. (Dave Rolsky)
1394 * Moose::Cookbook::Extending::Recipe1
1395 * Moose::Cookbook::Extending::Recipe2
1396 - Rewrote extending and embedding moose documentation and
1397 recipes to use Moose::Exporter (Dave Rolsky)
1401 - These two modules now warn when you load them from the main
1402 package "main" package, because we will not export sugar to
1403 main. Previously it just did nothing. (Dave Rolsky)
1406 - Now provide an init_meta method just like Moose.pm, and you
1407 can call this to provide an alternate role metaclass. (Dave
1408 Rolsky and nothingmuch)
1409 - get_method_map now respects the package cache flag (nothingmuch)
1412 - Two new methods - add_method and wrap_method_body
1416 - Optimizations including allowing constructors to accept hash
1417 refs, making many more classes immutable, and making
1418 constructors immutable. (nothingmuch)
1420 0.55 Sun August 3, 2008
1421 * Moose::Meta::Attribute
1422 - breaking down the way 'handles' methods are
1423 created so that the process can be more easily
1424 overridden by subclasses (stevan)
1426 * Moose::Meta::TypeConstraint
1427 - fixing what is passed into a ->message with
1428 the type constraints (RT #37569)
1429 - added tests for this (Charles Alderman)
1431 * Moose::Util::TypeConstraints
1432 - fix coerce to accept anon types like subtype can (mst)
1435 - reorganized the recipes into sections - Basics, Roles, Meta,
1436 Extending - and wrote abstracts for each section (Dave Rolsky)
1438 * Moose::Cookbook::Basics::Recipe10
1439 - A new recipe that demonstrates operator overloading
1440 in combination with Moose. (bluefeet)
1442 * Moose::Cookbook::Meta::Recipe1
1443 - an introduction to what meta is and why you'd want to make
1444 your own metaclass extensions (Dave Rolsky)
1446 * Moose::Cookbook::Meta::Recipe4
1447 - a very simple metaclass example (Dave Rolsky)
1449 * Moose::Cookbook::Extending::Recipe1
1450 - how to write a Moose-alike module to use your own object base
1453 * Moose::Cookbook::Extending::Recipe2
1454 - how to write modules with an API just like C<Moose.pm> (Dave
1458 - Tons of fixes, both syntactical and grammatical (Dave
1459 Rolsky, Paul Fenwick)
1461 0.54 Thurs. July 3, 2008
1462 ... this is not my day today ...
1464 * Moose::Meta::Attribute
1465 - fixed legal_options_for_inheritance such that
1466 clone_and_inherit options still works for
1467 Class::MOP::Attribute objects and therefore
1468 does not break MooseX::AttributeHelpers
1471 0.53 Thurs. July 3, 2008
1472 * Whoops, I guess I should run 'make manifest' before
1473 actually releasing the module. No actual changes
1474 in this release, except the fact that it includes
1475 the changes that I didn't include in the last
1478 0.52 Thurs. July 3, 2008
1480 - added "FEATURE REQUESTS" section to the Moose docs
1481 to properly direct people (stevan) (RT #34333)
1482 - making 'extends' croak if it is passed a Role since
1483 this is not ever something you want to do
1484 (fixed by stevan, found by obra)
1485 - added tests for this (stevan)
1488 - adding support for DOES (as in UNIVERSAL::DOES)
1490 - added test for this
1492 * Moose::Meta::Attribute
1493 - added legal_options_for_inheritance (wreis)
1494 - added tests for this (wreis)
1496 * Moose::Cookbook::Snacks::*
1497 - removed some of the unfinished snacks that should
1498 not have been released yet. Added some more examples
1499 to the 'Keywords' snack. (stevan)
1501 * Moose::Cookbook::Style
1502 - added general Moose "style guide" of sorts to the
1503 cookbook (nothingmuch) (RT #34335)
1506 - added more BUILDARGS tests (stevan)
1508 0.51 Thurs. Jun 26, 2008
1510 - add unimport so "no Moose::Role" actually does
1513 * Moose::Meta::Role::Application::ToRole
1514 - when RoleA did RoleB, and RoleA aliased a method from RoleB in
1515 order to provide its own implementation, that method still got
1516 added to the list of required methods for consumers of
1517 RoleB. Now an aliased method is only added to the list of
1518 required methods if the role doing the aliasing does not
1519 provide its own implementation. See Recipe 11 for an example
1520 of all this. (Dave Rolsky)
1521 - added tests for this
1523 * Moose::Meta::Method::Constructor
1524 - when a single argument that wasn't a hashref was provided to
1525 an immutabilized constructor, the error message was very
1526 unhelpful, as opposed to the non-immutable error. Reported by
1528 - added test for this (Dave Rolsky)
1530 * Moose::Meta::Attribute
1531 - added support for meta_attr->does("ShortAlias") (sartak)
1532 - added tests for this (sartak)
1533 - moved the bulk of the `handles` handling to the new
1534 install_delegation method (Stevan)
1537 - Added BUILDARGS, a new step in new()
1539 * Moose::Meta::Role::Application::RoleSummation
1540 - fix typos no one ever sees (sartak)
1542 * Moose::Util::TypeConstraints
1543 * Moose::Meta::TypeConstraint
1544 * Moose::Meta::TypeCoercion
1545 - Attempt to work around the ??{ } vs. threads issue
1547 - Some null_constraint optimizations
1549 0.50 Thurs. Jun 11, 2008
1550 - Fixed a version number issue by bumping all modules
1553 0.49 Thurs. Jun 11, 2008
1554 !! This version now approx. 20-25% !!
1555 !! faster with new Class::MOP 0.59 !!
1557 * Moose::Meta::Attribute
1558 - fixed how the is => (ro|rw) works with
1559 custom defined reader, writer and accessor
1561 - added docs for this (TODO).
1562 - added tests for this (Thanks to Penfold)
1563 - added the custom attribute alias for regular
1564 Moose attributes which is "Moose"
1565 - fix builder and default both being used
1570 Moose::Meta::Attribute
1572 Moose::Meta::Role::Composite
1573 Moose::Util::TypeConstraints
1574 - switched usage of reftype to ref because
1578 - changing add_package_symbol to use the new
1582 - fixed how DEMOLISHALL is called so that it
1583 can be overrided in subclasses (thanks to Sartak)
1584 - added test for this (thanks to Sartak)
1586 * Moose::Util::TypeConstraints
1587 - move the ClassName type check code to
1588 Class::MOP::is_class_loaded (thanks to Sartak)
1590 * Moose::Cookbook::Recipe11
1591 - add tests for this (thanks to tokuhirom)
1593 0.48 Thurs. May 29, 2008
1594 (early morning release engineering)--
1596 - fixing the version in Moose::Meta::Method::Destructor
1597 which was causing the indexer to choke
1599 0.47 Thurs. May 29, 2008
1600 (late night release engineering)--
1602 - fixing the version is META.yml, no functional
1603 changes in this release
1605 0.46 Wed. May 28, 2008
1606 !! This version now approx. 20-25% !!
1607 !! faster with new Class::MOP 0.57 !!
1609 * Moose::Meta::Class
1610 - some optimizations of the &initialize method
1611 since it is called so often by &meta
1613 * Moose::Meta::Class
1615 - now use the get_all_package_symbols from the
1616 updated Class::MOP, test suite is now 10 seconds
1619 * Moose::Meta::Method::Destructor
1620 - is_needed can now also be called as a class
1621 method for immutablization to check if the
1622 destructor object even needs to be created
1625 * Moose::Meta::Method::Destructor
1626 Moose::Meta::Method::Constructor
1627 - added more descriptive error message to help
1628 keep people from wasting time tracking an error
1629 that is easily fixed by upgrading.
1631 0.45 Saturday, May 24, 2008
1633 - Because of work in Class::MOP 0.57, all
1634 XS based functionality is now optional
1635 and a Pure Perl version is supplied
1636 - the CLASS_MOP_NO_XS environment variable
1637 can now be used to force non-XS versions
1639 - several of the packages have been tweaked
1640 to take care of this, mostly we added
1641 support for the package_name and name
1642 variables in all the Method metaclasses
1643 - before/around/after method modifiers now
1644 support regexp matching of names
1645 (thanks to Takatoshi Kitano)
1646 - tests added for this
1647 - NOTE: this only works for classes, it
1648 is currently not supported in roles,
1649 but, ... patches welcome
1650 - All usage of Carp::confess have been replaced
1651 by Carp::croak in the "keyword" functions since
1652 the stack trace is usually not helpful
1655 - All usage of Carp::confess have been replaced
1656 by Carp::croak in the "keyword" functions since
1657 the stack trace is usually not helpful
1658 - The 'has' keyword for roles now accepts the
1659 same array ref form that Moose.pm does
1660 (has [qw/foo bar/] => (is => 'rw', ...))
1661 - added test for this
1663 * Moose::Meta::Attribute
1664 - trigger on a ro-attribute is no longer an
1665 error, as it's useful to trigger off of the
1668 * Moose::Meta::Class
1669 - added same 'add_package_symbol' fix as in
1673 - does_role now handles non-Moose classes
1675 - added tests for this
1676 - added the 'add_method_modifier' function
1677 (thanks to Takatoshi Kitano)
1679 * Moose::Util::TypeConstraints
1680 - subtypes of parameterizable types now are
1681 themselves parameterizable types
1683 * Moose::Meta::Method::Constructor
1684 - fixed bug where trigger was not being
1685 called by the inlined immutable
1687 - added test for this (thanks to Caelum)
1689 * Moose::Meta::Role::Application::ToInstance
1690 - now uses the metaclass of the instance
1691 (if possible) to create the anon-class
1692 (thanks Jonathan Rockway)
1694 * Moose::Cookbook::Recipe22
1695 - added the meta-attribute trait recipe
1699 - fixed hash-ordering test bug that was
1700 causing occasional cpantester failures
1701 - renamed the t/000_recipe/*.t tests to be
1702 more descriptive (thanks to Sartak)
1704 0.44 Sat. May 10, 2008
1706 - made make_immutable warning cluck to
1707 show where the error is (thanks mst)
1710 - BUILDALL and DEMOLISHALL now call
1711 ->body when looping through the
1712 methods, to avoid the overloaded
1714 - fixed issue where DEMOLISHALL was
1715 eating the $@ values, and so not
1716 working correctly, it still kind of
1717 eats them, but so does vanilla perl
1718 - added tests for this
1720 * Moose::Cookbook::Recipe7
1721 - added new recipe for immutable
1722 functionality (thanks Dave Rolsky)
1724 * Moose::Cookbook::Recipe9
1725 - added new recipe for builder and
1726 lazy_build (thanks Dave Rolsky)
1728 * Moose::Cookbook::Recipe11
1729 - added new recipe for method aliasing
1730 and exclusion with Roles (thanks Dave Rolsky)
1733 - fixed Win32 test failure (thanks spicyjack)
1735 ~ removed Build.PL and Module::Build compat
1736 since Module::Install has done that.
1738 0.43 Wed. April, 30, 2008
1740 drink more coffee before
1741 doing release engineering
1743 - whoops, forgot to do the smolder tests,
1744 and we broke some of the custom meta-attr
1745 modules. This fixes that.
1747 0.42 Mon. April 28, 2008
1748 - some bad tests slipped by, nothing else
1749 changed in this release (cpantesters++)
1751 - upped the Class::MOP dependency to 0.55
1752 since we have tests which need the C3
1755 0.41 Mon. April 28, 2008
1756 ~~ numerous documentation updates ~~
1758 - Changed all usage of die to Carp::croak for better
1759 error reporting (initial patch by Tod Hagan)
1761 ** IMPORTANT NOTE **
1762 - the make_immutable keyword is now deprecated, don't
1763 use it in any new code and please fix your old code
1764 as well. There will be 2 releases, and then it will
1770 - refactored the way inner and super work to avoid
1771 any method/@ISA cache penalty (nothingmuch)
1773 * Moose::Meta::Class
1774 - fixing &new_object to make sure trigger gets the
1775 coerced value (spotted by Charles Alderman on the
1777 - added test for this
1779 * Moose::Meta::Method::Constructor
1780 - immutable classes which had non-lazy attributes were calling
1781 the default generating sub twice in the constructor. (bug
1782 found by Jesse Luehrs, fixed by Dave Rolsky)
1783 - added tests for this (Dave Rolsky)
1784 - fix typo in initialize_body method (nothingmuch)
1786 * Moose::Meta::Method::Destructor
1787 - fix typo in initialize_body method (nothingmuch)
1789 * Moose::Meta::Method::Overriden
1790 Moose::Meta::Method::Augmented
1791 - moved the logic for these into their own
1792 classes (nothingmuch)
1794 * Moose::Meta::Attribute
1795 - inherited attributes may now be extended without
1796 restriction on the type ('isa', 'does') (Sartak)
1797 - added tests for this (Sartak)
1798 - when an attribute property is malformed (such as lazy without
1799 a default), give the name of the attribute in the error
1801 - added the &applied_traits and &has_applied_traits methods
1802 to allow introspection of traits
1803 - added tests for this
1804 - moved 'trait' and 'metaclass' argument handling to here from
1806 - clone_and_inherit_options now handles 'trait' and 'metaclass' (has
1807 '+foo' syntax) (nothingmuch)
1808 - added tests for this (t0m)
1811 - localize $@ inside DEMOLISHALL to avoid it
1812 eating $@ (found by Ernesto)
1813 - added test for this (thanks to Ernesto)
1815 * Moose::Util::TypeConstraints
1816 - &find_type_constraint now DWIMs when given an
1817 type constraint object or name (nothingmuch)
1818 - &find_or_create_type_constraint superseded with a number of more
1820 - find_or_create_{isa,does}_type_constraint
1821 - find_or_parse_type_constraint
1823 * Moose::Meta::TypeConstraint
1824 Moose::Meta::TypeConstraint::Class
1825 Moose::Meta::TypeConstraint::Role
1826 Moose::Meta::TypeConstraint::Enum
1827 Moose::Meta::TypeConstraint::Union
1828 Moose::Meta::TypeConstraint::Parameterized
1829 - added the &equals method for comparing two type
1830 constraints (nothingmuch)
1831 - added tests for this (nothingmuch)
1833 * Moose::Meta::TypeConstraint
1834 - add the &parents method, which is just an alias to &parent.
1835 Useful for polymorphism with TC::{Class,Role,Union} (nothingmuch)
1837 * Moose::Meta::TypeConstraint::Class
1838 - added the class attribute for introspection purposes
1840 - added tests for this
1842 * Moose::Meta::TypeConstraint::Enum
1843 Moose::Meta::TypeConstraint::Role
1844 - broke these out into their own classes (nothingmuch)
1846 * Moose::Cookbook::Recipe*
1847 - fixed references to test file locations in the POD
1848 and updated up some text for new Moose features
1852 - Added &resolve_metaclass_alias, a helper function for finding an actual
1853 class for a short name (e.g. in the traits list)
1855 0.40 Fri. March 14, 2008
1856 - I hate Pod::Coverage
1858 0.39 Fri. March 14, 2008
1860 - documenting the use of '+name' with attributes
1861 that come from recently composed roles. It makes
1862 sense, people are using it, and so why not just
1863 officially support it.
1864 - fixing the 'extends' keyword so that it will not
1865 trigger Ovid's bug (http://use.perl.org/~Ovid/journal/35763)
1868 - added the perl -Moose=+Class::Name feature to allow
1869 monkeypatching of classes in one liners
1872 - fixing the 'apply_all_roles' keyword so that it will not
1873 trigger Ovid's bug (http://use.perl.org/~Ovid/journal/35763)
1875 * Moose::Meta::Class
1876 - added ->create method which now supports roles (thanks to jrockway)
1877 - added tests for this
1878 - added ->create_anon_class which now supports roles and caching of
1879 the results (thanks to jrockway)
1880 - added tests for this
1881 - made ->does_role a little more forgiving when it is
1882 checking a Class::MOP era metaclasses.
1884 * Moose::Meta::Role::Application::ToInstance
1885 - it is now possible to pass extra params to be used when
1886 a role is applied to an the instance (rebless_params)
1887 - added tests for this
1889 * Moose::Util::TypeConstraints
1890 - class_type now accepts an optional second argument for a
1891 custom message. POD anotated accordingly (groditi)
1892 - added tests for this
1893 - it is now possible to make anon-enums by passing 'enum' an
1894 ARRAY ref instead of the $name => @values. Everything else
1896 - added tests for this
1899 - making test for using '+name' on attributes consumed
1900 from a role, it works and makes sense too.
1902 * Moose::Meta::Attribute
1903 - fix handles so that it doesn't return nothing
1904 when the method cannot be found, not sure why
1905 it ever did this originally, this means we now
1906 have slightly better support for AUTOLOADed
1908 - added more delegation tests
1909 - adding ->does method to this so as to better
1910 support traits and their introspection.
1911 - added tests for this
1914 - localizing the Data::Dumper configurations so
1915 that it does not pollute others (RT #33509)
1916 - made ->does a little more forgiving when it is
1917 passed Class::MOP era metaclasses.
1919 0.38 Fri. Feb. 15, 2008
1920 * Moose::Meta::Attribute
1921 - fixed initializer to correctly do
1922 type checking and coercion in the
1924 - added tests for this
1927 - fixed some finicky tests (thanks to konobi)
1929 0.37 Thurs. Feb. 14, 2008
1931 - fixed some details in Moose::init_meta
1932 and its superclass handling (thanks thepler)
1933 - added tests for this (thanks thepler)
1934 - 'has' now dies if you don't pass in name
1936 - added the 'make_immutable' keyword as a shortcut
1939 * Moose::Meta::Class
1940 Moose::Meta::Method::Constructor
1941 Moose::Meta::Attribute
1942 - making (init_arg => undef) work here too
1943 (thanks to nothingmuch)
1945 * Moose::Meta::Attribute
1946 Moose::Meta::Method::Constructor
1947 Moose::Meta::Method::Accessor
1948 - make lazy attributes respect attr initializers (rjbs)
1949 - added tests for this
1951 * Moose::Util::TypeConstraints
1952 Moose::Util::TypeConstraints::OptimizedConstraints
1953 Moose::Meta::TypeConstraints
1954 Moose::Meta::Attribute
1955 Moose::Meta::Method::Constructor
1956 Moose::Meta::Method::Accessor
1957 - making type errors use the
1958 assigned message (thanks to Sartak)
1959 - added tests for this
1961 * Moose::Meta::Method::Destructor
1962 - making sure DESTROY gets inlined properly
1963 with successive DEMOLISH calls (thanks to manito)
1965 * Moose::Meta::Attribute
1966 Moose::Meta::Method::Accessor
1967 - fixed handling of undef with type constraints
1969 - added tests for this
1972 - added &get_all_init_args and &get_all_attribute_values
1973 (thanks to Sartak and nothingmuch)
1975 0.36 Sat. Jan. 26, 2008
1977 Moose::Meta::Attribute
1978 - role type tests now support when roles are
1979 applied to non-Moose classes (found by ash)
1980 - added tests for this (thanks to ash)
1981 - couple extra tests to boost code coverage
1983 * Moose::Meta::Method::Constructor
1984 - improved fix for handling Class::MOP attributes
1985 - added test for this
1987 * Moose::Meta::Class
1988 - handled the add_attribute($attribute_meta_object)
1990 - added test for this
1992 0.35 Tues. Jan. 22, 2008
1993 * Moose::Meta::Method::Constructor
1994 - fix to make sure even Class::MOP attributes
1995 are handled correctly (Thanks to Dave Rolsky)
1996 - added test for this (also Dave Rolsky)
1998 * Moose::Meta::Class
1999 - improved error message on _apply_all_roles,
2000 you should now use Moose::Util::apply_all_roles
2001 and you shouldnt have been using a _ prefixed
2002 method in the first place ;)
2004 0.34 Mon. Jan. 21, 2008
2005 ~~~ more misc. doc. fixes ~~~
2006 ~~ updated copyright dates ~~
2008 Moose is now a postmodern object system :)
2009 - (see the POD for details)
2011 * <<Role System Refactoring>>
2012 - this release contains a major reworking and
2013 cleanup of the role system
2014 - 100% backwards compat.
2015 - Role application now restructured into seperate
2016 classes based on type of applicants
2017 - Role summation (combining of more than one role)
2018 is much cleaner and anon-classes are no longer
2019 used in this process
2020 - new Composite role metaclass
2021 - runtime application of roles to instances
2022 is now more efficient and re-uses generated
2023 classes when applicable
2025 * <<New Role composition features>>
2026 - methods can now be excluded from a given role
2028 - methods can now be aliased to another name (and
2029 still retain the original as well)
2031 * Moose::Util::TypeConstraints::OptimizedConstraints
2032 - added this module (see above)
2034 * Moose::Meta::Class
2035 - fixed the &_process_attribute method to be called
2036 by &add_attribute, so that the API is now correct
2038 * Moose::Meta::Method::Accessor
2039 - fixed bug when passing a list of values to
2040 an accessor would get (incorrectly) ignored.
2041 Thanks to Sartak for finding this ;)
2042 - added tests for this (Sartak again)
2044 * Moose::Meta::Method::Accessor
2045 Moose::Meta::Method::Constructor
2046 Moose::Meta::Attribute
2047 Moose::Meta::TypeConstraint
2048 Moose::Meta::TypeCoercion
2049 - lots of cleanup of such things as:
2051 - type constraint handling
2052 - error handling/messages
2053 (thanks to nothingmuch)
2055 * Moose::Meta::TypeConstraint::Parameterizable
2056 - added this module to support the refactor
2057 in Moose::Meta::TypeConstraint::Parameterized
2059 * Moose::Meta::TypeConstraint::Parameterized
2060 - refactored how these types are handled so they
2061 are more generic and not confined to ArrayRef
2065 - shortened some file names for better VMS support (RT #32381)
2067 0.33 Fri. Dec. 14, 2007
2068 !! Moose now loads 2 x faster !!
2069 !! with new Class::MOP 0.49 !!
2071 ++ new oose.pm module to make command line
2072 Moose-ness easier (see POD docs for more)
2074 * Moose::Meta::Class
2076 - several tweaks to take advantage of the
2077 new method map caching in Class::MOP
2079 * Moose::Meta::TypeConstraint::Parameterized
2080 - allow subtypes of ArrayRef and HashRef to
2081 be used as a container (sartak)
2082 - added tests for this
2083 - basic support for coercion to ArrayRef and
2084 HashRef for containers (sartak)
2085 - added tests for this
2087 * Moose::Meta::TypeCoercion
2088 - coercions will now create subtypes as needed
2089 so you can now add coercions to parameterized
2090 types without having to explictly define them
2091 - added tests for this
2093 * Moose::Meta::Method::Accessor
2094 - allow subclasses to decide whether we need
2095 to copy the value into a new variable (sartak)
2097 0.32 Tues. Dec. 4, 2007
2098 * Moose::Util::TypeConstraints
2099 - fixing how subtype aliases of unions work
2100 they should inherit the parent's coercion
2101 - added tests for this
2102 - you can now define multiple coercions on
2103 a single type at different times instead of
2104 having to do it all in one place
2105 - added tests for this
2107 * Moose::Meta::TypeConstraint
2108 - there is now a default constraint of sub { 1 }
2109 instead of Moose::Util::TypeConstraints setting
2112 * Moose::Meta::TypeCoercion
2113 * Moose::Meta::TypeCoercion::Union
2114 - added the &has_coercion_for_type and
2115 &add_type_coercions methods to support the
2116 new features above (although you cannot add
2117 more type coercions for Union types)
2119 0.31 Mon. Nov. 26, 2007
2120 * Moose::Meta::Attribute
2121 - made the +attr syntax handle extending types with
2122 parameters. So "has '+foo' => (isa => 'ArrayRef[Int]')"
2123 now works if the original foo is an ArrayRef.
2124 - added tests for this.
2125 - delegation now works even if the attribute does not
2126 have a reader method using the get_read_method_ref
2127 method from Class::MOP::Attribute.
2128 - added tests for this
2129 - added docs for this
2131 * Moose::Util::TypeConstraints
2132 - passing no "additional attribute info" to
2133 &find_or_create_type_constraint will no longer
2134 attempt to create an __ANON__ type for you,
2135 instead it will just return undef.
2136 - added docs for this
2138 0.30 Fri. Nov. 23, 2007
2139 * Moose::Meta::Method::Constructor
2140 -builder related bug in inlined constructor. (groditi)
2142 * Moose::Meta::Method::Accessor
2143 - genereate unnecessary calls to predicates and refactor
2144 code generation for runtime speed (groditi)
2146 * Moose::Util::TypeConstraints
2147 - fix ClassName constraint to introspect symbol table (mst)
2148 - added more tests for this (mst)
2149 - fixed it so that subtype 'Foo' => as 'HashRef[Int]' ...
2150 with work correctly.
2151 - added tests for this
2154 - adding the link to Recipie 11 (written by Sartak)
2155 - adding test for SYNOPSIS code
2158 - New tests for builder bug. Upon instantiation, if an
2159 attribute had a builder, no value and was not lazy the
2160 builder default was not getting run, oops. (groditi)
2162 0.29 Tues. Nov. 13, 2007
2163 * Moose::Meta::Attribute
2164 - Fix error message on missing builder method (groditi)
2166 * Moose::Meta::Method::Accessor
2167 - Fix error message on missing builder method (groditi)
2170 - Add test to check for the correct error message when
2171 builder method is missing (groditi)
2173 0.28 Tues. Nov. 13, 2007
2174 - 0.27 packaged incorrectly (groditi)
2176 0.27 Tues. Nov. 13, 2007
2177 * Moose::Meta::Attribute
2178 - Added support for the new builder option (groditi)
2179 - Added support for lazy_build option (groditi)
2180 - Changed slot initialization for predicate changes (groditi)
2182 * Moose::Meta::Method::Accessor
2183 - Added support for lazy_build option (groditi)
2184 - Fix inline methods to work with corrected predicate
2187 * Moose::Meta::Method::Constructor
2188 - Added support for lazy_build option (groditi)
2191 - tests for builder and lazy_build (groditi)
2193 * fixing some misc. bits in the docs that
2194 got mentioned on CPAN Forum & perlmonks
2197 - fixed how required methods are handled
2198 when they encounter overriden or modified
2199 methods from a class (thanks to confound).
2200 - added tests for this
2202 * Moose::Util::TypeConstraint
2203 - fixed the type notation parser so that
2204 the | always creates a union and so is
2205 no longer a valid type char (thanks to
2206 konobi, mugwump and #moose for working
2208 - added more tests for this
2210 0.26 Thurs. Sept. 27, 2007
2213 * Parameterized Types
2214 We now support parameterized collection types, such as:
2215 ArrayRef[Int] # array or integers
2216 HashRef[Object] # a hash with object values
2217 They can also be nested:
2218 ArrayRef[HashRef[RegexpRef]] # an array of hashes with regex values
2219 And work with the type unions as well:
2220 ArrayRef[Int | Str] # array of integers of strings
2222 * Better Framework Extendability
2223 Moose.pm is now "extendable" such that it is now much
2224 easier to extend the framework and add your own keywords
2225 and customizations. See the "EXTENDING AND EMBEDDING MOOSE"
2226 section of the Moose.pm docs.
2229 In an effort to begin documenting some of the various
2230 details of Moose as well as some common idioms, we have
2231 created Moose::Cookbook::Snacks as a place to find
2232 small (easily digestable) nuggets of Moose code.
2235 ~ Several doc updates/cleanup thanks to castaway ~
2237 - converted build system to use Module::Install instead of
2238 Module::Build (thanks to jrockway)
2241 - added all the meta classes to the immutable list and
2242 set it to inline the accessors
2243 - fix import to allow Sub::Exporter like { into => }
2244 and { into_level => } (perigrin)
2245 - exposed and documented init_meta() to allow better
2246 embedding and extending of Moose (perigrin)
2249 - complete re-organization of the test suite
2250 - added some new tests as well
2251 - finally re-enabled the Moose::POOP test since
2252 the new version of DBM::Deep now works again
2255 * Moose::Meta::Class
2256 - fixed very odd and very nasty recursion bug with
2258 - added tests for this (eilara)
2260 * Moose::Meta::Attribute
2261 Moose::Meta::Method::Constructor
2262 Moose::Meta::Method::Accessor
2263 - fixed issue with overload::Overloaded getting called
2264 on non-blessed items. (RT #29269)
2265 - added tests for this
2267 * Moose::Meta::Method::Accessor
2268 - fixed issue with generated accessor code making
2269 assumptions about hash based classes (thanks to dexter)
2271 * Moose::Coookbook::Snacks
2272 - these are bits of documentation, not quite as big as
2273 Recipes but which have no clear place in the module docs.
2274 So they are Snacks! (horray for castaway++)
2276 * Moose::Cookbook::Recipe4
2277 - updated it to use the new ArrayRef[MyType] construct
2278 - updated the accompanying test as well
2280 +++ Major Refactor of the Type Constraint system +++
2281 +++ with new features added as well +++
2283 * Moose::Util::TypeConstraint
2284 - no longer uses package variable to keep track of
2285 the type constraints, now uses the an instance of
2286 Moose::Meta::TypeConstraint::Registry to do it
2287 - added more sophisticated type notation parsing
2289 - added tests for this
2291 * Moose::Meta::TypeConstraint
2292 - some minor adjustments to make subclassing easier
2293 - added the package_defined_in attribute so that we
2294 can track where the type constraints are created
2296 * Moose::Meta::TypeConstraint::Union
2297 - this is now been refactored to be a subclass of
2298 Moose::Meta::TypeConstraint
2300 * Moose::Meta::TypeCoercion::Union
2301 - this has been added to service the newly refactored
2302 Moose::Meta::TypeConstraint::Union and is itself
2303 a subclass of Moose::Meta::TypeCoercion
2305 * Moose::Meta::TypeConstraint::Parameterized
2306 - added this module (taken from MooseX::AttributeHelpers)
2307 to help construct nested collection types
2308 - added tests for this
2310 * Moose::Meta::TypeConstraint::Registry
2311 - added this class to keep track of type constraints
2313 0.25 Mon. Aug. 13, 2007
2315 - Documentation update to reference Moose::Util::TypeConstraints
2316 under 'isa' in 'has' for how to define a new type
2317 (thanks to shlomif).
2319 * Moose::Meta::Attribute
2320 - required attributes now will no longer accept undef
2321 from the constructor, even if there is a default and lazy
2322 - added tests for this
2323 - default subroutines must return a value which passes the
2325 - added tests for this
2327 * Moose::Meta::Attribute
2328 * Moose::Meta::Method::Constructor
2329 * Moose::Meta::Method::Accessor
2330 - type-constraint tests now handle overloaded objects correctly
2331 in the error message
2332 - added tests for this (thanks to EvanCarroll)
2334 * Moose::Meta::TypeConstraint::Union
2335 - added (has_)hand_optimized_constraint to this class so that
2336 it behaves as the regular Moose::Meta::TypeConstraint does.
2339 - large refactoring of this code
2340 - added several more tests
2341 - tests for subtle conflict resolition issues
2342 added, but not currently running
2345 * Moose::Cookbook::Recipe7
2346 - added new recipe for augment/inner functionality
2348 - added test for this
2351 - a formal definition of roles (still in progress)
2354 - utilities for easier working with Moose classes
2355 - added tests for these
2358 - This contains Moose specific test functions
2359 - added tests for these
2361 0.24 Tues. July 3, 2007
2362 ~ Some doc updates/cleanup ~
2364 * Moose::Meta::Attribute
2365 - added support for roles to be given as parameters
2366 to the 'handles' option.
2367 - added tests and docs for this
2368 - the has '+foo' attribute form now accepts changes to
2369 the lazy option, and the addition of a handles option
2370 (but not changing the handles option)
2371 - added tests and docs for this
2374 - required methods are now fetched using find_method_by_name
2375 so that required methods can come from superclasses
2376 - adjusted tests for this
2378 0.23 Mon. June 18, 2007
2379 * Moose::Meta::Method::Constructor
2380 - fix inlined constructor for hierarchy with multiple BUILD methods (mst)
2381 * Moose::Meta::Class
2382 - Modify make_immutable to work with the new Class::MOP immutable
2383 mechanism + POD + very basic test (groditi)
2384 * Moose::Meta::Attribute
2385 - Fix handles to use goto() so that caller() comes out properly on
2386 the other side (perigrin)
2388 0.22 Thurs. May 31, 2007
2389 * Moose::Util::TypeConstraints
2390 - fix for prototype undeclared issue when Moose::Util::TypeConstraints
2391 loaded before consumers (e.g. Moose::Meta::Attribute) by predeclaring
2392 prototypes for functions
2393 - added the ClassName type constraint, this checks for strings
2394 which will respond true to ->isa(UNIVERSAL).
2395 - added tests and docs for this
2396 - subtyping just in name now works correctly by making the
2397 default for where be { 1 }
2398 - added test for this
2400 * Moose::Meta::Method::Accessor
2401 - coerce and lazy now work together correctly, thanks to
2402 merlyn for finding this bug
2403 - tests added for this
2404 - fix reader presedence bug in Moose::Meta::Attribute + tests
2407 - Foo->new(undef) now gets ignored, it is assumed you meant to pass
2408 a HASH-ref and missed. This produces better error messages then
2409 having it die cause undef is not a HASH.
2410 - added tests for this
2412 0.21 Thursday, May 2nd, 2007
2414 - added SUPER_SLOT and INNER_SLOT class hashes to support unimport
2415 - modified unimport to remove super and inner along with the rest
2416 - altered unimport tests to handle this
2419 - altered super export to populate SUPER_SLOT
2421 * Moose::Meta::Class
2422 - altered augment and override modifier application to use *_SLOT
2423 - modified tests for these to unimport one test class each to test
2426 - fixed issue where custom attribute metaclasses
2427 where not handled correctly in roles
2428 - added tests for this
2430 * Moose::Meta::Class
2431 - fixed issue where extending metaclasses with
2432 roles would blow up. Thanks to Aankhen`` for
2433 finding this insidious error, and it's solution.
2435 ~~ lots of spelling and grammer fixes in the docs,
2436 many many thanks to rlb3 and Aankhen for these :)
2438 0.20 Friday, April 6th, 2007
2439 >> I messed up the SKIP logic in one test
2440 so this release is just to fix that.
2443 - 'has' now also accepts an ARRAY ref
2444 to create multiple attrs (see docs)
2445 (thanks to konobi for this)
2446 - added tests and docs
2448 0.19 Thurs. April 5th, 2007
2449 ~~ More documentation updates ~~
2451 * Moose::Util::TypeConstraints
2452 - 'type' now supports messages as well
2453 thanks to phaylon for finding this
2454 - added tests for this
2455 - added &list_all_type_constraints and
2456 &list_all_builtin_type_constraints
2457 functions to facilitate introspection.
2459 * Moose::Meta::Attribute
2460 - fixed regexp 'handles' declarations
2461 to build the list of delegated methods
2462 correctly (and not override important
2463 things like &new) thanks to ashleyb
2465 - added tests and docs for this
2466 - added the 'documentation' attributes
2467 so that you can actually document your
2468 attributes and inspect them through the
2470 - added tests and docs for this
2472 * Moose::Meta::Class
2473 - when loading custom attribute metaclasses
2474 it will first look in for the class in the
2475 Moose::Meta::Attribute::Custom::$name, and
2476 then default to just loading $name.
2477 - added tests and docs for this
2479 * Moose::Meta::TypeConstraint
2480 - type constraints now stringify to their names.
2481 - added test for this
2484 - added tests to assure we work with Module::Refresh
2485 - added stricter test skip logic in the Moose POOP
2486 test, ask Rob Kinyon why.
2487 - *cough* DBM::Deep 1.0 backwards compatibility sucks *cough* ;)
2489 0.18 Sat. March 10, 2007
2490 ~~ Many, many documentation updates ~~
2493 - We now use Class::MOP::load_class to
2495 - added tests to show types and subtypes
2496 working with Declare::Constraints::Simple
2497 and Test::Deep as constraint engines.
2500 !! You must have Class::MOP 0.37_001 !!
2501 !! for this developer release to work !!
2503 This release was primarily adding the immutable
2504 feature to Moose. An immutable class is one which
2505 you promise not to alter. When you set the class
2506 as immutable it will perform various bits of
2507 memoization and inline certain part of the code
2508 (constructors, destructors and accessors). This
2509 minimizes (and in some cases totally eliminates)
2510 one of Moose's biggest performance hits. This
2511 feature is not on by default, and is 100% optional.
2512 It has several configurable bits as well, so you
2513 can pick and choose to your specific needs.
2515 The changes involved in this were fairly wide and
2516 highly specific, but 100% backwards compatible, so
2517 I am not going to enumerate them here. If you are
2518 truely interested in what was changed, please do
2521 0.17 Tues. Nov. 14, 2006
2522 * Moose::Meta::Method::Accessor
2523 - bugfix for read-only accessors which
2524 are have a type constraint and lazy.
2525 Thanks to chansen for finding it.
2527 0.16 Tues. Nov. 14, 2006
2529 There are some speed improvements in this release,
2530 but they are only the begining, so stay tuned.
2533 - BUILDALL and DEMOLISHALL no longer get
2534 called unless they actually need to be.
2535 This gave us a signifigant speed boost
2536 for the cases when there is no BUILD or
2537 DEMOLISH method present.
2539 * Moose::Util::TypeConstraints
2540 * Moose::Meta::TypeConstraint
2541 - added an 'optimize_as' option to the
2542 type constraint, which allows for a
2543 hand optimized version of the type
2544 constraint to be used when possible.
2545 - Any internally created type constraints
2546 now provide an optimized version as well.
2548 0.15 Sun. Nov. 5, 2006
2550 This version of Moose *must* have Class::MOP 0.36 in order
2551 to work correctly. A number of small internal tweaks have
2552 been made in order to be compatible with that release.
2554 * Moose::Util::TypeConstraints
2555 - added &unimport so that you can clean out
2556 your class namespace of these exported
2559 * Moose::Meta::Class
2560 - fixed minor issue which occasionally
2561 comes up during global destruction
2563 - moved Moose::Meta::Method::Overriden into
2567 - moved Moose::Meta::Role::Method into
2570 * Moose::Meta::Attribute
2571 - changed how we do type checks so that
2572 we reduce the overall cost, but still
2575 - moved accessor generation methods to
2576 Moose::Meta::Method::Accessor to
2577 conform to the API changes from
2580 * Moose::Meta::TypeConstraint
2581 - changed how constraints are compiled
2582 so that we do less recursion and more
2583 iteration. This makes the type check
2585 - moved Moose::Meta::TypeConstraint::Union
2588 * Moose::Meta::Method::Accessor
2589 - created this from methods formerly found in
2590 Moose::Meta::Attribute
2592 * Moose::Meta::Role::Method
2593 - moved this from Moose::Meta::Role
2595 * Moose::Meta::Method::Overriden
2596 - moved this from Moose::Meta::Class
2598 * Moose::Meta::TypeConstraint::Union
2599 - moved this from Moose::Meta::TypeConstraint
2601 0.14 Mon. Oct. 9, 2006
2603 * Moose::Meta::Attribute
2604 - fixed lazy attributes which were not getting
2605 checked with the type constraint (thanks ashley)
2606 - added tests for this
2607 - removed the over-enthusiastic DWIMery of the
2608 automatic ArrayRef and HashRef defaults, it
2609 broke predicates in an ugly way.
2610 - removed tests for this
2612 0.13 Sat. Sept. 30, 2006
2614 This version of Moose *must* have Class::MOP 0.35 in order
2615 to work correctly. A number of small internal tweaks have
2616 been made in order to be compatible with that release.
2619 - Removed the use of UNIVERSAL::require to be a better
2620 symbol table citizen and remove a dependency
2621 (thanks Adam Kennedy)
2623 **~~ removed experimental & undocumented feature ~~**
2624 - commented out the 'method' and 'self' keywords, see the
2625 comments for more info.
2628 - added a FAQ and WTF files to document frequently
2629 asked questions and common problems
2631 * Moose::Util::TypeConstraints
2632 - added GlobRef and FileHandle type constraint
2633 - added tests for this
2635 * Moose::Meta::Attribute
2636 - if your attribute 'isa' ArrayRef of HashRef, and you have
2637 not explicitly set a default, then make the default DWIM.
2638 This will also work for subtypes of ArrayRef and HashRef
2640 - you can now auto-deref subtypes of ArrayRef or HashRef too.
2641 - new test added for this (thanks to ashley)
2644 - added basic support for runtime role composition
2645 but this is still *highly experimental*, so feedback
2646 is much appreciated :)
2647 - added tests for this
2649 * Moose::Meta::TypeConstraint
2650 - the type constraint now handles the coercion process
2651 through delegation, this is to support the coercion
2654 * Moose::Meta::TypeConstraint::Union
2655 - it is now possible for coercions to be performed
2657 - added tests for this (thanks to konobi)
2659 * Moose::Meta::TypeCoercion
2660 - properly capturing error when type constraint
2664 - Scalar::Util 1.18 is bad on Win32, so temporarily
2665 only require version 1.17 for Win32 and cygwin.
2666 (thanks Adam Kennedy)
2668 0.12 Sat. Sept. 1, 2006
2670 - Recipe5 (subtypes & coercion) has been written
2673 - fixed "bad meta" error message to be more descriptive
2674 - fixed &unimport to not remove the &inner and &super
2675 keywords because we need to localize them.
2676 - fixed number of spelling/grammer issues, thanks Theory :)
2678 **~~ experimental & undocumented feature ~~**
2679 - added the method and self keywords, they are basically
2680 just sugar, and they may not stay around.
2683 - added &dump method to easily Data::Dumper
2686 * Moose::Meta::TypeConstraint
2687 - added the &is_a_type_of method to check both the current
2688 and the subtype of a method (similar to &isa with classes)
2691 - this is now a subclass of Class::MOP::Module, and no longer
2692 creates the _role_meta ugliness of before.
2693 - fixed tests to reflect this change
2695 0.11 Wed. July 12, 2006
2697 - added an &unimport method to remove all the keywords
2698 that Moose will import, simply add 'no Moose' to the
2699 bottom of your class file.
2702 - fixed some test failures caused by a forgotten test
2705 0.10 Thurs. July 6, 2006
2707 - improved error message when loading modules so
2708 it is less confusing when you load a role.
2709 - added &calculate_all_roles method to
2710 Moose::Meta::Class and Moose::Meta::Role
2713 This module has been tested against Class::MOP 0.30
2714 but it does not yet utilize the optimizations
2715 it makes available. Stay tuned for that ;)
2717 0.09_03 Fri. June 23, 2006
2718 ++ DEVELOPER RELEASE ++
2720 - 'use strict' and 'use warnings' are no longer
2721 needed in Moose classes, Moose itself will
2722 turn them on for you.
2723 - added tests for this
2724 - moved code from exported subs to private methods
2725 in Moose::Meta::Class
2728 - as with Moose, strict and warnings are
2729 automatically turned on for you.
2730 - added tests for this
2733 - now handles an edge case for override errors
2734 - added tests for this
2735 - added some more edge case tests
2737 0.09_02 Tues. May 16, 2006
2738 ++ DEVELOPER RELEASE ++
2740 - added prototypes to the exported subs
2744 - added prototypes to the exported subs
2747 * Moose::Util::TypeConstraints
2748 - cleaned up prototypes for the subs
2751 0.09_01 Fri. May 12, 2006
2752 ++ DEVELOPER RELEASE ++
2753 - This release works in combination with
2754 Class::MOP 0.29_01, it is a developer
2755 release because it uses the a new
2756 instance sub-protocol and a fairly
2757 complete Role implementation. It has
2758 not yet been optimized, so it slower
2759 the the previous CPAN version. This
2760 release also lacks good updated docs,
2761 the official release will have updated docs.
2764 - refactored the keyword exports
2765 - 'with' now checks Role validaity and
2766 accepts more than one Role at a time
2767 - 'extends' makes metaclass adjustments as
2768 needed to ensure metaclass compatibility
2771 - refactored the keyword exports
2772 - 'with' now checks Role validaity and
2773 accepts more than one Role at a time
2775 * Moose::Util::TypeConstraints
2776 - added the 'enum' keyword for simple
2777 string enumerations which can be used as
2779 - see example of usage in t/202_example.t
2782 - more careful checking of params to new()
2785 - much work done on the role composition
2786 - many new tests for conflict detection
2787 and composition edge cases
2788 - not enough documentation, I suggest
2789 looking at the tests
2791 * Moose::Meta::Instance
2792 - added new Instance metaclass to support
2793 the new Class::MOP instance protocol
2795 * Moose::Meta::Class
2796 - some small changes to support the new
2798 - some small additions to support Roles
2800 * Moose::Meta::Attribute
2801 - some improvements to the accessor generation code
2803 - some small changes to support the new
2805 - (still somewhat) experimental delegation support
2806 with the 'handles' option
2807 - added several tests for this
2808 - no docs for this yet
2810 0.05 Thurs. April 27, 2006
2812 - keywords are now exported with Sub::Exporter
2813 thanks to chansen for this commit
2814 - has keyword now takes a 'metaclass' option
2815 to support custom attribute meta-classes
2816 on a per-attribute basis
2817 - added tests for this
2818 - the 'has' keyword not accepts inherited slot
2819 specifications (has '+foo'). This is still an
2820 experimental feature and probably not finished
2821 see t/038_attribute_inherited_slot_specs.t for
2822 more details, or ask about it on #moose
2823 - added tests for this
2826 - keywords are now exported with Sub::Exporter
2828 * Moose::Utils::TypeConstraints
2829 - reorganized the type constraint hierarchy, thanks
2830 to nothingmuch and chansen for his help and advice
2832 - added some tests for this
2833 - keywords are now exported with Sub::Exporter
2834 thanks to chansen for this commit
2836 * Moose::Meta::Class
2837 - due to changes in Class::MOP, we had to change
2838 construct_instance (for the better)
2840 * Moose::Meta::Attribute
2841 - due to changes in Class::MOP, we had to add the
2842 initialize_instance_slot method (it's a good thing)
2844 * Moose::Meta::TypeConstraint
2845 - added type constraint unions
2846 - added tests for this
2847 - added the is_subtype_of predicate method
2848 - added tests for this
2850 0.04 Sun. April 16th, 2006
2852 - Roles can now consume other roles
2853 - added tests for this
2854 - Roles can specify required methods now with
2855 the requires() keyword
2856 - added tests for this
2859 - ripped out much of it's guts ,.. much cleaner now
2860 - added required methods and correct handling of
2861 them in apply() for both classes and roles
2862 - added tests for this
2863 - no longer adds a does() method to consuming classes
2864 it relys on the one in Moose::Object
2865 - added roles attribute and some methods to support
2866 roles consuming roles
2868 * Moose::Meta::Attribute
2869 - added support for triggers on attributes
2870 - added tests for this
2871 - added support for does option on an attribute
2872 - added tests for this
2874 * Moose::Meta::Class
2875 - added support for attribute triggers in the
2877 - added tests for this
2880 - Moose no longer creates a subtype for your class
2881 if a subtype of the same name already exists, this
2882 should DWIM in 99.9999% of all cases
2884 * Moose::Util::TypeConstraints
2885 - fixed bug where incorrect subtype conflicts were
2887 - added test for this
2890 - this class can now be extended with 'use base' if
2891 you need it, it properly loads the metaclass class now
2892 - added test for this
2894 0.03_02 Wed. April 12, 2006
2896 - you must now explictly use Moose::Util::TypeConstraints
2897 it no longer gets exported for you automatically
2900 - new() now accepts hash-refs as well as key/value lists
2901 - added does() method to check for Roles
2902 - added tests for this
2904 * Moose::Meta::Class
2905 - added roles attribute along with the add_role() and
2907 - added tests for this
2910 - now adds a does() method to consuming classes
2911 which tests the class's hierarchy for roles
2912 - added tests for this
2914 0.03_01 Mon. April 10, 2006
2916 - added new Role recipe (no content yet, only code)
2919 - added 'with' keyword for Role support
2920 - added test and docs for this
2921 - fixed subtype quoting bug
2922 - added test for this
2926 - added test and docs
2928 * Moose::Util::TypeConstraints
2929 - added the message keyword to add custom
2930 error messages to type constraints
2933 - the meta role to support Moose::Role
2934 - added tests and docs
2936 * Moose::Meta::Class
2937 - moved a number of things from Moose.pm
2938 to here, they should have been here
2941 * Moose::Meta::Attribute
2942 - moved the attribute option macros here
2943 instead of putting them in Moose.pm
2945 * Moose::Meta::TypeConstraint
2946 - added the message attributes and the
2948 - added tests and docs for this
2950 0.03 Thurs. March 30, 2006
2952 - added the Moose::Cookbook with 5 recipes,
2953 describing all the stuff Moose can do.
2956 - fixed an issue with &extends super class loading
2957 it now captures errors and deals with inline
2958 packages correctly (bug found by mst, solution
2960 - added super/override & inner/augment features
2961 - added tests and docs for these
2964 - BUILDALL now takes a reference of the %params
2965 that are passed to &new, and passes that to
2968 * Moose::Util::TypeConstraints
2969 - Type constraints now survive runtime reloading
2970 - added test for this
2972 * Moose::Meta::Class
2973 - fixed the way attribute defaults are handled
2974 during instance construction (bug found by chansen)
2976 * Moose::Meta::Attribute
2977 - read-only attributes now actually enforce their
2978 read-only-ness (this corrected in Class::MOP as
2981 0.02 Tues. March 21, 2006
2983 - many more tests, fixing some bugs and
2985 - &extends now loads the base module with
2987 - added UNIVERSAL::require to the
2990 - each new Moose class will also create
2991 and register a subtype of Object which
2992 correspond to the new Moose class.
2993 - the 'isa' option in &has now only
2994 accepts strings, and will DWIM in
2997 * Moose::Util::TypeConstraints
2998 - added type coercion features
2999 - added tests for this
3000 - added support for this in attributes
3001 and instance construction
3003 - type construction no longer creates a
3004 function, it registers the type instead.
3005 - added several functions to get the
3009 - BUILDALL and DEMOLISHALL were broken
3010 because of a mis-named hash key, Whoops :)
3012 * Moose::Meta::Attribute
3013 - adding support for coercion in the
3014 autogenerated accessors
3016 * Moose::Meta::Class
3017 - adding support for coercion in the
3018 instance construction
3020 * Moose::Meta::TypeConstraint
3021 * Moose::Meta::TypeCoercion
3022 - type constraints and coercions are now
3023 full fledges meta-objects
3025 0.01 Wed. March 15, 2006
3026 - Moooooooooooooooooose!!!