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