1 Revision history for Perl extension Moose
4 * fixing some misc. bits in the docs that
5 got mentioned on CPAN Forum
7 0.26 Thurs. Sept. 27, 2007
11 We now support parameterized collection types, such as:
12 ArrayRef[Int] # array or integers
13 HashRef[Object] # a hash with object values
14 They can also be nested:
15 ArrayRef[HashRef[RegExpr]] # an array of hashes with regexpr values
16 And work with the type unions as well:
17 ArrayRef[Int | Str] # array of integers of strings
19 * Better Framework Extendability
20 Moose.pm is now "extendable" such that it is now much
21 easier to extend the framework and add your own keywords
22 and customizations. See the "EXTENDING AND EMBEDDING MOOSE"
23 section of the Moose.pm docs.
26 In an effort to begin documenting some of the various
27 details of Moose as well as some common idioms, we have
28 created Moose::Cookbook::Snacks as a place to find
29 small (easily digestable) nuggets of Moose code.
32 ~ Several doc updates/cleanup thanks to castaway ~
34 - converted build system to use Module::Install instead of
35 Module::Build (thanks to jrockway)
38 - added all the meta classes to the immutable list and
39 set it to inline the accessors
40 - fix import to allow Sub::Exporter like { into => }
41 and { into_level => } (perigrin)
42 - exposed and documented init_meta() to allow better
43 embedding and extending of Moose (perigrin)
46 - complete re-organization of the test suite
47 - added some new tests as well
48 - finally re-enabled the Moose::POOP test since
49 the new version of DBM::Deep now works again
53 - fixed very odd and very nasty recursion bug with
55 - added tests for this (eilara)
57 * Moose::Meta::Attribute
58 Moose::Meta::Method::Constructor
59 Moose::Meta::Method::Accessor
60 - fixed issue with overload::Overloaded getting called
61 on non-blessed items. (RT #29269)
62 - added tests for this
64 * Moose::Meta::Method::Accessor
65 - fixed issue with generated accessor code making
66 assumptions about hash based classes (thanks to dexter)
68 * Moose::Coookbook::Snacks
69 - these are bits of documentation, not quite as big as
70 Recipes but which have no clear place in the module docs.
71 So they are Snacks! (horray for castaway++)
73 * Moose::Cookbook::Recipe4
74 - updated it to use the new ArrayRef[MyType] construct
75 - updated the accompanying test as well
77 +++ Major Refactor of the Type Constraint system +++
78 +++ with new features added as well +++
80 * Moose::Util::TypeConstraint
81 - no longer uses package variable to keep track of
82 the type constraints, now uses the an instance of
83 Moose::Meta::TypeConstraint::Registry to do it
84 - added more sophisticated type notation parsing
86 - added tests for this
88 * Moose::Meta::TypeConstraint
89 - some minor adjustments to make subclassing easier
90 - added the package_defined_in attribute so that we
91 can track where the type constraints are created
93 * Moose::Meta::TypeConstraint::Union
94 - this is now been refactored to be a subclass of
95 Moose::Meta::TypeConstraint
97 * Moose::Meta::TypeCoercion::Union
98 - this has been added to service the newly refactored
99 Moose::Meta::TypeConstraint::Union and is itself
100 a subclass of Moose::Meta::TypeCoercion
102 * Moose::Meta::TypeConstraint::Parameterized
103 - added this module (taken from MooseX::AttributeHelpers)
104 to help construct nested collection types
105 - added tests for this
107 * Moose::Meta::TypeConstraint::Registry
108 - added this class to keep track of type constraints
110 0.25 Mon. Aug. 13, 2007
112 - Documentation update to reference Moose::Util::TypeConstraints
113 under 'isa' in 'has' for how to define a new type
116 * Moose::Meta::Attribute
117 - required attributes now will no longer accept undef
118 from the constructor, even if there is a default and lazy
119 - added tests for this
120 - default subroutines must return a value which passes the
122 - added tests for this
124 * Moose::Meta::Attribute
125 * Moose::Meta::Method::Constructor
126 * Moose::Meta::Method::Accessor
127 - type-constraint tests now handle overloaded objects correctly
129 - added tests for this (thanks to EvanCarroll)
131 * Moose::Meta::TypeConstraint::Union
132 - added (has_)hand_optimized_constraint to this class so that
133 it behaves as the regular Moose::Meta::TypeConstraint does.
136 - large refactoring of this code
137 - added several more tests
138 - tests for subtle conflict resolition issues
139 added, but not currently running
142 * Moose::Cookbook::Recipe7
143 - added new recipe for augment/inner functionality
145 - added test for this
148 - a formal definition of roles (still in progress)
151 - utilities for easier working with Moose classes
152 - added tests for these
155 - This contains Moose specific test functions
156 - added tests for these
158 0.24 Tues. July 3, 2007
159 ~ Some doc updates/cleanup ~
161 * Moose::Meta::Attribute
162 - added support for roles to be given as parameters
163 to the 'handles' option.
164 - added tests and docs for this
165 - the has '+foo' attribute form now accepts changes to
166 the lazy option, and the addition of a handles option
167 (but not changing the handles option)
168 - added tests and docs for this
171 - required methods are now fetched using find_method_by_name
172 so that required methods can come from superclasses
173 - adjusted tests for this
175 0.23 Mon. June 18, 2007
176 * Moose::Meta::Method::Constructor
177 - fix inlined constructor for hierarchy with multiple BUILD methods (mst)
179 - Modify make_immutable to work with the new Class::MOP immutable
180 mechanism + POD + very basic test (groditi)
181 * Moose::Meta::Attribute
182 - Fix handles to use goto() so that caller() comes out properly on
183 the other side (perigrin)
185 0.22 Thurs. May 31, 2007
186 * Moose::Util::TypeConstraints
187 - fix for prototype undeclared issue when Moose::Util::TypeConstraints
188 loaded before consumers (e.g. Moose::Meta::Attribute) by predeclaring
189 prototypes for functions
190 - added the ClassName type constraint, this checks for strings
191 which will respond true to ->isa(UNIVERSAL).
192 - added tests and docs for this
193 - subtyping just in name now works correctly by making the
194 default for where be { 1 }
195 - added test for this
197 * Moose::Meta::Method::Accessor
198 - coerce and lazy now work together correctly, thanks to
199 merlyn for finding this bug
200 - tests added for this
201 - fix reader presedence bug in Moose::Meta::Attribute + tests
204 - Foo->new(undef) now gets ignored, it is assumed you meant to pass
205 a HASH-ref and missed. This produces better error messages then
206 having it die cause undef is not a HASH.
207 - added tests for this
209 0.21 Thursday, May 2nd, 2007
211 - added SUPER_SLOT and INNER_SLOT class hashes to support unimport
212 - modified unimport to remove super and inner along with the rest
213 - altered unimport tests to handle this
216 - altered super export to populate SUPER_SLOT
219 - altered augment and override modifier application to use *_SLOT
220 - modified tests for these to unimport one test class each to test
223 - fixed issue where custom attribute metaclasses
224 where not handled correctly in roles
225 - added tests for this
228 - fixed issue where extending metaclasses with
229 roles would blow up. Thanks to Aankhen`` for
230 finding this insidious error, and it's solution.
232 ~~ lots of spelling and grammer fixes in the docs,
233 many many thanks to rlb3 and Aankhen for these :)
235 0.20 Friday, April 6th, 2007
236 >> I messed up the SKIP logic in one test
237 so this release is just to fix that.
240 - 'has' now also accepts an ARRAY ref
241 to create multiple attrs (see docs)
242 (thanks to konobi for this)
243 - added tests and docs
245 0.19 Thurs. April 5th, 2007
246 ~~ More documentation updates ~~
248 * Moose::Util::TypeConstraints
249 - 'type' now supports messages as well
250 thanks to phaylon for finding this
251 - added tests for this
252 - added &list_all_type_constraints and
253 &list_all_builtin_type_constraints
254 functions to facilitate introspection.
256 * Moose::Meta::Attribute
257 - fixed regexp 'handles' declarations
258 to build the list of delegated methods
259 correctly (and not override important
260 things like &new) thanks to ashleyb
262 - added tests and docs for this
263 - added the 'documentation' attributes
264 so that you can actually document your
265 attributes and inspect them through the
267 - added tests and docs for this
270 - when loading custom attribute metaclasses
271 it will first look in for the class in the
272 Moose::Meta::Attribute::Custom::$name, and
273 then default to just loading $name.
274 - added tests and docs for this
276 * Moose::Meta::TypeConstraint
277 - type constraints now stringify to their names.
278 - added test for this
281 - added tests to assure we work with Module::Refresh
282 - added stricter test skip logic in the Moose POOP
283 test, ask Rob Kinyon why.
284 - *cough* DBM::Deep 1.0 backwards compatability sucks *cough* ;)
286 0.18 Sat. March 10, 2007
287 ~~ Many, many documentation updates ~~
290 - We now use Class::MOP::load_class to
292 - added tests to show types and subtypes
293 working with Declare::Constraints::Simple
294 and Test::Deep as constraint engines.
297 !! You must have Class::MOP 0.37_001 !!
298 !! for this developer release to work !!
300 This release was primarily adding the immutable
301 feature to Moose. An immutable class is one which
302 you promise not to alter. When you set the class
303 as immutable it will perform various bits of
304 memoization and inline certain part of the code
305 (constructors, destructors and accessors). This
306 minimizes (and in some cases totally eliminates)
307 one of Moose's biggest performance hits. This
308 feature is not on by default, and is 100% optional.
309 It has several configurable bits as well, so you
310 can pick and choose to your specific needs.
312 The changes involved in this were fairly wide and
313 highly specific, but 100% backwards compatible, so
314 I am not going to enumerate them here. If you are
315 truely interested in what was changed, please do
318 0.17 Tues. Nov. 14, 2006
319 * Moose::Meta::Method::Accessor
320 - bugfix for read-only accessors which
321 are have a type constraint and lazy.
322 Thanks to chansen for finding it.
324 0.16 Tues. Nov. 14, 2006
326 There are some speed improvements in this release,
327 but they are only the begining, so stay tuned.
330 - BUILDALL and DEMOLISHALL no longer get
331 called unless they actually need to be.
332 This gave us a signifigant speed boost
333 for the cases when there is no BUILD or
334 DEMOLISH method present.
336 * Moose::Util::TypeConstraints
337 * Moose::Meta::TypeConstraint
338 - added an 'optimize_as' option to the
339 type constraint, which allows for a
340 hand optimized version of the type
341 constraint to be used when possible.
342 - Any internally created type constraints
343 now provide an optimized version as well.
345 0.15 Sun. Nov. 5, 2006
347 This version of Moose *must* have Class::MOP 0.36 in order
348 to work correctly. A number of small internal tweaks have
349 been made in order to be compatible with that release.
351 * Moose::Util::TypeConstraints
352 - added &unimport so that you can clean out
353 your class namespace of these exported
357 - fixed minor issue which occasionally
358 comes up during global destruction
360 - moved Moose::Meta::Method::Overriden into
364 - moved Moose::Meta::Role::Method into
367 * Moose::Meta::Attribute
368 - changed how we do type checks so that
369 we reduce the overall cost, but still
372 - moved accessor generation methods to
373 Moose::Meta::Method::Accessor to
374 conform to the API changes from
377 * Moose::Meta::TypeConstraint
378 - changed how constraints are compiled
379 so that we do less recursion and more
380 iteration. This makes the type check
382 - moved Moose::Meta::TypeConstraint::Union
385 * Moose::Meta::Method::Accessor
386 - created this from methods formerly found in
387 Moose::Meta::Attribute
389 * Moose::Meta::Role::Method
390 - moved this from Moose::Meta::Role
392 * Moose::Meta::Method::Overriden
393 - moved this from Moose::Meta::Class
395 * Moose::Meta::TypeConstraint::Union
396 - moved this from Moose::Meta::TypeConstraint
398 0.14 Mon. Oct. 9, 2006
400 * Moose::Meta::Attribute
401 - fixed lazy attributes which were not getting
402 checked with the type constraint (thanks ashley)
403 - added tests for this
404 - removed the over-enthusiastic DWIMery of the
405 automatic ArrayRef and HashRef defaults, it
406 broke predicates in an ugly way.
407 - removed tests for this
409 0.13 Sat. Sept. 30, 2006
411 This version of Moose *must* have Class::MOP 0.35 in order
412 to work correctly. A number of small internal tweaks have
413 been made in order to be compatible with that release.
416 - Removed the use of UNIVERSAL::require to be a better
417 symbol table citizen and remove a dependency
418 (thanks Adam Kennedy)
420 **~~ removed experimental & undocumented feature ~~**
421 - commented out the 'method' and 'self' keywords, see the
422 comments for more info.
425 - added a FAQ and WTF files to document frequently
426 asked questions and common problems
428 * Moose::Util::TypeConstraints
429 - added GlobRef and FileHandle type constraint
430 - added tests for this
432 * Moose::Meta::Attribute
433 - if your attribute 'isa' ArrayRef of HashRef, and you have
434 not explicitly set a default, then make the default DWIM.
435 This will also work for subtypes of ArrayRef and HashRef
437 - you can now auto-deref subtypes of ArrayRef or HashRef too.
438 - new test added for this (thanks to ashley)
441 - added basic support for runtime role composition
442 but this is still *highly experimental*, so feedback
443 is much appreciated :)
444 - added tests for this
446 * Moose::Meta::TypeConstraint
447 - the type constraint now handles the coercion process
448 through delegation, this is to support the coercion
451 * Moose::Meta::TypeConstraint::Union
452 - it is now possible for coercions to be performed
454 - added tests for this (thanks to konobi)
456 * Moose::Meta::TypeCoercion
457 - properly capturing error when type constraint
461 - Scalar::Util 1.18 is bad on Win32, so temporarily
462 only require version 1.17 for Win32 and cygwin.
463 (thanks Adam Kennedy)
465 0.12 Sat. Sept. 1, 2006
467 - Recipe5 (subtypes & coercion) has been written
470 - fixed "bad meta" error message to be more descriptive
471 - fixed &unimport to not remove the &inner and &super
472 keywords because we need to localize them.
473 - fixed number of spelling/grammer issues, thanks Theory :)
475 **~~ experimental & undocumented feature ~~**
476 - added the method and self keywords, they are basically
477 just sugar, and they may not stay around.
480 - added &dump method to easily Data::Dumper
483 * Moose::Meta::TypeConstraint
484 - added the &is_a_type_of method to check both the current
485 and the subtype of a method (similar to &isa with classes)
488 - this is now a subclass of Class::MOP::Module, and no longer
489 creates the _role_meta ugliness of before.
490 - fixed tests to reflect this change
492 0.11 Wed. July 12, 2006
494 - added an &unimport method to remove all the keywords
495 that Moose will import, simply add 'no Moose' to the
496 bottom of your class file.
499 - fixed some test failures caused by a forgotten test
502 0.10 Thurs. July 6, 2006
504 - improved error message when loading modules so
505 it is less confusing when you load a role.
506 - added &calculate_all_roles method to
507 Moose::Meta::Class and Moose::Meta::Role
510 This module has been tested against Class::MOP 0.30
511 but it does not yet utilize the optimizations
512 it makes available. Stay tuned for that ;)
514 0.09_03 Fri. June 23, 2006
515 ++ DEVELOPER RELEASE ++
517 - 'use strict' and 'use warnings' are no longer
518 needed in Moose classes, Moose itself will
519 turn them on for you.
520 - added tests for this
521 - moved code from exported subs to private methods
522 in Moose::Meta::Class
525 - as with Moose, strict and warnings are
526 automatically turned on for you.
527 - added tests for this
530 - now handles an edge case for override errors
531 - added tests for this
532 - added some more edge case tests
534 0.09_02 Tues. May 16, 2006
535 ++ DEVELOPER RELEASE ++
537 - added prototypes to the exported subs
541 - added prototypes to the exported subs
544 * Moose::Util::TypeConstraints
545 - cleaned up prototypes for the subs
548 0.09_01 Fri. May 12, 2006
549 ++ DEVELOPER RELEASE ++
550 - This release works in combination with
551 Class::MOP 0.29_01, it is a developer
552 release because it uses the a new
553 instance sub-protocol and a fairly
554 complete Role implementation. It has
555 not yet been optimized, so it slower
556 the the previous CPAN version. This
557 release also lacks good updated docs,
558 the official release will have updated docs.
561 - refactored the keyword exports
562 - 'with' now checks Role validaity and
563 accepts more than one Role at a time
564 - 'extends' makes metaclass adjustments as
565 needed to ensure metaclass compatability
568 - refactored the keyword exports
569 - 'with' now checks Role validaity and
570 accepts more than one Role at a time
572 * Moose::Util::TypeConstraints
573 - added the 'enum' keyword for simple
574 string enumerations which can be used as
576 - see example of usage in t/202_example.t
579 - more careful checking of params to new()
582 - much work done on the role composition
583 - many new tests for conflict detection
584 and composition edge cases
585 - not enough documentation, I suggest
588 * Moose::Meta::Instance
589 - added new Instance metaclass to support
590 the new Class::MOP instance protocol
593 - some small changes to support the new
595 - some small additions to support Roles
597 * Moose::Meta::Attribute
598 - some improvements to the accessor generation code
600 - some small changes to support the new
602 - (still somewhat) experimental delegation support
603 with the 'handles' option
604 - added several tests for this
605 - no docs for this yet
607 0.05 Thurs. April 27, 2006
609 - keywords are now exported with Sub::Exporter
610 thanks to chansen for this commit
611 - has keyword now takes a 'metaclass' option
612 to support custom attribute meta-classes
613 on a per-attribute basis
614 - added tests for this
615 - the 'has' keyword not accepts inherited slot
616 specifications (has '+foo'). This is still an
617 experimental feature and probably not finished
618 see t/038_attribute_inherited_slot_specs.t for
619 more details, or ask about it on #moose
620 - added tests for this
623 - keywords are now exported with Sub::Exporter
625 * Moose::Utils::TypeConstraints
626 - reorganized the type constraint hierarchy, thanks
627 to nothingmuch and chansen for his help and advice
629 - added some tests for this
630 - keywords are now exported with Sub::Exporter
631 thanks to chansen for this commit
634 - due to changes in Class::MOP, we had to change
635 construct_instance (for the better)
637 * Moose::Meta::Attribute
638 - due to changes in Class::MOP, we had to add the
639 initialize_instance_slot method (it's a good thing)
641 * Moose::Meta::TypeConstraint
642 - added type constraint unions
643 - added tests for this
644 - added the is_subtype_of predicate method
645 - added tests for this
647 0.04 Sun. April 16th, 2006
649 - Roles can now consume other roles
650 - added tests for this
651 - Roles can specify required methods now with
652 the requires() keyword
653 - added tests for this
656 - ripped out much of it's guts ,.. much cleaner now
657 - added required methods and correct handling of
658 them in apply() for both classes and roles
659 - added tests for this
660 - no longer adds a does() method to consuming classes
661 it relys on the one in Moose::Object
662 - added roles attribute and some methods to support
663 roles consuming roles
665 * Moose::Meta::Attribute
666 - added support for triggers on attributes
667 - added tests for this
668 - added support for does option on an attribute
669 - added tests for this
672 - added support for attribute triggers in the
674 - added tests for this
677 - Moose no longer creates a subtype for your class
678 if a subtype of the same name already exists, this
679 should DWIM in 99.9999% of all cases
681 * Moose::Util::TypeConstraints
682 - fixed bug where incorrect subtype conflicts were
684 - added test for this
687 - this class can now be extended with 'use base' if
688 you need it, it properly loads the metaclass class now
689 - added test for this
691 0.03_02 Wed. April 12, 2006
693 - you must now explictly use Moose::Util::TypeConstraints
694 it no longer gets exported for you automatically
697 - new() now accepts hash-refs as well as key/value lists
698 - added does() method to check for Roles
699 - added tests for this
702 - added roles attribute along with the add_role() and
704 - added tests for this
707 - now adds a does() method to consuming classes
708 which tests the class's hierarchy for roles
709 - added tests for this
711 0.03_01 Mon. April 10, 2006
713 - added new Role recipe (no content yet, only code)
716 - added 'with' keyword for Role support
717 - added test and docs for this
718 - fixed subtype quoting bug
719 - added test for this
723 - added test and docs
725 * Moose::Util::TypeConstraints
726 - added the message keyword to add custom
727 error messages to type constraints
730 - the meta role to support Moose::Role
731 - added tests and docs
734 - moved a number of things from Moose.pm
735 to here, they should have been here
738 * Moose::Meta::Attribute
739 - moved the attribute option macros here
740 instead of putting them in Moose.pm
742 * Moose::Meta::TypeConstraint
743 - added the message attributes and the
745 - added tests and docs for this
747 0.03 Thurs. March 30, 2006
749 - added the Moose::Cookbook with 5 recipes,
750 describing all the stuff Moose can do.
753 - fixed an issue with &extends super class loading
754 it now captures errors and deals with inline
755 packages correctly (bug found by mst, solution
757 - added super/override & inner/augment features
758 - added tests and docs for these
761 - BUILDALL now takes a reference of the %params
762 that are passed to &new, and passes that to
765 * Moose::Util::TypeConstraints
766 - Type constraints now survive runtime reloading
767 - added test for this
770 - fixed the way attribute defaults are handled
771 during instance construction (bug found by chansen)
773 * Moose::Meta::Attribute
774 - read-only attributes now actually enforce their
775 read-only-ness (this corrected in Class::MOP as
778 0.02 Tues. March 21, 2006
780 - many more tests, fixing some bugs and
782 - &extends now loads the base module with
784 - added UNIVERSAL::require to the
787 - each new Moose class will also create
788 and register a subtype of Object which
789 correspond to the new Moose class.
790 - the 'isa' option in &has now only
791 accepts strings, and will DWIM in
794 * Moose::Util::TypeConstraints
795 - added type coercion features
796 - added tests for this
797 - added support for this in attributes
798 and instance construction
800 - type construction no longer creates a
801 function, it registers the type instead.
802 - added several functions to get the
806 - BUILDALL and DEMOLISHALL were broken
807 because of a mis-named hash key, Whoops :)
809 * Moose::Meta::Attribute
810 - adding support for coercion in the
811 autogenerated accessors
814 - adding support for coercion in the
815 instance construction
817 * Moose::Meta::TypeConstraint
818 * Moose::Meta::TypeCoercion
819 - type constraints and coercions are now
820 full fledges meta-objects
822 0.01 Wed. March 15, 2006
823 - Moooooooooooooooooose!!!