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::Extending::Recipe1
15 * Moose::Cookbook::Extending::Recipe2
16 - Rewrote extending and embedding moose documentation and
17 recipes to use Moose::Exporter (Dave Rolsky)
21 - These two modules now warn when you load them from the main
22 package "main" package, because we will not export sugar to
23 main. Previously it just did nothing. (Dave Rolsky)
25 0.55 Sun August 3, 2008
26 * Moose::Meta::Attribute
27 - breaking down the way 'handles' methods are
28 created so that the process can be more easily
29 overridden by subclasses (stevan)
31 * Moose::Meta::TypeConstraint
32 - fixing what is passed into a ->message with
33 the type constraints (RT #37569)
34 - added tests for this (Charles Alderman)
36 * Moose::Util::TypeConstraints
37 - fix coerce to accept anon types like subtype can (mst)
40 - reorganized the recipes into sections - Basics, Roles, Meta,
41 Extending - and wrote abstracts for each section (Dave Rolsky)
43 * Moose::Cookbook::Basics::Recipe10
44 - A new recipe that demonstrates operator overloading
45 in combination with Moose. (bluefeet)
47 * Moose::Cookbook::Meta::Recipe1
48 - an introduction to what meta is and why you'd want to make
49 your own metaclass extensions (Dave Rolsky)
51 * Moose::Cookbook::Meta::Recipe4
52 - a very simple metaclass example (Dave Rolsky)
54 * Moose::Cookbook::Extending::Recipe1
55 - how to write a Moose-alike module to use your own object base
58 * Moose::Cookbook::Extending::Recipe2
59 - how to write modules with an API just like C<Moose.pm> (Dave
63 - Tons of fixes, both syntactical and grammatical (Dave
66 0.54 Thurs. July 3, 2008
67 ... this is not my day today ...
69 * Moose::Meta::Attribute
70 - fixed legal_options_for_inheritance such that
71 clone_and_inherit options still works for
72 Class::MOP::Attribute objects and therefore
73 does not break MooseX::AttributeHelpers
76 0.53 Thurs. July 3, 2008
77 * Whoops, I guess I should run 'make manifest' before
78 actually releasing the module. No actual changes
79 in this release, except the fact that it includes
80 the changes that I didn't include in the last
83 0.52 Thurs. July 3, 2008
85 - added "FEATURE REQUESTS" section to the Moose docs
86 to properly direct people (stevan) (RT #34333)
87 - making 'extends' croak if it is passed a Role since
88 this is not ever something you want to do
89 (fixed by stevan, found by obra)
90 - added tests for this (stevan)
93 - adding support for DOES (as in UNIVERSAL::DOES)
97 * Moose::Meta::Attribute
98 - added legal_options_for_inheritance (wreis)
99 - added tests for this (wreis)
101 * Moose::Cookbook::Snacks::*
102 - removed some of the unfinished snacks that should
103 not have been released yet. Added some more examples
104 to the 'Keywords' snack. (stevan)
106 * Moose::Cookbook::Style
107 - added general Moose "style guide" of sorts to the
108 cookbook (nothingmuch) (RT #34335)
111 - added more BUILDARGS tests (stevan)
113 0.51 Thurs. Jun 26, 2008
115 - add unimport so "no Moose::Role" actually does
118 * Moose::Meta::Role::Application::ToRole
119 - when RoleA did RoleB, and RoleA aliased a method from RoleB in
120 order to provide its own implementation, that method still got
121 added to the list of required methods for consumers of
122 RoleB. Now an aliased method is only added to the list of
123 required methods if the role doing the aliasing does not
124 provide its own implementation. See Recipe 11 for an example
125 of all this. (Dave Rolsky)
126 - added tests for this
128 * Moose::Meta::Method::Constructor
129 - when a single argument that wasn't a hashref was provided to
130 an immutabilized constructor, the error message was very
131 unhelpful, as opposed to the non-immutable error. Reported by
133 - added test for this (Dave Rolsky)
135 * Moose::Meta::Attribute
136 - added support for meta_attr->does("ShortAlias") (sartak)
137 - added tests for this (sartak)
138 - moved the bulk of the `handles` handling to the new
139 install_delegation method (Stevan)
142 - Added BUILDARGS, a new step in new()
144 * Moose::Meta::Role::Application::RoleSummation
145 - fix typos no one ever sees (sartak)
147 * Moose::Util::TypeConstraints
148 * Moose::Meta::TypeConstraint
149 * Moose::Meta::TypeCoercion
150 - Attempt to work around the ??{ } vs. threads issue
152 - Some null_constraint optimizations
154 0.50 Thurs. Jun 11, 2008
155 - Fixed a version number issue by bumping all modules
158 0.49 Thurs. Jun 11, 2008
159 !! This version now approx. 20-25% !!
160 !! faster with new Class::MOP 0.59 !!
162 * Moose::Meta::Attribute
163 - fixed how the is => (ro|rw) works with
164 custom defined reader, writer and accessor
166 - added docs for this (TODO).
167 - added tests for this (Thanks to Penfold)
168 - added the custom attribute alias for regular
169 Moose attributes which is "Moose"
170 - fix builder and default both being used
175 Moose::Meta::Attribute
177 Moose::Meta::Role::Composite
178 Moose::Util::TypeConstraints
179 - switched usage of reftype to ref because
183 - changing add_package_symbol to use the new
187 - fixed how DEMOLISHALL is called so that it
188 can be overrided in subclasses (thanks to Sartak)
189 - added test for this (thanks to Sartak)
191 * Moose::Util::TypeConstraints
192 - move the ClassName type check code to
193 Class::MOP::is_class_loaded (thanks to Sartak)
195 * Moose::Cookbook::Recipe11
196 - add tests for this (thanks to tokuhirom)
198 0.48 Thurs. May 29, 2008
199 (early morning release engineering)--
201 - fixing the version in Moose::Meta::Method::Destructor
202 which was causing the indexer to choke
204 0.47 Thurs. May 29, 2008
205 (late night release engineering)--
207 - fixing the version is META.yml, no functional
208 changes in this release
210 0.46 Wed. May 28, 2008
211 !! This version now approx. 20-25% !!
212 !! faster with new Class::MOP 0.57 !!
215 - some optimizations of the &initialize method
216 since it is called so often by &meta
220 - now use the get_all_package_symbols from the
221 updated Class::MOP, test suite is now 10 seconds
224 * Moose::Meta::Method::Destructor
225 - is_needed can now also be called as a class
226 method for immutablization to check if the
227 destructor object even needs to be created
230 * Moose::Meta::Method::Destructor
231 Moose::Meta::Method::Constructor
232 - added more descriptive error message to help
233 keep people from wasting time tracking an error
234 that is easily fixed by upgrading.
236 0.45 Saturday, May 24, 2008
238 - Because of work in Class::MOP 0.56, all
239 XS based functionality is now optional
240 and a Pure Perl version is supplied
241 - the CLASS_MOP_NO_XS environment variable
242 can now be used to force non-XS versions
244 - several of the packages have been tweaked
245 to take care of this, mostly we added
246 support for the package_name and name
247 variables in all the Method metaclasses
248 - before/around/after method modifiers now
249 support regexp matching of names
250 (thanks to Takatoshi Kitano)
251 - tests added for this
252 - NOTE: this only works for classes, it
253 is currently not supported in roles,
254 but, ... patches welcome
255 - All usage of Carp::confess have been replaced
256 by Carp::croak in the "keyword" functions since
257 the stack trace is usually not helpful
260 - All usage of Carp::confess have been replaced
261 by Carp::croak in the "keyword" functions since
262 the stack trace is usually not helpful
263 - The 'has' keyword for roles now accepts the
264 same array ref form that Moose.pm does
265 (has [qw/foo bar/] => (is => 'rw', ...))
266 - added test for this
268 * Moose::Meta::Attribute
269 - trigger on a ro-attribute is no longer an
270 error, as it's useful to trigger off of the
274 - added same 'add_package_symbol' fix as in
278 - does_role now handles non-Moose classes
280 - added tests for this
281 - added the 'add_method_modifier' function
282 (thanks to Takatoshi Kitano)
284 * Moose::Util::TypeConstraints
285 - subtypes of parameterizable types now are
286 themselves parameterizable types
288 * Moose::Meta::Method::Constructor
289 - fixed bug where trigger was not being
290 called by the inlined immutable
292 - added test for this (thanks to Caelum)
294 * Moose::Meta::Role::Application::ToInstance
295 - now uses the metaclass of the instance
296 (if possible) to create the anon-class
297 (thanks Jonathan Rockway)
299 * Moose::Cookbook::Recipe22
300 - added the meta-attribute trait recipe
304 - fixed hash-ordering test bug that was
305 causing occasional cpantester failures
306 - renamed the t/000_recipe/*.t tests to be
307 more descriptive (thanks to Sartak)
309 0.44 Sat. May 10, 2008
311 - made make_immutable warning cluck to
312 show where the error is (thanks mst)
315 - BUILDALL and DEMOLISHALL now call
316 ->body when looping through the
317 methods, to avoid the overloaded
319 - fixed issue where DEMOLISHALL was
320 eating the $@ values, and so not
321 working correctly, it still kind of
322 eats them, but so does vanilla perl
323 - added tests for this
325 * Moose::Cookbook::Recipe7
326 - added new recipe for immutable
327 functionality (thanks Dave Rolsky)
329 * Moose::Cookbook::Recipe9
330 - added new recipe for builder and
331 lazy_build (thanks Dave Rolsky)
333 * Moose::Cookbook::Recipe11
334 - added new recipe for method aliasing
335 and exclusion with Roles (thanks Dave Rolsky)
338 - fixed Win32 test failure (thanks spicyjack)
340 ~ removed Build.PL and Module::Build compat
341 since Module::Install has done that.
343 0.43 Wed. April, 30, 2008
345 drink more coffee before
346 doing release engineering
348 - whoops, forgot to do the smolder tests,
349 and we broke some of the custom meta-attr
350 modules. This fixes that.
352 0.42 Mon. April 28, 2008
353 - some bad tests slipped by, nothing else
354 changed in this release (cpantesters++)
356 - upped the Class::MOP dependency to 0.55
357 since we have tests which need the C3
360 0.41 Mon. April 28, 2008
361 ~~ numerous documentation updates ~~
363 - Changed all usage of die to Carp::croak for better
364 error reporting (initial patch by Tod Hagan)
367 - the make_immutable keyword is now deprecated, don't
368 use it in any new code and please fix your old code
369 as well. There will be 2 releases, and then it will
375 - refactored the way inner and super work to avoid
376 any method/@ISA cache penalty (nothingmuch)
379 - fixing &new_object to make sure trigger gets the
380 coerced value (spotted by Charles Alderman on the
382 - added test for this
384 * Moose::Meta::Method::Constructor
385 - immutable classes which had non-lazy attributes were calling
386 the default generating sub twice in the constructor. (bug
387 found by Jesse Luehrs, fixed by Dave Rolsky)
388 - added tests for this (Dave Rolsky)
389 - fix typo in initialize_body method (nothingmuch)
391 * Moose::Meta::Method::Destructor
392 - fix typo in initialize_body method (nothingmuch)
394 * Moose::Meta::Method::Overriden
395 Moose::Meta::Method::Augmented
396 - moved the logic for these into their own
397 classes (nothingmuch)
399 * Moose::Meta::Attribute
400 - inherited attributes may now be extended without
401 restriction on the type ('isa', 'does') (Sartak)
402 - added tests for this (Sartak)
403 - when an attribute property is malformed (such as lazy without
404 a default), give the name of the attribute in the error
406 - added the &applied_traits and &has_applied_traits methods
407 to allow introspection of traits
408 - added tests for this
409 - moved 'trait' and 'metaclass' argument handling to here from
411 - clone_and_inherit_options now handles 'trait' and 'metaclass' (has
412 '+foo' syntax) (nothingmuch)
413 - added tests for this (t0m)
416 - localize $@ inside DEMOLISHALL to avoid it
417 eating $@ (found by Ernesto)
418 - added test for this (thanks to Ernesto)
420 * Moose::Util::TypeConstraints
421 - &find_type_constraint now DWIMs when given an
422 type constraint object or name (nothingmuch)
423 - &find_or_create_type_constraint superseded with a number of more
425 - find_or_create_{isa,does}_type_constraint
426 - find_or_parse_type_constraint
428 * Moose::Meta::TypeConstraint
429 Moose::Meta::TypeConstraint::Class
430 Moose::Meta::TypeConstraint::Role
431 Moose::Meta::TypeConstraint::Enum
432 Moose::Meta::TypeConstraint::Union
433 Moose::Meta::TypeConstraint::Parameterized
434 - added the &equals method for comparing two type
435 constraints (nothingmuch)
436 - added tests for this (nothingmuch)
438 * Moose::Meta::TypeConstraint
439 - add the &parents method, which is just an alias to &parent.
440 Useful for polymorphism with TC::{Class,Role,Union} (nothingmuch)
442 * Moose::Meta::TypeConstraint::Class
443 - added the class attribute for introspection purposes
445 - added tests for this
447 * Moose::Meta::TypeConstraint::Enum
448 Moose::Meta::TypeConstraint::Role
449 - broke these out into their own classes (nothingmuch)
451 * Moose::Cookbook::Recipe*
452 - fixed references to test file locations in the POD
453 and updated up some text for new Moose features
457 - Added &resolve_metaclass_alias, a helper function for finding an actual
458 class for a short name (e.g. in the traits list)
460 0.40 Fri. March 14, 2008
461 - I hate Pod::Coverage
463 0.39 Fri. March 14, 2008
465 - documenting the use of '+name' with attributes
466 that come from recently composed roles. It makes
467 sense, people are using it, and so why not just
468 officially support it.
469 - fixing the 'extends' keyword so that it will not
470 trigger Ovid's bug (http://use.perl.org/~Ovid/journal/35763)
473 - added the perl -Moose=+Class::Name feature to allow
474 monkeypatching of classes in one liners
477 - fixing the 'apply_all_roles' keyword so that it will not
478 trigger Ovid's bug (http://use.perl.org/~Ovid/journal/35763)
481 - added ->create method which now supports roles (thanks to jrockway)
482 - added tests for this
483 - added ->create_anon_class which now supports roles and caching of
484 the results (thanks to jrockway)
485 - added tests for this
486 - made ->does_role a little more forgiving when it is
487 checking a Class::MOP era metaclasses.
489 * Moose::Meta::Role::Application::ToInstance
490 - it is now possible to pass extra params to be used when
491 a role is applied to an the instance (rebless_params)
492 - added tests for this
494 * Moose::Util::TypeConstraints
495 - class_type now accepts an optional second argument for a
496 custom message. POD anotated accordingly (groditi)
497 - added tests for this
498 - it is now possible to make anon-enums by passing 'enum' an
499 ARRAY ref instead of the $name => @values. Everything else
501 - added tests for this
504 - making test for using '+name' on attributes consumed
505 from a role, it works and makes sense too.
507 * Moose::Meta::Attribute
508 - fix handles so that it doesn't return nothing
509 when the method cannot be found, not sure why
510 it ever did this originally, this means we now
511 have slightly better support for AUTOLOADed
513 - added more delegation tests
514 - adding ->does method to this so as to better
515 support traits and their introspection.
516 - added tests for this
519 - localizing the Data::Dumper configurations so
520 that it does not pollute others (RT #33509)
521 - made ->does a little more forgiving when it is
522 passed Class::MOP era metaclasses.
524 0.38 Fri. Feb. 15, 2008
525 * Moose::Meta::Attribute
526 - fixed initializer to correctly do
527 type checking and coercion in the
529 - added tests for this
532 - fixed some finicky tests (thanks to konobi)
534 0.37 Thurs. Feb. 14, 2008
536 - fixed some details in Moose::init_meta
537 and its superclass handling (thanks thepler)
538 - added tests for this (thanks thepler)
539 - 'has' now dies if you don't pass in name
541 - added the 'make_immutable' keyword as a shortcut
545 Moose::Meta::Method::Constructor
546 Moose::Meta::Attribute
547 - making (init_arg => undef) work here too
548 (thanks to nothingmuch)
550 * Moose::Meta::Attribute
551 Moose::Meta::Method::Constructor
552 Moose::Meta::Method::Accessor
553 - make lazy attributes respect attr initializers (rjbs)
554 - added tests for this
556 * Moose::Util::TypeConstraints
557 Moose::Util::TypeConstraints::OptimizedConstraints
558 Moose::Meta::TypeConstraints
559 Moose::Meta::Attribute
560 Moose::Meta::Method::Constructor
561 Moose::Meta::Method::Accessor
562 - making type errors use the
563 assigned message (thanks to Sartak)
564 - added tests for this
566 * Moose::Meta::Method::Destructor
567 - making sure DESTROY gets inlined properly
568 with successive DEMOLISH calls (thanks to manito)
570 * Moose::Meta::Attribute
571 Moose::Meta::Method::Accessor
572 - fixed handling of undef with type constraints
574 - added tests for this
577 - added &get_all_init_args and &get_all_attribute_values
578 (thanks to Sartak and nothingmuch)
580 0.36 Sat. Jan. 26, 2008
582 Moose::Meta::Attribute
583 - role type tests now support when roles are
584 applied to non-Moose classes (found by ash)
585 - added tests for this (thanks to ash)
586 - couple extra tests to boost code coverage
588 * Moose::Meta::Method::Constructor
589 - improved fix for handling Class::MOP attributes
590 - added test for this
593 - handled the add_attribute($attribute_meta_object)
595 - added test for this
597 0.35 Tues. Jan. 22, 2008
598 * Moose::Meta::Method::Constructor
599 - fix to make sure even Class::MOP attributes
600 are handled correctly (Thanks to Dave Rolsky)
601 - added test for this (also Dave Rolsky)
604 - improved error message on _apply_all_roles,
605 you should now use Moose::Util::apply_all_roles
606 and you shouldnt have been using a _ prefixed
607 method in the first place ;)
609 0.34 Mon. Jan. 21, 2008
610 ~~~ more misc. doc. fixes ~~~
611 ~~ updated copyright dates ~~
613 Moose is now a postmodern object system :)
614 - (see the POD for details)
616 * <<Role System Refactoring>>
617 - this release contains a major reworking and
618 cleanup of the role system
619 - 100% backwards compat.
620 - Role application now restructured into seperate
621 classes based on type of applicants
622 - Role summation (combining of more than one role)
623 is much cleaner and anon-classes are no longer
625 - new Composite role metaclass
626 - runtime application of roles to instances
627 is now more efficient and re-uses generated
628 classes when applicable
630 * <<New Role composition features>>
631 - methods can now be excluded from a given role
633 - methods can now be aliased to another name (and
634 still retain the original as well)
636 * Moose::Util::TypeConstraints::OptimizedConstraints
637 - added this module (see above)
640 - fixed the &_process_attribute method to be called
641 by &add_attribute, so that the API is now correct
643 * Moose::Meta::Method::Accessor
644 - fixed bug when passing a list of values to
645 an accessor would get (incorrectly) ignored.
646 Thanks to Sartak for finding this ;)
647 - added tests for this (Sartak again)
649 * Moose::Meta::Method::Accessor
650 Moose::Meta::Method::Constructor
651 Moose::Meta::Attribute
652 Moose::Meta::TypeConstraint
653 Moose::Meta::TypeCoercion
654 - lots of cleanup of such things as:
656 - type constraint handling
657 - error handling/messages
658 (thanks to nothingmuch)
660 * Moose::Meta::TypeConstraint::Parameterizable
661 - added this module to support the refactor
662 in Moose::Meta::TypeConstraint::Parameterized
664 * Moose::Meta::TypeConstraint::Parameterized
665 - refactored how these types are handled so they
666 are more generic and not confined to ArrayRef
670 - shortened some file names for better VMS support (RT #32381)
672 0.33 Fri. Dec. 14, 2007
673 !! Moose now loads 2 x faster !!
674 !! with new Class::MOP 0.49 !!
676 ++ new oose.pm module to make command line
677 Moose-ness easier (see POD docs for more)
681 - several tweaks to take advantage of the
682 new method map caching in Class::MOP
684 * Moose::Meta::TypeConstraint::Parameterized
685 - allow subtypes of ArrayRef and HashRef to
686 be used as a container (sartak)
687 - added tests for this
688 - basic support for coercion to ArrayRef and
689 HashRef for containers (sartak)
690 - added tests for this
692 * Moose::Meta::TypeCoercion
693 - coercions will now create subtypes as needed
694 so you can now add coercions to parameterized
695 types without having to explictly define them
696 - added tests for this
698 * Moose::Meta::Method::Accessor
699 - allow subclasses to decide whether we need
700 to copy the value into a new variable (sartak)
702 0.32 Tues. Dec. 4, 2007
703 * Moose::Util::TypeConstraints
704 - fixing how subtype aliases of unions work
705 they should inherit the parent's coercion
706 - added tests for this
707 - you can now define multiple coercions on
708 a single type at different times instead of
709 having to do it all in one place
710 - added tests for this
712 * Moose::Meta::TypeConstraint
713 - there is now a default constraint of sub { 1 }
714 instead of Moose::Util::TypeConstraints setting
717 * Moose::Meta::TypeCoercion
718 * Moose::Meta::TypeCoercion::Union
719 - added the &has_coercion_for_type and
720 &add_type_coercions methods to support the
721 new features above (although you cannot add
722 more type coercions for Union types)
724 0.31 Mon. Nov. 26, 2007
725 * Moose::Meta::Attribute
726 - made the +attr syntax handle extending types with
727 parameters. So "has '+foo' => (isa => 'ArrayRef[Int]')"
728 now works if the original foo is an ArrayRef.
729 - added tests for this.
730 - delegation now works even if the attribute does not
731 have a reader method using the get_read_method_ref
732 method from Class::MOP::Attribute.
733 - added tests for this
734 - added docs for this
736 * Moose::Util::TypeConstraints
737 - passing no "additional attribute info" to
738 &find_or_create_type_constraint will no longer
739 attempt to create an __ANON__ type for you,
740 instead it will just return undef.
741 - added docs for this
743 0.30 Fri. Nov. 23, 2007
744 * Moose::Meta::Method::Constructor
745 -builder related bug in inlined constructor. (groditi)
747 * Moose::Meta::Method::Accessor
748 - genereate unnecessary calls to predicates and refactor
749 code generation for runtime speed (groditi)
751 * Moose::Util::TypeConstraints
752 - fix ClassName constraint to introspect symbol table (mst)
753 - added more tests for this (mst)
754 - fixed it so that subtype 'Foo' => as 'HashRef[Int]' ...
756 - added tests for this
759 - adding the link to Recipie 11 (written by Sartak)
760 - adding test for SYNOPSIS code
763 - New tests for builder bug. Upon instantiation, if an
764 attribute had a builder, no value and was not lazy the
765 builder default was not getting run, oops. (groditi)
767 0.29 Tues. Nov. 13, 2007
768 * Moose::Meta::Attribute
769 - Fix error message on missing builder method (groditi)
771 * Moose::Meta::Method::Accessor
772 - Fix error message on missing builder method (groditi)
775 - Add test to check for the correct error message when
776 builder method is missing (groditi)
778 0.28 Tues. Nov. 13, 2007
779 - 0.27 packaged incorrectly (groditi)
781 0.27 Tues. Nov. 13, 2007
782 * Moose::Meta::Attribute
783 - Added support for the new builder option (groditi)
784 - Added support for lazy_build option (groditi)
785 - Changed slot initialization for predicate changes (groditi)
787 * Moose::Meta::Method::Accessor
788 - Added support for lazy_build option (groditi)
789 - Fix inline methods to work with corrected predicate
792 * Moose::Meta::Method::Constructor
793 - Added support for lazy_build option (groditi)
796 - tests for builder and lazy_build (groditi)
798 * fixing some misc. bits in the docs that
799 got mentioned on CPAN Forum & perlmonks
802 - fixed how required methods are handled
803 when they encounter overriden or modified
804 methods from a class (thanks to confound).
805 - added tests for this
807 * Moose::Util::TypeConstraint
808 - fixed the type notation parser so that
809 the | always creates a union and so is
810 no longer a valid type char (thanks to
811 konobi, mugwump and #moose for working
813 - added more tests for this
815 0.26 Thurs. Sept. 27, 2007
818 * Parameterized Types
819 We now support parameterized collection types, such as:
820 ArrayRef[Int] # array or integers
821 HashRef[Object] # a hash with object values
822 They can also be nested:
823 ArrayRef[HashRef[RegExpr]] # an array of hashes with regexpr values
824 And work with the type unions as well:
825 ArrayRef[Int | Str] # array of integers of strings
827 * Better Framework Extendability
828 Moose.pm is now "extendable" such that it is now much
829 easier to extend the framework and add your own keywords
830 and customizations. See the "EXTENDING AND EMBEDDING MOOSE"
831 section of the Moose.pm docs.
834 In an effort to begin documenting some of the various
835 details of Moose as well as some common idioms, we have
836 created Moose::Cookbook::Snacks as a place to find
837 small (easily digestable) nuggets of Moose code.
840 ~ Several doc updates/cleanup thanks to castaway ~
842 - converted build system to use Module::Install instead of
843 Module::Build (thanks to jrockway)
846 - added all the meta classes to the immutable list and
847 set it to inline the accessors
848 - fix import to allow Sub::Exporter like { into => }
849 and { into_level => } (perigrin)
850 - exposed and documented init_meta() to allow better
851 embedding and extending of Moose (perigrin)
854 - complete re-organization of the test suite
855 - added some new tests as well
856 - finally re-enabled the Moose::POOP test since
857 the new version of DBM::Deep now works again
861 - fixed very odd and very nasty recursion bug with
863 - added tests for this (eilara)
865 * Moose::Meta::Attribute
866 Moose::Meta::Method::Constructor
867 Moose::Meta::Method::Accessor
868 - fixed issue with overload::Overloaded getting called
869 on non-blessed items. (RT #29269)
870 - added tests for this
872 * Moose::Meta::Method::Accessor
873 - fixed issue with generated accessor code making
874 assumptions about hash based classes (thanks to dexter)
876 * Moose::Coookbook::Snacks
877 - these are bits of documentation, not quite as big as
878 Recipes but which have no clear place in the module docs.
879 So they are Snacks! (horray for castaway++)
881 * Moose::Cookbook::Recipe4
882 - updated it to use the new ArrayRef[MyType] construct
883 - updated the accompanying test as well
885 +++ Major Refactor of the Type Constraint system +++
886 +++ with new features added as well +++
888 * Moose::Util::TypeConstraint
889 - no longer uses package variable to keep track of
890 the type constraints, now uses the an instance of
891 Moose::Meta::TypeConstraint::Registry to do it
892 - added more sophisticated type notation parsing
894 - added tests for this
896 * Moose::Meta::TypeConstraint
897 - some minor adjustments to make subclassing easier
898 - added the package_defined_in attribute so that we
899 can track where the type constraints are created
901 * Moose::Meta::TypeConstraint::Union
902 - this is now been refactored to be a subclass of
903 Moose::Meta::TypeConstraint
905 * Moose::Meta::TypeCoercion::Union
906 - this has been added to service the newly refactored
907 Moose::Meta::TypeConstraint::Union and is itself
908 a subclass of Moose::Meta::TypeCoercion
910 * Moose::Meta::TypeConstraint::Parameterized
911 - added this module (taken from MooseX::AttributeHelpers)
912 to help construct nested collection types
913 - added tests for this
915 * Moose::Meta::TypeConstraint::Registry
916 - added this class to keep track of type constraints
918 0.25 Mon. Aug. 13, 2007
920 - Documentation update to reference Moose::Util::TypeConstraints
921 under 'isa' in 'has' for how to define a new type
924 * Moose::Meta::Attribute
925 - required attributes now will no longer accept undef
926 from the constructor, even if there is a default and lazy
927 - added tests for this
928 - default subroutines must return a value which passes the
930 - added tests for this
932 * Moose::Meta::Attribute
933 * Moose::Meta::Method::Constructor
934 * Moose::Meta::Method::Accessor
935 - type-constraint tests now handle overloaded objects correctly
937 - added tests for this (thanks to EvanCarroll)
939 * Moose::Meta::TypeConstraint::Union
940 - added (has_)hand_optimized_constraint to this class so that
941 it behaves as the regular Moose::Meta::TypeConstraint does.
944 - large refactoring of this code
945 - added several more tests
946 - tests for subtle conflict resolition issues
947 added, but not currently running
950 * Moose::Cookbook::Recipe7
951 - added new recipe for augment/inner functionality
953 - added test for this
956 - a formal definition of roles (still in progress)
959 - utilities for easier working with Moose classes
960 - added tests for these
963 - This contains Moose specific test functions
964 - added tests for these
966 0.24 Tues. July 3, 2007
967 ~ Some doc updates/cleanup ~
969 * Moose::Meta::Attribute
970 - added support for roles to be given as parameters
971 to the 'handles' option.
972 - added tests and docs for this
973 - the has '+foo' attribute form now accepts changes to
974 the lazy option, and the addition of a handles option
975 (but not changing the handles option)
976 - added tests and docs for this
979 - required methods are now fetched using find_method_by_name
980 so that required methods can come from superclasses
981 - adjusted tests for this
983 0.23 Mon. June 18, 2007
984 * Moose::Meta::Method::Constructor
985 - fix inlined constructor for hierarchy with multiple BUILD methods (mst)
987 - Modify make_immutable to work with the new Class::MOP immutable
988 mechanism + POD + very basic test (groditi)
989 * Moose::Meta::Attribute
990 - Fix handles to use goto() so that caller() comes out properly on
991 the other side (perigrin)
993 0.22 Thurs. May 31, 2007
994 * Moose::Util::TypeConstraints
995 - fix for prototype undeclared issue when Moose::Util::TypeConstraints
996 loaded before consumers (e.g. Moose::Meta::Attribute) by predeclaring
997 prototypes for functions
998 - added the ClassName type constraint, this checks for strings
999 which will respond true to ->isa(UNIVERSAL).
1000 - added tests and docs for this
1001 - subtyping just in name now works correctly by making the
1002 default for where be { 1 }
1003 - added test for this
1005 * Moose::Meta::Method::Accessor
1006 - coerce and lazy now work together correctly, thanks to
1007 merlyn for finding this bug
1008 - tests added for this
1009 - fix reader presedence bug in Moose::Meta::Attribute + tests
1012 - Foo->new(undef) now gets ignored, it is assumed you meant to pass
1013 a HASH-ref and missed. This produces better error messages then
1014 having it die cause undef is not a HASH.
1015 - added tests for this
1017 0.21 Thursday, May 2nd, 2007
1019 - added SUPER_SLOT and INNER_SLOT class hashes to support unimport
1020 - modified unimport to remove super and inner along with the rest
1021 - altered unimport tests to handle this
1024 - altered super export to populate SUPER_SLOT
1026 * Moose::Meta::Class
1027 - altered augment and override modifier application to use *_SLOT
1028 - modified tests for these to unimport one test class each to test
1031 - fixed issue where custom attribute metaclasses
1032 where not handled correctly in roles
1033 - added tests for this
1035 * Moose::Meta::Class
1036 - fixed issue where extending metaclasses with
1037 roles would blow up. Thanks to Aankhen`` for
1038 finding this insidious error, and it's solution.
1040 ~~ lots of spelling and grammer fixes in the docs,
1041 many many thanks to rlb3 and Aankhen for these :)
1043 0.20 Friday, April 6th, 2007
1044 >> I messed up the SKIP logic in one test
1045 so this release is just to fix that.
1048 - 'has' now also accepts an ARRAY ref
1049 to create multiple attrs (see docs)
1050 (thanks to konobi for this)
1051 - added tests and docs
1053 0.19 Thurs. April 5th, 2007
1054 ~~ More documentation updates ~~
1056 * Moose::Util::TypeConstraints
1057 - 'type' now supports messages as well
1058 thanks to phaylon for finding this
1059 - added tests for this
1060 - added &list_all_type_constraints and
1061 &list_all_builtin_type_constraints
1062 functions to facilitate introspection.
1064 * Moose::Meta::Attribute
1065 - fixed regexp 'handles' declarations
1066 to build the list of delegated methods
1067 correctly (and not override important
1068 things like &new) thanks to ashleyb
1070 - added tests and docs for this
1071 - added the 'documentation' attributes
1072 so that you can actually document your
1073 attributes and inspect them through the
1075 - added tests and docs for this
1077 * Moose::Meta::Class
1078 - when loading custom attribute metaclasses
1079 it will first look in for the class in the
1080 Moose::Meta::Attribute::Custom::$name, and
1081 then default to just loading $name.
1082 - added tests and docs for this
1084 * Moose::Meta::TypeConstraint
1085 - type constraints now stringify to their names.
1086 - added test for this
1089 - added tests to assure we work with Module::Refresh
1090 - added stricter test skip logic in the Moose POOP
1091 test, ask Rob Kinyon why.
1092 - *cough* DBM::Deep 1.0 backwards compatability sucks *cough* ;)
1094 0.18 Sat. March 10, 2007
1095 ~~ Many, many documentation updates ~~
1098 - We now use Class::MOP::load_class to
1100 - added tests to show types and subtypes
1101 working with Declare::Constraints::Simple
1102 and Test::Deep as constraint engines.
1105 !! You must have Class::MOP 0.37_001 !!
1106 !! for this developer release to work !!
1108 This release was primarily adding the immutable
1109 feature to Moose. An immutable class is one which
1110 you promise not to alter. When you set the class
1111 as immutable it will perform various bits of
1112 memoization and inline certain part of the code
1113 (constructors, destructors and accessors). This
1114 minimizes (and in some cases totally eliminates)
1115 one of Moose's biggest performance hits. This
1116 feature is not on by default, and is 100% optional.
1117 It has several configurable bits as well, so you
1118 can pick and choose to your specific needs.
1120 The changes involved in this were fairly wide and
1121 highly specific, but 100% backwards compatible, so
1122 I am not going to enumerate them here. If you are
1123 truely interested in what was changed, please do
1126 0.17 Tues. Nov. 14, 2006
1127 * Moose::Meta::Method::Accessor
1128 - bugfix for read-only accessors which
1129 are have a type constraint and lazy.
1130 Thanks to chansen for finding it.
1132 0.16 Tues. Nov. 14, 2006
1134 There are some speed improvements in this release,
1135 but they are only the begining, so stay tuned.
1138 - BUILDALL and DEMOLISHALL no longer get
1139 called unless they actually need to be.
1140 This gave us a signifigant speed boost
1141 for the cases when there is no BUILD or
1142 DEMOLISH method present.
1144 * Moose::Util::TypeConstraints
1145 * Moose::Meta::TypeConstraint
1146 - added an 'optimize_as' option to the
1147 type constraint, which allows for a
1148 hand optimized version of the type
1149 constraint to be used when possible.
1150 - Any internally created type constraints
1151 now provide an optimized version as well.
1153 0.15 Sun. Nov. 5, 2006
1155 This version of Moose *must* have Class::MOP 0.36 in order
1156 to work correctly. A number of small internal tweaks have
1157 been made in order to be compatible with that release.
1159 * Moose::Util::TypeConstraints
1160 - added &unimport so that you can clean out
1161 your class namespace of these exported
1164 * Moose::Meta::Class
1165 - fixed minor issue which occasionally
1166 comes up during global destruction
1168 - moved Moose::Meta::Method::Overriden into
1172 - moved Moose::Meta::Role::Method into
1175 * Moose::Meta::Attribute
1176 - changed how we do type checks so that
1177 we reduce the overall cost, but still
1180 - moved accessor generation methods to
1181 Moose::Meta::Method::Accessor to
1182 conform to the API changes from
1185 * Moose::Meta::TypeConstraint
1186 - changed how constraints are compiled
1187 so that we do less recursion and more
1188 iteration. This makes the type check
1190 - moved Moose::Meta::TypeConstraint::Union
1193 * Moose::Meta::Method::Accessor
1194 - created this from methods formerly found in
1195 Moose::Meta::Attribute
1197 * Moose::Meta::Role::Method
1198 - moved this from Moose::Meta::Role
1200 * Moose::Meta::Method::Overriden
1201 - moved this from Moose::Meta::Class
1203 * Moose::Meta::TypeConstraint::Union
1204 - moved this from Moose::Meta::TypeConstraint
1206 0.14 Mon. Oct. 9, 2006
1208 * Moose::Meta::Attribute
1209 - fixed lazy attributes which were not getting
1210 checked with the type constraint (thanks ashley)
1211 - added tests for this
1212 - removed the over-enthusiastic DWIMery of the
1213 automatic ArrayRef and HashRef defaults, it
1214 broke predicates in an ugly way.
1215 - removed tests for this
1217 0.13 Sat. Sept. 30, 2006
1219 This version of Moose *must* have Class::MOP 0.35 in order
1220 to work correctly. A number of small internal tweaks have
1221 been made in order to be compatible with that release.
1224 - Removed the use of UNIVERSAL::require to be a better
1225 symbol table citizen and remove a dependency
1226 (thanks Adam Kennedy)
1228 **~~ removed experimental & undocumented feature ~~**
1229 - commented out the 'method' and 'self' keywords, see the
1230 comments for more info.
1233 - added a FAQ and WTF files to document frequently
1234 asked questions and common problems
1236 * Moose::Util::TypeConstraints
1237 - added GlobRef and FileHandle type constraint
1238 - added tests for this
1240 * Moose::Meta::Attribute
1241 - if your attribute 'isa' ArrayRef of HashRef, and you have
1242 not explicitly set a default, then make the default DWIM.
1243 This will also work for subtypes of ArrayRef and HashRef
1245 - you can now auto-deref subtypes of ArrayRef or HashRef too.
1246 - new test added for this (thanks to ashley)
1249 - added basic support for runtime role composition
1250 but this is still *highly experimental*, so feedback
1251 is much appreciated :)
1252 - added tests for this
1254 * Moose::Meta::TypeConstraint
1255 - the type constraint now handles the coercion process
1256 through delegation, this is to support the coercion
1259 * Moose::Meta::TypeConstraint::Union
1260 - it is now possible for coercions to be performed
1262 - added tests for this (thanks to konobi)
1264 * Moose::Meta::TypeCoercion
1265 - properly capturing error when type constraint
1269 - Scalar::Util 1.18 is bad on Win32, so temporarily
1270 only require version 1.17 for Win32 and cygwin.
1271 (thanks Adam Kennedy)
1273 0.12 Sat. Sept. 1, 2006
1275 - Recipe5 (subtypes & coercion) has been written
1278 - fixed "bad meta" error message to be more descriptive
1279 - fixed &unimport to not remove the &inner and &super
1280 keywords because we need to localize them.
1281 - fixed number of spelling/grammer issues, thanks Theory :)
1283 **~~ experimental & undocumented feature ~~**
1284 - added the method and self keywords, they are basically
1285 just sugar, and they may not stay around.
1288 - added &dump method to easily Data::Dumper
1291 * Moose::Meta::TypeConstraint
1292 - added the &is_a_type_of method to check both the current
1293 and the subtype of a method (similar to &isa with classes)
1296 - this is now a subclass of Class::MOP::Module, and no longer
1297 creates the _role_meta ugliness of before.
1298 - fixed tests to reflect this change
1300 0.11 Wed. July 12, 2006
1302 - added an &unimport method to remove all the keywords
1303 that Moose will import, simply add 'no Moose' to the
1304 bottom of your class file.
1307 - fixed some test failures caused by a forgotten test
1310 0.10 Thurs. July 6, 2006
1312 - improved error message when loading modules so
1313 it is less confusing when you load a role.
1314 - added &calculate_all_roles method to
1315 Moose::Meta::Class and Moose::Meta::Role
1318 This module has been tested against Class::MOP 0.30
1319 but it does not yet utilize the optimizations
1320 it makes available. Stay tuned for that ;)
1322 0.09_03 Fri. June 23, 2006
1323 ++ DEVELOPER RELEASE ++
1325 - 'use strict' and 'use warnings' are no longer
1326 needed in Moose classes, Moose itself will
1327 turn them on for you.
1328 - added tests for this
1329 - moved code from exported subs to private methods
1330 in Moose::Meta::Class
1333 - as with Moose, strict and warnings are
1334 automatically turned on for you.
1335 - added tests for this
1338 - now handles an edge case for override errors
1339 - added tests for this
1340 - added some more edge case tests
1342 0.09_02 Tues. May 16, 2006
1343 ++ DEVELOPER RELEASE ++
1345 - added prototypes to the exported subs
1349 - added prototypes to the exported subs
1352 * Moose::Util::TypeConstraints
1353 - cleaned up prototypes for the subs
1356 0.09_01 Fri. May 12, 2006
1357 ++ DEVELOPER RELEASE ++
1358 - This release works in combination with
1359 Class::MOP 0.29_01, it is a developer
1360 release because it uses the a new
1361 instance sub-protocol and a fairly
1362 complete Role implementation. It has
1363 not yet been optimized, so it slower
1364 the the previous CPAN version. This
1365 release also lacks good updated docs,
1366 the official release will have updated docs.
1369 - refactored the keyword exports
1370 - 'with' now checks Role validaity and
1371 accepts more than one Role at a time
1372 - 'extends' makes metaclass adjustments as
1373 needed to ensure metaclass compatability
1376 - refactored the keyword exports
1377 - 'with' now checks Role validaity and
1378 accepts more than one Role at a time
1380 * Moose::Util::TypeConstraints
1381 - added the 'enum' keyword for simple
1382 string enumerations which can be used as
1384 - see example of usage in t/202_example.t
1387 - more careful checking of params to new()
1390 - much work done on the role composition
1391 - many new tests for conflict detection
1392 and composition edge cases
1393 - not enough documentation, I suggest
1394 looking at the tests
1396 * Moose::Meta::Instance
1397 - added new Instance metaclass to support
1398 the new Class::MOP instance protocol
1400 * Moose::Meta::Class
1401 - some small changes to support the new
1403 - some small additions to support Roles
1405 * Moose::Meta::Attribute
1406 - some improvements to the accessor generation code
1408 - some small changes to support the new
1410 - (still somewhat) experimental delegation support
1411 with the 'handles' option
1412 - added several tests for this
1413 - no docs for this yet
1415 0.05 Thurs. April 27, 2006
1417 - keywords are now exported with Sub::Exporter
1418 thanks to chansen for this commit
1419 - has keyword now takes a 'metaclass' option
1420 to support custom attribute meta-classes
1421 on a per-attribute basis
1422 - added tests for this
1423 - the 'has' keyword not accepts inherited slot
1424 specifications (has '+foo'). This is still an
1425 experimental feature and probably not finished
1426 see t/038_attribute_inherited_slot_specs.t for
1427 more details, or ask about it on #moose
1428 - added tests for this
1431 - keywords are now exported with Sub::Exporter
1433 * Moose::Utils::TypeConstraints
1434 - reorganized the type constraint hierarchy, thanks
1435 to nothingmuch and chansen for his help and advice
1437 - added some tests for this
1438 - keywords are now exported with Sub::Exporter
1439 thanks to chansen for this commit
1441 * Moose::Meta::Class
1442 - due to changes in Class::MOP, we had to change
1443 construct_instance (for the better)
1445 * Moose::Meta::Attribute
1446 - due to changes in Class::MOP, we had to add the
1447 initialize_instance_slot method (it's a good thing)
1449 * Moose::Meta::TypeConstraint
1450 - added type constraint unions
1451 - added tests for this
1452 - added the is_subtype_of predicate method
1453 - added tests for this
1455 0.04 Sun. April 16th, 2006
1457 - Roles can now consume other roles
1458 - added tests for this
1459 - Roles can specify required methods now with
1460 the requires() keyword
1461 - added tests for this
1464 - ripped out much of it's guts ,.. much cleaner now
1465 - added required methods and correct handling of
1466 them in apply() for both classes and roles
1467 - added tests for this
1468 - no longer adds a does() method to consuming classes
1469 it relys on the one in Moose::Object
1470 - added roles attribute and some methods to support
1471 roles consuming roles
1473 * Moose::Meta::Attribute
1474 - added support for triggers on attributes
1475 - added tests for this
1476 - added support for does option on an attribute
1477 - added tests for this
1479 * Moose::Meta::Class
1480 - added support for attribute triggers in the
1482 - added tests for this
1485 - Moose no longer creates a subtype for your class
1486 if a subtype of the same name already exists, this
1487 should DWIM in 99.9999% of all cases
1489 * Moose::Util::TypeConstraints
1490 - fixed bug where incorrect subtype conflicts were
1492 - added test for this
1495 - this class can now be extended with 'use base' if
1496 you need it, it properly loads the metaclass class now
1497 - added test for this
1499 0.03_02 Wed. April 12, 2006
1501 - you must now explictly use Moose::Util::TypeConstraints
1502 it no longer gets exported for you automatically
1505 - new() now accepts hash-refs as well as key/value lists
1506 - added does() method to check for Roles
1507 - added tests for this
1509 * Moose::Meta::Class
1510 - added roles attribute along with the add_role() and
1512 - added tests for this
1515 - now adds a does() method to consuming classes
1516 which tests the class's hierarchy for roles
1517 - added tests for this
1519 0.03_01 Mon. April 10, 2006
1521 - added new Role recipe (no content yet, only code)
1524 - added 'with' keyword for Role support
1525 - added test and docs for this
1526 - fixed subtype quoting bug
1527 - added test for this
1531 - added test and docs
1533 * Moose::Util::TypeConstraints
1534 - added the message keyword to add custom
1535 error messages to type constraints
1538 - the meta role to support Moose::Role
1539 - added tests and docs
1541 * Moose::Meta::Class
1542 - moved a number of things from Moose.pm
1543 to here, they should have been here
1546 * Moose::Meta::Attribute
1547 - moved the attribute option macros here
1548 instead of putting them in Moose.pm
1550 * Moose::Meta::TypeConstraint
1551 - added the message attributes and the
1553 - added tests and docs for this
1555 0.03 Thurs. March 30, 2006
1557 - added the Moose::Cookbook with 5 recipes,
1558 describing all the stuff Moose can do.
1561 - fixed an issue with &extends super class loading
1562 it now captures errors and deals with inline
1563 packages correctly (bug found by mst, solution
1565 - added super/override & inner/augment features
1566 - added tests and docs for these
1569 - BUILDALL now takes a reference of the %params
1570 that are passed to &new, and passes that to
1573 * Moose::Util::TypeConstraints
1574 - Type constraints now survive runtime reloading
1575 - added test for this
1577 * Moose::Meta::Class
1578 - fixed the way attribute defaults are handled
1579 during instance construction (bug found by chansen)
1581 * Moose::Meta::Attribute
1582 - read-only attributes now actually enforce their
1583 read-only-ness (this corrected in Class::MOP as
1586 0.02 Tues. March 21, 2006
1588 - many more tests, fixing some bugs and
1590 - &extends now loads the base module with
1592 - added UNIVERSAL::require to the
1595 - each new Moose class will also create
1596 and register a subtype of Object which
1597 correspond to the new Moose class.
1598 - the 'isa' option in &has now only
1599 accepts strings, and will DWIM in
1602 * Moose::Util::TypeConstraints
1603 - added type coercion features
1604 - added tests for this
1605 - added support for this in attributes
1606 and instance construction
1608 - type construction no longer creates a
1609 function, it registers the type instead.
1610 - added several functions to get the
1614 - BUILDALL and DEMOLISHALL were broken
1615 because of a mis-named hash key, Whoops :)
1617 * Moose::Meta::Attribute
1618 - adding support for coercion in the
1619 autogenerated accessors
1621 * Moose::Meta::Class
1622 - adding support for coercion in the
1623 instance construction
1625 * Moose::Meta::TypeConstraint
1626 * Moose::Meta::TypeCoercion
1627 - type constraints and coercions are now
1628 full fledges meta-objects
1630 0.01 Wed. March 15, 2006
1631 - Moooooooooooooooooose!!!