1 Revision history for Perl extension Moose
4 * Moose::Meta::Attribute
5 - breaking down the way 'handles' methods are
6 created so that the process can be more easily
7 overridden by subclasses (stevan)
9 * Moose::Meta::TypeConstraint
10 - fixing what is passed into a ->message with
11 the type constraints (RT #37569)
12 - added tests for this (Charles Alderman)
14 * Moose::Cookbook::Recipe12
15 - A new recipe that shows off operator overloading
16 in combination with Moose. (bluefeet)
18 0.54 Thurs. July 3, 2008
19 ... this is not my day today ...
21 * Moose::Meta::Attribute
22 - fixed legal_options_for_inheritance such that
23 clone_and_inherit options still works for
24 Class::MOP::Attribute objects and therefore
25 does not break MooseX::AttributeHelpers
28 0.53 Thurs. July 3, 2008
29 * Whoops, I guess I should run 'make manifest' before
30 actually releasing the module. No actual changes
31 in this release, except the fact that it includes
32 the changes that I didn't include in the last
35 0.52 Thurs. July 3, 2008
37 - added "FEATURE REQUESTS" section to the Moose docs
38 to properly direct people (stevan) (RT #34333)
39 - making 'extends' croak if it is passed a Role since
40 this is not ever something you want to do
41 (fixed by stevan, found by obra)
42 - added tests for this (stevan)
45 - adding support for DOES (as in UNIVERSAL::DOES)
49 * Moose::Meta::Attribute
50 - added legal_options_for_inheritance (wreis)
51 - added tests for this (wreis)
53 * Moose::Cookbook::Snacks::*
54 - removed some of the unfinished snacks that should
55 not have been released yet. Added some more examples
56 to the 'Keywords' snack. (stevan)
58 * Moose::Cookbook::Style
59 - added general Moose "style guide" of sorts to the
60 cookbook (nothingmuch) (RT #34335)
63 - added more BUILDARGS tests (stevan)
65 0.51 Thurs. Jun 26, 2008
67 - add unimport so "no Moose::Role" actually does
70 * Moose::Meta::Role::Application::ToRole
71 - when RoleA did RoleB, and RoleA aliased a method from RoleB in
72 order to provide its own implementation, that method still got
73 added to the list of required methods for consumers of
74 RoleB. Now an aliased method is only added to the list of
75 required methods if the role doing the aliasing does not
76 provide its own implementation. See Recipe 11 for an example
77 of all this. (Dave Rolsky)
78 - added tests for this
80 * Moose::Meta::Method::Constructor
81 - when a single argument that wasn't a hashref was provided to
82 an immutabilized constructor, the error message was very
83 unhelpful, as opposed to the non-immutable error. Reported by
85 - added test for this (Dave Rolsky)
87 * Moose::Meta::Attribute
88 - added support for meta_attr->does("ShortAlias") (sartak)
89 - added tests for this (sartak)
90 - moved the bulk of the `handles` handling to the new
91 install_delegation method (Stevan)
94 - Added BUILDARGS, a new step in new()
96 * Moose::Meta::Role::Application::RoleSummation
97 - fix typos no one ever sees (sartak)
99 * Moose::Util::TypeConstraints
100 * Moose::Meta::TypeConstraint
101 * Moose::Meta::TypeCoercion
102 - Attempt to work around the ??{ } vs. threads issue
104 - Some null_constraint optimizations
106 0.50 Thurs. Jun 11, 2008
107 - Fixed a version number issue by bumping all modules
110 0.49 Thurs. Jun 11, 2008
111 !! This version now approx. 20-25% !!
112 !! faster with new Class::MOP 0.59 !!
114 * Moose::Meta::Attribute
115 - fixed how the is => (ro|rw) works with
116 custom defined reader, writer and accessor
118 - added docs for this (TODO).
119 - added tests for this (Thanks to Penfold)
120 - added the custom attribute alias for regular
121 Moose attributes which is "Moose"
122 - fix builder and default both being used
127 Moose::Meta::Attribute
129 Moose::Meta::Role::Composite
130 Moose::Util::TypeConstraints
131 - switched usage of reftype to ref because
135 - changing add_package_symbol to use the new
139 - fixed how DEMOLISHALL is called so that it
140 can be overrided in subclasses (thanks to Sartak)
141 - added test for this (thanks to Sartak)
143 * Moose::Util::TypeConstraints
144 - move the ClassName type check code to
145 Class::MOP::is_class_loaded (thanks to Sartak)
147 * Moose::Cookbook::Recipe11
148 - add tests for this (thanks to tokuhirom)
150 0.48 Thurs. May 29, 2008
151 (early morning release engineering)--
153 - fixing the version in Moose::Meta::Method::Destructor
154 which was causing the indexer to choke
156 0.47 Thurs. May 29, 2008
157 (late night release engineering)--
159 - fixing the version is META.yml, no functional
160 changes in this release
162 0.46 Wed. May 28, 2008
163 !! This version now approx. 20-25% !!
164 !! faster with new Class::MOP 0.57 !!
167 - some optimizations of the &initialize method
168 since it is called so often by &meta
172 - now use the get_all_package_symbols from the
173 updated Class::MOP, test suite is now 10 seconds
176 * Moose::Meta::Method::Destructor
177 - is_needed can now also be called as a class
178 method for immutablization to check if the
179 destructor object even needs to be created
182 * Moose::Meta::Method::Destructor
183 Moose::Meta::Method::Constructor
184 - added more descriptive error message to help
185 keep people from wasting time tracking an error
186 that is easily fixed by upgrading.
188 0.45 Saturday, May 24, 2008
190 - Because of work in Class::MOP 0.56, all
191 XS based functionality is now optional
192 and a Pure Perl version is supplied
193 - the CLASS_MOP_NO_XS environment variable
194 can now be used to force non-XS versions
196 - several of the packages have been tweaked
197 to take care of this, mostly we added
198 support for the package_name and name
199 variables in all the Method metaclasses
200 - before/around/after method modifiers now
201 support regexp matching of names
202 (thanks to Takatoshi Kitano)
203 - tests added for this
204 - NOTE: this only works for classes, it
205 is currently not supported in roles,
206 but, ... patches welcome
207 - All usage of Carp::confess have been replaced
208 by Carp::croak in the "keyword" functions since
209 the stack trace is usually not helpful
212 - All usage of Carp::confess have been replaced
213 by Carp::croak in the "keyword" functions since
214 the stack trace is usually not helpful
215 - The 'has' keyword for roles now accepts the
216 same array ref form that Moose.pm does
217 (has [qw/foo bar/] => (is => 'rw', ...))
218 - added test for this
220 * Moose::Meta::Attribute
221 - trigger on a ro-attribute is no longer an
222 error, as it's useful to trigger off of the
226 - added same 'add_package_symbol' fix as in
230 - does_role now handles non-Moose classes
232 - added tests for this
233 - added the 'add_method_modifier' function
234 (thanks to Takatoshi Kitano)
236 * Moose::Util::TypeConstraints
237 - subtypes of parameterizable types now are
238 themselves parameterizable types
240 * Moose::Meta::Method::Constructor
241 - fixed bug where trigger was not being
242 called by the inlined immutable
244 - added test for this (thanks to Caelum)
246 * Moose::Meta::Role::Application::ToInstance
247 - now uses the metaclass of the instance
248 (if possible) to create the anon-class
249 (thanks Jonathan Rockway)
251 * Moose::Cookbook::Recipe22
252 - added the meta-attribute trait recipe
256 - fixed hash-ordering test bug that was
257 causing occasional cpantester failures
258 - renamed the t/000_recipe/*.t tests to be
259 more descriptive (thanks to Sartak)
261 0.44 Sat. May 10, 2008
263 - made make_immutable warning cluck to
264 show where the error is (thanks mst)
267 - BUILDALL and DEMOLISHALL now call
268 ->body when looping through the
269 methods, to avoid the overloaded
271 - fixed issue where DEMOLISHALL was
272 eating the $@ values, and so not
273 working correctly, it still kind of
274 eats them, but so does vanilla perl
275 - added tests for this
277 * Moose::Cookbook::Recipe7
278 - added new recipe for immutable
279 functionality (thanks Dave Rolsky)
281 * Moose::Cookbook::Recipe9
282 - added new recipe for builder and
283 lazy_build (thanks Dave Rolsky)
285 * Moose::Cookbook::Recipe11
286 - added new recipe for method aliasing
287 and exclusion with Roles (thanks Dave Rolsky)
290 - fixed Win32 test failure (thanks spicyjack)
292 ~ removed Build.PL and Module::Build compat
293 since Module::Install has done that.
295 0.43 Wed. April, 30, 2008
297 drink more coffee before
298 doing release engineering
300 - whoops, forgot to do the smolder tests,
301 and we broke some of the custom meta-attr
302 modules. This fixes that.
304 0.42 Mon. April 28, 2008
305 - some bad tests slipped by, nothing else
306 changed in this release (cpantesters++)
308 - upped the Class::MOP dependency to 0.55
309 since we have tests which need the C3
312 0.41 Mon. April 28, 2008
313 ~~ numerous documentation updates ~~
315 - Changed all usage of die to Carp::croak for better
316 error reporting (initial patch by Tod Hagan)
319 - the make_immutable keyword is now deprecated, don't
320 use it in any new code and please fix your old code
321 as well. There will be 2 releases, and then it will
327 - refactored the way inner and super work to avoid
328 any method/@ISA cache penalty (nothingmuch)
331 - fixing &new_object to make sure trigger gets the
332 coerced value (spotted by Charles Alderman on the
334 - added test for this
336 * Moose::Meta::Method::Constructor
337 - immutable classes which had non-lazy attributes were calling
338 the default generating sub twice in the constructor. (bug
339 found by Jesse Luehrs, fixed by Dave Rolsky)
340 - added tests for this (Dave Rolsky)
341 - fix typo in initialize_body method (nothingmuch)
343 * Moose::Meta::Method::Destructor
344 - fix typo in initialize_body method (nothingmuch)
346 * Moose::Meta::Method::Overriden
347 Moose::Meta::Method::Augmented
348 - moved the logic for these into their own
349 classes (nothingmuch)
351 * Moose::Meta::Attribute
352 - inherited attributes may now be extended without
353 restriction on the type ('isa', 'does') (Sartak)
354 - added tests for this (Sartak)
355 - when an attribute property is malformed (such as lazy without
356 a default), give the name of the attribute in the error
358 - added the &applied_traits and &has_applied_traits methods
359 to allow introspection of traits
360 - added tests for this
361 - moved 'trait' and 'metaclass' argument handling to here from
363 - clone_and_inherit_options now handles 'trait' and 'metaclass' (has
364 '+foo' syntax) (nothingmuch)
365 - added tests for this (t0m)
368 - localize $@ inside DEMOLISHALL to avoid it
369 eating $@ (found by Ernesto)
370 - added test for this (thanks to Ernesto)
372 * Moose::Util::TypeConstraints
373 - &find_type_constraint now DWIMs when given an
374 type constraint object or name (nothingmuch)
375 - &find_or_create_type_constraint superseded with a number of more
377 - find_or_create_{isa,does}_type_constraint
378 - find_or_parse_type_constraint
380 * Moose::Meta::TypeConstraint
381 Moose::Meta::TypeConstraint::Class
382 Moose::Meta::TypeConstraint::Role
383 Moose::Meta::TypeConstraint::Enum
384 Moose::Meta::TypeConstraint::Union
385 Moose::Meta::TypeConstraint::Parameterized
386 - added the &equals method for comparing two type
387 constraints (nothingmuch)
388 - added tests for this (nothingmuch)
390 * Moose::Meta::TypeConstraint
391 - add the &parents method, which is just an alias to &parent.
392 Useful for polymorphism with TC::{Class,Role,Union} (nothingmuch)
394 * Moose::Meta::TypeConstraint::Class
395 - added the class attribute for introspection purposes
397 - added tests for this
399 * Moose::Meta::TypeConstraint::Enum
400 Moose::Meta::TypeConstraint::Role
401 - broke these out into their own classes (nothingmuch)
403 * Moose::Cookbook::Recipe*
404 - fixed references to test file locations in the POD
405 and updated up some text for new Moose features
409 - Added &resolve_metaclass_alias, a helper function for finding an actual
410 class for a short name (e.g. in the traits list)
412 0.40 Fri. March 14, 2008
413 - I hate Pod::Coverage
415 0.39 Fri. March 14, 2008
417 - documenting the use of '+name' with attributes
418 that come from recently composed roles. It makes
419 sense, people are using it, and so why not just
420 officially support it.
421 - fixing the 'extends' keyword so that it will not
422 trigger Ovid's bug (http://use.perl.org/~Ovid/journal/35763)
425 - added the perl -Moose=+Class::Name feature to allow
426 monkeypatching of classes in one liners
429 - fixing the 'apply_all_roles' keyword so that it will not
430 trigger Ovid's bug (http://use.perl.org/~Ovid/journal/35763)
433 - added ->create method which now supports roles (thanks to jrockway)
434 - added tests for this
435 - added ->create_anon_class which now supports roles and caching of
436 the results (thanks to jrockway)
437 - added tests for this
438 - made ->does_role a little more forgiving when it is
439 checking a Class::MOP era metaclasses.
441 * Moose::Meta::Role::Application::ToInstance
442 - it is now possible to pass extra params to be used when
443 a role is applied to an the instance (rebless_params)
444 - added tests for this
446 * Moose::Util::TypeConstraints
447 - class_type now accepts an optional second argument for a
448 custom message. POD anotated accordingly (groditi)
449 - added tests for this
450 - it is now possible to make anon-enums by passing 'enum' an
451 ARRAY ref instead of the $name => @values. Everything else
453 - added tests for this
456 - making test for using '+name' on attributes consumed
457 from a role, it works and makes sense too.
459 * Moose::Meta::Attribute
460 - fix handles so that it doesn't return nothing
461 when the method cannot be found, not sure why
462 it ever did this originally, this means we now
463 have slightly better support for AUTOLOADed
465 - added more delegation tests
466 - adding ->does method to this so as to better
467 support traits and their introspection.
468 - added tests for this
471 - localizing the Data::Dumper configurations so
472 that it does not pollute others (RT #33509)
473 - made ->does a little more forgiving when it is
474 passed Class::MOP era metaclasses.
476 0.38 Fri. Feb. 15, 2008
477 * Moose::Meta::Attribute
478 - fixed initializer to correctly do
479 type checking and coercion in the
481 - added tests for this
484 - fixed some finicky tests (thanks to konobi)
486 0.37 Thurs. Feb. 14, 2008
488 - fixed some details in Moose::init_meta
489 and its superclass handling (thanks thepler)
490 - added tests for this (thanks thepler)
491 - 'has' now dies if you don't pass in name
493 - added the 'make_immutable' keyword as a shortcut
497 Moose::Meta::Method::Constructor
498 Moose::Meta::Attribute
499 - making (init_arg => undef) work here too
500 (thanks to nothingmuch)
502 * Moose::Meta::Attribute
503 Moose::Meta::Method::Constructor
504 Moose::Meta::Method::Accessor
505 - make lazy attributes respect attr initializers (rjbs)
506 - added tests for this
508 * Moose::Util::TypeConstraints
509 Moose::Util::TypeConstraints::OptimizedConstraints
510 Moose::Meta::TypeConstraints
511 Moose::Meta::Attribute
512 Moose::Meta::Method::Constructor
513 Moose::Meta::Method::Accessor
514 - making type errors use the
515 assigned message (thanks to Sartak)
516 - added tests for this
518 * Moose::Meta::Method::Destructor
519 - making sure DESTROY gets inlined properly
520 with successive DEMOLISH calls (thanks to manito)
522 * Moose::Meta::Attribute
523 Moose::Meta::Method::Accessor
524 - fixed handling of undef with type constraints
526 - added tests for this
529 - added &get_all_init_args and &get_all_attribute_values
530 (thanks to Sartak and nothingmuch)
532 0.36 Sat. Jan. 26, 2008
534 Moose::Meta::Attribute
535 - role type tests now support when roles are
536 applied to non-Moose classes (found by ash)
537 - added tests for this (thanks to ash)
538 - couple extra tests to boost code coverage
540 * Moose::Meta::Method::Constructor
541 - improved fix for handling Class::MOP attributes
542 - added test for this
545 - handled the add_attribute($attribute_meta_object)
547 - added test for this
549 0.35 Tues. Jan. 22, 2008
550 * Moose::Meta::Method::Constructor
551 - fix to make sure even Class::MOP attributes
552 are handled correctly (Thanks to Dave Rolsky)
553 - added test for this (also Dave Rolsky)
556 - improved error message on _apply_all_roles,
557 you should now use Moose::Util::apply_all_roles
558 and you shouldnt have been using a _ prefixed
559 method in the first place ;)
561 0.34 Mon. Jan. 21, 2008
562 ~~~ more misc. doc. fixes ~~~
563 ~~ updated copyright dates ~~
565 Moose is now a postmodern object system :)
566 - (see the POD for details)
568 * <<Role System Refactoring>>
569 - this release contains a major reworking and
570 cleanup of the role system
571 - 100% backwards compat.
572 - Role application now restructured into seperate
573 classes based on type of applicants
574 - Role summation (combining of more than one role)
575 is much cleaner and anon-classes are no longer
577 - new Composite role metaclass
578 - runtime application of roles to instances
579 is now more efficient and re-uses generated
580 classes when applicable
582 * <<New Role composition features>>
583 - methods can now be excluded from a given role
585 - methods can now be aliased to another name (and
586 still retain the original as well)
588 * Moose::Util::TypeConstraints::OptimizedConstraints
589 - added this module (see above)
592 - fixed the &_process_attribute method to be called
593 by &add_attribute, so that the API is now correct
595 * Moose::Meta::Method::Accessor
596 - fixed bug when passing a list of values to
597 an accessor would get (incorrectly) ignored.
598 Thanks to Sartak for finding this ;)
599 - added tests for this (Sartak again)
601 * Moose::Meta::Method::Accessor
602 Moose::Meta::Method::Constructor
603 Moose::Meta::Attribute
604 Moose::Meta::TypeConstraint
605 Moose::Meta::TypeCoercion
606 - lots of cleanup of such things as:
608 - type constraint handling
609 - error handling/messages
610 (thanks to nothingmuch)
612 * Moose::Meta::TypeConstraint::Parameterizable
613 - added this module to support the refactor
614 in Moose::Meta::TypeConstraint::Parameterized
616 * Moose::Meta::TypeConstraint::Parameterized
617 - refactored how these types are handled so they
618 are more generic and not confined to ArrayRef
622 - shortened some file names for better VMS support (RT #32381)
624 0.33 Fri. Dec. 14, 2007
625 !! Moose now loads 2 x faster !!
626 !! with new Class::MOP 0.49 !!
628 ++ new oose.pm module to make command line
629 Moose-ness easier (see POD docs for more)
633 - several tweaks to take advantage of the
634 new method map caching in Class::MOP
636 * Moose::Meta::TypeConstraint::Parameterized
637 - allow subtypes of ArrayRef and HashRef to
638 be used as a container (sartak)
639 - added tests for this
640 - basic support for coercion to ArrayRef and
641 HashRef for containers (sartak)
642 - added tests for this
644 * Moose::Meta::TypeCoercion
645 - coercions will now create subtypes as needed
646 so you can now add coercions to parameterized
647 types without having to explictly define them
648 - added tests for this
650 * Moose::Meta::Method::Accessor
651 - allow subclasses to decide whether we need
652 to copy the value into a new variable (sartak)
654 0.32 Tues. Dec. 4, 2007
655 * Moose::Util::TypeConstraints
656 - fixing how subtype aliases of unions work
657 they should inherit the parent's coercion
658 - added tests for this
659 - you can now define multiple coercions on
660 a single type at different times instead of
661 having to do it all in one place
662 - added tests for this
664 * Moose::Meta::TypeConstraint
665 - there is now a default constraint of sub { 1 }
666 instead of Moose::Util::TypeConstraints setting
669 * Moose::Meta::TypeCoercion
670 * Moose::Meta::TypeCoercion::Union
671 - added the &has_coercion_for_type and
672 &add_type_coercions methods to support the
673 new features above (although you cannot add
674 more type coercions for Union types)
676 0.31 Mon. Nov. 26, 2007
677 * Moose::Meta::Attribute
678 - made the +attr syntax handle extending types with
679 parameters. So "has '+foo' => (isa => 'ArrayRef[Int]')"
680 now works if the original foo is an ArrayRef.
681 - added tests for this.
682 - delegation now works even if the attribute does not
683 have a reader method using the get_read_method_ref
684 method from Class::MOP::Attribute.
685 - added tests for this
686 - added docs for this
688 * Moose::Util::TypeConstraints
689 - passing no "additional attribute info" to
690 &find_or_create_type_constraint will no longer
691 attempt to create an __ANON__ type for you,
692 instead it will just return undef.
693 - added docs for this
695 0.30 Fri. Nov. 23, 2007
696 * Moose::Meta::Method::Constructor
697 -builder related bug in inlined constructor. (groditi)
699 * Moose::Meta::Method::Accessor
700 - genereate unnecessary calls to predicates and refactor
701 code generation for runtime speed (groditi)
703 * Moose::Util::TypeConstraints
704 - fix ClassName constraint to introspect symbol table (mst)
705 - added more tests for this (mst)
706 - fixed it so that subtype 'Foo' => as 'HashRef[Int]' ...
708 - added tests for this
711 - adding the link to Recipie 11 (written by Sartak)
712 - adding test for SYNOPSIS code
715 - New tests for builder bug. Upon instantiation, if an
716 attribute had a builder, no value and was not lazy the
717 builder default was not getting run, oops. (groditi)
719 0.29 Tues. Nov. 13, 2007
720 * Moose::Meta::Attribute
721 - Fix error message on missing builder method (groditi)
723 * Moose::Meta::Method::Accessor
724 - Fix error message on missing builder method (groditi)
727 - Add test to check for the correct error message when
728 builder method is missing (groditi)
730 0.28 Tues. Nov. 13, 2007
731 - 0.27 packaged incorrectly (groditi)
733 0.27 Tues. Nov. 13, 2007
734 * Moose::Meta::Attribute
735 - Added support for the new builder option (groditi)
736 - Added support for lazy_build option (groditi)
737 - Changed slot initialization for predicate changes (groditi)
739 * Moose::Meta::Method::Accessor
740 - Added support for lazy_build option (groditi)
741 - Fix inline methods to work with corrected predicate
744 * Moose::Meta::Method::Constructor
745 - Added support for lazy_build option (groditi)
748 - tests for builder and lazy_build (groditi)
750 * fixing some misc. bits in the docs that
751 got mentioned on CPAN Forum & perlmonks
754 - fixed how required methods are handled
755 when they encounter overriden or modified
756 methods from a class (thanks to confound).
757 - added tests for this
759 * Moose::Util::TypeConstraint
760 - fixed the type notation parser so that
761 the | always creates a union and so is
762 no longer a valid type char (thanks to
763 konobi, mugwump and #moose for working
765 - added more tests for this
767 0.26 Thurs. Sept. 27, 2007
770 * Parameterized Types
771 We now support parameterized collection types, such as:
772 ArrayRef[Int] # array or integers
773 HashRef[Object] # a hash with object values
774 They can also be nested:
775 ArrayRef[HashRef[RegExpr]] # an array of hashes with regexpr values
776 And work with the type unions as well:
777 ArrayRef[Int | Str] # array of integers of strings
779 * Better Framework Extendability
780 Moose.pm is now "extendable" such that it is now much
781 easier to extend the framework and add your own keywords
782 and customizations. See the "EXTENDING AND EMBEDDING MOOSE"
783 section of the Moose.pm docs.
786 In an effort to begin documenting some of the various
787 details of Moose as well as some common idioms, we have
788 created Moose::Cookbook::Snacks as a place to find
789 small (easily digestable) nuggets of Moose code.
792 ~ Several doc updates/cleanup thanks to castaway ~
794 - converted build system to use Module::Install instead of
795 Module::Build (thanks to jrockway)
798 - added all the meta classes to the immutable list and
799 set it to inline the accessors
800 - fix import to allow Sub::Exporter like { into => }
801 and { into_level => } (perigrin)
802 - exposed and documented init_meta() to allow better
803 embedding and extending of Moose (perigrin)
806 - complete re-organization of the test suite
807 - added some new tests as well
808 - finally re-enabled the Moose::POOP test since
809 the new version of DBM::Deep now works again
813 - fixed very odd and very nasty recursion bug with
815 - added tests for this (eilara)
817 * Moose::Meta::Attribute
818 Moose::Meta::Method::Constructor
819 Moose::Meta::Method::Accessor
820 - fixed issue with overload::Overloaded getting called
821 on non-blessed items. (RT #29269)
822 - added tests for this
824 * Moose::Meta::Method::Accessor
825 - fixed issue with generated accessor code making
826 assumptions about hash based classes (thanks to dexter)
828 * Moose::Coookbook::Snacks
829 - these are bits of documentation, not quite as big as
830 Recipes but which have no clear place in the module docs.
831 So they are Snacks! (horray for castaway++)
833 * Moose::Cookbook::Recipe4
834 - updated it to use the new ArrayRef[MyType] construct
835 - updated the accompanying test as well
837 +++ Major Refactor of the Type Constraint system +++
838 +++ with new features added as well +++
840 * Moose::Util::TypeConstraint
841 - no longer uses package variable to keep track of
842 the type constraints, now uses the an instance of
843 Moose::Meta::TypeConstraint::Registry to do it
844 - added more sophisticated type notation parsing
846 - added tests for this
848 * Moose::Meta::TypeConstraint
849 - some minor adjustments to make subclassing easier
850 - added the package_defined_in attribute so that we
851 can track where the type constraints are created
853 * Moose::Meta::TypeConstraint::Union
854 - this is now been refactored to be a subclass of
855 Moose::Meta::TypeConstraint
857 * Moose::Meta::TypeCoercion::Union
858 - this has been added to service the newly refactored
859 Moose::Meta::TypeConstraint::Union and is itself
860 a subclass of Moose::Meta::TypeCoercion
862 * Moose::Meta::TypeConstraint::Parameterized
863 - added this module (taken from MooseX::AttributeHelpers)
864 to help construct nested collection types
865 - added tests for this
867 * Moose::Meta::TypeConstraint::Registry
868 - added this class to keep track of type constraints
870 0.25 Mon. Aug. 13, 2007
872 - Documentation update to reference Moose::Util::TypeConstraints
873 under 'isa' in 'has' for how to define a new type
876 * Moose::Meta::Attribute
877 - required attributes now will no longer accept undef
878 from the constructor, even if there is a default and lazy
879 - added tests for this
880 - default subroutines must return a value which passes the
882 - added tests for this
884 * Moose::Meta::Attribute
885 * Moose::Meta::Method::Constructor
886 * Moose::Meta::Method::Accessor
887 - type-constraint tests now handle overloaded objects correctly
889 - added tests for this (thanks to EvanCarroll)
891 * Moose::Meta::TypeConstraint::Union
892 - added (has_)hand_optimized_constraint to this class so that
893 it behaves as the regular Moose::Meta::TypeConstraint does.
896 - large refactoring of this code
897 - added several more tests
898 - tests for subtle conflict resolition issues
899 added, but not currently running
902 * Moose::Cookbook::Recipe7
903 - added new recipe for augment/inner functionality
905 - added test for this
908 - a formal definition of roles (still in progress)
911 - utilities for easier working with Moose classes
912 - added tests for these
915 - This contains Moose specific test functions
916 - added tests for these
918 0.24 Tues. July 3, 2007
919 ~ Some doc updates/cleanup ~
921 * Moose::Meta::Attribute
922 - added support for roles to be given as parameters
923 to the 'handles' option.
924 - added tests and docs for this
925 - the has '+foo' attribute form now accepts changes to
926 the lazy option, and the addition of a handles option
927 (but not changing the handles option)
928 - added tests and docs for this
931 - required methods are now fetched using find_method_by_name
932 so that required methods can come from superclasses
933 - adjusted tests for this
935 0.23 Mon. June 18, 2007
936 * Moose::Meta::Method::Constructor
937 - fix inlined constructor for hierarchy with multiple BUILD methods (mst)
939 - Modify make_immutable to work with the new Class::MOP immutable
940 mechanism + POD + very basic test (groditi)
941 * Moose::Meta::Attribute
942 - Fix handles to use goto() so that caller() comes out properly on
943 the other side (perigrin)
945 0.22 Thurs. May 31, 2007
946 * Moose::Util::TypeConstraints
947 - fix for prototype undeclared issue when Moose::Util::TypeConstraints
948 loaded before consumers (e.g. Moose::Meta::Attribute) by predeclaring
949 prototypes for functions
950 - added the ClassName type constraint, this checks for strings
951 which will respond true to ->isa(UNIVERSAL).
952 - added tests and docs for this
953 - subtyping just in name now works correctly by making the
954 default for where be { 1 }
955 - added test for this
957 * Moose::Meta::Method::Accessor
958 - coerce and lazy now work together correctly, thanks to
959 merlyn for finding this bug
960 - tests added for this
961 - fix reader presedence bug in Moose::Meta::Attribute + tests
964 - Foo->new(undef) now gets ignored, it is assumed you meant to pass
965 a HASH-ref and missed. This produces better error messages then
966 having it die cause undef is not a HASH.
967 - added tests for this
969 0.21 Thursday, May 2nd, 2007
971 - added SUPER_SLOT and INNER_SLOT class hashes to support unimport
972 - modified unimport to remove super and inner along with the rest
973 - altered unimport tests to handle this
976 - altered super export to populate SUPER_SLOT
979 - altered augment and override modifier application to use *_SLOT
980 - modified tests for these to unimport one test class each to test
983 - fixed issue where custom attribute metaclasses
984 where not handled correctly in roles
985 - added tests for this
988 - fixed issue where extending metaclasses with
989 roles would blow up. Thanks to Aankhen`` for
990 finding this insidious error, and it's solution.
992 ~~ lots of spelling and grammer fixes in the docs,
993 many many thanks to rlb3 and Aankhen for these :)
995 0.20 Friday, April 6th, 2007
996 >> I messed up the SKIP logic in one test
997 so this release is just to fix that.
1000 - 'has' now also accepts an ARRAY ref
1001 to create multiple attrs (see docs)
1002 (thanks to konobi for this)
1003 - added tests and docs
1005 0.19 Thurs. April 5th, 2007
1006 ~~ More documentation updates ~~
1008 * Moose::Util::TypeConstraints
1009 - 'type' now supports messages as well
1010 thanks to phaylon for finding this
1011 - added tests for this
1012 - added &list_all_type_constraints and
1013 &list_all_builtin_type_constraints
1014 functions to facilitate introspection.
1016 * Moose::Meta::Attribute
1017 - fixed regexp 'handles' declarations
1018 to build the list of delegated methods
1019 correctly (and not override important
1020 things like &new) thanks to ashleyb
1022 - added tests and docs for this
1023 - added the 'documentation' attributes
1024 so that you can actually document your
1025 attributes and inspect them through the
1027 - added tests and docs for this
1029 * Moose::Meta::Class
1030 - when loading custom attribute metaclasses
1031 it will first look in for the class in the
1032 Moose::Meta::Attribute::Custom::$name, and
1033 then default to just loading $name.
1034 - added tests and docs for this
1036 * Moose::Meta::TypeConstraint
1037 - type constraints now stringify to their names.
1038 - added test for this
1041 - added tests to assure we work with Module::Refresh
1042 - added stricter test skip logic in the Moose POOP
1043 test, ask Rob Kinyon why.
1044 - *cough* DBM::Deep 1.0 backwards compatability sucks *cough* ;)
1046 0.18 Sat. March 10, 2007
1047 ~~ Many, many documentation updates ~~
1050 - We now use Class::MOP::load_class to
1052 - added tests to show types and subtypes
1053 working with Declare::Constraints::Simple
1054 and Test::Deep as constraint engines.
1057 !! You must have Class::MOP 0.37_001 !!
1058 !! for this developer release to work !!
1060 This release was primarily adding the immutable
1061 feature to Moose. An immutable class is one which
1062 you promise not to alter. When you set the class
1063 as immutable it will perform various bits of
1064 memoization and inline certain part of the code
1065 (constructors, destructors and accessors). This
1066 minimizes (and in some cases totally eliminates)
1067 one of Moose's biggest performance hits. This
1068 feature is not on by default, and is 100% optional.
1069 It has several configurable bits as well, so you
1070 can pick and choose to your specific needs.
1072 The changes involved in this were fairly wide and
1073 highly specific, but 100% backwards compatible, so
1074 I am not going to enumerate them here. If you are
1075 truely interested in what was changed, please do
1078 0.17 Tues. Nov. 14, 2006
1079 * Moose::Meta::Method::Accessor
1080 - bugfix for read-only accessors which
1081 are have a type constraint and lazy.
1082 Thanks to chansen for finding it.
1084 0.16 Tues. Nov. 14, 2006
1086 There are some speed improvements in this release,
1087 but they are only the begining, so stay tuned.
1090 - BUILDALL and DEMOLISHALL no longer get
1091 called unless they actually need to be.
1092 This gave us a signifigant speed boost
1093 for the cases when there is no BUILD or
1094 DEMOLISH method present.
1096 * Moose::Util::TypeConstraints
1097 * Moose::Meta::TypeConstraint
1098 - added an 'optimize_as' option to the
1099 type constraint, which allows for a
1100 hand optimized version of the type
1101 constraint to be used when possible.
1102 - Any internally created type constraints
1103 now provide an optimized version as well.
1105 0.15 Sun. Nov. 5, 2006
1107 This version of Moose *must* have Class::MOP 0.36 in order
1108 to work correctly. A number of small internal tweaks have
1109 been made in order to be compatible with that release.
1111 * Moose::Util::TypeConstraints
1112 - added &unimport so that you can clean out
1113 your class namespace of these exported
1116 * Moose::Meta::Class
1117 - fixed minor issue which occasionally
1118 comes up during global destruction
1120 - moved Moose::Meta::Method::Overriden into
1124 - moved Moose::Meta::Role::Method into
1127 * Moose::Meta::Attribute
1128 - changed how we do type checks so that
1129 we reduce the overall cost, but still
1132 - moved accessor generation methods to
1133 Moose::Meta::Method::Accessor to
1134 conform to the API changes from
1137 * Moose::Meta::TypeConstraint
1138 - changed how constraints are compiled
1139 so that we do less recursion and more
1140 iteration. This makes the type check
1142 - moved Moose::Meta::TypeConstraint::Union
1145 * Moose::Meta::Method::Accessor
1146 - created this from methods formerly found in
1147 Moose::Meta::Attribute
1149 * Moose::Meta::Role::Method
1150 - moved this from Moose::Meta::Role
1152 * Moose::Meta::Method::Overriden
1153 - moved this from Moose::Meta::Class
1155 * Moose::Meta::TypeConstraint::Union
1156 - moved this from Moose::Meta::TypeConstraint
1158 0.14 Mon. Oct. 9, 2006
1160 * Moose::Meta::Attribute
1161 - fixed lazy attributes which were not getting
1162 checked with the type constraint (thanks ashley)
1163 - added tests for this
1164 - removed the over-enthusiastic DWIMery of the
1165 automatic ArrayRef and HashRef defaults, it
1166 broke predicates in an ugly way.
1167 - removed tests for this
1169 0.13 Sat. Sept. 30, 2006
1171 This version of Moose *must* have Class::MOP 0.35 in order
1172 to work correctly. A number of small internal tweaks have
1173 been made in order to be compatible with that release.
1176 - Removed the use of UNIVERSAL::require to be a better
1177 symbol table citizen and remove a dependency
1178 (thanks Adam Kennedy)
1180 **~~ removed experimental & undocumented feature ~~**
1181 - commented out the 'method' and 'self' keywords, see the
1182 comments for more info.
1185 - added a FAQ and WTF files to document frequently
1186 asked questions and common problems
1188 * Moose::Util::TypeConstraints
1189 - added GlobRef and FileHandle type constraint
1190 - added tests for this
1192 * Moose::Meta::Attribute
1193 - if your attribute 'isa' ArrayRef of HashRef, and you have
1194 not explicitly set a default, then make the default DWIM.
1195 This will also work for subtypes of ArrayRef and HashRef
1197 - you can now auto-deref subtypes of ArrayRef or HashRef too.
1198 - new test added for this (thanks to ashley)
1201 - added basic support for runtime role composition
1202 but this is still *highly experimental*, so feedback
1203 is much appreciated :)
1204 - added tests for this
1206 * Moose::Meta::TypeConstraint
1207 - the type constraint now handles the coercion process
1208 through delegation, this is to support the coercion
1211 * Moose::Meta::TypeConstraint::Union
1212 - it is now possible for coercions to be performed
1214 - added tests for this (thanks to konobi)
1216 * Moose::Meta::TypeCoercion
1217 - properly capturing error when type constraint
1221 - Scalar::Util 1.18 is bad on Win32, so temporarily
1222 only require version 1.17 for Win32 and cygwin.
1223 (thanks Adam Kennedy)
1225 0.12 Sat. Sept. 1, 2006
1227 - Recipe5 (subtypes & coercion) has been written
1230 - fixed "bad meta" error message to be more descriptive
1231 - fixed &unimport to not remove the &inner and &super
1232 keywords because we need to localize them.
1233 - fixed number of spelling/grammer issues, thanks Theory :)
1235 **~~ experimental & undocumented feature ~~**
1236 - added the method and self keywords, they are basically
1237 just sugar, and they may not stay around.
1240 - added &dump method to easily Data::Dumper
1243 * Moose::Meta::TypeConstraint
1244 - added the &is_a_type_of method to check both the current
1245 and the subtype of a method (similar to &isa with classes)
1248 - this is now a subclass of Class::MOP::Module, and no longer
1249 creates the _role_meta ugliness of before.
1250 - fixed tests to reflect this change
1252 0.11 Wed. July 12, 2006
1254 - added an &unimport method to remove all the keywords
1255 that Moose will import, simply add 'no Moose' to the
1256 bottom of your class file.
1259 - fixed some test failures caused by a forgotten test
1262 0.10 Thurs. July 6, 2006
1264 - improved error message when loading modules so
1265 it is less confusing when you load a role.
1266 - added &calculate_all_roles method to
1267 Moose::Meta::Class and Moose::Meta::Role
1270 This module has been tested against Class::MOP 0.30
1271 but it does not yet utilize the optimizations
1272 it makes available. Stay tuned for that ;)
1274 0.09_03 Fri. June 23, 2006
1275 ++ DEVELOPER RELEASE ++
1277 - 'use strict' and 'use warnings' are no longer
1278 needed in Moose classes, Moose itself will
1279 turn them on for you.
1280 - added tests for this
1281 - moved code from exported subs to private methods
1282 in Moose::Meta::Class
1285 - as with Moose, strict and warnings are
1286 automatically turned on for you.
1287 - added tests for this
1290 - now handles an edge case for override errors
1291 - added tests for this
1292 - added some more edge case tests
1294 0.09_02 Tues. May 16, 2006
1295 ++ DEVELOPER RELEASE ++
1297 - added prototypes to the exported subs
1301 - added prototypes to the exported subs
1304 * Moose::Util::TypeConstraints
1305 - cleaned up prototypes for the subs
1308 0.09_01 Fri. May 12, 2006
1309 ++ DEVELOPER RELEASE ++
1310 - This release works in combination with
1311 Class::MOP 0.29_01, it is a developer
1312 release because it uses the a new
1313 instance sub-protocol and a fairly
1314 complete Role implementation. It has
1315 not yet been optimized, so it slower
1316 the the previous CPAN version. This
1317 release also lacks good updated docs,
1318 the official release will have updated docs.
1321 - refactored the keyword exports
1322 - 'with' now checks Role validaity and
1323 accepts more than one Role at a time
1324 - 'extends' makes metaclass adjustments as
1325 needed to ensure metaclass compatability
1328 - refactored the keyword exports
1329 - 'with' now checks Role validaity and
1330 accepts more than one Role at a time
1332 * Moose::Util::TypeConstraints
1333 - added the 'enum' keyword for simple
1334 string enumerations which can be used as
1336 - see example of usage in t/202_example.t
1339 - more careful checking of params to new()
1342 - much work done on the role composition
1343 - many new tests for conflict detection
1344 and composition edge cases
1345 - not enough documentation, I suggest
1346 looking at the tests
1348 * Moose::Meta::Instance
1349 - added new Instance metaclass to support
1350 the new Class::MOP instance protocol
1352 * Moose::Meta::Class
1353 - some small changes to support the new
1355 - some small additions to support Roles
1357 * Moose::Meta::Attribute
1358 - some improvements to the accessor generation code
1360 - some small changes to support the new
1362 - (still somewhat) experimental delegation support
1363 with the 'handles' option
1364 - added several tests for this
1365 - no docs for this yet
1367 0.05 Thurs. April 27, 2006
1369 - keywords are now exported with Sub::Exporter
1370 thanks to chansen for this commit
1371 - has keyword now takes a 'metaclass' option
1372 to support custom attribute meta-classes
1373 on a per-attribute basis
1374 - added tests for this
1375 - the 'has' keyword not accepts inherited slot
1376 specifications (has '+foo'). This is still an
1377 experimental feature and probably not finished
1378 see t/038_attribute_inherited_slot_specs.t for
1379 more details, or ask about it on #moose
1380 - added tests for this
1383 - keywords are now exported with Sub::Exporter
1385 * Moose::Utils::TypeConstraints
1386 - reorganized the type constraint hierarchy, thanks
1387 to nothingmuch and chansen for his help and advice
1389 - added some tests for this
1390 - keywords are now exported with Sub::Exporter
1391 thanks to chansen for this commit
1393 * Moose::Meta::Class
1394 - due to changes in Class::MOP, we had to change
1395 construct_instance (for the better)
1397 * Moose::Meta::Attribute
1398 - due to changes in Class::MOP, we had to add the
1399 initialize_instance_slot method (it's a good thing)
1401 * Moose::Meta::TypeConstraint
1402 - added type constraint unions
1403 - added tests for this
1404 - added the is_subtype_of predicate method
1405 - added tests for this
1407 0.04 Sun. April 16th, 2006
1409 - Roles can now consume other roles
1410 - added tests for this
1411 - Roles can specify required methods now with
1412 the requires() keyword
1413 - added tests for this
1416 - ripped out much of it's guts ,.. much cleaner now
1417 - added required methods and correct handling of
1418 them in apply() for both classes and roles
1419 - added tests for this
1420 - no longer adds a does() method to consuming classes
1421 it relys on the one in Moose::Object
1422 - added roles attribute and some methods to support
1423 roles consuming roles
1425 * Moose::Meta::Attribute
1426 - added support for triggers on attributes
1427 - added tests for this
1428 - added support for does option on an attribute
1429 - added tests for this
1431 * Moose::Meta::Class
1432 - added support for attribute triggers in the
1434 - added tests for this
1437 - Moose no longer creates a subtype for your class
1438 if a subtype of the same name already exists, this
1439 should DWIM in 99.9999% of all cases
1441 * Moose::Util::TypeConstraints
1442 - fixed bug where incorrect subtype conflicts were
1444 - added test for this
1447 - this class can now be extended with 'use base' if
1448 you need it, it properly loads the metaclass class now
1449 - added test for this
1451 0.03_02 Wed. April 12, 2006
1453 - you must now explictly use Moose::Util::TypeConstraints
1454 it no longer gets exported for you automatically
1457 - new() now accepts hash-refs as well as key/value lists
1458 - added does() method to check for Roles
1459 - added tests for this
1461 * Moose::Meta::Class
1462 - added roles attribute along with the add_role() and
1464 - added tests for this
1467 - now adds a does() method to consuming classes
1468 which tests the class's hierarchy for roles
1469 - added tests for this
1471 0.03_01 Mon. April 10, 2006
1473 - added new Role recipe (no content yet, only code)
1476 - added 'with' keyword for Role support
1477 - added test and docs for this
1478 - fixed subtype quoting bug
1479 - added test for this
1483 - added test and docs
1485 * Moose::Util::TypeConstraints
1486 - added the message keyword to add custom
1487 error messages to type constraints
1490 - the meta role to support Moose::Role
1491 - added tests and docs
1493 * Moose::Meta::Class
1494 - moved a number of things from Moose.pm
1495 to here, they should have been here
1498 * Moose::Meta::Attribute
1499 - moved the attribute option macros here
1500 instead of putting them in Moose.pm
1502 * Moose::Meta::TypeConstraint
1503 - added the message attributes and the
1505 - added tests and docs for this
1507 0.03 Thurs. March 30, 2006
1509 - added the Moose::Cookbook with 5 recipes,
1510 describing all the stuff Moose can do.
1513 - fixed an issue with &extends super class loading
1514 it now captures errors and deals with inline
1515 packages correctly (bug found by mst, solution
1517 - added super/override & inner/augment features
1518 - added tests and docs for these
1521 - BUILDALL now takes a reference of the %params
1522 that are passed to &new, and passes that to
1525 * Moose::Util::TypeConstraints
1526 - Type constraints now survive runtime reloading
1527 - added test for this
1529 * Moose::Meta::Class
1530 - fixed the way attribute defaults are handled
1531 during instance construction (bug found by chansen)
1533 * Moose::Meta::Attribute
1534 - read-only attributes now actually enforce their
1535 read-only-ness (this corrected in Class::MOP as
1538 0.02 Tues. March 21, 2006
1540 - many more tests, fixing some bugs and
1542 - &extends now loads the base module with
1544 - added UNIVERSAL::require to the
1547 - each new Moose class will also create
1548 and register a subtype of Object which
1549 correspond to the new Moose class.
1550 - the 'isa' option in &has now only
1551 accepts strings, and will DWIM in
1554 * Moose::Util::TypeConstraints
1555 - added type coercion features
1556 - added tests for this
1557 - added support for this in attributes
1558 and instance construction
1560 - type construction no longer creates a
1561 function, it registers the type instead.
1562 - added several functions to get the
1566 - BUILDALL and DEMOLISHALL were broken
1567 because of a mis-named hash key, Whoops :)
1569 * Moose::Meta::Attribute
1570 - adding support for coercion in the
1571 autogenerated accessors
1573 * Moose::Meta::Class
1574 - adding support for coercion in the
1575 instance construction
1577 * Moose::Meta::TypeConstraint
1578 * Moose::Meta::TypeCoercion
1579 - type constraints and coercions are now
1580 full fledges meta-objects
1582 0.01 Wed. March 15, 2006
1583 - Moooooooooooooooooose!!!