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