1 Revision history for Perl extension Moose
4 * Moose::Meta::Method::Constructor
5 - Fix inlined constructor so that values produced by default
6 or builder methods are coerced as required + test (t0m)
9 - This is a new helper module for writing "Moose-alike"
10 modules. This should make the lives of MooseX module authors
11 much easier. (Dave Rolsky)
14 - Implemented metaclass traits:
16 use Moose -traits => 'Foo'
18 This should make writing small Moose extensions a little
22 * Moose::Cookbook::Extending::Recipe1
23 * Moose::Cookbook::Extending::Recipe2
24 - Rewrote extending and embedding moose documentation and
25 recipes to use Moose::Exporter (Dave Rolsky)
29 - These two modules now warn when you load them from the main
30 package "main" package, because we will not export sugar to
31 main. Previously it just did nothing. (Dave Rolsky)
33 0.55 Sun August 3, 2008
34 * Moose::Meta::Attribute
35 - breaking down the way 'handles' methods are
36 created so that the process can be more easily
37 overridden by subclasses (stevan)
39 * Moose::Meta::TypeConstraint
40 - fixing what is passed into a ->message with
41 the type constraints (RT #37569)
42 - added tests for this (Charles Alderman)
44 * Moose::Util::TypeConstraints
45 - fix coerce to accept anon types like subtype can (mst)
48 - reorganized the recipes into sections - Basics, Roles, Meta,
49 Extending - and wrote abstracts for each section (Dave Rolsky)
51 * Moose::Cookbook::Basics::Recipe10
52 - A new recipe that demonstrates operator overloading
53 in combination with Moose. (bluefeet)
55 * Moose::Cookbook::Meta::Recipe1
56 - an introduction to what meta is and why you'd want to make
57 your own metaclass extensions (Dave Rolsky)
59 * Moose::Cookbook::Meta::Recipe4
60 - a very simple metaclass example (Dave Rolsky)
62 * Moose::Cookbook::Extending::Recipe1
63 - how to write a Moose-alike module to use your own object base
66 * Moose::Cookbook::Extending::Recipe2
67 - how to write modules with an API just like C<Moose.pm> (Dave
71 - Tons of fixes, both syntactical and grammatical (Dave
74 0.54 Thurs. July 3, 2008
75 ... this is not my day today ...
77 * Moose::Meta::Attribute
78 - fixed legal_options_for_inheritance such that
79 clone_and_inherit options still works for
80 Class::MOP::Attribute objects and therefore
81 does not break MooseX::AttributeHelpers
84 0.53 Thurs. July 3, 2008
85 * Whoops, I guess I should run 'make manifest' before
86 actually releasing the module. No actual changes
87 in this release, except the fact that it includes
88 the changes that I didn't include in the last
91 0.52 Thurs. July 3, 2008
93 - added "FEATURE REQUESTS" section to the Moose docs
94 to properly direct people (stevan) (RT #34333)
95 - making 'extends' croak if it is passed a Role since
96 this is not ever something you want to do
97 (fixed by stevan, found by obra)
98 - added tests for this (stevan)
101 - adding support for DOES (as in UNIVERSAL::DOES)
103 - added test for this
105 * Moose::Meta::Attribute
106 - added legal_options_for_inheritance (wreis)
107 - added tests for this (wreis)
109 * Moose::Cookbook::Snacks::*
110 - removed some of the unfinished snacks that should
111 not have been released yet. Added some more examples
112 to the 'Keywords' snack. (stevan)
114 * Moose::Cookbook::Style
115 - added general Moose "style guide" of sorts to the
116 cookbook (nothingmuch) (RT #34335)
119 - added more BUILDARGS tests (stevan)
121 0.51 Thurs. Jun 26, 2008
123 - add unimport so "no Moose::Role" actually does
126 * Moose::Meta::Role::Application::ToRole
127 - when RoleA did RoleB, and RoleA aliased a method from RoleB in
128 order to provide its own implementation, that method still got
129 added to the list of required methods for consumers of
130 RoleB. Now an aliased method is only added to the list of
131 required methods if the role doing the aliasing does not
132 provide its own implementation. See Recipe 11 for an example
133 of all this. (Dave Rolsky)
134 - added tests for this
136 * Moose::Meta::Method::Constructor
137 - when a single argument that wasn't a hashref was provided to
138 an immutabilized constructor, the error message was very
139 unhelpful, as opposed to the non-immutable error. Reported by
141 - added test for this (Dave Rolsky)
143 * Moose::Meta::Attribute
144 - added support for meta_attr->does("ShortAlias") (sartak)
145 - added tests for this (sartak)
146 - moved the bulk of the `handles` handling to the new
147 install_delegation method (Stevan)
150 - Added BUILDARGS, a new step in new()
152 * Moose::Meta::Role::Application::RoleSummation
153 - fix typos no one ever sees (sartak)
155 * Moose::Util::TypeConstraints
156 * Moose::Meta::TypeConstraint
157 * Moose::Meta::TypeCoercion
158 - Attempt to work around the ??{ } vs. threads issue
160 - Some null_constraint optimizations
162 0.50 Thurs. Jun 11, 2008
163 - Fixed a version number issue by bumping all modules
166 0.49 Thurs. Jun 11, 2008
167 !! This version now approx. 20-25% !!
168 !! faster with new Class::MOP 0.59 !!
170 * Moose::Meta::Attribute
171 - fixed how the is => (ro|rw) works with
172 custom defined reader, writer and accessor
174 - added docs for this (TODO).
175 - added tests for this (Thanks to Penfold)
176 - added the custom attribute alias for regular
177 Moose attributes which is "Moose"
178 - fix builder and default both being used
183 Moose::Meta::Attribute
185 Moose::Meta::Role::Composite
186 Moose::Util::TypeConstraints
187 - switched usage of reftype to ref because
191 - changing add_package_symbol to use the new
195 - fixed how DEMOLISHALL is called so that it
196 can be overrided in subclasses (thanks to Sartak)
197 - added test for this (thanks to Sartak)
199 * Moose::Util::TypeConstraints
200 - move the ClassName type check code to
201 Class::MOP::is_class_loaded (thanks to Sartak)
203 * Moose::Cookbook::Recipe11
204 - add tests for this (thanks to tokuhirom)
206 0.48 Thurs. May 29, 2008
207 (early morning release engineering)--
209 - fixing the version in Moose::Meta::Method::Destructor
210 which was causing the indexer to choke
212 0.47 Thurs. May 29, 2008
213 (late night release engineering)--
215 - fixing the version is META.yml, no functional
216 changes in this release
218 0.46 Wed. May 28, 2008
219 !! This version now approx. 20-25% !!
220 !! faster with new Class::MOP 0.57 !!
223 - some optimizations of the &initialize method
224 since it is called so often by &meta
228 - now use the get_all_package_symbols from the
229 updated Class::MOP, test suite is now 10 seconds
232 * Moose::Meta::Method::Destructor
233 - is_needed can now also be called as a class
234 method for immutablization to check if the
235 destructor object even needs to be created
238 * Moose::Meta::Method::Destructor
239 Moose::Meta::Method::Constructor
240 - added more descriptive error message to help
241 keep people from wasting time tracking an error
242 that is easily fixed by upgrading.
244 0.45 Saturday, May 24, 2008
246 - Because of work in Class::MOP 0.56, all
247 XS based functionality is now optional
248 and a Pure Perl version is supplied
249 - the CLASS_MOP_NO_XS environment variable
250 can now be used to force non-XS versions
252 - several of the packages have been tweaked
253 to take care of this, mostly we added
254 support for the package_name and name
255 variables in all the Method metaclasses
256 - before/around/after method modifiers now
257 support regexp matching of names
258 (thanks to Takatoshi Kitano)
259 - tests added for this
260 - NOTE: this only works for classes, it
261 is currently not supported in roles,
262 but, ... patches welcome
263 - All usage of Carp::confess have been replaced
264 by Carp::croak in the "keyword" functions since
265 the stack trace is usually not helpful
268 - All usage of Carp::confess have been replaced
269 by Carp::croak in the "keyword" functions since
270 the stack trace is usually not helpful
271 - The 'has' keyword for roles now accepts the
272 same array ref form that Moose.pm does
273 (has [qw/foo bar/] => (is => 'rw', ...))
274 - added test for this
276 * Moose::Meta::Attribute
277 - trigger on a ro-attribute is no longer an
278 error, as it's useful to trigger off of the
282 - added same 'add_package_symbol' fix as in
286 - does_role now handles non-Moose classes
288 - added tests for this
289 - added the 'add_method_modifier' function
290 (thanks to Takatoshi Kitano)
292 * Moose::Util::TypeConstraints
293 - subtypes of parameterizable types now are
294 themselves parameterizable types
296 * Moose::Meta::Method::Constructor
297 - fixed bug where trigger was not being
298 called by the inlined immutable
300 - added test for this (thanks to Caelum)
302 * Moose::Meta::Role::Application::ToInstance
303 - now uses the metaclass of the instance
304 (if possible) to create the anon-class
305 (thanks Jonathan Rockway)
307 * Moose::Cookbook::Recipe22
308 - added the meta-attribute trait recipe
312 - fixed hash-ordering test bug that was
313 causing occasional cpantester failures
314 - renamed the t/000_recipe/*.t tests to be
315 more descriptive (thanks to Sartak)
317 0.44 Sat. May 10, 2008
319 - made make_immutable warning cluck to
320 show where the error is (thanks mst)
323 - BUILDALL and DEMOLISHALL now call
324 ->body when looping through the
325 methods, to avoid the overloaded
327 - fixed issue where DEMOLISHALL was
328 eating the $@ values, and so not
329 working correctly, it still kind of
330 eats them, but so does vanilla perl
331 - added tests for this
333 * Moose::Cookbook::Recipe7
334 - added new recipe for immutable
335 functionality (thanks Dave Rolsky)
337 * Moose::Cookbook::Recipe9
338 - added new recipe for builder and
339 lazy_build (thanks Dave Rolsky)
341 * Moose::Cookbook::Recipe11
342 - added new recipe for method aliasing
343 and exclusion with Roles (thanks Dave Rolsky)
346 - fixed Win32 test failure (thanks spicyjack)
348 ~ removed Build.PL and Module::Build compat
349 since Module::Install has done that.
351 0.43 Wed. April, 30, 2008
353 drink more coffee before
354 doing release engineering
356 - whoops, forgot to do the smolder tests,
357 and we broke some of the custom meta-attr
358 modules. This fixes that.
360 0.42 Mon. April 28, 2008
361 - some bad tests slipped by, nothing else
362 changed in this release (cpantesters++)
364 - upped the Class::MOP dependency to 0.55
365 since we have tests which need the C3
368 0.41 Mon. April 28, 2008
369 ~~ numerous documentation updates ~~
371 - Changed all usage of die to Carp::croak for better
372 error reporting (initial patch by Tod Hagan)
375 - the make_immutable keyword is now deprecated, don't
376 use it in any new code and please fix your old code
377 as well. There will be 2 releases, and then it will
383 - refactored the way inner and super work to avoid
384 any method/@ISA cache penalty (nothingmuch)
387 - fixing &new_object to make sure trigger gets the
388 coerced value (spotted by Charles Alderman on the
390 - added test for this
392 * Moose::Meta::Method::Constructor
393 - immutable classes which had non-lazy attributes were calling
394 the default generating sub twice in the constructor. (bug
395 found by Jesse Luehrs, fixed by Dave Rolsky)
396 - added tests for this (Dave Rolsky)
397 - fix typo in initialize_body method (nothingmuch)
399 * Moose::Meta::Method::Destructor
400 - fix typo in initialize_body method (nothingmuch)
402 * Moose::Meta::Method::Overriden
403 Moose::Meta::Method::Augmented
404 - moved the logic for these into their own
405 classes (nothingmuch)
407 * Moose::Meta::Attribute
408 - inherited attributes may now be extended without
409 restriction on the type ('isa', 'does') (Sartak)
410 - added tests for this (Sartak)
411 - when an attribute property is malformed (such as lazy without
412 a default), give the name of the attribute in the error
414 - added the &applied_traits and &has_applied_traits methods
415 to allow introspection of traits
416 - added tests for this
417 - moved 'trait' and 'metaclass' argument handling to here from
419 - clone_and_inherit_options now handles 'trait' and 'metaclass' (has
420 '+foo' syntax) (nothingmuch)
421 - added tests for this (t0m)
424 - localize $@ inside DEMOLISHALL to avoid it
425 eating $@ (found by Ernesto)
426 - added test for this (thanks to Ernesto)
428 * Moose::Util::TypeConstraints
429 - &find_type_constraint now DWIMs when given an
430 type constraint object or name (nothingmuch)
431 - &find_or_create_type_constraint superseded with a number of more
433 - find_or_create_{isa,does}_type_constraint
434 - find_or_parse_type_constraint
436 * Moose::Meta::TypeConstraint
437 Moose::Meta::TypeConstraint::Class
438 Moose::Meta::TypeConstraint::Role
439 Moose::Meta::TypeConstraint::Enum
440 Moose::Meta::TypeConstraint::Union
441 Moose::Meta::TypeConstraint::Parameterized
442 - added the &equals method for comparing two type
443 constraints (nothingmuch)
444 - added tests for this (nothingmuch)
446 * Moose::Meta::TypeConstraint
447 - add the &parents method, which is just an alias to &parent.
448 Useful for polymorphism with TC::{Class,Role,Union} (nothingmuch)
450 * Moose::Meta::TypeConstraint::Class
451 - added the class attribute for introspection purposes
453 - added tests for this
455 * Moose::Meta::TypeConstraint::Enum
456 Moose::Meta::TypeConstraint::Role
457 - broke these out into their own classes (nothingmuch)
459 * Moose::Cookbook::Recipe*
460 - fixed references to test file locations in the POD
461 and updated up some text for new Moose features
465 - Added &resolve_metaclass_alias, a helper function for finding an actual
466 class for a short name (e.g. in the traits list)
468 0.40 Fri. March 14, 2008
469 - I hate Pod::Coverage
471 0.39 Fri. March 14, 2008
473 - documenting the use of '+name' with attributes
474 that come from recently composed roles. It makes
475 sense, people are using it, and so why not just
476 officially support it.
477 - fixing the 'extends' keyword so that it will not
478 trigger Ovid's bug (http://use.perl.org/~Ovid/journal/35763)
481 - added the perl -Moose=+Class::Name feature to allow
482 monkeypatching of classes in one liners
485 - fixing the 'apply_all_roles' keyword so that it will not
486 trigger Ovid's bug (http://use.perl.org/~Ovid/journal/35763)
489 - added ->create method which now supports roles (thanks to jrockway)
490 - added tests for this
491 - added ->create_anon_class which now supports roles and caching of
492 the results (thanks to jrockway)
493 - added tests for this
494 - made ->does_role a little more forgiving when it is
495 checking a Class::MOP era metaclasses.
497 * Moose::Meta::Role::Application::ToInstance
498 - it is now possible to pass extra params to be used when
499 a role is applied to an the instance (rebless_params)
500 - added tests for this
502 * Moose::Util::TypeConstraints
503 - class_type now accepts an optional second argument for a
504 custom message. POD anotated accordingly (groditi)
505 - added tests for this
506 - it is now possible to make anon-enums by passing 'enum' an
507 ARRAY ref instead of the $name => @values. Everything else
509 - added tests for this
512 - making test for using '+name' on attributes consumed
513 from a role, it works and makes sense too.
515 * Moose::Meta::Attribute
516 - fix handles so that it doesn't return nothing
517 when the method cannot be found, not sure why
518 it ever did this originally, this means we now
519 have slightly better support for AUTOLOADed
521 - added more delegation tests
522 - adding ->does method to this so as to better
523 support traits and their introspection.
524 - added tests for this
527 - localizing the Data::Dumper configurations so
528 that it does not pollute others (RT #33509)
529 - made ->does a little more forgiving when it is
530 passed Class::MOP era metaclasses.
532 0.38 Fri. Feb. 15, 2008
533 * Moose::Meta::Attribute
534 - fixed initializer to correctly do
535 type checking and coercion in the
537 - added tests for this
540 - fixed some finicky tests (thanks to konobi)
542 0.37 Thurs. Feb. 14, 2008
544 - fixed some details in Moose::init_meta
545 and its superclass handling (thanks thepler)
546 - added tests for this (thanks thepler)
547 - 'has' now dies if you don't pass in name
549 - added the 'make_immutable' keyword as a shortcut
553 Moose::Meta::Method::Constructor
554 Moose::Meta::Attribute
555 - making (init_arg => undef) work here too
556 (thanks to nothingmuch)
558 * Moose::Meta::Attribute
559 Moose::Meta::Method::Constructor
560 Moose::Meta::Method::Accessor
561 - make lazy attributes respect attr initializers (rjbs)
562 - added tests for this
564 * Moose::Util::TypeConstraints
565 Moose::Util::TypeConstraints::OptimizedConstraints
566 Moose::Meta::TypeConstraints
567 Moose::Meta::Attribute
568 Moose::Meta::Method::Constructor
569 Moose::Meta::Method::Accessor
570 - making type errors use the
571 assigned message (thanks to Sartak)
572 - added tests for this
574 * Moose::Meta::Method::Destructor
575 - making sure DESTROY gets inlined properly
576 with successive DEMOLISH calls (thanks to manito)
578 * Moose::Meta::Attribute
579 Moose::Meta::Method::Accessor
580 - fixed handling of undef with type constraints
582 - added tests for this
585 - added &get_all_init_args and &get_all_attribute_values
586 (thanks to Sartak and nothingmuch)
588 0.36 Sat. Jan. 26, 2008
590 Moose::Meta::Attribute
591 - role type tests now support when roles are
592 applied to non-Moose classes (found by ash)
593 - added tests for this (thanks to ash)
594 - couple extra tests to boost code coverage
596 * Moose::Meta::Method::Constructor
597 - improved fix for handling Class::MOP attributes
598 - added test for this
601 - handled the add_attribute($attribute_meta_object)
603 - added test for this
605 0.35 Tues. Jan. 22, 2008
606 * Moose::Meta::Method::Constructor
607 - fix to make sure even Class::MOP attributes
608 are handled correctly (Thanks to Dave Rolsky)
609 - added test for this (also Dave Rolsky)
612 - improved error message on _apply_all_roles,
613 you should now use Moose::Util::apply_all_roles
614 and you shouldnt have been using a _ prefixed
615 method in the first place ;)
617 0.34 Mon. Jan. 21, 2008
618 ~~~ more misc. doc. fixes ~~~
619 ~~ updated copyright dates ~~
621 Moose is now a postmodern object system :)
622 - (see the POD for details)
624 * <<Role System Refactoring>>
625 - this release contains a major reworking and
626 cleanup of the role system
627 - 100% backwards compat.
628 - Role application now restructured into seperate
629 classes based on type of applicants
630 - Role summation (combining of more than one role)
631 is much cleaner and anon-classes are no longer
633 - new Composite role metaclass
634 - runtime application of roles to instances
635 is now more efficient and re-uses generated
636 classes when applicable
638 * <<New Role composition features>>
639 - methods can now be excluded from a given role
641 - methods can now be aliased to another name (and
642 still retain the original as well)
644 * Moose::Util::TypeConstraints::OptimizedConstraints
645 - added this module (see above)
648 - fixed the &_process_attribute method to be called
649 by &add_attribute, so that the API is now correct
651 * Moose::Meta::Method::Accessor
652 - fixed bug when passing a list of values to
653 an accessor would get (incorrectly) ignored.
654 Thanks to Sartak for finding this ;)
655 - added tests for this (Sartak again)
657 * Moose::Meta::Method::Accessor
658 Moose::Meta::Method::Constructor
659 Moose::Meta::Attribute
660 Moose::Meta::TypeConstraint
661 Moose::Meta::TypeCoercion
662 - lots of cleanup of such things as:
664 - type constraint handling
665 - error handling/messages
666 (thanks to nothingmuch)
668 * Moose::Meta::TypeConstraint::Parameterizable
669 - added this module to support the refactor
670 in Moose::Meta::TypeConstraint::Parameterized
672 * Moose::Meta::TypeConstraint::Parameterized
673 - refactored how these types are handled so they
674 are more generic and not confined to ArrayRef
678 - shortened some file names for better VMS support (RT #32381)
680 0.33 Fri. Dec. 14, 2007
681 !! Moose now loads 2 x faster !!
682 !! with new Class::MOP 0.49 !!
684 ++ new oose.pm module to make command line
685 Moose-ness easier (see POD docs for more)
689 - several tweaks to take advantage of the
690 new method map caching in Class::MOP
692 * Moose::Meta::TypeConstraint::Parameterized
693 - allow subtypes of ArrayRef and HashRef to
694 be used as a container (sartak)
695 - added tests for this
696 - basic support for coercion to ArrayRef and
697 HashRef for containers (sartak)
698 - added tests for this
700 * Moose::Meta::TypeCoercion
701 - coercions will now create subtypes as needed
702 so you can now add coercions to parameterized
703 types without having to explictly define them
704 - added tests for this
706 * Moose::Meta::Method::Accessor
707 - allow subclasses to decide whether we need
708 to copy the value into a new variable (sartak)
710 0.32 Tues. Dec. 4, 2007
711 * Moose::Util::TypeConstraints
712 - fixing how subtype aliases of unions work
713 they should inherit the parent's coercion
714 - added tests for this
715 - you can now define multiple coercions on
716 a single type at different times instead of
717 having to do it all in one place
718 - added tests for this
720 * Moose::Meta::TypeConstraint
721 - there is now a default constraint of sub { 1 }
722 instead of Moose::Util::TypeConstraints setting
725 * Moose::Meta::TypeCoercion
726 * Moose::Meta::TypeCoercion::Union
727 - added the &has_coercion_for_type and
728 &add_type_coercions methods to support the
729 new features above (although you cannot add
730 more type coercions for Union types)
732 0.31 Mon. Nov. 26, 2007
733 * Moose::Meta::Attribute
734 - made the +attr syntax handle extending types with
735 parameters. So "has '+foo' => (isa => 'ArrayRef[Int]')"
736 now works if the original foo is an ArrayRef.
737 - added tests for this.
738 - delegation now works even if the attribute does not
739 have a reader method using the get_read_method_ref
740 method from Class::MOP::Attribute.
741 - added tests for this
742 - added docs for this
744 * Moose::Util::TypeConstraints
745 - passing no "additional attribute info" to
746 &find_or_create_type_constraint will no longer
747 attempt to create an __ANON__ type for you,
748 instead it will just return undef.
749 - added docs for this
751 0.30 Fri. Nov. 23, 2007
752 * Moose::Meta::Method::Constructor
753 -builder related bug in inlined constructor. (groditi)
755 * Moose::Meta::Method::Accessor
756 - genereate unnecessary calls to predicates and refactor
757 code generation for runtime speed (groditi)
759 * Moose::Util::TypeConstraints
760 - fix ClassName constraint to introspect symbol table (mst)
761 - added more tests for this (mst)
762 - fixed it so that subtype 'Foo' => as 'HashRef[Int]' ...
764 - added tests for this
767 - adding the link to Recipie 11 (written by Sartak)
768 - adding test for SYNOPSIS code
771 - New tests for builder bug. Upon instantiation, if an
772 attribute had a builder, no value and was not lazy the
773 builder default was not getting run, oops. (groditi)
775 0.29 Tues. Nov. 13, 2007
776 * Moose::Meta::Attribute
777 - Fix error message on missing builder method (groditi)
779 * Moose::Meta::Method::Accessor
780 - Fix error message on missing builder method (groditi)
783 - Add test to check for the correct error message when
784 builder method is missing (groditi)
786 0.28 Tues. Nov. 13, 2007
787 - 0.27 packaged incorrectly (groditi)
789 0.27 Tues. Nov. 13, 2007
790 * Moose::Meta::Attribute
791 - Added support for the new builder option (groditi)
792 - Added support for lazy_build option (groditi)
793 - Changed slot initialization for predicate changes (groditi)
795 * Moose::Meta::Method::Accessor
796 - Added support for lazy_build option (groditi)
797 - Fix inline methods to work with corrected predicate
800 * Moose::Meta::Method::Constructor
801 - Added support for lazy_build option (groditi)
804 - tests for builder and lazy_build (groditi)
806 * fixing some misc. bits in the docs that
807 got mentioned on CPAN Forum & perlmonks
810 - fixed how required methods are handled
811 when they encounter overriden or modified
812 methods from a class (thanks to confound).
813 - added tests for this
815 * Moose::Util::TypeConstraint
816 - fixed the type notation parser so that
817 the | always creates a union and so is
818 no longer a valid type char (thanks to
819 konobi, mugwump and #moose for working
821 - added more tests for this
823 0.26 Thurs. Sept. 27, 2007
826 * Parameterized Types
827 We now support parameterized collection types, such as:
828 ArrayRef[Int] # array or integers
829 HashRef[Object] # a hash with object values
830 They can also be nested:
831 ArrayRef[HashRef[RegExpr]] # an array of hashes with regexpr values
832 And work with the type unions as well:
833 ArrayRef[Int | Str] # array of integers of strings
835 * Better Framework Extendability
836 Moose.pm is now "extendable" such that it is now much
837 easier to extend the framework and add your own keywords
838 and customizations. See the "EXTENDING AND EMBEDDING MOOSE"
839 section of the Moose.pm docs.
842 In an effort to begin documenting some of the various
843 details of Moose as well as some common idioms, we have
844 created Moose::Cookbook::Snacks as a place to find
845 small (easily digestable) nuggets of Moose code.
848 ~ Several doc updates/cleanup thanks to castaway ~
850 - converted build system to use Module::Install instead of
851 Module::Build (thanks to jrockway)
854 - added all the meta classes to the immutable list and
855 set it to inline the accessors
856 - fix import to allow Sub::Exporter like { into => }
857 and { into_level => } (perigrin)
858 - exposed and documented init_meta() to allow better
859 embedding and extending of Moose (perigrin)
862 - complete re-organization of the test suite
863 - added some new tests as well
864 - finally re-enabled the Moose::POOP test since
865 the new version of DBM::Deep now works again
869 - fixed very odd and very nasty recursion bug with
871 - added tests for this (eilara)
873 * Moose::Meta::Attribute
874 Moose::Meta::Method::Constructor
875 Moose::Meta::Method::Accessor
876 - fixed issue with overload::Overloaded getting called
877 on non-blessed items. (RT #29269)
878 - added tests for this
880 * Moose::Meta::Method::Accessor
881 - fixed issue with generated accessor code making
882 assumptions about hash based classes (thanks to dexter)
884 * Moose::Coookbook::Snacks
885 - these are bits of documentation, not quite as big as
886 Recipes but which have no clear place in the module docs.
887 So they are Snacks! (horray for castaway++)
889 * Moose::Cookbook::Recipe4
890 - updated it to use the new ArrayRef[MyType] construct
891 - updated the accompanying test as well
893 +++ Major Refactor of the Type Constraint system +++
894 +++ with new features added as well +++
896 * Moose::Util::TypeConstraint
897 - no longer uses package variable to keep track of
898 the type constraints, now uses the an instance of
899 Moose::Meta::TypeConstraint::Registry to do it
900 - added more sophisticated type notation parsing
902 - added tests for this
904 * Moose::Meta::TypeConstraint
905 - some minor adjustments to make subclassing easier
906 - added the package_defined_in attribute so that we
907 can track where the type constraints are created
909 * Moose::Meta::TypeConstraint::Union
910 - this is now been refactored to be a subclass of
911 Moose::Meta::TypeConstraint
913 * Moose::Meta::TypeCoercion::Union
914 - this has been added to service the newly refactored
915 Moose::Meta::TypeConstraint::Union and is itself
916 a subclass of Moose::Meta::TypeCoercion
918 * Moose::Meta::TypeConstraint::Parameterized
919 - added this module (taken from MooseX::AttributeHelpers)
920 to help construct nested collection types
921 - added tests for this
923 * Moose::Meta::TypeConstraint::Registry
924 - added this class to keep track of type constraints
926 0.25 Mon. Aug. 13, 2007
928 - Documentation update to reference Moose::Util::TypeConstraints
929 under 'isa' in 'has' for how to define a new type
932 * Moose::Meta::Attribute
933 - required attributes now will no longer accept undef
934 from the constructor, even if there is a default and lazy
935 - added tests for this
936 - default subroutines must return a value which passes the
938 - added tests for this
940 * Moose::Meta::Attribute
941 * Moose::Meta::Method::Constructor
942 * Moose::Meta::Method::Accessor
943 - type-constraint tests now handle overloaded objects correctly
945 - added tests for this (thanks to EvanCarroll)
947 * Moose::Meta::TypeConstraint::Union
948 - added (has_)hand_optimized_constraint to this class so that
949 it behaves as the regular Moose::Meta::TypeConstraint does.
952 - large refactoring of this code
953 - added several more tests
954 - tests for subtle conflict resolition issues
955 added, but not currently running
958 * Moose::Cookbook::Recipe7
959 - added new recipe for augment/inner functionality
961 - added test for this
964 - a formal definition of roles (still in progress)
967 - utilities for easier working with Moose classes
968 - added tests for these
971 - This contains Moose specific test functions
972 - added tests for these
974 0.24 Tues. July 3, 2007
975 ~ Some doc updates/cleanup ~
977 * Moose::Meta::Attribute
978 - added support for roles to be given as parameters
979 to the 'handles' option.
980 - added tests and docs for this
981 - the has '+foo' attribute form now accepts changes to
982 the lazy option, and the addition of a handles option
983 (but not changing the handles option)
984 - added tests and docs for this
987 - required methods are now fetched using find_method_by_name
988 so that required methods can come from superclasses
989 - adjusted tests for this
991 0.23 Mon. June 18, 2007
992 * Moose::Meta::Method::Constructor
993 - fix inlined constructor for hierarchy with multiple BUILD methods (mst)
995 - Modify make_immutable to work with the new Class::MOP immutable
996 mechanism + POD + very basic test (groditi)
997 * Moose::Meta::Attribute
998 - Fix handles to use goto() so that caller() comes out properly on
999 the other side (perigrin)
1001 0.22 Thurs. May 31, 2007
1002 * Moose::Util::TypeConstraints
1003 - fix for prototype undeclared issue when Moose::Util::TypeConstraints
1004 loaded before consumers (e.g. Moose::Meta::Attribute) by predeclaring
1005 prototypes for functions
1006 - added the ClassName type constraint, this checks for strings
1007 which will respond true to ->isa(UNIVERSAL).
1008 - added tests and docs for this
1009 - subtyping just in name now works correctly by making the
1010 default for where be { 1 }
1011 - added test for this
1013 * Moose::Meta::Method::Accessor
1014 - coerce and lazy now work together correctly, thanks to
1015 merlyn for finding this bug
1016 - tests added for this
1017 - fix reader presedence bug in Moose::Meta::Attribute + tests
1020 - Foo->new(undef) now gets ignored, it is assumed you meant to pass
1021 a HASH-ref and missed. This produces better error messages then
1022 having it die cause undef is not a HASH.
1023 - added tests for this
1025 0.21 Thursday, May 2nd, 2007
1027 - added SUPER_SLOT and INNER_SLOT class hashes to support unimport
1028 - modified unimport to remove super and inner along with the rest
1029 - altered unimport tests to handle this
1032 - altered super export to populate SUPER_SLOT
1034 * Moose::Meta::Class
1035 - altered augment and override modifier application to use *_SLOT
1036 - modified tests for these to unimport one test class each to test
1039 - fixed issue where custom attribute metaclasses
1040 where not handled correctly in roles
1041 - added tests for this
1043 * Moose::Meta::Class
1044 - fixed issue where extending metaclasses with
1045 roles would blow up. Thanks to Aankhen`` for
1046 finding this insidious error, and it's solution.
1048 ~~ lots of spelling and grammer fixes in the docs,
1049 many many thanks to rlb3 and Aankhen for these :)
1051 0.20 Friday, April 6th, 2007
1052 >> I messed up the SKIP logic in one test
1053 so this release is just to fix that.
1056 - 'has' now also accepts an ARRAY ref
1057 to create multiple attrs (see docs)
1058 (thanks to konobi for this)
1059 - added tests and docs
1061 0.19 Thurs. April 5th, 2007
1062 ~~ More documentation updates ~~
1064 * Moose::Util::TypeConstraints
1065 - 'type' now supports messages as well
1066 thanks to phaylon for finding this
1067 - added tests for this
1068 - added &list_all_type_constraints and
1069 &list_all_builtin_type_constraints
1070 functions to facilitate introspection.
1072 * Moose::Meta::Attribute
1073 - fixed regexp 'handles' declarations
1074 to build the list of delegated methods
1075 correctly (and not override important
1076 things like &new) thanks to ashleyb
1078 - added tests and docs for this
1079 - added the 'documentation' attributes
1080 so that you can actually document your
1081 attributes and inspect them through the
1083 - added tests and docs for this
1085 * Moose::Meta::Class
1086 - when loading custom attribute metaclasses
1087 it will first look in for the class in the
1088 Moose::Meta::Attribute::Custom::$name, and
1089 then default to just loading $name.
1090 - added tests and docs for this
1092 * Moose::Meta::TypeConstraint
1093 - type constraints now stringify to their names.
1094 - added test for this
1097 - added tests to assure we work with Module::Refresh
1098 - added stricter test skip logic in the Moose POOP
1099 test, ask Rob Kinyon why.
1100 - *cough* DBM::Deep 1.0 backwards compatability sucks *cough* ;)
1102 0.18 Sat. March 10, 2007
1103 ~~ Many, many documentation updates ~~
1106 - We now use Class::MOP::load_class to
1108 - added tests to show types and subtypes
1109 working with Declare::Constraints::Simple
1110 and Test::Deep as constraint engines.
1113 !! You must have Class::MOP 0.37_001 !!
1114 !! for this developer release to work !!
1116 This release was primarily adding the immutable
1117 feature to Moose. An immutable class is one which
1118 you promise not to alter. When you set the class
1119 as immutable it will perform various bits of
1120 memoization and inline certain part of the code
1121 (constructors, destructors and accessors). This
1122 minimizes (and in some cases totally eliminates)
1123 one of Moose's biggest performance hits. This
1124 feature is not on by default, and is 100% optional.
1125 It has several configurable bits as well, so you
1126 can pick and choose to your specific needs.
1128 The changes involved in this were fairly wide and
1129 highly specific, but 100% backwards compatible, so
1130 I am not going to enumerate them here. If you are
1131 truely interested in what was changed, please do
1134 0.17 Tues. Nov. 14, 2006
1135 * Moose::Meta::Method::Accessor
1136 - bugfix for read-only accessors which
1137 are have a type constraint and lazy.
1138 Thanks to chansen for finding it.
1140 0.16 Tues. Nov. 14, 2006
1142 There are some speed improvements in this release,
1143 but they are only the begining, so stay tuned.
1146 - BUILDALL and DEMOLISHALL no longer get
1147 called unless they actually need to be.
1148 This gave us a signifigant speed boost
1149 for the cases when there is no BUILD or
1150 DEMOLISH method present.
1152 * Moose::Util::TypeConstraints
1153 * Moose::Meta::TypeConstraint
1154 - added an 'optimize_as' option to the
1155 type constraint, which allows for a
1156 hand optimized version of the type
1157 constraint to be used when possible.
1158 - Any internally created type constraints
1159 now provide an optimized version as well.
1161 0.15 Sun. Nov. 5, 2006
1163 This version of Moose *must* have Class::MOP 0.36 in order
1164 to work correctly. A number of small internal tweaks have
1165 been made in order to be compatible with that release.
1167 * Moose::Util::TypeConstraints
1168 - added &unimport so that you can clean out
1169 your class namespace of these exported
1172 * Moose::Meta::Class
1173 - fixed minor issue which occasionally
1174 comes up during global destruction
1176 - moved Moose::Meta::Method::Overriden into
1180 - moved Moose::Meta::Role::Method into
1183 * Moose::Meta::Attribute
1184 - changed how we do type checks so that
1185 we reduce the overall cost, but still
1188 - moved accessor generation methods to
1189 Moose::Meta::Method::Accessor to
1190 conform to the API changes from
1193 * Moose::Meta::TypeConstraint
1194 - changed how constraints are compiled
1195 so that we do less recursion and more
1196 iteration. This makes the type check
1198 - moved Moose::Meta::TypeConstraint::Union
1201 * Moose::Meta::Method::Accessor
1202 - created this from methods formerly found in
1203 Moose::Meta::Attribute
1205 * Moose::Meta::Role::Method
1206 - moved this from Moose::Meta::Role
1208 * Moose::Meta::Method::Overriden
1209 - moved this from Moose::Meta::Class
1211 * Moose::Meta::TypeConstraint::Union
1212 - moved this from Moose::Meta::TypeConstraint
1214 0.14 Mon. Oct. 9, 2006
1216 * Moose::Meta::Attribute
1217 - fixed lazy attributes which were not getting
1218 checked with the type constraint (thanks ashley)
1219 - added tests for this
1220 - removed the over-enthusiastic DWIMery of the
1221 automatic ArrayRef and HashRef defaults, it
1222 broke predicates in an ugly way.
1223 - removed tests for this
1225 0.13 Sat. Sept. 30, 2006
1227 This version of Moose *must* have Class::MOP 0.35 in order
1228 to work correctly. A number of small internal tweaks have
1229 been made in order to be compatible with that release.
1232 - Removed the use of UNIVERSAL::require to be a better
1233 symbol table citizen and remove a dependency
1234 (thanks Adam Kennedy)
1236 **~~ removed experimental & undocumented feature ~~**
1237 - commented out the 'method' and 'self' keywords, see the
1238 comments for more info.
1241 - added a FAQ and WTF files to document frequently
1242 asked questions and common problems
1244 * Moose::Util::TypeConstraints
1245 - added GlobRef and FileHandle type constraint
1246 - added tests for this
1248 * Moose::Meta::Attribute
1249 - if your attribute 'isa' ArrayRef of HashRef, and you have
1250 not explicitly set a default, then make the default DWIM.
1251 This will also work for subtypes of ArrayRef and HashRef
1253 - you can now auto-deref subtypes of ArrayRef or HashRef too.
1254 - new test added for this (thanks to ashley)
1257 - added basic support for runtime role composition
1258 but this is still *highly experimental*, so feedback
1259 is much appreciated :)
1260 - added tests for this
1262 * Moose::Meta::TypeConstraint
1263 - the type constraint now handles the coercion process
1264 through delegation, this is to support the coercion
1267 * Moose::Meta::TypeConstraint::Union
1268 - it is now possible for coercions to be performed
1270 - added tests for this (thanks to konobi)
1272 * Moose::Meta::TypeCoercion
1273 - properly capturing error when type constraint
1277 - Scalar::Util 1.18 is bad on Win32, so temporarily
1278 only require version 1.17 for Win32 and cygwin.
1279 (thanks Adam Kennedy)
1281 0.12 Sat. Sept. 1, 2006
1283 - Recipe5 (subtypes & coercion) has been written
1286 - fixed "bad meta" error message to be more descriptive
1287 - fixed &unimport to not remove the &inner and &super
1288 keywords because we need to localize them.
1289 - fixed number of spelling/grammer issues, thanks Theory :)
1291 **~~ experimental & undocumented feature ~~**
1292 - added the method and self keywords, they are basically
1293 just sugar, and they may not stay around.
1296 - added &dump method to easily Data::Dumper
1299 * Moose::Meta::TypeConstraint
1300 - added the &is_a_type_of method to check both the current
1301 and the subtype of a method (similar to &isa with classes)
1304 - this is now a subclass of Class::MOP::Module, and no longer
1305 creates the _role_meta ugliness of before.
1306 - fixed tests to reflect this change
1308 0.11 Wed. July 12, 2006
1310 - added an &unimport method to remove all the keywords
1311 that Moose will import, simply add 'no Moose' to the
1312 bottom of your class file.
1315 - fixed some test failures caused by a forgotten test
1318 0.10 Thurs. July 6, 2006
1320 - improved error message when loading modules so
1321 it is less confusing when you load a role.
1322 - added &calculate_all_roles method to
1323 Moose::Meta::Class and Moose::Meta::Role
1326 This module has been tested against Class::MOP 0.30
1327 but it does not yet utilize the optimizations
1328 it makes available. Stay tuned for that ;)
1330 0.09_03 Fri. June 23, 2006
1331 ++ DEVELOPER RELEASE ++
1333 - 'use strict' and 'use warnings' are no longer
1334 needed in Moose classes, Moose itself will
1335 turn them on for you.
1336 - added tests for this
1337 - moved code from exported subs to private methods
1338 in Moose::Meta::Class
1341 - as with Moose, strict and warnings are
1342 automatically turned on for you.
1343 - added tests for this
1346 - now handles an edge case for override errors
1347 - added tests for this
1348 - added some more edge case tests
1350 0.09_02 Tues. May 16, 2006
1351 ++ DEVELOPER RELEASE ++
1353 - added prototypes to the exported subs
1357 - added prototypes to the exported subs
1360 * Moose::Util::TypeConstraints
1361 - cleaned up prototypes for the subs
1364 0.09_01 Fri. May 12, 2006
1365 ++ DEVELOPER RELEASE ++
1366 - This release works in combination with
1367 Class::MOP 0.29_01, it is a developer
1368 release because it uses the a new
1369 instance sub-protocol and a fairly
1370 complete Role implementation. It has
1371 not yet been optimized, so it slower
1372 the the previous CPAN version. This
1373 release also lacks good updated docs,
1374 the official release will have updated docs.
1377 - refactored the keyword exports
1378 - 'with' now checks Role validaity and
1379 accepts more than one Role at a time
1380 - 'extends' makes metaclass adjustments as
1381 needed to ensure metaclass compatability
1384 - refactored the keyword exports
1385 - 'with' now checks Role validaity and
1386 accepts more than one Role at a time
1388 * Moose::Util::TypeConstraints
1389 - added the 'enum' keyword for simple
1390 string enumerations which can be used as
1392 - see example of usage in t/202_example.t
1395 - more careful checking of params to new()
1398 - much work done on the role composition
1399 - many new tests for conflict detection
1400 and composition edge cases
1401 - not enough documentation, I suggest
1402 looking at the tests
1404 * Moose::Meta::Instance
1405 - added new Instance metaclass to support
1406 the new Class::MOP instance protocol
1408 * Moose::Meta::Class
1409 - some small changes to support the new
1411 - some small additions to support Roles
1413 * Moose::Meta::Attribute
1414 - some improvements to the accessor generation code
1416 - some small changes to support the new
1418 - (still somewhat) experimental delegation support
1419 with the 'handles' option
1420 - added several tests for this
1421 - no docs for this yet
1423 0.05 Thurs. April 27, 2006
1425 - keywords are now exported with Sub::Exporter
1426 thanks to chansen for this commit
1427 - has keyword now takes a 'metaclass' option
1428 to support custom attribute meta-classes
1429 on a per-attribute basis
1430 - added tests for this
1431 - the 'has' keyword not accepts inherited slot
1432 specifications (has '+foo'). This is still an
1433 experimental feature and probably not finished
1434 see t/038_attribute_inherited_slot_specs.t for
1435 more details, or ask about it on #moose
1436 - added tests for this
1439 - keywords are now exported with Sub::Exporter
1441 * Moose::Utils::TypeConstraints
1442 - reorganized the type constraint hierarchy, thanks
1443 to nothingmuch and chansen for his help and advice
1445 - added some tests for this
1446 - keywords are now exported with Sub::Exporter
1447 thanks to chansen for this commit
1449 * Moose::Meta::Class
1450 - due to changes in Class::MOP, we had to change
1451 construct_instance (for the better)
1453 * Moose::Meta::Attribute
1454 - due to changes in Class::MOP, we had to add the
1455 initialize_instance_slot method (it's a good thing)
1457 * Moose::Meta::TypeConstraint
1458 - added type constraint unions
1459 - added tests for this
1460 - added the is_subtype_of predicate method
1461 - added tests for this
1463 0.04 Sun. April 16th, 2006
1465 - Roles can now consume other roles
1466 - added tests for this
1467 - Roles can specify required methods now with
1468 the requires() keyword
1469 - added tests for this
1472 - ripped out much of it's guts ,.. much cleaner now
1473 - added required methods and correct handling of
1474 them in apply() for both classes and roles
1475 - added tests for this
1476 - no longer adds a does() method to consuming classes
1477 it relys on the one in Moose::Object
1478 - added roles attribute and some methods to support
1479 roles consuming roles
1481 * Moose::Meta::Attribute
1482 - added support for triggers on attributes
1483 - added tests for this
1484 - added support for does option on an attribute
1485 - added tests for this
1487 * Moose::Meta::Class
1488 - added support for attribute triggers in the
1490 - added tests for this
1493 - Moose no longer creates a subtype for your class
1494 if a subtype of the same name already exists, this
1495 should DWIM in 99.9999% of all cases
1497 * Moose::Util::TypeConstraints
1498 - fixed bug where incorrect subtype conflicts were
1500 - added test for this
1503 - this class can now be extended with 'use base' if
1504 you need it, it properly loads the metaclass class now
1505 - added test for this
1507 0.03_02 Wed. April 12, 2006
1509 - you must now explictly use Moose::Util::TypeConstraints
1510 it no longer gets exported for you automatically
1513 - new() now accepts hash-refs as well as key/value lists
1514 - added does() method to check for Roles
1515 - added tests for this
1517 * Moose::Meta::Class
1518 - added roles attribute along with the add_role() and
1520 - added tests for this
1523 - now adds a does() method to consuming classes
1524 which tests the class's hierarchy for roles
1525 - added tests for this
1527 0.03_01 Mon. April 10, 2006
1529 - added new Role recipe (no content yet, only code)
1532 - added 'with' keyword for Role support
1533 - added test and docs for this
1534 - fixed subtype quoting bug
1535 - added test for this
1539 - added test and docs
1541 * Moose::Util::TypeConstraints
1542 - added the message keyword to add custom
1543 error messages to type constraints
1546 - the meta role to support Moose::Role
1547 - added tests and docs
1549 * Moose::Meta::Class
1550 - moved a number of things from Moose.pm
1551 to here, they should have been here
1554 * Moose::Meta::Attribute
1555 - moved the attribute option macros here
1556 instead of putting them in Moose.pm
1558 * Moose::Meta::TypeConstraint
1559 - added the message attributes and the
1561 - added tests and docs for this
1563 0.03 Thurs. March 30, 2006
1565 - added the Moose::Cookbook with 5 recipes,
1566 describing all the stuff Moose can do.
1569 - fixed an issue with &extends super class loading
1570 it now captures errors and deals with inline
1571 packages correctly (bug found by mst, solution
1573 - added super/override & inner/augment features
1574 - added tests and docs for these
1577 - BUILDALL now takes a reference of the %params
1578 that are passed to &new, and passes that to
1581 * Moose::Util::TypeConstraints
1582 - Type constraints now survive runtime reloading
1583 - added test for this
1585 * Moose::Meta::Class
1586 - fixed the way attribute defaults are handled
1587 during instance construction (bug found by chansen)
1589 * Moose::Meta::Attribute
1590 - read-only attributes now actually enforce their
1591 read-only-ness (this corrected in Class::MOP as
1594 0.02 Tues. March 21, 2006
1596 - many more tests, fixing some bugs and
1598 - &extends now loads the base module with
1600 - added UNIVERSAL::require to the
1603 - each new Moose class will also create
1604 and register a subtype of Object which
1605 correspond to the new Moose class.
1606 - the 'isa' option in &has now only
1607 accepts strings, and will DWIM in
1610 * Moose::Util::TypeConstraints
1611 - added type coercion features
1612 - added tests for this
1613 - added support for this in attributes
1614 and instance construction
1616 - type construction no longer creates a
1617 function, it registers the type instead.
1618 - added several functions to get the
1622 - BUILDALL and DEMOLISHALL were broken
1623 because of a mis-named hash key, Whoops :)
1625 * Moose::Meta::Attribute
1626 - adding support for coercion in the
1627 autogenerated accessors
1629 * Moose::Meta::Class
1630 - adding support for coercion in the
1631 instance construction
1633 * Moose::Meta::TypeConstraint
1634 * Moose::Meta::TypeCoercion
1635 - type constraints and coercions are now
1636 full fledges meta-objects
1638 0.01 Wed. March 15, 2006
1639 - Moooooooooooooooooose!!!