Changes

   1 Revision history for Perl extension Moose
   2
   3 0.41
   4     ~~ numerous documentation updates ~~
   5
   6     - Changed all usage of die to Carp::croak for better
   7       error reporting (initial patch by Tod Hagan)
   8
   9     ** IMPORTANT NOTE **
  10     - the make_immutable keyword is now deprecated, don't
  11       use it in any new code and please fix your old code
  12       as well. There will be 2 releases, and then it will
  13       be removed.
  14
  15     * Moose::Meta::Class
  16       - fixing &new_object to make sure trigger gets the
  17         coerced value (spotted by Charles Alderman on the
  18         mailing list)
  19         - added test for this
  20
  21     * Moose::Meta::Method::Constructor
  22       - immutable classes which had non-lazy attributes were calling
  23         the default generating sub twice in the constructor. (bug
  24         found by Jesse Luehrs, fixed by Dave Rolsky)
  25         - added tests for this (Dave Rolsky)
  26       - fix typo in initialize_body method (nothingmuch)
  27
  28     * Moose::Meta::Method::Destructor
  29       - fix typo in initialize_body method (nothingmuch)
  30
  31     * Moose::Meta::Attribute
  32       - inherited attributes may now be extended without
  33         restriction on the type ('isa', 'does') (Sartak)
  34         - added tests for this (Sartak)
  35       - when an attribute property is malformed (such as lazy without
  36         a default), give the name of the attribute in the error
  37         message (Sartak)
  38
  39     * Moose::Object
  40       - localize $@ inside DEMOLISHALL to avoid it
  41         eating $@ (found by Ernesto)
  42         - added test for this (thanks to Ernesto)
  43
  44     * Moose::Util::TypeConstraints
  45       - &find_type_constraint now DWIMs when given an
  46         type constraint object (nothingmuch)
  47
  48     * Moose::Meta::TypeConstraint
  49       Moose::Meta::TypeConstraint::Class
  50       Moose::Meta::TypeConstraint::Enum
  51       Moose::Meta::TypeConstraint::Union
  52       Moose::Meta::TypeConstraint::Parameterized
  53         - added the &equals method for comparing two type
  54           constraints (nothingmuch)
  55           - added tests for this (nothingmuch)
  56
  57     * Moose::Meta::TypeConstraint
  58       - add the &parents method, which is just an alias to &parent.
  59         Useful for polymorphism with TC::Class (nothingmuch)
  60
  61     * Moose::Meta::TypeConstraint::Class
  62       - added the class attribute for introspection purposes
  63         (nothingmuch)
  64         - added tests for this
  65
  66     * Moose::Meta::TypeConstraint::Enum
  67       - broke this out into it's own class (nothingmuch)
  68
  69     * Moose::Cookbook::Recipe*
  70       - fixed references to test file locations in the POD
  71         and updated up some text for new Moose features
  72         (Sartak)
  73
  74 0.40 Fri. March 14, 2008
  75     - I hate Pod::Coverage
  76
  77 0.39 Fri. March 14, 2008
  78     * Moose
  79       - documenting the use of '+name' with attributes
  80         that come from recently composed roles. It makes
  81         sense, people are using it, and so why not just
  82         officially support it.
  83       - fixing the 'extends' keyword so that it will not
  84         trigger Ovid's bug (http://use.perl.org/~Ovid/journal/35763)
  85
  86     * oose
  87       - added the perl -Moose=+Class::Name feature to allow
  88         monkeypatching of classes in one liners
  89
  90     * Moose::Util
  91       - fixing the 'apply_all_roles' keyword so that it will not
  92         trigger Ovid's bug (http://use.perl.org/~Ovid/journal/35763)
  93
  94     * Moose::Meta::Class
  95       - added ->create method which now supports roles (thanks to jrockway)
  96         - added tests for this
  97       - added ->create_anon_class which now supports roles and caching of
  98         the results (thanks to jrockway)
  99         - added tests for this
 100       - made ->does_role a little more forgiving when it is
 101         checking a Class::MOP era metaclasses.
 102
 103     * Moose::Meta::Role::Application::ToInstance
 104       - it is now possible to pass extra params to be used when
 105         a role is applied to an the instance (rebless_params)
 106         - added tests for this
 107
 108     * Moose::Util::TypeConstraints
 109       - class_type now accepts an optional second argument for a
 110         custom message. POD anotated accordingly (groditi)
 111         - added tests for this
 112       - it is now possible to make anon-enums by passing 'enum' an
 113         ARRAY ref instead of the $name => @values. Everything else
 114         works as before.
 115         - added tests for this
 116
 117     * t/
 118       - making test for using '+name' on attributes consumed
 119         from a role, it works and makes sense too.
 120
 121     * Moose::Meta::Attribute
 122       - fix handles so that it doesn't return nothing
 123         when the method cannot be found, not sure why
 124         it ever did this originally, this means we now
 125         have slightly better support for AUTOLOADed
 126         objects
 127         - added more delegation tests
 128       - adding ->does method to this so as to better
 129         support traits and their introspection.
 130         - added tests for this
 131
 132     * Moose::Object
 133       - localizing the Data::Dumper configurations so
 134         that it does not pollute others (RT #33509)
 135       - made ->does a little more forgiving when it is
 136         passed Class::MOP era metaclasses.
 137
 138 0.38 Fri. Feb. 15, 2008
 139     * Moose::Meta::Attribute
 140       - fixed initializer to correctly do
 141         type checking and coercion in the
 142         callback
 143         - added tests for this
 144
 145     * t/
 146       - fixed some finicky tests (thanks to konobi)
 147
 148 0.37 Thurs. Feb. 14, 2008
 149     * Moose
 150       - fixed some details in Moose::init_meta
 151         and its superclass handling (thanks thepler)
 152         - added tests for this (thanks thepler)
 153       - 'has' now dies if you don't pass in name
 154         value pairs
 155       - added the 'make_immutable' keyword as a shortcut
 156         to make_immutable
 157
 158     * Moose::Meta::Class
 159       Moose::Meta::Method::Constructor
 160       Moose::Meta::Attribute
 161       - making (init_arg => undef) work here too
 162         (thanks to nothingmuch)
 163
 164     * Moose::Meta::Attribute
 165       Moose::Meta::Method::Constructor
 166       Moose::Meta::Method::Accessor
 167       - make lazy attributes respect attr initializers (rjbs)
 168         - added tests for this
 169
 170     * Moose::Util::TypeConstraints
 171       Moose::Util::TypeConstraints::OptimizedConstraints
 172       Moose::Meta::TypeConstraints
 173       Moose::Meta::Attribute
 174       Moose::Meta::Method::Constructor
 175       Moose::Meta::Method::Accessor
 176       - making type errors use the
 177         assigned message (thanks to Sartak)
 178         - added tests for this
 179
 180     * Moose::Meta::Method::Destructor
 181       - making sure DESTROY gets inlined properly
 182         with successive DEMOLISH calls (thanks to manito)
 183
 184     * Moose::Meta::Attribute
 185       Moose::Meta::Method::Accessor
 186       - fixed handling of undef with type constraints
 187         (thanks to Ernesto)
 188         - added tests for this
 189
 190     * Moose::Util
 191       - added &get_all_init_args and &get_all_attribute_values
 192         (thanks to Sartak and nothingmuch)
 193
 194 0.36 Sat. Jan. 26, 2008
 195     * Moose::Role
 196       Moose::Meta::Attribute
 197       - role type tests now support when roles are
 198         applied to non-Moose classes (found by ash)
 199         - added tests for this (thanks to ash)
 200       - couple extra tests to boost code coverage
 201
 202     * Moose::Meta::Method::Constructor
 203       - improved fix for handling Class::MOP attributes
 204         - added test for this
 205
 206     * Moose::Meta::Class
 207       - handled the add_attribute($attribute_meta_object)
 208         case correctly
 209         - added test for this
 210
 211 0.35 Tues. Jan. 22, 2008
 212     * Moose::Meta::Method::Constructor
 213       - fix to make sure even Class::MOP attributes
 214         are handled correctly (Thanks to Dave Rolsky)
 215         - added test for this (also Dave Rolsky)
 216
 217     * Moose::Meta::Class
 218       - improved error message on _apply_all_roles,
 219         you should now use Moose::Util::apply_all_roles
 220         and you shouldnt have been using a _ prefixed
 221         method in the first place ;)
 222
 223 0.34 Mon. Jan. 21, 2008
 224     ~~~ more misc. doc. fixes ~~~
 225     ~~ updated copyright dates ~~
 226
 227     Moose is now a postmodern object system :)
 228       - (see the POD for details)
 229
 230     * <<Role System Refactoring>>
 231     - this release contains a major reworking and
 232       cleanup of the role system
 233       - 100% backwards compat.
 234       - Role application now restructured into seperate
 235         classes based on type of applicants
 236       - Role summation (combining of more than one role)
 237         is much cleaner and anon-classes are no longer
 238         used in this process
 239       - new Composite role metaclass
 240       - runtime application of roles to instances
 241         is now more efficient and re-uses generated
 242         classes when applicable
 243
 244     * <<New Role composition features>>
 245       - methods can now be excluded from a given role
 246         during composition
 247       - methods can now be aliased to another name (and
 248         still retain the original as well)
 249
 250     * Moose::Util::TypeConstraints::OptimizedConstraints
 251       - added this module (see above)
 252
 253     * Moose::Meta::Class
 254       - fixed the &_process_attribute method to be called
 255         by &add_attribute, so that the API is now correct
 256
 257     * Moose::Meta::Method::Accessor
 258       - fixed bug when passing a list of values to
 259         an accessor would get (incorrectly) ignored.
 260         Thanks to Sartak for finding this ;)
 261         - added tests for this (Sartak again)
 262
 263     * Moose::Meta::Method::Accessor
 264       Moose::Meta::Method::Constructor
 265       Moose::Meta::Attribute
 266       Moose::Meta::TypeConstraint
 267       Moose::Meta::TypeCoercion
 268       - lots of cleanup of such things as:
 269         - generated methods
 270         - type constraint handling
 271         - error handling/messages
 272         (thanks to nothingmuch)
 273
 274     * Moose::Meta::TypeConstraint::Parameterizable
 275       - added this module to support the refactor
 276         in Moose::Meta::TypeConstraint::Parameterized
 277
 278     * Moose::Meta::TypeConstraint::Parameterized
 279       - refactored how these types are handled so they
 280         are more generic and not confined to ArrayRef
 281         and HashRef only
 282
 283     * t/
 284       - shortened some file names for better VMS support (RT #32381)
 285
 286 0.33 Fri. Dec. 14, 2007
 287     !! Moose now loads 2 x faster !!
 288     !!  with new Class::MOP 0.49  !!
 289
 290     ++ new oose.pm module to make command line
 291        Moose-ness easier (see POD docs for more)
 292
 293     * Moose::Meta::Class
 294     * Moose::Meta::Role
 295       - several tweaks to take advantage of the
 296         new method map caching in Class::MOP
 297
 298     * Moose::Meta::TypeConstraint::Parameterized
 299       - allow subtypes of ArrayRef and HashRef to
 300         be used as a container (sartak)
 301         - added tests for this
 302       - basic support for coercion to ArrayRef and
 303         HashRef for containers (sartak)
 304         - added tests for this
 305
 306     * Moose::Meta::TypeCoercion
 307       - coercions will now create subtypes as needed
 308         so you can now add coercions to parameterized
 309         types without having to explictly define them
 310         - added tests for this
 311
 312     * Moose::Meta::Method::Accessor
 313       - allow subclasses to decide whether we need
 314         to copy the value into a new variable (sartak)
 315
 316 0.32 Tues. Dec. 4, 2007
 317     * Moose::Util::TypeConstraints
 318       - fixing how subtype aliases of unions work
 319         they should inherit the parent's coercion
 320         - added tests for this
 321       - you can now define multiple coercions on
 322         a single type at different times instead of
 323         having to do it all in one place
 324         - added tests for this
 325
 326     * Moose::Meta::TypeConstraint
 327       - there is now a default constraint of sub { 1 }
 328         instead of Moose::Util::TypeConstraints setting
 329         this for us
 330
 331     * Moose::Meta::TypeCoercion
 332     * Moose::Meta::TypeCoercion::Union
 333       - added the &has_coercion_for_type and
 334         &add_type_coercions methods to support the
 335         new features above (although you cannot add
 336         more type coercions for Union types)
 337
 338 0.31 Mon. Nov. 26, 2007
 339     * Moose::Meta::Attribute
 340       - made the +attr syntax handle extending types with
 341         parameters. So "has '+foo' => (isa => 'ArrayRef[Int]')"
 342         now works if the original foo is an ArrayRef.
 343         - added tests for this.
 344       - delegation now works even if the attribute does not
 345         have a reader method using the get_read_method_ref
 346         method from Class::MOP::Attribute.
 347         - added tests for this
 348         - added docs for this
 349
 350     * Moose::Util::TypeConstraints
 351       - passing no "additional attribute info" to
 352         &find_or_create_type_constraint will no longer
 353         attempt to create an __ANON__ type for you,
 354         instead it will just return undef.
 355         - added docs for this
 356
 357 0.30 Fri. Nov. 23, 2007
 358     * Moose::Meta::Method::Constructor
 359       -builder related bug in inlined constructor. (groditi)
 360
 361     * Moose::Meta::Method::Accessor
 362       - genereate unnecessary calls to predicates and refactor
 363         code generation for runtime speed (groditi)
 364
 365     * Moose::Util::TypeConstraints
 366       - fix ClassName constraint to introspect symbol table (mst)
 367         - added more tests for this (mst)
 368       - fixed it so that subtype 'Foo' => as 'HashRef[Int]' ...
 369         with work correctly.
 370         - added tests for this
 371
 372     * Moose::Cookbook
 373       - adding the link to Recipie 11 (written by Sartak)
 374         - adding test for SYNOPSIS code
 375
 376     * t/
 377       - New tests for builder bug. Upon instantiation, if an
 378         attribute had a builder, no value and was not lazy the
 379         builder default was not getting run, oops. (groditi)
 380
 381 0.29 Tues. Nov. 13, 2007
 382     * Moose::Meta::Attribute
 383       - Fix error message on missing builder method (groditi)
 384
 385     * Moose::Meta::Method::Accessor
 386       - Fix error message on missing builder method (groditi)
 387
 388     * t/
 389       - Add test to check for the correct error message when
 390         builder method is missing (groditi)
 391
 392 0.28 Tues. Nov. 13, 2007
 393     - 0.27 packaged incorrectly (groditi)
 394
 395 0.27 Tues. Nov. 13, 2007
 396     * Moose::Meta::Attribute
 397       - Added support for the new builder option (groditi)
 398       - Added support for lazy_build option (groditi)
 399       - Changed slot initialization for predicate changes (groditi)
 400
 401     * Moose::Meta::Method::Accessor
 402       - Added support for lazy_build option (groditi)
 403       - Fix inline methods to work with corrected predicate
 404         behavior (groditi)
 405
 406     * Moose::Meta::Method::Constructor
 407       - Added support for lazy_build option (groditi)
 408
 409     * t/
 410       - tests for builder and lazy_build (groditi)
 411
 412     * fixing some misc. bits in the docs that
 413       got mentioned on CPAN Forum & perlmonks
 414
 415     * Moose::Meta::Role
 416       - fixed how required methods are handled
 417         when they encounter overriden or modified
 418         methods from a class (thanks to confound).
 419         - added tests for this
 420
 421     * Moose::Util::TypeConstraint
 422       - fixed the type notation parser so that
 423         the | always creates a union and so is
 424         no longer a valid type char (thanks to
 425         konobi, mugwump and #moose for working
 426         this one out.)
 427         - added more tests for this
 428
 429 0.26 Thurs. Sept. 27, 2007
 430     == New Features ==
 431
 432     * Parameterized Types
 433       We now support parameterized collection types, such as:
 434           ArrayRef[Int]    # array or integers
 435           HashRef[Object]  # a hash with object values
 436       They can also be nested:
 437           ArrayRef[HashRef[RegExpr]] # an array of hashes with regexpr values
 438       And work with the type unions as well:
 439           ArrayRef[Int | Str]  # array of integers of strings
 440
 441     * Better Framework Extendability
 442       Moose.pm is now "extendable" such that it is now much
 443       easier to extend the framework and add your own keywords
 444       and customizations. See the "EXTENDING AND EMBEDDING MOOSE"
 445       section of the Moose.pm docs.
 446
 447     * Moose Snacks!
 448       In an effort to begin documenting some of the various
 449       details of Moose as well as some common idioms, we have
 450       created Moose::Cookbook::Snacks as a place to find
 451       small (easily digestable) nuggets of Moose code.
 452
 453     ====
 454     ~ Several doc updates/cleanup thanks to castaway ~
 455
 456     - converted build system to use Module::Install instead of
 457       Module::Build (thanks to jrockway)
 458
 459     * Moose
 460       - added all the meta classes to the immutable list and
 461         set it to inline the accessors
 462       - fix import to allow Sub::Exporter like { into => }
 463             and { into_level => } (perigrin)
 464       - exposed and documented init_meta() to allow better
 465             embedding and extending of Moose (perigrin)
 466
 467         * t/
 468           - complete re-organization of the test suite
 469           - added some new tests as well
 470           - finally re-enabled the Moose::POOP test since
 471             the new version of DBM::Deep now works again
 472             (thanks rob)
 473
 474     * Moose::Meta::Class
 475       - fixed very odd and very nasty recursion bug with
 476         inner/augment (mst)
 477         - added tests for this (eilara)
 478
 479     * Moose::Meta::Attribute
 480       Moose::Meta::Method::Constructor
 481       Moose::Meta::Method::Accessor
 482       - fixed issue with overload::Overloaded getting called
 483         on non-blessed items. (RT #29269)
 484         - added tests for this
 485
 486     * Moose::Meta::Method::Accessor
 487       - fixed issue with generated accessor code making
 488         assumptions about hash based classes (thanks to dexter)
 489
 490     * Moose::Coookbook::Snacks
 491       - these are bits of documentation, not quite as big as
 492         Recipes but which have no clear place in the module docs.
 493         So they are Snacks! (horray for castaway++)
 494
 495     * Moose::Cookbook::Recipe4
 496       - updated it to use the new ArrayRef[MyType] construct
 497         - updated the accompanying test as well
 498
 499     +++ Major Refactor of the Type Constraint system +++
 500     +++       with new features added as well        +++
 501
 502     * Moose::Util::TypeConstraint
 503       - no longer uses package variable to keep track of
 504         the type constraints, now uses the an instance of
 505         Moose::Meta::TypeConstraint::Registry to do it
 506       - added more sophisticated type notation parsing
 507         (thanks to mugwump)
 508         - added tests for this
 509
 510     * Moose::Meta::TypeConstraint
 511       - some minor adjustments to make subclassing easier
 512       - added the package_defined_in attribute so that we
 513         can track where the type constraints are created
 514
 515     * Moose::Meta::TypeConstraint::Union
 516       - this is now been refactored to be a subclass of
 517         Moose::Meta::TypeConstraint
 518
 519     * Moose::Meta::TypeCoercion::Union
 520       - this has been added to service the newly refactored
 521         Moose::Meta::TypeConstraint::Union and is itself
 522         a subclass of Moose::Meta::TypeCoercion
 523
 524     * Moose::Meta::TypeConstraint::Parameterized
 525       - added this module (taken from MooseX::AttributeHelpers)
 526         to help construct nested collection types
 527         - added tests for this
 528
 529     * Moose::Meta::TypeConstraint::Registry
 530       - added this class to keep track of type constraints
 531
 532 0.25 Mon. Aug. 13, 2007
 533     * Moose
 534       - Documentation update to reference Moose::Util::TypeConstraints
 535         under 'isa' in 'has' for how to define a new type
 536         (thanks to shlomif).
 537
 538     * Moose::Meta::Attribute
 539       - required attributes now will no longer accept undef
 540         from the constructor, even if there is a default and lazy
 541         - added tests for this
 542       - default subroutines must return a value which passes the
 543         type constraint
 544         - added tests for this
 545
 546     * Moose::Meta::Attribute
 547     * Moose::Meta::Method::Constructor
 548     * Moose::Meta::Method::Accessor
 549       - type-constraint tests now handle overloaded objects correctly
 550         in the error message
 551         - added tests for this (thanks to EvanCarroll)
 552
 553     * Moose::Meta::TypeConstraint::Union
 554       - added (has_)hand_optimized_constraint to this class so that
 555         it behaves as the regular Moose::Meta::TypeConstraint does.
 556
 557     * Moose::Meta::Role
 558       - large refactoring of this code
 559       - added several more tests
 560         - tests for subtle conflict resolition issues
 561           added, but not currently running
 562           (thanks to kolibre)
 563
 564     * Moose::Cookbook::Recipe7
 565       - added new recipe for augment/inner functionality
 566         (still in progress)
 567         - added test for this
 568
 569     * Moose::Spec::Role
 570       - a formal definition of roles (still in progress)
 571
 572     * Moose::Util
 573       - utilities for easier working with Moose classes
 574         - added tests for these
 575
 576     * Test::Moose
 577       - This contains Moose specific test functions
 578         - added tests for these
 579
 580 0.24 Tues. July 3, 2007
 581     ~ Some doc updates/cleanup ~
 582
 583     * Moose::Meta::Attribute
 584       - added support for roles to be given as parameters
 585         to the 'handles' option.
 586         - added tests and docs for this
 587       - the has '+foo' attribute form now accepts changes to
 588         the lazy option, and the addition of a handles option
 589         (but not changing the handles option)
 590         - added tests and docs for this
 591
 592     * Moose::Meta::Role
 593       - required methods are now fetched using find_method_by_name
 594         so that required methods can come from superclasses
 595         - adjusted tests for this
 596
 597 0.23 Mon. June 18, 2007
 598     * Moose::Meta::Method::Constructor
 599       - fix inlined constructor for hierarchy with multiple BUILD methods (mst)
 600     * Moose::Meta::Class
 601       - Modify make_immutable to work with the new Class::MOP immutable
 602         mechanism + POD + very basic test (groditi)
 603     * Moose::Meta::Attribute
 604       - Fix handles to use goto() so that caller() comes out properly on
 605         the other side (perigrin)
 606
 607 0.22 Thurs. May 31, 2007
 608     * Moose::Util::TypeConstraints
 609       - fix for prototype undeclared issue when Moose::Util::TypeConstraints
 610         loaded before consumers (e.g. Moose::Meta::Attribute) by predeclaring
 611         prototypes for functions
 612       - added the ClassName type constraint, this checks for strings
 613         which will respond true to ->isa(UNIVERSAL).
 614         - added tests and docs for this
 615       - subtyping just in name now works correctly by making the
 616         default for where be { 1 }
 617         - added test for this
 618
 619     * Moose::Meta::Method::Accessor
 620       - coerce and lazy now work together correctly, thanks to
 621         merlyn for finding this bug
 622         - tests added for this
 623       - fix reader presedence bug in Moose::Meta::Attribute + tests
 624
 625     * Moose::Object
 626       - Foo->new(undef) now gets ignored, it is assumed you meant to pass
 627         a HASH-ref and missed. This produces better error messages then
 628         having it die cause undef is not a HASH.
 629         - added tests for this
 630
 631 0.21 Thursday, May 2nd, 2007
 632     * Moose
 633       - added SUPER_SLOT and INNER_SLOT class hashes to support unimport
 634       - modified unimport to remove super and inner along with the rest
 635         - altered unimport tests to handle this
 636
 637     * Moose::Role
 638       - altered super export to populate SUPER_SLOT
 639
 640     * Moose::Meta::Class
 641       - altered augment and override modifier application to use *_SLOT
 642         - modified tests for these to unimport one test class each to test
 643
 644     * Moose::Meta::Role
 645       - fixed issue where custom attribute metaclasses
 646         where not handled correctly in roles
 647         - added tests for this
 648
 649     * Moose::Meta::Class
 650       - fixed issue where extending metaclasses with
 651         roles would blow up. Thanks to Aankhen`` for
 652         finding this insidious error, and it's solution.
 653
 654     ~~ lots of spelling and grammer fixes in the docs,
 655        many many thanks to rlb3 and Aankhen for these :)
 656
 657 0.20 Friday, April 6th, 2007
 658     >> I messed up the SKIP logic in one test
 659        so this release is just to fix that.
 660
 661     * Moose
 662       - 'has' now also accepts an ARRAY ref
 663         to create multiple attrs (see docs)
 664         (thanks to konobi for this)
 665          - added tests and docs
 666
 667 0.19 Thurs. April 5th, 2007
 668     ~~ More documentation updates ~~
 669
 670     * Moose::Util::TypeConstraints
 671       - 'type' now supports messages as well
 672         thanks to phaylon for finding this
 673         - added tests for this
 674       - added &list_all_type_constraints and
 675         &list_all_builtin_type_constraints
 676         functions to facilitate introspection.
 677
 678     * Moose::Meta::Attribute
 679       - fixed regexp 'handles' declarations
 680         to build the list of delegated methods
 681         correctly (and not override important
 682         things like &new) thanks to ashleyb
 683         for finding this
 684         - added tests and docs for this
 685       - added the 'documentation' attributes
 686         so that you can actually document your
 687         attributes and inspect them through the
 688         meta-object.
 689         - added tests and docs for this
 690
 691     * Moose::Meta::Class
 692       - when loading custom attribute metaclasses
 693         it will first look in for the class in the
 694         Moose::Meta::Attribute::Custom::$name, and
 695         then default to just loading $name.
 696         - added tests and docs for this
 697
 698     * Moose::Meta::TypeConstraint
 699       - type constraints now stringify to their names.
 700         - added test for this
 701
 702     * misc.
 703       - added tests to assure we work with Module::Refresh
 704       - added stricter test skip logic in the Moose POOP
 705         test, ask Rob Kinyon why.
 706         - *cough* DBM::Deep 1.0 backwards compatability sucks *cough* ;)
 707
 708 0.18 Sat. March 10, 2007
 709     ~~ Many, many documentation updates ~~
 710
 711     * misc.
 712       - We now use Class::MOP::load_class to
 713         load all classes.
 714       - added tests to show types and subtypes
 715         working with Declare::Constraints::Simple
 716         and Test::Deep as constraint engines.
 717
 718 0.18_001
 719     !! You must have Class::MOP 0.37_001  !!
 720     !! for this developer release to work !!
 721
 722     This release was primarily adding the immutable
 723     feature to Moose. An immutable class is one which
 724     you promise not to alter. When you set the class
 725     as immutable it will perform various bits of
 726     memoization and inline certain part of the code
 727     (constructors, destructors and accessors). This
 728     minimizes (and in some cases totally eliminates)
 729     one of Moose's biggest performance hits. This
 730     feature is not on by default, and is 100% optional.
 731     It has several configurable bits as well, so you
 732     can pick and choose to your specific needs.
 733
 734     The changes involved in this were fairly wide and
 735     highly specific, but 100% backwards compatible, so
 736     I am not going to enumerate them here. If you are
 737     truely interested in what was changed, please do
 738     a diff :)
 739
 740 0.17 Tues. Nov. 14, 2006
 741     * Moose::Meta::Method::Accessor
 742       - bugfix for read-only accessors which
 743         are have a type constraint and lazy.
 744         Thanks to chansen for finding it.
 745
 746 0.16 Tues. Nov. 14, 2006
 747     ++ NOTE ++
 748     There are some speed improvements in this release,
 749     but they are only the begining, so stay tuned.
 750
 751     * Moose::Object
 752       - BUILDALL and DEMOLISHALL no longer get
 753         called unless they actually need to be.
 754         This gave us a signifigant speed boost
 755         for the cases when there is no BUILD or
 756         DEMOLISH method present.
 757
 758     * Moose::Util::TypeConstraints
 759     * Moose::Meta::TypeConstraint
 760       - added an 'optimize_as' option to the
 761         type constraint, which allows for a
 762         hand optimized version of the type
 763         constraint to be used when possible.
 764       - Any internally created type constraints
 765         now provide an optimized version as well.
 766
 767 0.15 Sun. Nov. 5, 2006
 768     ++ NOTE ++
 769     This version of Moose *must* have Class::MOP 0.36 in order
 770     to work correctly. A number of small internal tweaks have
 771     been made in order to be compatible with that release.
 772
 773     * Moose::Util::TypeConstraints
 774       - added &unimport so that you can clean out
 775         your class namespace of these exported
 776         keywords
 777
 778     * Moose::Meta::Class
 779       - fixed minor issue which occasionally
 780         comes up during global destruction
 781         (thanks omega)
 782       - moved Moose::Meta::Method::Overriden into
 783         its own file.
 784
 785     * Moose::Meta::Role
 786       - moved Moose::Meta::Role::Method into
 787         its own file.
 788
 789     * Moose::Meta::Attribute
 790       - changed how we do type checks so that
 791         we reduce the overall cost, but still
 792         retain correctness.
 793        *** API CHANGE ***
 794       - moved accessor generation methods to
 795         Moose::Meta::Method::Accessor to
 796         conform to the API changes from
 797         Class::MOP 0.36
 798
 799     * Moose::Meta::TypeConstraint
 800       - changed how constraints are compiled
 801         so that we do less recursion and more
 802         iteration. This makes the type check
 803         faster :)
 804       - moved Moose::Meta::TypeConstraint::Union
 805         into its own file
 806
 807     * Moose::Meta::Method::Accessor
 808       - created this from methods formerly found in
 809         Moose::Meta::Attribute
 810
 811     * Moose::Meta::Role::Method
 812       - moved this from Moose::Meta::Role
 813
 814     * Moose::Meta::Method::Overriden
 815       - moved this from Moose::Meta::Class
 816
 817     * Moose::Meta::TypeConstraint::Union
 818       - moved this from Moose::Meta::TypeConstraint
 819
 820 0.14 Mon. Oct. 9, 2006
 821
 822     * Moose::Meta::Attribute
 823       - fixed lazy attributes which were not getting
 824         checked with the type constraint (thanks ashley)
 825         - added tests for this
 826       - removed the over-enthusiastic DWIMery of the
 827         automatic ArrayRef and HashRef defaults, it
 828         broke predicates in an ugly way.
 829         - removed tests for this
 830
 831 0.13 Sat. Sept. 30, 2006
 832     ++ NOTE ++
 833     This version of Moose *must* have Class::MOP 0.35 in order
 834     to work correctly. A number of small internal tweaks have
 835     been made in order to be compatible with that release.
 836
 837     * Moose
 838       - Removed the use of UNIVERSAL::require to be a better
 839         symbol table citizen and remove a dependency
 840         (thanks Adam Kennedy)
 841
 842       **~~ removed experimental & undocumented feature ~~**
 843       - commented out the 'method' and 'self' keywords, see the
 844         comments for more info.
 845
 846     * Moose::Cookbook
 847       - added a FAQ and WTF files to document frequently
 848         asked questions and common problems
 849
 850     * Moose::Util::TypeConstraints
 851       - added GlobRef and FileHandle type constraint
 852         - added tests for this
 853
 854     * Moose::Meta::Attribute
 855       - if your attribute 'isa' ArrayRef of HashRef, and you have
 856         not explicitly set a default, then make the default DWIM.
 857         This will also work for subtypes of ArrayRef and HashRef
 858         as well.
 859       - you can now auto-deref subtypes of ArrayRef or HashRef too.
 860         - new test added for this (thanks to ashley)
 861
 862     * Moose::Meta::Role
 863       - added basic support for runtime role composition
 864         but this is still *highly experimental*, so feedback
 865         is much appreciated :)
 866         - added tests for this
 867
 868     * Moose::Meta::TypeConstraint
 869       - the type constraint now handles the coercion process
 870         through delegation, this is to support the coercion
 871         of unions
 872
 873     * Moose::Meta::TypeConstraint::Union
 874       - it is now possible for coercions to be performed
 875         on a type union
 876         - added tests for this (thanks to konobi)
 877
 878     * Moose::Meta::TypeCoercion
 879       - properly capturing error when type constraint
 880         is not found
 881
 882     * Build.PL
 883       - Scalar::Util 1.18 is bad on Win32, so temporarily
 884         only require version 1.17 for Win32 and cygwin.
 885         (thanks Adam Kennedy)
 886
 887 0.12 Sat. Sept. 1, 2006
 888     * Moose::Cookbook
 889       - Recipe5 (subtypes & coercion) has been written
 890
 891     * Moose
 892       - fixed "bad meta" error message to be more descriptive
 893       - fixed &unimport to not remove the &inner and &super
 894         keywords because we need to localize them.
 895       - fixed number of spelling/grammer issues, thanks Theory :)
 896
 897       **~~ experimental & undocumented feature ~~**
 898       - added the method and self keywords, they are basically
 899         just sugar, and they may not stay around.
 900
 901     * Moose::Object
 902       - added &dump method to easily Data::Dumper
 903         an object
 904
 905     * Moose::Meta::TypeConstraint
 906       - added the &is_a_type_of method to check both the current
 907         and the subtype of a method (similar to &isa with classes)
 908
 909     * Moose::Meta::Role
 910       - this is now a subclass of Class::MOP::Module, and no longer
 911         creates the _role_meta ugliness of before.
 912         - fixed tests to reflect this change
 913
 914 0.11 Wed. July 12, 2006
 915     * Moose
 916       - added an &unimport method to remove all the keywords
 917         that Moose will import, simply add 'no Moose' to the
 918         bottom of your class file.
 919
 920     * t/
 921       - fixed some test failures caused by a forgotten test
 922         dependency.
 923
 924 0.10 Thurs. July 6, 2006
 925     * Moose
 926       - improved error message when loading modules so
 927         it is less confusing when you load a role.
 928       - added &calculate_all_roles method to
 929         Moose::Meta::Class and Moose::Meta::Role
 930
 931     NOTE:
 932     This module has been tested against Class::MOP 0.30
 933     but it does not yet utilize the optimizations
 934     it makes available. Stay tuned for that ;)
 935
 936 0.09_03 Fri. June 23, 2006
 937     ++ DEVELOPER RELEASE ++
 938     * Moose
 939       - 'use strict' and 'use warnings' are no longer
 940          needed in Moose classes, Moose itself will
 941          turn them on for you.
 942          - added tests for this
 943       - moved code from exported subs to private methods
 944         in Moose::Meta::Class
 945
 946     * Moose::Role
 947       - as with Moose, strict and warnings are
 948         automatically turned on for you.
 949          - added tests for this
 950
 951     * Moose::Meta::Role
 952       - now handles an edge case for override errors
 953         - added tests for this
 954       - added some more edge case tests
 955
 956 0.09_02 Tues. May 16, 2006
 957     ++ DEVELOPER RELEASE ++
 958     * Moose
 959       - added prototypes to the exported subs
 960       - updated docs
 961
 962     * Moose::Role
 963       - added prototypes to the exported subs
 964       - updated docs
 965
 966     * Moose::Util::TypeConstraints
 967       - cleaned up prototypes for the subs
 968       - updated docs
 969
 970 0.09_01 Fri. May 12, 2006
 971     ++ DEVELOPER RELEASE ++
 972       - This release works in combination with
 973         Class::MOP 0.29_01, it is a developer
 974         release because it uses the a new
 975         instance sub-protocol and a fairly
 976         complete Role implementation. It has
 977         not yet been optimized, so it slower
 978         the the previous CPAN version. This
 979         release also lacks good updated docs,
 980         the official release will have updated docs.
 981
 982     * Moose
 983       - refactored the keyword exports
 984         - 'with' now checks Role validaity and
 985           accepts more than one Role at a time
 986         - 'extends' makes metaclass adjustments as
 987            needed to ensure metaclass compatability
 988
 989     * Moose::Role
 990       - refactored the keyword exports
 991         - 'with' now checks Role validaity and
 992           accepts more than one Role at a time
 993
 994     * Moose::Util::TypeConstraints
 995       - added the 'enum' keyword for simple
 996         string enumerations which can be used as
 997         type constraints
 998         - see example of usage in t/202_example.t
 999
