Moved recipes to get rid of Basic 8 as a TODO, and just let them be numbered sequenti...
[gitmo/Moose.git] / Changes
1 Also see Moose::Manual::Delta for more details of, and workarounds
2 for, noteworthy changes.
3
4 0.78
5     * Moose::Exporter
6       - Make Moose::Exporter import strict and warnings into packages
7         that use it (doy)
8
9     * Moose::Object
10       - Fix DEMOLISHALL sometimes not being able to find DEMOLISH
11         methods during global destruction (doy)
12
13 0.77 Sat, May 2, 2009
14     * Moose::Meta::Role
15       - Add explicit use of Devel::GlobalDestruction and Sub::Name
16         (perigrin)
17
18     * Moose::Object
19       - Pass a boolean to DEMOLISHALL and DEMOLISH indicating whether
20         or not we are currently in global destruction (doy)
21       - Add explicit use of Devel::GlobalDestruction and Sub::Name
22         (perigrin)
23
24     * Moose::Cookbook::FAQ
25       - Reworked much of the existing content to be more useful to
26         modern Moose hackers (Sartak)
27
28     * Makefile.PL
29       - Depend on Class::MOP 0.83 instead of 0.82_01. It seems that if
30         we use a dev version number there CPAN.pm will not follow the
31         dependency.
32
33 0.76 Mon, April 27, 2009
34     * Moose::Meta::TypeConstraint
35       - Do not run coercions in coerce() if the value already passes the type
36         constraint (hdp)
37
38     * Moose::Meta::TypeConstraint::Class
39       - In validation error messages, specifically say that the value is not
40         an instance of the class. This should alleviate some frustrating
41         forgot-to-load-my-type bugs. rt.cpan.org #44639 (Sartak)
42
43     * Moose::Meta::Role::Application::ToClass
44       - Revert the class-overrides-role warning in favor of a solution outside
45         of the Moose core (Sartak)
46
47     * Tests
48       - Make Test::Output optional again, since it's only used in a few files
49         (Sartak)
50
51 0.75_01 Thu, April 23, 2009
52     * Moose::Meta::Role::Application::ToClass
53       - Moose now warns about each class overriding methods from roles it
54         consumes (Sartak)
55
56     * Tests
57       - Warnings tests have standardized on Test::Output which is now an
58         unconditionally dependency (Sartak)
59
60     * Moose::Meta::Class
61       - Changes to immutabilization to work with Class::MOP 0.82_01+.
62
63 0.75 Mon, April 20, 2009
64     * Moose
65     * Moose::Meta::Class
66       - Move validation of not inheriting from roles from Moose::extends to
67         Moose::Meta::Class::superclasses (doy)
68
69     * Moose::Util
70       - add ensure_all_roles() function to encapsulate the common "apply this
71         role unless the object already does it" pattern (hdp)
72
73     * Moose::Exporter
74       - Users can now select a different metaclass with the "-metaclass"
75         option to import, for classes and roles (Sartak)
76
77     * Moose::Meta::Role
78       - Make method_metaclass an attr so that it can accept a metarole
79         application.  (jdv)
80
81 0.74 Tue, April 7, 2009
82     * Moose::Meta::Role
83     * Moose::Meta::Method::Destructor
84       - Include stack traces in the deprecation warnings.
85         (Florian Ragwitz)
86
87     * Moose::Meta::Class
88       - Removed the long-deprecated _apply_all_roles method.
89
90     * Moose::Meta::TypeConstraint
91       - Removed the long-deprecated union method.
92
93
94 0.73_02 Mon, April 6, 2009
95     * More deprecations and renamings
96       - Moose::Meta::Method::Constructor
97         - initialize_body => _initialize_body (this is always called
98           when an object is constructed)
99
100     * Moose::Object
101       - The DEMOLISHALL method could throw an exception during global
102         destruction, meaning that your class's DEMOLISH methods would
103         not be properly called. Reported by t0m.
104
105     * Moose::Meta::Method::Destructor
106       - Destructor inlining was totally broken by the change to the
107         is_needed method in 0.72_01. Now there is a test for this
108         feature, and it works again.
109
110     * Moose::Util
111       - Bold the word 'not' in the POD for find_meta (t0m)
112
113 0.73_01 Sun, April 5, 2009
114     * Moose::*
115       - Call user_class->meta in fewer places, with the eventual goal
116         of allowing the user to rename or exclude ->meta
117         altogether. Instead uses Class::MOP::class_of. (Sartak)
118
119     * Moose::Meta::Method::Accessor
120       - If an attribute had a lazy default, and that value did not
121         pass the attribute's type constraint, it did not get the
122         message from the type constraint, instead using a generic
123         message. Test provided by perigrin.
124
125     * Moose::Util::TypeConstraints
126       - Add duck_type keyword. It's sugar over making sure an object
127         can() a list of methods. This is easier than jrockway's
128         suggestion to fork all of CPAN. (perigrin)
129         - add tests and documentation (perigrin)
130
131     * Moose
132       - Document the fact that init_meta() returns the target class's
133         metaclass object. (hdp)
134
135     * Moose::Cookbook::Extending::Recipe1
136     * Moose::Cookbook::Extending::Recipe2
137     * Moose::Cookbook::Extending::Recipe3
138     * Moose::Cookbook::Extending::Recipe4
139       - Make init_meta() examples explicitly return the metaclass and
140         point out this fact. (hdp)
141
142     * Moose::Cookbook::Basics::Recipe12
143       - A new recipe, creating a custom meta-method class.
144
145     * Moose::Cookbook::Meta::Recipe6
146       - A new recipe, creating a custom meta-method class.
147
148     * Moose::Meta::Class
149     * Moose::Meta::Method::Constructor
150       - Attribute triggers no longer receive the meta-attribute object
151         as an argument in any circumstance. Previously, triggers
152         called during instance construction were passed the
153         meta-attribute, but triggers called by normal accessors were
154         not. Fixes RT#44429, reported by Mark Swayne. (hdp)
155
156     * Moose::Manual::Attributes
157       - Remove references to triggers receving the meta-attribute object as an
158         argument. (hdp)
159
160     * Moose::Cookbook::FAQ
161       - Remove recommendation for deprecated Moose::Policy and
162         Moose::Policy::FollowPBP; recommend MooseX::FollowPBP
163         instead. (hdp)
164
165     * Many methods have been renamed with a leading underscore, and a
166       few have been deprecated entirely. The methods with a leading
167       underscore are consider "internals only". People writing
168       subclasses or extensions to Moose should feel free to override
169       them, but they are not for "public" use.
170
171       - Moose::Meta::Class
172         - check_metaclass_compatibility => _check_metaclass_compatibility
173
174       - Moose::Meta::Method::Accessor
175         - initialize_body => _initialize_body (this is always called
176           when an object is constructed)
177         - /(generate_.*_method(?:_inline)?)/ => '_' . $1
178
179       - Moose::Meta::Method::Constructor
180         - initialize_body => _initialize_body (this is always called
181           when an object is constructed)
182         - /(generate_constructor_method(?:_inline)?)/ => '_' . $1
183         - attributes => _attributes (now inherited from parent)
184         - meta_instance => _meta_instance (now inherited from parent)
185
186       - Moose::Meta::Role
187         - alias_method is deprecated. Use add_method
188
189 0.73 Fri, March 29, 2009
190     * No changes from 0.72_01.
191
192 0.72_01 Thu, March 26, 2009
193     * Everything
194       - Almost every module has complete API documentation. A few
195         methods (and even whole classes) have been intentionally
196         excluded pending some rethinking of their APIs.
197
198     * Moose::Util::TypeConstraints
199       - Calling subtype with a name as the only argument is now an
200         exception. If you want an anonymous subtype do:
201
202          my $subtype = subtype as 'Foo';
203
204     * Moose::Cookbook::Meta::Recipe7
205       - A new recipe, creating a custom meta-instance class.
206
207     * Moose::Cookbook::Basics::Recipe5
208       - Fix various typos and mistakes. Includes a patch from Radu
209         Greab.
210
211     * Moose::Cookbook::Basics::Recipe9
212       - Link to this recipe from Moose.pm's builder blurb
213
214     * Moose::Exporter
215       - When wrapping a function with a prototype, Moose::Exporter now
216         makes sure the wrapped function still has the same
217         prototype. (Daisuke Maki)
218
219     * Moose::Meta::Attribute
220       - Allow a subclass to set lazy_build for an inherited
221         attribute. (hdp)
222
223     * Makefile.PL
224       - Explicitly depend on Data::OptList. We already had this dependency
225         via Sub::Exporter, but since we're using it directly we're
226         better off with it listed. (Sartak)
227
228     * Moose::Meta::Method::Constructor
229       - Make it easier to subclass the inlining behaviour. (Ash
230         Berlin)
231
232     * Moose::Manual::Delta
233       - Details significant changes in the history of Moose, along
234         with recommended workarounds.
235
236     * Moose::Manual::Contributing
237       - Contributor's guide to Moose.
238
239     * Moose::Meta::Method::Constructor
240       - The long-deprecated intialize_body method has been removed
241         (yes, spelled like that).
242
243     * Moose::Meta::Method::Destructor
244       - This is_needed method is now always a class method.
245
246     * Moose::Meta::Class
247       - Changes to the internals of how make_immutable works to match
248         changes in latest Class::MOP.
249
250 0.72 Mon, February 23, 2009
251     * Moose::Object
252     * Moose::Meta::Method::Constructor
253       - A mutable class accepted Foo->new(undef) without complaint,
254         while an immutable class would blow up with an unhelpful
255         error. Now, in both cases we throw a helpful error
256         instead. Reported by doy.
257
258 0.71_01 Sun, February 22, 2009
259     * Moose::Cookbook
260       - Hopefully fixed some POD errors in a few recipes that caused
261         them to display weird on search.cpan.org.
262
263     * Moose::Util::TypeConstraints
264       - Calling type or subtype without the sugar helpers (as, where,
265         message) is now deprecated.
266       - The subtype function tried hard to guess what you meant, but
267         often got it wrong. For example:
268
269          my $subtype = subtype as 'ArrayRef[Object]';
270
271         This caused an error in the past, but now works as you'd
272         expect.
273
274     * Everywhere
275       - Make sure Moose.pm is loaded before calling
276         Moose->throw_error. This wasn't normally an issue, but could
277         bite you in weird cases.
278
279 0.71 Thu, February 19, 2009
280     * Moose::Cookbook::Basics::Recipe11
281       - A new recipe which demonstrates the use of BUILDARGS and
282         BUILD. (Dave Rolsky)
283
284     * Moose::Cookbook::Roles::Recipe3
285       - A new recipe, applying a role to an object instance. (Dave
286         Rolsky)
287
288     * Moose::Exporter
289       - Allow overriding specific keywords from "also" packages. (doy)
290
291     * Tests
292       - Replace hardcoded cookbook tests with Test::Inline to ensure
293         the tests match the actual code in the recipes. (Dave Rolsky)
294
295     * Moose::Cookbook
296       - Working on the above turned up a number of little bugs in the
297         recipe code. (Dave Rolsky)
298
299     * Moose::Util::TypeConstraints::Optimized
300       - Just use Class::MOP for the optimized ClassName check. (Dave
301         Rolsky)
302
303 0.70 Sat, February 14, 2009
304     * Moose::Util::TypeConstraints
305       - Added the RoleName type (stevan)
306         - added tests for this (stevan)
307
308     * Moose::Cookbook::Basics::Recipe3
309       - Updated the before qw[left right] sub to be a little more
310         defensive about what it accepts (stevan)
311         - added more tests to t/000_recipies/basics/003_binary_tree.t
312           (stevan)
313
314     * Moose::Object
315       - We now always call DEMOLISHALL, even if a class does not
316         define DEMOLISH. This makes sure that method modifiers on
317         DEMOLISHALL work as expected. (doy)
318         - added tests for this (EvanCarroll)
319
320     * Moose::Util::MetaRole
321       - Accept roles for the wrapped_method_metaclass (rafl)
322         - added tests for this (rafl)
323
324     * Moose::Meta::Attribute
325       - We no longer pass the meta-attribute object as a final
326         argument to triggers. This actually changed for inlined code a
327         while back, but the non-inlined version and the docs were
328         still out of date.
329
330     * Tests
331       - Some tests tried to use Test::Warn 0.10, which had bugs. Now
332         they require 0.11. (Dave Rolsky)
333
334     * Documentation
335       - Lots of small changes to the manual, cookbook, and
336         elsewhere. These were based on feedback from various
337         users, too many to list here. (Dave Rolsky)
338
339 0.69 Thu, February 12, 2009
340     * Moose
341       - Make some keyword errors use throw_error instead of croak
342         since Moose::Exporter wraps keywords now (Sartak)
343
344     * Moose::Cookbook::*
345       - Revised every recipe for style and clarity. Also moved some
346         documentation out of cookbook recipes and into Moose::Manual
347         pages. This work was funded as part of the Moose docs grant
348         from TPF. (Dave Rolsky)
349
350     * Moose::Meta::Method::Delegation
351       - If the attribute doing the delegation was not populated, the
352         error message did not specify the attribute name
353         properly. (doy)
354
355 0.68 Wed, February 4, 2009
356     * POD
357       - Many spelling, typo, and formatting fixes by daxim.
358
359     * Moose::Manual::Attributes
360       - The NAME section in the POD used "Attribute" so search.cpan
361         didn't resolve links from other documents properly.
362
363     * Moose::Meta::Method::Overriden
364       - Now properly spelled as Overridden. Thanks to daxim for
365         noticing this.
366
367 0.67 Tue, February 3, 2009
368     * Moose::Manual::*
369       - Lots of little typo fixes and a few clarifications. Several
370         pages didn't have proper titles, and so weren't actually
371         visible on search.cpan.org. Thanks to hanekomu for a variety
372         of fixes and formatting improvements.
373
374 0.66 Tue, February 3, 2009
375     * Moose::Manual
376       - This is a brand new, extensive manual for Moose. This aims to
377         provide a complete introduction to all of Moose's
378         features. This work was funded as part of the Moose docs grant
379         from TPF. (Dave Rolsky)
380
381     * Moose::Meta::Attribute
382       - Added a delegation_metaclass method to replace a hard-coded
383         use of Moose::Meta::Method::Delegation. (Dave Rolsky)
384
385     * Moose::Util::TypeConstraints
386       - If you created a subtype and passed a parent that Moose didn't
387         know about, it simply ignored the parent. Now it automatically
388         creates the parent as a class type. This may not be what you
389         want, but is less broken than before. (Dave Rolsky)
390
391     * Moose::Util::TypeConstraints
392       - This module tried throw errors by calling Moose->throw_error,
393         but it did not ensure that Moose was loaded first. This could
394         cause very unhelpful errors when it tried to throw an error
395         before Moose was loaded. (Dave Rolsky)
396
397     * Moose::Util::TypeConstraints
398       - You could declare a name with subtype such as "Foo!Bar" that
399         would be allowed, but if you used it in a parameterized type
400         such as "ArrayRef[Foo!Bar]" it wouldn't work. We now do some
401         vetting on names created via the sugar functions, so that they
402         can only contain alphanumerics, ":", and ".". (Dave Rolsky)
403
404 0.65 Thu, January 22, 2008
405     * Moose and Moose::Meta::Method::Overridden
406       - If an overridden method called super(), and then the
407         superclass's method (not overridden) _also_ called super(),
408         Moose went into an endless recursion loop. Test provided by
409         Chris Prather. (Dave Rolsky)
410
411     * Moose::Meta::TypeConstraint
412       - All methods are now documented. (gphat)
413
414     * t/100_bugs/011_DEMOLISH_eats_exceptions.t
415       - Fixed some bogus failures that occurred because we tried to
416         validate filesystem paths in a very ad-hoc and
417         not-quite-correct way. (Dave Rolsky)
418
419     * Moose::Util::TypeConstraints
420       - Added maybe_type to exports. See docs for details. (rjbs)
421
422     * Moose
423       - Added Moose::Util::TypeConstraints to the SEE ALSO
424         section. (pjf)
425
426     * Moose::Role
427       - Methods created via an attribute can now fulfill a "requires"
428         declaration for a role. (nothingmuch)
429
430     * Moose::Meta::Method::*
431       - Stack traces from inlined code will now report its line and
432         file as being in your class, as opposed to in Moose
433         guts. (nothingmuch).
434
435 0.64 Wed, December 31, 2008
436     * Moose::Meta::Method::Accessor
437       - Always inline predicate and clearer methods (Sartak)
438
439     * Moose::Meta::Attribute
440       - Support for parameterized traits (Sartak)
441       - verify_against_type_constraint method to avoid duplication
442         and enhance extensibility (Sartak)
443
444     * Moose::Meta::Class
445       - Tests (but no support yet) for parameterized traits (Sartak)
446
447     * Moose
448       - Require Class::MOP 0.75+, which has the side effect of making
449         sure we work on Win32. (Dave Rolsky)
450
451 0.63 Mon, December 8, 2008
452     * Moose::Unsweetened
453       - Some small grammar tweaks and bug fixes in non-Moose example
454         code. (Dave Rolsky)
455
456 0.62_02 Fri, December 5, 2008
457     * Moose::Meta::Role::Application::ToClass
458       - When a class does not provide all of a role's required
459         methods, the error thrown now mentions all of the missing
460         methods, as opposed to just the first one found. Requested by
461         Curtis Poe (RT #41119). (Dave Rolsky)
462
463     * Moose::Meta::Method::Constructor
464       - Moose will no longer inline a constructor for your class
465         unless it inherits its constructor from Moose::Object, and
466         will warn when it doesn't inline. If you want to force
467         inlining anyway, pass "replace_constructor => 1" to
468         make_immutable. Addresses RT #40968, reported by Jon
469         Swartz. (Dave Rolsky)
470       - The quoting of default values could be broken if the default
471         contained a single quote ('). Now we use quotemeta to escape
472         anything potentially dangerous in the defaults. (Dave Rolsky)
473
474 0.62_01 Wed, December 3, 2008
475     * Moose::Object
476       - use the method->execute API for BUILDALL
477         and DEMOLISHALL (Sartak)
478
479     * Moose::Util::TypeConstraints
480       - We now make all the type constraint meta classes immutable
481         before creating the default types provided by Moose. This
482         should make loading Moose a little faster. (Dave Rolsky)
483
484 0.62 Wed November 26, 2008
485     * Moose::Meta::Role::Application::ToClass
486       Moose::Meta::Role::Application::ToRole
487       - fixed issues where excluding and aliasing the
488         same methods for a single role did not work
489         right (worked just fine with multiple
490         roles) (stevan)
491         - added test for this (stevan)
492
493     * Moose::Meta::Role::Application::RoleSummation
494       - fixed the error message when trying to compose
495         a role with a role it excludes (Sartak)
496
497     * Moose::Exporter
498       - Catch another case where recursion caused the value
499         of $CALLER to be stamped on (t0m)
500         - added test for this (t0m)
501
502     * Moose
503       - Remove the make_immutable keyword, which has been
504         deprecated since April. It breaks metaclasses that
505         use Moose without no Moose (Sartak)
506
507     * Moose::Meta::Attribute
508       - Removing an attribute from a class now also removes delegation
509         (handles) methods installed for that attribute (t0m)
510         - added test for this (t0m)
511
512     * Moose::Meta::Method::Constructor
513       - An attribute with a default that looked like a number (but was
514         really a string) would accidentally be treated as a number
515         when the constructor was made immutable (perigrin)
516         - added test for this (perigrin)
517
518     * Moose::Meta::Role
519       - create method for constructing a role
520         dynamically (Sartak)
521         - added test for this (Sartak)
522       - anonymous roles! (Sartak)
523         - added test for this (Sartak)
524
525     * Moose::Role
526       - more consistent error messages (Sartak)
527
528     * Moose::Cookbook::Roles::Recipe1
529       - attempt to explain why a role that just requires
530         methods is useful (Sartak)
531
532 0.61 Fri November 7, 2008
533     * Moose::Meta::Attribute
534       - When passing a role to handles, it will be loaded if necessary
535         (perigrin)
536
537     * Moose::Meta::Class
538       - Method objects returned by get_method (and other methods)
539         Could end up being returned without an associated_metaclass
540         attribute. Removing get_method_map, which is provided by
541         Class::MOP::Class, fixed this. The Moose version did nothing
542         different from its parent except introduce a bug. (Dave Rolsky)
543         - added tests for this (jdv79)
544
545     * Various
546       - Added a $VERSION to all .pm files which didn't have one. Fixes
547         RT #40049, reported by Adam Kennedy. (Dave Rolsky)
548
549     * Moose::Cookbook::Basics::Recipe4
550     * Moose::Cookbook::Basics::Recipe6
551       - These files had spaces on the first line of the SYNOPSIS, as
552         opposed to a totally empty line. According to RT #40432, this
553         confuses POD parsers. (Dave Rolsky)
554
555 0.60 Fri October 24, 2008
556     * Moose::Exporter
557       - Passing "-traits" when loading Moose caused the Moose.pm
558         exports to be broken. Reported by t0m. (Dave Rolsky)
559         - Tests for this bug. (t0m)
560
561     * Moose::Util
562       - Change resolve_metaclass alias to use the new
563         load_first_existing_class function. This makes it a lot
564         simpler, and also around 5 times faster. (t0m)
565       - Add caching to resolve_metaclass_alias, which gives an order
566         of magnitude speedup to things which repeatedly call the
567         Moose::Meta::Attribute->does method, notably MooseX::Storage
568         (t0m)
569
570     * Moose::Util::TypeConstraint
571       - Put back the changes for parameterized constraints that
572         shouldn't have been removed in 0.59. We still cannot parse
573         them, but MooseX modules can create them in some other
574         way. See the 0.58 changes for more details. (jnapiorkowski)
575       - Changed the way subtypes are created so that the job is
576         delegated to a type constraint parent. This clears up some
577         hardcoded checking and should allow correct subtypes of
578         Moose::Meta::Type::Constraint. Don't rely on this new API too
579         much (create_child_type) because it may go away in the
580         future. (jnapiorkowski)
581
582     * Moose::Meta::TypeConstraint::Union
583       - Type constraint names are sorted as strings, not numbers.
584         (jnapiorkowski)
585
586     * Moose::Meta::TypeConstraint::Parameterizable
587       - New parameterize method. This can be used as a factory method
588         to make a new type constraint with a given parameterized
589         type. (jnapiorkowski)
590         - added tests (jnapiorkowski)
591
592 0.59 Tue October 14, 2008
593     * Moose
594       - Add abridged documentation for builder/default/initializer/
595         predicate, and link to more details sections in
596         Class::MOP::Attribute. (t0m)
597
598     * Moose::Util::TypeConstraints
599       - removed prototypes from all but the &-based stuff (mst)
600
601     * Moose::Util::TypeConstraints
602       - Creating a anonymous subtype with both a constraint and a
603         message failed with a very unhelpful error, but should just
604         work. Reported by t0m. (Dave Rolsky)
605
606     * Tests
607       - Some tests that used Test::Warn if it was available failed
608         with older versions of Test::Warn. Reported by Fayland. (Dave
609         Rolsky)
610       - Test firing behavior of triggers in relation to builder/default/
611         lazy_build. (t0m)
612       - Test behavior of equals/is_a_type_of/is_a_subtype_of for all
613         kinds of supported type. (t0m)
614
615     * Moose::Meta::Class
616       - In create(), do not pass "roles" option to the superclass
617         - added related test that creates an anon metaclass with
618           a required attribute
619
620     * Moose::Meta::TypeConstraint::Class
621     * Moose::Meta::TypeConstraint::Role
622       - Unify behavior of equals/is_a_type_of/is_a_subtype_of with
623         other types (as per change in 0.55_02). (t0m)
624
625     * Moose::Meta::TypeConstraint::Registry
626       - Fix warning when dealing with unknown type names (t0m)
627
628     * Moose::Util::TypeConstraints
629       - Reverted changes from 0.58 related to handle parameterized
630         types. This caused random failures on BSD and Win32 systems,
631         apparently related to the regex engine. This means that Moose
632         can no longer parse structured type constraints like
633         ArrayRef[Int,Int] or HashRef[name=>Str]. This will be
634         supported in a slightly different way via MooseX::Types some
635         time in the future. (Dave Rolsky)
636
637 0.58 Sat September 20, 2008
638     !! This release has an incompatible change regarding !!
639     !! how roles add methods to a class !!
640
641     * Roles and role application
642       ! Roles now add methods by calling add_method, not
643         alias_method. They make sure to always provide a method
644         object, which will be cloned internally. This means that it is
645         now possible to track the source of a method provided by a
646         role, and even follow its history through intermediate roles.
647
648         This means that methods added by a role now show up when
649         looking at a class's method list/map. (Dave Rolsky)
650
651     * Makefile.PL
652       - From this release on, we'll try to maintain a list of
653         conflicting modules, and warn you if you have one
654         installed. For example, this release conflicts with ...
655         - MooseX::Singleton        <= 0.11
656         - MooseX::Params::Validate <= 0.05
657         - Fey::ORM                 <= 0.10
658
659         In general, we try to not break backwards compatibility for
660         most Moose users, but MooseX modules and other code which
661         extends Moose's metaclasses is often affected by very small
662         changes in the Moose internals.
663
664     * Moose::Meta::Method::Delegation
665     * Moose::Meta::Attribute
666       - Delegation methods now have their own method class. (Dave
667         Rolsky)
668
669     * Moose::Meta::TypeConstraint::Parameterizable
670       - Added a new method 'parameterize' which is basically a factory
671         for the containing constraint. This makes it easier to create
672         new types of parameterized constraints. (jnapiorkowski)
673
674     * Moose::Meta::TypeConstraint::Union
675       - Changed the way Union types canonicalize their names to follow
676         the normalized TC naming rules, which means we strip all
677         whitespace. (jnapiorkowski)
678
679     * Moose::Util::TypeConstraints
680       - Parameter and Union args are now sorted, this makes Int|Str
681         the same constraint as Str|Int. (jnapiorkowski)
682       - Changes to the way Union types are parsed to more correctly
683         stringify their names. (jnapiorkowski)
684       - When creating a parameterized type, we now use the new
685         parameterize method. (jnapiorkowski)
686       - Incoming type constraint strings are now normalized to remove
687         all whitespace differences. (jnapiorkowski)
688       - Changed the way we parse type constraint strings so that we now
689         match TC[Int,Int,...] and TC[name=>Str] as parameterized type
690         constraints. This lays the foundation for more flexible type
691         constraint implementations.
692
693     * Tests and docs for all the above. (jnapiorkowski)
694
695     * Moose::Exporter
696     * Moose
697       - Moose::Exporter will no longer remove a subroutine that the
698         exporting package re-exports. Moose re-exports the
699         Carp::confess function, among others. The reasoning is that we
700         cannot know whether you have also explicitly imported those
701         functions for your own use, so we err on the safe side and
702         always keep them. (Dave Rolsky)
703         - added tests for this (rafl)
704
705     * Moose::Meta::Class
706       - Changes to how we fix metaclass compatibility that are much
707         too complicated to go into. The summary is that Moose is much
708         less likely to complain about metaclass incompatibility
709         now. In particular, if two metaclasses differ because
710         Moose::Util::MetaRole was used on the two corresponding
711         classes, then the difference in roles is reconciled for the
712         subclass's metaclass. (Dave Rolsky)
713       - Squashed an warning in _process_attribute (thepler)
714
715     * Moose::Meta::Role
716       - throw exceptions (sooner) for invalid attribute names (thepler)
717         - added tests for this (thepler)
718
719     * Moose::Util::MetaRole
720       - If you explicitly set a constructor or destructor class for a
721         metaclass object, and then applied roles to the metaclass,
722         that explicitly set class would be lost and replaced with the
723         default.
724
725     * Moose::Meta::Class
726     * Moose::Meta::Attribute
727     * Moose::Meta::Method
728     * Moose
729     * Moose::Object
730     * Moose::Error::Default
731     * Moose::Error::Croak
732     * Moose::Error::Confess
733       - All instances of confess() changed to use overridable
734         C<throw_error> method. This method ultimately calls a class
735         constructor, and you can change the class being called. In
736         addition, errors now pass more information than just a string.
737         The default C<error_class> behaves like C<Carp::confess>, so
738         the behavior is not visibly different for end users.
739
740 0.57 Wed September 3, 2008
741     * Moose::Intro
742       - A new bit of doc intended to introduce folks familiar with
743         "standard" Perl 5 OO to Moose concepts. (Dave Rolsky)
744
745     * Moose::Unsweetened
746       - Shows examples of two classes, each done first with and then
747         without Moose. This makes a nice parallel to
748         Moose::Intro. (Dave Rolsky)
749
750     * Moose::Util::TypeConstraints
751       - Fixed a bug in find_or_parse_type_constraint so that it
752         accepts a Moose::Meta::TypeConstraint object as the parent
753         type, not just a name (jnapiorkowski)
754         - added tests (jnapiorkowski)
755
756     * Moose::Exporter
757       - If Sub::Name was not present, unimporting failed to actually
758         remove some sugar subs, causing test failures (Dave Rolsky)
759
760 0.56 Mon September 1, 2008
761     For those not following the series of dev releases, there are
762     several major changes in this release of Moose.
763       ! Moose::init_meta should now be called as a method. See the
764         docs for details.
765
766       - Major performance improvements by nothingmuch.
767
768       - New modules for extension writers, Moose::Exporter and
769         Moose::Util::MetaRole by Dave Rolsky.
770
771       - Lots of doc improvements and additions, especially in the
772         cookbook sections.
773
774       - Various bug fixes.
775
776     * Removed all references to the experimental-but-no-longer-needed
777       Moose::Meta::Role::Application::ToMetaclassInstance.
778
779     * Require Class::MOP 0.65.
780
781 0.55_04 Sat August 30, 2008
782     * Moose::Util::MetaRole
783     * Moose::Cookbook::Extending::Recipe2
784       - This simplifies the application of roles to any meta class, as
785         well as the base object class. Reimplemented metaclass traits
786         using this module. (Dave Rolsky)
787
788     * Moose::Cookbook::Extending::Recipe1
789       - This a new recipe, an overview of various ways to write Moose
790         extensions (Dave Rolsky)
791
792     * Moose::Cookbook::Extending::Recipe3
793     * Moose::Cookbook::Extending::Recipe4
794       - These used to be Extending::Recipe1 and Extending::Recipe2,
795         respectively.
796
797 0.55_03 Fri August 29, 2008
798     * No changes from 0.55_02 except increasing the Class::MOP
799       dependency to 0.64_07.
800
801 0.55_02 Fri August 29, 2008
802     * Makefile.PL and Moose.pm
803       - explicitly require Perl 5.8.0+ (Dave Rolsky)
804
805     * Moose::Util::TypeConstraints
806       - Fix warnings from find_type_constraint if the type is not
807         found (t0m).
808
809     * Moose::Meta::TypeConstraint
810       - Predicate methods (equals/is_a_type_of/is_subtype_of) now
811         return false if the type you specify cannot be found in the
812         type registry, rather than throwing an unhelpful and
813         coincidental exception. (t0m).
814         - added docs & test for this (t0m)
815
816     * Moose::Meta::TypeConstraint::Registry
817       - add_type_constraint now throws an exception if a parameter is
818         not supplied (t0m).
819         - added docs & test for this (t0m)
820
821     * Moose::Cookbook::FAQ
822       - Added a faq entry on the difference between "role" and "trait"
823         (t0m)
824
825     * Moose::Meta::Role
826       - Fixed a bug that caused role composition to not see a required
827         method when that method was provided by another role being
828         composed at the same time. (Dave Rolsky)
829         - test and bug finding (tokuhirom)
830
831 0.55_01 Wed August 20, 2008
832
833     !! Calling Moose::init_meta as a function is now         !!
834     !! deprecated. Please see the Moose.pm docs for details. !!
835
836     * Moose::Meta::Method::Constructor
837       - Fix inlined constructor so that values produced by default
838         or builder methods are coerced as required. (t0m)
839         - added test for this (t0m)
840
841     * Moose::Meta::Attribute
842       - A lazy attribute with a default or builder did not attempt to
843         coerce the default value. The immutable code _did_
844         coerce. (t0m)
845         - added test for this (t0m)
846
847     * Moose::Exporter
848       - This is a new helper module for writing "Moose-alike"
849         modules. This should make the lives of MooseX module authors
850         much easier. (Dave Rolsky)
851
852     * Moose
853     * Moose::Cookbook::Meta::Recipe5
854       - Implemented metaclass traits (and wrote a recipe for it):
855
856           use Moose -traits => 'Foo'
857
858         This should make writing small Moose extensions a little
859         easier (Dave Rolsky)
860
861     * Moose::Cookbook::Basics::Recipe1
862       - Removed any examples of direct hashref access, and applied an
863         editorial axe to reduce verbosity. (Dave Rolsky)
864
865     * Moose::Cookbook::Basics::Recipe1
866       - Also applied an editorial axe here. (Dave Rolsky)
867
868     * Moose
869     * Moose::Cookbook::Extending::Recipe1
870     * Moose::Cookbook::Extending::Recipe2
871       - Rewrote extending and embedding moose documentation and
872         recipes to use Moose::Exporter (Dave Rolsky)
873
874     * Moose
875     * Moose::Role
876       - These two modules now warn when you load them from the main
877         package "main" package, because we will not export sugar to
878         main. Previously it just did nothing. (Dave Rolsky)
879
880     * Moose::Role
881       - Now provide an init_meta method just like Moose.pm, and you
882         can call this to provide an alternate role metaclass. (Dave
883         Rolsky and nothingmuch)
884       - get_method_map now respects the package cache flag (nothingmuch)
885
886     * Moose::Meta::Role
887       - Two new methods - add_method and wrap_method_body
888         (nothingmuch)
889
890     * many modules
891       - Optimizations including allowing constructors to accept hash
892         refs, making many more classes immutable, and making
893         constructors immutable. (nothingmuch)
894
895 0.55 Sun August 3, 2008
896     * Moose::Meta::Attribute
897       - breaking down the way 'handles' methods are
898         created so that the process can be more easily
899         overridden by subclasses (stevan)
900
901     * Moose::Meta::TypeConstraint
902       - fixing what is passed into a ->message with
903         the type constraints (RT #37569)
904         - added tests for this (Charles Alderman)
905
906     * Moose::Util::TypeConstraints
907       - fix coerce to accept anon types like subtype can (mst)
908
909     * Moose::Cookbook
910       - reorganized the recipes into sections - Basics, Roles, Meta,
911         Extending - and wrote abstracts for each section (Dave Rolsky)
912
913     * Moose::Cookbook::Basics::Recipe10
914       - A new recipe that demonstrates operator overloading
915         in combination with Moose. (bluefeet)
916
917     * Moose::Cookbook::Meta::Recipe1
918       - an introduction to what meta is and why you'd want to make
919         your own metaclass extensions (Dave Rolsky)
920
921     * Moose::Cookbook::Meta::Recipe4
922       - a very simple metaclass example (Dave Rolsky)
923
924     * Moose::Cookbook::Extending::Recipe1
925       - how to write a Moose-alike module to use your own object base
926         class (Dave Rolsky)
927
928     * Moose::Cookbook::Extending::Recipe2
929       - how to write modules with an API just like C<Moose.pm> (Dave
930         Rolsky)
931
932     * all documentation
933       - Tons of fixes, both syntactical and grammatical (Dave
934         Rolsky, Paul Fenwick)
935
936 0.54 Thurs. July 3, 2008
937     ... this is not my day today ...
938
939     * Moose::Meta::Attribute
940       - fixed legal_options_for_inheritance such that
941         clone_and_inherit options still works for
942         Class::MOP::Attribute objects and therefore
943         does not break MooseX::AttributeHelpers
944         (stevan)
945
946 0.53 Thurs. July 3, 2008
947     * Whoops, I guess I should run 'make manifest' before
948       actually releasing the module. No actual changes
949       in this release, except the fact that it includes
950       the changes that I didn't include in the last
951       release. (stevan--)
952
953 0.52 Thurs. July 3, 2008
954     * Moose
955       - added "FEATURE REQUESTS" section to the Moose docs
956         to properly direct people (stevan) (RT #34333)
957       - making 'extends' croak if it is passed a Role since
958         this is not ever something you want to do
959         (fixed by stevan, found by obra)
960         - added tests for this (stevan)
961
962     * Moose::Object
963       - adding support for DOES (as in UNIVERSAL::DOES)
964         (nothingmuch)
965         - added test for this
966
967     * Moose::Meta::Attribute
968       - added legal_options_for_inheritance (wreis)
969         - added tests for this (wreis)
970
971     * Moose::Cookbook::Snacks::*
972       - removed some of the unfinished snacks that should
973         not have been released yet. Added some more examples
974         to the 'Keywords' snack. (stevan)
975
976     * Moose::Cookbook::Style
977       - added general Moose "style guide" of sorts to the
978         cookbook (nothingmuch) (RT #34335)
979
980     * t/
981       - added more BUILDARGS tests (stevan)
982
983 0.51 Thurs. Jun 26, 2008
984     * Moose::Role
985       - add unimport so "no Moose::Role" actually does
986         something (sartak)
987
988     * Moose::Meta::Role::Application::ToRole
989       - when RoleA did RoleB, and RoleA aliased a method from RoleB in
990         order to provide its own implementation, that method still got
991         added to the list of required methods for consumers of
992         RoleB. Now an aliased method is only added to the list of
993         required methods if the role doing the aliasing does not
994         provide its own implementation. See Recipe 11 for an example
995         of all this. (Dave Rolsky)
996         - added tests for this
997
998     * Moose::Meta::Method::Constructor
999       - when a single argument that wasn't a hashref was provided to
1000         an immutabilized constructor, the error message was very
1001         unhelpful, as opposed to the non-immutable error. Reported by
1002         dew. (Dave Rolsky)
1003         - added test for this (Dave Rolsky)
1004
1005     * Moose::Meta::Attribute
1006       - added support for meta_attr->does("ShortAlias") (sartak)
1007         - added tests for this (sartak)
1008       - moved the bulk of the `handles` handling to the new
1009         install_delegation method (Stevan)
1010
1011     * Moose::Object
1012       - Added BUILDARGS, a new step in new()
1013
1014     * Moose::Meta::Role::Application::RoleSummation
1015       - fix typos no one ever sees (sartak)
1016
1017     * Moose::Util::TypeConstraints
1018     * Moose::Meta::TypeConstraint
1019     * Moose::Meta::TypeCoercion
1020       - Attempt to work around the ??{ } vs. threads issue
1021         (not yet fixed)
1022       - Some null_constraint optimizations
1023
1024 0.50 Thurs. Jun 11, 2008
1025     - Fixed a version number issue by bumping all modules
1026       to 0.50.
1027
1028 0.49 Thurs. Jun 11, 2008
1029     !! This version now approx. 20-25% !!
1030     !! faster with new Class::MOP 0.59 !!
1031
1032     * Moose::Meta::Attribute
1033       - fixed how the is => (ro|rw) works with
1034         custom defined reader, writer and accessor
1035         options.
1036         - added docs for this (TODO).
1037         - added tests for this (Thanks to Penfold)
1038       - added the custom attribute alias for regular
1039         Moose attributes which is "Moose"
1040       - fix builder and default both being used
1041         (groditi)
1042
1043     * Moose
1044       Moose::Meta::Class
1045       Moose::Meta::Attribute
1046       Moose::Meta::Role
1047       Moose::Meta::Role::Composite
1048       Moose::Util::TypeConstraints
1049       - switched usage of reftype to ref because
1050         it is much faster
1051
1052     * Moose::Meta::Role
1053       - changing add_package_symbol to use the new
1054         HASH ref form
1055
1056     * Moose::Object
1057       - fixed how DEMOLISHALL is called so that it
1058         can be overrided in subclasses (thanks to Sartak)
1059         - added test for this (thanks to Sartak)
1060
1061     * Moose::Util::TypeConstraints
1062       - move the ClassName type check code to
1063         Class::MOP::is_class_loaded (thanks to Sartak)
1064
1065     * Moose::Cookbook::Recipe11
1066       - add tests for this (thanks to tokuhirom)
1067
1068 0.48 Thurs. May 29, 2008
1069     (early morning release engineering)--
1070
1071     - fixing the version in Moose::Meta::Method::Destructor
1072       which was causing the indexer to choke
1073
1074 0.47 Thurs. May 29, 2008
1075     (late night release engineering)--
1076
1077     - fixing the version is META.yml, no functional
1078       changes in this release
1079
1080 0.46 Wed. May 28, 2008
1081     !! This version now approx. 20-25% !!
1082     !! faster with new Class::MOP 0.57 !!
1083
1084     * Moose::Meta::Class
1085       - some optimizations of the &initialize method
1086         since it is called so often by &meta
1087
1088     * Moose::Meta::Class
1089       Moose::Meta::Role
1090       - now use the get_all_package_symbols from the
1091         updated Class::MOP, test suite is now 10 seconds
1092         faster
1093
1094     * Moose::Meta::Method::Destructor
1095       - is_needed can now also be called as a class
1096         method for immutablization to check if the
1097         destructor object even needs to be created
1098         at all
1099
1100     * Moose::Meta::Method::Destructor
1101       Moose::Meta::Method::Constructor
1102       - added more descriptive error message to help
1103         keep people from wasting time tracking an error
1104         that is easily fixed by upgrading.
1105
1106 0.45 Saturday, May 24, 2008
1107     * Moose
1108       - Because of work in Class::MOP 0.57, all
1109         XS based functionality is now optional
1110         and a Pure Perl version is supplied
1111         - the CLASS_MOP_NO_XS environment variable
1112           can now be used to force non-XS versions
1113           to always be used
1114         - several of the packages have been tweaked
1115           to take care of this, mostly we added
1116           support for the package_name and name
1117           variables in all the Method metaclasses
1118       - before/around/after method modifiers now
1119         support regexp matching of names
1120         (thanks to Takatoshi Kitano)
1121         - tests added for this
1122         - NOTE: this only works for classes, it
1123           is currently not supported in roles,
1124           but, ... patches welcome
1125       - All usage of Carp::confess have been replaced
1126         by Carp::croak in the "keyword" functions since
1127         the stack trace is usually not helpful
1128
1129     * Moose::Role
1130       - All usage of Carp::confess have been replaced
1131         by Carp::croak in the "keyword" functions since
1132         the stack trace is usually not helpful
1133       - The 'has' keyword for roles now accepts the
1134         same array ref form that Moose.pm does
1135         (has [qw/foo bar/] => (is => 'rw', ...))
1136         - added test for this
1137
1138     * Moose::Meta::Attribute
1139       - trigger on a ro-attribute is no longer an
1140         error, as it's useful to trigger off of the
1141         constructor
1142
1143     * Moose::Meta::Class
1144       - added same 'add_package_symbol' fix as in
1145         Class::MOP 0.57
1146
1147     * Moose::Util
1148       - does_role now handles non-Moose classes
1149         more gracefully
1150         - added tests for this
1151       - added the 'add_method_modifier' function
1152         (thanks to Takatoshi Kitano)
1153
1154     * Moose::Util::TypeConstraints
1155       - subtypes of parameterizable types now are
1156         themselves parameterizable types
1157
1158     * Moose::Meta::Method::Constructor
1159       - fixed bug where trigger was not being
1160         called by the inlined immutable
1161         constructors
1162         - added test for this (thanks to Caelum)
1163
1164     * Moose::Meta::Role::Application::ToInstance
1165       - now uses the metaclass of the instance
1166         (if possible) to create the anon-class
1167         (thanks Jonathan Rockway)
1168
1169     * Moose::Cookbook::Recipe22
1170       - added the meta-attribute trait recipe
1171         (thanks to Sartak)
1172
1173     * t/
1174       - fixed hash-ordering test bug that was
1175         causing occasional cpantester failures
1176       - renamed the t/000_recipe/*.t tests to be
1177         more descriptive (thanks to Sartak)
1178
1179 0.44 Sat. May 10, 2008
1180     * Moose
1181       - made make_immutable warning cluck to
1182         show where the error is (thanks mst)
1183
1184     * Moose::Object
1185       - BUILDALL and DEMOLISHALL now call
1186         ->body when looping through the
1187         methods, to avoid the overloaded
1188         method call.
1189       - fixed issue where DEMOLISHALL was
1190         eating the $@ values, and so not
1191         working correctly, it still kind of
1192         eats them, but so does vanilla perl
1193         - added tests for this
1194
1195     * Moose::Cookbook::Recipe7
1196       - added new recipe for immutable
1197         functionality (thanks Dave Rolsky)
1198
1199     * Moose::Cookbook::Recipe9
1200       - added new recipe for builder and
1201         lazy_build (thanks Dave Rolsky)
1202
1203     * Moose::Cookbook::Recipe11
1204       - added new recipe for method aliasing
1205         and exclusion with Roles (thanks Dave Rolsky)
1206
1207     * t/
1208       - fixed Win32 test failure (thanks spicyjack)
1209
1210     ~ removed Build.PL and Module::Build compat
1211       since Module::Install has done that.
1212
1213 0.43 Wed. April, 30, 2008
1214     * NOTE TO SELF:
1215         drink more coffee before
1216         doing release engineering
1217
1218     - whoops, forgot to do the smolder tests,
1219       and we broke some of the custom meta-attr
1220       modules. This fixes that.
1221
1222 0.42 Mon. April 28, 2008
1223     - some bad tests slipped by, nothing else
1224       changed in this release (cpantesters++)
1225
1226     - upped the Class::MOP dependency to 0.55
1227       since we have tests which need the C3
1228       support
1229
1230 0.41 Mon. April 28, 2008
1231     ~~ numerous documentation updates ~~
1232
1233     - Changed all usage of die to Carp::croak for better
1234       error reporting (initial patch by Tod Hagan)
1235
1236     ** IMPORTANT NOTE **
1237     - the make_immutable keyword is now deprecated, don't
1238       use it in any new code and please fix your old code
1239       as well. There will be 2 releases, and then it will
1240       be removed.
1241
1242     * Moose
1243       Moose::Role
1244       Moose::Meta::Class
1245       - refactored the way inner and super work to avoid
1246         any method/@ISA cache penalty (nothingmuch)
1247
1248     * Moose::Meta::Class
1249       - fixing &new_object to make sure trigger gets the
1250         coerced value (spotted by Charles Alderman on the
1251         mailing list)
1252         - added test for this
1253
1254     * Moose::Meta::Method::Constructor
1255       - immutable classes which had non-lazy attributes were calling
1256         the default generating sub twice in the constructor. (bug
1257         found by Jesse Luehrs, fixed by Dave Rolsky)
1258         - added tests for this (Dave Rolsky)
1259       - fix typo in initialize_body method (nothingmuch)
1260
1261     * Moose::Meta::Method::Destructor
1262       - fix typo in initialize_body method (nothingmuch)
1263
1264     * Moose::Meta::Method::Overriden
1265       Moose::Meta::Method::Augmented
1266       - moved the logic for these into their own
1267         classes (nothingmuch)
1268
1269     * Moose::Meta::Attribute
1270       - inherited attributes may now be extended without
1271         restriction on the type ('isa', 'does') (Sartak)
1272         - added tests for this (Sartak)
1273       - when an attribute property is malformed (such as lazy without
1274         a default), give the name of the attribute in the error
1275         message (Sartak)
1276       - added the &applied_traits and &has_applied_traits methods
1277         to allow introspection of traits
1278         - added tests for this
1279       - moved 'trait' and 'metaclass' argument handling to here from
1280         Moose::Meta::Class
1281       - clone_and_inherit_options now handles 'trait' and 'metaclass' (has
1282         '+foo' syntax) (nothingmuch)
1283         - added tests for this (t0m)
1284
1285     * Moose::Object
1286       - localize $@ inside DEMOLISHALL to avoid it
1287         eating $@ (found by Ernesto)
1288         - added test for this (thanks to Ernesto)
1289
1290     * Moose::Util::TypeConstraints
1291       - &find_type_constraint now DWIMs when given an
1292         type constraint object or name (nothingmuch)
1293       - &find_or_create_type_constraint superseded with a number of more
1294         specific functions:
1295         - find_or_create_{isa,does}_type_constraint
1296         - find_or_parse_type_constraint
1297
1298     * Moose::Meta::TypeConstraint
1299       Moose::Meta::TypeConstraint::Class
1300       Moose::Meta::TypeConstraint::Role
1301       Moose::Meta::TypeConstraint::Enum
1302       Moose::Meta::TypeConstraint::Union
1303       Moose::Meta::TypeConstraint::Parameterized
1304         - added the &equals method for comparing two type
1305           constraints (nothingmuch)
1306           - added tests for this (nothingmuch)
1307
1308     * Moose::Meta::TypeConstraint
1309       - add the &parents method, which is just an alias to &parent.
1310         Useful for polymorphism with TC::{Class,Role,Union} (nothingmuch)
1311
1312     * Moose::Meta::TypeConstraint::Class
1313       - added the class attribute for introspection purposes
1314         (nothingmuch)
1315         - added tests for this
1316
1317     * Moose::Meta::TypeConstraint::Enum
1318       Moose::Meta::TypeConstraint::Role
1319       - broke these out into their own classes (nothingmuch)
1320
1321     * Moose::Cookbook::Recipe*
1322       - fixed references to test file locations in the POD
1323         and updated up some text for new Moose features
1324         (Sartak)
1325
1326     * Moose::Util
1327       - Added &resolve_metaclass_alias, a helper function for finding an actual
1328         class for a short name (e.g. in the traits list)
1329
1330 0.40 Fri. March 14, 2008
1331     - I hate Pod::Coverage
1332
1333 0.39 Fri. March 14, 2008
1334     * Moose
1335       - documenting the use of '+name' with attributes
1336         that come from recently composed roles. It makes
1337         sense, people are using it, and so why not just
1338         officially support it.
1339       - fixing the 'extends' keyword so that it will not
1340         trigger Ovid's bug (http://use.perl.org/~Ovid/journal/35763)
1341
1342     * oose
1343       - added the perl -Moose=+Class::Name feature to allow
1344         monkeypatching of classes in one liners
1345
1346     * Moose::Util
1347       - fixing the 'apply_all_roles' keyword so that it will not
1348         trigger Ovid's bug (http://use.perl.org/~Ovid/journal/35763)
1349
1350     * Moose::Meta::Class
1351       - added ->create method which now supports roles (thanks to jrockway)
1352         - added tests for this
1353       - added ->create_anon_class which now supports roles and caching of
1354         the results (thanks to jrockway)
1355         - added tests for this
1356       - made ->does_role a little more forgiving when it is
1357         checking a Class::MOP era metaclasses.
1358
1359     * Moose::Meta::Role::Application::ToInstance
1360       - it is now possible to pass extra params to be used when
1361         a role is applied to an the instance (rebless_params)
1362         - added tests for this
1363
1364     * Moose::Util::TypeConstraints
1365       - class_type now accepts an optional second argument for a
1366         custom message. POD anotated accordingly (groditi)
1367         - added tests for this
1368       - it is now possible to make anon-enums by passing 'enum' an
1369         ARRAY ref instead of the $name => @values. Everything else
1370         works as before.
1371         - added tests for this
1372
1373     * t/
1374       - making test for using '+name' on attributes consumed
1375         from a role, it works and makes sense too.
1376
1377     * Moose::Meta::Attribute
1378       - fix handles so that it doesn't return nothing
1379         when the method cannot be found, not sure why
1380         it ever did this originally, this means we now
1381         have slightly better support for AUTOLOADed
1382         objects
1383         - added more delegation tests
1384       - adding ->does method to this so as to better
1385         support traits and their introspection.
1386         - added tests for this
1387
1388     * Moose::Object
1389       - localizing the Data::Dumper configurations so
1390         that it does not pollute others (RT #33509)
1391       - made ->does a little more forgiving when it is
1392         passed Class::MOP era metaclasses.
1393
1394 0.38 Fri. Feb. 15, 2008
1395     * Moose::Meta::Attribute
1396       - fixed initializer to correctly do
1397         type checking and coercion in the
1398         callback
1399         - added tests for this
1400
1401     * t/
1402       - fixed some finicky tests (thanks to konobi)
1403
1404 0.37 Thurs. Feb. 14, 2008
1405     * Moose
1406       - fixed some details in Moose::init_meta
1407         and its superclass handling (thanks thepler)
1408         - added tests for this (thanks thepler)
1409       - 'has' now dies if you don't pass in name
1410         value pairs
1411       - added the 'make_immutable' keyword as a shortcut
1412         to make_immutable
1413
1414     * Moose::Meta::Class
1415       Moose::Meta::Method::Constructor
1416       Moose::Meta::Attribute
1417       - making (init_arg => undef) work here too
1418         (thanks to nothingmuch)
1419
1420     * Moose::Meta::Attribute
1421       Moose::Meta::Method::Constructor
1422       Moose::Meta::Method::Accessor
1423       - make lazy attributes respect attr initializers (rjbs)
1424         - added tests for this
1425
1426     * Moose::Util::TypeConstraints
1427       Moose::Util::TypeConstraints::OptimizedConstraints
1428       Moose::Meta::TypeConstraints
1429       Moose::Meta::Attribute
1430       Moose::Meta::Method::Constructor
1431       Moose::Meta::Method::Accessor
1432       - making type errors use the
1433         assigned message (thanks to Sartak)
1434         - added tests for this
1435
1436     * Moose::Meta::Method::Destructor
1437       - making sure DESTROY gets inlined properly
1438         with successive DEMOLISH calls (thanks to manito)
1439
1440     * Moose::Meta::Attribute
1441       Moose::Meta::Method::Accessor
1442       - fixed handling of undef with type constraints
1443         (thanks to Ernesto)
1444         - added tests for this
1445
1446     * Moose::Util
1447       - added &get_all_init_args and &get_all_attribute_values
1448         (thanks to Sartak and nothingmuch)
1449
1450 0.36 Sat. Jan. 26, 2008
1451     * Moose::Role
1452       Moose::Meta::Attribute
1453       - role type tests now support when roles are
1454         applied to non-Moose classes (found by ash)
1455         - added tests for this (thanks to ash)
1456       - couple extra tests to boost code coverage
1457
1458     * Moose::Meta::Method::Constructor
1459       - improved fix for handling Class::MOP attributes
1460         - added test for this
1461
1462     * Moose::Meta::Class
1463       - handled the add_attribute($attribute_meta_object)
1464         case correctly
1465         - added test for this
1466
1467 0.35 Tues. Jan. 22, 2008
1468     * Moose::Meta::Method::Constructor
1469       - fix to make sure even Class::MOP attributes
1470         are handled correctly (Thanks to Dave Rolsky)
1471         - added test for this (also Dave Rolsky)
1472
1473     * Moose::Meta::Class
1474       - improved error message on _apply_all_roles,
1475         you should now use Moose::Util::apply_all_roles
1476         and you shouldnt have been using a _ prefixed
1477         method in the first place ;)
1478
1479 0.34 Mon. Jan. 21, 2008
1480     ~~~ more misc. doc. fixes ~~~
1481     ~~ updated copyright dates ~~
1482
1483     Moose is now a postmodern object system :)
1484       - (see the POD for details)
1485
1486     * <<Role System Refactoring>>
1487     - this release contains a major reworking and
1488       cleanup of the role system
1489       - 100% backwards compat.
1490       - Role application now restructured into seperate
1491         classes based on type of applicants
1492       - Role summation (combining of more than one role)
1493         is much cleaner and anon-classes are no longer
1494         used in this process
1495       - new Composite role metaclass
1496       - runtime application of roles to instances
1497         is now more efficient and re-uses generated
1498         classes when applicable
1499
1500     * <<New Role composition features>>
1501       - methods can now be excluded from a given role
1502         during composition
1503       - methods can now be aliased to another name (and
1504         still retain the original as well)
1505
1506     * Moose::Util::TypeConstraints::OptimizedConstraints
1507       - added this module (see above)
1508
1509     * Moose::Meta::Class
1510       - fixed the &_process_attribute method to be called
1511         by &add_attribute, so that the API is now correct
1512
1513     * Moose::Meta::Method::Accessor
1514       - fixed bug when passing a list of values to
1515         an accessor would get (incorrectly) ignored.
1516         Thanks to Sartak for finding this ;)
1517         - added tests for this (Sartak again)
1518
1519     * Moose::Meta::Method::Accessor
1520       Moose::Meta::Method::Constructor
1521       Moose::Meta::Attribute
1522       Moose::Meta::TypeConstraint
1523       Moose::Meta::TypeCoercion
1524       - lots of cleanup of such things as:
1525         - generated methods
1526         - type constraint handling
1527         - error handling/messages
1528         (thanks to nothingmuch)
1529
1530     * Moose::Meta::TypeConstraint::Parameterizable
1531       - added this module to support the refactor
1532         in Moose::Meta::TypeConstraint::Parameterized
1533
1534     * Moose::Meta::TypeConstraint::Parameterized
1535       - refactored how these types are handled so they
1536         are more generic and not confined to ArrayRef
1537         and HashRef only
1538
1539     * t/
1540       - shortened some file names for better VMS support (RT #32381)
1541
1542 0.33 Fri. Dec. 14, 2007
1543     !! Moose now loads 2 x faster !!
1544     !!  with new Class::MOP 0.49  !!
1545
1546     ++ new oose.pm module to make command line
1547        Moose-ness easier (see POD docs for more)
1548
1549     * Moose::Meta::Class
1550     * Moose::Meta::Role
1551       - several tweaks to take advantage of the
1552         new method map caching in Class::MOP
1553
1554     * Moose::Meta::TypeConstraint::Parameterized
1555       - allow subtypes of ArrayRef and HashRef to
1556         be used as a container (sartak)
1557         - added tests for this
1558       - basic support for coercion to ArrayRef and
1559         HashRef for containers (sartak)
1560         - added tests for this
1561
1562     * Moose::Meta::TypeCoercion
1563       - coercions will now create subtypes as needed
1564         so you can now add coercions to parameterized
1565         types without having to explictly define them
1566         - added tests for this
1567
1568     * Moose::Meta::Method::Accessor
1569       - allow subclasses to decide whether we need
1570         to copy the value into a new variable (sartak)
1571
1572 0.32 Tues. Dec. 4, 2007
1573     * Moose::Util::TypeConstraints
1574       - fixing how subtype aliases of unions work
1575         they should inherit the parent's coercion
1576         - added tests for this
1577       - you can now define multiple coercions on
1578         a single type at different times instead of
1579         having to do it all in one place
1580         - added tests for this
1581
1582     * Moose::Meta::TypeConstraint
1583       - there is now a default constraint of sub { 1 }
1584         instead of Moose::Util::TypeConstraints setting
1585         this for us
1586
1587     * Moose::Meta::TypeCoercion
1588     * Moose::Meta::TypeCoercion::Union
1589       - added the &has_coercion_for_type and
1590         &add_type_coercions methods to support the
1591         new features above (although you cannot add
1592         more type coercions for Union types)
1593
1594 0.31 Mon. Nov. 26, 2007
1595     * Moose::Meta::Attribute
1596       - made the +attr syntax handle extending types with
1597         parameters. So "has '+foo' => (isa => 'ArrayRef[Int]')"
1598         now works if the original foo is an ArrayRef.
1599         - added tests for this.
1600       - delegation now works even if the attribute does not
1601         have a reader method using the get_read_method_ref
1602         method from Class::MOP::Attribute.
1603         - added tests for this
1604         - added docs for this
1605
1606     * Moose::Util::TypeConstraints
1607       - passing no "additional attribute info" to
1608         &find_or_create_type_constraint will no longer
1609         attempt to create an __ANON__ type for you,
1610         instead it will just return undef.
1611         - added docs for this
1612
1613 0.30 Fri. Nov. 23, 2007
1614     * Moose::Meta::Method::Constructor
1615       -builder related bug in inlined constructor. (groditi)
1616
1617     * Moose::Meta::Method::Accessor
1618       - genereate unnecessary calls to predicates and refactor
1619         code generation for runtime speed (groditi)
1620
1621     * Moose::Util::TypeConstraints
1622       - fix ClassName constraint to introspect symbol table (mst)
1623         - added more tests for this (mst)
1624       - fixed it so that subtype 'Foo' => as 'HashRef[Int]' ...
1625         with work correctly.
1626         - added tests for this
1627
1628     * Moose::Cookbook
1629       - adding the link to Recipie 11 (written by Sartak)
1630         - adding test for SYNOPSIS code
1631
1632     * t/
1633       - New tests for builder bug. Upon instantiation, if an
1634         attribute had a builder, no value and was not lazy the
1635         builder default was not getting run, oops. (groditi)
1636
1637 0.29 Tues. Nov. 13, 2007
1638     * Moose::Meta::Attribute
1639       - Fix error message on missing builder method (groditi)
1640
1641     * Moose::Meta::Method::Accessor
1642       - Fix error message on missing builder method (groditi)
1643
1644     * t/
1645       - Add test to check for the correct error message when
1646         builder method is missing (groditi)
1647
1648 0.28 Tues. Nov. 13, 2007
1649     - 0.27 packaged incorrectly (groditi)
1650
1651 0.27 Tues. Nov. 13, 2007
1652     * Moose::Meta::Attribute
1653       - Added support for the new builder option (groditi)
1654       - Added support for lazy_build option (groditi)
1655       - Changed slot initialization for predicate changes (groditi)
1656
1657     * Moose::Meta::Method::Accessor
1658       - Added support for lazy_build option (groditi)
1659       - Fix inline methods to work with corrected predicate
1660         behavior (groditi)
1661
1662     * Moose::Meta::Method::Constructor
1663       - Added support for lazy_build option (groditi)
1664
1665     * t/
1666       - tests for builder and lazy_build (groditi)
1667
1668     * fixing some misc. bits in the docs that
1669       got mentioned on CPAN Forum & perlmonks
1670
1671     * Moose::Meta::Role
1672       - fixed how required methods are handled
1673         when they encounter overriden or modified
1674         methods from a class (thanks to confound).
1675         - added tests for this
1676
1677     * Moose::Util::TypeConstraint
1678       - fixed the type notation parser so that
1679         the | always creates a union and so is
1680         no longer a valid type char (thanks to
1681         konobi, mugwump and #moose for working
1682         this one out.)
1683         - added more tests for this
1684
1685 0.26 Thurs. Sept. 27, 2007
1686     == New Features ==
1687
1688     * Parameterized Types
1689       We now support parameterized collection types, such as:
1690           ArrayRef[Int]    # array or integers
1691           HashRef[Object]  # a hash with object values
1692       They can also be nested:
1693           ArrayRef[HashRef[RegexpRef]] # an array of hashes with regex values
1694       And work with the type unions as well:
1695           ArrayRef[Int | Str]  # array of integers of strings
1696
1697     * Better Framework Extendability
1698       Moose.pm is now "extendable" such that it is now much
1699       easier to extend the framework and add your own keywords
1700       and customizations. See the "EXTENDING AND EMBEDDING MOOSE"
1701       section of the Moose.pm docs.
1702
1703     * Moose Snacks!
1704       In an effort to begin documenting some of the various
1705       details of Moose as well as some common idioms, we have
1706       created Moose::Cookbook::Snacks as a place to find
1707       small (easily digestable) nuggets of Moose code.
1708
1709     ====
1710     ~ Several doc updates/cleanup thanks to castaway ~
1711
1712     - converted build system to use Module::Install instead of
1713       Module::Build (thanks to jrockway)
1714
1715     * Moose
1716       - added all the meta classes to the immutable list and
1717         set it to inline the accessors
1718       - fix import to allow Sub::Exporter like { into => }
1719             and { into_level => } (perigrin)
1720       - exposed and documented init_meta() to allow better
1721             embedding and extending of Moose (perigrin)
1722
1723         * t/
1724           - complete re-organization of the test suite
1725           - added some new tests as well
1726           - finally re-enabled the Moose::POOP test since
1727             the new version of DBM::Deep now works again
1728             (thanks rob)
1729
1730     * Moose::Meta::Class
1731       - fixed very odd and very nasty recursion bug with
1732         inner/augment (mst)
1733         - added tests for this (eilara)
1734
1735     * Moose::Meta::Attribute
1736       Moose::Meta::Method::Constructor
1737       Moose::Meta::Method::Accessor
1738       - fixed issue with overload::Overloaded getting called
1739         on non-blessed items. (RT #29269)
1740         - added tests for this
1741
1742     * Moose::Meta::Method::Accessor
1743       - fixed issue with generated accessor code making
1744         assumptions about hash based classes (thanks to dexter)
1745
1746     * Moose::Coookbook::Snacks
1747       - these are bits of documentation, not quite as big as
1748         Recipes but which have no clear place in the module docs.
1749         So they are Snacks! (horray for castaway++)
1750
1751     * Moose::Cookbook::Recipe4
1752       - updated it to use the new ArrayRef[MyType] construct
1753         - updated the accompanying test as well
1754
1755     +++ Major Refactor of the Type Constraint system +++
1756     +++       with new features added as well        +++
1757
1758     * Moose::Util::TypeConstraint
1759       - no longer uses package variable to keep track of
1760         the type constraints, now uses the an instance of
1761         Moose::Meta::TypeConstraint::Registry to do it
1762       - added more sophisticated type notation parsing
1763         (thanks to mugwump)
1764         - added tests for this
1765
1766     * Moose::Meta::TypeConstraint
1767       - some minor adjustments to make subclassing easier
1768       - added the package_defined_in attribute so that we
1769         can track where the type constraints are created
1770
1771     * Moose::Meta::TypeConstraint::Union
1772       - this is now been refactored to be a subclass of
1773         Moose::Meta::TypeConstraint
1774
1775     * Moose::Meta::TypeCoercion::Union
1776       - this has been added to service the newly refactored
1777         Moose::Meta::TypeConstraint::Union and is itself
1778         a subclass of Moose::Meta::TypeCoercion
1779
1780     * Moose::Meta::TypeConstraint::Parameterized
1781       - added this module (taken from MooseX::AttributeHelpers)
1782         to help construct nested collection types
1783         - added tests for this
1784
1785     * Moose::Meta::TypeConstraint::Registry
1786       - added this class to keep track of type constraints
1787
1788 0.25 Mon. Aug. 13, 2007
1789     * Moose
1790       - Documentation update to reference Moose::Util::TypeConstraints
1791         under 'isa' in 'has' for how to define a new type
1792         (thanks to shlomif).
1793
1794     * Moose::Meta::Attribute
1795       - required attributes now will no longer accept undef
1796         from the constructor, even if there is a default and lazy
1797         - added tests for this
1798       - default subroutines must return a value which passes the
1799         type constraint
1800         - added tests for this
1801
1802     * Moose::Meta::Attribute
1803     * Moose::Meta::Method::Constructor
1804     * Moose::Meta::Method::Accessor
1805       - type-constraint tests now handle overloaded objects correctly
1806         in the error message
1807         - added tests for this (thanks to EvanCarroll)
1808
1809     * Moose::Meta::TypeConstraint::Union
1810       - added (has_)hand_optimized_constraint to this class so that
1811         it behaves as the regular Moose::Meta::TypeConstraint does.
1812
1813     * Moose::Meta::Role
1814       - large refactoring of this code
1815       - added several more tests
1816         - tests for subtle conflict resolition issues
1817           added, but not currently running
1818           (thanks to kolibre)
1819
1820     * Moose::Cookbook::Recipe7
1821       - added new recipe for augment/inner functionality
1822         (still in progress)
1823         - added test for this
1824
1825     * Moose::Spec::Role
1826       - a formal definition of roles (still in progress)
1827
1828     * Moose::Util
1829       - utilities for easier working with Moose classes
1830         - added tests for these
1831
1832     * Test::Moose
1833       - This contains Moose specific test functions
1834         - added tests for these
1835
1836 0.24 Tues. July 3, 2007
1837     ~ Some doc updates/cleanup ~
1838
1839     * Moose::Meta::Attribute
1840       - added support for roles to be given as parameters
1841         to the 'handles' option.
1842         - added tests and docs for this
1843       - the has '+foo' attribute form now accepts changes to
1844         the lazy option, and the addition of a handles option
1845         (but not changing the handles option)
1846         - added tests and docs for this
1847
1848     * Moose::Meta::Role
1849       - required methods are now fetched using find_method_by_name
1850         so that required methods can come from superclasses
1851         - adjusted tests for this
1852
1853 0.23 Mon. June 18, 2007
1854     * Moose::Meta::Method::Constructor
1855       - fix inlined constructor for hierarchy with multiple BUILD methods (mst)
1856     * Moose::Meta::Class
1857       - Modify make_immutable to work with the new Class::MOP immutable
1858         mechanism + POD + very basic test (groditi)
1859     * Moose::Meta::Attribute
1860       - Fix handles to use goto() so that caller() comes out properly on
1861         the other side (perigrin)
1862
1863 0.22 Thurs. May 31, 2007
1864     * Moose::Util::TypeConstraints
1865       - fix for prototype undeclared issue when Moose::Util::TypeConstraints
1866         loaded before consumers (e.g. Moose::Meta::Attribute) by predeclaring
1867         prototypes for functions
1868       - added the ClassName type constraint, this checks for strings
1869         which will respond true to ->isa(UNIVERSAL).
1870         - added tests and docs for this
1871       - subtyping just in name now works correctly by making the
1872         default for where be { 1 }
1873         - added test for this
1874
1875     * Moose::Meta::Method::Accessor
1876       - coerce and lazy now work together correctly, thanks to
1877         merlyn for finding this bug
1878         - tests added for this
1879       - fix reader presedence bug in Moose::Meta::Attribute + tests
1880
1881     * Moose::Object
1882       - Foo->new(undef) now gets ignored, it is assumed you meant to pass
1883         a HASH-ref and missed. This produces better error messages then
1884         having it die cause undef is not a HASH.
1885         - added tests for this
1886
1887 0.21 Thursday, May 2nd, 2007
1888     * Moose
1889       - added SUPER_SLOT and INNER_SLOT class hashes to support unimport
1890       - modified unimport to remove super and inner along with the rest
1891         - altered unimport tests to handle this
1892
1893     * Moose::Role
1894       - altered super export to populate SUPER_SLOT
1895
1896     * Moose::Meta::Class
1897       - altered augment and override modifier application to use *_SLOT
1898         - modified tests for these to unimport one test class each to test
1899
1900     * Moose::Meta::Role
1901       - fixed issue where custom attribute metaclasses
1902         where not handled correctly in roles
1903         - added tests for this
1904
1905     * Moose::Meta::Class
1906       - fixed issue where extending metaclasses with
1907         roles would blow up. Thanks to Aankhen`` for
1908         finding this insidious error, and it's solution.
1909
1910     ~~ lots of spelling and grammer fixes in the docs,
1911        many many thanks to rlb3 and Aankhen for these :)
1912
1913 0.20 Friday, April 6th, 2007
1914     >> I messed up the SKIP logic in one test
1915        so this release is just to fix that.
1916
1917     * Moose
1918       - 'has' now also accepts an ARRAY ref
1919         to create multiple attrs (see docs)
1920         (thanks to konobi for this)
1921          - added tests and docs
1922
1923 0.19 Thurs. April 5th, 2007
1924     ~~ More documentation updates ~~
1925
1926     * Moose::Util::TypeConstraints
1927       - 'type' now supports messages as well
1928         thanks to phaylon for finding this
1929         - added tests for this
1930       - added &list_all_type_constraints and
1931         &list_all_builtin_type_constraints
1932         functions to facilitate introspection.
1933
1934     * Moose::Meta::Attribute
1935       - fixed regexp 'handles' declarations
1936         to build the list of delegated methods
1937         correctly (and not override important
1938         things like &new) thanks to ashleyb
1939         for finding this
1940         - added tests and docs for this
1941       - added the 'documentation' attributes
1942         so that you can actually document your
1943         attributes and inspect them through the
1944         meta-object.
1945         - added tests and docs for this
1946
1947     * Moose::Meta::Class
1948       - when loading custom attribute metaclasses
1949         it will first look in for the class in the
1950         Moose::Meta::Attribute::Custom::$name, and
1951         then default to just loading $name.
1952         - added tests and docs for this
1953
1954     * Moose::Meta::TypeConstraint
1955       - type constraints now stringify to their names.
1956         - added test for this
1957
1958     * misc.
1959       - added tests to assure we work with Module::Refresh
1960       - added stricter test skip logic in the Moose POOP
1961         test, ask Rob Kinyon why.
1962         - *cough* DBM::Deep 1.0 backwards compatibility sucks *cough* ;)
1963
1964 0.18 Sat. March 10, 2007
1965     ~~ Many, many documentation updates ~~
1966
1967     * misc.
1968       - We now use Class::MOP::load_class to
1969         load all classes.
1970       - added tests to show types and subtypes
1971         working with Declare::Constraints::Simple
1972         and Test::Deep as constraint engines.
1973
1974 0.18_001
1975     !! You must have Class::MOP 0.37_001  !!
1976     !! for this developer release to work !!
1977
1978     This release was primarily adding the immutable
1979     feature to Moose. An immutable class is one which
1980     you promise not to alter. When you set the class
1981     as immutable it will perform various bits of
1982     memoization and inline certain part of the code
1983     (constructors, destructors and accessors). This
1984     minimizes (and in some cases totally eliminates)
1985     one of Moose's biggest performance hits. This
1986     feature is not on by default, and is 100% optional.
1987     It has several configurable bits as well, so you
1988     can pick and choose to your specific needs.
1989
1990     The changes involved in this were fairly wide and
1991     highly specific, but 100% backwards compatible, so
1992     I am not going to enumerate them here. If you are
1993     truely interested in what was changed, please do
1994     a diff :)
1995
1996 0.17 Tues. Nov. 14, 2006
1997     * Moose::Meta::Method::Accessor
1998       - bugfix for read-only accessors which
1999         are have a type constraint and lazy.
2000         Thanks to chansen for finding it.
2001
2002 0.16 Tues. Nov. 14, 2006
2003     ++ NOTE ++
2004     There are some speed improvements in this release,
2005     but they are only the begining, so stay tuned.
2006
2007     * Moose::Object
2008       - BUILDALL and DEMOLISHALL no longer get
2009         called unless they actually need to be.
2010         This gave us a signifigant speed boost
2011         for the cases when there is no BUILD or
2012         DEMOLISH method present.
2013
2014     * Moose::Util::TypeConstraints
2015     * Moose::Meta::TypeConstraint
2016       - added an 'optimize_as' option to the
2017         type constraint, which allows for a
2018         hand optimized version of the type
2019         constraint to be used when possible.
2020       - Any internally created type constraints
2021         now provide an optimized version as well.
2022
2023 0.15 Sun. Nov. 5, 2006
2024     ++ NOTE ++
2025     This version of Moose *must* have Class::MOP 0.36 in order
2026     to work correctly. A number of small internal tweaks have
2027     been made in order to be compatible with that release.
2028
2029     * Moose::Util::TypeConstraints
2030       - added &unimport so that you can clean out
2031         your class namespace of these exported
2032         keywords
2033
2034     * Moose::Meta::Class
2035       - fixed minor issue which occasionally
2036         comes up during global destruction
2037         (thanks omega)
2038       - moved Moose::Meta::Method::Overriden into
2039         its own file.
2040
2041     * Moose::Meta::Role
2042       - moved Moose::Meta::Role::Method into
2043         its own file.
2044
2045     * Moose::Meta::Attribute
2046       - changed how we do type checks so that
2047         we reduce the overall cost, but still
2048         retain correctness.
2049        *** API CHANGE ***
2050       - moved accessor generation methods to
2051         Moose::Meta::Method::Accessor to
2052         conform to the API changes from
2053         Class::MOP 0.36
2054
2055     * Moose::Meta::TypeConstraint
2056       - changed how constraints are compiled
2057         so that we do less recursion and more
2058         iteration. This makes the type check
2059         faster :)
2060       - moved Moose::Meta::TypeConstraint::Union
2061         into its own file
2062
2063     * Moose::Meta::Method::Accessor
2064       - created this from methods formerly found in
2065         Moose::Meta::Attribute
2066
2067     * Moose::Meta::Role::Method
2068       - moved this from Moose::Meta::Role
2069
2070     * Moose::Meta::Method::Overriden
2071       - moved this from Moose::Meta::Class
2072
2073     * Moose::Meta::TypeConstraint::Union
2074       - moved this from Moose::Meta::TypeConstraint
2075
2076 0.14 Mon. Oct. 9, 2006
2077
2078     * Moose::Meta::Attribute
2079       - fixed lazy attributes which were not getting
2080         checked with the type constraint (thanks ashley)
2081         - added tests for this
2082       - removed the over-enthusiastic DWIMery of the
2083         automatic ArrayRef and HashRef defaults, it
2084         broke predicates in an ugly way.
2085         - removed tests for this
2086
2087 0.13 Sat. Sept. 30, 2006
2088     ++ NOTE ++
2089     This version of Moose *must* have Class::MOP 0.35 in order
2090     to work correctly. A number of small internal tweaks have
2091     been made in order to be compatible with that release.
2092
2093     * Moose
2094       - Removed the use of UNIVERSAL::require to be a better
2095         symbol table citizen and remove a dependency
2096         (thanks Adam Kennedy)
2097
2098       **~~ removed experimental & undocumented feature ~~**
2099       - commented out the 'method' and 'self' keywords, see the
2100         comments for more info.
2101
2102     * Moose::Cookbook
2103       - added a FAQ and WTF files to document frequently
2104         asked questions and common problems
2105
2106     * Moose::Util::TypeConstraints
2107       - added GlobRef and FileHandle type constraint
2108         - added tests for this
2109
2110     * Moose::Meta::Attribute
2111       - if your attribute 'isa' ArrayRef of HashRef, and you have
2112         not explicitly set a default, then make the default DWIM.
2113         This will also work for subtypes of ArrayRef and HashRef
2114         as well.
2115       - you can now auto-deref subtypes of ArrayRef or HashRef too.
2116         - new test added for this (thanks to ashley)
2117
2118     * Moose::Meta::Role
2119       - added basic support for runtime role composition
2120         but this is still *highly experimental*, so feedback
2121         is much appreciated :)
2122         - added tests for this
2123
2124     * Moose::Meta::TypeConstraint
2125       - the type constraint now handles the coercion process
2126         through delegation, this is to support the coercion
2127         of unions
2128
2129     * Moose::Meta::TypeConstraint::Union
2130       - it is now possible for coercions to be performed
2131         on a type union
2132         - added tests for this (thanks to konobi)
2133
2134     * Moose::Meta::TypeCoercion
2135       - properly capturing error when type constraint
2136         is not found
2137
2138     * Build.PL
2139       - Scalar::Util 1.18 is bad on Win32, so temporarily
2140         only require version 1.17 for Win32 and cygwin.
2141         (thanks Adam Kennedy)
2142
2143 0.12 Sat. Sept. 1, 2006
2144     * Moose::Cookbook
2145       - Recipe5 (subtypes & coercion) has been written
2146
2147     * Moose
2148       - fixed "bad meta" error message to be more descriptive
2149       - fixed &unimport to not remove the &inner and &super
2150         keywords because we need to localize them.
2151       - fixed number of spelling/grammer issues, thanks Theory :)
2152
2153       **~~ experimental & undocumented feature ~~**
2154       - added the method and self keywords, they are basically
2155         just sugar, and they may not stay around.
2156
2157     * Moose::Object
2158       - added &dump method to easily Data::Dumper
2159         an object
2160
2161     * Moose::Meta::TypeConstraint
2162       - added the &is_a_type_of method to check both the current
2163         and the subtype of a method (similar to &isa with classes)
2164
2165     * Moose::Meta::Role
2166       - this is now a subclass of Class::MOP::Module, and no longer
2167         creates the _role_meta ugliness of before.
2168         - fixed tests to reflect this change
2169
2170 0.11 Wed. July 12, 2006
2171     * Moose
2172       - added an &unimport method to remove all the keywords
2173         that Moose will import, simply add 'no Moose' to the
2174         bottom of your class file.
2175
2176     * t/
2177       - fixed some test failures caused by a forgotten test
2178         dependency.
2179
2180 0.10 Thurs. July 6, 2006
2181     * Moose
2182       - improved error message when loading modules so
2183         it is less confusing when you load a role.
2184       - added &calculate_all_roles method to
2185         Moose::Meta::Class and Moose::Meta::Role
2186
2187     NOTE:
2188     This module has been tested against Class::MOP 0.30
2189     but it does not yet utilize the optimizations
2190     it makes available. Stay tuned for that ;)
2191
2192 0.09_03 Fri. June 23, 2006
2193     ++ DEVELOPER RELEASE ++
2194     * Moose
2195       - 'use strict' and 'use warnings' are no longer
2196          needed in Moose classes, Moose itself will
2197          turn them on for you.
2198          - added tests for this
2199       - moved code from exported subs to private methods
2200         in Moose::Meta::Class
2201
2202     * Moose::Role
2203       - as with Moose, strict and warnings are
2204         automatically turned on for you.
2205          - added tests for this
2206
2207     * Moose::Meta::Role
2208       - now handles an edge case for override errors
2209         - added tests for this
2210       - added some more edge case tests
2211
2212 0.09_02 Tues. May 16, 2006
2213     ++ DEVELOPER RELEASE ++
2214     * Moose
2215       - added prototypes to the exported subs
2216       - updated docs
2217
2218     * Moose::Role
2219       - added prototypes to the exported subs
2220       - updated docs
2221
2222     * Moose::Util::TypeConstraints
2223       - cleaned up prototypes for the subs
2224       - updated docs
2225
2226 0.09_01 Fri. May 12, 2006
2227     ++ DEVELOPER RELEASE ++
2228       - This release works in combination with
2229         Class::MOP 0.29_01, it is a developer
2230         release because it uses the a new
2231         instance sub-protocol and a fairly
2232         complete Role implementation. It has
2233         not yet been optimized, so it slower
2234         the the previous CPAN version. This
2235         release also lacks good updated docs,
2236         the official release will have updated docs.
2237
2238     * Moose
2239       - refactored the keyword exports
2240         - 'with' now checks Role validaity and
2241           accepts more than one Role at a time
2242         - 'extends' makes metaclass adjustments as
2243            needed to ensure metaclass compatibility
2244
2245     * Moose::Role
2246       - refactored the keyword exports
2247         - 'with' now checks Role validaity and
2248           accepts more than one Role at a time
2249
2250     * Moose::Util::TypeConstraints
2251       - added the 'enum' keyword for simple
2252         string enumerations which can be used as
2253         type constraints
2254         - see example of usage in t/202_example.t
2255
2256     * Moose::Object
2257       - more careful checking of params to new()
2258
2259     * Moose::Meta::Role
2260       - much work done on the role composition
2261         - many new tests for conflict detection
2262           and composition edge cases
2263         - not enough documentation, I suggest
2264           looking at the tests
2265
2266     * Moose::Meta::Instance
2267       - added new Instance metaclass to support
2268         the new Class::MOP instance protocol
2269
2270     * Moose::Meta::Class
2271       - some small changes to support the new
2272         instance protocol
2273       - some small additions to support Roles
2274
2275     * Moose::Meta::Attribute
2276       - some improvements to the accessor generation code
2277         by nothingmuch
2278       - some small changes to support the new
2279         instance protocol
2280       - (still somewhat) experimental delegation support
2281         with the 'handles' option
2282         - added several tests for this
2283         - no docs for this yet
2284
2285 0.05 Thurs. April 27, 2006
2286     * Moose
2287       - keywords are now exported with Sub::Exporter
2288         thanks to chansen for this commit
2289       - has keyword now takes a 'metaclass' option
2290         to support custom attribute meta-classes
2291         on a per-attribute basis
2292         - added tests for this
2293       - the 'has' keyword not accepts inherited slot
2294         specifications (has '+foo'). This is still an
2295         experimental feature and probably not finished
2296         see t/038_attribute_inherited_slot_specs.t for
2297         more details, or ask about it on #moose
2298         - added tests for this
2299
2300     * Moose::Role
2301       - keywords are now exported with Sub::Exporter
2302
2303     * Moose::Utils::TypeConstraints
2304       - reorganized the type constraint hierarchy, thanks
2305         to nothingmuch and chansen for his help and advice
2306         on this
2307         - added some tests for this
2308       - keywords are now exported with Sub::Exporter
2309         thanks to chansen for this commit
2310
2311     * Moose::Meta::Class
2312       - due to changes in Class::MOP, we had to change
2313         construct_instance (for the better)
2314
2315     * Moose::Meta::Attribute
2316       - due to changes in Class::MOP, we had to add the
2317         initialize_instance_slot method (it's a good thing)
2318
2319     * Moose::Meta::TypeConstraint
2320       - added type constraint unions
2321         - added tests for this
2322       - added the is_subtype_of predicate method
2323         - added tests for this
2324
2325 0.04 Sun. April 16th, 2006
2326     * Moose::Role
2327       - Roles can now consume other roles
2328         - added tests for this
2329       - Roles can specify required methods now with
2330         the requires() keyword
2331         - added tests for this
2332
2333     * Moose::Meta::Role
2334       - ripped out much of it's guts ,.. much cleaner now
2335       - added required methods and correct handling of
2336         them in apply() for both classes and roles
2337         - added tests for this
2338       - no longer adds a does() method to consuming classes
2339         it relys on the one in Moose::Object
2340       - added roles attribute and some methods to support
2341         roles consuming roles
2342
2343     * Moose::Meta::Attribute
2344       - added support for triggers on attributes
2345         - added tests for this
2346       - added support for does option on an attribute
2347         - added tests for this
2348
2349     * Moose::Meta::Class
2350       - added support for attribute triggers in the
2351         object construction
2352         - added tests for this
2353
2354     * Moose
2355       - Moose no longer creates a subtype for your class
2356         if a subtype of the same name already exists, this
2357         should DWIM in 99.9999% of all cases
2358
2359     * Moose::Util::TypeConstraints
2360       - fixed bug where incorrect subtype conflicts were
2361         being reported
2362         - added test for this
2363
2364     * Moose::Object
2365       - this class can now be extended with 'use base' if
2366         you need it, it properly loads the metaclass class now
2367         - added test for this
2368
2369 0.03_02 Wed. April 12, 2006
2370     * Moose
2371       - you must now explictly use Moose::Util::TypeConstraints
2372         it no longer gets exported for you automatically
2373
2374     * Moose::Object
2375       - new() now accepts hash-refs as well as key/value lists
2376       - added does() method to check for Roles
2377         - added tests for this
2378
2379     * Moose::Meta::Class
2380       - added roles attribute along with the add_role() and
2381         does_role() methods
2382         - added tests for this
2383
2384     * Moose::Meta::Role
2385       - now adds a does() method to consuming classes
2386         which tests the class's hierarchy for roles
2387         - added tests for this
2388
2389 0.03_01 Mon. April 10, 2006
2390     * Moose::Cookbook
2391       - added new Role recipe (no content yet, only code)
2392
2393     * Moose
2394       - added 'with' keyword for Role support
2395         - added test and docs for this
2396       - fixed subtype quoting bug
2397         - added test for this
2398
2399     * Moose::Role
2400       - Roles for Moose
2401         - added test and docs
2402
2403     * Moose::Util::TypeConstraints
2404       - added the message keyword to add custom
2405         error messages to type constraints
2406
2407     * Moose::Meta::Role
2408       - the meta role to support Moose::Role
2409         - added tests and docs
2410
2411     * Moose::Meta::Class
2412       - moved a number of things from Moose.pm
2413         to here, they should have been here
2414         in the first place
2415
2416     * Moose::Meta::Attribute
2417       - moved the attribute option macros here
2418         instead of putting them in Moose.pm
2419
2420     * Moose::Meta::TypeConstraint
2421       - added the message attributes and the
2422         validate method
2423         - added tests and docs for this
2424
2425 0.03 Thurs. March 30, 2006
2426     * Moose::Cookbook
2427       - added the Moose::Cookbook with 5 recipes,
2428         describing all the stuff Moose can do.
2429
2430     * Moose
2431       - fixed an issue with &extends super class loading
2432         it now captures errors and deals with inline
2433         packages correctly (bug found by mst, solution
2434         stolen from alias)
2435       - added super/override & inner/augment features
2436         - added tests and docs for these
2437
2438     * Moose::Object
2439       - BUILDALL now takes a reference of the %params
2440         that are passed to &new, and passes that to
2441         each BUILD as well.
2442
2443     * Moose::Util::TypeConstraints
2444       - Type constraints now survive runtime reloading
2445         - added test for this
2446
2447         * Moose::Meta::Class
2448           - fixed the way attribute defaults are handled
2449             during instance construction (bug found by chansen)
2450
2451     * Moose::Meta::Attribute
2452       - read-only attributes now actually enforce their
2453         read-only-ness (this corrected in Class::MOP as
2454         well)
2455
2456 0.02 Tues. March 21, 2006
2457     * Moose
2458       - many more tests, fixing some bugs and
2459         edge cases
2460       - &extends now loads the base module with
2461         UNIVERSAL::require
2462         - added UNIVERSAL::require to the
2463           dependencies list
2464       ** API CHANGES **
2465       - each new Moose class will also create
2466         and register a subtype of Object which
2467         correspond to the new Moose class.
2468       - the 'isa' option in &has now only
2469         accepts strings, and will DWIM in
2470         almost all cases
2471
2472     * Moose::Util::TypeConstraints
2473       - added type coercion features
2474         - added tests for this
2475         - added support for this in attributes
2476           and instance construction
2477       ** API CHANGES **
2478       - type construction no longer creates a
2479         function, it registers the type instead.
2480         - added several functions to get the
2481           registered types
2482
2483     * Moose::Object
2484       - BUILDALL and DEMOLISHALL were broken
2485         because of a mis-named hash key, Whoops :)
2486
2487     * Moose::Meta::Attribute
2488       - adding support for coercion in the
2489         autogenerated accessors
2490
2491     * Moose::Meta::Class
2492       - adding support for coercion in the
2493         instance construction
2494
2495     * Moose::Meta::TypeConstraint
2496     * Moose::Meta::TypeCoercion
2497           - type constraints and coercions are now
2498             full fledges meta-objects
2499
2500 0.01 Wed. March 15, 2006
2501     - Moooooooooooooooooose!!!