Changes

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