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