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)
8 * Moose::Cookbook::Basics::Recipe1
9 * Moose::Cookbook::Basics::Recipe2
10 - Editing and content changes to simplify these recipes (Dave
14 * Moose::Cookbook::Extending::Recipe2
15 - Add a _remove_keywords function so if you extend Moose
16 you don't have to cargo cult Moose's unimport (Sartak)
19 - Moose now warns when you try to have it export its sugar
20 functions into the "main" package. Previously it silently did
21 nothing. (Dave Rolsky)
23 0.55 Sun August 3, 2008
24 * Moose::Meta::Attribute
25 - breaking down the way 'handles' methods are
26 created so that the process can be more easily
27 overridden by subclasses (stevan)
29 * Moose::Meta::TypeConstraint
30 - fixing what is passed into a ->message with
31 the type constraints (RT #37569)
32 - added tests for this (Charles Alderman)
34 * Moose::Util::TypeConstraints
35 - fix coerce to accept anon types like subtype can (mst)
38 - reorganized the recipes into sections - Basics, Roles, Meta,
39 Extending - and wrote abstracts for each section (Dave Rolsky)
41 * Moose::Cookbook::Basics::Recipe10
42 - A new recipe that demonstrates operator overloading
43 in combination with Moose. (bluefeet)
45 * Moose::Cookbook::Meta::Recipe1
46 - an introduction to what meta is and why you'd want to make
47 your own metaclass extensions (Dave Rolsky)
49 * Moose::Cookbook::Meta::Recipe4
50 - a very simple metaclass example (Dave Rolsky)
52 * Moose::Cookbook::Extending::Recipe1
53 - how to write a Moose-alike module to use your own object base
56 * Moose::Cookbook::Extending::Recipe2
57 - how to write modules with an API just like C<Moose.pm> (Dave
61 - Tons of fixes, both syntactical and grammatical (Dave
64 0.54 Thurs. July 3, 2008
65 ... this is not my day today ...
67 * Moose::Meta::Attribute
68 - fixed legal_options_for_inheritance such that
69 clone_and_inherit options still works for
70 Class::MOP::Attribute objects and therefore
71 does not break MooseX::AttributeHelpers
74 0.53 Thurs. July 3, 2008
75 * Whoops, I guess I should run 'make manifest' before
76 actually releasing the module. No actual changes
77 in this release, except the fact that it includes
78 the changes that I didn't include in the last
81 0.52 Thurs. July 3, 2008
83 - added "FEATURE REQUESTS" section to the Moose docs
84 to properly direct people (stevan) (RT #34333)
85 - making 'extends' croak if it is passed a Role since
86 this is not ever something you want to do
87 (fixed by stevan, found by obra)
88 - added tests for this (stevan)
91 - adding support for DOES (as in UNIVERSAL::DOES)
95 * Moose::Meta::Attribute
96 - added legal_options_for_inheritance (wreis)
97 - added tests for this (wreis)
99 * Moose::Cookbook::Snacks::*
100 - removed some of the unfinished snacks that should
101 not have been released yet. Added some more examples
102 to the 'Keywords' snack. (stevan)
104 * Moose::Cookbook::Style
105 - added general Moose "style guide" of sorts to the
106 cookbook (nothingmuch) (RT #34335)
109 - added more BUILDARGS tests (stevan)
111 0.51 Thurs. Jun 26, 2008
113 - add unimport so "no Moose::Role" actually does
116 * Moose::Meta::Role::Application::ToRole
117 - when RoleA did RoleB, and RoleA aliased a method from RoleB in
118 order to provide its own implementation, that method still got
119 added to the list of required methods for consumers of
120 RoleB. Now an aliased method is only added to the list of
121 required methods if the role doing the aliasing does not
122 provide its own implementation. See Recipe 11 for an example
123 of all this. (Dave Rolsky)
124 - added tests for this
126 * Moose::Meta::Method::Constructor
127 - when a single argument that wasn't a hashref was provided to
128 an immutabilized constructor, the error message was very
129 unhelpful, as opposed to the non-immutable error. Reported by
131 - added test for this (Dave Rolsky)
133 * Moose::Meta::Attribute
134 - added support for meta_attr->does("ShortAlias") (sartak)
135 - added tests for this (sartak)
136 - moved the bulk of the `handles` handling to the new
137 install_delegation method (Stevan)
140 - Added BUILDARGS, a new step in new()
142 * Moose::Meta::Role::Application::RoleSummation
143 - fix typos no one ever sees (sartak)
145 * Moose::Util::TypeConstraints
146 * Moose::Meta::TypeConstraint
147 * Moose::Meta::TypeCoercion
148 - Attempt to work around the ??{ } vs. threads issue
150 - Some null_constraint optimizations
152 0.50 Thurs. Jun 11, 2008
153 - Fixed a version number issue by bumping all modules
156 0.49 Thurs. Jun 11, 2008
157 !! This version now approx. 20-25% !!
158 !! faster with new Class::MOP 0.59 !!
160 * Moose::Meta::Attribute
161 - fixed how the is => (ro|rw) works with
162 custom defined reader, writer and accessor
164 - added docs for this (TODO).
165 - added tests for this (Thanks to Penfold)
166 - added the custom attribute alias for regular
167 Moose attributes which is "Moose"
168 - fix builder and default both being used
173 Moose::Meta::Attribute
175 Moose::Meta::Role::Composite
176 Moose::Util::TypeConstraints
177 - switched usage of reftype to ref because
181 - changing add_package_symbol to use the new
185 - fixed how DEMOLISHALL is called so that it
186 can be overrided in subclasses (thanks to Sartak)
187 - added test for this (thanks to Sartak)
189 * Moose::Util::TypeConstraints
190 - move the ClassName type check code to
191 Class::MOP::is_class_loaded (thanks to Sartak)
193 * Moose::Cookbook::Recipe11
194 - add tests for this (thanks to tokuhirom)
196 0.48 Thurs. May 29, 2008
197 (early morning release engineering)--
199 - fixing the version in Moose::Meta::Method::Destructor
200 which was causing the indexer to choke
202 0.47 Thurs. May 29, 2008
203 (late night release engineering)--
205 - fixing the version is META.yml, no functional
206 changes in this release
208 0.46 Wed. May 28, 2008
209 !! This version now approx. 20-25% !!
210 !! faster with new Class::MOP 0.57 !!
213 - some optimizations of the &initialize method
214 since it is called so often by &meta
218 - now use the get_all_package_symbols from the
219 updated Class::MOP, test suite is now 10 seconds
222 * Moose::Meta::Method::Destructor
223 - is_needed can now also be called as a class
224 method for immutablization to check if the
225 destructor object even needs to be created
228 * Moose::Meta::Method::Destructor
229 Moose::Meta::Method::Constructor
230 - added more descriptive error message to help
231 keep people from wasting time tracking an error
232 that is easily fixed by upgrading.
234 0.45 Saturday, May 24, 2008
236 - Because of work in Class::MOP 0.56, all
237 XS based functionality is now optional
238 and a Pure Perl version is supplied
239 - the CLASS_MOP_NO_XS environment variable
240 can now be used to force non-XS versions
242 - several of the packages have been tweaked
243 to take care of this, mostly we added
244 support for the package_name and name
245 variables in all the Method metaclasses
246 - before/around/after method modifiers now
247 support regexp matching of names
248 (thanks to Takatoshi Kitano)
249 - tests added for this
250 - NOTE: this only works for classes, it
251 is currently not supported in roles,
252 but, ... patches welcome
253 - All usage of Carp::confess have been replaced
254 by Carp::croak in the "keyword" functions since
255 the stack trace is usually not helpful
258 - All usage of Carp::confess have been replaced
259 by Carp::croak in the "keyword" functions since
260 the stack trace is usually not helpful
261 - The 'has' keyword for roles now accepts the
262 same array ref form that Moose.pm does
263 (has [qw/foo bar/] => (is => 'rw', ...))
264 - added test for this
266 * Moose::Meta::Attribute
267 - trigger on a ro-attribute is no longer an
268 error, as it's useful to trigger off of the
272 - added same 'add_package_symbol' fix as in
276 - does_role now handles non-Moose classes
278 - added tests for this
279 - added the 'add_method_modifier' function
280 (thanks to Takatoshi Kitano)
282 * Moose::Util::TypeConstraints
283 - subtypes of parameterizable types now are
284 themselves parameterizable types
286 * Moose::Meta::Method::Constructor
287 - fixed bug where trigger was not being
288 called by the inlined immutable
290 - added test for this (thanks to Caelum)
292 * Moose::Meta::Role::Application::ToInstance
293 - now uses the metaclass of the instance
294 (if possible) to create the anon-class
295 (thanks Jonathan Rockway)
297 * Moose::Cookbook::Recipe22
298 - added the meta-attribute trait recipe
302 - fixed hash-ordering test bug that was
303 causing occasional cpantester failures
304 - renamed the t/000_recipe/*.t tests to be
305 more descriptive (thanks to Sartak)
307 0.44 Sat. May 10, 2008
309 - made make_immutable warning cluck to
310 show where the error is (thanks mst)
313 - BUILDALL and DEMOLISHALL now call
314 ->body when looping through the
315 methods, to avoid the overloaded
317 - fixed issue where DEMOLISHALL was
318 eating the $@ values, and so not
319 working correctly, it still kind of
320 eats them, but so does vanilla perl
321 - added tests for this
323 * Moose::Cookbook::Recipe7
324 - added new recipe for immutable
325 functionality (thanks Dave Rolsky)
327 * Moose::Cookbook::Recipe9
328 - added new recipe for builder and
329 lazy_build (thanks Dave Rolsky)
331 * Moose::Cookbook::Recipe11
332 - added new recipe for method aliasing
333 and exclusion with Roles (thanks Dave Rolsky)
336 - fixed Win32 test failure (thanks spicyjack)
338 ~ removed Build.PL and Module::Build compat
339 since Module::Install has done that.
341 0.43 Wed. April, 30, 2008
343 drink more coffee before
344 doing release engineering
346 - whoops, forgot to do the smolder tests,
347 and we broke some of the custom meta-attr
348 modules. This fixes that.
350 0.42 Mon. April 28, 2008
351 - some bad tests slipped by, nothing else
352 changed in this release (cpantesters++)
354 - upped the Class::MOP dependency to 0.55
355 since we have tests which need the C3
358 0.41 Mon. April 28, 2008
359 ~~ numerous documentation updates ~~
361 - Changed all usage of die to Carp::croak for better
362 error reporting (initial patch by Tod Hagan)
365 - the make_immutable keyword is now deprecated, don't
366 use it in any new code and please fix your old code
367 as well. There will be 2 releases, and then it will
373 - refactored the way inner and super work to avoid
374 any method/@ISA cache penalty (nothingmuch)
377 - fixing &new_object to make sure trigger gets the
378 coerced value (spotted by Charles Alderman on the
380 - added test for this
382 * Moose::Meta::Method::Constructor
383 - immutable classes which had non-lazy attributes were calling
384 the default generating sub twice in the constructor. (bug
385 found by Jesse Luehrs, fixed by Dave Rolsky)
386 - added tests for this (Dave Rolsky)
387 - fix typo in initialize_body method (nothingmuch)
389 * Moose::Meta::Method::Destructor
390 - fix typo in initialize_body method (nothingmuch)
392 * Moose::Meta::Method::Overriden
393 Moose::Meta::Method::Augmented
394 - moved the logic for these into their own
395 classes (nothingmuch)
397 * Moose::Meta::Attribute
398 - inherited attributes may now be extended without
399 restriction on the type ('isa', 'does') (Sartak)
400 - added tests for this (Sartak)
401 - when an attribute property is malformed (such as lazy without
402 a default), give the name of the attribute in the error
404 - added the &applied_traits and &has_applied_traits methods
405 to allow introspection of traits
406 - added tests for this
407 - moved 'trait' and 'metaclass' argument handling to here from
409 - clone_and_inherit_options now handles 'trait' and 'metaclass' (has
410 '+foo' syntax) (nothingmuch)
411 - added tests for this (t0m)
414 - localize $@ inside DEMOLISHALL to avoid it
415 eating $@ (found by Ernesto)
416 - added test for this (thanks to Ernesto)
418 * Moose::Util::TypeConstraints
419 - &find_type_constraint now DWIMs when given an
420 type constraint object or name (nothingmuch)
421 - &find_or_create_type_constraint superseded with a number of more
423 - find_or_create_{isa,does}_type_constraint
424 - find_or_parse_type_constraint
426 * Moose::Meta::TypeConstraint
427 Moose::Meta::TypeConstraint::Class
428 Moose::Meta::TypeConstraint::Role
429 Moose::Meta::TypeConstraint::Enum
430 Moose::Meta::TypeConstraint::Union
431 Moose::Meta::TypeConstraint::Parameterized
432 - added the &equals method for comparing two type
433 constraints (nothingmuch)
434 - added tests for this (nothingmuch)
436 * Moose::Meta::TypeConstraint
437 - add the &parents method, which is just an alias to &parent.
438 Useful for polymorphism with TC::{Class,Role,Union} (nothingmuch)
440 * Moose::Meta::TypeConstraint::Class
441 - added the class attribute for introspection purposes
443 - added tests for this
445 * Moose::Meta::TypeConstraint::Enum
446 Moose::Meta::TypeConstraint::Role
447 - broke these out into their own classes (nothingmuch)
449 * Moose::Cookbook::Recipe*
450 - fixed references to test file locations in the POD
451 and updated up some text for new Moose features
455 - Added &resolve_metaclass_alias, a helper function for finding an actual
456 class for a short name (e.g. in the traits list)
458 0.40 Fri. March 14, 2008
459 - I hate Pod::Coverage
461 0.39 Fri. March 14, 2008
463 - documenting the use of '+name' with attributes
464 that come from recently composed roles. It makes
465 sense, people are using it, and so why not just
466 officially support it.
467 - fixing the 'extends' keyword so that it will not
468 trigger Ovid's bug (http://use.perl.org/~Ovid/journal/35763)
471 - added the perl -Moose=+Class::Name feature to allow
472 monkeypatching of classes in one liners
475 - fixing the 'apply_all_roles' keyword so that it will not
476 trigger Ovid's bug (http://use.perl.org/~Ovid/journal/35763)
479 - added ->create method which now supports roles (thanks to jrockway)
480 - added tests for this
481 - added ->create_anon_class which now supports roles and caching of
482 the results (thanks to jrockway)
483 - added tests for this
484 - made ->does_role a little more forgiving when it is
485 checking a Class::MOP era metaclasses.
487 * Moose::Meta::Role::Application::ToInstance
488 - it is now possible to pass extra params to be used when
489 a role is applied to an the instance (rebless_params)
490 - added tests for this
492 * Moose::Util::TypeConstraints
493 - class_type now accepts an optional second argument for a
494 custom message. POD anotated accordingly (groditi)
495 - added tests for this
496 - it is now possible to make anon-enums by passing 'enum' an
497 ARRAY ref instead of the $name => @values. Everything else
499 - added tests for this
502 - making test for using '+name' on attributes consumed
503 from a role, it works and makes sense too.
505 * Moose::Meta::Attribute
506 - fix handles so that it doesn't return nothing
507 when the method cannot be found, not sure why
508 it ever did this originally, this means we now
509 have slightly better support for AUTOLOADed
511 - added more delegation tests
512 - adding ->does method to this so as to better
513 support traits and their introspection.
514 - added tests for this
517 - localizing the Data::Dumper configurations so
518 that it does not pollute others (RT #33509)
519 - made ->does a little more forgiving when it is
520 passed Class::MOP era metaclasses.
522 0.38 Fri. Feb. 15, 2008
523 * Moose::Meta::Attribute
524 - fixed initializer to correctly do
525 type checking and coercion in the
527 - added tests for this
530 - fixed some finicky tests (thanks to konobi)
532 0.37 Thurs. Feb. 14, 2008
534 - fixed some details in Moose::init_meta
535 and its superclass handling (thanks thepler)
536 - added tests for this (thanks thepler)
537 - 'has' now dies if you don't pass in name
539 - added the 'make_immutable' keyword as a shortcut
543 Moose::Meta::Method::Constructor
544 Moose::Meta::Attribute
545 - making (init_arg => undef) work here too
546 (thanks to nothingmuch)
548 * Moose::Meta::Attribute
549 Moose::Meta::Method::Constructor
550 Moose::Meta::Method::Accessor
551 - make lazy attributes respect attr initializers (rjbs)
552 - added tests for this
554 * Moose::Util::TypeConstraints
555 Moose::Util::TypeConstraints::OptimizedConstraints
556 Moose::Meta::TypeConstraints
557 Moose::Meta::Attribute
558 Moose::Meta::Method::Constructor
559 Moose::Meta::Method::Accessor
560 - making type errors use the
561 assigned message (thanks to Sartak)
562 - added tests for this
564 * Moose::Meta::Method::Destructor
565 - making sure DESTROY gets inlined properly
566 with successive DEMOLISH calls (thanks to manito)
568 * Moose::Meta::Attribute
569 Moose::Meta::Method::Accessor
570 - fixed handling of undef with type constraints
572 - added tests for this
575 - added &get_all_init_args and &get_all_attribute_values
576 (thanks to Sartak and nothingmuch)
578 0.36 Sat. Jan. 26, 2008
580 Moose::Meta::Attribute
581 - role type tests now support when roles are
582 applied to non-Moose classes (found by ash)
583 - added tests for this (thanks to ash)
584 - couple extra tests to boost code coverage
586 * Moose::Meta::Method::Constructor
587 - improved fix for handling Class::MOP attributes
588 - added test for this
591 - handled the add_attribute($attribute_meta_object)
593 - added test for this
595 0.35 Tues. Jan. 22, 2008
596 * Moose::Meta::Method::Constructor
597 - fix to make sure even Class::MOP attributes
598 are handled correctly (Thanks to Dave Rolsky)
599 - added test for this (also Dave Rolsky)
602 - improved error message on _apply_all_roles,
603 you should now use Moose::Util::apply_all_roles
604 and you shouldnt have been using a _ prefixed
605 method in the first place ;)
607 0.34 Mon. Jan. 21, 2008
608 ~~~ more misc. doc. fixes ~~~
609 ~~ updated copyright dates ~~
611 Moose is now a postmodern object system :)
612 - (see the POD for details)
614 * <<Role System Refactoring>>
615 - this release contains a major reworking and
616 cleanup of the role system
617 - 100% backwards compat.
618 - Role application now restructured into seperate
619 classes based on type of applicants
620 - Role summation (combining of more than one role)
621 is much cleaner and anon-classes are no longer
623 - new Composite role metaclass
624 - runtime application of roles to instances
625 is now more efficient and re-uses generated
626 classes when applicable
628 * <<New Role composition features>>
629 - methods can now be excluded from a given role
631 - methods can now be aliased to another name (and
632 still retain the original as well)
634 * Moose::Util::TypeConstraints::OptimizedConstraints
635 - added this module (see above)
638 - fixed the &_process_attribute method to be called
639 by &add_attribute, so that the API is now correct
641 * Moose::Meta::Method::Accessor
642 - fixed bug when passing a list of values to
643 an accessor would get (incorrectly) ignored.
644 Thanks to Sartak for finding this ;)
645 - added tests for this (Sartak again)
647 * Moose::Meta::Method::Accessor
648 Moose::Meta::Method::Constructor
649 Moose::Meta::Attribute
650 Moose::Meta::TypeConstraint
651 Moose::Meta::TypeCoercion
652 - lots of cleanup of such things as:
654 - type constraint handling
655 - error handling/messages
656 (thanks to nothingmuch)
658 * Moose::Meta::TypeConstraint::Parameterizable
659 - added this module to support the refactor
660 in Moose::Meta::TypeConstraint::Parameterized
662 * Moose::Meta::TypeConstraint::Parameterized
663 - refactored how these types are handled so they
664 are more generic and not confined to ArrayRef
668 - shortened some file names for better VMS support (RT #32381)
670 0.33 Fri. Dec. 14, 2007
671 !! Moose now loads 2 x faster !!
672 !! with new Class::MOP 0.49 !!
674 ++ new oose.pm module to make command line
675 Moose-ness easier (see POD docs for more)
679 - several tweaks to take advantage of the
680 new method map caching in Class::MOP
682 * Moose::Meta::TypeConstraint::Parameterized
683 - allow subtypes of ArrayRef and HashRef to
684 be used as a container (sartak)
685 - added tests for this
686 - basic support for coercion to ArrayRef and
687 HashRef for containers (sartak)
688 - added tests for this
690 * Moose::Meta::TypeCoercion
691 - coercions will now create subtypes as needed
692 so you can now add coercions to parameterized
693 types without having to explictly define them
694 - added tests for this
696 * Moose::Meta::Method::Accessor
697 - allow subclasses to decide whether we need
698 to copy the value into a new variable (sartak)
700 0.32 Tues. Dec. 4, 2007
701 * Moose::Util::TypeConstraints
702 - fixing how subtype aliases of unions work
703 they should inherit the parent's coercion
704 - added tests for this
705 - you can now define multiple coercions on
706 a single type at different times instead of
707 having to do it all in one place
708 - added tests for this
710 * Moose::Meta::TypeConstraint
711 - there is now a default constraint of sub { 1 }
712 instead of Moose::Util::TypeConstraints setting
715 * Moose::Meta::TypeCoercion
716 * Moose::Meta::TypeCoercion::Union
717 - added the &has_coercion_for_type and
718 &add_type_coercions methods to support the
719 new features above (although you cannot add
720 more type coercions for Union types)
722 0.31 Mon. Nov. 26, 2007
723 * Moose::Meta::Attribute
724 - made the +attr syntax handle extending types with
725 parameters. So "has '+foo' => (isa => 'ArrayRef[Int]')"
726 now works if the original foo is an ArrayRef.
727 - added tests for this.
728 - delegation now works even if the attribute does not
729 have a reader method using the get_read_method_ref
730 method from Class::MOP::Attribute.
731 - added tests for this
732 - added docs for this
734 * Moose::Util::TypeConstraints
735 - passing no "additional attribute info" to
736 &find_or_create_type_constraint will no longer
737 attempt to create an __ANON__ type for you,
738 instead it will just return undef.
739 - added docs for this
741 0.30 Fri. Nov. 23, 2007
742 * Moose::Meta::Method::Constructor
743 -builder related bug in inlined constructor. (groditi)
745 * Moose::Meta::Method::Accessor
746 - genereate unnecessary calls to predicates and refactor
747 code generation for runtime speed (groditi)
749 * Moose::Util::TypeConstraints
750 - fix ClassName constraint to introspect symbol table (mst)
751 - added more tests for this (mst)
752 - fixed it so that subtype 'Foo' => as 'HashRef[Int]' ...
754 - added tests for this
757 - adding the link to Recipie 11 (written by Sartak)
758 - adding test for SYNOPSIS code
761 - New tests for builder bug. Upon instantiation, if an
762 attribute had a builder, no value and was not lazy the
763 builder default was not getting run, oops. (groditi)
765 0.29 Tues. Nov. 13, 2007
766 * Moose::Meta::Attribute
767 - Fix error message on missing builder method (groditi)
769 * Moose::Meta::Method::Accessor
770 - Fix error message on missing builder method (groditi)
773 - Add test to check for the correct error message when
774 builder method is missing (groditi)
776 0.28 Tues. Nov. 13, 2007
777 - 0.27 packaged incorrectly (groditi)
779 0.27 Tues. Nov. 13, 2007
780 * Moose::Meta::Attribute
781 - Added support for the new builder option (groditi)
782 - Added support for lazy_build option (groditi)
783 - Changed slot initialization for predicate changes (groditi)
785 * Moose::Meta::Method::Accessor
786 - Added support for lazy_build option (groditi)
787 - Fix inline methods to work with corrected predicate
790 * Moose::Meta::Method::Constructor
791 - Added support for lazy_build option (groditi)
794 - tests for builder and lazy_build (groditi)
796 * fixing some misc. bits in the docs that
797 got mentioned on CPAN Forum & perlmonks
800 - fixed how required methods are handled
801 when they encounter overriden or modified
802 methods from a class (thanks to confound).
803 - added tests for this
805 * Moose::Util::TypeConstraint
806 - fixed the type notation parser so that
807 the | always creates a union and so is
808 no longer a valid type char (thanks to
809 konobi, mugwump and #moose for working
811 - added more tests for this
813 0.26 Thurs. Sept. 27, 2007
816 * Parameterized Types
817 We now support parameterized collection types, such as:
818 ArrayRef[Int] # array or integers
819 HashRef[Object] # a hash with object values
820 They can also be nested:
821 ArrayRef[HashRef[RegExpr]] # an array of hashes with regexpr values
822 And work with the type unions as well:
823 ArrayRef[Int | Str] # array of integers of strings
825 * Better Framework Extendability
826 Moose.pm is now "extendable" such that it is now much
827 easier to extend the framework and add your own keywords
828 and customizations. See the "EXTENDING AND EMBEDDING MOOSE"
829 section of the Moose.pm docs.
832 In an effort to begin documenting some of the various
833 details of Moose as well as some common idioms, we have
834 created Moose::Cookbook::Snacks as a place to find
835 small (easily digestable) nuggets of Moose code.
838 ~ Several doc updates/cleanup thanks to castaway ~
840 - converted build system to use Module::Install instead of
841 Module::Build (thanks to jrockway)
844 - added all the meta classes to the immutable list and
845 set it to inline the accessors
846 - fix import to allow Sub::Exporter like { into => }
847 and { into_level => } (perigrin)
848 - exposed and documented init_meta() to allow better
849 embedding and extending of Moose (perigrin)
852 - complete re-organization of the test suite
853 - added some new tests as well
854 - finally re-enabled the Moose::POOP test since
855 the new version of DBM::Deep now works again
859 - fixed very odd and very nasty recursion bug with
861 - added tests for this (eilara)
863 * Moose::Meta::Attribute
864 Moose::Meta::Method::Constructor
865 Moose::Meta::Method::Accessor
866 - fixed issue with overload::Overloaded getting called
867 on non-blessed items. (RT #29269)
868 - added tests for this
870 * Moose::Meta::Method::Accessor
871 - fixed issue with generated accessor code making
872 assumptions about hash based classes (thanks to dexter)
874 * Moose::Coookbook::Snacks
875 - these are bits of documentation, not quite as big as
876 Recipes but which have no clear place in the module docs.
877 So they are Snacks! (horray for castaway++)
879 * Moose::Cookbook::Recipe4
880 - updated it to use the new ArrayRef[MyType] construct
881 - updated the accompanying test as well
883 +++ Major Refactor of the Type Constraint system +++
884 +++ with new features added as well +++
886 * Moose::Util::TypeConstraint
887 - no longer uses package variable to keep track of
888 the type constraints, now uses the an instance of
889 Moose::Meta::TypeConstraint::Registry to do it
890 - added more sophisticated type notation parsing
892 - added tests for this
894 * Moose::Meta::TypeConstraint
895 - some minor adjustments to make subclassing easier
896 - added the package_defined_in attribute so that we
897 can track where the type constraints are created
899 * Moose::Meta::TypeConstraint::Union
900 - this is now been refactored to be a subclass of
901 Moose::Meta::TypeConstraint
903 * Moose::Meta::TypeCoercion::Union
904 - this has been added to service the newly refactored
905 Moose::Meta::TypeConstraint::Union and is itself
906 a subclass of Moose::Meta::TypeCoercion
908 * Moose::Meta::TypeConstraint::Parameterized
909 - added this module (taken from MooseX::AttributeHelpers)
910 to help construct nested collection types
911 - added tests for this
913 * Moose::Meta::TypeConstraint::Registry
914 - added this class to keep track of type constraints
916 0.25 Mon. Aug. 13, 2007
918 - Documentation update to reference Moose::Util::TypeConstraints
919 under 'isa' in 'has' for how to define a new type
922 * Moose::Meta::Attribute
923 - required attributes now will no longer accept undef
924 from the constructor, even if there is a default and lazy
925 - added tests for this
926 - default subroutines must return a value which passes the
928 - added tests for this
930 * Moose::Meta::Attribute
931 * Moose::Meta::Method::Constructor
932 * Moose::Meta::Method::Accessor
933 - type-constraint tests now handle overloaded objects correctly
935 - added tests for this (thanks to EvanCarroll)
937 * Moose::Meta::TypeConstraint::Union
938 - added (has_)hand_optimized_constraint to this class so that
939 it behaves as the regular Moose::Meta::TypeConstraint does.
942 - large refactoring of this code
943 - added several more tests
944 - tests for subtle conflict resolition issues
945 added, but not currently running
948 * Moose::Cookbook::Recipe7
949 - added new recipe for augment/inner functionality
951 - added test for this
954 - a formal definition of roles (still in progress)
957 - utilities for easier working with Moose classes
958 - added tests for these
961 - This contains Moose specific test functions
962 - added tests for these
964 0.24 Tues. July 3, 2007
965 ~ Some doc updates/cleanup ~
967 * Moose::Meta::Attribute
968 - added support for roles to be given as parameters
969 to the 'handles' option.
970 - added tests and docs for this
971 - the has '+foo' attribute form now accepts changes to
972 the lazy option, and the addition of a handles option
973 (but not changing the handles option)
974 - added tests and docs for this
977 - required methods are now fetched using find_method_by_name
978 so that required methods can come from superclasses
979 - adjusted tests for this
981 0.23 Mon. June 18, 2007
982 * Moose::Meta::Method::Constructor
983 - fix inlined constructor for hierarchy with multiple BUILD methods (mst)
985 - Modify make_immutable to work with the new Class::MOP immutable
986 mechanism + POD + very basic test (groditi)
987 * Moose::Meta::Attribute
988 - Fix handles to use goto() so that caller() comes out properly on
989 the other side (perigrin)
991 0.22 Thurs. May 31, 2007
992 * Moose::Util::TypeConstraints
993 - fix for prototype undeclared issue when Moose::Util::TypeConstraints
994 loaded before consumers (e.g. Moose::Meta::Attribute) by predeclaring
995 prototypes for functions
996 - added the ClassName type constraint, this checks for strings
997 which will respond true to ->isa(UNIVERSAL).
998 - added tests and docs for this
999 - subtyping just in name now works correctly by making the
1000 default for where be { 1 }
1001 - added test for this
1003 * Moose::Meta::Method::Accessor
1004 - coerce and lazy now work together correctly, thanks to
1005 merlyn for finding this bug
1006 - tests added for this
1007 - fix reader presedence bug in Moose::Meta::Attribute + tests
1010 - Foo->new(undef) now gets ignored, it is assumed you meant to pass
1011 a HASH-ref and missed. This produces better error messages then
1012 having it die cause undef is not a HASH.
1013 - added tests for this
1015 0.21 Thursday, May 2nd, 2007
1017 - added SUPER_SLOT and INNER_SLOT class hashes to support unimport
1018 - modified unimport to remove super and inner along with the rest
1019 - altered unimport tests to handle this
1022 - altered super export to populate SUPER_SLOT
1024 * Moose::Meta::Class
1025 - altered augment and override modifier application to use *_SLOT
1026 - modified tests for these to unimport one test class each to test
1029 - fixed issue where custom attribute metaclasses
1030 where not handled correctly in roles
1031 - added tests for this
1033 * Moose::Meta::Class
1034 - fixed issue where extending metaclasses with
1035 roles would blow up. Thanks to Aankhen`` for
1036 finding this insidious error, and it's solution.
1038 ~~ lots of spelling and grammer fixes in the docs,
1039 many many thanks to rlb3 and Aankhen for these :)
1041 0.20 Friday, April 6th, 2007
1042 >> I messed up the SKIP logic in one test
1043 so this release is just to fix that.
1046 - 'has' now also accepts an ARRAY ref
1047 to create multiple attrs (see docs)
1048 (thanks to konobi for this)
1049 - added tests and docs
1051 0.19 Thurs. April 5th, 2007
1052 ~~ More documentation updates ~~
1054 * Moose::Util::TypeConstraints
1055 - 'type' now supports messages as well
1056 thanks to phaylon for finding this
1057 - added tests for this
1058 - added &list_all_type_constraints and
1059 &list_all_builtin_type_constraints
1060 functions to facilitate introspection.
1062 * Moose::Meta::Attribute
1063 - fixed regexp 'handles' declarations
1064 to build the list of delegated methods
1065 correctly (and not override important
1066 things like &new) thanks to ashleyb
1068 - added tests and docs for this
1069 - added the 'documentation' attributes
1070 so that you can actually document your
1071 attributes and inspect them through the
1073 - added tests and docs for this
1075 * Moose::Meta::Class
1076 - when loading custom attribute metaclasses
1077 it will first look in for the class in the
1078 Moose::Meta::Attribute::Custom::$name, and
1079 then default to just loading $name.
1080 - added tests and docs for this
1082 * Moose::Meta::TypeConstraint
1083 - type constraints now stringify to their names.
1084 - added test for this
1087 - added tests to assure we work with Module::Refresh
1088 - added stricter test skip logic in the Moose POOP
1089 test, ask Rob Kinyon why.
1090 - *cough* DBM::Deep 1.0 backwards compatability sucks *cough* ;)
1092 0.18 Sat. March 10, 2007
1093 ~~ Many, many documentation updates ~~
1096 - We now use Class::MOP::load_class to
1098 - added tests to show types and subtypes
1099 working with Declare::Constraints::Simple
1100 and Test::Deep as constraint engines.
1103 !! You must have Class::MOP 0.37_001 !!
1104 !! for this developer release to work !!
1106 This release was primarily adding the immutable
1107 feature to Moose. An immutable class is one which
1108 you promise not to alter. When you set the class
1109 as immutable it will perform various bits of
1110 memoization and inline certain part of the code
1111 (constructors, destructors and accessors). This
1112 minimizes (and in some cases totally eliminates)
1113 one of Moose's biggest performance hits. This
1114 feature is not on by default, and is 100% optional.
1115 It has several configurable bits as well, so you
1116 can pick and choose to your specific needs.
1118 The changes involved in this were fairly wide and
1119 highly specific, but 100% backwards compatible, so
1120 I am not going to enumerate them here. If you are
1121 truely interested in what was changed, please do
1124 0.17 Tues. Nov. 14, 2006
1125 * Moose::Meta::Method::Accessor
1126 - bugfix for read-only accessors which
1127 are have a type constraint and lazy.
1128 Thanks to chansen for finding it.
1130 0.16 Tues. Nov. 14, 2006
1132 There are some speed improvements in this release,
1133 but they are only the begining, so stay tuned.
1136 - BUILDALL and DEMOLISHALL no longer get
1137 called unless they actually need to be.
1138 This gave us a signifigant speed boost
1139 for the cases when there is no BUILD or
1140 DEMOLISH method present.
1142 * Moose::Util::TypeConstraints
1143 * Moose::Meta::TypeConstraint
1144 - added an 'optimize_as' option to the
1145 type constraint, which allows for a
1146 hand optimized version of the type
1147 constraint to be used when possible.
1148 - Any internally created type constraints
1149 now provide an optimized version as well.
1151 0.15 Sun. Nov. 5, 2006
1153 This version of Moose *must* have Class::MOP 0.36 in order
1154 to work correctly. A number of small internal tweaks have
1155 been made in order to be compatible with that release.
1157 * Moose::Util::TypeConstraints
1158 - added &unimport so that you can clean out
1159 your class namespace of these exported
1162 * Moose::Meta::Class
1163 - fixed minor issue which occasionally
1164 comes up during global destruction
1166 - moved Moose::Meta::Method::Overriden into
1170 - moved Moose::Meta::Role::Method into
1173 * Moose::Meta::Attribute
1174 - changed how we do type checks so that
1175 we reduce the overall cost, but still
1178 - moved accessor generation methods to
1179 Moose::Meta::Method::Accessor to
1180 conform to the API changes from
1183 * Moose::Meta::TypeConstraint
1184 - changed how constraints are compiled
1185 so that we do less recursion and more
1186 iteration. This makes the type check
1188 - moved Moose::Meta::TypeConstraint::Union
1191 * Moose::Meta::Method::Accessor
1192 - created this from methods formerly found in
1193 Moose::Meta::Attribute
1195 * Moose::Meta::Role::Method
1196 - moved this from Moose::Meta::Role
1198 * Moose::Meta::Method::Overriden
1199 - moved this from Moose::Meta::Class
1201 * Moose::Meta::TypeConstraint::Union
1202 - moved this from Moose::Meta::TypeConstraint
1204 0.14 Mon. Oct. 9, 2006
1206 * Moose::Meta::Attribute
1207 - fixed lazy attributes which were not getting
1208 checked with the type constraint (thanks ashley)
1209 - added tests for this
1210 - removed the over-enthusiastic DWIMery of the
1211 automatic ArrayRef and HashRef defaults, it
1212 broke predicates in an ugly way.
1213 - removed tests for this
1215 0.13 Sat. Sept. 30, 2006
1217 This version of Moose *must* have Class::MOP 0.35 in order
1218 to work correctly. A number of small internal tweaks have
1219 been made in order to be compatible with that release.
1222 - Removed the use of UNIVERSAL::require to be a better
1223 symbol table citizen and remove a dependency
1224 (thanks Adam Kennedy)
1226 **~~ removed experimental & undocumented feature ~~**
1227 - commented out the 'method' and 'self' keywords, see the
1228 comments for more info.
1231 - added a FAQ and WTF files to document frequently
1232 asked questions and common problems
1234 * Moose::Util::TypeConstraints
1235 - added GlobRef and FileHandle type constraint
1236 - added tests for this
1238 * Moose::Meta::Attribute
1239 - if your attribute 'isa' ArrayRef of HashRef, and you have
1240 not explicitly set a default, then make the default DWIM.
1241 This will also work for subtypes of ArrayRef and HashRef
1243 - you can now auto-deref subtypes of ArrayRef or HashRef too.
1244 - new test added for this (thanks to ashley)
1247 - added basic support for runtime role composition
1248 but this is still *highly experimental*, so feedback
1249 is much appreciated :)
1250 - added tests for this
1252 * Moose::Meta::TypeConstraint
1253 - the type constraint now handles the coercion process
1254 through delegation, this is to support the coercion
1257 * Moose::Meta::TypeConstraint::Union
1258 - it is now possible for coercions to be performed
1260 - added tests for this (thanks to konobi)
1262 * Moose::Meta::TypeCoercion
1263 - properly capturing error when type constraint
1267 - Scalar::Util 1.18 is bad on Win32, so temporarily
1268 only require version 1.17 for Win32 and cygwin.
1269 (thanks Adam Kennedy)
1271 0.12 Sat. Sept. 1, 2006
1273 - Recipe5 (subtypes & coercion) has been written
1276 - fixed "bad meta" error message to be more descriptive
1277 - fixed &unimport to not remove the &inner and &super
1278 keywords because we need to localize them.
1279 - fixed number of spelling/grammer issues, thanks Theory :)
1281 **~~ experimental & undocumented feature ~~**
1282 - added the method and self keywords, they are basically
1283 just sugar, and they may not stay around.
1286 - added &dump method to easily Data::Dumper
1289 * Moose::Meta::TypeConstraint
1290 - added the &is_a_type_of method to check both the current
1291 and the subtype of a method (similar to &isa with classes)
1294 - this is now a subclass of Class::MOP::Module, and no longer
1295 creates the _role_meta ugliness of before.
1296 - fixed tests to reflect this change
1298 0.11 Wed. July 12, 2006
1300 - added an &unimport method to remove all the keywords
1301 that Moose will import, simply add 'no Moose' to the
1302 bottom of your class file.
1305 - fixed some test failures caused by a forgotten test
1308 0.10 Thurs. July 6, 2006
1310 - improved error message when loading modules so
1311 it is less confusing when you load a role.
1312 - added &calculate_all_roles method to
1313 Moose::Meta::Class and Moose::Meta::Role
1316 This module has been tested against Class::MOP 0.30
1317 but it does not yet utilize the optimizations
1318 it makes available. Stay tuned for that ;)
1320 0.09_03 Fri. June 23, 2006
1321 ++ DEVELOPER RELEASE ++
1323 - 'use strict' and 'use warnings' are no longer
1324 needed in Moose classes, Moose itself will
1325 turn them on for you.
1326 - added tests for this
1327 - moved code from exported subs to private methods
1328 in Moose::Meta::Class
1331 - as with Moose, strict and warnings are
1332 automatically turned on for you.
1333 - added tests for this
1336 - now handles an edge case for override errors
1337 - added tests for this
1338 - added some more edge case tests
1340 0.09_02 Tues. May 16, 2006
1341 ++ DEVELOPER RELEASE ++
1343 - added prototypes to the exported subs
1347 - added prototypes to the exported subs
1350 * Moose::Util::TypeConstraints
1351 - cleaned up prototypes for the subs
1354 0.09_01 Fri. May 12, 2006
1355 ++ DEVELOPER RELEASE ++
1356 - This release works in combination with
1357 Class::MOP 0.29_01, it is a developer
1358 release because it uses the a new
1359 instance sub-protocol and a fairly
1360 complete Role implementation. It has
1361 not yet been optimized, so it slower
1362 the the previous CPAN version. This
1363 release also lacks good updated docs,
1364 the official release will have updated docs.
1367 - refactored the keyword exports
1368 - 'with' now checks Role validaity and
1369 accepts more than one Role at a time
1370 - 'extends' makes metaclass adjustments as
1371 needed to ensure metaclass compatability
1374 - refactored the keyword exports
1375 - 'with' now checks Role validaity and
1376 accepts more than one Role at a time
1378 * Moose::Util::TypeConstraints
1379 - added the 'enum' keyword for simple
1380 string enumerations which can be used as
1382 - see example of usage in t/202_example.t
1385 - more careful checking of params to new()
1388 - much work done on the role composition
1389 - many new tests for conflict detection
1390 and composition edge cases
1391 - not enough documentation, I suggest
1392 looking at the tests
1394 * Moose::Meta::Instance
1395 - added new Instance metaclass to support
1396 the new Class::MOP instance protocol
1398 * Moose::Meta::Class
1399 - some small changes to support the new
1401 - some small additions to support Roles
1403 * Moose::Meta::Attribute
1404 - some improvements to the accessor generation code
1406 - some small changes to support the new
1408 - (still somewhat) experimental delegation support
1409 with the 'handles' option
1410 - added several tests for this
1411 - no docs for this yet
1413 0.05 Thurs. April 27, 2006
1415 - keywords are now exported with Sub::Exporter
1416 thanks to chansen for this commit
1417 - has keyword now takes a 'metaclass' option
1418 to support custom attribute meta-classes
1419 on a per-attribute basis
1420 - added tests for this
1421 - the 'has' keyword not accepts inherited slot
1422 specifications (has '+foo'). This is still an
1423 experimental feature and probably not finished
1424 see t/038_attribute_inherited_slot_specs.t for
1425 more details, or ask about it on #moose
1426 - added tests for this
1429 - keywords are now exported with Sub::Exporter
1431 * Moose::Utils::TypeConstraints
1432 - reorganized the type constraint hierarchy, thanks
1433 to nothingmuch and chansen for his help and advice
1435 - added some tests for this
1436 - keywords are now exported with Sub::Exporter
1437 thanks to chansen for this commit
1439 * Moose::Meta::Class
1440 - due to changes in Class::MOP, we had to change
1441 construct_instance (for the better)
1443 * Moose::Meta::Attribute
1444 - due to changes in Class::MOP, we had to add the
1445 initialize_instance_slot method (it's a good thing)
1447 * Moose::Meta::TypeConstraint
1448 - added type constraint unions
1449 - added tests for this
1450 - added the is_subtype_of predicate method
1451 - added tests for this
1453 0.04 Sun. April 16th, 2006
1455 - Roles can now consume other roles
1456 - added tests for this
1457 - Roles can specify required methods now with
1458 the requires() keyword
1459 - added tests for this
1462 - ripped out much of it's guts ,.. much cleaner now
1463 - added required methods and correct handling of
1464 them in apply() for both classes and roles
1465 - added tests for this
1466 - no longer adds a does() method to consuming classes
1467 it relys on the one in Moose::Object
1468 - added roles attribute and some methods to support
1469 roles consuming roles
1471 * Moose::Meta::Attribute
1472 - added support for triggers on attributes
1473 - added tests for this
1474 - added support for does option on an attribute
1475 - added tests for this
1477 * Moose::Meta::Class
1478 - added support for attribute triggers in the
1480 - added tests for this
1483 - Moose no longer creates a subtype for your class
1484 if a subtype of the same name already exists, this
1485 should DWIM in 99.9999% of all cases
1487 * Moose::Util::TypeConstraints
1488 - fixed bug where incorrect subtype conflicts were
1490 - added test for this
1493 - this class can now be extended with 'use base' if
1494 you need it, it properly loads the metaclass class now
1495 - added test for this
1497 0.03_02 Wed. April 12, 2006
1499 - you must now explictly use Moose::Util::TypeConstraints
1500 it no longer gets exported for you automatically
1503 - new() now accepts hash-refs as well as key/value lists
1504 - added does() method to check for Roles
1505 - added tests for this
1507 * Moose::Meta::Class
1508 - added roles attribute along with the add_role() and
1510 - added tests for this
1513 - now adds a does() method to consuming classes
1514 which tests the class's hierarchy for roles
1515 - added tests for this
1517 0.03_01 Mon. April 10, 2006
1519 - added new Role recipe (no content yet, only code)
1522 - added 'with' keyword for Role support
1523 - added test and docs for this
1524 - fixed subtype quoting bug
1525 - added test for this
1529 - added test and docs
1531 * Moose::Util::TypeConstraints
1532 - added the message keyword to add custom
1533 error messages to type constraints
1536 - the meta role to support Moose::Role
1537 - added tests and docs
1539 * Moose::Meta::Class
1540 - moved a number of things from Moose.pm
1541 to here, they should have been here
1544 * Moose::Meta::Attribute
1545 - moved the attribute option macros here
1546 instead of putting them in Moose.pm
1548 * Moose::Meta::TypeConstraint
1549 - added the message attributes and the
1551 - added tests and docs for this
1553 0.03 Thurs. March 30, 2006
1555 - added the Moose::Cookbook with 5 recipes,
1556 describing all the stuff Moose can do.
1559 - fixed an issue with &extends super class loading
1560 it now captures errors and deals with inline
1561 packages correctly (bug found by mst, solution
1563 - added super/override & inner/augment features
1564 - added tests and docs for these
1567 - BUILDALL now takes a reference of the %params
1568 that are passed to &new, and passes that to
1571 * Moose::Util::TypeConstraints
1572 - Type constraints now survive runtime reloading
1573 - added test for this
1575 * Moose::Meta::Class
1576 - fixed the way attribute defaults are handled
1577 during instance construction (bug found by chansen)
1579 * Moose::Meta::Attribute
1580 - read-only attributes now actually enforce their
1581 read-only-ness (this corrected in Class::MOP as
1584 0.02 Tues. March 21, 2006
1586 - many more tests, fixing some bugs and
1588 - &extends now loads the base module with
1590 - added UNIVERSAL::require to the
1593 - each new Moose class will also create
1594 and register a subtype of Object which
1595 correspond to the new Moose class.
1596 - the 'isa' option in &has now only
1597 accepts strings, and will DWIM in
1600 * Moose::Util::TypeConstraints
1601 - added type coercion features
1602 - added tests for this
1603 - added support for this in attributes
1604 and instance construction
1606 - type construction no longer creates a
1607 function, it registers the type instead.
1608 - added several functions to get the
1612 - BUILDALL and DEMOLISHALL were broken
1613 because of a mis-named hash key, Whoops :)
1615 * Moose::Meta::Attribute
1616 - adding support for coercion in the
1617 autogenerated accessors
1619 * Moose::Meta::Class
1620 - adding support for coercion in the
1621 instance construction
1623 * Moose::Meta::TypeConstraint
1624 * Moose::Meta::TypeCoercion
1625 - type constraints and coercions are now
1626 full fledges meta-objects
1628 0.01 Wed. March 15, 2006
1629 - Moooooooooooooooooose!!!