some minor tweaks
[gitmo/Moose.git] / Changes
CommitLineData
e522431d 1Revision history for Perl extension Moose
2
45fd4af3 30.35
4 * Moose::Meta::Method::Constructor
5 - fix to make sure even Class::MOP attributes
472b7401 6 are handled correctly (Thanks to Dave Rolsky)
c3b35392 7 - added test for this (also Dave Rolsky)
4498537c 8
9 * Moose::Meta::Class
10 - improved error message on _apply_all_roles,
11 you should now use Moose::Util::apply_all_roles
12 and you shouldnt have been using a _ prefixed
13 method in the first place ;)
45fd4af3 14
fe05ce9c 150.34 Mon. Jan. 21, 2008
778db3ac 16 ~~~ more misc. doc. fixes ~~~
17 ~~ updated copyright dates ~~
9b28d20b 18
19 Moose is now a postmodern object system :)
8bdc7f13 20 - (see the POD for details)
4734114b 21
22 * <<Role System Refactoring>>
23 - this release contains a major reworking and
24 cleanup of the role system
9b28d20b 25 - 100% backwards compat.
26 - Role application now restructured into seperate
27 classes based on type of applicants
28 - Role summation (combining of more than one role)
4734114b 29 is much cleaner and anon-classes are no longer
9b28d20b 30 used in this process
4734114b 31 - new Composite role metaclass
9b28d20b 32 - runtime application of roles to instances
33 is now more efficient and re-uses generated
34 classes when applicable
4734114b 35
9b28d20b 36 * <<New Role composition features>>
4734114b 37 - methods can now be excluded from a given role
9b28d20b 38 during composition
4734114b 39
40 with 'My::Role' => { excludes => [qw/method1 method2/] };
41
42 - methods can now be aliased to another name (and
43 still retain the original as well)
44
fe05ce9c 45 with 'My::Role' => {
46 alias => {
4734114b 47 method1 => method1_aliased
48 }
49 };
50
51 * <<New Attribute traits>>
52 - allows arbitrary roles to be applied to attribute metaobjects
53 to allow better combination of custom attribute features. Docs
54 are coming soon for this feature.
55
56 * <<New Maybe[$type] parameterized type>>
57 - added this new type which basically means the value is
58 of $type or it is undef
59
60 ====
61
d7d8a8c7 62 * Moose
63 Moose::Role
4734114b 64 - now uses the Moose::Util::apply_all_roles to deal
d7d8a8c7 65 with role application
4734114b 66
d7d8a8c7 67 * Moose::Util
68 - added the &apply_all_roles function
4734114b 69
70 * Moose::Util::TypeConstraints
71 - all optimized type constraint subs are now
72 pulled from the Moose::Util::TypeConstraints::OptimizedConstraints
73 module (thanks to nothingmuch)
74 - improved support for the IO:: family of modules within the
75 FileHandle type constraint
76
77 * Moose::Util::TypeConstraints::OptimizedConstraints
78 - added this module (see above)
79
d7d8a8c7 80 * Moose::Meta::Class
81 - fixed the &_process_attribute method to be called
4734114b 82 by &add_attribute, so that the API is now correct
83
e7c06c1e 84 * Moose::Meta::Method::Accessor
4734114b 85 - fixed bug when passing a list of values to
e7c06c1e 86 an accessor would get (incorrectly) ignored.
87 Thanks to Sartak for finding this ;)
88 - added tests for this (Sartak again)
32dd4a95 89
a4e516f6 90 * Moose::Meta::Method::Accessor
91 Moose::Meta::Method::Constructor
28412c0b 92 Moose::Meta::Attribute
4734114b 93 Moose::Meta::TypeConstraint
94 Moose::Meta::TypeCoercion
95 - lots of cleanup of such things as:
28412c0b 96 - generated methods
97 - type constraint handling
4734114b 98 - error handling/messages
99 (thanks to nothingmuch)
a4e516f6 100
4734114b 101 * Moose::Meta::TypeConstraint::Parameterizable
102 - added this module to support the refactor
103 in Moose::Meta::TypeConstraint::Parameterized
104
105 * Moose::Meta::TypeConstraint::Parameterized
106 - refactored how these types are handled so they
107 are more generic and not confined to ArrayRef
108 and HashRef only
a4e516f6 109
2de7e794 110 * t/
111 - shortened some file names for better VMS support (RT #32381)
112
25374f01 1130.33 Fri. Dec. 14, 2007
32dd4a95 114 !! Moose now loads 2 x faster !!
115 !! with new Class::MOP 0.49 !!
25374f01 116
f7865ec8 117 ++ new oose.pm module to make command line
25374f01 118 Moose-ness easier (see POD docs for more)
4734114b 119
25374f01 120 * Moose::Meta::Class
121 * Moose::Meta::Role
4734114b 122 - several tweaks to take advantage of the
25374f01 123 new method map caching in Class::MOP
124
39aba5c9 125 * Moose::Meta::TypeConstraint::Parameterized
126 - allow subtypes of ArrayRef and HashRef to
acb8a5db 127 be used as a container (sartak)
4734114b 128 - added tests for this
acb8a5db 129 - basic support for coercion to ArrayRef and
130 HashRef for containers (sartak)
4734114b 131 - added tests for this
132
25374f01 133 * Moose::Meta::TypeCoercion
134 - coercions will now create subtypes as needed
135 so you can now add coercions to parameterized
136 types without having to explictly define them
137 - added tests for this
138
ac211120 139 * Moose::Meta::Method::Accessor
140 - allow subclasses to decide whether we need
141 to copy the value into a new variable (sartak)
39aba5c9 142
dc26a424 1430.32 Tues. Dec. 4, 2007
8de73ff1 144 * Moose::Util::TypeConstraints
145 - fixing how subtype aliases of unions work
146 they should inherit the parent's coercion
147 - added tests for this
4734114b 148 - you can now define multiple coercions on
41e007e4 149 a single type at different times instead of
150 having to do it all in one place
151 - added tests for this
4734114b 152
8de73ff1 153 * Moose::Meta::TypeConstraint
154 - there is now a default constraint of sub { 1 }
155 instead of Moose::Util::TypeConstraints setting
156 this for us
157
4734114b 158 * Moose::Meta::TypeCoercion
159 * Moose::Meta::TypeCoercion::Union
160 - added the &has_coercion_for_type and
161 &add_type_coercions methods to support the
41e007e4 162 new features above (although you cannot add
163 more type coercions for Union types)
164
ffcb48b4 1650.31 Mon. Nov. 26, 2007
f3c4e20e 166 * Moose::Meta::Attribute
4734114b 167 - made the +attr syntax handle extending types with
f3c4e20e 168 parameters. So "has '+foo' => (isa => 'ArrayRef[Int]')"
169 now works if the original foo is an ArrayRef.
170 - added tests for this.
171 - delegation now works even if the attribute does not
172 have a reader method using the get_read_method_ref
4734114b 173 method from Class::MOP::Attribute.
f3c4e20e 174 - added tests for this
175 - added docs for this
4734114b 176
f3c4e20e 177 * Moose::Util::TypeConstraints
4734114b 178 - passing no "additional attribute info" to
179 &find_or_create_type_constraint will no longer
180 attempt to create an __ANON__ type for you,
f3c4e20e 181 instead it will just return undef.
182 - added docs for this
183
1edfdf1c 1840.30 Fri. Nov. 23, 2007
ca168e89 185 * Moose::Meta::Method::Constructor
186 -builder related bug in inlined constructor. (groditi)
187
3822d5ee 188 * Moose::Meta::Method::Accessor
189 - genereate unnecessary calls to predicates and refactor
190 code generation for runtime speed (groditi)
191
5d776bdf 192 * Moose::Util::TypeConstraints
0e0709ea 193 - fix ClassName constraint to introspect symbol table (mst)
a0f8153d 194 - added more tests for this (mst)
195 - fixed it so that subtype 'Foo' => as 'HashRef[Int]' ...
196 with work correctly.
197 - added tests for this
5d776bdf 198
1edfdf1c 199 * Moose::Cookbook
200 - adding the link to Recipie 11 (written by Sartak)
201 - adding test for SYNOPSIS code
202
4734114b 203 * t/
ca168e89 204 - New tests for builder bug. Upon instantiation, if an
205 attribute had a builder, no value and was not lazy the
206 builder default was not getting run, oops. (groditi)
207
b97b9655 2080.29 Tues. Nov. 13, 2007
0b26305c 209 * Moose::Meta::Attribute
5d776bdf 210 - Fix error message on missing builder method (groditi)
0b26305c 211
212 * Moose::Meta::Method::Accessor
5d776bdf 213 - Fix error message on missing builder method (groditi)
0b26305c 214
4734114b 215 * t/
5d776bdf 216 - Add test to check for the correct error message when
217 builder method is missing (groditi)
0b26305c 218
98c4c382 2190.28 Tues. Nov. 13, 2007
4734114b 220 - 0.27 packaged incorrectly (groditi)
98c4c382 221
e134cd19 2220.27 Tues. Nov. 13, 2007
26fbace8 223 * Moose::Meta::Attribute
224 - Added support for the new builder option (groditi)
6af1a927 225 - Added support for lazy_build option (groditi)
1ed0b94f 226 - Changed slot initialization for predicate changes (groditi)
26fbace8 227
228 * Moose::Meta::Method::Accessor
6af1a927 229 - Added support for lazy_build option (groditi)
4734114b 230 - Fix inline methods to work with corrected predicate
28669f89 231 behavior (groditi)
26fbace8 232
7a5b07b3 233 * Moose::Meta::Method::Constructor
234 - Added support for lazy_build option (groditi)
235
26fbace8 236 * t/
28669f89 237 - tests for builder and lazy_build (groditi)
26fbace8 238
4734114b 239 * fixing some misc. bits in the docs that
28669f89 240 got mentioned on CPAN Forum & perlmonks
4734114b 241
e7f8d0c2 242 * Moose::Meta::Role
4734114b 243 - fixed how required methods are handled
e7f8d0c2 244 when they encounter overriden or modified
245 methods from a class (thanks to confound).
246 - added tests for this
5af6a16d 247
3796382a 248 * Moose::Util::TypeConstraint
4734114b 249 - fixed the type notation parser so that
250 the | always creates a union and so is
251 no longer a valid type char (thanks to
252 konobi, mugwump and #moose for working
3796382a 253 this one out.)
254 - added more tests for this
255
77a18c28 2560.26 Thurs. Sept. 27, 2007
257 == New Features ==
4734114b 258
77a18c28 259 * Parameterized Types
4734114b 260 We now support parameterized collection types, such as:
77a18c28 261 ArrayRef[Int] # array or integers
262 HashRef[Object] # a hash with object values
263 They can also be nested:
264 ArrayRef[HashRef[RegExpr]] # an array of hashes with regexpr values
265 And work with the type unions as well:
266 ArrayRef[Int | Str] # array of integers of strings
4734114b 267
77a18c28 268 * Better Framework Extendability
4734114b 269 Moose.pm is now "extendable" such that it is now much
270 easier to extend the framework and add your own keywords
77a18c28 271 and customizations. See the "EXTENDING AND EMBEDDING MOOSE"
272 section of the Moose.pm docs.
4734114b 273
77a18c28 274 * Moose Snacks!
4734114b 275 In an effort to begin documenting some of the various
276 details of Moose as well as some common idioms, we have
277 created Moose::Cookbook::Snacks as a place to find
77a18c28 278 small (easily digestable) nuggets of Moose code.
4734114b 279
77a18c28 280 ====
fb697a87 281 ~ Several doc updates/cleanup thanks to castaway ~
4734114b 282
283 - converted build system to use Module::Install instead of
e46f5cc2 284 Module::Build (thanks to jrockway)
fb697a87 285
d67145ed 286 * Moose
4734114b 287 - added all the meta classes to the immutable list and
d67145ed 288 set it to inline the accessors
4734114b 289 - fix import to allow Sub::Exporter like { into => }
e59a5c29 290 and { into_level => } (perigrin)
4734114b 291 - exposed and documented init_meta() to allow better
e59a5c29 292 embedding and extending of Moose (perigrin)
4734114b 293
e59a5c29 294 * t/
295 - complete re-organization of the test suite
4734114b 296 - added some new tests as well
77a18c28 297 - finally re-enabled the Moose::POOP test since
298 the new version of DBM::Deep now works again
299 (thanks rob)
b468a3d3 300
301 * Moose::Meta::Class
4734114b 302 - fixed very odd and very nasty recursion bug with
b468a3d3 303 inner/augment (mst)
304 - added tests for this (eilara)
d67145ed 305
3726f905 306 * Moose::Meta::Attribute
307 Moose::Meta::Method::Constructor
308 Moose::Meta::Method::Accessor
4734114b 309 - fixed issue with overload::Overloaded getting called
f1917f58 310 on non-blessed items. (RT #29269)
3726f905 311 - added tests for this
4734114b 312
3ccdc84a 313 * Moose::Meta::Method::Accessor
4734114b 314 - fixed issue with generated accessor code making
3ccdc84a 315 assumptions about hash based classes (thanks to dexter)
4734114b 316
3726f905 317 * Moose::Coookbook::Snacks
4734114b 318 - these are bits of documentation, not quite as big as
319 Recipes but which have no clear place in the module docs.
3726f905 320 So they are Snacks! (horray for castaway++)
321
07cde929 322 * Moose::Cookbook::Recipe4
323 - updated it to use the new ArrayRef[MyType] construct
324 - updated the accompanying test as well
325
3726f905 326 +++ Major Refactor of the Type Constraint system +++
327 +++ with new features added as well +++
328
22aed3c0 329 * Moose::Util::TypeConstraint
4734114b 330 - no longer uses package variable to keep track of
22aed3c0 331 the type constraints, now uses the an instance of
332 Moose::Meta::TypeConstraint::Registry to do it
f1917f58 333 - added more sophisticated type notation parsing
334 (thanks to mugwump)
335 - added tests for this
22aed3c0 336
d67145ed 337 * Moose::Meta::TypeConstraint
338 - some minor adjustments to make subclassing easier
4734114b 339 - added the package_defined_in attribute so that we
22aed3c0 340 can track where the type constraints are created
4734114b 341
d67145ed 342 * Moose::Meta::TypeConstraint::Union
4734114b 343 - this is now been refactored to be a subclass of
3726f905 344 Moose::Meta::TypeConstraint
4734114b 345
3726f905 346 * Moose::Meta::TypeCoercion::Union
347 - this has been added to service the newly refactored
4734114b 348 Moose::Meta::TypeConstraint::Union and is itself
3726f905 349 a subclass of Moose::Meta::TypeCoercion
4734114b 350
0fbd4b0a 351 * Moose::Meta::TypeConstraint::Parameterized
d67145ed 352 - added this module (taken from MooseX::AttributeHelpers)
353 to help construct nested collection types
354 - added tests for this
4734114b 355
22aed3c0 356 * Moose::Meta::TypeConstraint::Registry
357 - added this class to keep track of type constraints
d67145ed 358
887169d7 3590.25 Mon. Aug. 13, 2007
8eca434b 360 * Moose
4734114b 361 - Documentation update to reference Moose::Util::TypeConstraints
362 under 'isa' in 'has' for how to define a new type
8eca434b 363 (thanks to shlomif).
364
ab859145 365 * Moose::Meta::Attribute
4734114b 366 - required attributes now will no longer accept undef
ab859145 367 from the constructor, even if there is a default and lazy
368 - added tests for this
4734114b 369 - default subroutines must return a value which passes the
7a5ebc40 370 type constraint
371 - added tests for this
4734114b 372
a909a4df 373 * Moose::Meta::Attribute
374 * Moose::Meta::Method::Constructor
4734114b 375 * Moose::Meta::Method::Accessor
a909a4df 376 - type-constraint tests now handle overloaded objects correctly
377 in the error message
4734114b 378 - added tests for this (thanks to EvanCarroll)
ab859145 379
8eca434b 380 * Moose::Meta::TypeConstraint::Union
4734114b 381 - added (has_)hand_optimized_constraint to this class so that
8eca434b 382 it behaves as the regular Moose::Meta::TypeConstraint does.
383
5868294f 384 * Moose::Meta::Role
887169d7 385 - large refactoring of this code
4734114b 386 - added several more tests
387 - tests for subtle conflict resolition issues
7125b244 388 added, but not currently running
389 (thanks to kolibre)
390
4734114b 391 * Moose::Cookbook::Recipe7
392 - added new recipe for augment/inner functionality
887169d7 393 (still in progress)
7125b244 394 - added test for this
5868294f 395
24a8fe99 396 * Moose::Spec::Role
7125b244 397 - a formal definition of roles (still in progress)
24a8fe99 398
9a641848 399 * Moose::Util
887169d7 400 - utilities for easier working with Moose classes
7125b244 401 - added tests for these
9a641848 402
403 * Test::Moose
887169d7 404 - This contains Moose specific test functions
7125b244 405 - added tests for these
9a641848 406
6b4c1bdd 4070.24 Tues. July 3, 2007
408 ~ Some doc updates/cleanup ~
c84f324f 409
410 * Moose::Meta::Attribute
4734114b 411 - added support for roles to be given as parameters
c84f324f 412 to the 'handles' option.
413 - added tests and docs for this
4734114b 414 - the has '+foo' attribute form now accepts changes to
83cc9094 415 the lazy option, and the addition of a handles option
416 (but not changing the handles option)
417 - added tests and docs for this
c84f324f 418
1db8ecc7 419 * Moose::Meta::Role
420 - required methods are now fetched using find_method_by_name
421 so that required methods can come from superclasses
422 - adjusted tests for this
423
81941e9b 4240.23 Mon. June 18, 2007
73b84d2e 425 * Moose::Meta::Method::Constructor
426 - fix inlined constructor for hierarchy with multiple BUILD methods (mst)
ac2dc464 427 * Moose::Meta::Class
428 - Modify make_immutable to work with the new Class::MOP immutable
429 mechanism + POD + very basic test (groditi)
cbe25729 430 * Moose::Meta::Attribute
4734114b 431 - Fix handles to use goto() so that caller() comes out properly on
cbe25729 432 the other side (perigrin)
ac2dc464 433
db53853c 4340.22 Thurs. May 31, 2007
3969267d 435 * Moose::Util::TypeConstraints
4734114b 436 - fix for prototype undeclared issue when Moose::Util::TypeConstraints
db53853c 437 loaded before consumers (e.g. Moose::Meta::Attribute) by predeclaring
438 prototypes for functions
4734114b 439 - added the ClassName type constraint, this checks for strings
440 which will respond true to ->isa(UNIVERSAL).
9af1d28b 441 - added tests and docs for this
4734114b 442 - subtyping just in name now works correctly by making the
86629f93 443 default for where be { 1 }
4734114b 444 - added test for this
3969267d 445
d7611a4a 446 * Moose::Meta::Method::Accessor
4734114b 447 - coerce and lazy now work together correctly, thanks to
d7611a4a 448 merlyn for finding this bug
449 - tests added for this
df492bba 450 - fix reader presedence bug in Moose::Meta::Attribute + tests
d7611a4a 451
86629f93 452 * Moose::Object
453 - Foo->new(undef) now gets ignored, it is assumed you meant to pass
4734114b 454 a HASH-ref and missed. This produces better error messages then
86629f93 455 having it die cause undef is not a HASH.
456 - added tests for this
457
74a0a945 4580.21 Thursday, May 2nd, 2007
52c7c330 459 * Moose
460 - added SUPER_SLOT and INNER_SLOT class hashes to support unimport
461 - modified unimport to remove super and inner along with the rest
462 - altered unimport tests to handle this
463
464 * Moose::Role
465 - altered super export to populate SUPER_SLOT
466
467 * Moose::Meta::Class
468 - altered augment and override modifier application to use *_SLOT
469 - modified tests for these to unimport one test class each to test
470
492d4d76 471 * Moose::Meta::Role
472 - fixed issue where custom attribute metaclasses
473 where not handled correctly in roles
474 - added tests for this
4734114b 475
5cb193ed 476 * Moose::Meta::Class
4734114b 477 - fixed issue where extending metaclasses with
5cb193ed 478 roles would blow up. Thanks to Aankhen`` for
479 finding this insidious error, and it's solution.
4734114b 480
481 ~~ lots of spelling and grammer fixes in the docs,
0305961b 482 many many thanks to rlb3 and Aankhen for these :)
492d4d76 483
e518dfb4 4840.20 Friday, April 6th, 2007
a60285b3 485 >> I messed up the SKIP logic in one test
486 so this release is just to fix that.
487
93c435b3 488 * Moose
489 - 'has' now also accepts an ARRAY ref
490 to create multiple attrs (see docs)
491 (thanks to konobi for this)
4734114b 492 - added tests and docs
93c435b3 493
cd7eeaf5 4940.19 Thurs. April 5th, 2007
495 ~~ More documentation updates ~~
496
c899258b 497 * Moose::Util::TypeConstraints
c1935ade 498 - 'type' now supports messages as well
ddbdc0cb 499 thanks to phaylon for finding this
c899258b 500 - added tests for this
4734114b 501 - added &list_all_type_constraints and
c1935ade 502 &list_all_builtin_type_constraints
943596a6 503 functions to facilitate introspection.
4734114b 504
d022f632 505 * Moose::Meta::Attribute
4734114b 506 - fixed regexp 'handles' declarations
d022f632 507 to build the list of delegated methods
4734114b 508 correctly (and not override important
509 things like &new) thanks to ashleyb
ddbdc0cb 510 for finding this
511 - added tests and docs for this
c1935ade 512 - added the 'documentation' attributes
4734114b 513 so that you can actually document your
514 attributes and inspect them through the
ddbdc0cb 515 meta-object.
d022f632 516 - added tests and docs for this
517
c1935ade 518 * Moose::Meta::Class
519 - when loading custom attribute metaclasses
4734114b 520 it will first look in for the class in the
521 Moose::Meta::Attribute::Custom::$name, and
c1935ade 522 then default to just loading $name.
523 - added tests and docs for this
524
900466d6 525 * Moose::Meta::TypeConstraint
526 - type constraints now stringify to their names.
527 - added test for this
528
d022f632 529 * misc.
4734114b 530 - added tests to assure we work with Module::Refresh
531 - added stricter test skip logic in the Moose POOP
ddbdc0cb 532 test, ask Rob Kinyon why.
533 - *cough* DBM::Deep 1.0 backwards compatability sucks *cough* ;)
c899258b 534
af5199c6 5350.18 Sat. March 10, 2007
536 ~~ Many, many documentation updates ~~
ddbdc0cb 537
538 * misc.
4734114b 539 - We now use Class::MOP::load_class to
540 load all classes.
541 - added tests to show types and subtypes
ddbdc0cb 542 working with Declare::Constraints::Simple
543 and Test::Deep as constraint engines.
b77fdbed 544
587ae0d2 5450.18_001
d01f1dab 546 !! You must have Class::MOP 0.37_001 !!
547 !! for this developer release to work !!
548
734d1752 549 This release was primarily adding the immutable
4734114b 550 feature to Moose. An immutable class is one which
551 you promise not to alter. When you set the class
552 as immutable it will perform various bits of
734d1752 553 memoization and inline certain part of the code
4734114b 554 (constructors, destructors and accessors). This
734d1752 555 minimizes (and in some cases totally eliminates)
4734114b 556 one of Moose's biggest performance hits. This
734d1752 557 feature is not on by default, and is 100% optional.
4734114b 558 It has several configurable bits as well, so you
734d1752 559 can pick and choose to your specific needs.
4734114b 560
561 The changes involved in this were fairly wide and
562 highly specific, but 100% backwards compatible, so
563 I am not going to enumerate them here. If you are
564 truely interested in what was changed, please do
734d1752 565 a diff :)
587ae0d2 566
5670.17 Tues. Nov. 14, 2006
568 * Moose::Meta::Method::Accessor
4734114b 569 - bugfix for read-only accessors which
587ae0d2 570 are have a type constraint and lazy.
571 Thanks to chansen for finding it.
572
5730.16 Tues. Nov. 14, 2006
574 ++ NOTE ++
4734114b 575 There are some speed improvements in this release,
587ae0d2 576 but they are only the begining, so stay tuned.
4734114b 577
587ae0d2 578 * Moose::Object
4734114b 579 - BUILDALL and DEMOLISHALL no longer get
587ae0d2 580 called unless they actually need to be.
581 This gave us a signifigant speed boost
4734114b 582 for the cases when there is no BUILD or
587ae0d2 583 DEMOLISH method present.
4734114b 584
587ae0d2 585 * Moose::Util::TypeConstraints
586 * Moose::Meta::TypeConstraint
4734114b 587 - added an 'optimize_as' option to the
587ae0d2 588 type constraint, which allows for a
4734114b 589 hand optimized version of the type
587ae0d2 590 constraint to be used when possible.
591 - Any internally created type constraints
592 now provide an optimized version as well.
593
ecb59493 5940.15 Sun. Nov. 5, 2006
946289d1 595 ++ NOTE ++
4734114b 596 This version of Moose *must* have Class::MOP 0.36 in order
597 to work correctly. A number of small internal tweaks have
946289d1 598 been made in order to be compatible with that release.
571dd39f 599
600 * Moose::Util::TypeConstraints
4734114b 601 - added &unimport so that you can clean out
602 your class namespace of these exported
571dd39f 603 keywords
4734114b 604
37ee30c9 605 * Moose::Meta::Class
4734114b 606 - fixed minor issue which occasionally
607 comes up during global destruction
37ee30c9 608 (thanks omega)
4734114b 609 - moved Moose::Meta::Method::Overriden into
946289d1 610 its own file.
4734114b 611
612 * Moose::Meta::Role
613 - moved Moose::Meta::Role::Method into
946289d1 614 its own file.
4734114b 615
43123819 616 * Moose::Meta::Attribute
4734114b 617 - changed how we do type checks so that
618 we reduce the overall cost, but still
7623f774 619 retain correctness.
946289d1 620 *** API CHANGE ***
4734114b 621 - moved accessor generation methods to
622 Moose::Meta::Method::Accessor to
623 conform to the API changes from
946289d1 624 Class::MOP 0.36
4734114b 625
43123819 626 * Moose::Meta::TypeConstraint
627 - changed how constraints are compiled
628 so that we do less recursion and more
4734114b 629 iteration. This makes the type check
43123819 630 faster :)
946289d1 631 - moved Moose::Meta::TypeConstraint::Union
632 into its own file
4734114b 633
946289d1 634 * Moose::Meta::Method::Accessor
4734114b 635 - created this from methods formerly found in
946289d1 636 Moose::Meta::Attribute
4734114b 637
946289d1 638 * Moose::Meta::Role::Method
639 - moved this from Moose::Meta::Role
4734114b 640
946289d1 641 * Moose::Meta::Method::Overriden
642 - moved this from Moose::Meta::Class
4734114b 643
946289d1 644 * Moose::Meta::TypeConstraint::Union
645 - moved this from Moose::Meta::TypeConstraint
37ee30c9 646
3ec7b7a3 6470.14 Mon. Oct. 9, 2006
4fd69d6c 648
649 * Moose::Meta::Attribute
4734114b 650 - fixed lazy attributes which were not getting
4fd69d6c 651 checked with the type constraint (thanks ashley)
652 - added tests for this
4734114b 653 - removed the over-enthusiastic DWIMery of the
654 automatic ArrayRef and HashRef defaults, it
3ec7b7a3 655 broke predicates in an ugly way.
656 - removed tests for this
4fd69d6c 657
c0c41f76 6580.13 Sat. Sept. 30, 2006
093b12c2 659 ++ NOTE ++
4734114b 660 This version of Moose *must* have Class::MOP 0.35 in order
661 to work correctly. A number of small internal tweaks have
093b12c2 662 been made in order to be compatible with that release.
663
3c2bc5e2 664 * Moose
665 - Removed the use of UNIVERSAL::require to be a better
4734114b 666 symbol table citizen and remove a dependency
093b12c2 667 (thanks Adam Kennedy)
3c2bc5e2 668
2a0f3bd3 669 **~~ removed experimental & undocumented feature ~~**
4734114b 670 - commented out the 'method' and 'self' keywords, see the
2a0f3bd3 671 comments for more info.
672
e95c7c42 673 * Moose::Cookbook
4734114b 674 - added a FAQ and WTF files to document frequently
e95c7c42 675 asked questions and common problems
4734114b 676
3f7376b0 677 * Moose::Util::TypeConstraints
0a5bd159 678 - added GlobRef and FileHandle type constraint
3f7376b0 679 - added tests for this
4734114b 680
3f7376b0 681 * Moose::Meta::Attribute
682 - if your attribute 'isa' ArrayRef of HashRef, and you have
683 not explicitly set a default, then make the default DWIM.
4734114b 684 This will also work for subtypes of ArrayRef and HashRef
94b8bbb8 685 as well.
686 - you can now auto-deref subtypes of ArrayRef or HashRef too.
687 - new test added for this (thanks to ashley)
4734114b 688
b805c70c 689 * Moose::Meta::Role
690 - added basic support for runtime role composition
4734114b 691 but this is still *highly experimental*, so feedback
0a5bd159 692 is much appreciated :)
b805c70c 693 - added tests for this
e95c7c42 694
0a5bd159 695 * Moose::Meta::TypeConstraint
696 - the type constraint now handles the coercion process
4734114b 697 through delegation, this is to support the coercion
0a5bd159 698 of unions
4734114b 699
0a5bd159 700 * Moose::Meta::TypeConstraint::Union
4734114b 701 - it is now possible for coercions to be performed
0a5bd159 702 on a type union
703 - added tests for this (thanks to konobi)
704
e95c7c42 705 * Moose::Meta::TypeCoercion
4734114b 706 - properly capturing error when type constraint
e95c7c42 707 is not found
708
3c2bc5e2 709 * Build.PL
710 - Scalar::Util 1.18 is bad on Win32, so temporarily
711 only require version 1.17 for Win32 and cygwin.
4734114b 712 (thanks Adam Kennedy)
3c2bc5e2 713
40e89659 7140.12 Sat. Sept. 1, 2006
2bdd01cd 715 * Moose::Cookbook
716 - Recipe5 (subtypes & coercion) has been written
4734114b 717
2bdd01cd 718 * Moose
4734114b 719 - fixed "bad meta" error message to be more descriptive
720 - fixed &unimport to not remove the &inner and &super
3279ab4a 721 keywords because we need to localize them.
68efb014 722 - fixed number of spelling/grammer issues, thanks Theory :)
4734114b 723
0558683c 724 **~~ experimental & undocumented feature ~~**
4734114b 725 - added the method and self keywords, they are basically
68efb014 726 just sugar, and they may not stay around.
4734114b 727
f742dfef 728 * Moose::Object
4734114b 729 - added &dump method to easily Data::Dumper
68efb014 730 an object
4734114b 731
b26e162e 732 * Moose::Meta::TypeConstraint
733 - added the &is_a_type_of method to check both the current
734 and the subtype of a method (similar to &isa with classes)
f008ac1f 735
68efb014 736 * Moose::Meta::Role
737 - this is now a subclass of Class::MOP::Module, and no longer
4734114b 738 creates the _role_meta ugliness of before.
68efb014 739 - fixed tests to reflect this change
4734114b 740
8c835eba 7410.11 Wed. July 12, 2006
31f8ec72 742 * Moose
743 - added an &unimport method to remove all the keywords
4734114b 744 that Moose will import, simply add 'no Moose' to the
745 bottom of your class file.
746
31f8ec72 747 * t/
4734114b 748 - fixed some test failures caused by a forgotten test
31f8ec72 749 dependency.
750
864cd714 7510.10 Thurs. July 6, 2006
01a8e221 752 * Moose
753 - improved error message when loading modules so
754 it is less confusing when you load a role.
4734114b 755 - added &calculate_all_roles method to
2b14ac61 756 Moose::Meta::Class and Moose::Meta::Role
4734114b 757
2b14ac61 758 NOTE:
759 This module has been tested against Class::MOP 0.30
4734114b 760 but it does not yet utilize the optimizations
2b14ac61 761 it makes available. Stay tuned for that ;)
4734114b 762
2b14ac61 7630.09_03 Fri. June 23, 2006
715ea0b7 764 ++ DEVELOPER RELEASE ++
4276ccb4 765 * Moose
766 - 'use strict' and 'use warnings' are no longer
4734114b 767 needed in Moose classes, Moose itself will
4276ccb4 768 turn them on for you.
769 - added tests for this
1341f10c 770 - moved code from exported subs to private methods
771 in Moose::Meta::Class
4734114b 772
4276ccb4 773 * Moose::Role
4734114b 774 - as with Moose, strict and warnings are
4276ccb4 775 automatically turned on for you.
4734114b 776 - added tests for this
777
e39d707f 778 * Moose::Meta::Role
779 - now handles an edge case for override errors
780 - added tests for this
b7f2d25b 781 - added some more edge case tests
1341f10c 782
43d599e5 7830.09_02 Tues. May 16, 2006
715ea0b7 784 ++ DEVELOPER RELEASE ++
2c0cbef7 785 * Moose
786 - added prototypes to the exported subs
43d599e5 787 - updated docs
4734114b 788
2c0cbef7 789 * Moose::Role
4734114b 790 - added prototypes to the exported subs
43d599e5 791 - updated docs
4734114b 792
2c0cbef7 793 * Moose::Util::TypeConstraints
4734114b 794 - cleaned up prototypes for the subs
795 - updated docs
2c0cbef7 796
72c4f6d1 7970.09_01 Fri. May 12, 2006
798 ++ DEVELOPER RELEASE ++
4734114b 799 - This release works in combination with
800 Class::MOP 0.29_01, it is a developer
801 release because it uses the a new
72c4f6d1 802 instance sub-protocol and a fairly
4734114b 803 complete Role implementation. It has
72c4f6d1 804 not yet been optimized, so it slower
4734114b 805 the the previous CPAN version. This
806 release also lacks good updated docs,
72c4f6d1 807 the official release will have updated docs.
808
4734114b 809 * Moose
98aae381 810 - refactored the keyword exports
4734114b 811 - 'with' now checks Role validaity and
db1ab48d 812 accepts more than one Role at a time
4734114b 813 - 'extends' makes metaclass adjustments as
98aae381 814 needed to ensure metaclass compatability
4734114b 815
72c4f6d1 816 * Moose::Role
817 - refactored the keyword exports
4734114b 818 - 'with' now checks Role validaity and
72c4f6d1 819 accepts more than one Role at a time
4734114b 820
98aae381 821 * Moose::Util::TypeConstraints
4734114b 822 - added the 'enum' keyword for simple
823 string enumerations which can be used as
98aae381 824 type constraints
db1ab48d 825 - see example of usage in t/202_example.t
4734114b 826
98aae381 827 * Moose::Object
828 - more careful checking of params to new()
4734114b 829
72c4f6d1 830 * Moose::Meta::Role
831 - much work done on the role composition
4734114b 832 - many new tests for conflict detection
72c4f6d1 833 and composition edge cases
4734114b 834 - not enough documentation, I suggest
835 looking at the tests
836
98aae381 837 * Moose::Meta::Instance
4734114b 838 - added new Instance metaclass to support
98aae381 839 the new Class::MOP instance protocol
4734114b 840
98aae381 841 * Moose::Meta::Class
4734114b 842 - some small changes to support the new
98aae381 843 instance protocol
72c4f6d1 844 - some small additions to support Roles
4734114b 845
98aae381 846 * Moose::Meta::Attribute
847 - some improvements to the accessor generation code
848 by nothingmuch
4734114b 849 - some small changes to support the new
98aae381 850 instance protocol
4734114b 851 - (still somewhat) experimental delegation support
98aae381 852 with the 'handles' option
853 - added several tests for this
db1ab48d 854 - no docs for this yet
98aae381 855
35c8b8f2 8560.05 Thurs. April 27, 2006
2d562421 857 * Moose
858 - keywords are now exported with Sub::Exporter
859 thanks to chansen for this commit
4734114b 860 - has keyword now takes a 'metaclass' option
861 to support custom attribute meta-classes
590868a3 862 on a per-attribute basis
4734114b 863 - added tests for this
daea75c9 864 - the 'has' keyword not accepts inherited slot
4734114b 865 specifications (has '+foo'). This is still an
daea75c9 866 experimental feature and probably not finished
4734114b 867 see t/038_attribute_inherited_slot_specs.t for
daea75c9 868 more details, or ask about it on #moose
fcb7afc2 869 - added tests for this
4734114b 870
2d562421 871 * Moose::Role
872 - keywords are now exported with Sub::Exporter
873
5204cd52 874 * Moose::Utils::TypeConstraints
cce8198b 875 - reorganized the type constraint hierarchy, thanks
4734114b 876 to nothingmuch and chansen for his help and advice
cce8198b 877 on this
878 - added some tests for this
7eaef7ad 879 - keywords are now exported with Sub::Exporter
35c8b8f2 880 thanks to chansen for this commit
5204cd52 881
d500266f 882 * Moose::Meta::Class
883 - due to changes in Class::MOP, we had to change
884 construct_instance (for the better)
4734114b 885
d500266f 886 * Moose::Meta::Attribute
4734114b 887 - due to changes in Class::MOP, we had to add the
d500266f 888 initialize_instance_slot method (it's a good thing)
4734114b 889
cce8198b 890 * Moose::Meta::TypeConstraint
4734114b 891 - added type constraint unions
c07af9d2 892 - added tests for this
cce8198b 893 - added the is_subtype_of predicate method
894 - added tests for this
d500266f 895
02a0fb52 8960.04 Sun. April 16th, 2006
1331430a 897 * Moose::Role
898 - Roles can now consume other roles
899 - added tests for this
4734114b 900 - Roles can specify required methods now with
1331430a 901 the requires() keyword
902 - added tests for this
903
bdabd620 904 * Moose::Meta::Role
905 - ripped out much of it's guts ,.. much cleaner now
4734114b 906 - added required methods and correct handling of
fa1be058 907 them in apply() for both classes and roles
908 - added tests for this
4734114b 909 - no longer adds a does() method to consuming classes
1331430a 910 it relys on the one in Moose::Object
4734114b 911 - added roles attribute and some methods to support
1331430a 912 roles consuming roles
8c9d74e7 913
914 * Moose::Meta::Attribute
915 - added support for triggers on attributes
916 - added tests for this
4734114b 917 - added support for does option on an attribute
02a0fb52 918 - added tests for this
4734114b 919
8c9d74e7 920 * Moose::Meta::Class
4734114b 921 - added support for attribute triggers in the
8c9d74e7 922 object construction
923 - added tests for this
4734114b 924
256903b6 925 * Moose
4734114b 926 - Moose no longer creates a subtype for your class
927 if a subtype of the same name already exists, this
256903b6 928 should DWIM in 99.9999% of all cases
4734114b 929
256903b6 930 * Moose::Util::TypeConstraints
4734114b 931 - fixed bug where incorrect subtype conflicts were
256903b6 932 being reported
8c9d74e7 933 - added test for this
4734114b 934
8c9d74e7 935 * Moose::Object
936 - this class can now be extended with 'use base' if
937 you need it, it properly loads the metaclass class now
938 - added test for this
bdabd620 939
0677220d 9400.03_02 Wed. April 12, 2006
05d9eaf6 941 * Moose
942 - you must now explictly use Moose::Util::TypeConstraints
943 it no longer gets exported for you automatically
4734114b 944
05d9eaf6 945 * Moose::Object
946 - new() now accepts hash-refs as well as key/value lists
0677220d 947 - added does() method to check for Roles
948 - added tests for this
05d9eaf6 949
0677220d 950 * Moose::Meta::Class
4734114b 951 - added roles attribute along with the add_role() and
0677220d 952 does_role() methods
4734114b 953 - added tests for this
0677220d 954
955 * Moose::Meta::Role
4734114b 956 - now adds a does() method to consuming classes
0677220d 957 which tests the class's hierarchy for roles
958 - added tests for this
959
9600.03_01 Mon. April 10, 2006
e9ec68d6 961 * Moose::Cookbook
76d37e5a 962 - added new Role recipe (no content yet, only code)
4734114b 963
e9ec68d6 964 * Moose
965 - added 'with' keyword for Role support
966 - added test and docs for this
967 - fixed subtype quoting bug
4734114b 968 - added test for this
e9ec68d6 969
970 * Moose::Role
971 - Roles for Moose
972 - added test and docs
76d37e5a 973
974 * Moose::Util::TypeConstraints
975 - added the message keyword to add custom
4734114b 976 error messages to type constraints
977
e9ec68d6 978 * Moose::Meta::Role
979 - the meta role to support Moose::Role
980 - added tests and docs
4734114b 981
e9ec68d6 982 * Moose::Meta::Class
4734114b 983 - moved a number of things from Moose.pm
984 to here, they should have been here
e9ec68d6 985 in the first place
986
987 * Moose::Meta::Attribute
988 - moved the attribute option macros here
989 instead of putting them in Moose.pm
e185c027 990
76d37e5a 991 * Moose::Meta::TypeConstraint
4734114b 992 - added the message attributes and the
76d37e5a 993 validate method
994 - added tests and docs for this
995
0ac928d2 9960.03 Thurs. March 30, 2006
e9bb8a31 997 * Moose::Cookbook
4734114b 998 - added the Moose::Cookbook with 5 recipes,
e9bb8a31 999 describing all the stuff Moose can do.
1000
d7f17ebb 1001 * Moose
1002 - fixed an issue with &extends super class loading
4734114b 1003 it now captures errors and deals with inline
1004 packages correctly (bug found by mst, solution
d7f17ebb 1005 stolen from alias)
159da176 1006 - added super/override & inner/augment features
1007 - added tests and docs for these
4734114b 1008
d7f17ebb 1009 * Moose::Object
4734114b 1010 - BUILDALL now takes a reference of the %params
1011 that are passed to &new, and passes that to
d7f17ebb 1012 each BUILD as well.
4734114b 1013
471c4f09 1014 * Moose::Util::TypeConstraints
1015 - Type constraints now survive runtime reloading
1016 - added test for this
d7f17ebb 1017
8339fae2 1018 * Moose::Meta::Class
4734114b 1019 - fixed the way attribute defaults are handled
8339fae2 1020 during instance construction (bug found by chansen)
1021
d7f17ebb 1022 * Moose::Meta::Attribute
1023 - read-only attributes now actually enforce their
4734114b 1024 read-only-ness (this corrected in Class::MOP as
9deed647 1025 well)
d7f17ebb 1026
076c81ed 10270.02 Tues. March 21, 2006
fc5609d2 1028 * Moose
4734114b 1029 - many more tests, fixing some bugs and
b841b2a3 1030 edge cases
b841b2a3 1031 - &extends now loads the base module with
4734114b 1032 UNIVERSAL::require
1033 - added UNIVERSAL::require to the
b841b2a3 1034 dependencies list
6ba6d68c 1035 ** API CHANGES **
4734114b 1036 - each new Moose class will also create
1037 and register a subtype of Object which
1038 correspond to the new Moose class.
1039 - the 'isa' option in &has now only
1040 accepts strings, and will DWIM in
b841b2a3 1041 almost all cases
4734114b 1042
b841b2a3 1043 * Moose::Util::TypeConstraints
1044 - added type coercion features
1045 - added tests for this
4734114b 1046 - added support for this in attributes
b841b2a3 1047 and instance construction
6ba6d68c 1048 ** API CHANGES **
4734114b 1049 - type construction no longer creates a
b841b2a3 1050 function, it registers the type instead.
4734114b 1051 - added several functions to get the
1052 registered types
6ba6d68c 1053
1054 * Moose::Object
4734114b 1055 - BUILDALL and DEMOLISHALL were broken
6ba6d68c 1056 because of a mis-named hash key, Whoops :)
4734114b 1057
b841b2a3 1058 * Moose::Meta::Attribute
1059 - adding support for coercion in the
1060 autogenerated accessors
4734114b 1061
b841b2a3 1062 * Moose::Meta::Class
1063 - adding support for coercion in the
4734114b 1064 instance construction
6ba6d68c 1065
1066 * Moose::Meta::TypeConstraint
1067 * Moose::Meta::TypeCoercion
4734114b 1068 - type constraints and coercions are now
6ba6d68c 1069 full fledges meta-objects
fc5609d2 1070
e522431d 10710.01 Wed. March 15, 2006
900466d6 1072 - Moooooooooooooooooose!!!