home *** CD-ROM | disk | FTP | other *** search
/ GameStar 2006 January / Gamestar_80_2006-01_dvd.iso / Dema / Civilization4 / data1.cab / Civ4DemoComponent / Assets / Python / System / Bastion.pyc (.txt) < prev    next >
Encoding:
Python Compiled Bytecode  |  2005-11-09  |  6.1 KB  |  160 lines
  1. # Source Generated with Decompyle++
  2. # File: in.pyc (Python 2.4)
  3.  
  4. """Bastionification utility.
  5.  
  6. A bastion (for another object -- the 'original') is an object that has
  7. the same methods as the original but does not give access to its
  8. instance variables.  Bastions have a number of uses, but the most
  9. obvious one is to provide code executing in restricted mode with a
  10. safe interface to an object implemented in unrestricted mode.
  11.  
  12. The bastionification routine has an optional second argument which is
  13. a filter function.  Only those methods for which the filter method
  14. (called with the method name as argument) returns true are accessible.
  15. The default filter method returns true unless the method name begins
  16. with an underscore.
  17.  
  18. There are a number of possible implementations of bastions.  We use a
  19. 'lazy' approach where the bastion's __getattr__() discipline does all
  20. the work for a particular method the first time it is used.  This is
  21. usually fastest, especially if the user doesn't call all available
  22. methods.  The retrieved methods are stored as instance variables of
  23. the bastion, so the overhead is only occurred on the first use of each
  24. method.
  25.  
  26. Detail: the bastion class has a __repr__() discipline which includes
  27. the repr() of the original object.  This is precomputed when the
  28. bastion is created.
  29.  
  30. """
  31. __all__ = [
  32.     'BastionClass',
  33.     'Bastion']
  34. from types import MethodType
  35.  
  36. class BastionClass:
  37.     '''Helper class used by the Bastion() function.
  38.  
  39.     You could subclass this and pass the subclass as the bastionclass
  40.     argument to the Bastion() function, as long as the constructor has
  41.     the same signature (a get() function and a name for the object).
  42.  
  43.     '''
  44.     
  45.     def __init__(self, get, name):
  46.         '''Constructor.
  47.  
  48.         Arguments:
  49.  
  50.         get - a function that gets the attribute value (by name)
  51.         name - a human-readable name for the original object
  52.                (suggestion: use repr(object))
  53.  
  54.         '''
  55.         self._get_ = get
  56.         self._name_ = name
  57.  
  58.     
  59.     def __repr__(self):
  60.         '''Return a representation string.
  61.  
  62.         This includes the name passed in to the constructor, so that
  63.         if you print the bastion during debugging, at least you have
  64.         some idea of what it is.
  65.  
  66.         '''
  67.         return '<Bastion for %s>' % self._name_
  68.  
  69.     
  70.     def __getattr__(self, name):
  71.         """Get an as-yet undefined attribute value.
  72.  
  73.         This calls the get() function that was passed to the
  74.         constructor.  The result is stored as an instance variable so
  75.         that the next time the same attribute is requested,
  76.         __getattr__() won't be invoked.
  77.  
  78.         If the get() function raises an exception, this is simply
  79.         passed on -- exceptions are not cached.
  80.  
  81.         """
  82.         attribute = self._get_(name)
  83.         self.__dict__[name] = attribute
  84.         return attribute
  85.  
  86.  
  87.  
  88. def Bastion(object, filter = (lambda name: name[:1] != '_'), name = None, bastionclass = BastionClass):
  89.     """Create a bastion for an object, using an optional filter.
  90.  
  91.     See the Bastion module's documentation for background.
  92.  
  93.     Arguments:
  94.  
  95.     object - the original object
  96.     filter - a predicate that decides whether a function name is OK;
  97.              by default all names are OK that don't start with '_'
  98.     name - the name of the object; default repr(object)
  99.     bastionclass - class used to create the bastion; default BastionClass
  100.  
  101.     """
  102.     raise RuntimeError, 'This code is not secure in Python 2.2 and 2.3'
  103.     
  104.     def get1(name, object = object, filter = filter):
  105.         '''Internal function for Bastion().  See source comments.'''
  106.         if filter(name):
  107.             attribute = getattr(object, name)
  108.             if type(attribute) == MethodType:
  109.                 return attribute
  110.             
  111.         
  112.         raise AttributeError, name
  113.  
  114.     
  115.     def get2(name, get1 = get1):
  116.         '''Internal function for Bastion().  See source comments.'''
  117.         return get1(name)
  118.  
  119.     if name is None:
  120.         name = repr(object)
  121.     
  122.     return bastionclass(get2, name)
  123.  
  124.  
  125. def _test():
  126.     '''Test the Bastion() function.'''
  127.     
  128.     class Original:
  129.         
  130.         def __init__(self):
  131.             self.sum = 0
  132.  
  133.         
  134.         def add(self, n):
  135.             self._add(n)
  136.  
  137.         
  138.         def _add(self, n):
  139.             self.sum = self.sum + n
  140.  
  141.         
  142.         def total(self):
  143.             return self.sum
  144.  
  145.  
  146.     o = Original()
  147.     b = Bastion(o)
  148.     testcode = 'if 1:\n    b.add(81)\n    b.add(18)\n    print "b.total() =", b.total()\n    try:\n        print "b.sum =", b.sum,\n    except:\n        print "inaccessible"\n    else:\n        print "accessible"\n    try:\n        print "b._add =", b._add,\n    except:\n        print "inaccessible"\n    else:\n        print "accessible"\n    try:\n        print "b._get_.func_defaults =", map(type, b._get_.func_defaults),\n    except:\n        print "inaccessible"\n    else:\n        print "accessible"\n    \n'
  149.     exec testcode
  150.     print '=' * 20, 'Using rexec:', '=' * 20
  151.     import rexec
  152.     r = rexec.RExec()
  153.     m = r.add_module('__main__')
  154.     m.b = b
  155.     r.r_exec(testcode)
  156.  
  157. if __name__ == '__main__':
  158.     _test()
  159.  
  160.