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