1 Revision history for Perl extension Moose
4 * Moose::Meta::Method::Constructor
5 - Fix inlined constructor so that values produced by default
6 or builder methods are coerced as required + test (t0m)
10 * Moose::Cookbook::Extending::Recipe2
11 - Add a _remove_keywords function so if you extend Moose
12 you don't have to cargo cult Moose's unimport (Sartak)
15 - Moose now warns when you try to have it export its sugar
16 functions into the "main" package. Previously it silently did
17 nothing. (Dave Rolsky)
19 0.55 Sun August 3, 2008
20 * Moose::Meta::Attribute
21 - breaking down the way 'handles' methods are
22 created so that the process can be more easily
23 overridden by subclasses (stevan)
25 * Moose::Meta::TypeConstraint
26 - fixing what is passed into a ->message with
27 the type constraints (RT #37569)
28 - added tests for this (Charles Alderman)
30 * Moose::Util::TypeConstraints
31 - fix coerce to accept anon types like subtype can (mst)
34 - reorganized the recipes into sections - Basics, Roles, Meta,
35 Extending - and wrote abstracts for each section (Dave Rolsky)
37 * Moose::Cookbook::Basics::Recipe10
38 - A new recipe that demonstrates operator overloading
39 in combination with Moose. (bluefeet)
41 * Moose::Cookbook::Meta::Recipe1
42 - an introduction to what meta is and why you'd want to make
43 your own metaclass extensions (Dave Rolsky)
45 * Moose::Cookbook::Meta::Recipe4
46 - a very simple metaclass example (Dave Rolsky)
48 * Moose::Cookbook::Extending::Recipe1
49 - how to write a Moose-alike module to use your own object base
52 * Moose::Cookbook::Extending::Recipe2
53 - how to write modules with an API just like C<Moose.pm> (Dave
57 - Tons of fixes, both syntactical and grammatical (Dave
60 0.54 Thurs. July 3, 2008
61 ... this is not my day today ...
63 * Moose::Meta::Attribute
64 - fixed legal_options_for_inheritance such that
65 clone_and_inherit options still works for
66 Class::MOP::Attribute objects and therefore
67 does not break MooseX::AttributeHelpers
70 0.53 Thurs. July 3, 2008
71 * Whoops, I guess I should run 'make manifest' before
72 actually releasing the module. No actual changes
73 in this release, except the fact that it includes
74 the changes that I didn't include in the last
77 0.52 Thurs. July 3, 2008
79 - added "FEATURE REQUESTS" section to the Moose docs
80 to properly direct people (stevan) (RT #34333)
81 - making 'extends' croak if it is passed a Role since
82 this is not ever something you want to do
83 (fixed by stevan, found by obra)
84 - added tests for this (stevan)
87 - adding support for DOES (as in UNIVERSAL::DOES)
91 * Moose::Meta::Attribute
92 - added legal_options_for_inheritance (wreis)
93 - added tests for this (wreis)
95 * Moose::Cookbook::Snacks::*
96 - removed some of the unfinished snacks that should
97 not have been released yet. Added some more examples
98 to the 'Keywords' snack. (stevan)
100 * Moose::Cookbook::Style
101 - added general Moose "style guide" of sorts to the
102 cookbook (nothingmuch) (RT #34335)
105 - added more BUILDARGS tests (stevan)
107 0.51 Thurs. Jun 26, 2008
109 - add unimport so "no Moose::Role" actually does
112 * Moose::Meta::Role::Application::ToRole
113 - when RoleA did RoleB, and RoleA aliased a method from RoleB in
114 order to provide its own implementation, that method still got
115 added to the list of required methods for consumers of
116 RoleB. Now an aliased method is only added to the list of
117 required methods if the role doing the aliasing does not
118 provide its own implementation. See Recipe 11 for an example
119 of all this. (Dave Rolsky)
120 - added tests for this
122 * Moose::Meta::Method::Constructor
123 - when a single argument that wasn't a hashref was provided to
124 an immutabilized constructor, the error message was very
125 unhelpful, as opposed to the non-immutable error. Reported by
127 - added test for this (Dave Rolsky)
129 * Moose::Meta::Attribute
130 - added support for meta_attr->does("ShortAlias") (sartak)
131 - added tests for this (sartak)
132 - moved the bulk of the `handles` handling to the new
133 install_delegation method (Stevan)
136 - Added BUILDARGS, a new step in new()
138 * Moose::Meta::Role::Application::RoleSummation
139 - fix typos no one ever sees (sartak)
141 * Moose::Util::TypeConstraints
142 * Moose::Meta::TypeConstraint
143 * Moose::Meta::TypeCoercion
144 - Attempt to work around the ??{ } vs. threads issue
146 - Some null_constraint optimizations
148 0.50 Thurs. Jun 11, 2008
149 - Fixed a version number issue by bumping all modules
152 0.49 Thurs. Jun 11, 2008
153 !! This version now approx. 20-25% !!
154 !! faster with new Class::MOP 0.59 !!
156 * Moose::Meta::Attribute
157 - fixed how the is => (ro|rw) works with
158 custom defined reader, writer and accessor
160 - added docs for this (TODO).
161 - added tests for this (Thanks to Penfold)
162 - added the custom attribute alias for regular
163 Moose attributes which is "Moose"
164 - fix builder and default both being used
169 Moose::Meta::Attribute
171 Moose::Meta::Role::Composite
172 Moose::Util::TypeConstraints
173 - switched usage of reftype to ref because
177 - changing add_package_symbol to use the new
181 - fixed how DEMOLISHALL is called so that it
182 can be overrided in subclasses (thanks to Sartak)
183 - added test for this (thanks to Sartak)
185 * Moose::Util::TypeConstraints
186 - move the ClassName type check code to
187 Class::MOP::is_class_loaded (thanks to Sartak)
189 * Moose::Cookbook::Recipe11
190 - add tests for this (thanks to tokuhirom)
192 0.48 Thurs. May 29, 2008
193 (early morning release engineering)--
195 - fixing the version in Moose::Meta::Method::Destructor
196 which was causing the indexer to choke
198 0.47 Thurs. May 29, 2008
199 (late night release engineering)--
201 - fixing the version is META.yml, no functional
202 changes in this release
204 0.46 Wed. May 28, 2008
205 !! This version now approx. 20-25% !!
206 !! faster with new Class::MOP 0.57 !!
209 - some optimizations of the &initialize method
210 since it is called so often by &meta
214 - now use the get_all_package_symbols from the
215 updated Class::MOP, test suite is now 10 seconds
218 * Moose::Meta::Method::Destructor
219 - is_needed can now also be called as a class
220 method for immutablization to check if the
221 destructor object even needs to be created
224 * Moose::Meta::Method::Destructor
225 Moose::Meta::Method::Constructor
226 - added more descriptive error message to help
227 keep people from wasting time tracking an error
228 that is easily fixed by upgrading.
230 0.45 Saturday, May 24, 2008
232 - Because of work in Class::MOP 0.56, all
233 XS based functionality is now optional
234 and a Pure Perl version is supplied
235 - the CLASS_MOP_NO_XS environment variable
236 can now be used to force non-XS versions
238 - several of the packages have been tweaked
239 to take care of this, mostly we added
240 support for the package_name and name
241 variables in all the Method metaclasses
242 - before/around/after method modifiers now
243 support regexp matching of names
244 (thanks to Takatoshi Kitano)
245 - tests added for this
246 - NOTE: this only works for classes, it
247 is currently not supported in roles,
248 but, ... patches welcome
249 - All usage of Carp::confess have been replaced
250 by Carp::croak in the "keyword" functions since
251 the stack trace is usually not helpful
254 - All usage of Carp::confess have been replaced
255 by Carp::croak in the "keyword" functions since
256 the stack trace is usually not helpful
257 - The 'has' keyword for roles now accepts the
258 same array ref form that Moose.pm does
259 (has [qw/foo bar/] => (is => 'rw', ...))
260 - added test for this
262 * Moose::Meta::Attribute
263 - trigger on a ro-attribute is no longer an
264 error, as it's useful to trigger off of the
268 - added same 'add_package_symbol' fix as in
272 - does_role now handles non-Moose classes
274 - added tests for this
275 - added the 'add_method_modifier' function
276 (thanks to Takatoshi Kitano)
278 * Moose::Util::TypeConstraints
279 - subtypes of parameterizable types now are
280 themselves parameterizable types
282 * Moose::Meta::Method::Constructor
283 - fixed bug where trigger was not being
284 called by the inlined immutable
286 - added test for this (thanks to Caelum)
288 * Moose::Meta::Role::Application::ToInstance
289 - now uses the metaclass of the instance
290 (if possible) to create the anon-class
291 (thanks Jonathan Rockway)
293 * Moose::Cookbook::Recipe22
294 - added the meta-attribute trait recipe
298 - fixed hash-ordering test bug that was
299 causing occasional cpantester failures
300 - renamed the t/000_recipe/*.t tests to be
301 more descriptive (thanks to Sartak)
303 0.44 Sat. May 10, 2008
305 - made make_immutable warning cluck to
306 show where the error is (thanks mst)
309 - BUILDALL and DEMOLISHALL now call
310 ->body when looping through the
311 methods, to avoid the overloaded
313 - fixed issue where DEMOLISHALL was
314 eating the $@ values, and so not
315 working correctly, it still kind of
316 eats them, but so does vanilla perl
317 - added tests for this
319 * Moose::Cookbook::Recipe7
320 - added new recipe for immutable
321 functionality (thanks Dave Rolsky)
323 * Moose::Cookbook::Recipe9
324 - added new recipe for builder and
325 lazy_build (thanks Dave Rolsky)
327 * Moose::Cookbook::Recipe11
328 - added new recipe for method aliasing
329 and exclusion with Roles (thanks Dave Rolsky)
332 - fixed Win32 test failure (thanks spicyjack)
334 ~ removed Build.PL and Module::Build compat
335 since Module::Install has done that.
337 0.43 Wed. April, 30, 2008
339 drink more coffee before
340 doing release engineering
342 - whoops, forgot to do the smolder tests,
343 and we broke some of the custom meta-attr
344 modules. This fixes that.
346 0.42 Mon. April 28, 2008
347 - some bad tests slipped by, nothing else
348 changed in this release (cpantesters++)
350 - upped the Class::MOP dependency to 0.55
351 since we have tests which need the C3
354 0.41 Mon. April 28, 2008
355 ~~ numerous documentation updates ~~
357 - Changed all usage of die to Carp::croak for better
358 error reporting (initial patch by Tod Hagan)
361 - the make_immutable keyword is now deprecated, don't
362 use it in any new code and please fix your old code
363 as well. There will be 2 releases, and then it will
369 - refactored the way inner and super work to avoid
370 any method/@ISA cache penalty (nothingmuch)
373 - fixing &new_object to make sure trigger gets the
374 coerced value (spotted by Charles Alderman on the
376 - added test for this
378 * Moose::Meta::Method::Constructor
379 - immutable classes which had non-lazy attributes were calling
380 the default generating sub twice in the constructor. (bug
381 found by Jesse Luehrs, fixed by Dave Rolsky)
382 - added tests for this (Dave Rolsky)
383 - fix typo in initialize_body method (nothingmuch)
385 * Moose::Meta::Method::Destructor
386 - fix typo in initialize_body method (nothingmuch)
388 * Moose::Meta::Method::Overriden
389 Moose::Meta::Method::Augmented
390 - moved the logic for these into their own
391 classes (nothingmuch)
393 * Moose::Meta::Attribute
394 - inherited attributes may now be extended without
395 restriction on the type ('isa', 'does') (Sartak)
396 - added tests for this (Sartak)
397 - when an attribute property is malformed (such as lazy without
398 a default), give the name of the attribute in the error
400 - added the &applied_traits and &has_applied_traits methods
401 to allow introspection of traits
402 - added tests for this
403 - moved 'trait' and 'metaclass' argument handling to here from
405 - clone_and_inherit_options now handles 'trait' and 'metaclass' (has
406 '+foo' syntax) (nothingmuch)
407 - added tests for this (t0m)
410 - localize $@ inside DEMOLISHALL to avoid it
411 eating $@ (found by Ernesto)
412 - added test for this (thanks to Ernesto)
414 * Moose::Util::TypeConstraints
415 - &find_type_constraint now DWIMs when given an
416 type constraint object or name (nothingmuch)
417 - &find_or_create_type_constraint superseded with a number of more
419 - find_or_create_{isa,does}_type_constraint
420 - find_or_parse_type_constraint
422 * Moose::Meta::TypeConstraint
423 Moose::Meta::TypeConstraint::Class
424 Moose::Meta::TypeConstraint::Role
425 Moose::Meta::TypeConstraint::Enum
426 Moose::Meta::TypeConstraint::Union
427 Moose::Meta::TypeConstraint::Parameterized
428 - added the &equals method for comparing two type
429 constraints (nothingmuch)
430 - added tests for this (nothingmuch)
432 * Moose::Meta::TypeConstraint
433 - add the &parents method, which is just an alias to &parent.
434 Useful for polymorphism with TC::{Class,Role,Union} (nothingmuch)
436 * Moose::Meta::TypeConstraint::Class
437 - added the class attribute for introspection purposes
439 - added tests for this
441 * Moose::Meta::TypeConstraint::Enum
442 Moose::Meta::TypeConstraint::Role
443 - broke these out into their own classes (nothingmuch)
445 * Moose::Cookbook::Recipe*
446 - fixed references to test file locations in the POD
447 and updated up some text for new Moose features
451 - Added &resolve_metaclass_alias, a helper function for finding an actual
452 class for a short name (e.g. in the traits list)
454 0.40 Fri. March 14, 2008
455 - I hate Pod::Coverage
457 0.39 Fri. March 14, 2008
459 - documenting the use of '+name' with attributes
460 that come from recently composed roles. It makes
461 sense, people are using it, and so why not just
462 officially support it.
463 - fixing the 'extends' keyword so that it will not
464 trigger Ovid's bug (http://use.perl.org/~Ovid/journal/35763)
467 - added the perl -Moose=+Class::Name feature to allow
468 monkeypatching of classes in one liners
471 - fixing the 'apply_all_roles' keyword so that it will not
472 trigger Ovid's bug (http://use.perl.org/~Ovid/journal/35763)
475 - added ->create method which now supports roles (thanks to jrockway)
476 - added tests for this
477 - added ->create_anon_class which now supports roles and caching of
478 the results (thanks to jrockway)
479 - added tests for this
480 - made ->does_role a little more forgiving when it is
481 checking a Class::MOP era metaclasses.
483 * Moose::Meta::Role::Application::ToInstance
484 - it is now possible to pass extra params to be used when
485 a role is applied to an the instance (rebless_params)
486 - added tests for this
488 * Moose::Util::TypeConstraints
489 - class_type now accepts an optional second argument for a
490 custom message. POD anotated accordingly (groditi)
491 - added tests for this
492 - it is now possible to make anon-enums by passing 'enum' an
493 ARRAY ref instead of the $name => @values. Everything else
495 - added tests for this
498 - making test for using '+name' on attributes consumed
499 from a role, it works and makes sense too.
501 * Moose::Meta::Attribute
502 - fix handles so that it doesn't return nothing
503 when the method cannot be found, not sure why
504 it ever did this originally, this means we now
505 have slightly better support for AUTOLOADed
507 - added more delegation tests
508 - adding ->does method to this so as to better
509 support traits and their introspection.
510 - added tests for this
513 - localizing the Data::Dumper configurations so
514 that it does not pollute others (RT #33509)
515 - made ->does a little more forgiving when it is
516 passed Class::MOP era metaclasses.
518 0.38 Fri. Feb. 15, 2008
519 * Moose::Meta::Attribute
520 - fixed initializer to correctly do
521 type checking and coercion in the
523 - added tests for this
526 - fixed some finicky tests (thanks to konobi)
528 0.37 Thurs. Feb. 14, 2008
530 - fixed some details in Moose::init_meta
531 and its superclass handling (thanks thepler)
532 - added tests for this (thanks thepler)
533 - 'has' now dies if you don't pass in name
535 - added the 'make_immutable' keyword as a shortcut
539 Moose::Meta::Method::Constructor
540 Moose::Meta::Attribute
541 - making (init_arg => undef) work here too
542 (thanks to nothingmuch)
544 * Moose::Meta::Attribute
545 Moose::Meta::Method::Constructor
546 Moose::Meta::Method::Accessor
547 - make lazy attributes respect attr initializers (rjbs)
548 - added tests for this
550 * Moose::Util::TypeConstraints
551 Moose::Util::TypeConstraints::OptimizedConstraints
552 Moose::Meta::TypeConstraints
553 Moose::Meta::Attribute
554 Moose::Meta::Method::Constructor
555 Moose::Meta::Method::Accessor
556 - making type errors use the
557 assigned message (thanks to Sartak)
558 - added tests for this
560 * Moose::Meta::Method::Destructor
561 - making sure DESTROY gets inlined properly
562 with successive DEMOLISH calls (thanks to manito)
564 * Moose::Meta::Attribute
565 Moose::Meta::Method::Accessor
566 - fixed handling of undef with type constraints
568 - added tests for this
571 - added &get_all_init_args and &get_all_attribute_values
572 (thanks to Sartak and nothingmuch)
574 0.36 Sat. Jan. 26, 2008
576 Moose::Meta::Attribute
577 - role type tests now support when roles are
578 applied to non-Moose classes (found by ash)
579 - added tests for this (thanks to ash)
580 - couple extra tests to boost code coverage
582 * Moose::Meta::Method::Constructor
583 - improved fix for handling Class::MOP attributes
584 - added test for this
587 - handled the add_attribute($attribute_meta_object)
589 - added test for this
591 0.35 Tues. Jan. 22, 2008
592 * Moose::Meta::Method::Constructor
593 - fix to make sure even Class::MOP attributes
594 are handled correctly (Thanks to Dave Rolsky)
595 - added test for this (also Dave Rolsky)
598 - improved error message on _apply_all_roles,
599 you should now use Moose::Util::apply_all_roles
600 and you shouldnt have been using a _ prefixed
601 method in the first place ;)
603 0.34 Mon. Jan. 21, 2008
604 ~~~ more misc. doc. fixes ~~~
605 ~~ updated copyright dates ~~
607 Moose is now a postmodern object system :)
608 - (see the POD for details)
610 * <<Role System Refactoring>>
611 - this release contains a major reworking and
612 cleanup of the role system
613 - 100% backwards compat.
614 - Role application now restructured into seperate
615 classes based on type of applicants
616 - Role summation (combining of more than one role)
617 is much cleaner and anon-classes are no longer
619 - new Composite role metaclass
620 - runtime application of roles to instances
621 is now more efficient and re-uses generated
622 classes when applicable
624 * <<New Role composition features>>
625 - methods can now be excluded from a given role
627 - methods can now be aliased to another name (and
628 still retain the original as well)
630 * Moose::Util::TypeConstraints::OptimizedConstraints
631 - added this module (see above)
634 - fixed the &_process_attribute method to be called
635 by &add_attribute, so that the API is now correct
637 * Moose::Meta::Method::Accessor
638 - fixed bug when passing a list of values to
639 an accessor would get (incorrectly) ignored.
640 Thanks to Sartak for finding this ;)
641 - added tests for this (Sartak again)
643 * Moose::Meta::Method::Accessor
644 Moose::Meta::Method::Constructor
645 Moose::Meta::Attribute
646 Moose::Meta::TypeConstraint
647 Moose::Meta::TypeCoercion
648 - lots of cleanup of such things as:
650 - type constraint handling
651 - error handling/messages
652 (thanks to nothingmuch)
654 * Moose::Meta::TypeConstraint::Parameterizable
655 - added this module to support the refactor
656 in Moose::Meta::TypeConstraint::Parameterized
658 * Moose::Meta::TypeConstraint::Parameterized
659 - refactored how these types are handled so they
660 are more generic and not confined to ArrayRef
664 - shortened some file names for better VMS support (RT #32381)
666 0.33 Fri. Dec. 14, 2007
667 !! Moose now loads 2 x faster !!
668 !! with new Class::MOP 0.49 !!
670 ++ new oose.pm module to make command line
671 Moose-ness easier (see POD docs for more)
675 - several tweaks to take advantage of the
676 new method map caching in Class::MOP
678 * Moose::Meta::TypeConstraint::Parameterized
679 - allow subtypes of ArrayRef and HashRef to
680 be used as a container (sartak)
681 - added tests for this
682 - basic support for coercion to ArrayRef and
683 HashRef for containers (sartak)
684 - added tests for this
686 * Moose::Meta::TypeCoercion
687 - coercions will now create subtypes as needed
688 so you can now add coercions to parameterized
689 types without having to explictly define them
690 - added tests for this
692 * Moose::Meta::Method::Accessor
693 - allow subclasses to decide whether we need
694 to copy the value into a new variable (sartak)
696 0.32 Tues. Dec. 4, 2007
697 * Moose::Util::TypeConstraints
698 - fixing how subtype aliases of unions work
699 they should inherit the parent's coercion
700 - added tests for this
701 - you can now define multiple coercions on
702 a single type at different times instead of
703 having to do it all in one place
704 - added tests for this
706 * Moose::Meta::TypeConstraint
707 - there is now a default constraint of sub { 1 }
708 instead of Moose::Util::TypeConstraints setting
711 * Moose::Meta::TypeCoercion
712 * Moose::Meta::TypeCoercion::Union
713 - added the &has_coercion_for_type and
714 &add_type_coercions methods to support the
715 new features above (although you cannot add
716 more type coercions for Union types)
718 0.31 Mon. Nov. 26, 2007
719 * Moose::Meta::Attribute
720 - made the +attr syntax handle extending types with
721 parameters. So "has '+foo' => (isa => 'ArrayRef[Int]')"
722 now works if the original foo is an ArrayRef.
723 - added tests for this.
724 - delegation now works even if the attribute does not
725 have a reader method using the get_read_method_ref
726 method from Class::MOP::Attribute.
727 - added tests for this
728 - added docs for this
730 * Moose::Util::TypeConstraints
731 - passing no "additional attribute info" to
732 &find_or_create_type_constraint will no longer
733 attempt to create an __ANON__ type for you,
734 instead it will just return undef.
735 - added docs for this
737 0.30 Fri. Nov. 23, 2007
738 * Moose::Meta::Method::Constructor
739 -builder related bug in inlined constructor. (groditi)
741 * Moose::Meta::Method::Accessor
742 - genereate unnecessary calls to predicates and refactor
743 code generation for runtime speed (groditi)
745 * Moose::Util::TypeConstraints
746 - fix ClassName constraint to introspect symbol table (mst)
747 - added more tests for this (mst)
748 - fixed it so that subtype 'Foo' => as 'HashRef[Int]' ...
750 - added tests for this
753 - adding the link to Recipie 11 (written by Sartak)
754 - adding test for SYNOPSIS code
757 - New tests for builder bug. Upon instantiation, if an
758 attribute had a builder, no value and was not lazy the
759 builder default was not getting run, oops. (groditi)
761 0.29 Tues. Nov. 13, 2007
762 * Moose::Meta::Attribute
763 - Fix error message on missing builder method (groditi)
765 * Moose::Meta::Method::Accessor
766 - Fix error message on missing builder method (groditi)
769 - Add test to check for the correct error message when
770 builder method is missing (groditi)
772 0.28 Tues. Nov. 13, 2007
773 - 0.27 packaged incorrectly (groditi)
775 0.27 Tues. Nov. 13, 2007
776 * Moose::Meta::Attribute
777 - Added support for the new builder option (groditi)
778 - Added support for lazy_build option (groditi)
779 - Changed slot initialization for predicate changes (groditi)
781 * Moose::Meta::Method::Accessor
782 - Added support for lazy_build option (groditi)
783 - Fix inline methods to work with corrected predicate
786 * Moose::Meta::Method::Constructor
787 - Added support for lazy_build option (groditi)
790 - tests for builder and lazy_build (groditi)
792 * fixing some misc. bits in the docs that
793 got mentioned on CPAN Forum & perlmonks
796 - fixed how required methods are handled
797 when they encounter overriden or modified
798 methods from a class (thanks to confound).
799 - added tests for this
801 * Moose::Util::TypeConstraint
802 - fixed the type notation parser so that
803 the | always creates a union and so is
804 no longer a valid type char (thanks to
805 konobi, mugwump and #moose for working
807 - added more tests for this
809 0.26 Thurs. Sept. 27, 2007
812 * Parameterized Types
813 We now support parameterized collection types, such as:
814 ArrayRef[Int] # array or integers
815 HashRef[Object] # a hash with object values
816 They can also be nested:
817 ArrayRef[HashRef[RegExpr]] # an array of hashes with regexpr values
818 And work with the type unions as well:
819 ArrayRef[Int | Str] # array of integers of strings
821 * Better Framework Extendability
822 Moose.pm is now "extendable" such that it is now much
823 easier to extend the framework and add your own keywords
824 and customizations. See the "EXTENDING AND EMBEDDING MOOSE"
825 section of the Moose.pm docs.
828 In an effort to begin documenting some of the various
829 details of Moose as well as some common idioms, we have
830 created Moose::Cookbook::Snacks as a place to find
831 small (easily digestable) nuggets of Moose code.
834 ~ Several doc updates/cleanup thanks to castaway ~
836 - converted build system to use Module::Install instead of
837 Module::Build (thanks to jrockway)
840 - added all the meta classes to the immutable list and
841 set it to inline the accessors
842 - fix import to allow Sub::Exporter like { into => }
843 and { into_level => } (perigrin)
844 - exposed and documented init_meta() to allow better
845 embedding and extending of Moose (perigrin)
848 - complete re-organization of the test suite
849 - added some new tests as well
850 - finally re-enabled the Moose::POOP test since
851 the new version of DBM::Deep now works again
855 - fixed very odd and very nasty recursion bug with
857 - added tests for this (eilara)
859 * Moose::Meta::Attribute
860 Moose::Meta::Method::Constructor
861 Moose::Meta::Method::Accessor
862 - fixed issue with overload::Overloaded getting called
863 on non-blessed items. (RT #29269)
864 - added tests for this
866 * Moose::Meta::Method::Accessor
867 - fixed issue with generated accessor code making
868 assumptions about hash based classes (thanks to dexter)
870 * Moose::Coookbook::Snacks
871 - these are bits of documentation, not quite as big as
872 Recipes but which have no clear place in the module docs.
873 So they are Snacks! (horray for castaway++)
875 * Moose::Cookbook::Recipe4
876 - updated it to use the new ArrayRef[MyType] construct
877 - updated the accompanying test as well
879 +++ Major Refactor of the Type Constraint system +++
880 +++ with new features added as well +++
882 * Moose::Util::TypeConstraint
883 - no longer uses package variable to keep track of
884 the type constraints, now uses the an instance of
885 Moose::Meta::TypeConstraint::Registry to do it
886 - added more sophisticated type notation parsing
888 - added tests for this
890 * Moose::Meta::TypeConstraint
891 - some minor adjustments to make subclassing easier
892 - added the package_defined_in attribute so that we
893 can track where the type constraints are created
895 * Moose::Meta::TypeConstraint::Union
896 - this is now been refactored to be a subclass of
897 Moose::Meta::TypeConstraint
899 * Moose::Meta::TypeCoercion::Union
900 - this has been added to service the newly refactored
901 Moose::Meta::TypeConstraint::Union and is itself
902 a subclass of Moose::Meta::TypeCoercion
904 * Moose::Meta::TypeConstraint::Parameterized
905 - added this module (taken from MooseX::AttributeHelpers)
906 to help construct nested collection types
907 - added tests for this
909 * Moose::Meta::TypeConstraint::Registry
910 - added this class to keep track of type constraints
912 0.25 Mon. Aug. 13, 2007
914 - Documentation update to reference Moose::Util::TypeConstraints
915 under 'isa' in 'has' for how to define a new type
918 * Moose::Meta::Attribute
919 - required attributes now will no longer accept undef
920 from the constructor, even if there is a default and lazy
921 - added tests for this
922 - default subroutines must return a value which passes the
924 - added tests for this
926 * Moose::Meta::Attribute
927 * Moose::Meta::Method::Constructor
928 * Moose::Meta::Method::Accessor
929 - type-constraint tests now handle overloaded objects correctly
931 - added tests for this (thanks to EvanCarroll)
933 * Moose::Meta::TypeConstraint::Union
934 - added (has_)hand_optimized_constraint to this class so that
935 it behaves as the regular Moose::Meta::TypeConstraint does.
938 - large refactoring of this code
939 - added several more tests
940 - tests for subtle conflict resolition issues
941 added, but not currently running
944 * Moose::Cookbook::Recipe7
945 - added new recipe for augment/inner functionality
947 - added test for this
950 - a formal definition of roles (still in progress)
953 - utilities for easier working with Moose classes
954 - added tests for these
957 - This contains Moose specific test functions
958 - added tests for these
960 0.24 Tues. July 3, 2007
961 ~ Some doc updates/cleanup ~
963 * Moose::Meta::Attribute
964 - added support for roles to be given as parameters
965 to the 'handles' option.
966 - added tests and docs for this
967 - the has '+foo' attribute form now accepts changes to
968 the lazy option, and the addition of a handles option
969 (but not changing the handles option)
970 - added tests and docs for this
973 - required methods are now fetched using find_method_by_name
974 so that required methods can come from superclasses
975 - adjusted tests for this
977 0.23 Mon. June 18, 2007
978 * Moose::Meta::Method::Constructor
979 - fix inlined constructor for hierarchy with multiple BUILD methods (mst)
981 - Modify make_immutable to work with the new Class::MOP immutable
982 mechanism + POD + very basic test (groditi)
983 * Moose::Meta::Attribute
984 - Fix handles to use goto() so that caller() comes out properly on
985 the other side (perigrin)
987 0.22 Thurs. May 31, 2007
988 * Moose::Util::TypeConstraints
989 - fix for prototype undeclared issue when Moose::Util::TypeConstraints
990 loaded before consumers (e.g. Moose::Meta::Attribute) by predeclaring
991 prototypes for functions
992 - added the ClassName type constraint, this checks for strings
993 which will respond true to ->isa(UNIVERSAL).
994 - added tests and docs for this
995 - subtyping just in name now works correctly by making the
996 default for where be { 1 }
997 - added test for this
999 * Moose::Meta::Method::Accessor
1000 - coerce and lazy now work together correctly, thanks to
1001 merlyn for finding this bug
1002 - tests added for this
1003 - fix reader presedence bug in Moose::Meta::Attribute + tests
1006 - Foo->new(undef) now gets ignored, it is assumed you meant to pass
1007 a HASH-ref and missed. This produces better error messages then
1008 having it die cause undef is not a HASH.
1009 - added tests for this
1011 0.21 Thursday, May 2nd, 2007
1013 - added SUPER_SLOT and INNER_SLOT class hashes to support unimport
1014 - modified unimport to remove super and inner along with the rest
1015 - altered unimport tests to handle this
1018 - altered super export to populate SUPER_SLOT
1020 * Moose::Meta::Class
1021 - altered augment and override modifier application to use *_SLOT
1022 - modified tests for these to unimport one test class each to test
1025 - fixed issue where custom attribute metaclasses
1026 where not handled correctly in roles
1027 - added tests for this
1029 * Moose::Meta::Class
1030 - fixed issue where extending metaclasses with
1031 roles would blow up. Thanks to Aankhen`` for
1032 finding this insidious error, and it's solution.
1034 ~~ lots of spelling and grammer fixes in the docs,
1035 many many thanks to rlb3 and Aankhen for these :)
1037 0.20 Friday, April 6th, 2007
1038 >> I messed up the SKIP logic in one test
1039 so this release is just to fix that.
1042 - 'has' now also accepts an ARRAY ref
1043 to create multiple attrs (see docs)
1044 (thanks to konobi for this)
1045 - added tests and docs
1047 0.19 Thurs. April 5th, 2007
1048 ~~ More documentation updates ~~
1050 * Moose::Util::TypeConstraints
1051 - 'type' now supports messages as well
1052 thanks to phaylon for finding this
1053 - added tests for this
1054 - added &list_all_type_constraints and
1055 &list_all_builtin_type_constraints
1056 functions to facilitate introspection.
1058 * Moose::Meta::Attribute
1059 - fixed regexp 'handles' declarations
1060 to build the list of delegated methods
1061 correctly (and not override important
1062 things like &new) thanks to ashleyb
1064 - added tests and docs for this
1065 - added the 'documentation' attributes
1066 so that you can actually document your
1067 attributes and inspect them through the
1069 - added tests and docs for this
1071 * Moose::Meta::Class
1072 - when loading custom attribute metaclasses
1073 it will first look in for the class in the
1074 Moose::Meta::Attribute::Custom::$name, and
1075 then default to just loading $name.
1076 - added tests and docs for this
1078 * Moose::Meta::TypeConstraint
1079 - type constraints now stringify to their names.
1080 - added test for this
1083 - added tests to assure we work with Module::Refresh
1084 - added stricter test skip logic in the Moose POOP
1085 test, ask Rob Kinyon why.
1086 - *cough* DBM::Deep 1.0 backwards compatability sucks *cough* ;)
1088 0.18 Sat. March 10, 2007
1089 ~~ Many, many documentation updates ~~
1092 - We now use Class::MOP::load_class to
1094 - added tests to show types and subtypes
1095 working with Declare::Constraints::Simple
1096 and Test::Deep as constraint engines.
1099 !! You must have Class::MOP 0.37_001 !!
1100 !! for this developer release to work !!
1102 This release was primarily adding the immutable
1103 feature to Moose. An immutable class is one which
1104 you promise not to alter. When you set the class
1105 as immutable it will perform various bits of
1106 memoization and inline certain part of the code
1107 (constructors, destructors and accessors). This
1108 minimizes (and in some cases totally eliminates)
1109 one of Moose's biggest performance hits. This
1110 feature is not on by default, and is 100% optional.
1111 It has several configurable bits as well, so you
1112 can pick and choose to your specific needs.
1114 The changes involved in this were fairly wide and
1115 highly specific, but 100% backwards compatible, so
1116 I am not going to enumerate them here. If you are
1117 truely interested in what was changed, please do
1120 0.17 Tues. Nov. 14, 2006
1121 * Moose::Meta::Method::Accessor
1122 - bugfix for read-only accessors which
1123 are have a type constraint and lazy.
1124 Thanks to chansen for finding it.
1126 0.16 Tues. Nov. 14, 2006
1128 There are some speed improvements in this release,
1129 but they are only the begining, so stay tuned.
1132 - BUILDALL and DEMOLISHALL no longer get
1133 called unless they actually need to be.
1134 This gave us a signifigant speed boost
1135 for the cases when there is no BUILD or
1136 DEMOLISH method present.
1138 * Moose::Util::TypeConstraints
1139 * Moose::Meta::TypeConstraint
1140 - added an 'optimize_as' option to the
1141 type constraint, which allows for a
1142 hand optimized version of the type
1143 constraint to be used when possible.
1144 - Any internally created type constraints
1145 now provide an optimized version as well.
1147 0.15 Sun. Nov. 5, 2006
1149 This version of Moose *must* have Class::MOP 0.36 in order
1150 to work correctly. A number of small internal tweaks have
1151 been made in order to be compatible with that release.
1153 * Moose::Util::TypeConstraints
1154 - added &unimport so that you can clean out
1155 your class namespace of these exported
1158 * Moose::Meta::Class
1159 - fixed minor issue which occasionally
1160 comes up during global destruction
1162 - moved Moose::Meta::Method::Overriden into
1166 - moved Moose::Meta::Role::Method into
1169 * Moose::Meta::Attribute
1170 - changed how we do type checks so that
1171 we reduce the overall cost, but still
1174 - moved accessor generation methods to
1175 Moose::Meta::Method::Accessor to
1176 conform to the API changes from
1179 * Moose::Meta::TypeConstraint
1180 - changed how constraints are compiled
1181 so that we do less recursion and more
1182 iteration. This makes the type check
1184 - moved Moose::Meta::TypeConstraint::Union
1187 * Moose::Meta::Method::Accessor
1188 - created this from methods formerly found in
1189 Moose::Meta::Attribute
1191 * Moose::Meta::Role::Method
1192 - moved this from Moose::Meta::Role
1194 * Moose::Meta::Method::Overriden
1195 - moved this from Moose::Meta::Class
1197 * Moose::Meta::TypeConstraint::Union
1198 - moved this from Moose::Meta::TypeConstraint
1200 0.14 Mon. Oct. 9, 2006
1202 * Moose::Meta::Attribute
1203 - fixed lazy attributes which were not getting
1204 checked with the type constraint (thanks ashley)
1205 - added tests for this
1206 - removed the over-enthusiastic DWIMery of the
1207 automatic ArrayRef and HashRef defaults, it
1208 broke predicates in an ugly way.
1209 - removed tests for this
1211 0.13 Sat. Sept. 30, 2006
1213 This version of Moose *must* have Class::MOP 0.35 in order
1214 to work correctly. A number of small internal tweaks have
1215 been made in order to be compatible with that release.
1218 - Removed the use of UNIVERSAL::require to be a better
1219 symbol table citizen and remove a dependency
1220 (thanks Adam Kennedy)
1222 **~~ removed experimental & undocumented feature ~~**
1223 - commented out the 'method' and 'self' keywords, see the
1224 comments for more info.
1227 - added a FAQ and WTF files to document frequently
1228 asked questions and common problems
1230 * Moose::Util::TypeConstraints
1231 - added GlobRef and FileHandle type constraint
1232 - added tests for this
1234 * Moose::Meta::Attribute
1235 - if your attribute 'isa' ArrayRef of HashRef, and you have
1236 not explicitly set a default, then make the default DWIM.
1237 This will also work for subtypes of ArrayRef and HashRef
1239 - you can now auto-deref subtypes of ArrayRef or HashRef too.
1240 - new test added for this (thanks to ashley)
1243 - added basic support for runtime role composition
1244 but this is still *highly experimental*, so feedback
1245 is much appreciated :)
1246 - added tests for this
1248 * Moose::Meta::TypeConstraint
1249 - the type constraint now handles the coercion process
1250 through delegation, this is to support the coercion
1253 * Moose::Meta::TypeConstraint::Union
1254 - it is now possible for coercions to be performed
1256 - added tests for this (thanks to konobi)
1258 * Moose::Meta::TypeCoercion
1259 - properly capturing error when type constraint
1263 - Scalar::Util 1.18 is bad on Win32, so temporarily
1264 only require version 1.17 for Win32 and cygwin.
1265 (thanks Adam Kennedy)
1267 0.12 Sat. Sept. 1, 2006
1269 - Recipe5 (subtypes & coercion) has been written
1272 - fixed "bad meta" error message to be more descriptive
1273 - fixed &unimport to not remove the &inner and &super
1274 keywords because we need to localize them.
1275 - fixed number of spelling/grammer issues, thanks Theory :)
1277 **~~ experimental & undocumented feature ~~**
1278 - added the method and self keywords, they are basically
1279 just sugar, and they may not stay around.
1282 - added &dump method to easily Data::Dumper
1285 * Moose::Meta::TypeConstraint
1286 - added the &is_a_type_of method to check both the current
1287 and the subtype of a method (similar to &isa with classes)
1290 - this is now a subclass of Class::MOP::Module, and no longer
1291 creates the _role_meta ugliness of before.
1292 - fixed tests to reflect this change
1294 0.11 Wed. July 12, 2006
1296 - added an &unimport method to remove all the keywords
1297 that Moose will import, simply add 'no Moose' to the
1298 bottom of your class file.
1301 - fixed some test failures caused by a forgotten test
1304 0.10 Thurs. July 6, 2006
1306 - improved error message when loading modules so
1307 it is less confusing when you load a role.
1308 - added &calculate_all_roles method to
1309 Moose::Meta::Class and Moose::Meta::Role
1312 This module has been tested against Class::MOP 0.30
1313 but it does not yet utilize the optimizations
1314 it makes available. Stay tuned for that ;)
1316 0.09_03 Fri. June 23, 2006
1317 ++ DEVELOPER RELEASE ++
1319 - 'use strict' and 'use warnings' are no longer
1320 needed in Moose classes, Moose itself will
1321 turn them on for you.
1322 - added tests for this
1323 - moved code from exported subs to private methods
1324 in Moose::Meta::Class
1327 - as with Moose, strict and warnings are
1328 automatically turned on for you.
1329 - added tests for this
1332 - now handles an edge case for override errors
1333 - added tests for this
1334 - added some more edge case tests
1336 0.09_02 Tues. May 16, 2006
1337 ++ DEVELOPER RELEASE ++
1339 - added prototypes to the exported subs
1343 - added prototypes to the exported subs
1346 * Moose::Util::TypeConstraints
1347 - cleaned up prototypes for the subs
1350 0.09_01 Fri. May 12, 2006
1351 ++ DEVELOPER RELEASE ++
1352 - This release works in combination with
1353 Class::MOP 0.29_01, it is a developer
1354 release because it uses the a new
1355 instance sub-protocol and a fairly
1356 complete Role implementation. It has
1357 not yet been optimized, so it slower
1358 the the previous CPAN version. This
1359 release also lacks good updated docs,
1360 the official release will have updated docs.
1363 - refactored the keyword exports
1364 - 'with' now checks Role validaity and
1365 accepts more than one Role at a time
1366 - 'extends' makes metaclass adjustments as
1367 needed to ensure metaclass compatability
1370 - refactored the keyword exports
1371 - 'with' now checks Role validaity and
1372 accepts more than one Role at a time
1374 * Moose::Util::TypeConstraints
1375 - added the 'enum' keyword for simple
1376 string enumerations which can be used as
1378 - see example of usage in t/202_example.t
1381 - more careful checking of params to new()
1384 - much work done on the role composition
1385 - many new tests for conflict detection
1386 and composition edge cases
1387 - not enough documentation, I suggest
1388 looking at the tests
1390 * Moose::Meta::Instance
1391 - added new Instance metaclass to support
1392 the new Class::MOP instance protocol
1394 * Moose::Meta::Class
1395 - some small changes to support the new
1397 - some small additions to support Roles
1399 * Moose::Meta::Attribute
1400 - some improvements to the accessor generation code
1402 - some small changes to support the new
1404 - (still somewhat) experimental delegation support
1405 with the 'handles' option
1406 - added several tests for this
1407 - no docs for this yet
1409 0.05 Thurs. April 27, 2006
1411 - keywords are now exported with Sub::Exporter
1412 thanks to chansen for this commit
1413 - has keyword now takes a 'metaclass' option
1414 to support custom attribute meta-classes
1415 on a per-attribute basis
1416 - added tests for this
1417 - the 'has' keyword not accepts inherited slot
1418 specifications (has '+foo'). This is still an
1419 experimental feature and probably not finished
1420 see t/038_attribute_inherited_slot_specs.t for
1421 more details, or ask about it on #moose
1422 - added tests for this
1425 - keywords are now exported with Sub::Exporter
1427 * Moose::Utils::TypeConstraints
1428 - reorganized the type constraint hierarchy, thanks
1429 to nothingmuch and chansen for his help and advice
1431 - added some tests for this
1432 - keywords are now exported with Sub::Exporter
1433 thanks to chansen for this commit
1435 * Moose::Meta::Class
1436 - due to changes in Class::MOP, we had to change
1437 construct_instance (for the better)
1439 * Moose::Meta::Attribute
1440 - due to changes in Class::MOP, we had to add the
1441 initialize_instance_slot method (it's a good thing)
1443 * Moose::Meta::TypeConstraint
1444 - added type constraint unions
1445 - added tests for this
1446 - added the is_subtype_of predicate method
1447 - added tests for this
1449 0.04 Sun. April 16th, 2006
1451 - Roles can now consume other roles
1452 - added tests for this
1453 - Roles can specify required methods now with
1454 the requires() keyword
1455 - added tests for this
1458 - ripped out much of it's guts ,.. much cleaner now
1459 - added required methods and correct handling of
1460 them in apply() for both classes and roles
1461 - added tests for this
1462 - no longer adds a does() method to consuming classes
1463 it relys on the one in Moose::Object
1464 - added roles attribute and some methods to support
1465 roles consuming roles
1467 * Moose::Meta::Attribute
1468 - added support for triggers on attributes
1469 - added tests for this
1470 - added support for does option on an attribute
1471 - added tests for this
1473 * Moose::Meta::Class
1474 - added support for attribute triggers in the
1476 - added tests for this
1479 - Moose no longer creates a subtype for your class
1480 if a subtype of the same name already exists, this
1481 should DWIM in 99.9999% of all cases
1483 * Moose::Util::TypeConstraints
1484 - fixed bug where incorrect subtype conflicts were
1486 - added test for this
1489 - this class can now be extended with 'use base' if
1490 you need it, it properly loads the metaclass class now
1491 - added test for this
1493 0.03_02 Wed. April 12, 2006
1495 - you must now explictly use Moose::Util::TypeConstraints
1496 it no longer gets exported for you automatically
1499 - new() now accepts hash-refs as well as key/value lists
1500 - added does() method to check for Roles
1501 - added tests for this
1503 * Moose::Meta::Class
1504 - added roles attribute along with the add_role() and
1506 - added tests for this
1509 - now adds a does() method to consuming classes
1510 which tests the class's hierarchy for roles
1511 - added tests for this
1513 0.03_01 Mon. April 10, 2006
1515 - added new Role recipe (no content yet, only code)
1518 - added 'with' keyword for Role support
1519 - added test and docs for this
1520 - fixed subtype quoting bug
1521 - added test for this
1525 - added test and docs
1527 * Moose::Util::TypeConstraints
1528 - added the message keyword to add custom
1529 error messages to type constraints
1532 - the meta role to support Moose::Role
1533 - added tests and docs
1535 * Moose::Meta::Class
1536 - moved a number of things from Moose.pm
1537 to here, they should have been here
1540 * Moose::Meta::Attribute
1541 - moved the attribute option macros here
1542 instead of putting them in Moose.pm
1544 * Moose::Meta::TypeConstraint
1545 - added the message attributes and the
1547 - added tests and docs for this
1549 0.03 Thurs. March 30, 2006
1551 - added the Moose::Cookbook with 5 recipes,
1552 describing all the stuff Moose can do.
1555 - fixed an issue with &extends super class loading
1556 it now captures errors and deals with inline
1557 packages correctly (bug found by mst, solution
1559 - added super/override & inner/augment features
1560 - added tests and docs for these
1563 - BUILDALL now takes a reference of the %params
1564 that are passed to &new, and passes that to
1567 * Moose::Util::TypeConstraints
1568 - Type constraints now survive runtime reloading
1569 - added test for this
1571 * Moose::Meta::Class
1572 - fixed the way attribute defaults are handled
1573 during instance construction (bug found by chansen)
1575 * Moose::Meta::Attribute
1576 - read-only attributes now actually enforce their
1577 read-only-ness (this corrected in Class::MOP as
1580 0.02 Tues. March 21, 2006
1582 - many more tests, fixing some bugs and
1584 - &extends now loads the base module with
1586 - added UNIVERSAL::require to the
1589 - each new Moose class will also create
1590 and register a subtype of Object which
1591 correspond to the new Moose class.
1592 - the 'isa' option in &has now only
1593 accepts strings, and will DWIM in
1596 * Moose::Util::TypeConstraints
1597 - added type coercion features
1598 - added tests for this
1599 - added support for this in attributes
1600 and instance construction
1602 - type construction no longer creates a
1603 function, it registers the type instead.
1604 - added several functions to get the
1608 - BUILDALL and DEMOLISHALL were broken
1609 because of a mis-named hash key, Whoops :)
1611 * Moose::Meta::Attribute
1612 - adding support for coercion in the
1613 autogenerated accessors
1615 * Moose::Meta::Class
1616 - adding support for coercion in the
1617 instance construction
1619 * Moose::Meta::TypeConstraint
1620 * Moose::Meta::TypeCoercion
1621 - type constraints and coercions are now
1622 full fledges meta-objects
1624 0.01 Wed. March 15, 2006
1625 - Moooooooooooooooooose!!!