cleaned up log
[gitmo/Moose.git] / Changes
1 Revision history for Perl extension Moose
2
3 0.60
4     * Moose::Exporter
5       - Passing "-traits" when loading Moose caused the Moose.pm
6         exports to be broken. Reported by t0m. (Dave Rolsky)
7         - Tests for this bug. (t0m)
8     * Moose::Util::TypeConstraint
9       - Put back the changes for parameterized constraints that
10         shouldn't have been removed in 0.59. We still cannot parse
11         them, but MooseX modules can create them in some other
12         way. See the 0.58 changes for more details. (jnapiorkowski)
13       - changed the way subtypes are created so that the job is delegated to a
14         type constraint parent.  This clears up some hardcoded checking and
15         should allow correct subtypes of Moose::Meta::Type::Constraint
16     * Moose::Meta::TypeConstraint
17       - added new method 'create_childtype' so that a parent can now be in
18         charge of creating and influencing it's own children.
19     * Moose::Meta::TypeConstraint::Union
20       - more careful sorting of the type constraints that make up a name string
21       - support for create_childtype customization
22     * Moose::Meta::TypeConstraint::Parameterized
23       - support for create_childtype customization
24     * Moose::Meta::TypeConstraint::Parameterizable
25       - new parameterize method which is a type of factory method to make a new
26         type constraint with a given parameterized type.
27     * Moose::Util
28       - Change resolve_metaclass alias to use the new
29         load_first_existing_class function. This makes it a lot
30         simpler, and also around 5 times faster. (t0m)
31       - Add caching to resolve_metaclass_alias, which gives an order
32         of magnitude speedup to things which repeatedly call the
33         Moose::Meta::Attribute->does method, notably MooseX::Storage
34         (t0m)
35     * /t/040_type_constraints/027_parameterize_from.t
36       - test to make sure the new parameterize method works.
37     * /t/040_type_constraints/030-class_subtypes.t
38       - test to make sure we can properly subclass Moose::Meta::TypeConstraint
39
40 0.59 Tue October 14, 2008
41     * Moose
42       - Add abridged documentation for builder/default/initializer/
43         predicate, and link to more details sections in 
44         Class::MOP::Attribute. (t0m)
45
46     * Moose::Util::TypeConstraints
47       - removed prototypes from all but the &-based stuff (mst)
48
49     * Moose::Util::TypeConstraints
50       - Creating a anonymous subtype with both a constraint and a
51         message failed with a very unhelpful error, but should just
52         work. Reported by t0m. (Dave Rolsky)
53
54     * Tests
55       - Some tests that used Test::Warn if it was available failed
56         with older versions of Test::Warn. Reported by Fayland. (Dave
57         Rolsky)
58       - Test firing behavior of triggers in relation to builder/default/
59         lazy_build. (t0m)
60       - Test behavior of equals/is_a_type_of/is_a_subtype_of for all
61         kinds of supported type. (t0m)
62
63     * Moose::Meta::Class
64       - In create(), do not pass "roles" option to the superclass
65         - added related test that creates an anon metaclass with
66           a required attribute
67
68     * Moose::Meta::TypeConstraint::Class
69     * Moose::Meta::TypeConstraint::Role
70       - Unify behavior of equals/is_a_type_of/is_a_subtype_of with
71         other types (as per change in 0.55_02). (t0m)
72
73     * Moose::Meta::TypeConstraint::Registry
74       - Fix warning when dealing with unknown type names (t0m)
75
76     * Moose::Util::TypeConstraints
77       - Reverted changes from 0.58 related to handle parameterized
78         types. This caused random failures on BSD and Win32 systems,
79         apparently related to the regex engine. This means that Moose
80         can no longer parse structured type constraints like
81         ArrayRef[Int,Int] or HashRef[name=>Str]. This will be
82         supported in a slightly different way via MooseX::Types some
83         time in the future. (Dave Rolsky)
84
85 0.58 Sat September 20, 2008
86     !! This release has an incompatible change regarding !!
87     !! how roles add methods to a class !!
88
89     * Roles and role application
90       ! Roles now add methods by calling add_method, not
91         alias_method. They make sure to always provide a method
92         object, which will be cloned internally. This means that it is
93         now possible to track the source of a method provided by a
94         role, and even follow its history through intermediate roles.
95
96         This means that methods added by a role now show up when
97         looking at a class's method list/map. (Dave Rolsky)
98
99     * Makefile.PL
100       - From this release on, we'll try to maintain a list of
101         conflicting modules, and warn you if you have one
102         installed. For example, this release conflicts with ...
103         - MooseX::Singleton        <= 0.11
104         - MooseX::Params::Validate <= 0.05
105         - Fey::ORM                 <= 0.10
106
107         In general, we try to not break backwards compatibility for
108         most Moose users, but MooseX modules and other code which
109         extends Moose's metaclasses is often affected by very small
110         changes in the Moose internals.
111
112     * Moose::Meta::Method::Delegation
113     * Moose::Meta::Attribute
114       - Delegation methods now have their own method class. (Dave
115         Rolsky)
116
117     * Moose::Meta::TypeConstraint::Parameterizable
118       - Added a new method 'parameterize' which is basically a factory
119         for the containing constraint.  This makes it easier to create
120         new types of parameterized constraints. (jnapiorkowski)
121
122     * Moose::Meta::TypeConstraint::Union
123       - Changed the way Union types canonicalize their names to follow
124         the normalized TC naming rules, which means we strip all
125         whitespace. (jnapiorkowski)
126
127     * Moose::Util::TypeConstraints
128       - Parameter and Union args are now sorted, this makes Int|Str
129         the same constraint as Str|Int. (jnapiorkowski)
130       - Changes to the way Union types are parsed to more correctly
131         stringify their names. (jnapiorkowski)
132       - When creating a parameterized type, we now use the new
133         parameterize method. (jnapiorkowski)
134       - Incoming type constraint strings are now normalized to remove
135         all whitespace differences. (jnapiorkowski)
136       - Changed the way we parse type constraint strings so that we now
137         match TC[Int,Int,...] and TC[name=>Str] as parameterized type
138         constraints.  This lays the foundation for more flexible type
139         constraint implementations.
140
141     * Tests and docs for all the above. (jnapiorkowski)
142
143     * Moose::Exporter
144     * Moose
145       - Moose::Exporter will no longer remove a subroutine that the
146         exporting package re-exports. Moose re-exports the
147         Carp::confess function, among others. The reasoning is that we
148         cannot know whether you have also explicitly imported those
149         functions for your own use, so we err on the safe side and
150         always keep them. (Dave Rolsky)
151         - added tests for this (rafl)
152
153     * Moose::Meta::Class
154       - Changes to how we fix metaclass compatibility that are much
155         too complicated to go into. The summary is that Moose is much
156         less likely to complain about metaclass incompatibility
157         now. In particular, if two metaclasses differ because
158         Moose::Util::MetaRole was used on the two corresponding
159         classes, then the difference in roles is reconciled for the
160         subclass's metaclass. (Dave Rolsky)
161       - Squashed an warning in _process_attribute (thepler)
162
163     * Moose::Meta::Role
164       - throw exceptions (sooner) for invalid attribute names (thepler)
165         - added tests for this (thepler)
166
167     * Moose::Util::MetaRole
168       - If you explicitly set a constructor or destructor class for a
169         metaclass object, and then applied roles to the metaclass,
170         that explicitly set class would be lost and replaced with the
171         default.
172
173     * Moose::Meta::Class
174     * Moose::Meta::Attribute
175     * Moose::Meta::Method
176     * Moose
177     * Moose::Object
178     * Moose::Error::Default
179     * Moose::Error::Croak
180     * Moose::Error::Confess
181       - All instances of confess() changed to use overridable
182         C<throw_error> method. This method ultimately calls a class
183         constructor, and you can change the class being called. In
184         addition, errors now pass more information than just a string.
185         The default C<error_class> behaves like C<Carp::confess>, so
186         the behavior is not visibly different for end users.
187
188 0.57 Wed September 3, 2008
189     * Moose::Intro
190       - A new bit of doc intended to introduce folks familiar with
191         "standard" Perl 5 OO to Moose concepts. (Dave Rolsky)
192
193     * Moose::Unsweetened
194       - Shows examples of two classes, each done first with and then
195         without Moose. This makes a nice parallel to
196         Moose::Intro. (Dave Rolsky)
197
198     * Moose::Util::TypeConstraints
199       - Fixed a bug in find_or_parse_type_constraint so that it
200         accepts a Moose::Meta::TypeConstraint object as the parent
201         type, not just a name (jnapiorkowski)
202         - added tests (jnapiorkowski)
203
204     * Moose::Exporter
205       - If Sub::Name was not present, unimporting failed to actually
206         remove some sugar subs, causing test failures (Dave Rolsky)
207
208 0.56 Mon September 1, 2008
209     For those not following the series of dev releases, there are
210     several major changes in this release of Moose.
211       ! Moose::init_meta should now be called as a method. See the
212         docs for details.
213
214       - Major performance improvements by nothingmuch.
215
216       - New modules for extension writers, Moose::Exporter and
217         Moose::Util::MetaRole by Dave Rolsky.
218
219       - Lots of doc improvements and additions, especially in the
220         cookbook sections.
221
222       - Various bug fixes.
223
224     * Removed all references to the experimental-but-no-longer-needed
225       Moose::Meta::Role::Application::ToMetaclassInstance.
226
227     * Require Class::MOP 0.65.
228
229 0.55_04 Sat August 30, 2008
230     * Moose::Util::MetaRole
231     * Moose::Cookbook::Extending::Recipe2
232       - This simplifies the application of roles to any meta class, as
233         well as the base object class. Reimplemented metaclass traits
234         using this module. (Dave Rolsky)
235
236     * Moose::Cookbook::Extending::Recipe1
237       - This a new recipe, an overview of various ways to write Moose
238         extensions (Dave Rolsky)
239
240     * Moose::Cookbook::Extending::Recipe3
241     * Moose::Cookbook::Extending::Recipe4
242       - These used to be Extending::Recipe1 and Extending::Recipe2,
243         respectively.
244
245 0.55_03 Fri August 29, 2008
246     * No changes from 0.55_02 except increasing the Class::MOP
247       dependency to 0.64_07.
248
249 0.55_02 Fri August 29, 2008
250     * Makefile.PL and Moose.pm
251       - explicitly require Perl 5.8.0+ (Dave Rolsky)
252
253     * Moose::Util::TypeConstraints
254       - Fix warnings from find_type_constraint if the type is not 
255         found (t0m).
256       
257     * Moose::Meta::TypeConstraint
258       - Predicate methods (equals/is_a_type_of/is_subtype_of) now
259         return false if the type you specify cannot be found in the
260         type registry, rather than throwing an unhelpful and
261         coincidental exception. (t0m).
262         - added docs & test for this (t0m)
263     
264     * Moose::Meta::TypeConstraint::Registry
265       - add_type_constraint now throws an exception if a parameter is
266         not supplied (t0m).
267         - added docs & test for this (t0m)
268
269     * Moose::Cookbook::FAQ
270       - Added a faq entry on the difference between "role" and "trait"
271         (t0m)
272
273     * Moose::Meta::Role
274       - Fixed a bug that caused role composition to not see a required
275         method when that method was provided by another role being
276         composed at the same time. (Dave Rolsky)
277         - test and bug finding (tokuhirom)
278         
279 0.55_01 Wed August 20, 2008
280
281     !! Calling Moose::init_meta as a function is now         !!
282     !! deprecated. Please see the Moose.pm docs for details. !!
283
284     * Moose::Meta::Method::Constructor
285       - Fix inlined constructor so that values produced by default
286         or builder methods are coerced as required. (t0m)
287         - added test for this (t0m)
288
289     * Moose::Meta::Attribute
290       - A lazy attribute with a default or builder did not attempt to
291         coerce the default value. The immutable code _did_
292         coerce. (t0m)
293         - added test for this (t0m)
294
295     * Moose::Exporter
296       - This is a new helper module for writing "Moose-alike"
297         modules. This should make the lives of MooseX module authors
298         much easier. (Dave Rolsky)
299
300     * Moose
301     * Moose::Cookbook::Meta::Recipe5
302       - Implemented metaclass traits (and wrote a recipe for it):
303
304           use Moose -traits => 'Foo'
305
306         This should make writing small Moose extensions a little
307         easier (Dave Rolsky)
308
309     * Moose::Cookbook::Basics::Recipe1
310       - Removed any examples of direct hashref access, and applied an
311         editorial axe to reduce verbosity. (Dave Rolsky)
312
313     * Moose::Cookbook::Basics::Recipe1
314       - Also applied an editorial axe here. (Dave Rolsky)
315
316     * Moose
317     * Moose::Cookbook::Extending::Recipe1
318     * Moose::Cookbook::Extending::Recipe2
319       - Rewrote extending and embedding moose documentation and
320         recipes to use Moose::Exporter (Dave Rolsky)
321
322     * Moose
323     * Moose::Role
324       - These two modules now warn when you load them from the main
325         package "main" package, because we will not export sugar to
326         main. Previously it just did nothing. (Dave Rolsky)
327
328     * Moose::Role
329       - Now provide an init_meta method just like Moose.pm, and you
330         can call this to provide an alternate role metaclass. (Dave
331         Rolsky and nothingmuch)
332       - get_method_map now respects the package cache flag (nothingmuch)
333
334     * Moose::Meta::Role
335       - Two new methods - add_method and wrap_method_body
336         (nothingmuch)
337
338     * many modules
339       - Optimizations including allowing constructors to accept hash
340         refs, making many more classes immutable, and making
341         constructors immutable. (nothingmuch)
342
343 0.55 Sun August 3, 2008
344     * Moose::Meta::Attribute
345       - breaking down the way 'handles' methods are
346         created so that the process can be more easily
347         overridden by subclasses (stevan)
348
349     * Moose::Meta::TypeConstraint
350       - fixing what is passed into a ->message with
351         the type constraints (RT #37569)
352         - added tests for this (Charles Alderman)
353
354     * Moose::Util::TypeConstraints
355       - fix coerce to accept anon types like subtype can (mst)
356
357     * Moose::Cookbook
358       - reorganized the recipes into sections - Basics, Roles, Meta,
359         Extending - and wrote abstracts for each section (Dave Rolsky)
360
361     * Moose::Cookbook::Basics::Recipe10
362       - A new recipe that demonstrates operator overloading
363         in combination with Moose. (bluefeet)
364
365     * Moose::Cookbook::Meta::Recipe1
366       - an introduction to what meta is and why you'd want to make
367         your own metaclass extensions (Dave Rolsky)
368
369     * Moose::Cookbook::Meta::Recipe4
370       - a very simple metaclass example (Dave Rolsky)
371
372     * Moose::Cookbook::Extending::Recipe1
373       - how to write a Moose-alike module to use your own object base
374         class (Dave Rolsky)
375
376     * Moose::Cookbook::Extending::Recipe2
377       - how to write modules with an API just like C<Moose.pm> (Dave
378         Rolsky)
379
380     * all documentation
381       - Tons of fixes, both syntactical and grammatical (Dave
382         Rolsky, Paul Fenwick)
383
384 0.54 Thurs. July 3, 2008
385     ... this is not my day today ...
386     
387     * Moose::Meta::Attribute
388       - fixed legal_options_for_inheritance such that 
389         clone_and_inherit options still works for 
390         Class::MOP::Attribute objects and therefore 
391         does not break MooseX::AttributeHelpers
392         (stevan)
393
394 0.53 Thurs. July 3, 2008
395     * Whoops, I guess I should run 'make manifest' before 
396       actually releasing the module. No actual changes 
397       in this release, except the fact that it includes
398       the changes that I didn't include in the last 
399       release. (stevan--)
400
401 0.52 Thurs. July 3, 2008
402     * Moose
403       - added "FEATURE REQUESTS" section to the Moose docs
404         to properly direct people (stevan) (RT #34333)
405       - making 'extends' croak if it is passed a Role since 
406         this is not ever something you want to do 
407         (fixed by stevan, found by obra)
408         - added tests for this (stevan)
409
410     * Moose::Object
411       - adding support for DOES (as in UNIVERSAL::DOES) 
412         (nothingmuch)
413         - added test for this
414
415     * Moose::Meta::Attribute
416       - added legal_options_for_inheritance (wreis)
417         - added tests for this (wreis)
418
419     * Moose::Cookbook::Snacks::*
420       - removed some of the unfinished snacks that should 
421         not have been released yet. Added some more examples
422         to the 'Keywords' snack. (stevan)
423
424     * Moose::Cookbook::Style
425       - added general Moose "style guide" of sorts to the 
426         cookbook (nothingmuch) (RT #34335)
427
428     * t/
429       - added more BUILDARGS tests (stevan)
430
431 0.51 Thurs. Jun 26, 2008
432     * Moose::Role
433       - add unimport so "no Moose::Role" actually does
434         something (sartak)
435
436     * Moose::Meta::Role::Application::ToRole
437       - when RoleA did RoleB, and RoleA aliased a method from RoleB in
438         order to provide its own implementation, that method still got
439         added to the list of required methods for consumers of
440         RoleB. Now an aliased method is only added to the list of
441         required methods if the role doing the aliasing does not
442         provide its own implementation. See Recipe 11 for an example
443         of all this. (Dave Rolsky)
444         - added tests for this
445
446     * Moose::Meta::Method::Constructor
447       - when a single argument that wasn't a hashref was provided to
448         an immutabilized constructor, the error message was very
449         unhelpful, as opposed to the non-immutable error. Reported by
450         dew. (Dave Rolsky)
451         - added test for this (Dave Rolsky)
452
453     * Moose::Meta::Attribute
454       - added support for meta_attr->does("ShortAlias") (sartak)
455         - added tests for this (sartak)
456       - moved the bulk of the `handles` handling to the new
457         install_delegation method (Stevan)
458
459     * Moose::Object
460       - Added BUILDARGS, a new step in new()
461
462     * Moose::Meta::Role::Application::RoleSummation
463       - fix typos no one ever sees (sartak)
464
465     * Moose::Util::TypeConstraints
466     * Moose::Meta::TypeConstraint
467     * Moose::Meta::TypeCoercion
468       - Attempt to work around the ??{ } vs. threads issue
469         (not yet fixed)
470       - Some null_constraint optimizations
471
472 0.50 Thurs. Jun 11, 2008
473     - Fixed a version number issue by bumping all modules
474       to 0.50.
475
476 0.49 Thurs. Jun 11, 2008
477     !! This version now approx. 20-25% !!
478     !! faster with new Class::MOP 0.59 !!
479
480     * Moose::Meta::Attribute
481       - fixed how the is => (ro|rw) works with 
482         custom defined reader, writer and accessor
483         options. 
484         - added docs for this (TODO).
485         - added tests for this (Thanks to Penfold)
486       - added the custom attribute alias for regular
487         Moose attributes which is "Moose"
488       - fix builder and default both being used
489         (groditi)
490
491     * Moose
492       Moose::Meta::Class
493       Moose::Meta::Attribute
494       Moose::Meta::Role
495       Moose::Meta::Role::Composite
496       Moose::Util::TypeConstraints
497       - switched usage of reftype to ref because 
498         it is much faster
499         
500     * Moose::Meta::Role
501       - changing add_package_symbol to use the new
502         HASH ref form
503     
504     * Moose::Object
505       - fixed how DEMOLISHALL is called so that it 
506         can be overrided in subclasses (thanks to Sartak)
507         - added test for this (thanks to Sartak)
508
509     * Moose::Util::TypeConstraints
510       - move the ClassName type check code to
511         Class::MOP::is_class_loaded (thanks to Sartak)
512
513     * Moose::Cookbook::Recipe11
514       - add tests for this (thanks to tokuhirom)
515
516 0.48 Thurs. May 29, 2008
517     (early morning release engineering)--
518
519     - fixing the version in Moose::Meta::Method::Destructor
520       which was causing the indexer to choke
521
522 0.47 Thurs. May 29, 2008
523     (late night release engineering)--
524
525     - fixing the version is META.yml, no functional 
526       changes in this release
527
528 0.46 Wed. May 28, 2008
529     !! This version now approx. 20-25% !!
530     !! faster with new Class::MOP 0.57 !!
531
532     * Moose::Meta::Class
533       - some optimizations of the &initialize method
534         since it is called so often by &meta    
535         
536     * Moose::Meta::Class
537       Moose::Meta::Role
538       - now use the get_all_package_symbols from the 
539         updated Class::MOP, test suite is now 10 seconds 
540         faster
541     
542     * Moose::Meta::Method::Destructor
543       - is_needed can now also be called as a class 
544         method for immutablization to check if the 
545         destructor object even needs to be created 
546         at all
547     
548     * Moose::Meta::Method::Destructor
549       Moose::Meta::Method::Constructor
550       - added more descriptive error message to help 
551         keep people from wasting time tracking an error
552         that is easily fixed by upgrading.
553
554 0.45 Saturday, May 24, 2008
555     * Moose
556       - Because of work in Class::MOP 0.57, all 
557         XS based functionality is now optional
558         and a Pure Perl version is supplied
559         - the CLASS_MOP_NO_XS environment variable
560           can now be used to force non-XS versions 
561           to always be used   
562         - several of the packages have been tweaked
563           to take care of this, mostly we added
564           support for the package_name and name 
565           variables in all the Method metaclasses
566       - before/around/after method modifiers now 
567         support regexp matching of names
568         (thanks to Takatoshi Kitano)
569         - tests added for this
570         - NOTE: this only works for classes, it 
571           is currently not supported in roles, 
572           but, ... patches welcome
573       - All usage of Carp::confess have been replaced
574         by Carp::croak in the "keyword" functions since
575         the stack trace is usually not helpful
576       
577     * Moose::Role
578       - All usage of Carp::confess have been replaced
579         by Carp::croak in the "keyword" functions since
580         the stack trace is usually not helpful  
581       - The 'has' keyword for roles now accepts the 
582         same array ref form that Moose.pm does 
583         (has [qw/foo bar/] => (is => 'rw', ...))
584         - added test for this
585       
586     * Moose::Meta::Attribute
587       - trigger on a ro-attribute is no longer an
588         error, as it's useful to trigger off of the
589         constructor
590
591     * Moose::Meta::Class
592       - added same 'add_package_symbol' fix as in 
593         Class::MOP 0.57
594
595     * Moose::Util
596       - does_role now handles non-Moose classes 
597         more gracefully
598         - added tests for this
599       - added the 'add_method_modifier' function 
600         (thanks to Takatoshi Kitano)
601
602     * Moose::Util::TypeConstraints
603       - subtypes of parameterizable types now are 
604         themselves parameterizable types
605
606     * Moose::Meta::Method::Constructor
607       - fixed bug where trigger was not being 
608         called by the inlined immutable 
609         constructors 
610         - added test for this (thanks to Caelum)
611     
612     * Moose::Meta::Role::Application::ToInstance
613       - now uses the metaclass of the instance
614         (if possible) to create the anon-class
615         (thanks Jonathan Rockway)
616     
617     * Moose::Cookbook::Recipe22
618       - added the meta-attribute trait recipe
619         (thanks to Sartak)
620     
621     * t/
622       - fixed hash-ordering test bug that was 
623         causing occasional cpantester failures
624       - renamed the t/000_recipe/*.t tests to be 
625         more descriptive (thanks to Sartak) 
626
627 0.44 Sat. May 10, 2008
628     * Moose
629       - made make_immutable warning cluck to 
630         show where the error is (thanks mst)
631     
632     * Moose::Object
633       - BUILDALL and DEMOLISHALL now call 
634         ->body when looping through the 
635         methods, to avoid the overloaded
636         method call.
637       - fixed issue where DEMOLISHALL was
638         eating the $@ values, and so not 
639         working correctly, it still kind of
640         eats them, but so does vanilla perl 
641         - added tests for this
642       
643     * Moose::Cookbook::Recipe7
644       - added new recipe for immutable 
645         functionality (thanks Dave Rolsky)
646       
647     * Moose::Cookbook::Recipe9
648       - added new recipe for builder and 
649         lazy_build (thanks Dave Rolsky)
650       
651     * Moose::Cookbook::Recipe11
652       - added new recipe for method aliasing 
653         and exclusion with Roles (thanks Dave Rolsky)
654
655     * t/
656       - fixed Win32 test failure (thanks spicyjack)
657
658     ~ removed Build.PL and Module::Build compat 
659       since Module::Install has done that.
660
661 0.43 Wed. April, 30, 2008
662     * NOTE TO SELF:
663         drink more coffee before 
664         doing release engineering
665       
666     - whoops, forgot to do the smolder tests, 
667       and we broke some of the custom meta-attr
668       modules. This fixes that.
669
670 0.42 Mon. April 28, 2008
671     - some bad tests slipped by, nothing else 
672       changed in this release (cpantesters++)
673       
674     - upped the Class::MOP dependency to 0.55 
675       since we have tests which need the C3 
676       support
677
678 0.41 Mon. April 28, 2008
679     ~~ numerous documentation updates ~~
680     
681     - Changed all usage of die to Carp::croak for better
682       error reporting (initial patch by Tod Hagan)
683
684     ** IMPORTANT NOTE **
685     - the make_immutable keyword is now deprecated, don't
686       use it in any new code and please fix your old code
687       as well. There will be 2 releases, and then it will
688       be removed.
689
690     * Moose
691       Moose::Role
692       Moose::Meta::Class
693       - refactored the way inner and super work to avoid
694         any method/@ISA cache penalty (nothingmuch)
695
696     * Moose::Meta::Class
697       - fixing &new_object to make sure trigger gets the 
698         coerced value (spotted by Charles Alderman on the 
699         mailing list)
700         - added test for this
701
702     * Moose::Meta::Method::Constructor
703       - immutable classes which had non-lazy attributes were calling
704         the default generating sub twice in the constructor. (bug
705         found by Jesse Luehrs, fixed by Dave Rolsky)
706         - added tests for this (Dave Rolsky)
707       - fix typo in initialize_body method (nothingmuch)
708       
709     * Moose::Meta::Method::Destructor
710       - fix typo in initialize_body method (nothingmuch)
711
712     * Moose::Meta::Method::Overriden
713       Moose::Meta::Method::Augmented
714       - moved the logic for these into their own 
715         classes (nothingmuch)
716
717     * Moose::Meta::Attribute
718       - inherited attributes may now be extended without 
719         restriction on the type ('isa', 'does') (Sartak)
720         - added tests for this (Sartak)
721       - when an attribute property is malformed (such as lazy without 
722         a default), give the name of the attribute in the error 
723         message (Sartak)
724       - added the &applied_traits and &has_applied_traits methods 
725         to allow introspection of traits
726         - added tests for this
727       - moved 'trait' and 'metaclass' argument handling to here from
728         Moose::Meta::Class
729       - clone_and_inherit_options now handles 'trait' and 'metaclass' (has
730         '+foo' syntax) (nothingmuch)
731         - added tests for this (t0m)
732      
733     * Moose::Object 
734       - localize $@ inside DEMOLISHALL to avoid it 
735         eating $@ (found by Ernesto)
736         - added test for this (thanks to Ernesto)
737
738     * Moose::Util::TypeConstraints
739       - &find_type_constraint now DWIMs when given an 
740         type constraint object or name (nothingmuch)
741       - &find_or_create_type_constraint superseded with a number of more
742         specific functions:
743         - find_or_create_{isa,does}_type_constraint
744         - find_or_parse_type_constraint
745
746     * Moose::Meta::TypeConstraint
747       Moose::Meta::TypeConstraint::Class
748       Moose::Meta::TypeConstraint::Role
749       Moose::Meta::TypeConstraint::Enum
750       Moose::Meta::TypeConstraint::Union
751       Moose::Meta::TypeConstraint::Parameterized
752         - added the &equals method for comparing two type 
753           constraints (nothingmuch)
754           - added tests for this (nothingmuch)
755
756     * Moose::Meta::TypeConstraint
757       - add the &parents method, which is just an alias to &parent. 
758         Useful for polymorphism with TC::{Class,Role,Union} (nothingmuch)
759
760     * Moose::Meta::TypeConstraint::Class
761       - added the class attribute for introspection purposes
762         (nothingmuch)
763         - added tests for this
764         
765     * Moose::Meta::TypeConstraint::Enum
766       Moose::Meta::TypeConstraint::Role
767       - broke these out into their own classes (nothingmuch)
768
769     * Moose::Cookbook::Recipe*
770       - fixed references to test file locations in the POD
771         and updated up some text for new Moose features
772         (Sartak)
773
774     * Moose::Util
775       - Added &resolve_metaclass_alias, a helper function for finding an actual
776         class for a short name (e.g. in the traits list)
777
778 0.40 Fri. March 14, 2008
779     - I hate Pod::Coverage
780
781 0.39 Fri. March 14, 2008
782     * Moose
783       - documenting the use of '+name' with attributes 
784         that come from recently composed roles. It makes
785         sense, people are using it, and so why not just 
786         officially support it.
787       - fixing the 'extends' keyword so that it will not 
788         trigger Ovid's bug (http://use.perl.org/~Ovid/journal/35763)
789       
790     * oose
791       - added the perl -Moose=+Class::Name feature to allow 
792         monkeypatching of classes in one liners
793       
794     * Moose::Util
795       - fixing the 'apply_all_roles' keyword so that it will not 
796         trigger Ovid's bug (http://use.perl.org/~Ovid/journal/35763)    
797     
798     * Moose::Meta::Class
799       - added ->create method which now supports roles (thanks to jrockway)
800         - added tests for this
801       - added ->create_anon_class which now supports roles and caching of 
802         the results (thanks to jrockway)
803         - added tests for this
804       - made ->does_role a little more forgiving when it is
805         checking a Class::MOP era metaclasses.
806     
807     * Moose::Meta::Role::Application::ToInstance
808       - it is now possible to pass extra params to be used when 
809         a role is applied to an the instance (rebless_params)
810         - added tests for this
811     
812     * Moose::Util::TypeConstraints
813       - class_type now accepts an optional second argument for a
814         custom message. POD anotated accordingly (groditi)
815         - added tests for this 
816       - it is now possible to make anon-enums by passing 'enum' an 
817         ARRAY ref instead of the $name => @values. Everything else 
818         works as before.
819         - added tests for this
820     
821     * t/
822       - making test for using '+name' on attributes consumed 
823         from a role, it works and makes sense too.    
824
825     * Moose::Meta::Attribute 
826       - fix handles so that it doesn't return nothing 
827         when the method cannot be found, not sure why 
828         it ever did this originally, this means we now
829         have slightly better support for AUTOLOADed 
830         objects
831         - added more delegation tests
832       - adding ->does method to this so as to better 
833         support traits and their introspection.
834         - added tests for this
835     
836     * Moose::Object
837       - localizing the Data::Dumper configurations so 
838         that it does not pollute others (RT #33509)
839       - made ->does a little more forgiving when it is
840         passed Class::MOP era metaclasses.
841
842 0.38 Fri. Feb. 15, 2008
843     * Moose::Meta::Attribute 
844       - fixed initializer to correctly do 
845         type checking and coercion in the 
846         callback 
847         - added tests for this
848
849     * t/
850       - fixed some finicky tests (thanks to konobi)
851
852 0.37 Thurs. Feb. 14, 2008
853     * Moose
854       - fixed some details in Moose::init_meta 
855         and its superclass handling (thanks thepler)
856         - added tests for this (thanks thepler)
857       - 'has' now dies if you don't pass in name 
858         value pairs
859       - added the 'make_immutable' keyword as a shortcut
860         to make_immutable
861
862     * Moose::Meta::Class
863       Moose::Meta::Method::Constructor
864       Moose::Meta::Attribute        
865       - making (init_arg => undef) work here too
866         (thanks to nothingmuch)
867         
868     * Moose::Meta::Attribute        
869       Moose::Meta::Method::Constructor
870       Moose::Meta::Method::Accessor                
871       - make lazy attributes respect attr initializers (rjbs)
872         - added tests for this
873     
874     * Moose::Util::TypeConstraints
875       Moose::Util::TypeConstraints::OptimizedConstraints
876       Moose::Meta::TypeConstraints
877       Moose::Meta::Attribute
878       Moose::Meta::Method::Constructor
879       Moose::Meta::Method::Accessor            
880       - making type errors use the 
881         assigned message (thanks to Sartak)
882         - added tests for this
883
884     * Moose::Meta::Method::Destructor
885       - making sure DESTROY gets inlined properly 
886         with successive DEMOLISH calls (thanks to manito)
887
888     * Moose::Meta::Attribute  
889       Moose::Meta::Method::Accessor 
890       - fixed handling of undef with type constraints 
891         (thanks to Ernesto)               
892         - added tests for this
893     
894     * Moose::Util
895       - added &get_all_init_args and &get_all_attribute_values 
896         (thanks to Sartak and nothingmuch)
897
898 0.36 Sat. Jan. 26, 2008
899     * Moose::Role
900       Moose::Meta::Attribute
901       - role type tests now support when roles are 
902         applied to non-Moose classes (found by ash)
903         - added tests for this (thanks to ash)
904       - couple extra tests to boost code coverage
905
906     * Moose::Meta::Method::Constructor    
907       - improved fix for handling Class::MOP attributes
908         - added test for this        
909       
910     * Moose::Meta::Class
911       - handled the add_attribute($attribute_meta_object)
912         case correctly
913         - added test for this
914
915 0.35 Tues. Jan. 22, 2008
916     * Moose::Meta::Method::Constructor
917       - fix to make sure even Class::MOP attributes 
918         are handled correctly (Thanks to Dave Rolsky)
919         - added test for this (also Dave Rolsky)
920     
921     * Moose::Meta::Class
922       - improved error message on _apply_all_roles, 
923         you should now use Moose::Util::apply_all_roles
924         and you shouldnt have been using a _ prefixed
925         method in the first place ;)
926
927 0.34 Mon. Jan. 21, 2008
928     ~~~ more misc. doc. fixes ~~~
929     ~~ updated copyright dates ~~
930
931     Moose is now a postmodern object system :)
932       - (see the POD for details)
933       
934     * <<Role System Refactoring>>    
935     - this release contains a major reworking and 
936       cleanup of the role system     
937       - 100% backwards compat.
938       - Role application now restructured into seperate
939         classes based on type of applicants
940       - Role summation (combining of more than one role)
941         is much cleaner and anon-classes are no longer 
942         used in this process
943       - new Composite role metaclass    
944       - runtime application of roles to instances
945         is now more efficient and re-uses generated
946         classes when applicable
947         
948     * <<New Role composition features>>
949       - methods can now be excluded from a given role 
950         during composition
951       - methods can now be aliased to another name (and 
952         still retain the original as well)        
953     
954     * Moose::Util::TypeConstraints::OptimizedConstraints
955       - added this module (see above)
956
957     * Moose::Meta::Class
958       - fixed the &_process_attribute method to be called
959         by &add_attribute, so that the API is now correct
960
961     * Moose::Meta::Method::Accessor
962       - fixed bug when passing a list of values to
963         an accessor would get (incorrectly) ignored.
964         Thanks to Sartak for finding this ;)
965         - added tests for this (Sartak again)
966
967     * Moose::Meta::Method::Accessor
968       Moose::Meta::Method::Constructor
969       Moose::Meta::Attribute
970       Moose::Meta::TypeConstraint      
971       Moose::Meta::TypeCoercion      
972       - lots of cleanup of such things as: 
973         - generated methods
974         - type constraint handling
975         - error handling/messages 
976         (thanks to nothingmuch)   
977     
978     * Moose::Meta::TypeConstraint::Parameterizable
979       - added this module to support the refactor 
980         in Moose::Meta::TypeConstraint::Parameterized
981
982     * Moose::Meta::TypeConstraint::Parameterized
983       - refactored how these types are handled so they 
984         are more generic and not confined to ArrayRef
985         and HashRef only
986
987     * t/
988       - shortened some file names for better VMS support (RT #32381)
989
990 0.33 Fri. Dec. 14, 2007
991     !! Moose now loads 2 x faster !!
992     !!  with new Class::MOP 0.49  !!
993
994     ++ new oose.pm module to make command line
995        Moose-ness easier (see POD docs for more)
996
997     * Moose::Meta::Class
998     * Moose::Meta::Role
999       - several tweaks to take advantage of the
1000         new method map caching in Class::MOP
1001
1002     * Moose::Meta::TypeConstraint::Parameterized
1003       - allow subtypes of ArrayRef and HashRef to
1004         be used as a container (sartak)
1005         - added tests for this
1006       - basic support for coercion to ArrayRef and
1007         HashRef for containers (sartak)
1008         - added tests for this
1009
1010     * Moose::Meta::TypeCoercion
1011       - coercions will now create subtypes as needed
1012         so you can now add coercions to parameterized
1013         types without having to explictly define them
1014         - added tests for this
1015
1016     * Moose::Meta::Method::Accessor
1017       - allow subclasses to decide whether we need
1018         to copy the value into a new variable (sartak)
1019
1020 0.32 Tues. Dec. 4, 2007
1021     * Moose::Util::TypeConstraints
1022       - fixing how subtype aliases of unions work
1023         they should inherit the parent's coercion
1024         - added tests for this
1025       - you can now define multiple coercions on
1026         a single type at different times instead of
1027         having to do it all in one place
1028         - added tests for this
1029
1030     * Moose::Meta::TypeConstraint
1031       - there is now a default constraint of sub { 1 }
1032         instead of Moose::Util::TypeConstraints setting
1033         this for us
1034
1035     * Moose::Meta::TypeCoercion
1036     * Moose::Meta::TypeCoercion::Union
1037       - added the &has_coercion_for_type and
1038         &add_type_coercions methods to support the
1039         new features above (although you cannot add
1040         more type coercions for Union types)
1041
1042 0.31 Mon. Nov. 26, 2007
1043     * Moose::Meta::Attribute
1044       - made the +attr syntax handle extending types with
1045         parameters. So "has '+foo' => (isa => 'ArrayRef[Int]')"
1046         now works if the original foo is an ArrayRef.
1047         - added tests for this.
1048       - delegation now works even if the attribute does not
1049         have a reader method using the get_read_method_ref
1050         method from Class::MOP::Attribute.
1051         - added tests for this
1052         - added docs for this
1053
1054     * Moose::Util::TypeConstraints
1055       - passing no "additional attribute info" to
1056         &find_or_create_type_constraint will no longer
1057         attempt to create an __ANON__ type for you,
1058         instead it will just return undef.
1059         - added docs for this
1060
1061 0.30 Fri. Nov. 23, 2007
1062     * Moose::Meta::Method::Constructor
1063       -builder related bug in inlined constructor. (groditi)
1064
1065     * Moose::Meta::Method::Accessor
1066       - genereate unnecessary calls to predicates and refactor
1067         code generation for runtime speed (groditi)
1068
1069     * Moose::Util::TypeConstraints
1070       - fix ClassName constraint to introspect symbol table (mst)
1071         - added more tests for this (mst)
1072       - fixed it so that subtype 'Foo' => as 'HashRef[Int]' ...
1073         with work correctly.
1074         - added tests for this
1075
1076     * Moose::Cookbook
1077       - adding the link to Recipie 11 (written by Sartak)
1078         - adding test for SYNOPSIS code
1079
1080     * t/
1081       - New tests for builder bug. Upon instantiation, if an
1082         attribute had a builder, no value and was not lazy the
1083         builder default was not getting run, oops. (groditi)
1084
1085 0.29 Tues. Nov. 13, 2007
1086     * Moose::Meta::Attribute
1087       - Fix error message on missing builder method (groditi)
1088
1089     * Moose::Meta::Method::Accessor
1090       - Fix error message on missing builder method (groditi)
1091
1092     * t/
1093       - Add test to check for the correct error message when
1094         builder method is missing (groditi)
1095
1096 0.28 Tues. Nov. 13, 2007
1097     - 0.27 packaged incorrectly (groditi)
1098
1099 0.27 Tues. Nov. 13, 2007
1100     * Moose::Meta::Attribute
1101       - Added support for the new builder option (groditi)
1102       - Added support for lazy_build option (groditi)
1103       - Changed slot initialization for predicate changes (groditi)
1104
1105     * Moose::Meta::Method::Accessor
1106       - Added support for lazy_build option (groditi)
1107       - Fix inline methods to work with corrected predicate
1108         behavior (groditi)
1109
1110     * Moose::Meta::Method::Constructor
1111       - Added support for lazy_build option (groditi)
1112
1113     * t/
1114       - tests for builder and lazy_build (groditi)
1115
1116     * fixing some misc. bits in the docs that
1117       got mentioned on CPAN Forum & perlmonks
1118
1119     * Moose::Meta::Role
1120       - fixed how required methods are handled
1121         when they encounter overriden or modified
1122         methods from a class (thanks to confound).
1123         - added tests for this
1124
1125     * Moose::Util::TypeConstraint
1126       - fixed the type notation parser so that
1127         the | always creates a union and so is
1128         no longer a valid type char (thanks to
1129         konobi, mugwump and #moose for working
1130         this one out.)
1131         - added more tests for this
1132
1133 0.26 Thurs. Sept. 27, 2007
1134     == New Features ==
1135
1136     * Parameterized Types
1137       We now support parameterized collection types, such as:
1138           ArrayRef[Int]    # array or integers
1139           HashRef[Object]  # a hash with object values
1140       They can also be nested:
1141           ArrayRef[HashRef[RegExpr]] # an array of hashes with regexpr values
1142       And work with the type unions as well:
1143           ArrayRef[Int | Str]  # array of integers of strings
1144
1145     * Better Framework Extendability
1146       Moose.pm is now "extendable" such that it is now much
1147       easier to extend the framework and add your own keywords
1148       and customizations. See the "EXTENDING AND EMBEDDING MOOSE"
1149       section of the Moose.pm docs.
1150
1151     * Moose Snacks!
1152       In an effort to begin documenting some of the various
1153       details of Moose as well as some common idioms, we have
1154       created Moose::Cookbook::Snacks as a place to find
1155       small (easily digestable) nuggets of Moose code.
1156
1157     ====
1158     ~ Several doc updates/cleanup thanks to castaway ~
1159
1160     - converted build system to use Module::Install instead of
1161       Module::Build (thanks to jrockway)
1162
1163     * Moose
1164       - added all the meta classes to the immutable list and
1165         set it to inline the accessors
1166       - fix import to allow Sub::Exporter like { into => }
1167             and { into_level => } (perigrin)
1168       - exposed and documented init_meta() to allow better
1169             embedding and extending of Moose (perigrin)
1170
1171         * t/
1172           - complete re-organization of the test suite
1173           - added some new tests as well
1174           - finally re-enabled the Moose::POOP test since
1175             the new version of DBM::Deep now works again
1176             (thanks rob)
1177
1178     * Moose::Meta::Class
1179       - fixed very odd and very nasty recursion bug with
1180         inner/augment (mst)
1181         - added tests for this (eilara)
1182
1183     * Moose::Meta::Attribute
1184       Moose::Meta::Method::Constructor
1185       Moose::Meta::Method::Accessor
1186       - fixed issue with overload::Overloaded getting called
1187         on non-blessed items. (RT #29269)
1188         - added tests for this
1189
1190     * Moose::Meta::Method::Accessor
1191       - fixed issue with generated accessor code making
1192         assumptions about hash based classes (thanks to dexter)
1193
1194     * Moose::Coookbook::Snacks
1195       - these are bits of documentation, not quite as big as
1196         Recipes but which have no clear place in the module docs.
1197         So they are Snacks! (horray for castaway++)
1198
1199     * Moose::Cookbook::Recipe4
1200       - updated it to use the new ArrayRef[MyType] construct
1201         - updated the accompanying test as well
1202
1203     +++ Major Refactor of the Type Constraint system +++
1204     +++       with new features added as well        +++
1205
1206     * Moose::Util::TypeConstraint
1207       - no longer uses package variable to keep track of
1208         the type constraints, now uses the an instance of
1209         Moose::Meta::TypeConstraint::Registry to do it
1210       - added more sophisticated type notation parsing
1211         (thanks to mugwump)
1212         - added tests for this
1213
1214     * Moose::Meta::TypeConstraint
1215       - some minor adjustments to make subclassing easier
1216       - added the package_defined_in attribute so that we
1217         can track where the type constraints are created
1218
1219     * Moose::Meta::TypeConstraint::Union
1220       - this is now been refactored to be a subclass of
1221         Moose::Meta::TypeConstraint
1222
1223     * Moose::Meta::TypeCoercion::Union
1224       - this has been added to service the newly refactored
1225         Moose::Meta::TypeConstraint::Union and is itself
1226         a subclass of Moose::Meta::TypeCoercion
1227
1228     * Moose::Meta::TypeConstraint::Parameterized
1229       - added this module (taken from MooseX::AttributeHelpers)
1230         to help construct nested collection types
1231         - added tests for this
1232
1233     * Moose::Meta::TypeConstraint::Registry
1234       - added this class to keep track of type constraints
1235
1236 0.25 Mon. Aug. 13, 2007
1237     * Moose
1238       - Documentation update to reference Moose::Util::TypeConstraints
1239         under 'isa' in 'has' for how to define a new type
1240         (thanks to shlomif).
1241
1242     * Moose::Meta::Attribute
1243       - required attributes now will no longer accept undef
1244         from the constructor, even if there is a default and lazy
1245         - added tests for this
1246       - default subroutines must return a value which passes the
1247         type constraint
1248         - added tests for this
1249
1250     * Moose::Meta::Attribute
1251     * Moose::Meta::Method::Constructor
1252     * Moose::Meta::Method::Accessor
1253       - type-constraint tests now handle overloaded objects correctly
1254         in the error message
1255         - added tests for this (thanks to EvanCarroll)
1256
1257     * Moose::Meta::TypeConstraint::Union
1258       - added (has_)hand_optimized_constraint to this class so that
1259         it behaves as the regular Moose::Meta::TypeConstraint does.
1260
1261     * Moose::Meta::Role
1262       - large refactoring of this code
1263       - added several more tests
1264         - tests for subtle conflict resolition issues
1265           added, but not currently running
1266           (thanks to kolibre)
1267
1268     * Moose::Cookbook::Recipe7
1269       - added new recipe for augment/inner functionality
1270         (still in progress)
1271         - added test for this
1272
1273     * Moose::Spec::Role
1274       - a formal definition of roles (still in progress)
1275
1276     * Moose::Util
1277       - utilities for easier working with Moose classes
1278         - added tests for these
1279
1280     * Test::Moose
1281       - This contains Moose specific test functions
1282         - added tests for these
1283
1284 0.24 Tues. July 3, 2007
1285     ~ Some doc updates/cleanup ~
1286
1287     * Moose::Meta::Attribute
1288       - added support for roles to be given as parameters
1289         to the 'handles' option.
1290         - added tests and docs for this
1291       - the has '+foo' attribute form now accepts changes to
1292         the lazy option, and the addition of a handles option
1293         (but not changing the handles option)
1294         - added tests and docs for this
1295
1296     * Moose::Meta::Role
1297       - required methods are now fetched using find_method_by_name
1298         so that required methods can come from superclasses
1299         - adjusted tests for this
1300
1301 0.23 Mon. June 18, 2007
1302     * Moose::Meta::Method::Constructor
1303       - fix inlined constructor for hierarchy with multiple BUILD methods (mst)
1304     * Moose::Meta::Class
1305       - Modify make_immutable to work with the new Class::MOP immutable
1306         mechanism + POD + very basic test (groditi)
1307     * Moose::Meta::Attribute
1308       - Fix handles to use goto() so that caller() comes out properly on
1309         the other side (perigrin)
1310
1311 0.22 Thurs. May 31, 2007
1312     * Moose::Util::TypeConstraints
1313       - fix for prototype undeclared issue when Moose::Util::TypeConstraints
1314         loaded before consumers (e.g. Moose::Meta::Attribute) by predeclaring
1315         prototypes for functions
1316       - added the ClassName type constraint, this checks for strings
1317         which will respond true to ->isa(UNIVERSAL).
1318         - added tests and docs for this
1319       - subtyping just in name now works correctly by making the
1320         default for where be { 1 }
1321         - added test for this
1322
1323     * Moose::Meta::Method::Accessor
1324       - coerce and lazy now work together correctly, thanks to
1325         merlyn for finding this bug
1326         - tests added for this
1327       - fix reader presedence bug in Moose::Meta::Attribute + tests
1328
1329     * Moose::Object
1330       - Foo->new(undef) now gets ignored, it is assumed you meant to pass
1331         a HASH-ref and missed. This produces better error messages then
1332         having it die cause undef is not a HASH.
1333         - added tests for this
1334
1335 0.21 Thursday, May 2nd, 2007
1336     * Moose
1337       - added SUPER_SLOT and INNER_SLOT class hashes to support unimport
1338       - modified unimport to remove super and inner along with the rest
1339         - altered unimport tests to handle this
1340
1341     * Moose::Role
1342       - altered super export to populate SUPER_SLOT
1343
1344     * Moose::Meta::Class
1345       - altered augment and override modifier application to use *_SLOT
1346         - modified tests for these to unimport one test class each to test
1347
1348     * Moose::Meta::Role
1349       - fixed issue where custom attribute metaclasses
1350         where not handled correctly in roles
1351         - added tests for this
1352
1353     * Moose::Meta::Class
1354       - fixed issue where extending metaclasses with
1355         roles would blow up. Thanks to Aankhen`` for
1356         finding this insidious error, and it's solution.
1357
1358     ~~ lots of spelling and grammer fixes in the docs,
1359        many many thanks to rlb3 and Aankhen for these :)
1360
1361 0.20 Friday, April 6th, 2007
1362     >> I messed up the SKIP logic in one test
1363        so this release is just to fix that.
1364
1365     * Moose
1366       - 'has' now also accepts an ARRAY ref
1367         to create multiple attrs (see docs)
1368         (thanks to konobi for this)
1369          - added tests and docs
1370
1371 0.19 Thurs. April 5th, 2007
1372     ~~ More documentation updates ~~
1373
1374     * Moose::Util::TypeConstraints
1375       - 'type' now supports messages as well
1376         thanks to phaylon for finding this
1377         - added tests for this
1378       - added &list_all_type_constraints and
1379         &list_all_builtin_type_constraints
1380         functions to facilitate introspection.
1381
1382     * Moose::Meta::Attribute
1383       - fixed regexp 'handles' declarations
1384         to build the list of delegated methods
1385         correctly (and not override important
1386         things like &new) thanks to ashleyb
1387         for finding this
1388         - added tests and docs for this
1389       - added the 'documentation' attributes
1390         so that you can actually document your
1391         attributes and inspect them through the
1392         meta-object.
1393         - added tests and docs for this
1394
1395     * Moose::Meta::Class
1396       - when loading custom attribute metaclasses
1397         it will first look in for the class in the
1398         Moose::Meta::Attribute::Custom::$name, and
1399         then default to just loading $name.
1400         - added tests and docs for this
1401
1402     * Moose::Meta::TypeConstraint
1403       - type constraints now stringify to their names.
1404         - added test for this
1405
1406     * misc.
1407       - added tests to assure we work with Module::Refresh
1408       - added stricter test skip logic in the Moose POOP
1409         test, ask Rob Kinyon why.
1410         - *cough* DBM::Deep 1.0 backwards compatibility sucks *cough* ;)
1411
1412 0.18 Sat. March 10, 2007
1413     ~~ Many, many documentation updates ~~
1414
1415     * misc.
1416       - We now use Class::MOP::load_class to
1417         load all classes.
1418       - added tests to show types and subtypes
1419         working with Declare::Constraints::Simple
1420         and Test::Deep as constraint engines.
1421
1422 0.18_001
1423     !! You must have Class::MOP 0.37_001  !!
1424     !! for this developer release to work !!
1425
1426     This release was primarily adding the immutable
1427     feature to Moose. An immutable class is one which
1428     you promise not to alter. When you set the class
1429     as immutable it will perform various bits of
1430     memoization and inline certain part of the code
1431     (constructors, destructors and accessors). This
1432     minimizes (and in some cases totally eliminates)
1433     one of Moose's biggest performance hits. This
1434     feature is not on by default, and is 100% optional.
1435     It has several configurable bits as well, so you
1436     can pick and choose to your specific needs.
1437
1438     The changes involved in this were fairly wide and
1439     highly specific, but 100% backwards compatible, so
1440     I am not going to enumerate them here. If you are
1441     truely interested in what was changed, please do
1442     a diff :)
1443
1444 0.17 Tues. Nov. 14, 2006
1445     * Moose::Meta::Method::Accessor
1446       - bugfix for read-only accessors which
1447         are have a type constraint and lazy.
1448         Thanks to chansen for finding it.
1449
1450 0.16 Tues. Nov. 14, 2006
1451     ++ NOTE ++
1452     There are some speed improvements in this release,
1453     but they are only the begining, so stay tuned.
1454
1455     * Moose::Object
1456       - BUILDALL and DEMOLISHALL no longer get
1457         called unless they actually need to be.
1458         This gave us a signifigant speed boost
1459         for the cases when there is no BUILD or
1460         DEMOLISH method present.
1461
1462     * Moose::Util::TypeConstraints
1463     * Moose::Meta::TypeConstraint
1464       - added an 'optimize_as' option to the
1465         type constraint, which allows for a
1466         hand optimized version of the type
1467         constraint to be used when possible.
1468       - Any internally created type constraints
1469         now provide an optimized version as well.
1470
1471 0.15 Sun. Nov. 5, 2006
1472     ++ NOTE ++
1473     This version of Moose *must* have Class::MOP 0.36 in order
1474     to work correctly. A number of small internal tweaks have
1475     been made in order to be compatible with that release.
1476
1477     * Moose::Util::TypeConstraints
1478       - added &unimport so that you can clean out
1479         your class namespace of these exported
1480         keywords
1481
1482     * Moose::Meta::Class
1483       - fixed minor issue which occasionally
1484         comes up during global destruction
1485         (thanks omega)
1486       - moved Moose::Meta::Method::Overriden into
1487         its own file.
1488
1489     * Moose::Meta::Role
1490       - moved Moose::Meta::Role::Method into
1491         its own file.
1492
1493     * Moose::Meta::Attribute
1494       - changed how we do type checks so that
1495         we reduce the overall cost, but still
1496         retain correctness.
1497        *** API CHANGE ***
1498       - moved accessor generation methods to
1499         Moose::Meta::Method::Accessor to
1500         conform to the API changes from
1501         Class::MOP 0.36
1502
1503     * Moose::Meta::TypeConstraint
1504       - changed how constraints are compiled
1505         so that we do less recursion and more
1506         iteration. This makes the type check
1507         faster :)
1508       - moved Moose::Meta::TypeConstraint::Union
1509         into its own file
1510
1511     * Moose::Meta::Method::Accessor
1512       - created this from methods formerly found in
1513         Moose::Meta::Attribute
1514
1515     * Moose::Meta::Role::Method
1516       - moved this from Moose::Meta::Role
1517
1518     * Moose::Meta::Method::Overriden
1519       - moved this from Moose::Meta::Class
1520
1521     * Moose::Meta::TypeConstraint::Union
1522       - moved this from Moose::Meta::TypeConstraint
1523
1524 0.14 Mon. Oct. 9, 2006
1525
1526     * Moose::Meta::Attribute
1527       - fixed lazy attributes which were not getting
1528         checked with the type constraint (thanks ashley)
1529         - added tests for this
1530       - removed the over-enthusiastic DWIMery of the
1531         automatic ArrayRef and HashRef defaults, it
1532         broke predicates in an ugly way.
1533         - removed tests for this
1534
1535 0.13 Sat. Sept. 30, 2006
1536     ++ NOTE ++
1537     This version of Moose *must* have Class::MOP 0.35 in order
1538     to work correctly. A number of small internal tweaks have
1539     been made in order to be compatible with that release.
1540
1541     * Moose
1542       - Removed the use of UNIVERSAL::require to be a better
1543         symbol table citizen and remove a dependency
1544         (thanks Adam Kennedy)
1545
1546       **~~ removed experimental & undocumented feature ~~**
1547       - commented out the 'method' and 'self' keywords, see the
1548         comments for more info.
1549
1550     * Moose::Cookbook
1551       - added a FAQ and WTF files to document frequently
1552         asked questions and common problems
1553
1554     * Moose::Util::TypeConstraints
1555       - added GlobRef and FileHandle type constraint
1556         - added tests for this
1557
1558     * Moose::Meta::Attribute
1559       - if your attribute 'isa' ArrayRef of HashRef, and you have
1560         not explicitly set a default, then make the default DWIM.
1561         This will also work for subtypes of ArrayRef and HashRef
1562         as well.
1563       - you can now auto-deref subtypes of ArrayRef or HashRef too.
1564         - new test added for this (thanks to ashley)
1565
1566     * Moose::Meta::Role
1567       - added basic support for runtime role composition
1568         but this is still *highly experimental*, so feedback
1569         is much appreciated :)
1570         - added tests for this
1571
1572     * Moose::Meta::TypeConstraint
1573       - the type constraint now handles the coercion process
1574         through delegation, this is to support the coercion
1575         of unions
1576
1577     * Moose::Meta::TypeConstraint::Union
1578       - it is now possible for coercions to be performed
1579         on a type union
1580         - added tests for this (thanks to konobi)
1581
1582     * Moose::Meta::TypeCoercion
1583       - properly capturing error when type constraint
1584         is not found
1585
1586     * Build.PL
1587       - Scalar::Util 1.18 is bad on Win32, so temporarily
1588         only require version 1.17 for Win32 and cygwin.
1589         (thanks Adam Kennedy)
1590
1591 0.12 Sat. Sept. 1, 2006
1592     * Moose::Cookbook
1593       - Recipe5 (subtypes & coercion) has been written
1594
1595     * Moose
1596       - fixed "bad meta" error message to be more descriptive
1597       - fixed &unimport to not remove the &inner and &super
1598         keywords because we need to localize them.
1599       - fixed number of spelling/grammer issues, thanks Theory :)
1600
1601       **~~ experimental & undocumented feature ~~**
1602       - added the method and self keywords, they are basically
1603         just sugar, and they may not stay around.
1604
1605     * Moose::Object
1606       - added &dump method to easily Data::Dumper
1607         an object
1608
1609     * Moose::Meta::TypeConstraint
1610       - added the &is_a_type_of method to check both the current
1611         and the subtype of a method (similar to &isa with classes)
1612
1613     * Moose::Meta::Role
1614       - this is now a subclass of Class::MOP::Module, and no longer
1615         creates the _role_meta ugliness of before.
1616         - fixed tests to reflect this change
1617
1618 0.11 Wed. July 12, 2006
1619     * Moose
1620       - added an &unimport method to remove all the keywords
1621         that Moose will import, simply add 'no Moose' to the
1622         bottom of your class file.
1623
1624     * t/
1625       - fixed some test failures caused by a forgotten test
1626         dependency.
1627
1628 0.10 Thurs. July 6, 2006
1629     * Moose
1630       - improved error message when loading modules so
1631         it is less confusing when you load a role.
1632       - added &calculate_all_roles method to
1633         Moose::Meta::Class and Moose::Meta::Role
1634
1635     NOTE:
1636     This module has been tested against Class::MOP 0.30
1637     but it does not yet utilize the optimizations
1638     it makes available. Stay tuned for that ;)
1639
1640 0.09_03 Fri. June 23, 2006
1641     ++ DEVELOPER RELEASE ++
1642     * Moose
1643       - 'use strict' and 'use warnings' are no longer
1644          needed in Moose classes, Moose itself will
1645          turn them on for you.
1646          - added tests for this
1647       - moved code from exported subs to private methods
1648         in Moose::Meta::Class
1649
1650     * Moose::Role
1651       - as with Moose, strict and warnings are
1652         automatically turned on for you.
1653          - added tests for this
1654
1655     * Moose::Meta::Role
1656       - now handles an edge case for override errors
1657         - added tests for this
1658       - added some more edge case tests
1659
1660 0.09_02 Tues. May 16, 2006
1661     ++ DEVELOPER RELEASE ++
1662     * Moose
1663       - added prototypes to the exported subs
1664       - updated docs
1665
1666     * Moose::Role
1667       - added prototypes to the exported subs
1668       - updated docs
1669
1670     * Moose::Util::TypeConstraints
1671       - cleaned up prototypes for the subs
1672       - updated docs
1673
1674 0.09_01 Fri. May 12, 2006
1675     ++ DEVELOPER RELEASE ++
1676       - This release works in combination with
1677         Class::MOP 0.29_01, it is a developer
1678         release because it uses the a new
1679         instance sub-protocol and a fairly
1680         complete Role implementation. It has
1681         not yet been optimized, so it slower
1682         the the previous CPAN version. This
1683         release also lacks good updated docs,
1684         the official release will have updated docs.
1685
1686     * Moose
1687       - refactored the keyword exports
1688         - 'with' now checks Role validaity and
1689           accepts more than one Role at a time
1690         - 'extends' makes metaclass adjustments as
1691            needed to ensure metaclass compatibility
1692
1693     * Moose::Role
1694       - refactored the keyword exports
1695         - 'with' now checks Role validaity and
1696           accepts more than one Role at a time
1697
1698     * Moose::Util::TypeConstraints
1699       - added the 'enum' keyword for simple
1700         string enumerations which can be used as
1701         type constraints
1702         - see example of usage in t/202_example.t
1703
1704     * Moose::Object
1705       - more careful checking of params to new()
1706
1707     * Moose::Meta::Role
1708       - much work done on the role composition
1709         - many new tests for conflict detection
1710           and composition edge cases
1711         - not enough documentation, I suggest
1712           looking at the tests
1713
1714     * Moose::Meta::Instance
1715       - added new Instance metaclass to support
1716         the new Class::MOP instance protocol
1717
1718     * Moose::Meta::Class
1719       - some small changes to support the new
1720         instance protocol
1721       - some small additions to support Roles
1722
1723     * Moose::Meta::Attribute
1724       - some improvements to the accessor generation code
1725         by nothingmuch
1726       - some small changes to support the new
1727         instance protocol
1728       - (still somewhat) experimental delegation support
1729         with the 'handles' option
1730         - added several tests for this
1731         - no docs for this yet
1732
1733 0.05 Thurs. April 27, 2006
1734     * Moose
1735       - keywords are now exported with Sub::Exporter
1736         thanks to chansen for this commit
1737       - has keyword now takes a 'metaclass' option
1738         to support custom attribute meta-classes
1739         on a per-attribute basis
1740         - added tests for this
1741       - the 'has' keyword not accepts inherited slot
1742         specifications (has '+foo'). This is still an
1743         experimental feature and probably not finished
1744         see t/038_attribute_inherited_slot_specs.t for
1745         more details, or ask about it on #moose
1746         - added tests for this
1747
1748     * Moose::Role
1749       - keywords are now exported with Sub::Exporter
1750
1751     * Moose::Utils::TypeConstraints
1752       - reorganized the type constraint hierarchy, thanks
1753         to nothingmuch and chansen for his help and advice
1754         on this
1755         - added some tests for this
1756       - keywords are now exported with Sub::Exporter
1757         thanks to chansen for this commit
1758
1759     * Moose::Meta::Class
1760       - due to changes in Class::MOP, we had to change
1761         construct_instance (for the better)
1762
1763     * Moose::Meta::Attribute
1764       - due to changes in Class::MOP, we had to add the
1765         initialize_instance_slot method (it's a good thing)
1766
1767     * Moose::Meta::TypeConstraint
1768       - added type constraint unions
1769         - added tests for this
1770       - added the is_subtype_of predicate method
1771         - added tests for this
1772
1773 0.04 Sun. April 16th, 2006
1774     * Moose::Role
1775       - Roles can now consume other roles
1776         - added tests for this
1777       - Roles can specify required methods now with
1778         the requires() keyword
1779         - added tests for this
1780
1781     * Moose::Meta::Role
1782       - ripped out much of it's guts ,.. much cleaner now
1783       - added required methods and correct handling of
1784         them in apply() for both classes and roles
1785         - added tests for this
1786       - no longer adds a does() method to consuming classes
1787         it relys on the one in Moose::Object
1788       - added roles attribute and some methods to support
1789         roles consuming roles
1790
1791     * Moose::Meta::Attribute
1792       - added support for triggers on attributes
1793         - added tests for this
1794       - added support for does option on an attribute
1795         - added tests for this
1796
1797     * Moose::Meta::Class
1798       - added support for attribute triggers in the
1799         object construction
1800         - added tests for this
1801
1802     * Moose
1803       - Moose no longer creates a subtype for your class
1804         if a subtype of the same name already exists, this
1805         should DWIM in 99.9999% of all cases
1806
1807     * Moose::Util::TypeConstraints
1808       - fixed bug where incorrect subtype conflicts were
1809         being reported
1810         - added test for this
1811
1812     * Moose::Object
1813       - this class can now be extended with 'use base' if
1814         you need it, it properly loads the metaclass class now
1815         - added test for this
1816
1817 0.03_02 Wed. April 12, 2006
1818     * Moose
1819       - you must now explictly use Moose::Util::TypeConstraints
1820         it no longer gets exported for you automatically
1821
1822     * Moose::Object
1823       - new() now accepts hash-refs as well as key/value lists
1824       - added does() method to check for Roles
1825         - added tests for this
1826
1827     * Moose::Meta::Class
1828       - added roles attribute along with the add_role() and
1829         does_role() methods
1830         - added tests for this
1831
1832     * Moose::Meta::Role
1833       - now adds a does() method to consuming classes
1834         which tests the class's hierarchy for roles
1835         - added tests for this
1836
1837 0.03_01 Mon. April 10, 2006
1838     * Moose::Cookbook
1839       - added new Role recipe (no content yet, only code)
1840
1841     * Moose
1842       - added 'with' keyword for Role support
1843         - added test and docs for this
1844       - fixed subtype quoting bug
1845         - added test for this
1846
1847     * Moose::Role
1848       - Roles for Moose
1849         - added test and docs
1850
1851     * Moose::Util::TypeConstraints
1852       - added the message keyword to add custom
1853         error messages to type constraints
1854
1855     * Moose::Meta::Role
1856       - the meta role to support Moose::Role
1857         - added tests and docs
1858
1859     * Moose::Meta::Class
1860       - moved a number of things from Moose.pm
1861         to here, they should have been here
1862         in the first place
1863
1864     * Moose::Meta::Attribute
1865       - moved the attribute option macros here
1866         instead of putting them in Moose.pm
1867
1868     * Moose::Meta::TypeConstraint
1869       - added the message attributes and the
1870         validate method
1871         - added tests and docs for this
1872
1873 0.03 Thurs. March 30, 2006
1874     * Moose::Cookbook
1875       - added the Moose::Cookbook with 5 recipes,
1876         describing all the stuff Moose can do.
1877
1878     * Moose
1879       - fixed an issue with &extends super class loading
1880         it now captures errors and deals with inline
1881         packages correctly (bug found by mst, solution
1882         stolen from alias)
1883       - added super/override & inner/augment features
1884         - added tests and docs for these
1885
1886     * Moose::Object
1887       - BUILDALL now takes a reference of the %params
1888         that are passed to &new, and passes that to
1889         each BUILD as well.
1890
1891     * Moose::Util::TypeConstraints
1892       - Type constraints now survive runtime reloading
1893         - added test for this
1894
1895         * Moose::Meta::Class
1896           - fixed the way attribute defaults are handled
1897             during instance construction (bug found by chansen)
1898
1899     * Moose::Meta::Attribute
1900       - read-only attributes now actually enforce their
1901         read-only-ness (this corrected in Class::MOP as
1902         well)
1903
1904 0.02 Tues. March 21, 2006
1905     * Moose
1906       - many more tests, fixing some bugs and
1907         edge cases
1908       - &extends now loads the base module with
1909         UNIVERSAL::require
1910         - added UNIVERSAL::require to the
1911           dependencies list
1912       ** API CHANGES **
1913       - each new Moose class will also create
1914         and register a subtype of Object which
1915         correspond to the new Moose class.
1916       - the 'isa' option in &has now only
1917         accepts strings, and will DWIM in
1918         almost all cases
1919
1920     * Moose::Util::TypeConstraints
1921       - added type coercion features
1922         - added tests for this
1923         - added support for this in attributes
1924           and instance construction
1925       ** API CHANGES **
1926       - type construction no longer creates a
1927         function, it registers the type instead.
1928         - added several functions to get the
1929           registered types
1930
1931     * Moose::Object
1932       - BUILDALL and DEMOLISHALL were broken
1933         because of a mis-named hash key, Whoops :)
1934
1935     * Moose::Meta::Attribute
1936       - adding support for coercion in the
1937         autogenerated accessors
1938
1939     * Moose::Meta::Class
1940       - adding support for coercion in the
1941         instance construction
1942
1943     * Moose::Meta::TypeConstraint
1944     * Moose::Meta::TypeCoercion
1945           - type constraints and coercions are now
1946             full fledges meta-objects
1947
1948 0.01 Wed. March 15, 2006
1949     - Moooooooooooooooooose!!!