/usr/lib/python2.7/dist-packages/traits/category.py is in python-traits 4.6.0-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 | #------------------------------------------------------------------------------
#
# Copyright (c) 2005, Enthought, Inc.
# All rights reserved.
#
# This software is provided without warranty under the terms of the BSD
# license included in enthought/LICENSE.txt and may be redistributed only
# under the conditions described in the aforementioned license. The license
# is also available online at http://www.enthought.com/licenses/BSD.txt
#
# Thanks for using Enthought open source!
#
# Author: David C. Morrill
# Date: 11/06/2004
#
#------------------------------------------------------------------------------
""" Adds a "category" capability to Traits-based classes, similar to that
provided by the Cocoa (Objective-C) environment for the Macintosh.
You can use categories to extend an existing HasTraits class, as an
alternative to subclassing. An advantage of categories over subclassing is
that you can access the added members on instances of the original class,
without having to change them to instances of a subclass. Unlike
subclassing, categories do not allow overriding trait attributes.
"""
#-------------------------------------------------------------------------------
# Imports:
#-------------------------------------------------------------------------------
from __future__ import absolute_import
from .has_traits import MetaHasTraits, MetaHasTraitsObject
#-------------------------------------------------------------------------------
# 'MetaCategory' class:
#-------------------------------------------------------------------------------
class MetaCategory ( MetaHasTraits ):
def __new__ ( cls, class_name, bases, class_dict ):
# Make sure the correct usage is being applied:
if len( bases ) > 2:
raise TypeError, \
"Correct usage is: class FooCategory(Category,Foo):"
# Process any traits-related information in the class dictionary:
MetaCategoryObject( cls, class_name, bases, class_dict, True )
# Move all remaining items in our class dictionary to the base class's
# dictionary:
if len( bases ) == 2:
category_class = bases[1]
for name, value in class_dict.items():
if not hasattr( category_class, name ):
setattr( category_class, name, value )
del class_dict[ name ]
# Finish building the class using the updated class dictionary:
return type.__new__( cls, class_name, bases, class_dict )
#-------------------------------------------------------------------------------
# 'MetaCategoryObject' class:
#-------------------------------------------------------------------------------
class MetaCategoryObject ( MetaHasTraitsObject ):
#---------------------------------------------------------------------------
# Adds the traits meta-data to the class:
#---------------------------------------------------------------------------
def add_traits_meta_data ( self, bases, class_dict, base_traits,
class_traits, instance_traits, prefix_traits,
listeners, view_elements ):
if len( bases ) == 2:
# Update the class and each of the existing subclasses:
bases[1]._add_trait_category( base_traits, class_traits,
instance_traits, prefix_traits, listeners,
view_elements )
else:
MetaHasTraitsObject.add_traits_meta_data( self, bases,
class_dict, base_traits, class_traits, instance_traits,
prefix_traits, listeners, view_elements )
#-------------------------------------------------------------------------------
# 'Category' class:
#-------------------------------------------------------------------------------
class Category ( object ):
""" Used for defining "category" extensions to existing classes.
To define a class as a category, specify "Category," followed by the name
of the base class name in the base class list.
The following example demonstrates defining a category::
from traits.api import HasTraits, Str, Category
class Base(HasTraits):
x = Str("Base x")
y = Str("Base y")
class BaseExtra(Category, Base):
z = Str("BaseExtra z")
"""
__metaclass__ = MetaCategory
|