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