|
| 1 | +#------------------------------------------------------------------------------- |
| 2 | +# |
| 3 | +# Adds a Cocoa-like 'category' capability to Traits-base classes. |
| 4 | +# |
| 5 | +# Written by: David C. Morrill |
| 6 | +# |
| 7 | +# Date: 11/06/2004 |
| 8 | +# |
| 9 | +# (c) Copyright 2002, 2004 by Enthought, Inc. |
| 10 | +# |
| 11 | +#------------------------------------------------------------------------------- |
| 12 | + |
| 13 | +#------------------------------------------------------------------------------- |
| 14 | +# Imports: |
| 15 | +#------------------------------------------------------------------------------- |
| 16 | + |
| 17 | +from has_traits import MetaHasTraits, MetaHasTraitsObject, BaseTraits, \ |
| 18 | + ClassTraits, PrefixTraits, ViewTraits |
| 19 | + |
| 20 | +#------------------------------------------------------------------------------- |
| 21 | +# 'MetaCategory' class: |
| 22 | +#------------------------------------------------------------------------------- |
| 23 | + |
| 24 | +class MetaCategory ( MetaHasTraits ): |
| 25 | + |
| 26 | + def __new__ ( cls, class_name, bases, class_dict ): |
| 27 | + |
| 28 | + # Make sure the correct usage is being applied: |
| 29 | + if len( bases ) > 2: |
| 30 | + raise TypeError, \ |
| 31 | + "Correct usage is: class FooCategory(Category,Foo):" |
| 32 | + |
| 33 | + # Process any traits-related information in the class dictionary: |
| 34 | + MetaCategoryObject( cls, class_name, bases, class_dict, True ) |
| 35 | + |
| 36 | + # Move all remaining items in our class dictionary to the base class's |
| 37 | + # dictionary: |
| 38 | + if len( bases ) == 2: |
| 39 | + category_class = bases[1] |
| 40 | + for name, value in class_dict.items(): |
| 41 | + if name != '__module__': |
| 42 | + setattr( category_class, name, value ) |
| 43 | + del class_dict[ name ] |
| 44 | + |
| 45 | + # Finish building the class using the updated class dictionary: |
| 46 | + return type.__new__( cls, class_name, bases, class_dict ) |
| 47 | + |
| 48 | +#------------------------------------------------------------------------------- |
| 49 | +# 'MetaCategoryObject' class: |
| 50 | +#------------------------------------------------------------------------------- |
| 51 | + |
| 52 | +class MetaCategoryObject ( MetaHasTraitsObject ): |
| 53 | + |
| 54 | + #--------------------------------------------------------------------------- |
| 55 | + # Adds the traits meta-data to the class: |
| 56 | + #--------------------------------------------------------------------------- |
| 57 | + |
| 58 | + def add_traits_meta_data ( self, bases, class_dict, base_traits, |
| 59 | + class_traits, prefix_traits, view_elements ): |
| 60 | + if len( bases ) == 2: |
| 61 | + category_class = bases[1] |
| 62 | + |
| 63 | + # Update the base class's traits with the new ones: |
| 64 | + if len( base_traits ) > 0: |
| 65 | + getattr( category_class, BaseTraits ).update( base_traits ) |
| 66 | + if len( class_traits ) > 0: |
| 67 | + getattr( category_class, ClassTraits ).update( class_traits ) |
| 68 | + if len( prefix_traits ) > 0: |
| 69 | + getattr( category_class, PrefixTraits ).update( prefix_traits ) |
| 70 | + |
| 71 | + # Copy all our view elements into the base class's ViewElements: |
| 72 | + if view_elements is not None: |
| 73 | + content = view_elements.content |
| 74 | + if len( content ) > 0: |
| 75 | + base_ve = getattr( category_class, ViewTraits, None ) |
| 76 | + if base_ve is None: |
| 77 | + setattr( category_class, ViewTraits, view_elements ) |
| 78 | + else: |
| 79 | + base_ve.content.update( content ) |
| 80 | + |
| 81 | + # Update each of the existing subclasses as well: |
| 82 | + for subclass in category_class.trait_subclasses( True ): |
| 83 | + |
| 84 | + subclass_traits = getattr( subclass, BaseTraits ) |
| 85 | + for name, value in base_traits.items(): |
| 86 | + subclass_traits.setdefault( name, value ) |
| 87 | + |
| 88 | + subclass_traits = getattr( subclass, ClassTraits ) |
| 89 | + for name, value in class_traits.items(): |
| 90 | + subclass_traits.setdefault( name, value ) |
| 91 | + |
| 92 | + subclass_traits = getattr( subclass, PrefixTraits ) |
| 93 | + subclass_list = subclass_traits['*'] |
| 94 | + changed = False |
| 95 | + for name, value in prefix_traits.items(): |
| 96 | + if name not in subclass_traits: |
| 97 | + subclass_traits[ name ] = value |
| 98 | + subclass_list.append( name ) |
| 99 | + changed = True |
| 100 | + # Resort the list from longest to shortest (if necessary): |
| 101 | + if changed: |
| 102 | + subclass_list.sort( lambda x, y: len( y ) - len( x ) ) |
| 103 | + else: |
| 104 | + MetaHasTraitsObject.add_traits_meta_data( self, bases, |
| 105 | + class_dict, base_traits, class_traits, prefix_traits, |
| 106 | + view_elements ) |
| 107 | + |
| 108 | +#------------------------------------------------------------------------------- |
| 109 | +# 'Category' class: |
| 110 | +#------------------------------------------------------------------------------- |
| 111 | + |
| 112 | +class Category ( object ): |
| 113 | + |
| 114 | + __metaclass__ = MetaCategory |
| 115 | + |
0 commit comments