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 * Moose::Cookbook::Extending::Recipe2
10 - Add a _remove_keywords function so if you extend Moose
11 you don't have to cargo cult Moose's unimport (Sartak)
14 - Moose now warns when you try to have it export its sugar
15 functions into the "main" package. Previously it silently did
16 nothing. (Dave Rolsky)
18 0.55 Sun August 3, 2008
19 * Moose::Meta::Attribute
20 - breaking down the way 'handles' methods are
21 created so that the process can be more easily
22 overridden by subclasses (stevan)
24 * Moose::Meta::TypeConstraint
25 - fixing what is passed into a ->message with
26 the type constraints (RT #37569)
27 - added tests for this (Charles Alderman)
29 * Moose::Util::TypeConstraints
30 - fix coerce to accept anon types like subtype can (mst)
33 - reorganized the recipes into sections - Basics, Roles, Meta,
34 Extending - and wrote abstracts for each section (Dave Rolsky)
36 * Moose::Cookbook::Basics::Recipe10
37 - A new recipe that demonstrates operator overloading
38 in combination with Moose. (bluefeet)
40 * Moose::Cookbook::Meta::Recipe1
41 - an introduction to what meta is and why you'd want to make
42 your own metaclass extensions (Dave Rolsky)
44 * Moose::Cookbook::Meta::Recipe4
45 - a very simple metaclass example (Dave Rolsky)
47 * Moose::Cookbook::Extending::Recipe1
48 - how to write a Moose-alike module to use your own object base
51 * Moose::Cookbook::Extending::Recipe2
52 - how to write modules with an API just like C<Moose.pm> (Dave
56 - Tons of fixes, both syntactical and grammatical (Dave
59 0.54 Thurs. July 3, 2008
60 ... this is not my day today ...
62 * Moose::Meta::Attribute
63 - fixed legal_options_for_inheritance such that
64 clone_and_inherit options still works for
65 Class::MOP::Attribute objects and therefore
66 does not break MooseX::AttributeHelpers
69 0.53 Thurs. July 3, 2008
70 * Whoops, I guess I should run 'make manifest' before
71 actually releasing the module. No actual changes
72 in this release, except the fact that it includes
73 the changes that I didn't include in the last
76 0.52 Thurs. July 3, 2008
78 - added "FEATURE REQUESTS" section to the Moose docs
79 to properly direct people (stevan) (RT #34333)
80 - making 'extends' croak if it is passed a Role since
81 this is not ever something you want to do
82 (fixed by stevan, found by obra)
83 - added tests for this (stevan)
86 - adding support for DOES (as in UNIVERSAL::DOES)
90 * Moose::Meta::Attribute
91 - added legal_options_for_inheritance (wreis)
92 - added tests for this (wreis)
94 * Moose::Cookbook::Snacks::*
95 - removed some of the unfinished snacks that should
96 not have been released yet. Added some more examples
97 to the 'Keywords' snack. (stevan)
99 * Moose::Cookbook::Style
100 - added general Moose "style guide" of sorts to the
101 cookbook (nothingmuch) (RT #34335)
104 - added more BUILDARGS tests (stevan)
106 0.51 Thurs. Jun 26, 2008
108 - add unimport so "no Moose::Role" actually does
111 * Moose::Meta::Role::Application::ToRole
112 - when RoleA did RoleB, and RoleA aliased a method from RoleB in
113 order to provide its own implementation, that method still got
114 added to the list of required methods for consumers of
115 RoleB. Now an aliased method is only added to the list of
116 required methods if the role doing the aliasing does not
117 provide its own implementation. See Recipe 11 for an example
118 of all this. (Dave Rolsky)
119 - added tests for this
121 * Moose::Meta::Method::Constructor
122 - when a single argument that wasn't a hashref was provided to
123 an immutabilized constructor, the error message was very
124 unhelpful, as opposed to the non-immutable error. Reported by
126 - added test for this (Dave Rolsky)
128 * Moose::Meta::Attribute
129 - added support for meta_attr->does("ShortAlias") (sartak)
130 - added tests for this (sartak)
131 - moved the bulk of the `handles` handling to the new
132 install_delegation method (Stevan)
135 - Added BUILDARGS, a new step in new()
137 * Moose::Meta::Role::Application::RoleSummation
138 - fix typos no one ever sees (sartak)
140 * Moose::Util::TypeConstraints
141 * Moose::Meta::TypeConstraint
142 * Moose::Meta::TypeCoercion
143 - Attempt to work around the ??{ } vs. threads issue
145 - Some null_constraint optimizations
147 0.50 Thurs. Jun 11, 2008
148 - Fixed a version number issue by bumping all modules
151 0.49 Thurs. Jun 11, 2008
152 !! This version now approx. 20-25% !!
153 !! faster with new Class::MOP 0.59 !!
155 * Moose::Meta::Attribute
156 - fixed how the is => (ro|rw) works with
157 custom defined reader, writer and accessor
159 - added docs for this (TODO).
160 - added tests for this (Thanks to Penfold)
161 - added the custom attribute alias for regular
162 Moose attributes which is "Moose"
163 - fix builder and default both being used
168 Moose::Meta::Attribute
170 Moose::Meta::Role::Composite
171 Moose::Util::TypeConstraints
172 - switched usage of reftype to ref because
176 - changing add_package_symbol to use the new
180 - fixed how DEMOLISHALL is called so that it
181 can be overrided in subclasses (thanks to Sartak)
182 - added test for this (thanks to Sartak)
184 * Moose::Util::TypeConstraints
185 - move the ClassName type check code to
186 Class::MOP::is_class_loaded (thanks to Sartak)
188 * Moose::Cookbook::Recipe11
189 - add tests for this (thanks to tokuhirom)
191 0.48 Thurs. May 29, 2008
192 (early morning release engineering)--
194 - fixing the version in Moose::Meta::Method::Destructor
195 which was causing the indexer to choke
197 0.47 Thurs. May 29, 2008
198 (late night release engineering)--
200 - fixing the version is META.yml, no functional
201 changes in this release
203 0.46 Wed. May 28, 2008
204 !! This version now approx. 20-25% !!
205 !! faster with new Class::MOP 0.57 !!
208 - some optimizations of the &initialize method
209 since it is called so often by &meta
213 - now use the get_all_package_symbols from the
214 updated Class::MOP, test suite is now 10 seconds
217 * Moose::Meta::Method::Destructor
218 - is_needed can now also be called as a class
219 method for immutablization to check if the
220 destructor object even needs to be created
223 * Moose::Meta::Method::Destructor
224 Moose::Meta::Method::Constructor
225 - added more descriptive error message to help
226 keep people from wasting time tracking an error
227 that is easily fixed by upgrading.
229 0.45 Saturday, May 24, 2008
231 - Because of work in Class::MOP 0.56, all
232 XS based functionality is now optional
233 and a Pure Perl version is supplied
234 - the CLASS_MOP_NO_XS environment variable
235 can now be used to force non-XS versions
237 - several of the packages have been tweaked
238 to take care of this, mostly we added
239 support for the package_name and name
240 variables in all the Method metaclasses
241 - before/around/after method modifiers now
242 support regexp matching of names
243 (thanks to Takatoshi Kitano)
244 - tests added for this
245 - NOTE: this only works for classes, it
246 is currently not supported in roles,
247 but, ... patches welcome
248 - All usage of Carp::confess have been replaced
249 by Carp::croak in the "keyword" functions since
250 the stack trace is usually not helpful
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
256 - The 'has' keyword for roles now accepts the
257 same array ref form that Moose.pm does
258 (has [qw/foo bar/] => (is => 'rw', ...))
259 - added test for this
261 * Moose::Meta::Attribute
262 - trigger on a ro-attribute is no longer an
263 error, as it's useful to trigger off of the
267 - added same 'add_package_symbol' fix as in
271 - does_role now handles non-Moose classes
273 - added tests for this
274 - added the 'add_method_modifier' function
275 (thanks to Takatoshi Kitano)
277 * Moose::Util::TypeConstraints
278 - subtypes of parameterizable types now are
279 themselves parameterizable types
281 * Moose::Meta::Method::Constructor
282 - fixed bug where trigger was not being
283 called by the inlined immutable
285 - added test for this (thanks to Caelum)
287 * Moose::Meta::Role::Application::ToInstance
288 - now uses the metaclass of the instance
289 (if possible) to create the anon-class
290 (thanks Jonathan Rockway)
292 * Moose::Cookbook::Recipe22
293 - added the meta-attribute trait recipe
297 - fixed hash-ordering test bug that was
298 causing occasional cpantester failures
299 - renamed the t/000_recipe/*.t tests to be
300 more descriptive (thanks to Sartak)
302 0.44 Sat. May 10, 2008
304 - made make_immutable warning cluck to
305 show where the error is (thanks mst)
308 - BUILDALL and DEMOLISHALL now call
309 ->body when looping through the
310 methods, to avoid the overloaded
312 - fixed issue where DEMOLISHALL was
313 eating the $@ values, and so not
314 working correctly, it still kind of
315 eats them, but so does vanilla perl
316 - added tests for this
318 * Moose::Cookbook::Recipe7
319 - added new recipe for immutable
320 functionality (thanks Dave Rolsky)
322 * Moose::Cookbook::Recipe9
323 - added new recipe for builder and
324 lazy_build (thanks Dave Rolsky)
326 * Moose::Cookbook::Recipe11
327 - added new recipe for method aliasing
328 and exclusion with Roles (thanks Dave Rolsky)
331 - fixed Win32 test failure (thanks spicyjack)
333 ~ removed Build.PL and Module::Build compat
334 since Module::Install has done that.
336 0.43 Wed. April, 30, 2008
338 drink more coffee before
339 doing release engineering
341 - whoops, forgot to do the smolder tests,
342 and we broke some of the custom meta-attr
343 modules. This fixes that.
345 0.42 Mon. April 28, 2008
346 - some bad tests slipped by, nothing else
347 changed in this release (cpantesters++)
349 - upped the Class::MOP dependency to 0.55
350 since we have tests which need the C3
353 0.41 Mon. April 28, 2008
354 ~~ numerous documentation updates ~~
356 - Changed all usage of die to Carp::croak for better
357 error reporting (initial patch by Tod Hagan)
360 - the make_immutable keyword is now deprecated, don't
361 use it in any new code and please fix your old code
362 as well. There will be 2 releases, and then it will
368 - refactored the way inner and super work to avoid
369 any method/@ISA cache penalty (nothingmuch)
372 - fixing &new_object to make sure trigger gets the
373 coerced value (spotted by Charles Alderman on the
375 - added test for this
377 * Moose::Meta::Method::Constructor
378 - immutable classes which had non-lazy attributes were calling
379 the default generating sub twice in the constructor. (bug
380 found by Jesse Luehrs, fixed by Dave Rolsky)
381 - added tests for this (Dave Rolsky)
382 - fix typo in initialize_body method (nothingmuch)
384 * Moose::Meta::Method::Destructor
385 - fix typo in initialize_body method (nothingmuch)
387 * Moose::Meta::Method::Overriden
388 Moose::Meta::Method::Augmented
389 - moved the logic for these into their own
390 classes (nothingmuch)
392 * Moose::Meta::Attribute
393 - inherited attributes may now be extended without
394 restriction on the type ('isa', 'does') (Sartak)
395 - added tests for this (Sartak)
396 - when an attribute property is malformed (such as lazy without
397 a default), give the name of the attribute in the error
399 - added the &applied_traits and &has_applied_traits methods
400 to allow introspection of traits
401 - added tests for this
402 - moved 'trait' and 'metaclass' argument handling to here from
404 - clone_and_inherit_options now handles 'trait' and 'metaclass' (has
405 '+foo' syntax) (nothingmuch)
406 - added tests for this (t0m)
409 - localize $@ inside DEMOLISHALL to avoid it
410 eating $@ (found by Ernesto)
411 - added test for this (thanks to Ernesto)
413 * Moose::Util::TypeConstraints
414 - &find_type_constraint now DWIMs when given an
415 type constraint object or name (nothingmuch)
416 - &find_or_create_type_constraint superseded with a number of more
418 - find_or_create_{isa,does}_type_constraint
419 - find_or_parse_type_constraint
421 * Moose::Meta::TypeConstraint
422 Moose::Meta::TypeConstraint::Class
423 Moose::Meta::TypeConstraint::Role
424 Moose::Meta::TypeConstraint::Enum
425 Moose::Meta::TypeConstraint::Union
426 Moose::Meta::TypeConstraint::Parameterized
427 - added the &equals method for comparing two type
428 constraints (nothingmuch)
429 - added tests for this (nothingmuch)
431 * Moose::Meta::TypeConstraint
432 - add the &parents method, which is just an alias to &parent.
433 Useful for polymorphism with TC::{Class,Role,Union} (nothingmuch)
435 * Moose::Meta::TypeConstraint::Class
436 - added the class attribute for introspection purposes
438 - added tests for this
440 * Moose::Meta::TypeConstraint::Enum
441 Moose::Meta::TypeConstraint::Role
442 - broke these out into their own classes (nothingmuch)
444 * Moose::Cookbook::Recipe*
445 - fixed references to test file locations in the POD
446 and updated up some text for new Moose features
450 - Added &resolve_metaclass_alias, a helper function for finding an actual
451 class for a short name (e.g. in the traits list)
453 0.40 Fri. March 14, 2008
454 - I hate Pod::Coverage
456 0.39 Fri. March 14, 2008
458 - documenting the use of '+name' with attributes
459 that come from recently composed roles. It makes
460 sense, people are using it, and so why not just
461 officially support it.
462 - fixing the 'extends' keyword so that it will not
463 trigger Ovid's bug (http://use.perl.org/~Ovid/journal/35763)
466 - added the perl -Moose=+Class::Name feature to allow
467 monkeypatching of classes in one liners
470 - fixing the 'apply_all_roles' keyword so that it will not
471 trigger Ovid's bug (http://use.perl.org/~Ovid/journal/35763)
474 - added ->create method which now supports roles (thanks to jrockway)
475 - added tests for this
476 - added ->create_anon_class which now supports roles and caching of
477 the results (thanks to jrockway)
478 - added tests for this
479 - made ->does_role a little more forgiving when it is
480 checking a Class::MOP era metaclasses.
482 * Moose::Meta::Role::Application::ToInstance
483 - it is now possible to pass extra params to be used when
484 a role is applied to an the instance (rebless_params)
485 - added tests for this
487 * Moose::Util::TypeConstraints
488 - class_type now accepts an optional second argument for a
489 custom message. POD anotated accordingly (groditi)
490 - added tests for this
491 - it is now possible to make anon-enums by passing 'enum' an
492 ARRAY ref instead of the $name => @values. Everything else
494 - added tests for this
497 - making test for using '+name' on attributes consumed
498 from a role, it works and makes sense too.
500 * Moose::Meta::Attribute
501 - fix handles so that it doesn't return nothing
502 when the method cannot be found, not sure why
503 it ever did this originally, this means we now
504 have slightly better support for AUTOLOADed
506 - added more delegation tests
507 - adding ->does method to this so as to better
508 support traits and their introspection.
509 - added tests for this
512 - localizing the Data::Dumper configurations so
513 that it does not pollute others (RT #33509)
514 - made ->does a little more forgiving when it is
515 passed Class::MOP era metaclasses.
517 0.38 Fri. Feb. 15, 2008
518 * Moose::Meta::Attribute
519 - fixed initializer to correctly do
520 type checking and coercion in the
522 - added tests for this
525 - fixed some finicky tests (thanks to konobi)
527 0.37 Thurs. Feb. 14, 2008
529 - fixed some details in Moose::init_meta
530 and its superclass handling (thanks thepler)
531 - added tests for this (thanks thepler)
532 - 'has' now dies if you don't pass in name
534 - added the 'make_immutable' keyword as a shortcut
538 Moose::Meta::Method::Constructor
539 Moose::Meta::Attribute
540 - making (init_arg => undef) work here too
541 (thanks to nothingmuch)
543 * Moose::Meta::Attribute
544 Moose::Meta::Method::Constructor
545 Moose::Meta::Method::Accessor
546 - make lazy attributes respect attr initializers (rjbs)
547 - added tests for this
549 * Moose::Util::TypeConstraints
550 Moose::Util::TypeConstraints::OptimizedConstraints
551 Moose::Meta::TypeConstraints
552 Moose::Meta::Attribute
553 Moose::Meta::Method::Constructor
554 Moose::Meta::Method::Accessor
555 - making type errors use the
556 assigned message (thanks to Sartak)
557 - added tests for this
559 * Moose::Meta::Method::Destructor
560 - making sure DESTROY gets inlined properly
561 with successive DEMOLISH calls (thanks to manito)
563 * Moose::Meta::Attribute
564 Moose::Meta::Method::Accessor
565 - fixed handling of undef with type constraints
567 - added tests for this
570 - added &get_all_init_args and &get_all_attribute_values
571 (thanks to Sartak and nothingmuch)
573 0.36 Sat. Jan. 26, 2008
575 Moose::Meta::Attribute
576 - role type tests now support when roles are
577 applied to non-Moose classes (found by ash)
578 - added tests for this (thanks to ash)
579 - couple extra tests to boost code coverage
581 * Moose::Meta::Method::Constructor
582 - improved fix for handling Class::MOP attributes
583 - added test for this
586 - handled the add_attribute($attribute_meta_object)
588 - added test for this
590 0.35 Tues. Jan. 22, 2008
591 * Moose::Meta::Method::Constructor
592 - fix to make sure even Class::MOP attributes
593 are handled correctly (Thanks to Dave Rolsky)
594 - added test for this (also Dave Rolsky)
597 - improved error message on _apply_all_roles,
598 you should now use Moose::Util::apply_all_roles
599 and you shouldnt have been using a _ prefixed
600 method in the first place ;)
602 0.34 Mon. Jan. 21, 2008
603 ~~~ more misc. doc. fixes ~~~
604 ~~ updated copyright dates ~~
606 Moose is now a postmodern object system :)
607 - (see the POD for details)
609 * <<Role System Refactoring>>
610 - this release contains a major reworking and
611 cleanup of the role system
612 - 100% backwards compat.
613 - Role application now restructured into seperate
614 classes based on type of applicants
615 - Role summation (combining of more than one role)
616 is much cleaner and anon-classes are no longer
618 - new Composite role metaclass
619 - runtime application of roles to instances
620 is now more efficient and re-uses generated
621 classes when applicable
623 * <<New Role composition features>>
624 - methods can now be excluded from a given role
626 - methods can now be aliased to another name (and
627 still retain the original as well)
629 * Moose::Util::TypeConstraints::OptimizedConstraints
630 - added this module (see above)
633 - fixed the &_process_attribute method to be called
634 by &add_attribute, so that the API is now correct
636 * Moose::Meta::Method::Accessor
637 - fixed bug when passing a list of values to
638 an accessor would get (incorrectly) ignored.
639 Thanks to Sartak for finding this ;)
640 - added tests for this (Sartak again)
642 * Moose::Meta::Method::Accessor
643 Moose::Meta::Method::Constructor
644 Moose::Meta::Attribute
645 Moose::Meta::TypeConstraint
646 Moose::Meta::TypeCoercion
647 - lots of cleanup of such things as:
649 - type constraint handling
650 - error handling/messages
651 (thanks to nothingmuch)
653 * Moose::Meta::TypeConstraint::Parameterizable
654 - added this module to support the refactor
655 in Moose::Meta::TypeConstraint::Parameterized
657 * Moose::Meta::TypeConstraint::Parameterized
658 - refactored how these types are handled so they
659 are more generic and not confined to ArrayRef
663 - shortened some file names for better VMS support (RT #32381)
665 0.33 Fri. Dec. 14, 2007
666 !! Moose now loads 2 x faster !!
667 !! with new Class::MOP 0.49 !!
669 ++ new oose.pm module to make command line
670 Moose-ness easier (see POD docs for more)
674 - several tweaks to take advantage of the
675 new method map caching in Class::MOP
677 * Moose::Meta::TypeConstraint::Parameterized
678 - allow subtypes of ArrayRef and HashRef to
679 be used as a container (sartak)
680 - added tests for this
681 - basic support for coercion to ArrayRef and
682 HashRef for containers (sartak)
683 - added tests for this
685 * Moose::Meta::TypeCoercion
686 - coercions will now create subtypes as needed
687 so you can now add coercions to parameterized
688 types without having to explictly define them
689 - added tests for this
691 * Moose::Meta::Method::Accessor
692 - allow subclasses to decide whether we need
693 to copy the value into a new variable (sartak)
695 0.32 Tues. Dec. 4, 2007
696 * Moose::Util::TypeConstraints
697 - fixing how subtype aliases of unions work
698 they should inherit the parent's coercion
699 - added tests for this
700 - you can now define multiple coercions on
701 a single type at different times instead of
702 having to do it all in one place
703 - added tests for this
705 * Moose::Meta::TypeConstraint
706 - there is now a default constraint of sub { 1 }
707 instead of Moose::Util::TypeConstraints setting
710 * Moose::Meta::TypeCoercion
711 * Moose::Meta::TypeCoercion::Union
712 - added the &has_coercion_for_type and
713 &add_type_coercions methods to support the
714 new features above (although you cannot add
715 more type coercions for Union types)
717 0.31 Mon. Nov. 26, 2007
718 * Moose::Meta::Attribute
719 - made the +attr syntax handle extending types with
720 parameters. So "has '+foo' => (isa => 'ArrayRef[Int]')"
721 now works if the original foo is an ArrayRef.
722 - added tests for this.
723 - delegation now works even if the attribute does not
724 have a reader method using the get_read_method_ref
725 method from Class::MOP::Attribute.
726 - added tests for this
727 - added docs for this
729 * Moose::Util::TypeConstraints
730 - passing no "additional attribute info" to
731 &find_or_create_type_constraint will no longer
732 attempt to create an __ANON__ type for you,
733 instead it will just return undef.
734 - added docs for this
736 0.30 Fri. Nov. 23, 2007
737 * Moose::Meta::Method::Constructor
738 -builder related bug in inlined constructor. (groditi)
740 * Moose::Meta::Method::Accessor
741 - genereate unnecessary calls to predicates and refactor
742 code generation for runtime speed (groditi)
744 * Moose::Util::TypeConstraints
745 - fix ClassName constraint to introspect symbol table (mst)
746 - added more tests for this (mst)
747 - fixed it so that subtype 'Foo' => as 'HashRef[Int]' ...
749 - added tests for this
752 - adding the link to Recipie 11 (written by Sartak)
753 - adding test for SYNOPSIS code
756 - New tests for builder bug. Upon instantiation, if an
757 attribute had a builder, no value and was not lazy the
758 builder default was not getting run, oops. (groditi)
760 0.29 Tues. Nov. 13, 2007
761 * Moose::Meta::Attribute
762 - Fix error message on missing builder method (groditi)
764 * Moose::Meta::Method::Accessor
765 - Fix error message on missing builder method (groditi)
768 - Add test to check for the correct error message when
769 builder method is missing (groditi)
771 0.28 Tues. Nov. 13, 2007
772 - 0.27 packaged incorrectly (groditi)
774 0.27 Tues. Nov. 13, 2007
775 * Moose::Meta::Attribute
776 - Added support for the new builder option (groditi)
777 - Added support for lazy_build option (groditi)
778 - Changed slot initialization for predicate changes (groditi)
780 * Moose::Meta::Method::Accessor
781 - Added support for lazy_build option (groditi)
782 - Fix inline methods to work with corrected predicate
785 * Moose::Meta::Method::Constructor
786 - Added support for lazy_build option (groditi)
789 - tests for builder and lazy_build (groditi)
791 * fixing some misc. bits in the docs that
792 got mentioned on CPAN Forum & perlmonks
795 - fixed how required methods are handled
796 when they encounter overriden or modified
797 methods from a class (thanks to confound).
798 - added tests for this
800 * Moose::Util::TypeConstraint
801 - fixed the type notation parser so that
802 the | always creates a union and so is
803 no longer a valid type char (thanks to
804 konobi, mugwump and #moose for working
806 - added more tests for this
808 0.26 Thurs. Sept. 27, 2007
811 * Parameterized Types
812 We now support parameterized collection types, such as:
813 ArrayRef[Int] # array or integers
814 HashRef[Object] # a hash with object values
815 They can also be nested:
816 ArrayRef[HashRef[RegExpr]] # an array of hashes with regexpr values
817 And work with the type unions as well:
818 ArrayRef[Int | Str] # array of integers of strings
820 * Better Framework Extendability
821 Moose.pm is now "extendable" such that it is now much
822 easier to extend the framework and add your own keywords
823 and customizations. See the "EXTENDING AND EMBEDDING MOOSE"
824 section of the Moose.pm docs.
827 In an effort to begin documenting some of the various
828 details of Moose as well as some common idioms, we have
829 created Moose::Cookbook::Snacks as a place to find
830 small (easily digestable) nuggets of Moose code.
833 ~ Several doc updates/cleanup thanks to castaway ~
835 - converted build system to use Module::Install instead of
836 Module::Build (thanks to jrockway)
839 - added all the meta classes to the immutable list and
840 set it to inline the accessors
841 - fix import to allow Sub::Exporter like { into => }
842 and { into_level => } (perigrin)
843 - exposed and documented init_meta() to allow better
844 embedding and extending of Moose (perigrin)
847 - complete re-organization of the test suite
848 - added some new tests as well
849 - finally re-enabled the Moose::POOP test since
850 the new version of DBM::Deep now works again
854 - fixed very odd and very nasty recursion bug with
856 - added tests for this (eilara)
858 * Moose::Meta::Attribute
859 Moose::Meta::Method::Constructor
860 Moose::Meta::Method::Accessor
861 - fixed issue with overload::Overloaded getting called
862 on non-blessed items. (RT #29269)
863 - added tests for this
865 * Moose::Meta::Method::Accessor
866 - fixed issue with generated accessor code making
867 assumptions about hash based classes (thanks to dexter)
869 * Moose::Coookbook::Snacks
870 - these are bits of documentation, not quite as big as
871 Recipes but which have no clear place in the module docs.
872 So they are Snacks! (horray for castaway++)
874 * Moose::Cookbook::Recipe4
875 - updated it to use the new ArrayRef[MyType] construct
876 - updated the accompanying test as well
878 +++ Major Refactor of the Type Constraint system +++
879 +++ with new features added as well +++
881 * Moose::Util::TypeConstraint
882 - no longer uses package variable to keep track of
883 the type constraints, now uses the an instance of
884 Moose::Meta::TypeConstraint::Registry to do it
885 - added more sophisticated type notation parsing
887 - added tests for this
889 * Moose::Meta::TypeConstraint
890 - some minor adjustments to make subclassing easier
891 - added the package_defined_in attribute so that we
892 can track where the type constraints are created
894 * Moose::Meta::TypeConstraint::Union
895 - this is now been refactored to be a subclass of
896 Moose::Meta::TypeConstraint
898 * Moose::Meta::TypeCoercion::Union
899 - this has been added to service the newly refactored
900 Moose::Meta::TypeConstraint::Union and is itself
901 a subclass of Moose::Meta::TypeCoercion
903 * Moose::Meta::TypeConstraint::Parameterized
904 - added this module (taken from MooseX::AttributeHelpers)
905 to help construct nested collection types
906 - added tests for this
908 * Moose::Meta::TypeConstraint::Registry
909 - added this class to keep track of type constraints
911 0.25 Mon. Aug. 13, 2007
913 - Documentation update to reference Moose::Util::TypeConstraints
914 under 'isa' in 'has' for how to define a new type
917 * Moose::Meta::Attribute
918 - required attributes now will no longer accept undef
919 from the constructor, even if there is a default and lazy
920 - added tests for this
921 - default subroutines must return a value which passes the
923 - added tests for this
925 * Moose::Meta::Attribute
926 * Moose::Meta::Method::Constructor
927 * Moose::Meta::Method::Accessor
928 - type-constraint tests now handle overloaded objects correctly
930 - added tests for this (thanks to EvanCarroll)
932 * Moose::Meta::TypeConstraint::Union
933 - added (has_)hand_optimized_constraint to this class so that
934 it behaves as the regular Moose::Meta::TypeConstraint does.
937 - large refactoring of this code
938 - added several more tests
939 - tests for subtle conflict resolition issues
940 added, but not currently running
943 * Moose::Cookbook::Recipe7
944 - added new recipe for augment/inner functionality
946 - added test for this
949 - a formal definition of roles (still in progress)
952 - utilities for easier working with Moose classes
953 - added tests for these
956 - This contains Moose specific test functions
957 - added tests for these
959 0.24 Tues. July 3, 2007
960 ~ Some doc updates/cleanup ~
962 * Moose::Meta::Attribute
963 - added support for roles to be given as parameters
964 to the 'handles' option.
965 - added tests and docs for this
966 - the has '+foo' attribute form now accepts changes to
967 the lazy option, and the addition of a handles option
968 (but not changing the handles option)
969 - added tests and docs for this
972 - required methods are now fetched using find_method_by_name
973 so that required methods can come from superclasses
974 - adjusted tests for this
976 0.23 Mon. June 18, 2007
977 * Moose::Meta::Method::Constructor
978 - fix inlined constructor for hierarchy with multiple BUILD methods (mst)
980 - Modify make_immutable to work with the new Class::MOP immutable
981 mechanism + POD + very basic test (groditi)
982 * Moose::Meta::Attribute
983 - Fix handles to use goto() so that caller() comes out properly on
984 the other side (perigrin)
986 0.22 Thurs. May 31, 2007
987 * Moose::Util::TypeConstraints
988 - fix for prototype undeclared issue when Moose::Util::TypeConstraints
989 loaded before consumers (e.g. Moose::Meta::Attribute) by predeclaring
990 prototypes for functions
991 - added the ClassName type constraint, this checks for strings
992 which will respond true to ->isa(UNIVERSAL).
993 - added tests and docs for this
994 - subtyping just in name now works correctly by making the
995 default for where be { 1 }
996 - added test for this
998 * Moose::Meta::Method::Accessor
999 - coerce and lazy now work together correctly, thanks to
1000 merlyn for finding this bug
1001 - tests added for this
1002 - fix reader presedence bug in Moose::Meta::Attribute + tests
1005 - Foo->new(undef) now gets ignored, it is assumed you meant to pass
1006 a HASH-ref and missed. This produces better error messages then
1007 having it die cause undef is not a HASH.
1008 - added tests for this
1010 0.21 Thursday, May 2nd, 2007
1012 - added SUPER_SLOT and INNER_SLOT class hashes to support unimport
1013 - modified unimport to remove super and inner along with the rest
1014 - altered unimport tests to handle this
1017 - altered super export to populate SUPER_SLOT
1019 * Moose::Meta::Class
1020 - altered augment and override modifier application to use *_SLOT
1021 - modified tests for these to unimport one test class each to test
1024 - fixed issue where custom attribute metaclasses
1025 where not handled correctly in roles
1026 - added tests for this
1028 * Moose::Meta::Class
1029 - fixed issue where extending metaclasses with
1030 roles would blow up. Thanks to Aankhen`` for
1031 finding this insidious error, and it's solution.
1033 ~~ lots of spelling and grammer fixes in the docs,
1034 many many thanks to rlb3 and Aankhen for these :)
1036 0.20 Friday, April 6th, 2007
1037 >> I messed up the SKIP logic in one test
1038 so this release is just to fix that.
1041 - 'has' now also accepts an ARRAY ref
1042 to create multiple attrs (see docs)
1043 (thanks to konobi for this)
1044 - added tests and docs
1046 0.19 Thurs. April 5th, 2007
1047 ~~ More documentation updates ~~
1049 * Moose::Util::TypeConstraints
1050 - 'type' now supports messages as well
1051 thanks to phaylon for finding this
1052 - added tests for this
1053 - added &list_all_type_constraints and
1054 &list_all_builtin_type_constraints
1055 functions to facilitate introspection.
1057 * Moose::Meta::Attribute
1058 - fixed regexp 'handles' declarations
1059 to build the list of delegated methods
1060 correctly (and not override important
1061 things like &new) thanks to ashleyb
1063 - added tests and docs for this
1064 - added the 'documentation' attributes
1065 so that you can actually document your
1066 attributes and inspect them through the
1068 - added tests and docs for this
1070 * Moose::Meta::Class
1071 - when loading custom attribute metaclasses
1072 it will first look in for the class in the
1073 Moose::Meta::Attribute::Custom::$name, and
1074 then default to just loading $name.
1075 - added tests and docs for this
1077 * Moose::Meta::TypeConstraint
1078 - type constraints now stringify to their names.
1079 - added test for this
1082 - added tests to assure we work with Module::Refresh
1083 - added stricter test skip logic in the Moose POOP
1084 test, ask Rob Kinyon why.
1085 - *cough* DBM::Deep 1.0 backwards compatability sucks *cough* ;)
1087 0.18 Sat. March 10, 2007
1088 ~~ Many, many documentation updates ~~
1091 - We now use Class::MOP::load_class to
1093 - added tests to show types and subtypes
1094 working with Declare::Constraints::Simple
1095 and Test::Deep as constraint engines.
1098 !! You must have Class::MOP 0.37_001 !!
1099 !! for this developer release to work !!
1101 This release was primarily adding the immutable
1102 feature to Moose. An immutable class is one which
1103 you promise not to alter. When you set the class
1104 as immutable it will perform various bits of
1105 memoization and inline certain part of the code
1106 (constructors, destructors and accessors). This
1107 minimizes (and in some cases totally eliminates)
1108 one of Moose's biggest performance hits. This
1109 feature is not on by default, and is 100% optional.
1110 It has several configurable bits as well, so you
1111 can pick and choose to your specific needs.
1113 The changes involved in this were fairly wide and
1114 highly specific, but 100% backwards compatible, so
1115 I am not going to enumerate them here. If you are
1116 truely interested in what was changed, please do
1119 0.17 Tues. Nov. 14, 2006
1120 * Moose::Meta::Method::Accessor
1121 - bugfix for read-only accessors which
1122 are have a type constraint and lazy.
1123 Thanks to chansen for finding it.
1125 0.16 Tues. Nov. 14, 2006
1127 There are some speed improvements in this release,
1128 but they are only the begining, so stay tuned.
1131 - BUILDALL and DEMOLISHALL no longer get
1132 called unless they actually need to be.
1133 This gave us a signifigant speed boost
1134 for the cases when there is no BUILD or
1135 DEMOLISH method present.
1137 * Moose::Util::TypeConstraints
1138 * Moose::Meta::TypeConstraint
1139 - added an 'optimize_as' option to the
1140 type constraint, which allows for a
1141 hand optimized version of the type
1142 constraint to be used when possible.
1143 - Any internally created type constraints
1144 now provide an optimized version as well.
1146 0.15 Sun. Nov. 5, 2006
1148 This version of Moose *must* have Class::MOP 0.36 in order
1149 to work correctly. A number of small internal tweaks have
1150 been made in order to be compatible with that release.
1152 * Moose::Util::TypeConstraints
1153 - added &unimport so that you can clean out
1154 your class namespace of these exported
1157 * Moose::Meta::Class
1158 - fixed minor issue which occasionally
1159 comes up during global destruction
1161 - moved Moose::Meta::Method::Overriden into
1165 - moved Moose::Meta::Role::Method into
1168 * Moose::Meta::Attribute
1169 - changed how we do type checks so that
1170 we reduce the overall cost, but still
1173 - moved accessor generation methods to
1174 Moose::Meta::Method::Accessor to
1175 conform to the API changes from
1178 * Moose::Meta::TypeConstraint
1179 - changed how constraints are compiled
1180 so that we do less recursion and more
1181 iteration. This makes the type check
1183 - moved Moose::Meta::TypeConstraint::Union
1186 * Moose::Meta::Method::Accessor
1187 - created this from methods formerly found in
1188 Moose::Meta::Attribute
1190 * Moose::Meta::Role::Method
1191 - moved this from Moose::Meta::Role
1193 * Moose::Meta::Method::Overriden
1194 - moved this from Moose::Meta::Class
1196 * Moose::Meta::TypeConstraint::Union
1197 - moved this from Moose::Meta::TypeConstraint
1199 0.14 Mon. Oct. 9, 2006
1201 * Moose::Meta::Attribute
1202 - fixed lazy attributes which were not getting
1203 checked with the type constraint (thanks ashley)
1204 - added tests for this
1205 - removed the over-enthusiastic DWIMery of the
1206 automatic ArrayRef and HashRef defaults, it
1207 broke predicates in an ugly way.
1208 - removed tests for this
1210 0.13 Sat. Sept. 30, 2006
1212 This version of Moose *must* have Class::MOP 0.35 in order
1213 to work correctly. A number of small internal tweaks have
1214 been made in order to be compatible with that release.
1217 - Removed the use of UNIVERSAL::require to be a better
1218 symbol table citizen and remove a dependency
1219 (thanks Adam Kennedy)
1221 **~~ removed experimental & undocumented feature ~~**
1222 - commented out the 'method' and 'self' keywords, see the
1223 comments for more info.
1226 - added a FAQ and WTF files to document frequently
1227 asked questions and common problems
1229 * Moose::Util::TypeConstraints
1230 - added GlobRef and FileHandle type constraint
1231 - added tests for this
1233 * Moose::Meta::Attribute
1234 - if your attribute 'isa' ArrayRef of HashRef, and you have
1235 not explicitly set a default, then make the default DWIM.
1236 This will also work for subtypes of ArrayRef and HashRef
1238 - you can now auto-deref subtypes of ArrayRef or HashRef too.
1239 - new test added for this (thanks to ashley)
1242 - added basic support for runtime role composition
1243 but this is still *highly experimental*, so feedback
1244 is much appreciated :)
1245 - added tests for this
1247 * Moose::Meta::TypeConstraint
1248 - the type constraint now handles the coercion process
1249 through delegation, this is to support the coercion
1252 * Moose::Meta::TypeConstraint::Union
1253 - it is now possible for coercions to be performed
1255 - added tests for this (thanks to konobi)
1257 * Moose::Meta::TypeCoercion
1258 - properly capturing error when type constraint
1262 - Scalar::Util 1.18 is bad on Win32, so temporarily
1263 only require version 1.17 for Win32 and cygwin.
1264 (thanks Adam Kennedy)
1266 0.12 Sat. Sept. 1, 2006
1268 - Recipe5 (subtypes & coercion) has been written
1271 - fixed "bad meta" error message to be more descriptive
1272 - fixed &unimport to not remove the &inner and &super
1273 keywords because we need to localize them.
1274 - fixed number of spelling/grammer issues, thanks Theory :)
1276 **~~ experimental & undocumented feature ~~**
1277 - added the method and self keywords, they are basically
1278 just sugar, and they may not stay around.
1281 - added &dump method to easily Data::Dumper
1284 * Moose::Meta::TypeConstraint
1285 - added the &is_a_type_of method to check both the current
1286 and the subtype of a method (similar to &isa with classes)
1289 - this is now a subclass of Class::MOP::Module, and no longer
1290 creates the _role_meta ugliness of before.
1291 - fixed tests to reflect this change
1293 0.11 Wed. July 12, 2006
1295 - added an &unimport method to remove all the keywords
1296 that Moose will import, simply add 'no Moose' to the
1297 bottom of your class file.
1300 - fixed some test failures caused by a forgotten test
1303 0.10 Thurs. July 6, 2006
1305 - improved error message when loading modules so
1306 it is less confusing when you load a role.
1307 - added &calculate_all_roles method to
1308 Moose::Meta::Class and Moose::Meta::Role
1311 This module has been tested against Class::MOP 0.30
1312 but it does not yet utilize the optimizations
1313 it makes available. Stay tuned for that ;)
1315 0.09_03 Fri. June 23, 2006
1316 ++ DEVELOPER RELEASE ++
1318 - 'use strict' and 'use warnings' are no longer
1319 needed in Moose classes, Moose itself will
1320 turn them on for you.
1321 - added tests for this
1322 - moved code from exported subs to private methods
1323 in Moose::Meta::Class
1326 - as with Moose, strict and warnings are
1327 automatically turned on for you.
1328 - added tests for this
1331 - now handles an edge case for override errors
1332 - added tests for this
1333 - added some more edge case tests
1335 0.09_02 Tues. May 16, 2006
1336 ++ DEVELOPER RELEASE ++
1338 - added prototypes to the exported subs
1342 - added prototypes to the exported subs
1345 * Moose::Util::TypeConstraints
1346 - cleaned up prototypes for the subs
1349 0.09_01 Fri. May 12, 2006
1350 ++ DEVELOPER RELEASE ++
1351 - This release works in combination with
1352 Class::MOP 0.29_01, it is a developer
1353 release because it uses the a new
1354 instance sub-protocol and a fairly
1355 complete Role implementation. It has
1356 not yet been optimized, so it slower
1357 the the previous CPAN version. This
1358 release also lacks good updated docs,
1359 the official release will have updated docs.
1362 - refactored the keyword exports
1363 - 'with' now checks Role validaity and
1364 accepts more than one Role at a time
1365 - 'extends' makes metaclass adjustments as
1366 needed to ensure metaclass compatability
1369 - refactored the keyword exports
1370 - 'with' now checks Role validaity and
1371 accepts more than one Role at a time
1373 * Moose::Util::TypeConstraints
1374 - added the 'enum' keyword for simple
1375 string enumerations which can be used as
1377 - see example of usage in t/202_example.t
1380 - more careful checking of params to new()
1383 - much work done on the role composition
1384 - many new tests for conflict detection
1385 and composition edge cases
1386 - not enough documentation, I suggest
1387 looking at the tests
1389 * Moose::Meta::Instance
1390 - added new Instance metaclass to support
1391 the new Class::MOP instance protocol
1393 * Moose::Meta::Class
1394 - some small changes to support the new
1396 - some small additions to support Roles
1398 * Moose::Meta::Attribute
1399 - some improvements to the accessor generation code
1401 - some small changes to support the new
1403 - (still somewhat) experimental delegation support
1404 with the 'handles' option
1405 - added several tests for this
1406 - no docs for this yet
1408 0.05 Thurs. April 27, 2006
1410 - keywords are now exported with Sub::Exporter
1411 thanks to chansen for this commit
1412 - has keyword now takes a 'metaclass' option
1413 to support custom attribute meta-classes
1414 on a per-attribute basis
1415 - added tests for this
1416 - the 'has' keyword not accepts inherited slot
1417 specifications (has '+foo'). This is still an
1418 experimental feature and probably not finished
1419 see t/038_attribute_inherited_slot_specs.t for
1420 more details, or ask about it on #moose
1421 - added tests for this
1424 - keywords are now exported with Sub::Exporter
1426 * Moose::Utils::TypeConstraints
1427 - reorganized the type constraint hierarchy, thanks
1428 to nothingmuch and chansen for his help and advice
1430 - added some tests for this
1431 - keywords are now exported with Sub::Exporter
1432 thanks to chansen for this commit
1434 * Moose::Meta::Class
1435 - due to changes in Class::MOP, we had to change
1436 construct_instance (for the better)
1438 * Moose::Meta::Attribute
1439 - due to changes in Class::MOP, we had to add the
1440 initialize_instance_slot method (it's a good thing)
1442 * Moose::Meta::TypeConstraint
1443 - added type constraint unions
1444 - added tests for this
1445 - added the is_subtype_of predicate method
1446 - added tests for this
1448 0.04 Sun. April 16th, 2006
1450 - Roles can now consume other roles
1451 - added tests for this
1452 - Roles can specify required methods now with
1453 the requires() keyword
1454 - added tests for this
1457 - ripped out much of it's guts ,.. much cleaner now
1458 - added required methods and correct handling of
1459 them in apply() for both classes and roles
1460 - added tests for this
1461 - no longer adds a does() method to consuming classes
1462 it relys on the one in Moose::Object
1463 - added roles attribute and some methods to support
1464 roles consuming roles
1466 * Moose::Meta::Attribute
1467 - added support for triggers on attributes
1468 - added tests for this
1469 - added support for does option on an attribute
1470 - added tests for this
1472 * Moose::Meta::Class
1473 - added support for attribute triggers in the
1475 - added tests for this
1478 - Moose no longer creates a subtype for your class
1479 if a subtype of the same name already exists, this
1480 should DWIM in 99.9999% of all cases
1482 * Moose::Util::TypeConstraints
1483 - fixed bug where incorrect subtype conflicts were
1485 - added test for this
1488 - this class can now be extended with 'use base' if
1489 you need it, it properly loads the metaclass class now
1490 - added test for this
1492 0.03_02 Wed. April 12, 2006
1494 - you must now explictly use Moose::Util::TypeConstraints
1495 it no longer gets exported for you automatically
1498 - new() now accepts hash-refs as well as key/value lists
1499 - added does() method to check for Roles
1500 - added tests for this
1502 * Moose::Meta::Class
1503 - added roles attribute along with the add_role() and
1505 - added tests for this
1508 - now adds a does() method to consuming classes
1509 which tests the class's hierarchy for roles
1510 - added tests for this
1512 0.03_01 Mon. April 10, 2006
1514 - added new Role recipe (no content yet, only code)
1517 - added 'with' keyword for Role support
1518 - added test and docs for this
1519 - fixed subtype quoting bug
1520 - added test for this
1524 - added test and docs
1526 * Moose::Util::TypeConstraints
1527 - added the message keyword to add custom
1528 error messages to type constraints
1531 - the meta role to support Moose::Role
1532 - added tests and docs
1534 * Moose::Meta::Class
1535 - moved a number of things from Moose.pm
1536 to here, they should have been here
1539 * Moose::Meta::Attribute
1540 - moved the attribute option macros here
1541 instead of putting them in Moose.pm
1543 * Moose::Meta::TypeConstraint
1544 - added the message attributes and the
1546 - added tests and docs for this
1548 0.03 Thurs. March 30, 2006
1550 - added the Moose::Cookbook with 5 recipes,
1551 describing all the stuff Moose can do.
1554 - fixed an issue with &extends super class loading
1555 it now captures errors and deals with inline
1556 packages correctly (bug found by mst, solution
1558 - added super/override & inner/augment features
1559 - added tests and docs for these
1562 - BUILDALL now takes a reference of the %params
1563 that are passed to &new, and passes that to
1566 * Moose::Util::TypeConstraints
1567 - Type constraints now survive runtime reloading
1568 - added test for this
1570 * Moose::Meta::Class
1571 - fixed the way attribute defaults are handled
1572 during instance construction (bug found by chansen)
1574 * Moose::Meta::Attribute
1575 - read-only attributes now actually enforce their
1576 read-only-ness (this corrected in Class::MOP as
1579 0.02 Tues. March 21, 2006
1581 - many more tests, fixing some bugs and
1583 - &extends now loads the base module with
1585 - added UNIVERSAL::require to the
1588 - each new Moose class will also create
1589 and register a subtype of Object which
1590 correspond to the new Moose class.
1591 - the 'isa' option in &has now only
1592 accepts strings, and will DWIM in
1595 * Moose::Util::TypeConstraints
1596 - added type coercion features
1597 - added tests for this
1598 - added support for this in attributes
1599 and instance construction
1601 - type construction no longer creates a
1602 function, it registers the type instead.
1603 - added several functions to get the
1607 - BUILDALL and DEMOLISHALL were broken
1608 because of a mis-named hash key, Whoops :)
1610 * Moose::Meta::Attribute
1611 - adding support for coercion in the
1612 autogenerated accessors
1614 * Moose::Meta::Class
1615 - adding support for coercion in the
1616 instance construction
1618 * Moose::Meta::TypeConstraint
1619 * Moose::Meta::TypeCoercion
1620 - type constraints and coercions are now
1621 full fledges meta-objects
1623 0.01 Wed. March 15, 2006
1624 - Moooooooooooooooooose!!!