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