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