1 Revision history for Perl extension Moose
4 * Moose::Meta::Method::Accessor
5 - If an attribute had a lazy default, and that value did not
6 pass the attribute's type constraint, it did not get the
7 message from the type constraint, instead using a generic
8 message. Test provided by perigrin.
10 * Moose::Util::TypeConstraints
11 - Add duck_type keyword. It's sugar over making sure an object
12 can() a list of methods. This is easier than jrockway's suggestion
13 to fork all of CPAN. (perigrin)
14 - add tests and documentation (perigrin)
16 0.73 Fri, March 29, 2009
17 * No changes from 0.72_01.
19 0.72_01 Thu, March 26, 2009
21 - Almost every module has complete API documentation. A few
22 methods (and even whole classes) have been intentionally
23 excluded pending some rethinking of their APIs.
25 * Moose::Util::TypeConstraints
26 - Calling subtype with a name as the only argument is now an
27 exception. If you want an anonymous subtype do:
29 my $subtype = subtype as 'Foo';
31 * Moose::Cookbook::Meta::Recipe7
32 - A new recipe, creating a custom meta-instance class.
34 * Moose::Cookbook::Basics::Recipe5
35 - Fix various typos and mistakes. Includes a patch from Radu
38 * Moose::Cookbook::Basics::Recipe9
39 - Link to this recipe from Moose.pm's builder blurb
42 - When wrapping a function with a prototype, Moose::Exporter now
43 makes sure the wrapped function still has the same
44 prototype. (Daisuke Maki)
46 * Moose::Meta::Attribute
47 - Allow a subclass to set lazy_build for an inherited
48 attribute. (Dieter Pearcey)
51 - Explicitly depend on Data::OptList. We already had this dependency
52 via Sub::Exporter, but since we're using it directly we're
53 better off with it listed. (Sartak)
55 * Moose::Meta::Method::Constructor
56 - Make it easier to subclass the inlining behaviour. (Ash
59 * Moose::Manual::Delta
60 - Details significant changes in the history of Moose, along
61 with recommended workarounds.
63 * Moose::Manual::Contributing
64 - Contributor's guide to Moose.
66 * Moose::Meta::Method::Constructor
67 - The long-deprecated intialize_body method has been removed
68 (yes, spelled like that).
70 * Moose::Meta::Method::Destructor
71 - This is_needed method is now always a class method.
74 - Changes to the internals of how make_immutable works to match
75 changes in latest Class::MOP.
77 0.72 Mon, February 23, 2009
79 * Moose::Meta::Method::Constructor
80 - A mutable class accepted Foo->new(undef) without complaint,
81 while an immutable class would blow up with an unhelpful
82 error. Now, in both cases we throw a helpful error
83 instead. Reported by doy.
85 0.71_01 Sun, February 22, 2009
87 - Hopefully fixed some POD errors in a few recipes that caused
88 them to display weird on search.cpan.org.
90 * Moose::Util::TypeConstraints
91 - Calling type or subtype without the sugar helpers (as, where,
92 message) is now deprecated.
93 - The subtype function tried hard to guess what you meant, but
94 often got it wrong. For example:
96 my $subtype = subtype as 'ArrayRef[Object]';
98 This caused an error in the past, but now works as you'd
102 - Make sure Moose.pm is loaded before calling
103 Moose->throw_error. This wasn't normally an issue, but could
104 bite you in weird cases.
106 0.71 Thu, February 19, 2009
107 * Moose::Cookbook::Basics::Recipe11
108 - A new recipe which demonstrates the use of BUILDARGS and
111 * Moose::Cookbook::Roles::Recipe3
112 - A new recipe, applying a role to an object instance. (Dave
116 - Allow overriding specific keywords from "also" packages. (doy)
119 - Replace hardcoded cookbook tests with Test::Inline to ensure
120 the tests match the actual code in the recipes. (Dave Rolsky)
123 - Working on the above turned up a number of little bugs in the
124 recipe code. (Dave Rolsky)
126 * Moose::Util::TypeConstraints::Optimized
127 - Just use Class::MOP for the optimized ClassName check. (Dave
130 0.70 Sat, February 14, 2009
131 * Moose::Util::TypeConstraints
132 - Added the RoleName type (stevan)
133 - added tests for this (stevan)
135 * Moose::Cookbook::Basics::Recipe3
136 - Updated the before qw[left right] sub to be a little more
137 defensive about what it accepts (stevan)
138 - added more tests to t/000_recipies/basics/003_binary_tree.t
142 - We now always call DEMOLISHALL, even if a class does not
143 define DEMOLISH. This makes sure that method modifiers on
144 DEMOLISHALL work as expected. (doy)
145 - added tests for this (EvanCarroll)
147 * Moose::Util::MetaRole
148 - Accept roles for the wrapped_method_metaclass (rafl)
149 - added tests for this (rafl)
151 * Moose::Meta::Attribute
152 - We no longer pass the meta-attribute object as a final
153 argument to triggers. This actually changed for inlined code a
154 while back, but the non-inlined version and the docs were
158 - Some tests tried to use Test::Warn 0.10, which had bugs. Now
159 they require 0.11. (Dave Rolsky)
162 - Lots of small changes to the manual, cookbook, and
163 elsewhere. These were based on feedback from various
164 users, too many to list here. (Dave Rolsky)
166 0.69 Thu, February 12, 2009
168 - Make some keyword errors use throw_error instead of croak
169 since Moose::Exporter wraps keywords now (Sartak)
172 - Revised every recipe for style and clarity. Also moved some
173 documentation out of cookbook recipes and into Moose::Manual
174 pages. This work was funded as part of the Moose docs grant
175 from TPF. (Dave Rolsky)
177 * Moose::Meta::Method::Delegation
178 - If the attribute doing the delegation was not populated, the
179 error message did not specify the attribute name
182 0.68 Wed, February 4, 2009
184 - Many spelling, typo, and formatting fixes by daxim.
186 * Moose::Manual::Attributes
187 - The NAME section in the POD used "Attribute" so search.cpan
188 didn't resolve links from other documents properly.
190 * Moose::Meta::Method::Overriden
191 - Now properly spelled as Overridden. Thanks to daxim for
194 0.67 Tue, February 3, 2009
196 - Lots of little typo fixes and a few clarifications. Several
197 pages didn't have proper titles, and so weren't actually
198 visible on search.cpan.org. Thanks to hanekomu for a variety
199 of fixes and formatting improvements.
201 0.66 Tue, February 3, 2009
203 - This is a brand new, extensive manual for Moose. This aims to
204 provide a complete introduction to all of Moose's
205 features. This work was funded as part of the Moose docs grant
206 from TPF. (Dave Rolsky)
208 * Moose::Meta::Attribute
209 - Added a delegation_metaclass method to replace a hard-coded
210 use of Moose::Meta::Method::Delegation. (Dave Rolsky)
212 * Moose::Util::TypeConstraints
213 - If you created a subtype and passed a parent that Moose didn't
214 know about, it simply ignored the parent. Now it automatically
215 creates the parent as a class type. This may not be what you
216 want, but is less broken than before. (Dave Rolsky)
218 * Moose::Util::TypeConstraints
219 - This module tried throw errors by calling Moose->throw_error,
220 but it did not ensure that Moose was loaded first. This could
221 cause very unhelpful errors when it tried to throw an error
222 before Moose was loaded. (Dave Rolsky)
224 * Moose::Util::TypeConstraints
225 - You could declare a name with subtype such as "Foo!Bar" that
226 would be allowed, but if you used it in a parameterized type
227 such as "ArrayRef[Foo!Bar]" it wouldn't work. We now do some
228 vetting on names created via the sugar functions, so that they
229 can only contain alphanumerics, ":", and ".". (Dave Rolsky)
231 0.65 Thu, January 22, 2008
232 * Moose and Moose::Meta::Method::Overridden
233 - If an overridden method called super(), and then the
234 superclass's method (not overridden) _also_ called super(),
235 Moose went into an endless recursion loop. Test provided by
236 Chris Prather. (Dave Rolsky)
238 * Moose::Meta::TypeConstraint
239 - All methods are now documented. (gphat)
241 * t/100_bugs/011_DEMOLISH_eats_exceptions.t
242 - Fixed some bogus failures that occurred because we tried to
243 validate filesystem paths in a very ad-hoc and
244 not-quite-correct way. (Dave Rolsky)
246 * Moose::Util::TypeConstraints
247 - Added maybe_type to exports. See docs for details. (rjbs)
250 - Added Moose::Util::TypeConstraints to the SEE ALSO
254 - Methods created via an attribute can now fulfill a "requires"
255 declaration for a role. (nothingmuch)
257 * Moose::Meta::Method::*
258 - Stack traces from inlined code will now report its line and
259 file as being in your class, as opposed to in Moose
262 0.64 Wed, December 31, 2008
263 * Moose::Meta::Method::Accessor
264 - Always inline predicate and clearer methods (Sartak)
266 * Moose::Meta::Attribute
267 - Support for parameterized traits (Sartak)
268 - verify_against_type_constraint method to avoid duplication
269 and enhance extensibility (Sartak)
272 - Tests (but no support yet) for parameterized traits (Sartak)
275 - Require Class::MOP 0.75+, which has the side effect of making
276 sure we work on Win32. (Dave Rolsky)
278 0.63 Mon, December 8, 2008
280 - Some small grammar tweaks and bug fixes in non-Moose example
283 0.62_02 Fri, December 5, 2008
284 * Moose::Meta::Role::Application::ToClass
285 - When a class does not provide all of a role's required
286 methods, the error thrown now mentions all of the missing
287 methods, as opposed to just the first one found. Requested by
288 Curtis Poe (RT #41119). (Dave Rolsky)
290 * Moose::Meta::Method::Constructor
291 - Moose will no longer inline a constructor for your class
292 unless it inherits its constructor from Moose::Object, and
293 will warn when it doesn't inline. If you want to force
294 inlining anyway, pass "replace_constructor => 1" to
295 make_immutable. Addresses RT #40968, reported by Jon
296 Swartz. (Dave Rolsky)
297 - The quoting of default values could be broken if the default
298 contained a single quote ('). Now we use quotemeta to escape
299 anything potentially dangerous in the defaults. (Dave Rolsky)
301 0.62_01 Wed, December 3, 2008
303 - use the method->execute API for BUILDALL
304 and DEMOLISHALL (Sartak)
306 * Moose::Util::TypeConstraints
307 - We now make all the type constraint meta classes immutable
308 before creating the default types provided by Moose. This
309 should make loading Moose a little faster. (Dave Rolsky)
311 0.62 Wed November 26, 2008
312 * Moose::Meta::Role::Application::ToClass
313 Moose::Meta::Role::Application::ToRole
314 - fixed issues where excluding and aliasing the
315 same methods for a single role did not work
316 right (worked just fine with multiple
318 - added test for this (stevan)
320 * Moose::Meta::Role::Application::RoleSummation
321 - fixed the error message when trying to compose
322 a role with a role it excludes (Sartak)
325 - Catch another case where recursion caused the value
326 of $CALLER to be stamped on (t0m)
327 - added test for this (t0m)
330 - Remove the make_immutable keyword, which has been
331 deprecated since April. It breaks metaclasses that
332 use Moose without no Moose (Sartak)
334 * Moose::Meta::Attribute
335 - Removing an attribute from a class now also removes delegation
336 (handles) methods installed for that attribute (t0m)
337 - added test for this (t0m)
339 * Moose::Meta::Method::Constructor
340 - An attribute with a default that looked like a number (but was
341 really a string) would accidentally be treated as a number
342 when the constructor was made immutable (perigrin)
343 - added test for this (perigrin)
346 - create method for constructing a role
348 - added test for this (Sartak)
349 - anonymous roles! (Sartak)
350 - added test for this (Sartak)
353 - more consistent error messages (Sartak)
355 * Moose::Cookbook::Roles::Recipe1
356 - attempt to explain why a role that just requires
357 methods is useful (Sartak)
359 0.61 Fri November 7, 2008
360 * Moose::Meta::Attribute
361 - When passing a role to handles, it will be loaded if necessary
365 - Method objects returned by get_method (and other methods)
366 Could end up being returned without an associated_metaclass
367 attribute. Removing get_method_map, which is provided by
368 Class::MOP::Class, fixed this. The Moose version did nothing
369 different from its parent except introduce a bug. (Dave Rolsky)
370 - added tests for this (jdv79)
373 - Added a $VERSION to all .pm files which didn't have one. Fixes
374 RT #40049, reported by Adam Kennedy. (Dave Rolsky)
376 * Moose::Cookbook::Basics::Recipe4
377 * Moose::Cookbook::Basics::Recipe6
378 - These files had spaces on the first line of the SYNOPSIS, as
379 opposed to a totally empty line. According to RT #40432, this
380 confuses POD parsers. (Dave Rolsky)
382 0.60 Fri October 24, 2008
384 - Passing "-traits" when loading Moose caused the Moose.pm
385 exports to be broken. Reported by t0m. (Dave Rolsky)
386 - Tests for this bug. (t0m)
389 - Change resolve_metaclass alias to use the new
390 load_first_existing_class function. This makes it a lot
391 simpler, and also around 5 times faster. (t0m)
392 - Add caching to resolve_metaclass_alias, which gives an order
393 of magnitude speedup to things which repeatedly call the
394 Moose::Meta::Attribute->does method, notably MooseX::Storage
397 * Moose::Util::TypeConstraint
398 - Put back the changes for parameterized constraints that
399 shouldn't have been removed in 0.59. We still cannot parse
400 them, but MooseX modules can create them in some other
401 way. See the 0.58 changes for more details. (jnapiorkowski)
402 - Changed the way subtypes are created so that the job is
403 delegated to a type constraint parent. This clears up some
404 hardcoded checking and should allow correct subtypes of
405 Moose::Meta::Type::Constraint. Don't rely on this new API too
406 much (create_child_type) because it may go away in the
407 future. (jnapiorkowski)
409 * Moose::Meta::TypeConstraint::Union
410 - Type constraint names are sorted as strings, not numbers.
413 * Moose::Meta::TypeConstraint::Parameterizable
414 - New parameterize method. This can be used as a factory method
415 to make a new type constraint with a given parameterized
416 type. (jnapiorkowski)
417 - added tests (jnapiorkowski)
419 0.59 Tue October 14, 2008
421 - Add abridged documentation for builder/default/initializer/
422 predicate, and link to more details sections in
423 Class::MOP::Attribute. (t0m)
425 * Moose::Util::TypeConstraints
426 - removed prototypes from all but the &-based stuff (mst)
428 * Moose::Util::TypeConstraints
429 - Creating a anonymous subtype with both a constraint and a
430 message failed with a very unhelpful error, but should just
431 work. Reported by t0m. (Dave Rolsky)
434 - Some tests that used Test::Warn if it was available failed
435 with older versions of Test::Warn. Reported by Fayland. (Dave
437 - Test firing behavior of triggers in relation to builder/default/
439 - Test behavior of equals/is_a_type_of/is_a_subtype_of for all
440 kinds of supported type. (t0m)
443 - In create(), do not pass "roles" option to the superclass
444 - added related test that creates an anon metaclass with
447 * Moose::Meta::TypeConstraint::Class
448 * Moose::Meta::TypeConstraint::Role
449 - Unify behavior of equals/is_a_type_of/is_a_subtype_of with
450 other types (as per change in 0.55_02). (t0m)
452 * Moose::Meta::TypeConstraint::Registry
453 - Fix warning when dealing with unknown type names (t0m)
455 * Moose::Util::TypeConstraints
456 - Reverted changes from 0.58 related to handle parameterized
457 types. This caused random failures on BSD and Win32 systems,
458 apparently related to the regex engine. This means that Moose
459 can no longer parse structured type constraints like
460 ArrayRef[Int,Int] or HashRef[name=>Str]. This will be
461 supported in a slightly different way via MooseX::Types some
462 time in the future. (Dave Rolsky)
464 0.58 Sat September 20, 2008
465 !! This release has an incompatible change regarding !!
466 !! how roles add methods to a class !!
468 * Roles and role application
469 ! Roles now add methods by calling add_method, not
470 alias_method. They make sure to always provide a method
471 object, which will be cloned internally. This means that it is
472 now possible to track the source of a method provided by a
473 role, and even follow its history through intermediate roles.
475 This means that methods added by a role now show up when
476 looking at a class's method list/map. (Dave Rolsky)
479 - From this release on, we'll try to maintain a list of
480 conflicting modules, and warn you if you have one
481 installed. For example, this release conflicts with ...
482 - MooseX::Singleton <= 0.11
483 - MooseX::Params::Validate <= 0.05
486 In general, we try to not break backwards compatibility for
487 most Moose users, but MooseX modules and other code which
488 extends Moose's metaclasses is often affected by very small
489 changes in the Moose internals.
491 * Moose::Meta::Method::Delegation
492 * Moose::Meta::Attribute
493 - Delegation methods now have their own method class. (Dave
496 * Moose::Meta::TypeConstraint::Parameterizable
497 - Added a new method 'parameterize' which is basically a factory
498 for the containing constraint. This makes it easier to create
499 new types of parameterized constraints. (jnapiorkowski)
501 * Moose::Meta::TypeConstraint::Union
502 - Changed the way Union types canonicalize their names to follow
503 the normalized TC naming rules, which means we strip all
504 whitespace. (jnapiorkowski)
506 * Moose::Util::TypeConstraints
507 - Parameter and Union args are now sorted, this makes Int|Str
508 the same constraint as Str|Int. (jnapiorkowski)
509 - Changes to the way Union types are parsed to more correctly
510 stringify their names. (jnapiorkowski)
511 - When creating a parameterized type, we now use the new
512 parameterize method. (jnapiorkowski)
513 - Incoming type constraint strings are now normalized to remove
514 all whitespace differences. (jnapiorkowski)
515 - Changed the way we parse type constraint strings so that we now
516 match TC[Int,Int,...] and TC[name=>Str] as parameterized type
517 constraints. This lays the foundation for more flexible type
518 constraint implementations.
520 * Tests and docs for all the above. (jnapiorkowski)
524 - Moose::Exporter will no longer remove a subroutine that the
525 exporting package re-exports. Moose re-exports the
526 Carp::confess function, among others. The reasoning is that we
527 cannot know whether you have also explicitly imported those
528 functions for your own use, so we err on the safe side and
529 always keep them. (Dave Rolsky)
530 - added tests for this (rafl)
533 - Changes to how we fix metaclass compatibility that are much
534 too complicated to go into. The summary is that Moose is much
535 less likely to complain about metaclass incompatibility
536 now. In particular, if two metaclasses differ because
537 Moose::Util::MetaRole was used on the two corresponding
538 classes, then the difference in roles is reconciled for the
539 subclass's metaclass. (Dave Rolsky)
540 - Squashed an warning in _process_attribute (thepler)
543 - throw exceptions (sooner) for invalid attribute names (thepler)
544 - added tests for this (thepler)
546 * Moose::Util::MetaRole
547 - If you explicitly set a constructor or destructor class for a
548 metaclass object, and then applied roles to the metaclass,
549 that explicitly set class would be lost and replaced with the
553 * Moose::Meta::Attribute
554 * Moose::Meta::Method
557 * Moose::Error::Default
558 * Moose::Error::Croak
559 * Moose::Error::Confess
560 - All instances of confess() changed to use overridable
561 C<throw_error> method. This method ultimately calls a class
562 constructor, and you can change the class being called. In
563 addition, errors now pass more information than just a string.
564 The default C<error_class> behaves like C<Carp::confess>, so
565 the behavior is not visibly different for end users.
567 0.57 Wed September 3, 2008
569 - A new bit of doc intended to introduce folks familiar with
570 "standard" Perl 5 OO to Moose concepts. (Dave Rolsky)
573 - Shows examples of two classes, each done first with and then
574 without Moose. This makes a nice parallel to
575 Moose::Intro. (Dave Rolsky)
577 * Moose::Util::TypeConstraints
578 - Fixed a bug in find_or_parse_type_constraint so that it
579 accepts a Moose::Meta::TypeConstraint object as the parent
580 type, not just a name (jnapiorkowski)
581 - added tests (jnapiorkowski)
584 - If Sub::Name was not present, unimporting failed to actually
585 remove some sugar subs, causing test failures (Dave Rolsky)
587 0.56 Mon September 1, 2008
588 For those not following the series of dev releases, there are
589 several major changes in this release of Moose.
590 ! Moose::init_meta should now be called as a method. See the
593 - Major performance improvements by nothingmuch.
595 - New modules for extension writers, Moose::Exporter and
596 Moose::Util::MetaRole by Dave Rolsky.
598 - Lots of doc improvements and additions, especially in the
603 * Removed all references to the experimental-but-no-longer-needed
604 Moose::Meta::Role::Application::ToMetaclassInstance.
606 * Require Class::MOP 0.65.
608 0.55_04 Sat August 30, 2008
609 * Moose::Util::MetaRole
610 * Moose::Cookbook::Extending::Recipe2
611 - This simplifies the application of roles to any meta class, as
612 well as the base object class. Reimplemented metaclass traits
613 using this module. (Dave Rolsky)
615 * Moose::Cookbook::Extending::Recipe1
616 - This a new recipe, an overview of various ways to write Moose
617 extensions (Dave Rolsky)
619 * Moose::Cookbook::Extending::Recipe3
620 * Moose::Cookbook::Extending::Recipe4
621 - These used to be Extending::Recipe1 and Extending::Recipe2,
624 0.55_03 Fri August 29, 2008
625 * No changes from 0.55_02 except increasing the Class::MOP
626 dependency to 0.64_07.
628 0.55_02 Fri August 29, 2008
629 * Makefile.PL and Moose.pm
630 - explicitly require Perl 5.8.0+ (Dave Rolsky)
632 * Moose::Util::TypeConstraints
633 - Fix warnings from find_type_constraint if the type is not
636 * Moose::Meta::TypeConstraint
637 - Predicate methods (equals/is_a_type_of/is_subtype_of) now
638 return false if the type you specify cannot be found in the
639 type registry, rather than throwing an unhelpful and
640 coincidental exception. (t0m).
641 - added docs & test for this (t0m)
643 * Moose::Meta::TypeConstraint::Registry
644 - add_type_constraint now throws an exception if a parameter is
646 - added docs & test for this (t0m)
648 * Moose::Cookbook::FAQ
649 - Added a faq entry on the difference between "role" and "trait"
653 - Fixed a bug that caused role composition to not see a required
654 method when that method was provided by another role being
655 composed at the same time. (Dave Rolsky)
656 - test and bug finding (tokuhirom)
658 0.55_01 Wed August 20, 2008
660 !! Calling Moose::init_meta as a function is now !!
661 !! deprecated. Please see the Moose.pm docs for details. !!
663 * Moose::Meta::Method::Constructor
664 - Fix inlined constructor so that values produced by default
665 or builder methods are coerced as required. (t0m)
666 - added test for this (t0m)
668 * Moose::Meta::Attribute
669 - A lazy attribute with a default or builder did not attempt to
670 coerce the default value. The immutable code _did_
672 - added test for this (t0m)
675 - This is a new helper module for writing "Moose-alike"
676 modules. This should make the lives of MooseX module authors
677 much easier. (Dave Rolsky)
680 * Moose::Cookbook::Meta::Recipe5
681 - Implemented metaclass traits (and wrote a recipe for it):
683 use Moose -traits => 'Foo'
685 This should make writing small Moose extensions a little
688 * Moose::Cookbook::Basics::Recipe1
689 - Removed any examples of direct hashref access, and applied an
690 editorial axe to reduce verbosity. (Dave Rolsky)
692 * Moose::Cookbook::Basics::Recipe1
693 - Also applied an editorial axe here. (Dave Rolsky)
696 * Moose::Cookbook::Extending::Recipe1
697 * Moose::Cookbook::Extending::Recipe2
698 - Rewrote extending and embedding moose documentation and
699 recipes to use Moose::Exporter (Dave Rolsky)
703 - These two modules now warn when you load them from the main
704 package "main" package, because we will not export sugar to
705 main. Previously it just did nothing. (Dave Rolsky)
708 - Now provide an init_meta method just like Moose.pm, and you
709 can call this to provide an alternate role metaclass. (Dave
710 Rolsky and nothingmuch)
711 - get_method_map now respects the package cache flag (nothingmuch)
714 - Two new methods - add_method and wrap_method_body
718 - Optimizations including allowing constructors to accept hash
719 refs, making many more classes immutable, and making
720 constructors immutable. (nothingmuch)
722 0.55 Sun August 3, 2008
723 * Moose::Meta::Attribute
724 - breaking down the way 'handles' methods are
725 created so that the process can be more easily
726 overridden by subclasses (stevan)
728 * Moose::Meta::TypeConstraint
729 - fixing what is passed into a ->message with
730 the type constraints (RT #37569)
731 - added tests for this (Charles Alderman)
733 * Moose::Util::TypeConstraints
734 - fix coerce to accept anon types like subtype can (mst)
737 - reorganized the recipes into sections - Basics, Roles, Meta,
738 Extending - and wrote abstracts for each section (Dave Rolsky)
740 * Moose::Cookbook::Basics::Recipe10
741 - A new recipe that demonstrates operator overloading
742 in combination with Moose. (bluefeet)
744 * Moose::Cookbook::Meta::Recipe1
745 - an introduction to what meta is and why you'd want to make
746 your own metaclass extensions (Dave Rolsky)
748 * Moose::Cookbook::Meta::Recipe4
749 - a very simple metaclass example (Dave Rolsky)
751 * Moose::Cookbook::Extending::Recipe1
752 - how to write a Moose-alike module to use your own object base
755 * Moose::Cookbook::Extending::Recipe2
756 - how to write modules with an API just like C<Moose.pm> (Dave
760 - Tons of fixes, both syntactical and grammatical (Dave
761 Rolsky, Paul Fenwick)
763 0.54 Thurs. July 3, 2008
764 ... this is not my day today ...
766 * Moose::Meta::Attribute
767 - fixed legal_options_for_inheritance such that
768 clone_and_inherit options still works for
769 Class::MOP::Attribute objects and therefore
770 does not break MooseX::AttributeHelpers
773 0.53 Thurs. July 3, 2008
774 * Whoops, I guess I should run 'make manifest' before
775 actually releasing the module. No actual changes
776 in this release, except the fact that it includes
777 the changes that I didn't include in the last
780 0.52 Thurs. July 3, 2008
782 - added "FEATURE REQUESTS" section to the Moose docs
783 to properly direct people (stevan) (RT #34333)
784 - making 'extends' croak if it is passed a Role since
785 this is not ever something you want to do
786 (fixed by stevan, found by obra)
787 - added tests for this (stevan)
790 - adding support for DOES (as in UNIVERSAL::DOES)
792 - added test for this
794 * Moose::Meta::Attribute
795 - added legal_options_for_inheritance (wreis)
796 - added tests for this (wreis)
798 * Moose::Cookbook::Snacks::*
799 - removed some of the unfinished snacks that should
800 not have been released yet. Added some more examples
801 to the 'Keywords' snack. (stevan)
803 * Moose::Cookbook::Style
804 - added general Moose "style guide" of sorts to the
805 cookbook (nothingmuch) (RT #34335)
808 - added more BUILDARGS tests (stevan)
810 0.51 Thurs. Jun 26, 2008
812 - add unimport so "no Moose::Role" actually does
815 * Moose::Meta::Role::Application::ToRole
816 - when RoleA did RoleB, and RoleA aliased a method from RoleB in
817 order to provide its own implementation, that method still got
818 added to the list of required methods for consumers of
819 RoleB. Now an aliased method is only added to the list of
820 required methods if the role doing the aliasing does not
821 provide its own implementation. See Recipe 11 for an example
822 of all this. (Dave Rolsky)
823 - added tests for this
825 * Moose::Meta::Method::Constructor
826 - when a single argument that wasn't a hashref was provided to
827 an immutabilized constructor, the error message was very
828 unhelpful, as opposed to the non-immutable error. Reported by
830 - added test for this (Dave Rolsky)
832 * Moose::Meta::Attribute
833 - added support for meta_attr->does("ShortAlias") (sartak)
834 - added tests for this (sartak)
835 - moved the bulk of the `handles` handling to the new
836 install_delegation method (Stevan)
839 - Added BUILDARGS, a new step in new()
841 * Moose::Meta::Role::Application::RoleSummation
842 - fix typos no one ever sees (sartak)
844 * Moose::Util::TypeConstraints
845 * Moose::Meta::TypeConstraint
846 * Moose::Meta::TypeCoercion
847 - Attempt to work around the ??{ } vs. threads issue
849 - Some null_constraint optimizations
851 0.50 Thurs. Jun 11, 2008
852 - Fixed a version number issue by bumping all modules
855 0.49 Thurs. Jun 11, 2008
856 !! This version now approx. 20-25% !!
857 !! faster with new Class::MOP 0.59 !!
859 * Moose::Meta::Attribute
860 - fixed how the is => (ro|rw) works with
861 custom defined reader, writer and accessor
863 - added docs for this (TODO).
864 - added tests for this (Thanks to Penfold)
865 - added the custom attribute alias for regular
866 Moose attributes which is "Moose"
867 - fix builder and default both being used
872 Moose::Meta::Attribute
874 Moose::Meta::Role::Composite
875 Moose::Util::TypeConstraints
876 - switched usage of reftype to ref because
880 - changing add_package_symbol to use the new
884 - fixed how DEMOLISHALL is called so that it
885 can be overrided in subclasses (thanks to Sartak)
886 - added test for this (thanks to Sartak)
888 * Moose::Util::TypeConstraints
889 - move the ClassName type check code to
890 Class::MOP::is_class_loaded (thanks to Sartak)
892 * Moose::Cookbook::Recipe11
893 - add tests for this (thanks to tokuhirom)
895 0.48 Thurs. May 29, 2008
896 (early morning release engineering)--
898 - fixing the version in Moose::Meta::Method::Destructor
899 which was causing the indexer to choke
901 0.47 Thurs. May 29, 2008
902 (late night release engineering)--
904 - fixing the version is META.yml, no functional
905 changes in this release
907 0.46 Wed. May 28, 2008
908 !! This version now approx. 20-25% !!
909 !! faster with new Class::MOP 0.57 !!
912 - some optimizations of the &initialize method
913 since it is called so often by &meta
917 - now use the get_all_package_symbols from the
918 updated Class::MOP, test suite is now 10 seconds
921 * Moose::Meta::Method::Destructor
922 - is_needed can now also be called as a class
923 method for immutablization to check if the
924 destructor object even needs to be created
927 * Moose::Meta::Method::Destructor
928 Moose::Meta::Method::Constructor
929 - added more descriptive error message to help
930 keep people from wasting time tracking an error
931 that is easily fixed by upgrading.
933 0.45 Saturday, May 24, 2008
935 - Because of work in Class::MOP 0.57, all
936 XS based functionality is now optional
937 and a Pure Perl version is supplied
938 - the CLASS_MOP_NO_XS environment variable
939 can now be used to force non-XS versions
941 - several of the packages have been tweaked
942 to take care of this, mostly we added
943 support for the package_name and name
944 variables in all the Method metaclasses
945 - before/around/after method modifiers now
946 support regexp matching of names
947 (thanks to Takatoshi Kitano)
948 - tests added for this
949 - NOTE: this only works for classes, it
950 is currently not supported in roles,
951 but, ... patches welcome
952 - All usage of Carp::confess have been replaced
953 by Carp::croak in the "keyword" functions since
954 the stack trace is usually not helpful
957 - All usage of Carp::confess have been replaced
958 by Carp::croak in the "keyword" functions since
959 the stack trace is usually not helpful
960 - The 'has' keyword for roles now accepts the
961 same array ref form that Moose.pm does
962 (has [qw/foo bar/] => (is => 'rw', ...))
963 - added test for this
965 * Moose::Meta::Attribute
966 - trigger on a ro-attribute is no longer an
967 error, as it's useful to trigger off of the
971 - added same 'add_package_symbol' fix as in
975 - does_role now handles non-Moose classes
977 - added tests for this
978 - added the 'add_method_modifier' function
979 (thanks to Takatoshi Kitano)
981 * Moose::Util::TypeConstraints
982 - subtypes of parameterizable types now are
983 themselves parameterizable types
985 * Moose::Meta::Method::Constructor
986 - fixed bug where trigger was not being
987 called by the inlined immutable
989 - added test for this (thanks to Caelum)
991 * Moose::Meta::Role::Application::ToInstance
992 - now uses the metaclass of the instance
993 (if possible) to create the anon-class
994 (thanks Jonathan Rockway)
996 * Moose::Cookbook::Recipe22
997 - added the meta-attribute trait recipe
1001 - fixed hash-ordering test bug that was
1002 causing occasional cpantester failures
1003 - renamed the t/000_recipe/*.t tests to be
1004 more descriptive (thanks to Sartak)
1006 0.44 Sat. May 10, 2008
1008 - made make_immutable warning cluck to
1009 show where the error is (thanks mst)
1012 - BUILDALL and DEMOLISHALL now call
1013 ->body when looping through the
1014 methods, to avoid the overloaded
1016 - fixed issue where DEMOLISHALL was
1017 eating the $@ values, and so not
1018 working correctly, it still kind of
1019 eats them, but so does vanilla perl
1020 - added tests for this
1022 * Moose::Cookbook::Recipe7
1023 - added new recipe for immutable
1024 functionality (thanks Dave Rolsky)
1026 * Moose::Cookbook::Recipe9
1027 - added new recipe for builder and
1028 lazy_build (thanks Dave Rolsky)
1030 * Moose::Cookbook::Recipe11
1031 - added new recipe for method aliasing
1032 and exclusion with Roles (thanks Dave Rolsky)
1035 - fixed Win32 test failure (thanks spicyjack)
1037 ~ removed Build.PL and Module::Build compat
1038 since Module::Install has done that.
1040 0.43 Wed. April, 30, 2008
1042 drink more coffee before
1043 doing release engineering
1045 - whoops, forgot to do the smolder tests,
1046 and we broke some of the custom meta-attr
1047 modules. This fixes that.
1049 0.42 Mon. April 28, 2008
1050 - some bad tests slipped by, nothing else
1051 changed in this release (cpantesters++)
1053 - upped the Class::MOP dependency to 0.55
1054 since we have tests which need the C3
1057 0.41 Mon. April 28, 2008
1058 ~~ numerous documentation updates ~~
1060 - Changed all usage of die to Carp::croak for better
1061 error reporting (initial patch by Tod Hagan)
1063 ** IMPORTANT NOTE **
1064 - the make_immutable keyword is now deprecated, don't
1065 use it in any new code and please fix your old code
1066 as well. There will be 2 releases, and then it will
1072 - refactored the way inner and super work to avoid
1073 any method/@ISA cache penalty (nothingmuch)
1075 * Moose::Meta::Class
1076 - fixing &new_object to make sure trigger gets the
1077 coerced value (spotted by Charles Alderman on the
1079 - added test for this
1081 * Moose::Meta::Method::Constructor
1082 - immutable classes which had non-lazy attributes were calling
1083 the default generating sub twice in the constructor. (bug
1084 found by Jesse Luehrs, fixed by Dave Rolsky)
1085 - added tests for this (Dave Rolsky)
1086 - fix typo in initialize_body method (nothingmuch)
1088 * Moose::Meta::Method::Destructor
1089 - fix typo in initialize_body method (nothingmuch)
1091 * Moose::Meta::Method::Overriden
1092 Moose::Meta::Method::Augmented
1093 - moved the logic for these into their own
1094 classes (nothingmuch)
1096 * Moose::Meta::Attribute
1097 - inherited attributes may now be extended without
1098 restriction on the type ('isa', 'does') (Sartak)
1099 - added tests for this (Sartak)
1100 - when an attribute property is malformed (such as lazy without
1101 a default), give the name of the attribute in the error
1103 - added the &applied_traits and &has_applied_traits methods
1104 to allow introspection of traits
1105 - added tests for this
1106 - moved 'trait' and 'metaclass' argument handling to here from
1108 - clone_and_inherit_options now handles 'trait' and 'metaclass' (has
1109 '+foo' syntax) (nothingmuch)
1110 - added tests for this (t0m)
1113 - localize $@ inside DEMOLISHALL to avoid it
1114 eating $@ (found by Ernesto)
1115 - added test for this (thanks to Ernesto)
1117 * Moose::Util::TypeConstraints
1118 - &find_type_constraint now DWIMs when given an
1119 type constraint object or name (nothingmuch)
1120 - &find_or_create_type_constraint superseded with a number of more
1122 - find_or_create_{isa,does}_type_constraint
1123 - find_or_parse_type_constraint
1125 * Moose::Meta::TypeConstraint
1126 Moose::Meta::TypeConstraint::Class
1127 Moose::Meta::TypeConstraint::Role
1128 Moose::Meta::TypeConstraint::Enum
1129 Moose::Meta::TypeConstraint::Union
1130 Moose::Meta::TypeConstraint::Parameterized
1131 - added the &equals method for comparing two type
1132 constraints (nothingmuch)
1133 - added tests for this (nothingmuch)
1135 * Moose::Meta::TypeConstraint
1136 - add the &parents method, which is just an alias to &parent.
1137 Useful for polymorphism with TC::{Class,Role,Union} (nothingmuch)
1139 * Moose::Meta::TypeConstraint::Class
1140 - added the class attribute for introspection purposes
1142 - added tests for this
1144 * Moose::Meta::TypeConstraint::Enum
1145 Moose::Meta::TypeConstraint::Role
1146 - broke these out into their own classes (nothingmuch)
1148 * Moose::Cookbook::Recipe*
1149 - fixed references to test file locations in the POD
1150 and updated up some text for new Moose features
1154 - Added &resolve_metaclass_alias, a helper function for finding an actual
1155 class for a short name (e.g. in the traits list)
1157 0.40 Fri. March 14, 2008
1158 - I hate Pod::Coverage
1160 0.39 Fri. March 14, 2008
1162 - documenting the use of '+name' with attributes
1163 that come from recently composed roles. It makes
1164 sense, people are using it, and so why not just
1165 officially support it.
1166 - fixing the 'extends' keyword so that it will not
1167 trigger Ovid's bug (http://use.perl.org/~Ovid/journal/35763)
1170 - added the perl -Moose=+Class::Name feature to allow
1171 monkeypatching of classes in one liners
1174 - fixing the 'apply_all_roles' keyword so that it will not
1175 trigger Ovid's bug (http://use.perl.org/~Ovid/journal/35763)
1177 * Moose::Meta::Class
1178 - added ->create method which now supports roles (thanks to jrockway)
1179 - added tests for this
1180 - added ->create_anon_class which now supports roles and caching of
1181 the results (thanks to jrockway)
1182 - added tests for this
1183 - made ->does_role a little more forgiving when it is
1184 checking a Class::MOP era metaclasses.
1186 * Moose::Meta::Role::Application::ToInstance
1187 - it is now possible to pass extra params to be used when
1188 a role is applied to an the instance (rebless_params)
1189 - added tests for this
1191 * Moose::Util::TypeConstraints
1192 - class_type now accepts an optional second argument for a
1193 custom message. POD anotated accordingly (groditi)
1194 - added tests for this
1195 - it is now possible to make anon-enums by passing 'enum' an
1196 ARRAY ref instead of the $name => @values. Everything else
1198 - added tests for this
1201 - making test for using '+name' on attributes consumed
1202 from a role, it works and makes sense too.
1204 * Moose::Meta::Attribute
1205 - fix handles so that it doesn't return nothing
1206 when the method cannot be found, not sure why
1207 it ever did this originally, this means we now
1208 have slightly better support for AUTOLOADed
1210 - added more delegation tests
1211 - adding ->does method to this so as to better
1212 support traits and their introspection.
1213 - added tests for this
1216 - localizing the Data::Dumper configurations so
1217 that it does not pollute others (RT #33509)
1218 - made ->does a little more forgiving when it is
1219 passed Class::MOP era metaclasses.
1221 0.38 Fri. Feb. 15, 2008
1222 * Moose::Meta::Attribute
1223 - fixed initializer to correctly do
1224 type checking and coercion in the
1226 - added tests for this
1229 - fixed some finicky tests (thanks to konobi)
1231 0.37 Thurs. Feb. 14, 2008
1233 - fixed some details in Moose::init_meta
1234 and its superclass handling (thanks thepler)
1235 - added tests for this (thanks thepler)
1236 - 'has' now dies if you don't pass in name
1238 - added the 'make_immutable' keyword as a shortcut
1241 * Moose::Meta::Class
1242 Moose::Meta::Method::Constructor
1243 Moose::Meta::Attribute
1244 - making (init_arg => undef) work here too
1245 (thanks to nothingmuch)
1247 * Moose::Meta::Attribute
1248 Moose::Meta::Method::Constructor
1249 Moose::Meta::Method::Accessor
1250 - make lazy attributes respect attr initializers (rjbs)
1251 - added tests for this
1253 * Moose::Util::TypeConstraints
1254 Moose::Util::TypeConstraints::OptimizedConstraints
1255 Moose::Meta::TypeConstraints
1256 Moose::Meta::Attribute
1257 Moose::Meta::Method::Constructor
1258 Moose::Meta::Method::Accessor
1259 - making type errors use the
1260 assigned message (thanks to Sartak)
1261 - added tests for this
1263 * Moose::Meta::Method::Destructor
1264 - making sure DESTROY gets inlined properly
1265 with successive DEMOLISH calls (thanks to manito)
1267 * Moose::Meta::Attribute
1268 Moose::Meta::Method::Accessor
1269 - fixed handling of undef with type constraints
1271 - added tests for this
1274 - added &get_all_init_args and &get_all_attribute_values
1275 (thanks to Sartak and nothingmuch)
1277 0.36 Sat. Jan. 26, 2008
1279 Moose::Meta::Attribute
1280 - role type tests now support when roles are
1281 applied to non-Moose classes (found by ash)
1282 - added tests for this (thanks to ash)
1283 - couple extra tests to boost code coverage
1285 * Moose::Meta::Method::Constructor
1286 - improved fix for handling Class::MOP attributes
1287 - added test for this
1289 * Moose::Meta::Class
1290 - handled the add_attribute($attribute_meta_object)
1292 - added test for this
1294 0.35 Tues. Jan. 22, 2008
1295 * Moose::Meta::Method::Constructor
1296 - fix to make sure even Class::MOP attributes
1297 are handled correctly (Thanks to Dave Rolsky)
1298 - added test for this (also Dave Rolsky)
1300 * Moose::Meta::Class
1301 - improved error message on _apply_all_roles,
1302 you should now use Moose::Util::apply_all_roles
1303 and you shouldnt have been using a _ prefixed
1304 method in the first place ;)
1306 0.34 Mon. Jan. 21, 2008
1307 ~~~ more misc. doc. fixes ~~~
1308 ~~ updated copyright dates ~~
1310 Moose is now a postmodern object system :)
1311 - (see the POD for details)
1313 * <<Role System Refactoring>>
1314 - this release contains a major reworking and
1315 cleanup of the role system
1316 - 100% backwards compat.
1317 - Role application now restructured into seperate
1318 classes based on type of applicants
1319 - Role summation (combining of more than one role)
1320 is much cleaner and anon-classes are no longer
1321 used in this process
1322 - new Composite role metaclass
1323 - runtime application of roles to instances
1324 is now more efficient and re-uses generated
1325 classes when applicable
1327 * <<New Role composition features>>
1328 - methods can now be excluded from a given role
1330 - methods can now be aliased to another name (and
1331 still retain the original as well)
1333 * Moose::Util::TypeConstraints::OptimizedConstraints
1334 - added this module (see above)
1336 * Moose::Meta::Class
1337 - fixed the &_process_attribute method to be called
1338 by &add_attribute, so that the API is now correct
1340 * Moose::Meta::Method::Accessor
1341 - fixed bug when passing a list of values to
1342 an accessor would get (incorrectly) ignored.
1343 Thanks to Sartak for finding this ;)
1344 - added tests for this (Sartak again)
1346 * Moose::Meta::Method::Accessor
1347 Moose::Meta::Method::Constructor
1348 Moose::Meta::Attribute
1349 Moose::Meta::TypeConstraint
1350 Moose::Meta::TypeCoercion
1351 - lots of cleanup of such things as:
1353 - type constraint handling
1354 - error handling/messages
1355 (thanks to nothingmuch)
1357 * Moose::Meta::TypeConstraint::Parameterizable
1358 - added this module to support the refactor
1359 in Moose::Meta::TypeConstraint::Parameterized
1361 * Moose::Meta::TypeConstraint::Parameterized
1362 - refactored how these types are handled so they
1363 are more generic and not confined to ArrayRef
1367 - shortened some file names for better VMS support (RT #32381)
1369 0.33 Fri. Dec. 14, 2007
1370 !! Moose now loads 2 x faster !!
1371 !! with new Class::MOP 0.49 !!
1373 ++ new oose.pm module to make command line
1374 Moose-ness easier (see POD docs for more)
1376 * Moose::Meta::Class
1378 - several tweaks to take advantage of the
1379 new method map caching in Class::MOP
1381 * Moose::Meta::TypeConstraint::Parameterized
1382 - allow subtypes of ArrayRef and HashRef to
1383 be used as a container (sartak)
1384 - added tests for this
1385 - basic support for coercion to ArrayRef and
1386 HashRef for containers (sartak)
1387 - added tests for this
1389 * Moose::Meta::TypeCoercion
1390 - coercions will now create subtypes as needed
1391 so you can now add coercions to parameterized
1392 types without having to explictly define them
1393 - added tests for this
1395 * Moose::Meta::Method::Accessor
1396 - allow subclasses to decide whether we need
1397 to copy the value into a new variable (sartak)
1399 0.32 Tues. Dec. 4, 2007
1400 * Moose::Util::TypeConstraints
1401 - fixing how subtype aliases of unions work
1402 they should inherit the parent's coercion
1403 - added tests for this
1404 - you can now define multiple coercions on
1405 a single type at different times instead of
1406 having to do it all in one place
1407 - added tests for this
1409 * Moose::Meta::TypeConstraint
1410 - there is now a default constraint of sub { 1 }
1411 instead of Moose::Util::TypeConstraints setting
1414 * Moose::Meta::TypeCoercion
1415 * Moose::Meta::TypeCoercion::Union
1416 - added the &has_coercion_for_type and
1417 &add_type_coercions methods to support the
1418 new features above (although you cannot add
1419 more type coercions for Union types)
1421 0.31 Mon. Nov. 26, 2007
1422 * Moose::Meta::Attribute
1423 - made the +attr syntax handle extending types with
1424 parameters. So "has '+foo' => (isa => 'ArrayRef[Int]')"
1425 now works if the original foo is an ArrayRef.
1426 - added tests for this.
1427 - delegation now works even if the attribute does not
1428 have a reader method using the get_read_method_ref
1429 method from Class::MOP::Attribute.
1430 - added tests for this
1431 - added docs for this
1433 * Moose::Util::TypeConstraints
1434 - passing no "additional attribute info" to
1435 &find_or_create_type_constraint will no longer
1436 attempt to create an __ANON__ type for you,
1437 instead it will just return undef.
1438 - added docs for this
1440 0.30 Fri. Nov. 23, 2007
1441 * Moose::Meta::Method::Constructor
1442 -builder related bug in inlined constructor. (groditi)
1444 * Moose::Meta::Method::Accessor
1445 - genereate unnecessary calls to predicates and refactor
1446 code generation for runtime speed (groditi)
1448 * Moose::Util::TypeConstraints
1449 - fix ClassName constraint to introspect symbol table (mst)
1450 - added more tests for this (mst)
1451 - fixed it so that subtype 'Foo' => as 'HashRef[Int]' ...
1452 with work correctly.
1453 - added tests for this
1456 - adding the link to Recipie 11 (written by Sartak)
1457 - adding test for SYNOPSIS code
1460 - New tests for builder bug. Upon instantiation, if an
1461 attribute had a builder, no value and was not lazy the
1462 builder default was not getting run, oops. (groditi)
1464 0.29 Tues. Nov. 13, 2007
1465 * Moose::Meta::Attribute
1466 - Fix error message on missing builder method (groditi)
1468 * Moose::Meta::Method::Accessor
1469 - Fix error message on missing builder method (groditi)
1472 - Add test to check for the correct error message when
1473 builder method is missing (groditi)
1475 0.28 Tues. Nov. 13, 2007
1476 - 0.27 packaged incorrectly (groditi)
1478 0.27 Tues. Nov. 13, 2007
1479 * Moose::Meta::Attribute
1480 - Added support for the new builder option (groditi)
1481 - Added support for lazy_build option (groditi)
1482 - Changed slot initialization for predicate changes (groditi)
1484 * Moose::Meta::Method::Accessor
1485 - Added support for lazy_build option (groditi)
1486 - Fix inline methods to work with corrected predicate
1489 * Moose::Meta::Method::Constructor
1490 - Added support for lazy_build option (groditi)
1493 - tests for builder and lazy_build (groditi)
1495 * fixing some misc. bits in the docs that
1496 got mentioned on CPAN Forum & perlmonks
1499 - fixed how required methods are handled
1500 when they encounter overriden or modified
1501 methods from a class (thanks to confound).
1502 - added tests for this
1504 * Moose::Util::TypeConstraint
1505 - fixed the type notation parser so that
1506 the | always creates a union and so is
1507 no longer a valid type char (thanks to
1508 konobi, mugwump and #moose for working
1510 - added more tests for this
1512 0.26 Thurs. Sept. 27, 2007
1515 * Parameterized Types
1516 We now support parameterized collection types, such as:
1517 ArrayRef[Int] # array or integers
1518 HashRef[Object] # a hash with object values
1519 They can also be nested:
1520 ArrayRef[HashRef[RegexpRef]] # an array of hashes with regex values
1521 And work with the type unions as well:
1522 ArrayRef[Int | Str] # array of integers of strings
1524 * Better Framework Extendability
1525 Moose.pm is now "extendable" such that it is now much
1526 easier to extend the framework and add your own keywords
1527 and customizations. See the "EXTENDING AND EMBEDDING MOOSE"
1528 section of the Moose.pm docs.
1531 In an effort to begin documenting some of the various
1532 details of Moose as well as some common idioms, we have
1533 created Moose::Cookbook::Snacks as a place to find
1534 small (easily digestable) nuggets of Moose code.
1537 ~ Several doc updates/cleanup thanks to castaway ~
1539 - converted build system to use Module::Install instead of
1540 Module::Build (thanks to jrockway)
1543 - added all the meta classes to the immutable list and
1544 set it to inline the accessors
1545 - fix import to allow Sub::Exporter like { into => }
1546 and { into_level => } (perigrin)
1547 - exposed and documented init_meta() to allow better
1548 embedding and extending of Moose (perigrin)
1551 - complete re-organization of the test suite
1552 - added some new tests as well
1553 - finally re-enabled the Moose::POOP test since
1554 the new version of DBM::Deep now works again
1557 * Moose::Meta::Class
1558 - fixed very odd and very nasty recursion bug with
1560 - added tests for this (eilara)
1562 * Moose::Meta::Attribute
1563 Moose::Meta::Method::Constructor
1564 Moose::Meta::Method::Accessor
1565 - fixed issue with overload::Overloaded getting called
1566 on non-blessed items. (RT #29269)
1567 - added tests for this
1569 * Moose::Meta::Method::Accessor
1570 - fixed issue with generated accessor code making
1571 assumptions about hash based classes (thanks to dexter)
1573 * Moose::Coookbook::Snacks
1574 - these are bits of documentation, not quite as big as
1575 Recipes but which have no clear place in the module docs.
1576 So they are Snacks! (horray for castaway++)
1578 * Moose::Cookbook::Recipe4
1579 - updated it to use the new ArrayRef[MyType] construct
1580 - updated the accompanying test as well
1582 +++ Major Refactor of the Type Constraint system +++
1583 +++ with new features added as well +++
1585 * Moose::Util::TypeConstraint
1586 - no longer uses package variable to keep track of
1587 the type constraints, now uses the an instance of
1588 Moose::Meta::TypeConstraint::Registry to do it
1589 - added more sophisticated type notation parsing
1591 - added tests for this
1593 * Moose::Meta::TypeConstraint
1594 - some minor adjustments to make subclassing easier
1595 - added the package_defined_in attribute so that we
1596 can track where the type constraints are created
1598 * Moose::Meta::TypeConstraint::Union
1599 - this is now been refactored to be a subclass of
1600 Moose::Meta::TypeConstraint
1602 * Moose::Meta::TypeCoercion::Union
1603 - this has been added to service the newly refactored
1604 Moose::Meta::TypeConstraint::Union and is itself
1605 a subclass of Moose::Meta::TypeCoercion
1607 * Moose::Meta::TypeConstraint::Parameterized
1608 - added this module (taken from MooseX::AttributeHelpers)
1609 to help construct nested collection types
1610 - added tests for this
1612 * Moose::Meta::TypeConstraint::Registry
1613 - added this class to keep track of type constraints
1615 0.25 Mon. Aug. 13, 2007
1617 - Documentation update to reference Moose::Util::TypeConstraints
1618 under 'isa' in 'has' for how to define a new type
1619 (thanks to shlomif).
1621 * Moose::Meta::Attribute
1622 - required attributes now will no longer accept undef
1623 from the constructor, even if there is a default and lazy
1624 - added tests for this
1625 - default subroutines must return a value which passes the
1627 - added tests for this
1629 * Moose::Meta::Attribute
1630 * Moose::Meta::Method::Constructor
1631 * Moose::Meta::Method::Accessor
1632 - type-constraint tests now handle overloaded objects correctly
1633 in the error message
1634 - added tests for this (thanks to EvanCarroll)
1636 * Moose::Meta::TypeConstraint::Union
1637 - added (has_)hand_optimized_constraint to this class so that
1638 it behaves as the regular Moose::Meta::TypeConstraint does.
1641 - large refactoring of this code
1642 - added several more tests
1643 - tests for subtle conflict resolition issues
1644 added, but not currently running
1647 * Moose::Cookbook::Recipe7
1648 - added new recipe for augment/inner functionality
1650 - added test for this
1653 - a formal definition of roles (still in progress)
1656 - utilities for easier working with Moose classes
1657 - added tests for these
1660 - This contains Moose specific test functions
1661 - added tests for these
1663 0.24 Tues. July 3, 2007
1664 ~ Some doc updates/cleanup ~
1666 * Moose::Meta::Attribute
1667 - added support for roles to be given as parameters
1668 to the 'handles' option.
1669 - added tests and docs for this
1670 - the has '+foo' attribute form now accepts changes to
1671 the lazy option, and the addition of a handles option
1672 (but not changing the handles option)
1673 - added tests and docs for this
1676 - required methods are now fetched using find_method_by_name
1677 so that required methods can come from superclasses
1678 - adjusted tests for this
1680 0.23 Mon. June 18, 2007
1681 * Moose::Meta::Method::Constructor
1682 - fix inlined constructor for hierarchy with multiple BUILD methods (mst)
1683 * Moose::Meta::Class
1684 - Modify make_immutable to work with the new Class::MOP immutable
1685 mechanism + POD + very basic test (groditi)
1686 * Moose::Meta::Attribute
1687 - Fix handles to use goto() so that caller() comes out properly on
1688 the other side (perigrin)
1690 0.22 Thurs. May 31, 2007
1691 * Moose::Util::TypeConstraints
1692 - fix for prototype undeclared issue when Moose::Util::TypeConstraints
1693 loaded before consumers (e.g. Moose::Meta::Attribute) by predeclaring
1694 prototypes for functions
1695 - added the ClassName type constraint, this checks for strings
1696 which will respond true to ->isa(UNIVERSAL).
1697 - added tests and docs for this
1698 - subtyping just in name now works correctly by making the
1699 default for where be { 1 }
1700 - added test for this
1702 * Moose::Meta::Method::Accessor
1703 - coerce and lazy now work together correctly, thanks to
1704 merlyn for finding this bug
1705 - tests added for this
1706 - fix reader presedence bug in Moose::Meta::Attribute + tests
1709 - Foo->new(undef) now gets ignored, it is assumed you meant to pass
1710 a HASH-ref and missed. This produces better error messages then
1711 having it die cause undef is not a HASH.
1712 - added tests for this
1714 0.21 Thursday, May 2nd, 2007
1716 - added SUPER_SLOT and INNER_SLOT class hashes to support unimport
1717 - modified unimport to remove super and inner along with the rest
1718 - altered unimport tests to handle this
1721 - altered super export to populate SUPER_SLOT
1723 * Moose::Meta::Class
1724 - altered augment and override modifier application to use *_SLOT
1725 - modified tests for these to unimport one test class each to test
1728 - fixed issue where custom attribute metaclasses
1729 where not handled correctly in roles
1730 - added tests for this
1732 * Moose::Meta::Class
1733 - fixed issue where extending metaclasses with
1734 roles would blow up. Thanks to Aankhen`` for
1735 finding this insidious error, and it's solution.
1737 ~~ lots of spelling and grammer fixes in the docs,
1738 many many thanks to rlb3 and Aankhen for these :)
1740 0.20 Friday, April 6th, 2007
1741 >> I messed up the SKIP logic in one test
1742 so this release is just to fix that.
1745 - 'has' now also accepts an ARRAY ref
1746 to create multiple attrs (see docs)
1747 (thanks to konobi for this)
1748 - added tests and docs
1750 0.19 Thurs. April 5th, 2007
1751 ~~ More documentation updates ~~
1753 * Moose::Util::TypeConstraints
1754 - 'type' now supports messages as well
1755 thanks to phaylon for finding this
1756 - added tests for this
1757 - added &list_all_type_constraints and
1758 &list_all_builtin_type_constraints
1759 functions to facilitate introspection.
1761 * Moose::Meta::Attribute
1762 - fixed regexp 'handles' declarations
1763 to build the list of delegated methods
1764 correctly (and not override important
1765 things like &new) thanks to ashleyb
1767 - added tests and docs for this
1768 - added the 'documentation' attributes
1769 so that you can actually document your
1770 attributes and inspect them through the
1772 - added tests and docs for this
1774 * Moose::Meta::Class
1775 - when loading custom attribute metaclasses
1776 it will first look in for the class in the
1777 Moose::Meta::Attribute::Custom::$name, and
1778 then default to just loading $name.
1779 - added tests and docs for this
1781 * Moose::Meta::TypeConstraint
1782 - type constraints now stringify to their names.
1783 - added test for this
1786 - added tests to assure we work with Module::Refresh
1787 - added stricter test skip logic in the Moose POOP
1788 test, ask Rob Kinyon why.
1789 - *cough* DBM::Deep 1.0 backwards compatibility sucks *cough* ;)
1791 0.18 Sat. March 10, 2007
1792 ~~ Many, many documentation updates ~~
1795 - We now use Class::MOP::load_class to
1797 - added tests to show types and subtypes
1798 working with Declare::Constraints::Simple
1799 and Test::Deep as constraint engines.
1802 !! You must have Class::MOP 0.37_001 !!
1803 !! for this developer release to work !!
1805 This release was primarily adding the immutable
1806 feature to Moose. An immutable class is one which
1807 you promise not to alter. When you set the class
1808 as immutable it will perform various bits of
1809 memoization and inline certain part of the code
1810 (constructors, destructors and accessors). This
1811 minimizes (and in some cases totally eliminates)
1812 one of Moose's biggest performance hits. This
1813 feature is not on by default, and is 100% optional.
1814 It has several configurable bits as well, so you
1815 can pick and choose to your specific needs.
1817 The changes involved in this were fairly wide and
1818 highly specific, but 100% backwards compatible, so
1819 I am not going to enumerate them here. If you are
1820 truely interested in what was changed, please do
1823 0.17 Tues. Nov. 14, 2006
1824 * Moose::Meta::Method::Accessor
1825 - bugfix for read-only accessors which
1826 are have a type constraint and lazy.
1827 Thanks to chansen for finding it.
1829 0.16 Tues. Nov. 14, 2006
1831 There are some speed improvements in this release,
1832 but they are only the begining, so stay tuned.
1835 - BUILDALL and DEMOLISHALL no longer get
1836 called unless they actually need to be.
1837 This gave us a signifigant speed boost
1838 for the cases when there is no BUILD or
1839 DEMOLISH method present.
1841 * Moose::Util::TypeConstraints
1842 * Moose::Meta::TypeConstraint
1843 - added an 'optimize_as' option to the
1844 type constraint, which allows for a
1845 hand optimized version of the type
1846 constraint to be used when possible.
1847 - Any internally created type constraints
1848 now provide an optimized version as well.
1850 0.15 Sun. Nov. 5, 2006
1852 This version of Moose *must* have Class::MOP 0.36 in order
1853 to work correctly. A number of small internal tweaks have
1854 been made in order to be compatible with that release.
1856 * Moose::Util::TypeConstraints
1857 - added &unimport so that you can clean out
1858 your class namespace of these exported
1861 * Moose::Meta::Class
1862 - fixed minor issue which occasionally
1863 comes up during global destruction
1865 - moved Moose::Meta::Method::Overriden into
1869 - moved Moose::Meta::Role::Method into
1872 * Moose::Meta::Attribute
1873 - changed how we do type checks so that
1874 we reduce the overall cost, but still
1877 - moved accessor generation methods to
1878 Moose::Meta::Method::Accessor to
1879 conform to the API changes from
1882 * Moose::Meta::TypeConstraint
1883 - changed how constraints are compiled
1884 so that we do less recursion and more
1885 iteration. This makes the type check
1887 - moved Moose::Meta::TypeConstraint::Union
1890 * Moose::Meta::Method::Accessor
1891 - created this from methods formerly found in
1892 Moose::Meta::Attribute
1894 * Moose::Meta::Role::Method
1895 - moved this from Moose::Meta::Role
1897 * Moose::Meta::Method::Overriden
1898 - moved this from Moose::Meta::Class
1900 * Moose::Meta::TypeConstraint::Union
1901 - moved this from Moose::Meta::TypeConstraint
1903 0.14 Mon. Oct. 9, 2006
1905 * Moose::Meta::Attribute
1906 - fixed lazy attributes which were not getting
1907 checked with the type constraint (thanks ashley)
1908 - added tests for this
1909 - removed the over-enthusiastic DWIMery of the
1910 automatic ArrayRef and HashRef defaults, it
1911 broke predicates in an ugly way.
1912 - removed tests for this
1914 0.13 Sat. Sept. 30, 2006
1916 This version of Moose *must* have Class::MOP 0.35 in order
1917 to work correctly. A number of small internal tweaks have
1918 been made in order to be compatible with that release.
1921 - Removed the use of UNIVERSAL::require to be a better
1922 symbol table citizen and remove a dependency
1923 (thanks Adam Kennedy)
1925 **~~ removed experimental & undocumented feature ~~**
1926 - commented out the 'method' and 'self' keywords, see the
1927 comments for more info.
1930 - added a FAQ and WTF files to document frequently
1931 asked questions and common problems
1933 * Moose::Util::TypeConstraints
1934 - added GlobRef and FileHandle type constraint
1935 - added tests for this
1937 * Moose::Meta::Attribute
1938 - if your attribute 'isa' ArrayRef of HashRef, and you have
1939 not explicitly set a default, then make the default DWIM.
1940 This will also work for subtypes of ArrayRef and HashRef
1942 - you can now auto-deref subtypes of ArrayRef or HashRef too.
1943 - new test added for this (thanks to ashley)
1946 - added basic support for runtime role composition
1947 but this is still *highly experimental*, so feedback
1948 is much appreciated :)
1949 - added tests for this
1951 * Moose::Meta::TypeConstraint
1952 - the type constraint now handles the coercion process
1953 through delegation, this is to support the coercion
1956 * Moose::Meta::TypeConstraint::Union
1957 - it is now possible for coercions to be performed
1959 - added tests for this (thanks to konobi)
1961 * Moose::Meta::TypeCoercion
1962 - properly capturing error when type constraint
1966 - Scalar::Util 1.18 is bad on Win32, so temporarily
1967 only require version 1.17 for Win32 and cygwin.
1968 (thanks Adam Kennedy)
1970 0.12 Sat. Sept. 1, 2006
1972 - Recipe5 (subtypes & coercion) has been written
1975 - fixed "bad meta" error message to be more descriptive
1976 - fixed &unimport to not remove the &inner and &super
1977 keywords because we need to localize them.
1978 - fixed number of spelling/grammer issues, thanks Theory :)
1980 **~~ experimental & undocumented feature ~~**
1981 - added the method and self keywords, they are basically
1982 just sugar, and they may not stay around.
1985 - added &dump method to easily Data::Dumper
1988 * Moose::Meta::TypeConstraint
1989 - added the &is_a_type_of method to check both the current
1990 and the subtype of a method (similar to &isa with classes)
1993 - this is now a subclass of Class::MOP::Module, and no longer
1994 creates the _role_meta ugliness of before.
1995 - fixed tests to reflect this change
1997 0.11 Wed. July 12, 2006
1999 - added an &unimport method to remove all the keywords
2000 that Moose will import, simply add 'no Moose' to the
2001 bottom of your class file.
2004 - fixed some test failures caused by a forgotten test
2007 0.10 Thurs. July 6, 2006
2009 - improved error message when loading modules so
2010 it is less confusing when you load a role.
2011 - added &calculate_all_roles method to
2012 Moose::Meta::Class and Moose::Meta::Role
2015 This module has been tested against Class::MOP 0.30
2016 but it does not yet utilize the optimizations
2017 it makes available. Stay tuned for that ;)
2019 0.09_03 Fri. June 23, 2006
2020 ++ DEVELOPER RELEASE ++
2022 - 'use strict' and 'use warnings' are no longer
2023 needed in Moose classes, Moose itself will
2024 turn them on for you.
2025 - added tests for this
2026 - moved code from exported subs to private methods
2027 in Moose::Meta::Class
2030 - as with Moose, strict and warnings are
2031 automatically turned on for you.
2032 - added tests for this
2035 - now handles an edge case for override errors
2036 - added tests for this
2037 - added some more edge case tests
2039 0.09_02 Tues. May 16, 2006
2040 ++ DEVELOPER RELEASE ++
2042 - added prototypes to the exported subs
2046 - added prototypes to the exported subs
2049 * Moose::Util::TypeConstraints
2050 - cleaned up prototypes for the subs
2053 0.09_01 Fri. May 12, 2006
2054 ++ DEVELOPER RELEASE ++
2055 - This release works in combination with
2056 Class::MOP 0.29_01, it is a developer
2057 release because it uses the a new
2058 instance sub-protocol and a fairly
2059 complete Role implementation. It has
2060 not yet been optimized, so it slower
2061 the the previous CPAN version. This
2062 release also lacks good updated docs,
2063 the official release will have updated docs.
2066 - refactored the keyword exports
2067 - 'with' now checks Role validaity and
2068 accepts more than one Role at a time
2069 - 'extends' makes metaclass adjustments as
2070 needed to ensure metaclass compatibility
2073 - refactored the keyword exports
2074 - 'with' now checks Role validaity and
2075 accepts more than one Role at a time
2077 * Moose::Util::TypeConstraints
2078 - added the 'enum' keyword for simple
2079 string enumerations which can be used as
2081 - see example of usage in t/202_example.t
2084 - more careful checking of params to new()
2087 - much work done on the role composition
2088 - many new tests for conflict detection
2089 and composition edge cases
2090 - not enough documentation, I suggest
2091 looking at the tests
2093 * Moose::Meta::Instance
2094 - added new Instance metaclass to support
2095 the new Class::MOP instance protocol
2097 * Moose::Meta::Class
2098 - some small changes to support the new
2100 - some small additions to support Roles
2102 * Moose::Meta::Attribute
2103 - some improvements to the accessor generation code
2105 - some small changes to support the new
2107 - (still somewhat) experimental delegation support
2108 with the 'handles' option
2109 - added several tests for this
2110 - no docs for this yet
2112 0.05 Thurs. April 27, 2006
2114 - keywords are now exported with Sub::Exporter
2115 thanks to chansen for this commit
2116 - has keyword now takes a 'metaclass' option
2117 to support custom attribute meta-classes
2118 on a per-attribute basis
2119 - added tests for this
2120 - the 'has' keyword not accepts inherited slot
2121 specifications (has '+foo'). This is still an
2122 experimental feature and probably not finished
2123 see t/038_attribute_inherited_slot_specs.t for
2124 more details, or ask about it on #moose
2125 - added tests for this
2128 - keywords are now exported with Sub::Exporter
2130 * Moose::Utils::TypeConstraints
2131 - reorganized the type constraint hierarchy, thanks
2132 to nothingmuch and chansen for his help and advice
2134 - added some tests for this
2135 - keywords are now exported with Sub::Exporter
2136 thanks to chansen for this commit
2138 * Moose::Meta::Class
2139 - due to changes in Class::MOP, we had to change
2140 construct_instance (for the better)
2142 * Moose::Meta::Attribute
2143 - due to changes in Class::MOP, we had to add the
2144 initialize_instance_slot method (it's a good thing)
2146 * Moose::Meta::TypeConstraint
2147 - added type constraint unions
2148 - added tests for this
2149 - added the is_subtype_of predicate method
2150 - added tests for this
2152 0.04 Sun. April 16th, 2006
2154 - Roles can now consume other roles
2155 - added tests for this
2156 - Roles can specify required methods now with
2157 the requires() keyword
2158 - added tests for this
2161 - ripped out much of it's guts ,.. much cleaner now
2162 - added required methods and correct handling of
2163 them in apply() for both classes and roles
2164 - added tests for this
2165 - no longer adds a does() method to consuming classes
2166 it relys on the one in Moose::Object
2167 - added roles attribute and some methods to support
2168 roles consuming roles
2170 * Moose::Meta::Attribute
2171 - added support for triggers on attributes
2172 - added tests for this
2173 - added support for does option on an attribute
2174 - added tests for this
2176 * Moose::Meta::Class
2177 - added support for attribute triggers in the
2179 - added tests for this
2182 - Moose no longer creates a subtype for your class
2183 if a subtype of the same name already exists, this
2184 should DWIM in 99.9999% of all cases
2186 * Moose::Util::TypeConstraints
2187 - fixed bug where incorrect subtype conflicts were
2189 - added test for this
2192 - this class can now be extended with 'use base' if
2193 you need it, it properly loads the metaclass class now
2194 - added test for this
2196 0.03_02 Wed. April 12, 2006
2198 - you must now explictly use Moose::Util::TypeConstraints
2199 it no longer gets exported for you automatically
2202 - new() now accepts hash-refs as well as key/value lists
2203 - added does() method to check for Roles
2204 - added tests for this
2206 * Moose::Meta::Class
2207 - added roles attribute along with the add_role() and
2209 - added tests for this
2212 - now adds a does() method to consuming classes
2213 which tests the class's hierarchy for roles
2214 - added tests for this
2216 0.03_01 Mon. April 10, 2006
2218 - added new Role recipe (no content yet, only code)
2221 - added 'with' keyword for Role support
2222 - added test and docs for this
2223 - fixed subtype quoting bug
2224 - added test for this
2228 - added test and docs
2230 * Moose::Util::TypeConstraints
2231 - added the message keyword to add custom
2232 error messages to type constraints
2235 - the meta role to support Moose::Role
2236 - added tests and docs
2238 * Moose::Meta::Class
2239 - moved a number of things from Moose.pm
2240 to here, they should have been here
2243 * Moose::Meta::Attribute
2244 - moved the attribute option macros here
2245 instead of putting them in Moose.pm
2247 * Moose::Meta::TypeConstraint
2248 - added the message attributes and the
2250 - added tests and docs for this
2252 0.03 Thurs. March 30, 2006
2254 - added the Moose::Cookbook with 5 recipes,
2255 describing all the stuff Moose can do.
2258 - fixed an issue with &extends super class loading
2259 it now captures errors and deals with inline
2260 packages correctly (bug found by mst, solution
2262 - added super/override & inner/augment features
2263 - added tests and docs for these
2266 - BUILDALL now takes a reference of the %params
2267 that are passed to &new, and passes that to
2270 * Moose::Util::TypeConstraints
2271 - Type constraints now survive runtime reloading
2272 - added test for this
2274 * Moose::Meta::Class
2275 - fixed the way attribute defaults are handled
2276 during instance construction (bug found by chansen)
2278 * Moose::Meta::Attribute
2279 - read-only attributes now actually enforce their
2280 read-only-ness (this corrected in Class::MOP as
2283 0.02 Tues. March 21, 2006
2285 - many more tests, fixing some bugs and
2287 - &extends now loads the base module with
2289 - added UNIVERSAL::require to the
2292 - each new Moose class will also create
2293 and register a subtype of Object which
2294 correspond to the new Moose class.
2295 - the 'isa' option in &has now only
2296 accepts strings, and will DWIM in
2299 * Moose::Util::TypeConstraints
2300 - added type coercion features
2301 - added tests for this
2302 - added support for this in attributes
2303 and instance construction
2305 - type construction no longer creates a
2306 function, it registers the type instead.
2307 - added several functions to get the
2311 - BUILDALL and DEMOLISHALL were broken
2312 because of a mis-named hash key, Whoops :)
2314 * Moose::Meta::Attribute
2315 - adding support for coercion in the
2316 autogenerated accessors
2318 * Moose::Meta::Class
2319 - adding support for coercion in the
2320 instance construction
2322 * Moose::Meta::TypeConstraint
2323 * Moose::Meta::TypeCoercion
2324 - type constraints and coercions are now
2325 full fledges meta-objects
2327 0.01 Wed. March 15, 2006
2328 - Moooooooooooooooooose!!!