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