more immutable fixes
[gitmo/Class-MOP.git] / Changes
1 Revision history for Perl extension Class-MOP.
2 0.39 
3     * Class::MOP::Class::Immutable
4       - added make_metaclass_mutable + docs (groditi)
5       - removed unused variable
6       - added create_immutable_transformer
7         necessary for sane overloading of immutable behavior
8          - tests for this (groditi) 
9
10     * Class::MOP::Class
11       - Immutability can now be undone,
12         added make_mutable + tests + docs (groditi)
13       - Massive changes to the way Immutable is done
14         for details see comments next to make_immutable
15         This fixes a bug where custom metaclasses broke
16         when made immutable. We are now keeping one immutable 
17         metaclass instance per metaclass instead of just one 
18         to prevent isa hierarchy corruption. Memory use will go
19         up, but I suspect it will be neglible.
20          - New tests added for this behavior.  (groditi)
21
22 0.38 Thurs. May 31, 2007
23     ~~ More documentation updates ~~
24     
25     * Class::MOP::Package
26       - we now deal with stub methods properly
27         - added tests for this
28       - fixed some tests failing on 5.9.5 (thanks blblack)
29         
30     * Class::MOP::Attribute
31       - added get_read_method and get_write_method
32         thanks to groditi for this code, tests 
33         and docs.
34         - added tests and POD for this
35     
36     * Class::MOP::Class
37       - fixed RT issue #27329, clone object now 
38         handles undef values correctly.
39         - added tests for this
40       - Corrected anon-class handling so that they 
41         will not get reaped when instances still 
42         exist which need to reference them. This is 
43         the correct behavior, hopefully this is an 
44         obscure enough feature that there are not too 
45         many work arounds out in the wild.
46         - added tests for this by groditi   
47         - updated docs to explain this
48
49     * metaclass
50       - load custom metaclasses automatically (thanks groditi)
51         - added tests for this behavior
52
53 0.37 Sat. March 10, 2007
54     ~~ Many, many documentation updates ~~
55     
56     * Class::MOP
57       - added &load_class and &is_class_loaded 
58         - added tests and docs for these
59
60     * Class::MOP::Attribute
61       - default now checks the instance with defined to 
62         avoid setting off bool-overloads (found by Carl Franks)
63
64 0.37_002
65     * /t 
66       - bad name in a test, causing meaningless failuress. 
67         No other changes.
68
69 0.37_001
70     
71     ~~ GLOBAL CHANGES ~~
72     - All attribute names are now consistent and follow Perl 6 
73       style (prefixed with the sigil, and ! as the twigil for 
74       private attrs). This should not affect any code, unless 
75       you broke encapsulation, in which case, it is your problem 
76       anyway.
77       
78     !! Class::MOP::Class::Immutable has been removed
79     
80     * Class::MOP::Method::Constructor
81       - this has been moved out of Class::MOP::Class::Immutable 
82         and is a proper subclass of Class::MOP::Method now.
83         
84     * Class::MOP::Class
85       - this module now uses Class::MOP::Immutable for the 
86         immutable transformation instead of 
87         Class::MOP::Class::Immutable.
88         
89     + Class::MOP::Immutable 
90       - this module now controls the transformation from a mutable 
91         to an immutable version of the class. Docs for this will 
92         be coming eventually.
93     
94
95 0.36 Sun. Nov. 5, 2006
96     * Class::MOP::Class
97       - added a few 'no warnings' lines to keep annoying 
98         (and meaningless) warnings from chirping during 
99         global destruction.
100           
101     * Class::MOP
102       - some more bootstrapping is now done on the new 
103         classes
104     
105     * Class::MOP::Class::Immutable
106       *** API CHANGE ***    
107       - constructor generation is now handled by 
108         the Class::MOP::Method::Constructor class
109      
110     * Class::MOP::Method::Constructor
111       - created this to handle constructor generation 
112         in Class::MOP::Class::Immutable
113     
114     * Class::MOP::Attribute
115       *** API CHANGE ***    
116       - attributes now delegate to the 
117         Class::MOP::Method::Accessor to generate 
118         accessors
119     
120     * Class::MOP::Method::Accessor
121       - all accessor generation functions from 
122         Class::MOP::Attribute have been moved here
123
124 0.35 Sat. Sept. 30, 2006
125
126     * scripts/class_browser.pl
127       - initial prototype of a class browser, more 
128         on this to come. Comments and patches are 
129         very much welcome.
130
131     * Class::MOP
132       - All Class::MOP::* accessors are no longer 
133         re-generated in the bootstrap, instead 
134         they are aliased from the originals
135         - fixed tests to reflect
136       - added Class::MOP::Method (and its subclasses) 
137         to the bootstrap
138         - adjusted tests for this
139       - added the Class::MOP::Instance attributes
140         to the bootstrap
141     
142     * Class::MOP::Method
143       *** API CHANGE ***
144       - methods are no longer blessed CODE refs
145         but are actual objects which can be CODE-ified
146         - adjusted tests to compensate
147         - adjusted docs for this        
148
149     * Class::MOP::Class
150       - changed how methods are dealt with to 
151         encapsulate most of the work into the 
152         &get_method_map method
153       - made several adjustments for the change
154         in Class::MOP::Method
155       - &add_attribute now checks if you are adding 
156         a duplicate name, and properly removes the 
157         old one before installing the new one
158         - added tests for this
159         - adjusted docs for this
160     
161     * Class::MOP::Class::Immutable
162       - added caching of &get_method_map
163       - fixed issue with &get_package_symbol
164       - cleaned up the methods that die (patch by David Wheeler)
165     
166     * Class::MOP::Package
167       - added filtering capabilities to 
168         &list_all_package_symbols
169
170 0.34 Sat. Aug. 26, 2006
171     * Class::MOP::Class
172       - added the %:methods attribute, which like
173         the $:version and such just actually goes 
174         to the symbol table to get it's stuff. 
175         However, it makes the MOP more complete.
176      ** API CHANGE **
177       - The &create method now requires that all 
178         but the package name now is passed in as 
179         named parameters. See docs for more info.
180         - updated docs and tests for this
181         
182     * Class::MOP::Object
183       - added &dump method to easily Data::Dumper 
184         an object
185         
186     * Class::MOP
187       - cleaned up the initialization of attributes 
188         which do not store things in the instance 
189       - added the %:methods attribute definition to
190         the bootstrap
191         
192     ~ lots of misc. test cleanup
193
194 0.33 Sat. Aug. 19, 2006
195     * Class::MOP::Class
196       - moved the metaclass cache out of here 
197         and it is now in Class::MOP itself.
198         
199     * Class::MOP
200       - moved all the metaclass cache stuff here
201         - fixed all tests for this
202
203     * Class::MOP::Attribute
204       - reference values (other than CODE refs) 
205         are no longer allowed for defaults
206         - added tests for this
207     
208     * Class::MOP::Package
209       - fixed an issue with perl 5.8.1 and how it deals 
210         with symbol tables. The namespace hash is now 
211         always reloaded from the symbol table. 
212
213     ~ lots of misc. documentation cleanup
214
215 0.32 Sat. Aug. 12, 2006
216     + added Class::MOP::Object so that the 
217       metamodel is more complete (and closer
218       to what Perl 6 will probably be).
219
220     * Class::MOP::Package
221       - refactored entire class, this is now 
222         the primary gateway between the metaclass
223         and the Perl 5 symbol table
224         - added many tests for this
225       - this class is now a subclass of 
226         Class::MOP::Object
227         - added some tests to reflect this
228         
229     * Class::MOP::Class
230       - refactored all symbol table access to 
231         use Class::MOP::Package methods instead
232         
233     * Class::MOP::Module
234       - adding the $:version attribute in the bootstrap
235         so that Module has a version as an attribute
236         - see comment in Class::MOP for details
237       - added the $:authority attribute to this module 
238         as well as an &identifier method, to bring us 
239         ever closer to Perl 6 goodness 
240         - I have added $AUTHORITY to all the modules 
241         - added tests for this
242       
243     * Class::MOP::Instance
244       - added &deinitialize_slot for removing slots 
245         from an instance
246         - added tests for this      
247       
248     * Class::MOP::Attribute 
249       - added support for &deinitialize_slot for removing
250         slots from an instance
251         - added tests for this
252
253 0.31 Sat. July 15, 2006
254
255     * Class::MOP::Class
256       - added &find_method_by_name to locate a method
257         anywhere within the class hierarchy   
258         
259     * Class::MOP::Attribute
260       - added &set_value and &get_value for getting 
261         the value of the attribute for a particular 
262         instance.
263
264 0.30 Wed. July 5, 2006
265     ---------------------------------------
266     This is the first version of Class::MOP 
267     to introduce the immutable features which
268     will be used for optimizating the MOP. 
269     This support should still be considered
270     experimental, but moving towards stability.
271     ---------------------------------------
272     
273     * Created Class::MOP::Class::Immutable  
274     
275     * Created the Class::MOP::Package and 
276       Class::MOP::Module classes to more 
277       closely conform to Perl 6's meta-model
278
279     * Class::MOP::Class
280       - now inherits from Class::MOP::Module
281       - several methods moved to ::Module and 
282         ::Package and now inherited
283         - added tests for this
284       
285     * Class::MOP::Instance
286       - added an is_inlinable method to allow other 
287         classes to check before they attempt to optimize.
288       - added an inline_create_instance to inline 
289         instance creation (of course) 
290         
291     ** API CHANGE **
292       - the Class::MOP::Class::*_package_variable 
293         methods are all now methods of Class::MOP::Package
294         and called *_package_symbol instead. This is 
295         because they are now more general purpose symbol 
296         table manipulation methods.        
297
298 0.29_02 Thurs. June 22, 2006
299     ++ DEVELOPER RELEASE ++
300     * Class::MOP::Class
301       - small change in &create so that it behaves 
302         properly when inherited
303       - small fix to &clone_instance
304
305 0.29_01 Fri. May 12, 2006
306     ++ DEVELOPER RELEASE ++
307       - This release works in combination with 
308         Moose 0.09_01, it is a developer release
309         because it introduces a new instance 
310         sub-protocol and has not yet been 
311         optimized.  
312
313     * Class::MOP::Class
314       - anon-classes are now properly garbage collected
315         - added tests for this 
316       - improved method modifier wrapping 
317
318     * Class::MOP::Instance
319       - added new instance protocol
320         - added tests for this
321       - changed all relevant modules and examples
322         - Class::MOP::Class
323         - Class::MOP::Attribute
324         - examples/*
325
326     * metaclass
327       - you no longer need to specify the metaclass
328         itself, if it is not there, Class::MOP::Class
329         is just assumed
330         - updated tests for this
331
332     * examples/
333       - added ArrayBasedStorage example to show 
334         instance storage using ARRAY refs instead of
335         HASH refs. 
336         - added tests for this
337       - InsideOutClass is totally revised using the 
338         new instance protocol
339         - added more tests for this
340
341 0.26 Mon. April 24, 2006
342     * Class::MOP::Class
343       - added find_attribute_by_name method
344         - added tests and docs for this
345       - some small optimizations
346
347     * Class::MOP::Attribute
348       - some small optimizations
349
350 0.25 Thurs. April 20, 2006
351     * Class::MOP::Class
352       - added create_anon_class for creating anonymous classes
353         - added tests for this
354       - added get_all_metaclasses, get_all_metaclass_names
355         and get_all_metaclass_instances method to allow
356         access to all the cached metaclass objects.
357       - attribute slot initialization is now the responsibility
358         of the attribute itself, and construct_instance now 
359         delegates appropriately
360         
361     * Class::MOP::Attribute
362       - attribute slot initialization is now the responsibility
363         of the attribute itself, so we added a method for it
364         called initialize_instance_slot
365     
366     * examples/
367       - adjusted all the examples to use the new attribute 
368         initialize_instance_slot method 
369
370 0.24 Tues. April 11, 2006
371     * Class::MOP::Class
372       - cleaned up how the before/after/around method 
373         modifiers get named with Sub::Name
374
375 0.23 Thurs. March 30, 2006
376         * Class::MOP::Class
377           - fixed the way attribute defaults are handled 
378             during instance construction (bug found by chansen)
379             
380         * Class::MOP::Attribute
381           - read-only accessors ('reader') will now die if 
382             passed more than one argument (attempting to write
383             to them basically)
384               - added tests for this
385               - adjusted all /example files to comply 
386
387 0.22 Mon. March 20, 2006
388     * Class::MOP::Class
389       - localized $@ in the *_package_variable functions
390         because otherwise, it does ugly things in Moose.
391           - added test case for this
392
393 0.21 Wed. March 15, 2006
394     * Class::MOP::Class
395       - fixed issue where metaclasses are reaped from 
396         our cache in global destruction, and so are not
397         available in DESTORY calls
398
399 0.20 Thurs. March 2, 2006
400     - removed the dependency for Clone since 
401       we no longer to deep-cloning by default.
402     
403     * Class::MOP::Method
404       - added &package_name, &name and 
405         &fully_qualified_name methods, some of 
406         which were formerly private subs in 
407         Class::MOP::Class
408       
409     * Class::MOP::Method::Wrapped
410       - allows for a method to be wrapped with 
411         before, after and around modifiers 
412           - added tests and docs for this feature
413
414     * Class::MOP::Class
415       - improved &get_package_symbol
416           - &version and &superclasses now use it
417       - methods are now blessed into Class::MOP::Method
418         whenever possible
419       - added methods to install CLOS-style method modifiers 
420          - &add_before_method_modifier
421          - &add_after_method_modifier         
422          - &add_around_method_modifier
423              - added tests and docs for these
424       - added &find_next_method_by_name which finds the 
425         equivalent of SUPER::method_name
426
427 0.12 Thurs. Feb 23, 2006
428     - reduced the dependency on B, no need to always 
429       have the latest
430
431     * examples/
432       - added docs to the C3 method dispatch order test
433       - fixed missing Algorithm::C3 dependency by making 
434         the test skip if it is not installed
435
436 0.11 Mon Feb. 20, 2006
437     * examples/
438       - added example of changing method dispatch order to C3
439       
440     * Class::MOP::Class
441       - changed how clone_instance behaves, it now only does a
442         shallow clone (see docs for more details)
443         - added docs and tests
444
445 0.10 Tues Feb. 14, 2006
446     ** This release was mostly about writing more tests and 
447        cleaning out old and dusty code, the MOP should now 
448        be considered "ready to use".
449
450     - adding more tests to get coverage up a little higher,
451       mostly testing errors and edge cases.
452       - test coverage is now at 99%
453       
454     * Class::MOP
455       - no longer optionally exports to UNIVERSAL::meta or
456         creates a custom metaclass generator, use the 
457         metaclass pragma instead.
458
459     * Class::MOP::Class  
460       - fixed a number of minor issues which came up in the 
461         error/edge-case tests
462         
463     * Class::MOP::Attribute 
464       - fixed a number of minor issues which came up in the 
465         error/edge-case tests        
466      
467     * examples/
468       - fixing the AttributesWithHistory example, it was broken.
469
470 0.06 Thurs Feb. 9, 2006
471     * metaclass
472       - adding new metaclass pragma to make setting up the 
473         metaclass a little more straightforward
474         
475     * Class::MOP
476       - clean up bootstrapping to include more complete 
477         attribute definitions for Class::MOP::Class and 
478         Class::MOP::Attribute (accessors, readers, writers, 
479         etc.) ... it is redundant, but is useful meta-info
480         to have around.
481
482     * Class::MOP::Class
483       - fixing minor meta-circularity issue with &meta, it 
484         is now more useful for subclasses
485       - added &get_attribute_map as an accessor for the 
486         hash of attribute meta objects
487       - &compute_all_applicable_attributes now just returns
488         the attribute meta-object, rather than the HASH ref
489         since all the same info can be gotten from the 
490         attribute meta-object itself
491           - updated docs & tests to reflect
492       - added &clone_instance method which does a deep clone
493         of the instance structure created by &construct_instance
494           - added docs & tests for this
495           - added Clone as a dependency
496       - added &new_object and &clone_object convience methods to
497         return blessed new or cloned instances
498           - they handle Class::MOP::Class singletons correctly too
499           - added docs & tests for this
500       - cleaned up the &constuct_class_instance so that it behaves
501         more like &construct_instance (and managed the singletons too)
502       - added the &check_metaclass_compatibility method to make sure
503         that metaclasses are upward and downward compatible.
504           - added tests and docs for this
505           
506     * examples/
507       - adjusting code to use the &Class::MOP::Class::meta
508         fix detailed above
509       - adjusting code to use the metaclass pragma
510       
511 0.05 Sat Feb. 4, 2006
512     * Class::MOP::Class
513       - added the &attribute_metaclass and &method_metaclass
514         attributes which contain a metaclass name to use for 
515         attributes/methods respectively
516     
517     * Class::MOP
518       - bootstrap additional attributes for Class::MOP::Class 
519         
520     * examples/
521       - adjusted the example code and tests to use the new
522         &attribute_metaclass feature of Class::MOP::Class
523       - added new example:
524         - LazyClass
525
526 0.04 Fri Feb. 3, 2006
527     * Class::MOP::Class
528       - some documentation suggestions from #perl6
529     
530     * Class::MOP::Attribute
531       - improved error messages    
532     
533     * examples/
534       - added new examples:
535         - AttributesWithHistory
536         - ClassEncapsultedAttributes
537
538 0.03 Fri Feb. 3, 2006
539     - converted to Module::Build instead of EU::MM
540     
541     * Class::MOP::Attribute
542       - refactored method generation code
543       - attributes are now associated with class directly
544     
545     * examples/
546       - refactored the InsideOut example to take advantage 
547         of the Class::MOP::Attribute refactoring
548       - changed example files to .pod files and hide thier
549         package names from PAUSE (I don't want to own these
550         namespaces really, they are just examples)
551
552 0.02 Thurs Feb. 2, 2006
553     - moving examples from t/lib/* to examples/*
554         - adding POD documentation to the examples
555
556 0.01 Thurs Feb. 2, 2006
557     - Initial release