1000     * Moose::Object
1001       - more careful checking of params to new()
1002
1003     * Moose::Meta::Role
1004       - much work done on the role composition
1005         - many new tests for conflict detection
1006           and composition edge cases
1007         - not enough documentation, I suggest
1008           looking at the tests
1009
1010     * Moose::Meta::Instance
1011       - added new Instance metaclass to support
1012         the new Class::MOP instance protocol
1013
1014     * Moose::Meta::Class
1015       - some small changes to support the new
1016         instance protocol
1017       - some small additions to support Roles
1018
1019     * Moose::Meta::Attribute
1020       - some improvements to the accessor generation code
1021         by nothingmuch
1022       - some small changes to support the new
1023         instance protocol
1024       - (still somewhat) experimental delegation support
1025         with the 'handles' option
1026         - added several tests for this
1027         - no docs for this yet
1028
1029 0.05 Thurs. April 27, 2006
1030     * Moose
1031       - keywords are now exported with Sub::Exporter
1032         thanks to chansen for this commit
1033       - has keyword now takes a 'metaclass' option
1034         to support custom attribute meta-classes
1035         on a per-attribute basis
1036         - added tests for this
1037       - the 'has' keyword not accepts inherited slot
1038         specifications (has '+foo'). This is still an
1039         experimental feature and probably not finished
1040         see t/038_attribute_inherited_slot_specs.t for
1041         more details, or ask about it on #moose
1042         - added tests for this
1043
1044     * Moose::Role
1045       - keywords are now exported with Sub::Exporter
1046
1047     * Moose::Utils::TypeConstraints
1048       - reorganized the type constraint hierarchy, thanks
1049         to nothingmuch and chansen for his help and advice
1050         on this
1051         - added some tests for this
1052       - keywords are now exported with Sub::Exporter
1053         thanks to chansen for this commit
1054
1055     * Moose::Meta::Class
1056       - due to changes in Class::MOP, we had to change
1057         construct_instance (for the better)
1058
1059     * Moose::Meta::Attribute
1060       - due to changes in Class::MOP, we had to add the
1061         initialize_instance_slot method (it's a good thing)
1062
1063     * Moose::Meta::TypeConstraint
1064       - added type constraint unions
1065         - added tests for this
1066       - added the is_subtype_of predicate method
1067         - added tests for this
1068
1069 0.04 Sun. April 16th, 2006
1070     * Moose::Role
1071       - Roles can now consume other roles
1072         - added tests for this
1073       - Roles can specify required methods now with
1074         the requires() keyword
1075         - added tests for this
1076
1077     * Moose::Meta::Role
1078       - ripped out much of it's guts ,.. much cleaner now
1079       - added required methods and correct handling of
1080         them in apply() for both classes and roles
1081         - added tests for this
1082       - no longer adds a does() method to consuming classes
1083         it relys on the one in Moose::Object
1084       - added roles attribute and some methods to support
1085         roles consuming roles
1086
1087     * Moose::Meta::Attribute
1088       - added support for triggers on attributes
1089         - added tests for this
1090       - added support for does option on an attribute
1091         - added tests for this
1092
1093     * Moose::Meta::Class
1094       - added support for attribute triggers in the
1095         object construction
1096         - added tests for this
1097
1098     * Moose
1099       - Moose no longer creates a subtype for your class
1100         if a subtype of the same name already exists, this
1101         should DWIM in 99.9999% of all cases
1102
1103     * Moose::Util::TypeConstraints
1104       - fixed bug where incorrect subtype conflicts were
1105         being reported
1106         - added test for this
1107
1108     * Moose::Object
1109       - this class can now be extended with 'use base' if
1110         you need it, it properly loads the metaclass class now
1111         - added test for this
1112
1113 0.03_02 Wed. April 12, 2006
1114     * Moose
1115       - you must now explictly use Moose::Util::TypeConstraints
1116         it no longer gets exported for you automatically
1117
1118     * Moose::Object
1119       - new() now accepts hash-refs as well as key/value lists
1120       - added does() method to check for Roles
1121         - added tests for this
1122
1123     * Moose::Meta::Class
1124       - added roles attribute along with the add_role() and
1125         does_role() methods
1126         - added tests for this
1127
1128     * Moose::Meta::Role
1129       - now adds a does() method to consuming classes
1130         which tests the class's hierarchy for roles
1131         - added tests for this
1132
1133 0.03_01 Mon. April 10, 2006
1134     * Moose::Cookbook
1135       - added new Role recipe (no content yet, only code)
1136
1137     * Moose
1138       - added 'with' keyword for Role support
1139         - added test and docs for this
1140       - fixed subtype quoting bug
1141         - added test for this
1142
1143     * Moose::Role
1144       - Roles for Moose
1145         - added test and docs
1146
1147     * Moose::Util::TypeConstraints
1148       - added the message keyword to add custom
1149         error messages to type constraints
1150
1151     * Moose::Meta::Role
1152       - the meta role to support Moose::Role
1153         - added tests and docs
1154
1155     * Moose::Meta::Class
1156       - moved a number of things from Moose.pm
1157         to here, they should have been here
1158         in the first place
1159
1160     * Moose::Meta::Attribute
1161       - moved the attribute option macros here
1162         instead of putting them in Moose.pm
1163
1164     * Moose::Meta::TypeConstraint
1165       - added the message attributes and the
1166         validate method
1167         - added tests and docs for this
1168
1169 0.03 Thurs. March 30, 2006
1170     * Moose::Cookbook
1171       - added the Moose::Cookbook with 5 recipes,
1172         describing all the stuff Moose can do.
1173
1174     * Moose
1175       - fixed an issue with &extends super class loading
1176         it now captures errors and deals with inline
1177         packages correctly (bug found by mst, solution
1178         stolen from alias)
1179       - added super/override & inner/augment features
1180         - added tests and docs for these
1181
1182     * Moose::Object
1183       - BUILDALL now takes a reference of the %params
1184         that are passed to &new, and passes that to
1185         each BUILD as well.
1186
1187     * Moose::Util::TypeConstraints
1188       - Type constraints now survive runtime reloading
1189         - added test for this
1190
1191         * Moose::Meta::Class
1192           - fixed the way attribute defaults are handled
1193             during instance construction (bug found by chansen)
1194
1195     * Moose::Meta::Attribute
1196       - read-only attributes now actually enforce their
1197         read-only-ness (this corrected in Class::MOP as
1198         well)
1199
1200 0.02 Tues. March 21, 2006
1201     * Moose
1202       - many more tests, fixing some bugs and
1203         edge cases
1204       - &extends now loads the base module with
1205         UNIVERSAL::require
1206         - added UNIVERSAL::require to the
1207           dependencies list
1208       ** API CHANGES **
1209       - each new Moose class will also create
1210         and register a subtype of Object which
1211         correspond to the new Moose class.
1212       - the 'isa' option in &has now only
1213         accepts strings, and will DWIM in
1214         almost all cases
1215
1216     * Moose::Util::TypeConstraints
1217       - added type coercion features
1218         - added tests for this
1219         - added support for this in attributes
1220           and instance construction
1221       ** API CHANGES **
1222       - type construction no longer creates a
1223         function, it registers the type instead.
1224         - added several functions to get the
1225           registered types
1226
1227     * Moose::Object
1228       - BUILDALL and DEMOLISHALL were broken
1229         because of a mis-named hash key, Whoops :)
1230
1231     * Moose::Meta::Attribute
1232       - adding support for coercion in the
1233         autogenerated accessors
1234
1235     * Moose::Meta::Class
1236       - adding support for coercion in the
1237         instance construction
1238
1239     * Moose::Meta::TypeConstraint
1240     * Moose::Meta::TypeCoercion
1241           - type constraints and coercions are now
1242             full fledges meta-objects
1243
1244 0.01 Wed. March 15, 2006
1245     - Moooooooooooooooooose!!!