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)
9 - This is a new helper module for writing "Moose-alike"
10 modules. This should make the lives of MooseX module authors
11 much easier. (Dave Rolsky)
14 * Moose::Cookbook::Meta::Recipe5
15 - Implemented metaclass traits (and wrote a recipe for it):
17 use Moose -traits => 'Foo'
19 This should make writing small Moose extensions a little
23 * Moose::Cookbook::Extending::Recipe1
24 * Moose::Cookbook::Extending::Recipe2
25 - Rewrote extending and embedding moose documentation and
26 recipes to use Moose::Exporter (Dave Rolsky)
30 - These two modules now warn when you load them from the main
31 package "main" package, because we will not export sugar to
32 main. Previously it just did nothing. (Dave Rolsky)
34 0.55 Sun August 3, 2008
35 * Moose::Meta::Attribute
36 - breaking down the way 'handles' methods are
37 created so that the process can be more easily
38 overridden by subclasses (stevan)
40 * Moose::Meta::TypeConstraint
41 - fixing what is passed into a ->message with
42 the type constraints (RT #37569)
43 - added tests for this (Charles Alderman)
45 * Moose::Util::TypeConstraints
46 - fix coerce to accept anon types like subtype can (mst)
49 - reorganized the recipes into sections - Basics, Roles, Meta,
50 Extending - and wrote abstracts for each section (Dave Rolsky)
52 * Moose::Cookbook::Basics::Recipe10
53 - A new recipe that demonstrates operator overloading
54 in combination with Moose. (bluefeet)
56 * Moose::Cookbook::Meta::Recipe1
57 - an introduction to what meta is and why you'd want to make
58 your own metaclass extensions (Dave Rolsky)
60 * Moose::Cookbook::Meta::Recipe4
61 - a very simple metaclass example (Dave Rolsky)
63 * Moose::Cookbook::Extending::Recipe1
64 - how to write a Moose-alike module to use your own object base
67 * Moose::Cookbook::Extending::Recipe2
68 - how to write modules with an API just like C<Moose.pm> (Dave
72 - Tons of fixes, both syntactical and grammatical (Dave
75 0.54 Thurs. July 3, 2008
76 ... this is not my day today ...
78 * Moose::Meta::Attribute
79 - fixed legal_options_for_inheritance such that
80 clone_and_inherit options still works for
81 Class::MOP::Attribute objects and therefore
82 does not break MooseX::AttributeHelpers
85 0.53 Thurs. July 3, 2008
86 * Whoops, I guess I should run 'make manifest' before
87 actually releasing the module. No actual changes
88 in this release, except the fact that it includes
89 the changes that I didn't include in the last
92 0.52 Thurs. July 3, 2008
94 - added "FEATURE REQUESTS" section to the Moose docs
95 to properly direct people (stevan) (RT #34333)
96 - making 'extends' croak if it is passed a Role since
97 this is not ever something you want to do
98 (fixed by stevan, found by obra)
99 - added tests for this (stevan)
102 - adding support for DOES (as in UNIVERSAL::DOES)
104 - added test for this
106 * Moose::Meta::Attribute
107 - added legal_options_for_inheritance (wreis)
108 - added tests for this (wreis)
110 * Moose::Cookbook::Snacks::*
111 - removed some of the unfinished snacks that should
112 not have been released yet. Added some more examples
113 to the 'Keywords' snack. (stevan)
115 * Moose::Cookbook::Style
116 - added general Moose "style guide" of sorts to the
117 cookbook (nothingmuch) (RT #34335)
120 - added more BUILDARGS tests (stevan)
122 0.51 Thurs. Jun 26, 2008
124 - add unimport so "no Moose::Role" actually does
127 * Moose::Meta::Role::Application::ToRole
128 - when RoleA did RoleB, and RoleA aliased a method from RoleB in
129 order to provide its own implementation, that method still got
130 added to the list of required methods for consumers of
131 RoleB. Now an aliased method is only added to the list of
132 required methods if the role doing the aliasing does not
133 provide its own implementation. See Recipe 11 for an example
134 of all this. (Dave Rolsky)
135 - added tests for this
137 * Moose::Meta::Method::Constructor
138 - when a single argument that wasn't a hashref was provided to
139 an immutabilized constructor, the error message was very
140 unhelpful, as opposed to the non-immutable error. Reported by
142 - added test for this (Dave Rolsky)
144 * Moose::Meta::Attribute
145 - added support for meta_attr->does("ShortAlias") (sartak)
146 - added tests for this (sartak)
147 - moved the bulk of the `handles` handling to the new
148 install_delegation method (Stevan)
151 - Added BUILDARGS, a new step in new()
153 * Moose::Meta::Role::Application::RoleSummation
154 - fix typos no one ever sees (sartak)
156 * Moose::Util::TypeConstraints
157 * Moose::Meta::TypeConstraint
158 * Moose::Meta::TypeCoercion
159 - Attempt to work around the ??{ } vs. threads issue
161 - Some null_constraint optimizations
163 0.50 Thurs. Jun 11, 2008
164 - Fixed a version number issue by bumping all modules
167 0.49 Thurs. Jun 11, 2008
168 !! This version now approx. 20-25% !!
169 !! faster with new Class::MOP 0.59 !!
171 * Moose::Meta::Attribute
172 - fixed how the is => (ro|rw) works with
173 custom defined reader, writer and accessor
175 - added docs for this (TODO).
176 - added tests for this (Thanks to Penfold)
177 - added the custom attribute alias for regular
178 Moose attributes which is "Moose"
179 - fix builder and default both being used
184 Moose::Meta::Attribute
186 Moose::Meta::Role::Composite
187 Moose::Util::TypeConstraints
188 - switched usage of reftype to ref because
192 - changing add_package_symbol to use the new
196 - fixed how DEMOLISHALL is called so that it
197 can be overrided in subclasses (thanks to Sartak)
198 - added test for this (thanks to Sartak)
200 * Moose::Util::TypeConstraints
201 - move the ClassName type check code to
202 Class::MOP::is_class_loaded (thanks to Sartak)
204 * Moose::Cookbook::Recipe11
205 - add tests for this (thanks to tokuhirom)
207 0.48 Thurs. May 29, 2008
208 (early morning release engineering)--
210 - fixing the version in Moose::Meta::Method::Destructor
211 which was causing the indexer to choke
213 0.47 Thurs. May 29, 2008
214 (late night release engineering)--
216 - fixing the version is META.yml, no functional
217 changes in this release
219 0.46 Wed. May 28, 2008
220 !! This version now approx. 20-25% !!
221 !! faster with new Class::MOP 0.57 !!
224 - some optimizations of the &initialize method
225 since it is called so often by &meta
229 - now use the get_all_package_symbols from the
230 updated Class::MOP, test suite is now 10 seconds
233 * Moose::Meta::Method::Destructor
234 - is_needed can now also be called as a class
235 method for immutablization to check if the
236 destructor object even needs to be created
239 * Moose::Meta::Method::Destructor
240 Moose::Meta::Method::Constructor
241 - added more descriptive error message to help
242 keep people from wasting time tracking an error
243 that is easily fixed by upgrading.
245 0.45 Saturday, May 24, 2008
247 - Because of work in Class::MOP 0.56, all
248 XS based functionality is now optional
249 and a Pure Perl version is supplied
250 - the CLASS_MOP_NO_XS environment variable
251 can now be used to force non-XS versions
253 - several of the packages have been tweaked
254 to take care of this, mostly we added
255 support for the package_name and name
256 variables in all the Method metaclasses
257 - before/around/after method modifiers now
258 support regexp matching of names
259 (thanks to Takatoshi Kitano)
260 - tests added for this
261 - NOTE: this only works for classes, it
262 is currently not supported in roles,
263 but, ... patches welcome
264 - All usage of Carp::confess have been replaced
265 by Carp::croak in the "keyword" functions since
266 the stack trace is usually not helpful
269 - All usage of Carp::confess have been replaced
270 by Carp::croak in the "keyword" functions since
271 the stack trace is usually not helpful
272 - The 'has' keyword for roles now accepts the
273 same array ref form that Moose.pm does
274 (has [qw/foo bar/] => (is => 'rw', ...))
275 - added test for this
277 * Moose::Meta::Attribute
278 - trigger on a ro-attribute is no longer an
279 error, as it's useful to trigger off of the
283 - added same 'add_package_symbol' fix as in
287 - does_role now handles non-Moose classes
289 - added tests for this
290 - added the 'add_method_modifier' function
291 (thanks to Takatoshi Kitano)
293 * Moose::Util::TypeConstraints
294 - subtypes of parameterizable types now are
295 themselves parameterizable types
297 * Moose::Meta::Method::Constructor
298 - fixed bug where trigger was not being
299 called by the inlined immutable
301 - added test for this (thanks to Caelum)
303 * Moose::Meta::Role::Application::ToInstance
304 - now uses the metaclass of the instance
305 (if possible) to create the anon-class
306 (thanks Jonathan Rockway)
308 * Moose::Cookbook::Recipe22
309 - added the meta-attribute trait recipe
313 - fixed hash-ordering test bug that was
314 causing occasional cpantester failures
315 - renamed the t/000_recipe/*.t tests to be
316 more descriptive (thanks to Sartak)
318 0.44 Sat. May 10, 2008
320 - made make_immutable warning cluck to
321 show where the error is (thanks mst)
324 - BUILDALL and DEMOLISHALL now call
325 ->body when looping through the
326 methods, to avoid the overloaded
328 - fixed issue where DEMOLISHALL was
329 eating the $@ values, and so not
330 working correctly, it still kind of
331 eats them, but so does vanilla perl
332 - added tests for this
334 * Moose::Cookbook::Recipe7
335 - added new recipe for immutable
336 functionality (thanks Dave Rolsky)
338 * Moose::Cookbook::Recipe9
339 - added new recipe for builder and
340 lazy_build (thanks Dave Rolsky)
342 * Moose::Cookbook::Recipe11
343 - added new recipe for method aliasing
344 and exclusion with Roles (thanks Dave Rolsky)
347 - fixed Win32 test failure (thanks spicyjack)
349 ~ removed Build.PL and Module::Build compat
350 since Module::Install has done that.
352 0.43 Wed. April, 30, 2008
354 drink more coffee before
355 doing release engineering
357 - whoops, forgot to do the smolder tests,
358 and we broke some of the custom meta-attr
359 modules. This fixes that.
361 0.42 Mon. April 28, 2008
362 - some bad tests slipped by, nothing else
363 changed in this release (cpantesters++)
365 - upped the Class::MOP dependency to 0.55
366 since we have tests which need the C3
369 0.41 Mon. April 28, 2008
370 ~~ numerous documentation updates ~~
372 - Changed all usage of die to Carp::croak for better
373 error reporting (initial patch by Tod Hagan)
376 - the make_immutable keyword is now deprecated, don't
377 use it in any new code and please fix your old code
378 as well. There will be 2 releases, and then it will
384 - refactored the way inner and super work to avoid
385 any method/@ISA cache penalty (nothingmuch)
388 - fixing &new_object to make sure trigger gets the
389 coerced value (spotted by Charles Alderman on the
391 - added test for this
393 * Moose::Meta::Method::Constructor
394 - immutable classes which had non-lazy attributes were calling
395 the default generating sub twice in the constructor. (bug
396 found by Jesse Luehrs, fixed by Dave Rolsky)
397 - added tests for this (Dave Rolsky)
398 - fix typo in initialize_body method (nothingmuch)
400 * Moose::Meta::Method::Destructor
401 - fix typo in initialize_body method (nothingmuch)
403 * Moose::Meta::Method::Overriden
404 Moose::Meta::Method::Augmented
405 - moved the logic for these into their own
406 classes (nothingmuch)
408 * Moose::Meta::Attribute
409 - inherited attributes may now be extended without
410 restriction on the type ('isa', 'does') (Sartak)
411 - added tests for this (Sartak)
412 - when an attribute property is malformed (such as lazy without
413 a default), give the name of the attribute in the error
415 - added the &applied_traits and &has_applied_traits methods
416 to allow introspection of traits
417 - added tests for this
418 - moved 'trait' and 'metaclass' argument handling to here from
420 - clone_and_inherit_options now handles 'trait' and 'metaclass' (has
421 '+foo' syntax) (nothingmuch)
422 - added tests for this (t0m)
425 - localize $@ inside DEMOLISHALL to avoid it
426 eating $@ (found by Ernesto)
427 - added test for this (thanks to Ernesto)
429 * Moose::Util::TypeConstraints
430 - &find_type_constraint now DWIMs when given an
431 type constraint object or name (nothingmuch)
432 - &find_or_create_type_constraint superseded with a number of more
434 - find_or_create_{isa,does}_type_constraint
435 - find_or_parse_type_constraint
437 * Moose::Meta::TypeConstraint
438 Moose::Meta::TypeConstraint::Class
439 Moose::Meta::TypeConstraint::Role
440 Moose::Meta::TypeConstraint::Enum
441 Moose::Meta::TypeConstraint::Union
442 Moose::Meta::TypeConstraint::Parameterized
443 - added the &equals method for comparing two type
444 constraints (nothingmuch)
445 - added tests for this (nothingmuch)
447 * Moose::Meta::TypeConstraint
448 - add the &parents method, which is just an alias to &parent.
449 Useful for polymorphism with TC::{Class,Role,Union} (nothingmuch)
451 * Moose::Meta::TypeConstraint::Class
452 - added the class attribute for introspection purposes
454 - added tests for this
456 * Moose::Meta::TypeConstraint::Enum
457 Moose::Meta::TypeConstraint::Role
458 - broke these out into their own classes (nothingmuch)
460 * Moose::Cookbook::Recipe*
461 - fixed references to test file locations in the POD
462 and updated up some text for new Moose features
466 - Added &resolve_metaclass_alias, a helper function for finding an actual
467 class for a short name (e.g. in the traits list)
469 0.40 Fri. March 14, 2008
470 - I hate Pod::Coverage
472 0.39 Fri. March 14, 2008
474 - documenting the use of '+name' with attributes
475 that come from recently composed roles. It makes
476 sense, people are using it, and so why not just
477 officially support it.
478 - fixing the 'extends' keyword so that it will not
479 trigger Ovid's bug (http://use.perl.org/~Ovid/journal/35763)
482 - added the perl -Moose=+Class::Name feature to allow
483 monkeypatching of classes in one liners
486 - fixing the 'apply_all_roles' keyword so that it will not
487 trigger Ovid's bug (http://use.perl.org/~Ovid/journal/35763)
490 - added ->create method which now supports roles (thanks to jrockway)
491 - added tests for this
492 - added ->create_anon_class which now supports roles and caching of
493 the results (thanks to jrockway)
494 - added tests for this
495 - made ->does_role a little more forgiving when it is
496 checking a Class::MOP era metaclasses.
498 * Moose::Meta::Role::Application::ToInstance
499 - it is now possible to pass extra params to be used when
500 a role is applied to an the instance (rebless_params)
501 - added tests for this
503 * Moose::Util::TypeConstraints
504 - class_type now accepts an optional second argument for a
505 custom message. POD anotated accordingly (groditi)
506 - added tests for this
507 - it is now possible to make anon-enums by passing 'enum' an
508 ARRAY ref instead of the $name => @values. Everything else
510 - added tests for this
513 - making test for using '+name' on attributes consumed
514 from a role, it works and makes sense too.
516 * Moose::Meta::Attribute
517 - fix handles so that it doesn't return nothing
518 when the method cannot be found, not sure why
519 it ever did this originally, this means we now
520 have slightly better support for AUTOLOADed
522 - added more delegation tests
523 - adding ->does method to this so as to better
524 support traits and their introspection.
525 - added tests for this
528 - localizing the Data::Dumper configurations so
529 that it does not pollute others (RT #33509)
530 - made ->does a little more forgiving when it is
531 passed Class::MOP era metaclasses.
533 0.38 Fri. Feb. 15, 2008
534 * Moose::Meta::Attribute
535 - fixed initializer to correctly do
536 type checking and coercion in the
538 - added tests for this
541 - fixed some finicky tests (thanks to konobi)
543 0.37 Thurs. Feb. 14, 2008
545 - fixed some details in Moose::init_meta
546 and its superclass handling (thanks thepler)
547 - added tests for this (thanks thepler)
548 - 'has' now dies if you don't pass in name
550 - added the 'make_immutable' keyword as a shortcut
554 Moose::Meta::Method::Constructor
555 Moose::Meta::Attribute
556 - making (init_arg => undef) work here too
557 (thanks to nothingmuch)
559 * Moose::Meta::Attribute
560 Moose::Meta::Method::Constructor
561 Moose::Meta::Method::Accessor
562 - make lazy attributes respect attr initializers (rjbs)
563 - added tests for this
565 * Moose::Util::TypeConstraints
566 Moose::Util::TypeConstraints::OptimizedConstraints
567 Moose::Meta::TypeConstraints
568 Moose::Meta::Attribute
569 Moose::Meta::Method::Constructor
570 Moose::Meta::Method::Accessor
571 - making type errors use the
572 assigned message (thanks to Sartak)
573 - added tests for this
575 * Moose::Meta::Method::Destructor
576 - making sure DESTROY gets inlined properly
577 with successive DEMOLISH calls (thanks to manito)
579 * Moose::Meta::Attribute
580 Moose::Meta::Method::Accessor
581 - fixed handling of undef with type constraints
583 - added tests for this
586 - added &get_all_init_args and &get_all_attribute_values
587 (thanks to Sartak and nothingmuch)
589 0.36 Sat. Jan. 26, 2008
591 Moose::Meta::Attribute
592 - role type tests now support when roles are
593 applied to non-Moose classes (found by ash)
594 - added tests for this (thanks to ash)
595 - couple extra tests to boost code coverage
597 * Moose::Meta::Method::Constructor
598 - improved fix for handling Class::MOP attributes
599 - added test for this
602 - handled the add_attribute($attribute_meta_object)
604 - added test for this
606 0.35 Tues. Jan. 22, 2008
607 * Moose::Meta::Method::Constructor
608 - fix to make sure even Class::MOP attributes
609 are handled correctly (Thanks to Dave Rolsky)
610 - added test for this (also Dave Rolsky)
613 - improved error message on _apply_all_roles,
614 you should now use Moose::Util::apply_all_roles
615 and you shouldnt have been using a _ prefixed
616 method in the first place ;)
618 0.34 Mon. Jan. 21, 2008
619 ~~~ more misc. doc. fixes ~~~
620 ~~ updated copyright dates ~~
622 Moose is now a postmodern object system :)
623 - (see the POD for details)
625 * <<Role System Refactoring>>
626 - this release contains a major reworking and
627 cleanup of the role system
628 - 100% backwards compat.
629 - Role application now restructured into seperate
630 classes based on type of applicants
631 - Role summation (combining of more than one role)
632 is much cleaner and anon-classes are no longer
634 - new Composite role metaclass
635 - runtime application of roles to instances
636 is now more efficient and re-uses generated
637 classes when applicable
639 * <<New Role composition features>>
640 - methods can now be excluded from a given role
642 - methods can now be aliased to another name (and
643 still retain the original as well)
645 * Moose::Util::TypeConstraints::OptimizedConstraints
646 - added this module (see above)
649 - fixed the &_process_attribute method to be called
650 by &add_attribute, so that the API is now correct
652 * Moose::Meta::Method::Accessor
653 - fixed bug when passing a list of values to
654 an accessor would get (incorrectly) ignored.
655 Thanks to Sartak for finding this ;)
656 - added tests for this (Sartak again)
658 * Moose::Meta::Method::Accessor
659 Moose::Meta::Method::Constructor
660 Moose::Meta::Attribute
661 Moose::Meta::TypeConstraint
662 Moose::Meta::TypeCoercion
663 - lots of cleanup of such things as:
665 - type constraint handling
666 - error handling/messages
667 (thanks to nothingmuch)
669 * Moose::Meta::TypeConstraint::Parameterizable
670 - added this module to support the refactor
671 in Moose::Meta::TypeConstraint::Parameterized
673 * Moose::Meta::TypeConstraint::Parameterized
674 - refactored how these types are handled so they
675 are more generic and not confined to ArrayRef
679 - shortened some file names for better VMS support (RT #32381)
681 0.33 Fri. Dec. 14, 2007
682 !! Moose now loads 2 x faster !!
683 !! with new Class::MOP 0.49 !!
685 ++ new oose.pm module to make command line
686 Moose-ness easier (see POD docs for more)
690 - several tweaks to take advantage of the
691 new method map caching in Class::MOP
693 * Moose::Meta::TypeConstraint::Parameterized
694 - allow subtypes of ArrayRef and HashRef to
695 be used as a container (sartak)
696 - added tests for this
697 - basic support for coercion to ArrayRef and
698 HashRef for containers (sartak)
699 - added tests for this
701 * Moose::Meta::TypeCoercion
702 - coercions will now create subtypes as needed
703 so you can now add coercions to parameterized
704 types without having to explictly define them
705 - added tests for this
707 * Moose::Meta::Method::Accessor
708 - allow subclasses to decide whether we need
709 to copy the value into a new variable (sartak)
711 0.32 Tues. Dec. 4, 2007
712 * Moose::Util::TypeConstraints
713 - fixing how subtype aliases of unions work
714 they should inherit the parent's coercion
715 - added tests for this
716 - you can now define multiple coercions on
717 a single type at different times instead of
718 having to do it all in one place
719 - added tests for this
721 * Moose::Meta::TypeConstraint
722 - there is now a default constraint of sub { 1 }
723 instead of Moose::Util::TypeConstraints setting
726 * Moose::Meta::TypeCoercion
727 * Moose::Meta::TypeCoercion::Union
728 - added the &has_coercion_for_type and
729 &add_type_coercions methods to support the
730 new features above (although you cannot add
731 more type coercions for Union types)
733 0.31 Mon. Nov. 26, 2007
734 * Moose::Meta::Attribute
735 - made the +attr syntax handle extending types with
736 parameters. So "has '+foo' => (isa => 'ArrayRef[Int]')"
737 now works if the original foo is an ArrayRef.
738 - added tests for this.
739 - delegation now works even if the attribute does not
740 have a reader method using the get_read_method_ref
741 method from Class::MOP::Attribute.
742 - added tests for this
743 - added docs for this
745 * Moose::Util::TypeConstraints
746 - passing no "additional attribute info" to
747 &find_or_create_type_constraint will no longer
748 attempt to create an __ANON__ type for you,
749 instead it will just return undef.
750 - added docs for this
752 0.30 Fri. Nov. 23, 2007
753 * Moose::Meta::Method::Constructor
754 -builder related bug in inlined constructor. (groditi)
756 * Moose::Meta::Method::Accessor
757 - genereate unnecessary calls to predicates and refactor
758 code generation for runtime speed (groditi)
760 * Moose::Util::TypeConstraints
761 - fix ClassName constraint to introspect symbol table (mst)
762 - added more tests for this (mst)
763 - fixed it so that subtype 'Foo' => as 'HashRef[Int]' ...
765 - added tests for this
768 - adding the link to Recipie 11 (written by Sartak)
769 - adding test for SYNOPSIS code
772 - New tests for builder bug. Upon instantiation, if an
773 attribute had a builder, no value and was not lazy the
774 builder default was not getting run, oops. (groditi)
776 0.29 Tues. Nov. 13, 2007
777 * Moose::Meta::Attribute
778 - Fix error message on missing builder method (groditi)
780 * Moose::Meta::Method::Accessor
781 - Fix error message on missing builder method (groditi)
784 - Add test to check for the correct error message when
785 builder method is missing (groditi)
787 0.28 Tues. Nov. 13, 2007
788 - 0.27 packaged incorrectly (groditi)
790 0.27 Tues. Nov. 13, 2007
791 * Moose::Meta::Attribute
792 - Added support for the new builder option (groditi)
793 - Added support for lazy_build option (groditi)
794 - Changed slot initialization for predicate changes (groditi)
796 * Moose::Meta::Method::Accessor
797 - Added support for lazy_build option (groditi)
798 - Fix inline methods to work with corrected predicate
801 * Moose::Meta::Method::Constructor
802 - Added support for lazy_build option (groditi)
805 - tests for builder and lazy_build (groditi)
807 * fixing some misc. bits in the docs that
808 got mentioned on CPAN Forum & perlmonks
811 - fixed how required methods are handled
812 when they encounter overriden or modified
813 methods from a class (thanks to confound).
814 - added tests for this
816 * Moose::Util::TypeConstraint
817 - fixed the type notation parser so that
818 the | always creates a union and so is
819 no longer a valid type char (thanks to
820 konobi, mugwump and #moose for working
822 - added more tests for this
824 0.26 Thurs. Sept. 27, 2007
827 * Parameterized Types
828 We now support parameterized collection types, such as:
829 ArrayRef[Int] # array or integers
830 HashRef[Object] # a hash with object values
831 They can also be nested:
832 ArrayRef[HashRef[RegExpr]] # an array of hashes with regexpr values
833 And work with the type unions as well:
834 ArrayRef[Int | Str] # array of integers of strings
836 * Better Framework Extendability
837 Moose.pm is now "extendable" such that it is now much
838 easier to extend the framework and add your own keywords
839 and customizations. See the "EXTENDING AND EMBEDDING MOOSE"
840 section of the Moose.pm docs.
843 In an effort to begin documenting some of the various
844 details of Moose as well as some common idioms, we have
845 created Moose::Cookbook::Snacks as a place to find
846 small (easily digestable) nuggets of Moose code.
849 ~ Several doc updates/cleanup thanks to castaway ~
851 - converted build system to use Module::Install instead of
852 Module::Build (thanks to jrockway)
855 - added all the meta classes to the immutable list and
856 set it to inline the accessors
857 - fix import to allow Sub::Exporter like { into => }
858 and { into_level => } (perigrin)
859 - exposed and documented init_meta() to allow better
860 embedding and extending of Moose (perigrin)
863 - complete re-organization of the test suite
864 - added some new tests as well
865 - finally re-enabled the Moose::POOP test since
866 the new version of DBM::Deep now works again
870 - fixed very odd and very nasty recursion bug with
872 - added tests for this (eilara)
874 * Moose::Meta::Attribute
875 Moose::Meta::Method::Constructor
876 Moose::Meta::Method::Accessor
877 - fixed issue with overload::Overloaded getting called
878 on non-blessed items. (RT #29269)
879 - added tests for this
881 * Moose::Meta::Method::Accessor
882 - fixed issue with generated accessor code making
883 assumptions about hash based classes (thanks to dexter)
885 * Moose::Coookbook::Snacks
886 - these are bits of documentation, not quite as big as
887 Recipes but which have no clear place in the module docs.
888 So they are Snacks! (horray for castaway++)
890 * Moose::Cookbook::Recipe4
891 - updated it to use the new ArrayRef[MyType] construct
892 - updated the accompanying test as well
894 +++ Major Refactor of the Type Constraint system +++
895 +++ with new features added as well +++
897 * Moose::Util::TypeConstraint
898 - no longer uses package variable to keep track of
899 the type constraints, now uses the an instance of
900 Moose::Meta::TypeConstraint::Registry to do it
901 - added more sophisticated type notation parsing
903 - added tests for this
905 * Moose::Meta::TypeConstraint
906 - some minor adjustments to make subclassing easier
907 - added the package_defined_in attribute so that we
908 can track where the type constraints are created
910 * Moose::Meta::TypeConstraint::Union
911 - this is now been refactored to be a subclass of
912 Moose::Meta::TypeConstraint
914 * Moose::Meta::TypeCoercion::Union
915 - this has been added to service the newly refactored
916 Moose::Meta::TypeConstraint::Union and is itself
917 a subclass of Moose::Meta::TypeCoercion
919 * Moose::Meta::TypeConstraint::Parameterized
920 - added this module (taken from MooseX::AttributeHelpers)
921 to help construct nested collection types
922 - added tests for this
924 * Moose::Meta::TypeConstraint::Registry
925 - added this class to keep track of type constraints
927 0.25 Mon. Aug. 13, 2007
929 - Documentation update to reference Moose::Util::TypeConstraints
930 under 'isa' in 'has' for how to define a new type
933 * Moose::Meta::Attribute
934 - required attributes now will no longer accept undef
935 from the constructor, even if there is a default and lazy
936 - added tests for this
937 - default subroutines must return a value which passes the
939 - added tests for this
941 * Moose::Meta::Attribute
942 * Moose::Meta::Method::Constructor
943 * Moose::Meta::Method::Accessor
944 - type-constraint tests now handle overloaded objects correctly
946 - added tests for this (thanks to EvanCarroll)
948 * Moose::Meta::TypeConstraint::Union
949 - added (has_)hand_optimized_constraint to this class so that
950 it behaves as the regular Moose::Meta::TypeConstraint does.
953 - large refactoring of this code
954 - added several more tests
955 - tests for subtle conflict resolition issues
956 added, but not currently running
959 * Moose::Cookbook::Recipe7
960 - added new recipe for augment/inner functionality
962 - added test for this
965 - a formal definition of roles (still in progress)
968 - utilities for easier working with Moose classes
969 - added tests for these
972 - This contains Moose specific test functions
973 - added tests for these
975 0.24 Tues. July 3, 2007
976 ~ Some doc updates/cleanup ~
978 * Moose::Meta::Attribute
979 - added support for roles to be given as parameters
980 to the 'handles' option.
981 - added tests and docs for this
982 - the has '+foo' attribute form now accepts changes to
983 the lazy option, and the addition of a handles option
984 (but not changing the handles option)
985 - added tests and docs for this
988 - required methods are now fetched using find_method_by_name
989 so that required methods can come from superclasses
990 - adjusted tests for this
992 0.23 Mon. June 18, 2007
993 * Moose::Meta::Method::Constructor
994 - fix inlined constructor for hierarchy with multiple BUILD methods (mst)
996 - Modify make_immutable to work with the new Class::MOP immutable
997 mechanism + POD + very basic test (groditi)
998 * Moose::Meta::Attribute
999 - Fix handles to use goto() so that caller() comes out properly on
1000 the other side (perigrin)
1002 0.22 Thurs. May 31, 2007
1003 * Moose::Util::TypeConstraints
1004 - fix for prototype undeclared issue when Moose::Util::TypeConstraints
1005 loaded before consumers (e.g. Moose::Meta::Attribute) by predeclaring
1006 prototypes for functions
1007 - added the ClassName type constraint, this checks for strings
1008 which will respond true to ->isa(UNIVERSAL).
1009 - added tests and docs for this
1010 - subtyping just in name now works correctly by making the
1011 default for where be { 1 }
1012 - added test for this
1014 * Moose::Meta::Method::Accessor
1015 - coerce and lazy now work together correctly, thanks to
1016 merlyn for finding this bug
1017 - tests added for this
1018 - fix reader presedence bug in Moose::Meta::Attribute + tests
1021 - Foo->new(undef) now gets ignored, it is assumed you meant to pass
1022 a HASH-ref and missed. This produces better error messages then
1023 having it die cause undef is not a HASH.
1024 - added tests for this
1026 0.21 Thursday, May 2nd, 2007
1028 - added SUPER_SLOT and INNER_SLOT class hashes to support unimport
1029 - modified unimport to remove super and inner along with the rest
1030 - altered unimport tests to handle this
1033 - altered super export to populate SUPER_SLOT
1035 * Moose::Meta::Class
1036 - altered augment and override modifier application to use *_SLOT
1037 - modified tests for these to unimport one test class each to test
1040 - fixed issue where custom attribute metaclasses
1041 where not handled correctly in roles
1042 - added tests for this
1044 * Moose::Meta::Class
1045 - fixed issue where extending metaclasses with
1046 roles would blow up. Thanks to Aankhen`` for
1047 finding this insidious error, and it's solution.
1049 ~~ lots of spelling and grammer fixes in the docs,
1050 many many thanks to rlb3 and Aankhen for these :)
1052 0.20 Friday, April 6th, 2007
1053 >> I messed up the SKIP logic in one test
1054 so this release is just to fix that.
1057 - 'has' now also accepts an ARRAY ref
1058 to create multiple attrs (see docs)
1059 (thanks to konobi for this)
1060 - added tests and docs
1062 0.19 Thurs. April 5th, 2007
1063 ~~ More documentation updates ~~
1065 * Moose::Util::TypeConstraints
1066 - 'type' now supports messages as well
1067 thanks to phaylon for finding this
1068 - added tests for this
1069 - added &list_all_type_constraints and
1070 &list_all_builtin_type_constraints
1071 functions to facilitate introspection.
1073 * Moose::Meta::Attribute
1074 - fixed regexp 'handles' declarations
1075 to build the list of delegated methods
1076 correctly (and not override important
1077 things like &new) thanks to ashleyb
1079 - added tests and docs for this
1080 - added the 'documentation' attributes
1081 so that you can actually document your
1082 attributes and inspect them through the
1084 - added tests and docs for this
1086 * Moose::Meta::Class
1087 - when loading custom attribute metaclasses
1088 it will first look in for the class in the
1089 Moose::Meta::Attribute::Custom::$name, and
1090 then default to just loading $name.
1091 - added tests and docs for this
1093 * Moose::Meta::TypeConstraint
1094 - type constraints now stringify to their names.
1095 - added test for this
1098 - added tests to assure we work with Module::Refresh
1099 - added stricter test skip logic in the Moose POOP
1100 test, ask Rob Kinyon why.
1101 - *cough* DBM::Deep 1.0 backwards compatability sucks *cough* ;)
1103 0.18 Sat. March 10, 2007
1104 ~~ Many, many documentation updates ~~
1107 - We now use Class::MOP::load_class to
1109 - added tests to show types and subtypes
1110 working with Declare::Constraints::Simple
1111 and Test::Deep as constraint engines.
1114 !! You must have Class::MOP 0.37_001 !!
1115 !! for this developer release to work !!
1117 This release was primarily adding the immutable
1118 feature to Moose. An immutable class is one which
1119 you promise not to alter. When you set the class
1120 as immutable it will perform various bits of
1121 memoization and inline certain part of the code
1122 (constructors, destructors and accessors). This
1123 minimizes (and in some cases totally eliminates)
1124 one of Moose's biggest performance hits. This
1125 feature is not on by default, and is 100% optional.
1126 It has several configurable bits as well, so you
1127 can pick and choose to your specific needs.
1129 The changes involved in this were fairly wide and
1130 highly specific, but 100% backwards compatible, so
1131 I am not going to enumerate them here. If you are
1132 truely interested in what was changed, please do
1135 0.17 Tues. Nov. 14, 2006
1136 * Moose::Meta::Method::Accessor
1137 - bugfix for read-only accessors which
1138 are have a type constraint and lazy.
1139 Thanks to chansen for finding it.
1141 0.16 Tues. Nov. 14, 2006
1143 There are some speed improvements in this release,
1144 but they are only the begining, so stay tuned.
1147 - BUILDALL and DEMOLISHALL no longer get
1148 called unless they actually need to be.
1149 This gave us a signifigant speed boost
1150 for the cases when there is no BUILD or
1151 DEMOLISH method present.
1153 * Moose::Util::TypeConstraints
1154 * Moose::Meta::TypeConstraint
1155 - added an 'optimize_as' option to the
1156 type constraint, which allows for a
1157 hand optimized version of the type
1158 constraint to be used when possible.
1159 - Any internally created type constraints
1160 now provide an optimized version as well.
1162 0.15 Sun. Nov. 5, 2006
1164 This version of Moose *must* have Class::MOP 0.36 in order
1165 to work correctly. A number of small internal tweaks have
1166 been made in order to be compatible with that release.
1168 * Moose::Util::TypeConstraints
1169 - added &unimport so that you can clean out
1170 your class namespace of these exported
1173 * Moose::Meta::Class
1174 - fixed minor issue which occasionally
1175 comes up during global destruction
1177 - moved Moose::Meta::Method::Overriden into
1181 - moved Moose::Meta::Role::Method into
1184 * Moose::Meta::Attribute
1185 - changed how we do type checks so that
1186 we reduce the overall cost, but still
1189 - moved accessor generation methods to
1190 Moose::Meta::Method::Accessor to
1191 conform to the API changes from
1194 * Moose::Meta::TypeConstraint
1195 - changed how constraints are compiled
1196 so that we do less recursion and more
1197 iteration. This makes the type check
1199 - moved Moose::Meta::TypeConstraint::Union
1202 * Moose::Meta::Method::Accessor
1203 - created this from methods formerly found in
1204 Moose::Meta::Attribute
1206 * Moose::Meta::Role::Method
1207 - moved this from Moose::Meta::Role
1209 * Moose::Meta::Method::Overriden
1210 - moved this from Moose::Meta::Class
1212 * Moose::Meta::TypeConstraint::Union
1213 - moved this from Moose::Meta::TypeConstraint
1215 0.14 Mon. Oct. 9, 2006
1217 * Moose::Meta::Attribute
1218 - fixed lazy attributes which were not getting
1219 checked with the type constraint (thanks ashley)
1220 - added tests for this
1221 - removed the over-enthusiastic DWIMery of the
1222 automatic ArrayRef and HashRef defaults, it
1223 broke predicates in an ugly way.
1224 - removed tests for this
1226 0.13 Sat. Sept. 30, 2006
1228 This version of Moose *must* have Class::MOP 0.35 in order
1229 to work correctly. A number of small internal tweaks have
1230 been made in order to be compatible with that release.
1233 - Removed the use of UNIVERSAL::require to be a better
1234 symbol table citizen and remove a dependency
1235 (thanks Adam Kennedy)
1237 **~~ removed experimental & undocumented feature ~~**
1238 - commented out the 'method' and 'self' keywords, see the
1239 comments for more info.
1242 - added a FAQ and WTF files to document frequently
1243 asked questions and common problems
1245 * Moose::Util::TypeConstraints
1246 - added GlobRef and FileHandle type constraint
1247 - added tests for this
1249 * Moose::Meta::Attribute
1250 - if your attribute 'isa' ArrayRef of HashRef, and you have
1251 not explicitly set a default, then make the default DWIM.
1252 This will also work for subtypes of ArrayRef and HashRef
1254 - you can now auto-deref subtypes of ArrayRef or HashRef too.
1255 - new test added for this (thanks to ashley)
1258 - added basic support for runtime role composition
1259 but this is still *highly experimental*, so feedback
1260 is much appreciated :)
1261 - added tests for this
1263 * Moose::Meta::TypeConstraint
1264 - the type constraint now handles the coercion process
1265 through delegation, this is to support the coercion
1268 * Moose::Meta::TypeConstraint::Union
1269 - it is now possible for coercions to be performed
1271 - added tests for this (thanks to konobi)
1273 * Moose::Meta::TypeCoercion
1274 - properly capturing error when type constraint
1278 - Scalar::Util 1.18 is bad on Win32, so temporarily
1279 only require version 1.17 for Win32 and cygwin.
1280 (thanks Adam Kennedy)
1282 0.12 Sat. Sept. 1, 2006
1284 - Recipe5 (subtypes & coercion) has been written
1287 - fixed "bad meta" error message to be more descriptive
1288 - fixed &unimport to not remove the &inner and &super
1289 keywords because we need to localize them.
1290 - fixed number of spelling/grammer issues, thanks Theory :)
1292 **~~ experimental & undocumented feature ~~**
1293 - added the method and self keywords, they are basically
1294 just sugar, and they may not stay around.
1297 - added &dump method to easily Data::Dumper
1300 * Moose::Meta::TypeConstraint
1301 - added the &is_a_type_of method to check both the current
1302 and the subtype of a method (similar to &isa with classes)
1305 - this is now a subclass of Class::MOP::Module, and no longer
1306 creates the _role_meta ugliness of before.
1307 - fixed tests to reflect this change
1309 0.11 Wed. July 12, 2006
1311 - added an &unimport method to remove all the keywords
1312 that Moose will import, simply add 'no Moose' to the
1313 bottom of your class file.
1316 - fixed some test failures caused by a forgotten test
1319 0.10 Thurs. July 6, 2006
1321 - improved error message when loading modules so
1322 it is less confusing when you load a role.
1323 - added &calculate_all_roles method to
1324 Moose::Meta::Class and Moose::Meta::Role
1327 This module has been tested against Class::MOP 0.30
1328 but it does not yet utilize the optimizations
1329 it makes available. Stay tuned for that ;)
1331 0.09_03 Fri. June 23, 2006
1332 ++ DEVELOPER RELEASE ++
1334 - 'use strict' and 'use warnings' are no longer
1335 needed in Moose classes, Moose itself will
1336 turn them on for you.
1337 - added tests for this
1338 - moved code from exported subs to private methods
1339 in Moose::Meta::Class
1342 - as with Moose, strict and warnings are
1343 automatically turned on for you.
1344 - added tests for this
1347 - now handles an edge case for override errors
1348 - added tests for this
1349 - added some more edge case tests
1351 0.09_02 Tues. May 16, 2006
1352 ++ DEVELOPER RELEASE ++
1354 - added prototypes to the exported subs
1358 - added prototypes to the exported subs
1361 * Moose::Util::TypeConstraints
1362 - cleaned up prototypes for the subs
1365 0.09_01 Fri. May 12, 2006
1366 ++ DEVELOPER RELEASE ++
1367 - This release works in combination with
1368 Class::MOP 0.29_01, it is a developer
1369 release because it uses the a new
1370 instance sub-protocol and a fairly
1371 complete Role implementation. It has
1372 not yet been optimized, so it slower
1373 the the previous CPAN version. This
1374 release also lacks good updated docs,
1375 the official release will have updated docs.
1378 - refactored the keyword exports
1379 - 'with' now checks Role validaity and
1380 accepts more than one Role at a time
1381 - 'extends' makes metaclass adjustments as
1382 needed to ensure metaclass compatability
1385 - refactored the keyword exports
1386 - 'with' now checks Role validaity and
1387 accepts more than one Role at a time
1389 * Moose::Util::TypeConstraints
1390 - added the 'enum' keyword for simple
1391 string enumerations which can be used as
1393 - see example of usage in t/202_example.t
1396 - more careful checking of params to new()
1399 - much work done on the role composition
1400 - many new tests for conflict detection
1401 and composition edge cases
1402 - not enough documentation, I suggest
1403 looking at the tests
1405 * Moose::Meta::Instance
1406 - added new Instance metaclass to support
1407 the new Class::MOP instance protocol
1409 * Moose::Meta::Class
1410 - some small changes to support the new
1412 - some small additions to support Roles
1414 * Moose::Meta::Attribute
1415 - some improvements to the accessor generation code
1417 - some small changes to support the new
1419 - (still somewhat) experimental delegation support
1420 with the 'handles' option
1421 - added several tests for this
1422 - no docs for this yet
1424 0.05 Thurs. April 27, 2006
1426 - keywords are now exported with Sub::Exporter
1427 thanks to chansen for this commit
1428 - has keyword now takes a 'metaclass' option
1429 to support custom attribute meta-classes
1430 on a per-attribute basis
1431 - added tests for this
1432 - the 'has' keyword not accepts inherited slot
1433 specifications (has '+foo'). This is still an
1434 experimental feature and probably not finished
1435 see t/038_attribute_inherited_slot_specs.t for
1436 more details, or ask about it on #moose
1437 - added tests for this
1440 - keywords are now exported with Sub::Exporter
1442 * Moose::Utils::TypeConstraints
1443 - reorganized the type constraint hierarchy, thanks
1444 to nothingmuch and chansen for his help and advice
1446 - added some tests for this
1447 - keywords are now exported with Sub::Exporter
1448 thanks to chansen for this commit
1450 * Moose::Meta::Class
1451 - due to changes in Class::MOP, we had to change
1452 construct_instance (for the better)
1454 * Moose::Meta::Attribute
1455 - due to changes in Class::MOP, we had to add the
1456 initialize_instance_slot method (it's a good thing)
1458 * Moose::Meta::TypeConstraint
1459 - added type constraint unions
1460 - added tests for this
1461 - added the is_subtype_of predicate method
1462 - added tests for this
1464 0.04 Sun. April 16th, 2006
1466 - Roles can now consume other roles
1467 - added tests for this
1468 - Roles can specify required methods now with
1469 the requires() keyword
1470 - added tests for this
1473 - ripped out much of it's guts ,.. much cleaner now
1474 - added required methods and correct handling of
1475 them in apply() for both classes and roles
1476 - added tests for this
1477 - no longer adds a does() method to consuming classes
1478 it relys on the one in Moose::Object
1479 - added roles attribute and some methods to support
1480 roles consuming roles
1482 * Moose::Meta::Attribute
1483 - added support for triggers on attributes
1484 - added tests for this
1485 - added support for does option on an attribute
1486 - added tests for this
1488 * Moose::Meta::Class
1489 - added support for attribute triggers in the
1491 - added tests for this
1494 - Moose no longer creates a subtype for your class
1495 if a subtype of the same name already exists, this
1496 should DWIM in 99.9999% of all cases
1498 * Moose::Util::TypeConstraints
1499 - fixed bug where incorrect subtype conflicts were
1501 - added test for this
1504 - this class can now be extended with 'use base' if
1505 you need it, it properly loads the metaclass class now
1506 - added test for this
1508 0.03_02 Wed. April 12, 2006
1510 - you must now explictly use Moose::Util::TypeConstraints
1511 it no longer gets exported for you automatically
1514 - new() now accepts hash-refs as well as key/value lists
1515 - added does() method to check for Roles
1516 - added tests for this
1518 * Moose::Meta::Class
1519 - added roles attribute along with the add_role() and
1521 - added tests for this
1524 - now adds a does() method to consuming classes
1525 which tests the class's hierarchy for roles
1526 - added tests for this
1528 0.03_01 Mon. April 10, 2006
1530 - added new Role recipe (no content yet, only code)
1533 - added 'with' keyword for Role support
1534 - added test and docs for this
1535 - fixed subtype quoting bug
1536 - added test for this
1540 - added test and docs
1542 * Moose::Util::TypeConstraints
1543 - added the message keyword to add custom
1544 error messages to type constraints
1547 - the meta role to support Moose::Role
1548 - added tests and docs
1550 * Moose::Meta::Class
1551 - moved a number of things from Moose.pm
1552 to here, they should have been here
1555 * Moose::Meta::Attribute
1556 - moved the attribute option macros here
1557 instead of putting them in Moose.pm
1559 * Moose::Meta::TypeConstraint
1560 - added the message attributes and the
1562 - added tests and docs for this
1564 0.03 Thurs. March 30, 2006
1566 - added the Moose::Cookbook with 5 recipes,
1567 describing all the stuff Moose can do.
1570 - fixed an issue with &extends super class loading
1571 it now captures errors and deals with inline
1572 packages correctly (bug found by mst, solution
1574 - added super/override & inner/augment features
1575 - added tests and docs for these
1578 - BUILDALL now takes a reference of the %params
1579 that are passed to &new, and passes that to
1582 * Moose::Util::TypeConstraints
1583 - Type constraints now survive runtime reloading
1584 - added test for this
1586 * Moose::Meta::Class
1587 - fixed the way attribute defaults are handled
1588 during instance construction (bug found by chansen)
1590 * Moose::Meta::Attribute
1591 - read-only attributes now actually enforce their
1592 read-only-ness (this corrected in Class::MOP as
1595 0.02 Tues. March 21, 2006
1597 - many more tests, fixing some bugs and
1599 - &extends now loads the base module with
1601 - added UNIVERSAL::require to the
1604 - each new Moose class will also create
1605 and register a subtype of Object which
1606 correspond to the new Moose class.
1607 - the 'isa' option in &has now only
1608 accepts strings, and will DWIM in
1611 * Moose::Util::TypeConstraints
1612 - added type coercion features
1613 - added tests for this
1614 - added support for this in attributes
1615 and instance construction
1617 - type construction no longer creates a
1618 function, it registers the type instead.
1619 - added several functions to get the
1623 - BUILDALL and DEMOLISHALL were broken
1624 because of a mis-named hash key, Whoops :)
1626 * Moose::Meta::Attribute
1627 - adding support for coercion in the
1628 autogenerated accessors
1630 * Moose::Meta::Class
1631 - adding support for coercion in the
1632 instance construction
1634 * Moose::Meta::TypeConstraint
1635 * Moose::Meta::TypeCoercion
1636 - type constraints and coercions are now
1637 full fledges meta-objects
1639 0.01 Wed. March 15, 2006
1640 - Moooooooooooooooooose!!!