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