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