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 * DEMOLISH methods in mutable subclasses of immutable classes are now called
14 properly (Chia-liang Kao, Jesse Luehrs)
18 * Added Moose::Manual::Support that defines the support, compatiblity, and
19 release policies for Moose. (Chris Prather)
21 0.98 Wed, Feb 10, 2010
25 * An internals change in 0.97 broke role application to an instance in some
26 cases. The bug occurred when two different roles were applied to different
27 instances of the same class. (Rafael Kitover)
34 * Calling ->reinitialize on a cached anonymous class effectively uncached
35 the metaclass object, causing the metaclass to go out of scope
36 unexpectedly. This could easily happen at a distance by applying a
37 metarole to an anonymous class. (Dave Rolsky).
43 * ScalarRef is now a parameterized type. You can now specify a type
44 constraint for whatever the reference points to. (Closes RT#50857)
45 (Michael G. Schwern, Florian Ragwitz)
49 * ScalarRef now accepts references to other references. (Closes RT#50934)
56 * Moose::Meta::Attribute::Native::Trait::Code now provides execute_method as
57 a delegation option. This allows the code reference to be called as a
58 method on the object. (Florian Ragwitz)
62 * Moose::Object::does no longer checks the entire inheritance tree, since
63 Moose::Meta::Class::does_role already does this. (doy)
65 * Moose::Util::add_method_modifier (and subsequently the sugar functions
66 Moose::before, Moose::after, and Moose::around) can now accept arrayrefs,
67 with the same behavior as lists. Types other than arrayref and regexp
68 result in an error. (Dylan Hardison)
70 0.94 Mon, Jan 18, 2010
74 * Please see the changes listed for 0.93_01 and Moose::Manual::Delta.
78 * Improved support for anonymous roles by changing various APIs to take
79 Moose::Meta::Role objects as well as role names. This included
81 - Moose::Meta::Class->does_role
82 - Moose::Meta::Role->does_role
83 - Moose::Util::does_role
84 - Moose::Util::apply_all_roles
85 - Moose::Util::ensure_all_roles
86 - Moose::Util::search_class_by_role
88 Requested by Shawn Moore. Addresses RT #51143 (and then some). (Dave Rolsky)
92 * Fix handling of non-alphanumeric attributes names like '@foo'. This should
93 work as long as the accessor method names are explicitly set to valid Perl
94 method names. Reported by Doug Treder. RT #53731. (Dave Rolsky)
97 0.93_03 Tue, Jan 5, 2010
101 * Portability fixes to our XS code so we compile with 5.8.8 and Visual
102 C++. Fixes RT #53391. Reported by Taro Nishino. (rafl)
105 0.93_02 Tue, Jan 5, 2010
109 * Depend on Class::MOP 0.97_01 so we can get useful results from CPAN
110 testers. (Dave Rolsky)
113 0.93_01 Mon, Jan 4, 2010
117 See Moose::Manual::Delta for more details on backwards compatiblity issues.
119 * Role attributes are now objects of the Moose::Meta::Role::Attribute
120 class. (Dave Rolsky).
122 * There were major changes to how metaroles are applied. We now distinguish
123 between metaroles for classes vs those for roles. See the
124 Moose::Util::MetaRole docs for details. (Dave Rolsky)
126 * The old MetaRole API has been deprecated, but will continue to
127 work. However, if you are applying an attribute metaclass role, this may
128 break because of the fact that roles now have an attribute metaclass
131 * Moose::Util::MetaRole::apply_metaclass_roles is now called
132 apply_metaroles. The old name is deprecated. Dave Rolsky>
134 * The unimport subs created by Moose::Exporter now clean up re-exported
135 functions like blessed and confess, unless the caller imported them from
136 somewhere else too. See Moose::Manua::Delta for backcompat details. (rafl)
138 [ENHANCEMENTS AND BUG FIXES]
140 * Changed the Str constraint to accept magic lvalue strings like one gets from
141 substr et al, again. (sorear)
143 * Sped up the type constraint parsing regex. (Sam Vilain)
145 * The Moose::Cookbook::Extending::Recipe2 recipe was broken. Fix suggested by
148 * Added Moose::Util::TypeConstraints exports when using oose.pm to allow
149 easier testing of TypeConstraints from the command line. (perigrin)
151 * Added a with_immutable test function to Test::Moose, to run a block of tests
152 with and without certain classes being immutable. (doy)
154 * We now use Module::Install extensions explicitly to avoid confusing errors
155 if they're not installed. We use Module::Install::AuthorRequires to stop
156 test extraction and general failures if you don't have the author side
157 dependencies installed.
159 * Fixed a grammar error in Moose::Cookbook::Basics::Recipe4. rt.cpan.org
160 #51791. (Amir E. Aharoni)
163 0.93 Thu, Nov 19, 2009
165 - Calling $object->new() is no longer deprecated, and no longer
169 - The get_attribute_map method is now deprecated. (Dave Rolsky)
171 * Moose::Meta::Method::Delegation
172 - Preserve variable aliasing in @_ for delegated methods, so that
173 altering @_ affects the passed value. (doy)
175 * Moose::Util::TypeConstraints
176 - Allow array refs for non-anonymous form of enum and duck_type, not
177 just anonymous. The non-arrayref forms may be removed in the
179 - Changed Str constraint to not accept globs (*STDIN or *FOO). (chansen)
180 - Properly document Int being a subtype of Str. (doy)
183 - Moose::Exporter using modules can now export their functions to the
184 main package. This applied to Moose and Moose::Role, among
185 others. (nothingmuch)
187 * Moose::Meta::Attribute
188 - Don't remove attribute accessors we never installed, during
189 remove_accessors. (doy)
191 * Moose::Meta::Attribute::Native::Trait::Array
192 - Don't bypass prototype checking when calling List::Util::first, to
193 avoid a segfault when it is called with a non-code argument. (doy)
195 * Moose::Meta::Attribute::Native::Trait::Code
196 - Fix passing arguments to code execute helpers. (doy)
198 0.92 Tue, Sep 22, 2009
199 * Moose::Util::TypeConstraints
200 - added the match_on_type operator (Stevan)
201 - added tests and docs for this (Stevan)
204 - Metaclass compat fixing should already happen recursively, there's no
205 need to explicitly walk up the inheritance tree. (doy)
207 * Moose::Meta::Attribute
208 - Add tests for set_raw_value and get_raw_value. (nothingmuch)
210 0.91 Thu, Sep 17, 2009
212 - Don't import any functions, in order to avoid polluting our namespace
213 with things that can look like methods (blessed, try, etc)
216 * Moose::Meta::Method::Constructor
217 - The generated code needs to called Scalar::Util::blessed by its
218 fully-qualified name or else Perl can interpret the call to blessed as
219 an indirect method call. This broke Search::GIN, which in turn broke
220 KiokuDB. (nothingmuch)
222 0.90 Tue, Sep 15, 2009
223 * Moose::Meta::Attribute::Native::Trait::Counter
224 * Moose::Meta::Attribute::Native::Trait::String
225 - For these two traits, an attribute which did not explicitly provide
226 methods to handles magically ended up delegating *all* the helper
227 methods. This has been removed. You must be explicit in your handles
228 declaration for all Native Traits. (Dave Rolsky)
231 - DEMOLISHALL behavior has changed. If any DEMOLISH method dies, we make
232 sure to rethrow its error message. However, we also localize $@ before
233 this so that if all the DEMOLISH methods success, the value of $@ will
234 be preserved. (nothingmuch and Dave Rolsky)
235 - We now also localize $? during object destruction. (nothingmuch and
237 - The handling of DEMOLISH methods was broken for immutablized classes,
238 which were not receiving the value of
239 Devel::GlobalDestruction::in_global_destruction.
240 - These two fixes address some of RT #48271, reported by Zefram.
241 - This is all now documented in Moose::Manual::Construction.
242 - Calling $object->new() is now deprecated. A warning will be
246 - Added more hooks to customize how roles are applied. The role
247 summation class, used to create composite roles, can now be changed
248 and/or have meta-roles applied to it. (rafl)
249 - The get_method_list method no longer explicitly excludes the "meta"
250 method. This was a hack that has been replaced by better hacks. (Dave
253 * Moose::Meta::Method::Delegation
254 - fixed delegated methods to make sure that any modifiers attached to
255 the accessor being delegated on will be called (Stevan)
256 - added tests for this (Stevan)
259 - Moose no longer warns when a class that is being made immutable has
260 mutable ancestors. While in theory this is a good thing to warn about,
261 we found so many exceptions to this that doing this properly became
264 0.89_02 Thu, Sep 10, 2009
265 * Moose::Meta::Attribute::Native
266 - Fix Hash, which still had 'empty' instead of 'is_empty'. (hdp)
268 * Moose::Meta::Attribute::Native::Trait::Array
269 - Added a number of functions from List::Util and List::MoreUtils,
270 including reduce, shuffle, uniq, and natatime. (doy)
273 - This module will now generate an init_meta method for your exporting
274 class if you pass it options for
275 Moose::Util::MetaRole::apply_metaclass_roles or
276 apply_base_class_roles. This eliminates a lot of repetitive
277 boilerplate for typical MooseX modules. (doy).
278 - Documented the with_meta feature, which is a replacement for
279 with_caller. This feature was added by josh a while ago.
280 - The with_caller feature is now deprecated, but will not issue a
281 warning yet. (Dave Rolsky)
282 - If you try to wrap/export a subroutine which doesn't actually exist,
283 Moose::Exporter will warn you about this. (doy)
285 * Moose::Meta::Role::Application::ToRole
286 - When a role aliased a method from another role, it was only getting
287 the new (aliased) name, not the original name. This differed from what
288 happens when a class aliases a role's methods. If you _only_ want the
289 aliased name, make sure to also exclue the original name. (Dave
292 0.89_01 Wed Sep 2, 2009
293 * Moose::Meta::Attribute
294 - Added the currying syntax for delegation from AttributeHelpers to the
295 existing delegation API. (hdp)
297 * Moose::Meta::Attribute::Native
298 - We have merged the functionality of MooseX::AttributeHelpers into the
299 Moose core with some API tweaks. You can continue to use
300 MooseX::AttributeHelpers, but it will not be maintained except
301 (perhaps) for critical bug fixes in the future. See
302 Moose::Manual::Delta for details. (hdp, jhannah, rbuels, Sartak,
305 * Moose::Error::Croak
306 * Moose::Error::Confess
307 - Clarify documentation on how to use different error-throwing
308 modules. (Curtis Jewell)
311 - Correct POD for builder to point to Recipe8, not 9. (gphat)
314 - When a nonexistent sub name is passed to as_is, with_caller, or
315 with_meta, throw a warning and skip the exporting, rather than
316 installing a broken sub. (doy)
319 - Moose now warns if you call C<make_immutable> for a class with mutable
322 0.89 Thu Aug 13, 2009
323 * Moose::Manual::Attributes
324 - Clarify "is", include discussion of "bare". (Sartak)
326 * Moose::Meta::Role::Method::Conflicting
327 * Moose::Meta::Role::Application::ToClass
328 - For the first set of roles involved in a conflict, report all
329 unresolved method conflicts, not just the first method. Fixes #47210
330 reported by Ovid. (Sartak)
332 * Moose::Meta::TypeConstraint
333 - Add assert_valid method to use a TypeConstraint for assertion (rjbs)
336 - Make "use Moose -metaclass => 'Foo'" do alias resolution, like -traits
338 - Allow specifying role options (alias, excludes, MXRP stuff) in the
339 arrayref passed to "use Moose -traits" (doy)
342 - Add functions meta_class_alias and meta_attribute_alias for creating
343 aliases for class and attribute metaclasses and metatraits. (doy)
345 * Moose::Meta::Attribute
346 * Moose::Meta::Method::Accessor
347 - A trigger now receives the old value as a second argument, if the
348 attribute had one. (Dave Rolsky)
350 * Moose::Meta::Method::Constructor
351 - Fix a bug with $obj->new when $obj has stringify overloading.
352 Reported by Andrew Suffield [rt.cpan.org #47882] (Sartak)
353 - However, we will probably deprecate $obj->new, so please don't start
354 using it for new code!
356 * Moose::Meta::Role::Application
357 * Moose::Meta::Role::Application::RoleSummation
358 - Rename alias and excludes to -alias and -excludes (but keep the old
359 names for now, for backcompat) (doy)
361 0.88 Fri Jul 24, 2009
362 * Moose::Manual::Contributing
363 - Re-write the Moose::Manual::Contributing document to reflect
364 the new layout and methods of work for the Git repository. All
365 work now should be done in topic branches and reviewed by a
366 core committer before being applied to master. All releases
367 are done by a cabal member and merged from master to
368 stable. This plan was devised by Yuval, blame him. (perigrin)
371 - Create metaclass attributes for the different role application
374 * Moose::Util::MetaRole
375 - Allow applying roles to a meta role's role application
378 * Moose::Meta::Attribute
379 - Add weak_ref to allowed options for "has '+foo'" (mst)
381 * Moose::Meta::Method::Accessor
382 - No longer uses inline_slot_access in accessors, to support
383 non-lvalue-based meta instances. (sorear)
386 * Moose::Meta::Method::Delegation
387 - Once again allow class names as well as objects for
388 delegation. This was changed in 0.86.
391 * Moose::Meta::Class::Immutable::Trait
392 - Fixes to work with the latest Class::MOP.
394 * Moose::Meta::Method::Delegation
395 - Delegation now dies with a more useful error message if the
396 attribute's accessor returns something defined but
399 0.85 Fri, Jun 26, 2009
400 * Moose::Meta::Attribute
401 - The warning for 'no associated methods' is now split out into
402 the _check_associated_methods method, so that extensions can
403 safely call 'after install_accessors => ...'. This fixes a
404 warning from MooseX::AttributeHelpers. (hdp)
406 0.84 Fri, Jun 26, 2009
408 - has now sets definition_context for attributes defined in
411 * Moose::Meta::Attribute
412 - When adding an attribute to a metaclass, if the attribute has
413 no associated methods, it will give a deprecation
415 - Methods generated by delegation were not being added to
416 associated_methods. (hdp)
417 - Attribute accessors (reader, writer, accessor, predicate,
418 clearer) now warn if they overwrite an existing method. (doy)
419 - Attribute constructors now warn very noisily about unknown (or
420 misspelled) arguments
422 * Moose::Util::TypeConstraints
423 - Deprecated the totally useless Role type name, which just
424 checked if $object->can('does'). Note that this is _not_ the
425 same as a type created by calling role_type('RoleName').
427 * Moose::Util::TypeConstraints
428 * Moose::Meta::TypeConstraint::DuckType
429 - Reify duck type from a regular subtype into an actual class
431 - Document this because Sartak did all my work for me
434 * Moose::Meta::Attribute
435 - Allow Moose::Meta::TypeConstraint::DuckType in handles, since
436 it is just a list of methods (Sartak)
439 - The get_*_method_modifiers methods would die if the role had
440 no modifiers of the given type (Robert Buels).
442 0.83 Tue, Jun 23, 2009
444 - Fix _construct_instance not setting the special __MOP__ object
445 key in instances of anon classes. (doy)
447 0.82 Sun, Jun 21, 2009
448 * Moose::Manual::Types
449 - Mention MooseX::Types early to avoid users falling down the
450 string parsing rathole (mst)
452 * Moose::Manual::MooseX
453 - Add warnings about class-level extensions and mention considering
454 using plain objects instead
456 0.81 Sun, Jun 7, 2009
457 * Bumped our Class::MOP prereq to the latest version (0.85), since
460 0.80 Sat, Jun 6, 2009
462 - Add FAQ about the coercion change from 0.76 because it came up
463 three times today (perigrin)
464 - Win doy $10 dollars because Sartak didn't think anybody
465 would document this fast enough (perigrin)
467 * Moose::Meta::Method::Destructor
468 - Inline a DESTROY method even if there are no DEMOLISH methods
469 to prevent unnecessary introspection in
470 Moose::Object::DEMOLISHALL
473 - A role's required methods are now represented by
474 Moose::Meta::Role::Method::Required objects. Conflicts are now
475 represented by Moose::Meta::Role::Method::Conflicting
476 objects. The benefit for end-users in that unresolved
477 conflicts generate different, more instructive, errors,
478 resolving Ovid's #44895. (Sartak)
481 - Improve the error message of "extends" as suggested by Adam
482 Kennedy and confound (Sartak)
483 - Link to Moose::Manual::Roles from Moose::Role as we now have
484 excellent documentation (Adam Kennedy)
487 - Update test suite for subname change in Class::MOP
489 - Add TODO test for infinite recursion in Moose::Meta::Class
492 0.79 Wed, May 13, 2009
494 - More fixes for Win32 problems. Reported by Robert Krimen.
497 - The DEMOLISHALL method could still blow up in some cases
498 during global destruction. This method has been made more
499 resilient in the face of global destruction's random garbage
503 - If you "also" a module that isn't loaded, the error message
504 now acknowledges that (Sartak)
507 - When your ->meta method does not return a Moose::Meta::Class,
508 the error message gave the wrong output (Sartak)
510 0.78 Tue, May 12, 2009
511 * Moose::Cookbook::FAQ and Moose::Cookbook::WTF
512 - Merged these documents into what is now Moose::Manual::FAQ
515 - Moved to Moose::Manual::Unsweetened
517 * Moose::Cookbook::Basics::Recipes 9-12
518 - Renamed to be 8-11, since recipe 8 did not exist
521 - Make Moose::Exporter import strict and warnings into packages
525 - Fix DEMOLISHALL sometimes not being able to find DEMOLISH
526 methods during global destruction (doy)
529 * Moose::Meta::Role::Application::ToClass
530 - Track the Role::Application objects created during class-role
534 - Fix metaclass incompatibility errors when extending a vanilla perl
535 class which isa Moose class with a metaclass role applied (t0m)
538 - Add a role-combination hook, _role_for_combination, for the
539 benefit of MooseX::Role::Parameterized (Sartak)
542 - Some tests were failing on Win32 because they explicit checked
543 warning output for newlines. Reported by Nickolay Platonov.
545 0.77 Sat, May 2, 2009
547 - Add explicit use of Devel::GlobalDestruction and Sub::Name
551 - Pass a boolean to DEMOLISHALL and DEMOLISH indicating whether
552 or not we are currently in global destruction (doy)
553 - Add explicit use of Devel::GlobalDestruction and Sub::Name
556 * Moose::Cookbook::FAQ
557 - Reworked much of the existing content to be more useful to
558 modern Moose hackers (Sartak)
561 - Depend on Class::MOP 0.83 instead of 0.82_01.
563 0.76 Mon, April 27, 2009
564 * Moose::Meta::TypeConstraint
565 - Do not run coercions in coerce() if the value already passes the type
568 * Moose::Meta::TypeConstraint::Class
569 - In validation error messages, specifically say that the value is not
570 an instance of the class. This should alleviate some frustrating
571 forgot-to-load-my-type bugs. rt.cpan.org #44639 (Sartak)
573 * Moose::Meta::Role::Application::ToClass
574 - Revert the class-overrides-role warning in favor of a solution outside
575 of the Moose core (Sartak)
578 - Make Test::Output optional again, since it's only used in a few files
581 0.75_01 Thu, April 23, 2009
582 * Moose::Meta::Role::Application::ToClass
583 - Moose now warns about each class overriding methods from roles it
587 - Warnings tests have standardized on Test::Output which is now an
588 unconditionally dependency (Sartak)
591 - Changes to immutabilization to work with Class::MOP 0.82_01+.
593 0.75 Mon, April 20, 2009
596 - Move validation of not inheriting from roles from Moose::extends to
597 Moose::Meta::Class::superclasses (doy)
600 - add ensure_all_roles() function to encapsulate the common "apply this
601 role unless the object already does it" pattern (hdp)
604 - Users can now select a different metaclass with the "-metaclass"
605 option to import, for classes and roles (Sartak)
608 - Make method_metaclass an attr so that it can accept a metarole
611 0.74 Tue, April 7, 2009
613 * Moose::Meta::Method::Destructor
614 - Include stack traces in the deprecation warnings.
618 - Removed the long-deprecated _apply_all_roles method.
620 * Moose::Meta::TypeConstraint
621 - Removed the long-deprecated union method.
624 0.73_02 Mon, April 6, 2009
625 * More deprecations and renamings
626 - Moose::Meta::Method::Constructor
627 - initialize_body => _initialize_body (this is always called
628 when an object is constructed)
631 - The DEMOLISHALL method could throw an exception during global
632 destruction, meaning that your class's DEMOLISH methods would
633 not be properly called. Reported by t0m.
635 * Moose::Meta::Method::Destructor
636 - Destructor inlining was totally broken by the change to the
637 is_needed method in 0.72_01. Now there is a test for this
638 feature, and it works again.
641 - Bold the word 'not' in the POD for find_meta (t0m)
643 0.73_01 Sun, April 5, 2009
645 - Call user_class->meta in fewer places, with the eventual goal
646 of allowing the user to rename or exclude ->meta
647 altogether. Instead uses Class::MOP::class_of. (Sartak)
649 * Moose::Meta::Method::Accessor
650 - If an attribute had a lazy default, and that value did not
651 pass the attribute's type constraint, it did not get the
652 message from the type constraint, instead using a generic
653 message. Test provided by perigrin.
655 * Moose::Util::TypeConstraints
656 - Add duck_type keyword. It's sugar over making sure an object
657 can() a list of methods. This is easier than jrockway's
658 suggestion to fork all of CPAN. (perigrin)
659 - add tests and documentation (perigrin)
662 - Document the fact that init_meta() returns the target class's
663 metaclass object. (hdp)
665 * Moose::Cookbook::Extending::Recipe1
666 * Moose::Cookbook::Extending::Recipe2
667 * Moose::Cookbook::Extending::Recipe3
668 * Moose::Cookbook::Extending::Recipe4
669 - Make init_meta() examples explicitly return the metaclass and
670 point out this fact. (hdp)
672 * Moose::Cookbook::Basics::Recipe12
673 - A new recipe, creating a custom meta-method class.
675 * Moose::Cookbook::Meta::Recipe6
676 - A new recipe, creating a custom meta-method class.
679 * Moose::Meta::Method::Constructor
680 - Attribute triggers no longer receive the meta-attribute object
681 as an argument in any circumstance. Previously, triggers
682 called during instance construction were passed the
683 meta-attribute, but triggers called by normal accessors were
684 not. Fixes RT#44429, reported by Mark Swayne. (hdp)
686 * Moose::Manual::Attributes
687 - Remove references to triggers receving the meta-attribute object as an
690 * Moose::Cookbook::FAQ
691 - Remove recommendation for deprecated Moose::Policy and
692 Moose::Policy::FollowPBP; recommend MooseX::FollowPBP
695 * Many methods have been renamed with a leading underscore, and a
696 few have been deprecated entirely. The methods with a leading
697 underscore are consider "internals only". People writing
698 subclasses or extensions to Moose should feel free to override
699 them, but they are not for "public" use.
702 - check_metaclass_compatibility => _check_metaclass_compatibility
704 - Moose::Meta::Method::Accessor
705 - initialize_body => _initialize_body (this is always called
706 when an object is constructed)
707 - /(generate_.*_method(?:_inline)?)/ => '_' . $1
709 - Moose::Meta::Method::Constructor
710 - initialize_body => _initialize_body (this is always called
711 when an object is constructed)
712 - /(generate_constructor_method(?:_inline)?)/ => '_' . $1
713 - attributes => _attributes (now inherited from parent)
714 - meta_instance => _meta_instance (now inherited from parent)
717 - alias_method is deprecated. Use add_method
719 0.73 Fri, March 29, 2009
720 * No changes from 0.72_01.
722 0.72_01 Thu, March 26, 2009
724 - Almost every module has complete API documentation. A few
725 methods (and even whole classes) have been intentionally
726 excluded pending some rethinking of their APIs.
728 * Moose::Util::TypeConstraints
729 - Calling subtype with a name as the only argument is now an
730 exception. If you want an anonymous subtype do:
732 my $subtype = subtype as 'Foo';
734 * Moose::Cookbook::Meta::Recipe7
735 - A new recipe, creating a custom meta-instance class.
737 * Moose::Cookbook::Basics::Recipe5
738 - Fix various typos and mistakes. Includes a patch from Radu
741 * Moose::Cookbook::Basics::Recipe9
742 - Link to this recipe from Moose.pm's builder blurb
745 - When wrapping a function with a prototype, Moose::Exporter now
746 makes sure the wrapped function still has the same
747 prototype. (Daisuke Maki)
749 * Moose::Meta::Attribute
750 - Allow a subclass to set lazy_build for an inherited
754 - Explicitly depend on Data::OptList. We already had this dependency
755 via Sub::Exporter, but since we're using it directly we're
756 better off with it listed. (Sartak)
758 * Moose::Meta::Method::Constructor
759 - Make it easier to subclass the inlining behaviour. (Ash
762 * Moose::Manual::Delta
763 - Details significant changes in the history of Moose, along
764 with recommended workarounds.
766 * Moose::Manual::Contributing
767 - Contributor's guide to Moose.
769 * Moose::Meta::Method::Constructor
770 - The long-deprecated intialize_body method has been removed
771 (yes, spelled like that).
773 * Moose::Meta::Method::Destructor
774 - This is_needed method is now always a class method.
777 - Changes to the internals of how make_immutable works to match
778 changes in latest Class::MOP.
780 0.72 Mon, February 23, 2009
782 * Moose::Meta::Method::Constructor
783 - A mutable class accepted Foo->new(undef) without complaint,
784 while an immutable class would blow up with an unhelpful
785 error. Now, in both cases we throw a helpful error
786 instead. Reported by doy.
788 0.71_01 Sun, February 22, 2009
790 - Hopefully fixed some POD errors in a few recipes that caused
791 them to display weird on search.cpan.org.
793 * Moose::Util::TypeConstraints
794 - Calling type or subtype without the sugar helpers (as, where,
795 message) is now deprecated.
796 - The subtype function tried hard to guess what you meant, but
797 often got it wrong. For example:
799 my $subtype = subtype as 'ArrayRef[Object]';
801 This caused an error in the past, but now works as you'd
805 - Make sure Moose.pm is loaded before calling
806 Moose->throw_error. This wasn't normally an issue, but could
807 bite you in weird cases.
809 0.71 Thu, February 19, 2009
810 * Moose::Cookbook::Basics::Recipe11
811 - A new recipe which demonstrates the use of BUILDARGS and
814 * Moose::Cookbook::Roles::Recipe3
815 - A new recipe, applying a role to an object instance. (Dave
819 - Allow overriding specific keywords from "also" packages. (doy)
822 - Replace hardcoded cookbook tests with Test::Inline to ensure
823 the tests match the actual code in the recipes. (Dave Rolsky)
826 - Working on the above turned up a number of little bugs in the
827 recipe code. (Dave Rolsky)
829 * Moose::Util::TypeConstraints::Optimized
830 - Just use Class::MOP for the optimized ClassName check. (Dave
833 0.70 Sat, February 14, 2009
834 * Moose::Util::TypeConstraints
835 - Added the RoleName type (stevan)
836 - added tests for this (stevan)
838 * Moose::Cookbook::Basics::Recipe3
839 - Updated the before qw[left right] sub to be a little more
840 defensive about what it accepts (stevan)
841 - added more tests to t/000_recipies/basics/003_binary_tree.t
845 - We now always call DEMOLISHALL, even if a class does not
846 define DEMOLISH. This makes sure that method modifiers on
847 DEMOLISHALL work as expected. (doy)
848 - added tests for this (EvanCarroll)
850 * Moose::Util::MetaRole
851 - Accept roles for the wrapped_method_metaclass (rafl)
852 - added tests for this (rafl)
854 * Moose::Meta::Attribute
855 - We no longer pass the meta-attribute object as a final
856 argument to triggers. This actually changed for inlined code a
857 while back, but the non-inlined version and the docs were
861 - Some tests tried to use Test::Warn 0.10, which had bugs. Now
862 they require 0.11. (Dave Rolsky)
865 - Lots of small changes to the manual, cookbook, and
866 elsewhere. These were based on feedback from various
867 users, too many to list here. (Dave Rolsky)
869 0.69 Thu, February 12, 2009
871 - Make some keyword errors use throw_error instead of croak
872 since Moose::Exporter wraps keywords now (Sartak)
875 - Revised every recipe for style and clarity. Also moved some
876 documentation out of cookbook recipes and into Moose::Manual
877 pages. This work was funded as part of the Moose docs grant
878 from TPF. (Dave Rolsky)
880 * Moose::Meta::Method::Delegation
881 - If the attribute doing the delegation was not populated, the
882 error message did not specify the attribute name
885 0.68 Wed, February 4, 2009
887 - Many spelling, typo, and formatting fixes by daxim.
889 * Moose::Manual::Attributes
890 - The NAME section in the POD used "Attribute" so search.cpan
891 didn't resolve links from other documents properly.
893 * Moose::Meta::Method::Overriden
894 - Now properly spelled as Overridden. Thanks to daxim for
897 0.67 Tue, February 3, 2009
899 - Lots of little typo fixes and a few clarifications. Several
900 pages didn't have proper titles, and so weren't actually
901 visible on search.cpan.org. Thanks to hanekomu for a variety
902 of fixes and formatting improvements.
904 0.66 Tue, February 3, 2009
906 - This is a brand new, extensive manual for Moose. This aims to
907 provide a complete introduction to all of Moose's
908 features. This work was funded as part of the Moose docs grant
909 from TPF. (Dave Rolsky)
911 * Moose::Meta::Attribute
912 - Added a delegation_metaclass method to replace a hard-coded
913 use of Moose::Meta::Method::Delegation. (Dave Rolsky)
915 * Moose::Util::TypeConstraints
916 - If you created a subtype and passed a parent that Moose didn't
917 know about, it simply ignored the parent. Now it automatically
918 creates the parent as a class type. This may not be what you
919 want, but is less broken than before. (Dave Rolsky)
921 * Moose::Util::TypeConstraints
922 - This module tried throw errors by calling Moose->throw_error,
923 but it did not ensure that Moose was loaded first. This could
924 cause very unhelpful errors when it tried to throw an error
925 before Moose was loaded. (Dave Rolsky)
927 * Moose::Util::TypeConstraints
928 - You could declare a name with subtype such as "Foo!Bar" that
929 would be allowed, but if you used it in a parameterized type
930 such as "ArrayRef[Foo!Bar]" it wouldn't work. We now do some
931 vetting on names created via the sugar functions, so that they
932 can only contain alphanumerics, ":", and ".". (Dave Rolsky)
934 0.65 Thu, January 22, 2008
935 * Moose and Moose::Meta::Method::Overridden
936 - If an overridden method called super(), and then the
937 superclass's method (not overridden) _also_ called super(),
938 Moose went into an endless recursion loop. Test provided by
939 Chris Prather. (Dave Rolsky)
941 * Moose::Meta::TypeConstraint
942 - All methods are now documented. (gphat)
944 * t/100_bugs/011_DEMOLISH_eats_exceptions.t
945 - Fixed some bogus failures that occurred because we tried to
946 validate filesystem paths in a very ad-hoc and
947 not-quite-correct way. (Dave Rolsky)
949 * Moose::Util::TypeConstraints
950 - Added maybe_type to exports. See docs for details. (rjbs)
953 - Added Moose::Util::TypeConstraints to the SEE ALSO
957 - Methods created via an attribute can now fulfill a "requires"
958 declaration for a role. (nothingmuch)
960 * Moose::Meta::Method::*
961 - Stack traces from inlined code will now report its line and
962 file as being in your class, as opposed to in Moose
965 0.64 Wed, December 31, 2008
966 * Moose::Meta::Method::Accessor
967 - Always inline predicate and clearer methods (Sartak)
969 * Moose::Meta::Attribute
970 - Support for parameterized traits (Sartak)
971 - verify_against_type_constraint method to avoid duplication
972 and enhance extensibility (Sartak)
975 - Tests (but no support yet) for parameterized traits (Sartak)
978 - Require Class::MOP 0.75+, which has the side effect of making
979 sure we work on Win32. (Dave Rolsky)
981 0.63 Mon, December 8, 2008
983 - Some small grammar tweaks and bug fixes in non-Moose example
986 0.62_02 Fri, December 5, 2008
987 * Moose::Meta::Role::Application::ToClass
988 - When a class does not provide all of a role's required
989 methods, the error thrown now mentions all of the missing
990 methods, as opposed to just the first one found. Requested by
991 Curtis Poe (RT #41119). (Dave Rolsky)
993 * Moose::Meta::Method::Constructor
994 - Moose will no longer inline a constructor for your class
995 unless it inherits its constructor from Moose::Object, and
996 will warn when it doesn't inline. If you want to force
997 inlining anyway, pass "replace_constructor => 1" to
998 make_immutable. Addresses RT #40968, reported by Jon
999 Swartz. (Dave Rolsky)
1000 - The quoting of default values could be broken if the default
1001 contained a single quote ('). Now we use quotemeta to escape
1002 anything potentially dangerous in the defaults. (Dave Rolsky)
1004 0.62_01 Wed, December 3, 2008
1006 - use the method->execute API for BUILDALL
1007 and DEMOLISHALL (Sartak)
1009 * Moose::Util::TypeConstraints
1010 - We now make all the type constraint meta classes immutable
1011 before creating the default types provided by Moose. This
1012 should make loading Moose a little faster. (Dave Rolsky)
1014 0.62 Wed November 26, 2008
1015 * Moose::Meta::Role::Application::ToClass
1016 Moose::Meta::Role::Application::ToRole
1017 - fixed issues where excluding and aliasing the
1018 same methods for a single role did not work
1019 right (worked just fine with multiple
1021 - added test for this (stevan)
1023 * Moose::Meta::Role::Application::RoleSummation
1024 - fixed the error message when trying to compose
1025 a role with a role it excludes (Sartak)
1028 - Catch another case where recursion caused the value
1029 of $CALLER to be stamped on (t0m)
1030 - added test for this (t0m)
1033 - Remove the make_immutable keyword, which has been
1034 deprecated since April. It breaks metaclasses that
1035 use Moose without no Moose (Sartak)
1037 * Moose::Meta::Attribute
1038 - Removing an attribute from a class now also removes delegation
1039 (handles) methods installed for that attribute (t0m)
1040 - added test for this (t0m)
1042 * Moose::Meta::Method::Constructor
1043 - An attribute with a default that looked like a number (but was
1044 really a string) would accidentally be treated as a number
1045 when the constructor was made immutable (perigrin)
1046 - added test for this (perigrin)
1049 - create method for constructing a role
1050 dynamically (Sartak)
1051 - added test for this (Sartak)
1052 - anonymous roles! (Sartak)
1053 - added test for this (Sartak)
1056 - more consistent error messages (Sartak)
1058 * Moose::Cookbook::Roles::Recipe1
1059 - attempt to explain why a role that just requires
1060 methods is useful (Sartak)
1062 0.61 Fri November 7, 2008
1063 * Moose::Meta::Attribute
1064 - When passing a role to handles, it will be loaded if necessary
1067 * Moose::Meta::Class
1068 - Method objects returned by get_method (and other methods)
1069 Could end up being returned without an associated_metaclass
1070 attribute. Removing get_method_map, which is provided by
1071 Class::MOP::Class, fixed this. The Moose version did nothing
1072 different from its parent except introduce a bug. (Dave Rolsky)
1073 - added tests for this (jdv79)
1076 - Added a $VERSION to all .pm files which didn't have one. Fixes
1077 RT #40049, reported by Adam Kennedy. (Dave Rolsky)
1079 * Moose::Cookbook::Basics::Recipe4
1080 * Moose::Cookbook::Basics::Recipe6
1081 - These files had spaces on the first line of the SYNOPSIS, as
1082 opposed to a totally empty line. According to RT #40432, this
1083 confuses POD parsers. (Dave Rolsky)
1085 0.60 Fri October 24, 2008
1087 - Passing "-traits" when loading Moose caused the Moose.pm
1088 exports to be broken. Reported by t0m. (Dave Rolsky)
1089 - Tests for this bug. (t0m)
1092 - Change resolve_metaclass alias to use the new
1093 load_first_existing_class function. This makes it a lot
1094 simpler, and also around 5 times faster. (t0m)
1095 - Add caching to resolve_metaclass_alias, which gives an order
1096 of magnitude speedup to things which repeatedly call the
1097 Moose::Meta::Attribute->does method, notably MooseX::Storage
1100 * Moose::Util::TypeConstraint
1101 - Put back the changes for parameterized constraints that
1102 shouldn't have been removed in 0.59. We still cannot parse
1103 them, but MooseX modules can create them in some other
1104 way. See the 0.58 changes for more details. (jnapiorkowski)
1105 - Changed the way subtypes are created so that the job is
1106 delegated to a type constraint parent. This clears up some
1107 hardcoded checking and should allow correct subtypes of
1108 Moose::Meta::Type::Constraint. Don't rely on this new API too
1109 much (create_child_type) because it may go away in the
1110 future. (jnapiorkowski)
1112 * Moose::Meta::TypeConstraint::Union
1113 - Type constraint names are sorted as strings, not numbers.
1116 * Moose::Meta::TypeConstraint::Parameterizable
1117 - New parameterize method. This can be used as a factory method
1118 to make a new type constraint with a given parameterized
1119 type. (jnapiorkowski)
1120 - added tests (jnapiorkowski)
1122 0.59 Tue October 14, 2008
1124 - Add abridged documentation for builder/default/initializer/
1125 predicate, and link to more details sections in
1126 Class::MOP::Attribute. (t0m)
1128 * Moose::Util::TypeConstraints
1129 - removed prototypes from all but the &-based stuff (mst)
1131 * Moose::Util::TypeConstraints
1132 - Creating a anonymous subtype with both a constraint and a
1133 message failed with a very unhelpful error, but should just
1134 work. Reported by t0m. (Dave Rolsky)
1137 - Some tests that used Test::Warn if it was available failed
1138 with older versions of Test::Warn. Reported by Fayland. (Dave
1140 - Test firing behavior of triggers in relation to builder/default/
1142 - Test behavior of equals/is_a_type_of/is_a_subtype_of for all
1143 kinds of supported type. (t0m)
1145 * Moose::Meta::Class
1146 - In create(), do not pass "roles" option to the superclass
1147 - added related test that creates an anon metaclass with
1148 a required attribute
1150 * Moose::Meta::TypeConstraint::Class
1151 * Moose::Meta::TypeConstraint::Role
1152 - Unify behavior of equals/is_a_type_of/is_a_subtype_of with
1153 other types (as per change in 0.55_02). (t0m)
1155 * Moose::Meta::TypeConstraint::Registry
1156 - Fix warning when dealing with unknown type names (t0m)
1158 * Moose::Util::TypeConstraints
1159 - Reverted changes from 0.58 related to handle parameterized
1160 types. This caused random failures on BSD and Win32 systems,
1161 apparently related to the regex engine. This means that Moose
1162 can no longer parse structured type constraints like
1163 ArrayRef[Int,Int] or HashRef[name=>Str]. This will be
1164 supported in a slightly different way via MooseX::Types some
1165 time in the future. (Dave Rolsky)
1167 0.58 Sat September 20, 2008
1168 !! This release has an incompatible change regarding !!
1169 !! how roles add methods to a class !!
1171 * Roles and role application
1172 ! Roles now add methods by calling add_method, not
1173 alias_method. They make sure to always provide a method
1174 object, which will be cloned internally. This means that it is
1175 now possible to track the source of a method provided by a
1176 role, and even follow its history through intermediate roles.
1178 This means that methods added by a role now show up when
1179 looking at a class's method list/map. (Dave Rolsky)
1182 - From this release on, we'll try to maintain a list of
1183 conflicting modules, and warn you if you have one
1184 installed. For example, this release conflicts with ...
1185 - MooseX::Singleton <= 0.11
1186 - MooseX::Params::Validate <= 0.05
1189 In general, we try to not break backwards compatibility for
1190 most Moose users, but MooseX modules and other code which
1191 extends Moose's metaclasses is often affected by very small
1192 changes in the Moose internals.
1194 * Moose::Meta::Method::Delegation
1195 * Moose::Meta::Attribute
1196 - Delegation methods now have their own method class. (Dave
1199 * Moose::Meta::TypeConstraint::Parameterizable
1200 - Added a new method 'parameterize' which is basically a factory
1201 for the containing constraint. This makes it easier to create
1202 new types of parameterized constraints. (jnapiorkowski)
1204 * Moose::Meta::TypeConstraint::Union
1205 - Changed the way Union types canonicalize their names to follow
1206 the normalized TC naming rules, which means we strip all
1207 whitespace. (jnapiorkowski)
1209 * Moose::Util::TypeConstraints
1210 - Parameter and Union args are now sorted, this makes Int|Str
1211 the same constraint as Str|Int. (jnapiorkowski)
1212 - Changes to the way Union types are parsed to more correctly
1213 stringify their names. (jnapiorkowski)
1214 - When creating a parameterized type, we now use the new
1215 parameterize method. (jnapiorkowski)
1216 - Incoming type constraint strings are now normalized to remove
1217 all whitespace differences. (jnapiorkowski)
1218 - Changed the way we parse type constraint strings so that we now
1219 match TC[Int,Int,...] and TC[name=>Str] as parameterized type
1220 constraints. This lays the foundation for more flexible type
1221 constraint implementations.
1223 * Tests and docs for all the above. (jnapiorkowski)
1227 - Moose::Exporter will no longer remove a subroutine that the
1228 exporting package re-exports. Moose re-exports the
1229 Carp::confess function, among others. The reasoning is that we
1230 cannot know whether you have also explicitly imported those
1231 functions for your own use, so we err on the safe side and
1232 always keep them. (Dave Rolsky)
1233 - added tests for this (rafl)
1235 * Moose::Meta::Class
1236 - Changes to how we fix metaclass compatibility that are much
1237 too complicated to go into. The summary is that Moose is much
1238 less likely to complain about metaclass incompatibility
1239 now. In particular, if two metaclasses differ because
1240 Moose::Util::MetaRole was used on the two corresponding
1241 classes, then the difference in roles is reconciled for the
1242 subclass's metaclass. (Dave Rolsky)
1243 - Squashed an warning in _process_attribute (thepler)
1246 - throw exceptions (sooner) for invalid attribute names (thepler)
1247 - added tests for this (thepler)
1249 * Moose::Util::MetaRole
1250 - If you explicitly set a constructor or destructor class for a
1251 metaclass object, and then applied roles to the metaclass,
1252 that explicitly set class would be lost and replaced with the
1255 * Moose::Meta::Class
1256 * Moose::Meta::Attribute
1257 * Moose::Meta::Method
1260 * Moose::Error::Default
1261 * Moose::Error::Croak
1262 * Moose::Error::Confess
1263 - All instances of confess() changed to use overridable
1264 C<throw_error> method. This method ultimately calls a class
1265 constructor, and you can change the class being called. In
1266 addition, errors now pass more information than just a string.
1267 The default C<error_class> behaves like C<Carp::confess>, so
1268 the behavior is not visibly different for end users.
1270 0.57 Wed September 3, 2008
1272 - A new bit of doc intended to introduce folks familiar with
1273 "standard" Perl 5 OO to Moose concepts. (Dave Rolsky)
1275 * Moose::Unsweetened
1276 - Shows examples of two classes, each done first with and then
1277 without Moose. This makes a nice parallel to
1278 Moose::Intro. (Dave Rolsky)
1280 * Moose::Util::TypeConstraints
1281 - Fixed a bug in find_or_parse_type_constraint so that it
1282 accepts a Moose::Meta::TypeConstraint object as the parent
1283 type, not just a name (jnapiorkowski)
1284 - added tests (jnapiorkowski)
1287 - If Sub::Name was not present, unimporting failed to actually
1288 remove some sugar subs, causing test failures (Dave Rolsky)
1290 0.56 Mon September 1, 2008
1291 For those not following the series of dev releases, there are
1292 several major changes in this release of Moose.
1293 ! Moose::init_meta should now be called as a method. See the
1296 - Major performance improvements by nothingmuch.
1298 - New modules for extension writers, Moose::Exporter and
1299 Moose::Util::MetaRole by Dave Rolsky.
1301 - Lots of doc improvements and additions, especially in the
1304 - Various bug fixes.
1306 * Removed all references to the experimental-but-no-longer-needed
1307 Moose::Meta::Role::Application::ToMetaclassInstance.
1309 * Require Class::MOP 0.65.
1311 0.55_04 Sat August 30, 2008
1312 * Moose::Util::MetaRole
1313 * Moose::Cookbook::Extending::Recipe2
1314 - This simplifies the application of roles to any meta class, as
1315 well as the base object class. Reimplemented metaclass traits
1316 using this module. (Dave Rolsky)
1318 * Moose::Cookbook::Extending::Recipe1
1319 - This a new recipe, an overview of various ways to write Moose
1320 extensions (Dave Rolsky)
1322 * Moose::Cookbook::Extending::Recipe3
1323 * Moose::Cookbook::Extending::Recipe4
1324 - These used to be Extending::Recipe1 and Extending::Recipe2,
1327 0.55_03 Fri August 29, 2008
1328 * No changes from 0.55_02 except increasing the Class::MOP
1329 dependency to 0.64_07.
1331 0.55_02 Fri August 29, 2008
1332 * Makefile.PL and Moose.pm
1333 - explicitly require Perl 5.8.0+ (Dave Rolsky)
1335 * Moose::Util::TypeConstraints
1336 - Fix warnings from find_type_constraint if the type is not
1339 * Moose::Meta::TypeConstraint
1340 - Predicate methods (equals/is_a_type_of/is_subtype_of) now
1341 return false if the type you specify cannot be found in the
1342 type registry, rather than throwing an unhelpful and
1343 coincidental exception. (t0m).
1344 - added docs & test for this (t0m)
1346 * Moose::Meta::TypeConstraint::Registry
1347 - add_type_constraint now throws an exception if a parameter is
1349 - added docs & test for this (t0m)
1351 * Moose::Cookbook::FAQ
1352 - Added a faq entry on the difference between "role" and "trait"
1356 - Fixed a bug that caused role composition to not see a required
1357 method when that method was provided by another role being
1358 composed at the same time. (Dave Rolsky)
1359 - test and bug finding (tokuhirom)
1361 0.55_01 Wed August 20, 2008
1363 !! Calling Moose::init_meta as a function is now !!
1364 !! deprecated. Please see the Moose.pm docs for details. !!
1366 * Moose::Meta::Method::Constructor
1367 - Fix inlined constructor so that values produced by default
1368 or builder methods are coerced as required. (t0m)
1369 - added test for this (t0m)
1371 * Moose::Meta::Attribute
1372 - A lazy attribute with a default or builder did not attempt to
1373 coerce the default value. The immutable code _did_
1375 - added test for this (t0m)
1378 - This is a new helper module for writing "Moose-alike"
1379 modules. This should make the lives of MooseX module authors
1380 much easier. (Dave Rolsky)
1383 * Moose::Cookbook::Meta::Recipe5
1384 - Implemented metaclass traits (and wrote a recipe for it):
1386 use Moose -traits => 'Foo'
1388 This should make writing small Moose extensions a little
1389 easier (Dave Rolsky)
1391 * Moose::Cookbook::Basics::Recipe1
1392 - Removed any examples of direct hashref access, and applied an
1393 editorial axe to reduce verbosity. (Dave Rolsky)
1395 * Moose::Cookbook::Basics::Recipe1
1396 - Also applied an editorial axe here. (Dave Rolsky)
1399 * Moose::Cookbook::Extending::Recipe1
1400 * Moose::Cookbook::Extending::Recipe2
1401 - Rewrote extending and embedding moose documentation and
1402 recipes to use Moose::Exporter (Dave Rolsky)
1406 - These two modules now warn when you load them from the main
1407 package "main" package, because we will not export sugar to
1408 main. Previously it just did nothing. (Dave Rolsky)
1411 - Now provide an init_meta method just like Moose.pm, and you
1412 can call this to provide an alternate role metaclass. (Dave
1413 Rolsky and nothingmuch)
1414 - get_method_map now respects the package cache flag (nothingmuch)
1417 - Two new methods - add_method and wrap_method_body
1421 - Optimizations including allowing constructors to accept hash
1422 refs, making many more classes immutable, and making
1423 constructors immutable. (nothingmuch)
1425 0.55 Sun August 3, 2008
1426 * Moose::Meta::Attribute
1427 - breaking down the way 'handles' methods are
1428 created so that the process can be more easily
1429 overridden by subclasses (stevan)
1431 * Moose::Meta::TypeConstraint
1432 - fixing what is passed into a ->message with
1433 the type constraints (RT #37569)
1434 - added tests for this (Charles Alderman)
1436 * Moose::Util::TypeConstraints
1437 - fix coerce to accept anon types like subtype can (mst)
1440 - reorganized the recipes into sections - Basics, Roles, Meta,
1441 Extending - and wrote abstracts for each section (Dave Rolsky)
1443 * Moose::Cookbook::Basics::Recipe10
1444 - A new recipe that demonstrates operator overloading
1445 in combination with Moose. (bluefeet)
1447 * Moose::Cookbook::Meta::Recipe1
1448 - an introduction to what meta is and why you'd want to make
1449 your own metaclass extensions (Dave Rolsky)
1451 * Moose::Cookbook::Meta::Recipe4
1452 - a very simple metaclass example (Dave Rolsky)
1454 * Moose::Cookbook::Extending::Recipe1
1455 - how to write a Moose-alike module to use your own object base
1458 * Moose::Cookbook::Extending::Recipe2
1459 - how to write modules with an API just like C<Moose.pm> (Dave
1463 - Tons of fixes, both syntactical and grammatical (Dave
1464 Rolsky, Paul Fenwick)
1466 0.54 Thurs. July 3, 2008
1467 ... this is not my day today ...
1469 * Moose::Meta::Attribute
1470 - fixed legal_options_for_inheritance such that
1471 clone_and_inherit options still works for
1472 Class::MOP::Attribute objects and therefore
1473 does not break MooseX::AttributeHelpers
1476 0.53 Thurs. July 3, 2008
1477 * Whoops, I guess I should run 'make manifest' before
1478 actually releasing the module. No actual changes
1479 in this release, except the fact that it includes
1480 the changes that I didn't include in the last
1483 0.52 Thurs. July 3, 2008
1485 - added "FEATURE REQUESTS" section to the Moose docs
1486 to properly direct people (stevan) (RT #34333)
1487 - making 'extends' croak if it is passed a Role since
1488 this is not ever something you want to do
1489 (fixed by stevan, found by obra)
1490 - added tests for this (stevan)
1493 - adding support for DOES (as in UNIVERSAL::DOES)
1495 - added test for this
1497 * Moose::Meta::Attribute
1498 - added legal_options_for_inheritance (wreis)
1499 - added tests for this (wreis)
1501 * Moose::Cookbook::Snacks::*
1502 - removed some of the unfinished snacks that should
1503 not have been released yet. Added some more examples
1504 to the 'Keywords' snack. (stevan)
1506 * Moose::Cookbook::Style
1507 - added general Moose "style guide" of sorts to the
1508 cookbook (nothingmuch) (RT #34335)
1511 - added more BUILDARGS tests (stevan)
1513 0.51 Thurs. Jun 26, 2008
1515 - add unimport so "no Moose::Role" actually does
1518 * Moose::Meta::Role::Application::ToRole
1519 - when RoleA did RoleB, and RoleA aliased a method from RoleB in
1520 order to provide its own implementation, that method still got
1521 added to the list of required methods for consumers of
1522 RoleB. Now an aliased method is only added to the list of
1523 required methods if the role doing the aliasing does not
1524 provide its own implementation. See Recipe 11 for an example
1525 of all this. (Dave Rolsky)
1526 - added tests for this
1528 * Moose::Meta::Method::Constructor
1529 - when a single argument that wasn't a hashref was provided to
1530 an immutabilized constructor, the error message was very
1531 unhelpful, as opposed to the non-immutable error. Reported by
1533 - added test for this (Dave Rolsky)
1535 * Moose::Meta::Attribute
1536 - added support for meta_attr->does("ShortAlias") (sartak)
1537 - added tests for this (sartak)
1538 - moved the bulk of the `handles` handling to the new
1539 install_delegation method (Stevan)
1542 - Added BUILDARGS, a new step in new()
1544 * Moose::Meta::Role::Application::RoleSummation
1545 - fix typos no one ever sees (sartak)
1547 * Moose::Util::TypeConstraints
1548 * Moose::Meta::TypeConstraint
1549 * Moose::Meta::TypeCoercion
1550 - Attempt to work around the ??{ } vs. threads issue
1552 - Some null_constraint optimizations
1554 0.50 Thurs. Jun 11, 2008
1555 - Fixed a version number issue by bumping all modules
1558 0.49 Thurs. Jun 11, 2008
1559 !! This version now approx. 20-25% !!
1560 !! faster with new Class::MOP 0.59 !!
1562 * Moose::Meta::Attribute
1563 - fixed how the is => (ro|rw) works with
1564 custom defined reader, writer and accessor
1566 - added docs for this (TODO).
1567 - added tests for this (Thanks to Penfold)
1568 - added the custom attribute alias for regular
1569 Moose attributes which is "Moose"
1570 - fix builder and default both being used
1575 Moose::Meta::Attribute
1577 Moose::Meta::Role::Composite
1578 Moose::Util::TypeConstraints
1579 - switched usage of reftype to ref because
1583 - changing add_package_symbol to use the new
1587 - fixed how DEMOLISHALL is called so that it
1588 can be overrided in subclasses (thanks to Sartak)
1589 - added test for this (thanks to Sartak)
1591 * Moose::Util::TypeConstraints
1592 - move the ClassName type check code to
1593 Class::MOP::is_class_loaded (thanks to Sartak)
1595 * Moose::Cookbook::Recipe11
1596 - add tests for this (thanks to tokuhirom)
1598 0.48 Thurs. May 29, 2008
1599 (early morning release engineering)--
1601 - fixing the version in Moose::Meta::Method::Destructor
1602 which was causing the indexer to choke
1604 0.47 Thurs. May 29, 2008
1605 (late night release engineering)--
1607 - fixing the version is META.yml, no functional
1608 changes in this release
1610 0.46 Wed. May 28, 2008
1611 !! This version now approx. 20-25% !!
1612 !! faster with new Class::MOP 0.57 !!
1614 * Moose::Meta::Class
1615 - some optimizations of the &initialize method
1616 since it is called so often by &meta
1618 * Moose::Meta::Class
1620 - now use the get_all_package_symbols from the
1621 updated Class::MOP, test suite is now 10 seconds
1624 * Moose::Meta::Method::Destructor
1625 - is_needed can now also be called as a class
1626 method for immutablization to check if the
1627 destructor object even needs to be created
1630 * Moose::Meta::Method::Destructor
1631 Moose::Meta::Method::Constructor
1632 - added more descriptive error message to help
1633 keep people from wasting time tracking an error
1634 that is easily fixed by upgrading.
1636 0.45 Saturday, May 24, 2008
1638 - Because of work in Class::MOP 0.57, all
1639 XS based functionality is now optional
1640 and a Pure Perl version is supplied
1641 - the CLASS_MOP_NO_XS environment variable
1642 can now be used to force non-XS versions
1644 - several of the packages have been tweaked
1645 to take care of this, mostly we added
1646 support for the package_name and name
1647 variables in all the Method metaclasses
1648 - before/around/after method modifiers now
1649 support regexp matching of names
1650 (thanks to Takatoshi Kitano)
1651 - tests added for this
1652 - NOTE: this only works for classes, it
1653 is currently not supported in roles,
1654 but, ... patches welcome
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
1660 - All usage of Carp::confess have been replaced
1661 by Carp::croak in the "keyword" functions since
1662 the stack trace is usually not helpful
1663 - The 'has' keyword for roles now accepts the
1664 same array ref form that Moose.pm does
1665 (has [qw/foo bar/] => (is => 'rw', ...))
1666 - added test for this
1668 * Moose::Meta::Attribute
1669 - trigger on a ro-attribute is no longer an
1670 error, as it's useful to trigger off of the
1673 * Moose::Meta::Class
1674 - added same 'add_package_symbol' fix as in
1678 - does_role now handles non-Moose classes
1680 - added tests for this
1681 - added the 'add_method_modifier' function
1682 (thanks to Takatoshi Kitano)
1684 * Moose::Util::TypeConstraints
1685 - subtypes of parameterizable types now are
1686 themselves parameterizable types
1688 * Moose::Meta::Method::Constructor
1689 - fixed bug where trigger was not being
1690 called by the inlined immutable
1692 - added test for this (thanks to Caelum)
1694 * Moose::Meta::Role::Application::ToInstance
1695 - now uses the metaclass of the instance
1696 (if possible) to create the anon-class
1697 (thanks Jonathan Rockway)
1699 * Moose::Cookbook::Recipe22
1700 - added the meta-attribute trait recipe
1704 - fixed hash-ordering test bug that was
1705 causing occasional cpantester failures
1706 - renamed the t/000_recipe/*.t tests to be
1707 more descriptive (thanks to Sartak)
1709 0.44 Sat. May 10, 2008
1711 - made make_immutable warning cluck to
1712 show where the error is (thanks mst)
1715 - BUILDALL and DEMOLISHALL now call
1716 ->body when looping through the
1717 methods, to avoid the overloaded
1719 - fixed issue where DEMOLISHALL was
1720 eating the $@ values, and so not
1721 working correctly, it still kind of
1722 eats them, but so does vanilla perl
1723 - added tests for this
1725 * Moose::Cookbook::Recipe7
1726 - added new recipe for immutable
1727 functionality (thanks Dave Rolsky)
1729 * Moose::Cookbook::Recipe9
1730 - added new recipe for builder and
1731 lazy_build (thanks Dave Rolsky)
1733 * Moose::Cookbook::Recipe11
1734 - added new recipe for method aliasing
1735 and exclusion with Roles (thanks Dave Rolsky)
1738 - fixed Win32 test failure (thanks spicyjack)
1740 ~ removed Build.PL and Module::Build compat
1741 since Module::Install has done that.
1743 0.43 Wed. April, 30, 2008
1745 drink more coffee before
1746 doing release engineering
1748 - whoops, forgot to do the smolder tests,
1749 and we broke some of the custom meta-attr
1750 modules. This fixes that.
1752 0.42 Mon. April 28, 2008
1753 - some bad tests slipped by, nothing else
1754 changed in this release (cpantesters++)
1756 - upped the Class::MOP dependency to 0.55
1757 since we have tests which need the C3
1760 0.41 Mon. April 28, 2008
1761 ~~ numerous documentation updates ~~
1763 - Changed all usage of die to Carp::croak for better
1764 error reporting (initial patch by Tod Hagan)
1766 ** IMPORTANT NOTE **
1767 - the make_immutable keyword is now deprecated, don't
1768 use it in any new code and please fix your old code
1769 as well. There will be 2 releases, and then it will
1775 - refactored the way inner and super work to avoid
1776 any method/@ISA cache penalty (nothingmuch)
1778 * Moose::Meta::Class
1779 - fixing &new_object to make sure trigger gets the
1780 coerced value (spotted by Charles Alderman on the
1782 - added test for this
1784 * Moose::Meta::Method::Constructor
1785 - immutable classes which had non-lazy attributes were calling
1786 the default generating sub twice in the constructor. (bug
1787 found by Jesse Luehrs, fixed by Dave Rolsky)
1788 - added tests for this (Dave Rolsky)
1789 - fix typo in initialize_body method (nothingmuch)
1791 * Moose::Meta::Method::Destructor
1792 - fix typo in initialize_body method (nothingmuch)
1794 * Moose::Meta::Method::Overriden
1795 Moose::Meta::Method::Augmented
1796 - moved the logic for these into their own
1797 classes (nothingmuch)
1799 * Moose::Meta::Attribute
1800 - inherited attributes may now be extended without
1801 restriction on the type ('isa', 'does') (Sartak)
1802 - added tests for this (Sartak)
1803 - when an attribute property is malformed (such as lazy without
1804 a default), give the name of the attribute in the error
1806 - added the &applied_traits and &has_applied_traits methods
1807 to allow introspection of traits
1808 - added tests for this
1809 - moved 'trait' and 'metaclass' argument handling to here from
1811 - clone_and_inherit_options now handles 'trait' and 'metaclass' (has
1812 '+foo' syntax) (nothingmuch)
1813 - added tests for this (t0m)
1816 - localize $@ inside DEMOLISHALL to avoid it
1817 eating $@ (found by Ernesto)
1818 - added test for this (thanks to Ernesto)
1820 * Moose::Util::TypeConstraints
1821 - &find_type_constraint now DWIMs when given an
1822 type constraint object or name (nothingmuch)
1823 - &find_or_create_type_constraint superseded with a number of more
1825 - find_or_create_{isa,does}_type_constraint
1826 - find_or_parse_type_constraint
1828 * Moose::Meta::TypeConstraint
1829 Moose::Meta::TypeConstraint::Class
1830 Moose::Meta::TypeConstraint::Role
1831 Moose::Meta::TypeConstraint::Enum
1832 Moose::Meta::TypeConstraint::Union
1833 Moose::Meta::TypeConstraint::Parameterized
1834 - added the &equals method for comparing two type
1835 constraints (nothingmuch)
1836 - added tests for this (nothingmuch)
1838 * Moose::Meta::TypeConstraint
1839 - add the &parents method, which is just an alias to &parent.
1840 Useful for polymorphism with TC::{Class,Role,Union} (nothingmuch)
1842 * Moose::Meta::TypeConstraint::Class
1843 - added the class attribute for introspection purposes
1845 - added tests for this
1847 * Moose::Meta::TypeConstraint::Enum
1848 Moose::Meta::TypeConstraint::Role
1849 - broke these out into their own classes (nothingmuch)
1851 * Moose::Cookbook::Recipe*
1852 - fixed references to test file locations in the POD
1853 and updated up some text for new Moose features
1857 - Added &resolve_metaclass_alias, a helper function for finding an actual
1858 class for a short name (e.g. in the traits list)
1860 0.40 Fri. March 14, 2008
1861 - I hate Pod::Coverage
1863 0.39 Fri. March 14, 2008
1865 - documenting the use of '+name' with attributes
1866 that come from recently composed roles. It makes
1867 sense, people are using it, and so why not just
1868 officially support it.
1869 - fixing the 'extends' keyword so that it will not
1870 trigger Ovid's bug (http://use.perl.org/~Ovid/journal/35763)
1873 - added the perl -Moose=+Class::Name feature to allow
1874 monkeypatching of classes in one liners
1877 - fixing the 'apply_all_roles' keyword so that it will not
1878 trigger Ovid's bug (http://use.perl.org/~Ovid/journal/35763)
1880 * Moose::Meta::Class
1881 - added ->create method which now supports roles (thanks to jrockway)
1882 - added tests for this
1883 - added ->create_anon_class which now supports roles and caching of
1884 the results (thanks to jrockway)
1885 - added tests for this
1886 - made ->does_role a little more forgiving when it is
1887 checking a Class::MOP era metaclasses.
1889 * Moose::Meta::Role::Application::ToInstance
1890 - it is now possible to pass extra params to be used when
1891 a role is applied to an the instance (rebless_params)
1892 - added tests for this
1894 * Moose::Util::TypeConstraints
1895 - class_type now accepts an optional second argument for a
1896 custom message. POD anotated accordingly (groditi)
1897 - added tests for this
1898 - it is now possible to make anon-enums by passing 'enum' an
1899 ARRAY ref instead of the $name => @values. Everything else
1901 - added tests for this
1904 - making test for using '+name' on attributes consumed
1905 from a role, it works and makes sense too.
1907 * Moose::Meta::Attribute
1908 - fix handles so that it doesn't return nothing
1909 when the method cannot be found, not sure why
1910 it ever did this originally, this means we now
1911 have slightly better support for AUTOLOADed
1913 - added more delegation tests
1914 - adding ->does method to this so as to better
1915 support traits and their introspection.
1916 - added tests for this
1919 - localizing the Data::Dumper configurations so
1920 that it does not pollute others (RT #33509)
1921 - made ->does a little more forgiving when it is
1922 passed Class::MOP era metaclasses.
1924 0.38 Fri. Feb. 15, 2008
1925 * Moose::Meta::Attribute
1926 - fixed initializer to correctly do
1927 type checking and coercion in the
1929 - added tests for this
1932 - fixed some finicky tests (thanks to konobi)
1934 0.37 Thurs. Feb. 14, 2008
1936 - fixed some details in Moose::init_meta
1937 and its superclass handling (thanks thepler)
1938 - added tests for this (thanks thepler)
1939 - 'has' now dies if you don't pass in name
1941 - added the 'make_immutable' keyword as a shortcut
1944 * Moose::Meta::Class
1945 Moose::Meta::Method::Constructor
1946 Moose::Meta::Attribute
1947 - making (init_arg => undef) work here too
1948 (thanks to nothingmuch)
1950 * Moose::Meta::Attribute
1951 Moose::Meta::Method::Constructor
1952 Moose::Meta::Method::Accessor
1953 - make lazy attributes respect attr initializers (rjbs)
1954 - added tests for this
1956 * Moose::Util::TypeConstraints
1957 Moose::Util::TypeConstraints::OptimizedConstraints
1958 Moose::Meta::TypeConstraints
1959 Moose::Meta::Attribute
1960 Moose::Meta::Method::Constructor
1961 Moose::Meta::Method::Accessor
1962 - making type errors use the
1963 assigned message (thanks to Sartak)
1964 - added tests for this
1966 * Moose::Meta::Method::Destructor
1967 - making sure DESTROY gets inlined properly
1968 with successive DEMOLISH calls (thanks to manito)
1970 * Moose::Meta::Attribute
1971 Moose::Meta::Method::Accessor
1972 - fixed handling of undef with type constraints
1974 - added tests for this
1977 - added &get_all_init_args and &get_all_attribute_values
1978 (thanks to Sartak and nothingmuch)
1980 0.36 Sat. Jan. 26, 2008
1982 Moose::Meta::Attribute
1983 - role type tests now support when roles are
1984 applied to non-Moose classes (found by ash)
1985 - added tests for this (thanks to ash)
1986 - couple extra tests to boost code coverage
1988 * Moose::Meta::Method::Constructor
1989 - improved fix for handling Class::MOP attributes
1990 - added test for this
1992 * Moose::Meta::Class
1993 - handled the add_attribute($attribute_meta_object)
1995 - added test for this
1997 0.35 Tues. Jan. 22, 2008
1998 * Moose::Meta::Method::Constructor
1999 - fix to make sure even Class::MOP attributes
2000 are handled correctly (Thanks to Dave Rolsky)
2001 - added test for this (also Dave Rolsky)
2003 * Moose::Meta::Class
2004 - improved error message on _apply_all_roles,
2005 you should now use Moose::Util::apply_all_roles
2006 and you shouldnt have been using a _ prefixed
2007 method in the first place ;)
2009 0.34 Mon. Jan. 21, 2008
2010 ~~~ more misc. doc. fixes ~~~
2011 ~~ updated copyright dates ~~
2013 Moose is now a postmodern object system :)
2014 - (see the POD for details)
2016 * <<Role System Refactoring>>
2017 - this release contains a major reworking and
2018 cleanup of the role system
2019 - 100% backwards compat.
2020 - Role application now restructured into seperate
2021 classes based on type of applicants
2022 - Role summation (combining of more than one role)
2023 is much cleaner and anon-classes are no longer
2024 used in this process
2025 - new Composite role metaclass
2026 - runtime application of roles to instances
2027 is now more efficient and re-uses generated
2028 classes when applicable
2030 * <<New Role composition features>>
2031 - methods can now be excluded from a given role
2033 - methods can now be aliased to another name (and
2034 still retain the original as well)
2036 * Moose::Util::TypeConstraints::OptimizedConstraints
2037 - added this module (see above)
2039 * Moose::Meta::Class
2040 - fixed the &_process_attribute method to be called
2041 by &add_attribute, so that the API is now correct
2043 * Moose::Meta::Method::Accessor
2044 - fixed bug when passing a list of values to
2045 an accessor would get (incorrectly) ignored.
2046 Thanks to Sartak for finding this ;)
2047 - added tests for this (Sartak again)
2049 * Moose::Meta::Method::Accessor
2050 Moose::Meta::Method::Constructor
2051 Moose::Meta::Attribute
2052 Moose::Meta::TypeConstraint
2053 Moose::Meta::TypeCoercion
2054 - lots of cleanup of such things as:
2056 - type constraint handling
2057 - error handling/messages
2058 (thanks to nothingmuch)
2060 * Moose::Meta::TypeConstraint::Parameterizable
2061 - added this module to support the refactor
2062 in Moose::Meta::TypeConstraint::Parameterized
2064 * Moose::Meta::TypeConstraint::Parameterized
2065 - refactored how these types are handled so they
2066 are more generic and not confined to ArrayRef
2070 - shortened some file names for better VMS support (RT #32381)
2072 0.33 Fri. Dec. 14, 2007
2073 !! Moose now loads 2 x faster !!
2074 !! with new Class::MOP 0.49 !!
2076 ++ new oose.pm module to make command line
2077 Moose-ness easier (see POD docs for more)
2079 * Moose::Meta::Class
2081 - several tweaks to take advantage of the
2082 new method map caching in Class::MOP
2084 * Moose::Meta::TypeConstraint::Parameterized
2085 - allow subtypes of ArrayRef and HashRef to
2086 be used as a container (sartak)
2087 - added tests for this
2088 - basic support for coercion to ArrayRef and
2089 HashRef for containers (sartak)
2090 - added tests for this
2092 * Moose::Meta::TypeCoercion
2093 - coercions will now create subtypes as needed
2094 so you can now add coercions to parameterized
2095 types without having to explictly define them
2096 - added tests for this
2098 * Moose::Meta::Method::Accessor
2099 - allow subclasses to decide whether we need
2100 to copy the value into a new variable (sartak)
2102 0.32 Tues. Dec. 4, 2007
2103 * Moose::Util::TypeConstraints
2104 - fixing how subtype aliases of unions work
2105 they should inherit the parent's coercion
2106 - added tests for this
2107 - you can now define multiple coercions on
2108 a single type at different times instead of
2109 having to do it all in one place
2110 - added tests for this
2112 * Moose::Meta::TypeConstraint
2113 - there is now a default constraint of sub { 1 }
2114 instead of Moose::Util::TypeConstraints setting
2117 * Moose::Meta::TypeCoercion
2118 * Moose::Meta::TypeCoercion::Union
2119 - added the &has_coercion_for_type and
2120 &add_type_coercions methods to support the
2121 new features above (although you cannot add
2122 more type coercions for Union types)
2124 0.31 Mon. Nov. 26, 2007
2125 * Moose::Meta::Attribute
2126 - made the +attr syntax handle extending types with
2127 parameters. So "has '+foo' => (isa => 'ArrayRef[Int]')"
2128 now works if the original foo is an ArrayRef.
2129 - added tests for this.
2130 - delegation now works even if the attribute does not
2131 have a reader method using the get_read_method_ref
2132 method from Class::MOP::Attribute.
2133 - added tests for this
2134 - added docs for this
2136 * Moose::Util::TypeConstraints
2137 - passing no "additional attribute info" to
2138 &find_or_create_type_constraint will no longer
2139 attempt to create an __ANON__ type for you,
2140 instead it will just return undef.
2141 - added docs for this
2143 0.30 Fri. Nov. 23, 2007
2144 * Moose::Meta::Method::Constructor
2145 -builder related bug in inlined constructor. (groditi)
2147 * Moose::Meta::Method::Accessor
2148 - genereate unnecessary calls to predicates and refactor
2149 code generation for runtime speed (groditi)
2151 * Moose::Util::TypeConstraints
2152 - fix ClassName constraint to introspect symbol table (mst)
2153 - added more tests for this (mst)
2154 - fixed it so that subtype 'Foo' => as 'HashRef[Int]' ...
2155 with work correctly.
2156 - added tests for this
2159 - adding the link to Recipie 11 (written by Sartak)
2160 - adding test for SYNOPSIS code
2163 - New tests for builder bug. Upon instantiation, if an
2164 attribute had a builder, no value and was not lazy the
2165 builder default was not getting run, oops. (groditi)
2167 0.29 Tues. Nov. 13, 2007
2168 * Moose::Meta::Attribute
2169 - Fix error message on missing builder method (groditi)
2171 * Moose::Meta::Method::Accessor
2172 - Fix error message on missing builder method (groditi)
2175 - Add test to check for the correct error message when
2176 builder method is missing (groditi)
2178 0.28 Tues. Nov. 13, 2007
2179 - 0.27 packaged incorrectly (groditi)
2181 0.27 Tues. Nov. 13, 2007
2182 * Moose::Meta::Attribute
2183 - Added support for the new builder option (groditi)
2184 - Added support for lazy_build option (groditi)
2185 - Changed slot initialization for predicate changes (groditi)
2187 * Moose::Meta::Method::Accessor
2188 - Added support for lazy_build option (groditi)
2189 - Fix inline methods to work with corrected predicate
2192 * Moose::Meta::Method::Constructor
2193 - Added support for lazy_build option (groditi)
2196 - tests for builder and lazy_build (groditi)
2198 * fixing some misc. bits in the docs that
2199 got mentioned on CPAN Forum & perlmonks
2202 - fixed how required methods are handled
2203 when they encounter overriden or modified
2204 methods from a class (thanks to confound).
2205 - added tests for this
2207 * Moose::Util::TypeConstraint
2208 - fixed the type notation parser so that
2209 the | always creates a union and so is
2210 no longer a valid type char (thanks to
2211 konobi, mugwump and #moose for working
2213 - added more tests for this
2215 0.26 Thurs. Sept. 27, 2007
2218 * Parameterized Types
2219 We now support parameterized collection types, such as:
2220 ArrayRef[Int] # array or integers
2221 HashRef[Object] # a hash with object values
2222 They can also be nested:
2223 ArrayRef[HashRef[RegexpRef]] # an array of hashes with regex values
2224 And work with the type unions as well:
2225 ArrayRef[Int | Str] # array of integers of strings
2227 * Better Framework Extendability
2228 Moose.pm is now "extendable" such that it is now much
2229 easier to extend the framework and add your own keywords
2230 and customizations. See the "EXTENDING AND EMBEDDING MOOSE"
2231 section of the Moose.pm docs.
2234 In an effort to begin documenting some of the various
2235 details of Moose as well as some common idioms, we have
2236 created Moose::Cookbook::Snacks as a place to find
2237 small (easily digestable) nuggets of Moose code.
2240 ~ Several doc updates/cleanup thanks to castaway ~
2242 - converted build system to use Module::Install instead of
2243 Module::Build (thanks to jrockway)
2246 - added all the meta classes to the immutable list and
2247 set it to inline the accessors
2248 - fix import to allow Sub::Exporter like { into => }
2249 and { into_level => } (perigrin)
2250 - exposed and documented init_meta() to allow better
2251 embedding and extending of Moose (perigrin)
2254 - complete re-organization of the test suite
2255 - added some new tests as well
2256 - finally re-enabled the Moose::POOP test since
2257 the new version of DBM::Deep now works again
2260 * Moose::Meta::Class
2261 - fixed very odd and very nasty recursion bug with
2263 - added tests for this (eilara)
2265 * Moose::Meta::Attribute
2266 Moose::Meta::Method::Constructor
2267 Moose::Meta::Method::Accessor
2268 - fixed issue with overload::Overloaded getting called
2269 on non-blessed items. (RT #29269)
2270 - added tests for this
2272 * Moose::Meta::Method::Accessor
2273 - fixed issue with generated accessor code making
2274 assumptions about hash based classes (thanks to dexter)
2276 * Moose::Coookbook::Snacks
2277 - these are bits of documentation, not quite as big as
2278 Recipes but which have no clear place in the module docs.
2279 So they are Snacks! (horray for castaway++)
2281 * Moose::Cookbook::Recipe4
2282 - updated it to use the new ArrayRef[MyType] construct
2283 - updated the accompanying test as well
2285 +++ Major Refactor of the Type Constraint system +++
2286 +++ with new features added as well +++
2288 * Moose::Util::TypeConstraint
2289 - no longer uses package variable to keep track of
2290 the type constraints, now uses the an instance of
2291 Moose::Meta::TypeConstraint::Registry to do it
2292 - added more sophisticated type notation parsing
2294 - added tests for this
2296 * Moose::Meta::TypeConstraint
2297 - some minor adjustments to make subclassing easier
2298 - added the package_defined_in attribute so that we
2299 can track where the type constraints are created
2301 * Moose::Meta::TypeConstraint::Union
2302 - this is now been refactored to be a subclass of
2303 Moose::Meta::TypeConstraint
2305 * Moose::Meta::TypeCoercion::Union
2306 - this has been added to service the newly refactored
2307 Moose::Meta::TypeConstraint::Union and is itself
2308 a subclass of Moose::Meta::TypeCoercion
2310 * Moose::Meta::TypeConstraint::Parameterized
2311 - added this module (taken from MooseX::AttributeHelpers)
2312 to help construct nested collection types
2313 - added tests for this
2315 * Moose::Meta::TypeConstraint::Registry
2316 - added this class to keep track of type constraints
2318 0.25 Mon. Aug. 13, 2007
2320 - Documentation update to reference Moose::Util::TypeConstraints
2321 under 'isa' in 'has' for how to define a new type
2322 (thanks to shlomif).
2324 * Moose::Meta::Attribute
2325 - required attributes now will no longer accept undef
2326 from the constructor, even if there is a default and lazy
2327 - added tests for this
2328 - default subroutines must return a value which passes the
2330 - added tests for this
2332 * Moose::Meta::Attribute
2333 * Moose::Meta::Method::Constructor
2334 * Moose::Meta::Method::Accessor
2335 - type-constraint tests now handle overloaded objects correctly
2336 in the error message
2337 - added tests for this (thanks to EvanCarroll)
2339 * Moose::Meta::TypeConstraint::Union
2340 - added (has_)hand_optimized_constraint to this class so that
2341 it behaves as the regular Moose::Meta::TypeConstraint does.
2344 - large refactoring of this code
2345 - added several more tests
2346 - tests for subtle conflict resolition issues
2347 added, but not currently running
2350 * Moose::Cookbook::Recipe7
2351 - added new recipe for augment/inner functionality
2353 - added test for this
2356 - a formal definition of roles (still in progress)
2359 - utilities for easier working with Moose classes
2360 - added tests for these
2363 - This contains Moose specific test functions
2364 - added tests for these
2366 0.24 Tues. July 3, 2007
2367 ~ Some doc updates/cleanup ~
2369 * Moose::Meta::Attribute
2370 - added support for roles to be given as parameters
2371 to the 'handles' option.
2372 - added tests and docs for this
2373 - the has '+foo' attribute form now accepts changes to
2374 the lazy option, and the addition of a handles option
2375 (but not changing the handles option)
2376 - added tests and docs for this
2379 - required methods are now fetched using find_method_by_name
2380 so that required methods can come from superclasses
2381 - adjusted tests for this
2383 0.23 Mon. June 18, 2007
2384 * Moose::Meta::Method::Constructor
2385 - fix inlined constructor for hierarchy with multiple BUILD methods (mst)
2386 * Moose::Meta::Class
2387 - Modify make_immutable to work with the new Class::MOP immutable
2388 mechanism + POD + very basic test (groditi)
2389 * Moose::Meta::Attribute
2390 - Fix handles to use goto() so that caller() comes out properly on
2391 the other side (perigrin)
2393 0.22 Thurs. May 31, 2007
2394 * Moose::Util::TypeConstraints
2395 - fix for prototype undeclared issue when Moose::Util::TypeConstraints
2396 loaded before consumers (e.g. Moose::Meta::Attribute) by predeclaring
2397 prototypes for functions
2398 - added the ClassName type constraint, this checks for strings
2399 which will respond true to ->isa(UNIVERSAL).
2400 - added tests and docs for this
2401 - subtyping just in name now works correctly by making the
2402 default for where be { 1 }
2403 - added test for this
2405 * Moose::Meta::Method::Accessor
2406 - coerce and lazy now work together correctly, thanks to
2407 merlyn for finding this bug
2408 - tests added for this
2409 - fix reader presedence bug in Moose::Meta::Attribute + tests
2412 - Foo->new(undef) now gets ignored, it is assumed you meant to pass
2413 a HASH-ref and missed. This produces better error messages then
2414 having it die cause undef is not a HASH.
2415 - added tests for this
2417 0.21 Thursday, May 2nd, 2007
2419 - added SUPER_SLOT and INNER_SLOT class hashes to support unimport
2420 - modified unimport to remove super and inner along with the rest
2421 - altered unimport tests to handle this
2424 - altered super export to populate SUPER_SLOT
2426 * Moose::Meta::Class
2427 - altered augment and override modifier application to use *_SLOT
2428 - modified tests for these to unimport one test class each to test
2431 - fixed issue where custom attribute metaclasses
2432 where not handled correctly in roles
2433 - added tests for this
2435 * Moose::Meta::Class
2436 - fixed issue where extending metaclasses with
2437 roles would blow up. Thanks to Aankhen`` for
2438 finding this insidious error, and it's solution.
2440 ~~ lots of spelling and grammer fixes in the docs,
2441 many many thanks to rlb3 and Aankhen for these :)
2443 0.20 Friday, April 6th, 2007
2444 >> I messed up the SKIP logic in one test
2445 so this release is just to fix that.
2448 - 'has' now also accepts an ARRAY ref
2449 to create multiple attrs (see docs)
2450 (thanks to konobi for this)
2451 - added tests and docs
2453 0.19 Thurs. April 5th, 2007
2454 ~~ More documentation updates ~~
2456 * Moose::Util::TypeConstraints
2457 - 'type' now supports messages as well
2458 thanks to phaylon for finding this
2459 - added tests for this
2460 - added &list_all_type_constraints and
2461 &list_all_builtin_type_constraints
2462 functions to facilitate introspection.
2464 * Moose::Meta::Attribute
2465 - fixed regexp 'handles' declarations
2466 to build the list of delegated methods
2467 correctly (and not override important
2468 things like &new) thanks to ashleyb
2470 - added tests and docs for this
2471 - added the 'documentation' attributes
2472 so that you can actually document your
2473 attributes and inspect them through the
2475 - added tests and docs for this
2477 * Moose::Meta::Class
2478 - when loading custom attribute metaclasses
2479 it will first look in for the class in the
2480 Moose::Meta::Attribute::Custom::$name, and
2481 then default to just loading $name.
2482 - added tests and docs for this
2484 * Moose::Meta::TypeConstraint
2485 - type constraints now stringify to their names.
2486 - added test for this
2489 - added tests to assure we work with Module::Refresh
2490 - added stricter test skip logic in the Moose POOP
2491 test, ask Rob Kinyon why.
2492 - *cough* DBM::Deep 1.0 backwards compatibility sucks *cough* ;)
2494 0.18 Sat. March 10, 2007
2495 ~~ Many, many documentation updates ~~
2498 - We now use Class::MOP::load_class to
2500 - added tests to show types and subtypes
2501 working with Declare::Constraints::Simple
2502 and Test::Deep as constraint engines.
2505 !! You must have Class::MOP 0.37_001 !!
2506 !! for this developer release to work !!
2508 This release was primarily adding the immutable
2509 feature to Moose. An immutable class is one which
2510 you promise not to alter. When you set the class
2511 as immutable it will perform various bits of
2512 memoization and inline certain part of the code
2513 (constructors, destructors and accessors). This
2514 minimizes (and in some cases totally eliminates)
2515 one of Moose's biggest performance hits. This
2516 feature is not on by default, and is 100% optional.
2517 It has several configurable bits as well, so you
2518 can pick and choose to your specific needs.
2520 The changes involved in this were fairly wide and
2521 highly specific, but 100% backwards compatible, so
2522 I am not going to enumerate them here. If you are
2523 truely interested in what was changed, please do
2526 0.17 Tues. Nov. 14, 2006
2527 * Moose::Meta::Method::Accessor
2528 - bugfix for read-only accessors which
2529 are have a type constraint and lazy.
2530 Thanks to chansen for finding it.
2532 0.16 Tues. Nov. 14, 2006
2534 There are some speed improvements in this release,
2535 but they are only the begining, so stay tuned.
2538 - BUILDALL and DEMOLISHALL no longer get
2539 called unless they actually need to be.
2540 This gave us a signifigant speed boost
2541 for the cases when there is no BUILD or
2542 DEMOLISH method present.
2544 * Moose::Util::TypeConstraints
2545 * Moose::Meta::TypeConstraint
2546 - added an 'optimize_as' option to the
2547 type constraint, which allows for a
2548 hand optimized version of the type
2549 constraint to be used when possible.
2550 - Any internally created type constraints
2551 now provide an optimized version as well.
2553 0.15 Sun. Nov. 5, 2006
2555 This version of Moose *must* have Class::MOP 0.36 in order
2556 to work correctly. A number of small internal tweaks have
2557 been made in order to be compatible with that release.
2559 * Moose::Util::TypeConstraints
2560 - added &unimport so that you can clean out
2561 your class namespace of these exported
2564 * Moose::Meta::Class
2565 - fixed minor issue which occasionally
2566 comes up during global destruction
2568 - moved Moose::Meta::Method::Overriden into
2572 - moved Moose::Meta::Role::Method into
2575 * Moose::Meta::Attribute
2576 - changed how we do type checks so that
2577 we reduce the overall cost, but still
2580 - moved accessor generation methods to
2581 Moose::Meta::Method::Accessor to
2582 conform to the API changes from
2585 * Moose::Meta::TypeConstraint
2586 - changed how constraints are compiled
2587 so that we do less recursion and more
2588 iteration. This makes the type check
2590 - moved Moose::Meta::TypeConstraint::Union
2593 * Moose::Meta::Method::Accessor
2594 - created this from methods formerly found in
2595 Moose::Meta::Attribute
2597 * Moose::Meta::Role::Method
2598 - moved this from Moose::Meta::Role
2600 * Moose::Meta::Method::Overriden
2601 - moved this from Moose::Meta::Class
2603 * Moose::Meta::TypeConstraint::Union
2604 - moved this from Moose::Meta::TypeConstraint
2606 0.14 Mon. Oct. 9, 2006
2608 * Moose::Meta::Attribute
2609 - fixed lazy attributes which were not getting
2610 checked with the type constraint (thanks ashley)
2611 - added tests for this
2612 - removed the over-enthusiastic DWIMery of the
2613 automatic ArrayRef and HashRef defaults, it
2614 broke predicates in an ugly way.
2615 - removed tests for this
2617 0.13 Sat. Sept. 30, 2006
2619 This version of Moose *must* have Class::MOP 0.35 in order
2620 to work correctly. A number of small internal tweaks have
2621 been made in order to be compatible with that release.
2624 - Removed the use of UNIVERSAL::require to be a better
2625 symbol table citizen and remove a dependency
2626 (thanks Adam Kennedy)
2628 **~~ removed experimental & undocumented feature ~~**
2629 - commented out the 'method' and 'self' keywords, see the
2630 comments for more info.
2633 - added a FAQ and WTF files to document frequently
2634 asked questions and common problems
2636 * Moose::Util::TypeConstraints
2637 - added GlobRef and FileHandle type constraint
2638 - added tests for this
2640 * Moose::Meta::Attribute
2641 - if your attribute 'isa' ArrayRef of HashRef, and you have
2642 not explicitly set a default, then make the default DWIM.
2643 This will also work for subtypes of ArrayRef and HashRef
2645 - you can now auto-deref subtypes of ArrayRef or HashRef too.
2646 - new test added for this (thanks to ashley)
2649 - added basic support for runtime role composition
2650 but this is still *highly experimental*, so feedback
2651 is much appreciated :)
2652 - added tests for this
2654 * Moose::Meta::TypeConstraint
2655 - the type constraint now handles the coercion process
2656 through delegation, this is to support the coercion
2659 * Moose::Meta::TypeConstraint::Union
2660 - it is now possible for coercions to be performed
2662 - added tests for this (thanks to konobi)
2664 * Moose::Meta::TypeCoercion
2665 - properly capturing error when type constraint
2669 - Scalar::Util 1.18 is bad on Win32, so temporarily
2670 only require version 1.17 for Win32 and cygwin.
2671 (thanks Adam Kennedy)
2673 0.12 Sat. Sept. 1, 2006
2675 - Recipe5 (subtypes & coercion) has been written
2678 - fixed "bad meta" error message to be more descriptive
2679 - fixed &unimport to not remove the &inner and &super
2680 keywords because we need to localize them.
2681 - fixed number of spelling/grammer issues, thanks Theory :)
2683 **~~ experimental & undocumented feature ~~**
2684 - added the method and self keywords, they are basically
2685 just sugar, and they may not stay around.
2688 - added &dump method to easily Data::Dumper
2691 * Moose::Meta::TypeConstraint
2692 - added the &is_a_type_of method to check both the current
2693 and the subtype of a method (similar to &isa with classes)
2696 - this is now a subclass of Class::MOP::Module, and no longer
2697 creates the _role_meta ugliness of before.
2698 - fixed tests to reflect this change
2700 0.11 Wed. July 12, 2006
2702 - added an &unimport method to remove all the keywords
2703 that Moose will import, simply add 'no Moose' to the
2704 bottom of your class file.
2707 - fixed some test failures caused by a forgotten test
2710 0.10 Thurs. July 6, 2006
2712 - improved error message when loading modules so
2713 it is less confusing when you load a role.
2714 - added &calculate_all_roles method to
2715 Moose::Meta::Class and Moose::Meta::Role
2718 This module has been tested against Class::MOP 0.30
2719 but it does not yet utilize the optimizations
2720 it makes available. Stay tuned for that ;)
2722 0.09_03 Fri. June 23, 2006
2723 ++ DEVELOPER RELEASE ++
2725 - 'use strict' and 'use warnings' are no longer
2726 needed in Moose classes, Moose itself will
2727 turn them on for you.
2728 - added tests for this
2729 - moved code from exported subs to private methods
2730 in Moose::Meta::Class
2733 - as with Moose, strict and warnings are
2734 automatically turned on for you.
2735 - added tests for this
2738 - now handles an edge case for override errors
2739 - added tests for this
2740 - added some more edge case tests
2742 0.09_02 Tues. May 16, 2006
2743 ++ DEVELOPER RELEASE ++
2745 - added prototypes to the exported subs
2749 - added prototypes to the exported subs
2752 * Moose::Util::TypeConstraints
2753 - cleaned up prototypes for the subs
2756 0.09_01 Fri. May 12, 2006
2757 ++ DEVELOPER RELEASE ++
2758 - This release works in combination with
2759 Class::MOP 0.29_01, it is a developer
2760 release because it uses the a new
2761 instance sub-protocol and a fairly
2762 complete Role implementation. It has
2763 not yet been optimized, so it slower
2764 the the previous CPAN version. This
2765 release also lacks good updated docs,
2766 the official release will have updated docs.
2769 - refactored the keyword exports
2770 - 'with' now checks Role validaity and
2771 accepts more than one Role at a time
2772 - 'extends' makes metaclass adjustments as
2773 needed to ensure metaclass compatibility
2776 - refactored the keyword exports
2777 - 'with' now checks Role validaity and
2778 accepts more than one Role at a time
2780 * Moose::Util::TypeConstraints
2781 - added the 'enum' keyword for simple
2782 string enumerations which can be used as
2784 - see example of usage in t/202_example.t
2787 - more careful checking of params to new()
2790 - much work done on the role composition
2791 - many new tests for conflict detection
2792 and composition edge cases
2793 - not enough documentation, I suggest
2794 looking at the tests
2796 * Moose::Meta::Instance
2797 - added new Instance metaclass to support
2798 the new Class::MOP instance protocol
2800 * Moose::Meta::Class
2801 - some small changes to support the new
2803 - some small additions to support Roles
2805 * Moose::Meta::Attribute
2806 - some improvements to the accessor generation code
2808 - some small changes to support the new
2810 - (still somewhat) experimental delegation support
2811 with the 'handles' option
2812 - added several tests for this
2813 - no docs for this yet
2815 0.05 Thurs. April 27, 2006
2817 - keywords are now exported with Sub::Exporter
2818 thanks to chansen for this commit
2819 - has keyword now takes a 'metaclass' option
2820 to support custom attribute meta-classes
2821 on a per-attribute basis
2822 - added tests for this
2823 - the 'has' keyword not accepts inherited slot
2824 specifications (has '+foo'). This is still an
2825 experimental feature and probably not finished
2826 see t/038_attribute_inherited_slot_specs.t for
2827 more details, or ask about it on #moose
2828 - added tests for this
2831 - keywords are now exported with Sub::Exporter
2833 * Moose::Utils::TypeConstraints
2834 - reorganized the type constraint hierarchy, thanks
2835 to nothingmuch and chansen for his help and advice
2837 - added some tests for this
2838 - keywords are now exported with Sub::Exporter
2839 thanks to chansen for this commit
2841 * Moose::Meta::Class
2842 - due to changes in Class::MOP, we had to change
2843 construct_instance (for the better)
2845 * Moose::Meta::Attribute
2846 - due to changes in Class::MOP, we had to add the
2847 initialize_instance_slot method (it's a good thing)
2849 * Moose::Meta::TypeConstraint
2850 - added type constraint unions
2851 - added tests for this
2852 - added the is_subtype_of predicate method
2853 - added tests for this
2855 0.04 Sun. April 16th, 2006
2857 - Roles can now consume other roles
2858 - added tests for this
2859 - Roles can specify required methods now with
2860 the requires() keyword
2861 - added tests for this
2864 - ripped out much of it's guts ,.. much cleaner now
2865 - added required methods and correct handling of
2866 them in apply() for both classes and roles
2867 - added tests for this
2868 - no longer adds a does() method to consuming classes
2869 it relys on the one in Moose::Object
2870 - added roles attribute and some methods to support
2871 roles consuming roles
2873 * Moose::Meta::Attribute
2874 - added support for triggers on attributes
2875 - added tests for this
2876 - added support for does option on an attribute
2877 - added tests for this
2879 * Moose::Meta::Class
2880 - added support for attribute triggers in the
2882 - added tests for this
2885 - Moose no longer creates a subtype for your class
2886 if a subtype of the same name already exists, this
2887 should DWIM in 99.9999% of all cases
2889 * Moose::Util::TypeConstraints
2890 - fixed bug where incorrect subtype conflicts were
2892 - added test for this
2895 - this class can now be extended with 'use base' if
2896 you need it, it properly loads the metaclass class now
2897 - added test for this
2899 0.03_02 Wed. April 12, 2006
2901 - you must now explictly use Moose::Util::TypeConstraints
2902 it no longer gets exported for you automatically
2905 - new() now accepts hash-refs as well as key/value lists
2906 - added does() method to check for Roles
2907 - added tests for this
2909 * Moose::Meta::Class
2910 - added roles attribute along with the add_role() and
2912 - added tests for this
2915 - now adds a does() method to consuming classes
2916 which tests the class's hierarchy for roles
2917 - added tests for this
2919 0.03_01 Mon. April 10, 2006
2921 - added new Role recipe (no content yet, only code)
2924 - added 'with' keyword for Role support
2925 - added test and docs for this
2926 - fixed subtype quoting bug
2927 - added test for this
2931 - added test and docs
2933 * Moose::Util::TypeConstraints
2934 - added the message keyword to add custom
2935 error messages to type constraints
2938 - the meta role to support Moose::Role
2939 - added tests and docs
2941 * Moose::Meta::Class
2942 - moved a number of things from Moose.pm
2943 to here, they should have been here
2946 * Moose::Meta::Attribute
2947 - moved the attribute option macros here
2948 instead of putting them in Moose.pm
2950 * Moose::Meta::TypeConstraint
2951 - added the message attributes and the
2953 - added tests and docs for this
2955 0.03 Thurs. March 30, 2006
2957 - added the Moose::Cookbook with 5 recipes,
2958 describing all the stuff Moose can do.
2961 - fixed an issue with &extends super class loading
2962 it now captures errors and deals with inline
2963 packages correctly (bug found by mst, solution
2965 - added super/override & inner/augment features
2966 - added tests and docs for these
2969 - BUILDALL now takes a reference of the %params
2970 that are passed to &new, and passes that to
2973 * Moose::Util::TypeConstraints
2974 - Type constraints now survive runtime reloading
2975 - added test for this
2977 * Moose::Meta::Class
2978 - fixed the way attribute defaults are handled
2979 during instance construction (bug found by chansen)
2981 * Moose::Meta::Attribute
2982 - read-only attributes now actually enforce their
2983 read-only-ness (this corrected in Class::MOP as
2986 0.02 Tues. March 21, 2006
2988 - many more tests, fixing some bugs and
2990 - &extends now loads the base module with
2992 - added UNIVERSAL::require to the
2995 - each new Moose class will also create
2996 and register a subtype of Object which
2997 correspond to the new Moose class.
2998 - the 'isa' option in &has now only
2999 accepts strings, and will DWIM in
3002 * Moose::Util::TypeConstraints
3003 - added type coercion features
3004 - added tests for this
3005 - added support for this in attributes
3006 and instance construction
3008 - type construction no longer creates a
3009 function, it registers the type instead.
3010 - added several functions to get the
3014 - BUILDALL and DEMOLISHALL were broken
3015 because of a mis-named hash key, Whoops :)
3017 * Moose::Meta::Attribute
3018 - adding support for coercion in the
3019 autogenerated accessors
3021 * Moose::Meta::Class
3022 - adding support for coercion in the
3023 instance construction
3025 * Moose::Meta::TypeConstraint
3026 * Moose::Meta::TypeCoercion
3027 - type constraints and coercions are now
3028 full fledges meta-objects
3030 0.01 Wed. March 15, 2006
3031 - Moooooooooooooooooose!!!