"""The wrapping code for providing natural ctypes-based OpenGL interface"""
import ctypes, logging
from OpenGL import platform,error,STORE_POINTERS,ERROR_ON_COPY,SIZE_1_ARRAY_UNPACK
glGetError = platform.OpenGL.glGetError
from OpenGL import converters
from OpenGL.converters import DefaultCConverter
from OpenGL.converters import returnCArgument,returnPyArgument
from OpenGL.latebind import LateBind
log = logging.getLogger( 'OpenGL.wrapper' )
from OpenGL import acceleratesupport
cWrapper = None
if acceleratesupport.ACCELERATE_AVAILABLE:
try:
from OpenGL_accelerate.latebind import LateBind
from OpenGL_accelerate.wrapper import (
Wrapper as cWrapper,
CArgCalculator,
PyArgCalculator,
CArgumentCalculator,
)
except ImportError, err:
log.warn( """OpenGL_accelerate seems to be installed, but unable to import expected wrapper entry points!""" )
NULL = object()
if not STORE_POINTERS:
if not ERROR_ON_COPY:
log.error( """You've specified (not STORE_POINTERS) yet ERROR_ON_COPY is False, this would cause segfaults, so (not STORE_POINTERS) is being ignored""" )
STORE_POINTERS = True
def asList( o ):
"""Convert to a list if not already one"""
if not isinstance( o, list ):
return list(o)
return o
class Wrapper( LateBind ):
"""Wrapper around a ctypes cFunction object providing SWIG-like hooks
Attributes:
wrappedOperation -- base operation, normally a ctypes function
with data-types and error-checking specified
pyConverters -- converters for incoming Python arguments,
provide 1:1 mapping to incoming Python arguments, can
suppress an argument from the argument-set as well
see setPyConverter
pyConverterNames -- caching/storage of the argument names
for the Python converters
cConverters -- converters for incoming C-level arguments
produce Python-level objects in 1:1 mapping to ctypes
arguments from pyConverters results
see setCConverter
cResolvers -- converters turning Python-level objects into
ctypes-compatible data-types
see setCResolver
Generic Attributes:
{ARG1}_LOOKUP_{ARG2} -- lookup dictionaries to provide sizes for
ARG1 output value from the value of ARG2, provided for
documentation/reference
{ARG1}_FROM_{ARG2} -- lookup functions to provide sizes for ARG1
output value from the value of ARG2, provided for
documentation/reference
"""
localProperties = (
'wrappedOperation',
'__file__',
'pyConverters',
'pyConverterNames',
'cConverters',
'cResolvers',
'storeValues',
'returnValues',
'_finalCall',
)
def __init__( self, wrappedOperation ):
"""Initialise the wrapper, storing wrappedOperation"""
if isinstance( wrappedOperation, Wrapper ):
wrappedOperation = wrappedOperation.wrappedOperation
self.wrappedOperation = wrappedOperation
def __getattr__( self, key ):
"""Delegate attribute lookup to our wrappedOperation"""
if key != 'wrappedOperation':
return getattr( self.wrappedOperation, key )
raise AttributeError( key )
def __nonzero__( self ):
"""Is this function/wrapper available?"""
return bool( self.wrappedOperation )
def __setattr__( self, key, value ):
"""Forward attribute setting to our wrappedOperation"""
if key in self.localProperties:
super( Wrapper, self ).__setattr__( key, value )
else:
return setattr( self.wrappedOperation, key, value )
def pyArgIndex( self, argName ):
"""Return the Python-argument index for the given argument name"""
argNames = getattr( self, 'pyConverterNames', None )
if argNames is None:
argNames = self.wrappedOperation.argNames
try:
return asList( argNames ).index( argName )
except (ValueError,IndexError), err:
raise KeyError( """No argument %r in argument list %r"""%(
argName, argNames
))
def cArgIndex( self, argName ):
"""Return the C-argument index for the given argument name"""
argNames = self.wrappedOperation.argNames
try:
return asList( argNames ).index( argName )
except (ValueError,IndexError), err:
raise KeyError( """No argument %r in argument list %r"""%(
argName, argNames
))
def setOutput(
self, outArg, size=(1,), pnameArg=None,
arrayType=None, oldStyleReturn=SIZE_1_ARRAY_UNPACK,
orPassIn = False,
):
"""Set the given argName to be an output array
size -- either a tuple compatible with arrayType.zeros or
a function taking pname to produce such a value.
arrayType -- array data-type used to generate the output
array using the zeros class method...
pname -- optional argument passed into size function, that
is, the name of the argument whose *value* will be passed
to the size function, often the name of an input argument
to be "sized" to match the output argument.
"""
if arrayType is None:
# figure out from self.wrappedOperation's argtypes
index = self.cArgIndex( outArg )
arrayType = self.wrappedOperation.argtypes[ index ]
if pnameArg is None:
assert not hasattr(size,'__call__' )
conv = converters.Output(
name=outArg,
size=size,
arrayType=arrayType,
)
else:
if isinstance( size, dict ):
setattr( self, '%s_LOOKUP_%s'%(outArg,pnameArg), size )
size = size.__getitem__
else:
setattr( self, '%s_FROM_%s'%(outArg,pnameArg), size )
assert hasattr( size, '__call__' )
conv = converters.SizedOutput(
name=outArg,
specifier=pnameArg,
lookup=size,
arrayType=arrayType,
)
if oldStyleReturn:
returnObject = conv.oldStyleReturn
else:
returnObject = converters.returnCArgument( outArg )
if orPassIn:
self.setPyConverter(
outArg, None
)
else:
self.setPyConverter( outArg )
return self.setCConverter(
outArg, conv,
).setReturnValues(
returnObject
)
def setPyConverter( self, argName, function = NULL ):
"""Set Python-argument converter for given argument
argName -- the argument name which will be coerced to a usable internal
format using the function provided.
function -- None (indicating a simple copy), NULL (default) to eliminate
the argument from the Python argument-list, or a callable object with
the signature:
converter(arg, wrappedOperation, args)
where arg is the particular argument on which the convert is working,
wrappedOperation is the underlying wrapper, and args is the set of
original Python arguments to the function.
Note that you need exactly the same number of pyConverters as Python
arguments.
"""
if not hasattr( self, 'pyConverters' ):
self.pyConverters = [None]*len( self.wrappedOperation.argNames )
self.pyConverterNames = list(self.wrappedOperation.argNames)
try:
i = asList( self.pyConverterNames ).index( argName )
except ValueError:
raise AttributeError( """No argument named %r left in pyConverters for %r: %s"""%(
argName, self.wrappedOperation.__name__, self.pyConverterNames,
))
if function is NULL:
del self.pyConverters[i]
del self.pyConverterNames[i]
else:
self.pyConverters[i] = function
return self
def setCConverter( self, argName, function ):
"""Set C-argument converter for a given argument
argName -- the argument name whose C-compatible representation will
be calculated with the passed function.
function -- None (indicating a simple copy), a non-callable object to
be copied into the result-list itself, or a callable object with
the signature:
converter( pyArgs, index, wrappedOperation )
where pyArgs is the set of passed Python arguments, with the
pyConverters already applied, index is the index of the C argument
and wrappedOperation is the underlying function.
C-argument converters are your chance to expand/contract a Python
argument list (pyArgs) to match the number of arguments expected by
the ctypes baseOperation. You can't have a "null" C-argument converter,
as *something* has to be passed to the C-level function in the
parameter.
"""
if not hasattr( self, 'cConverters' ):
self.cConverters = [None]*len( self.wrappedOperation.argNames )
try:
if not isinstance(self.wrappedOperation.argNames, list):
self.wrappedOperation.argNames = list( self.wrappedOperation.argNames )
i = asList( self.wrappedOperation.argNames ).index( argName )
except ValueError:
raise AttributeError( """No argument named %r left in cConverters: %s"""%(
argName, self.wrappedOperation.argNames,
))
self.cConverters[i] = function
return self
def setCResolver( self, argName, function=NULL ):
"""Set C-argument converter for a given argument"""
if not hasattr( self, 'cResolvers' ):
self.cResolvers = [None]*len( self.wrappedOperation.argNames )
try:
if not isinstance(self.wrappedOperation.argNames, list):
self.wrappedOperation.argNames = list( self.wrappedOperation.argNames )
i = asList( self.wrappedOperation.argNames).index( argName )
except ValueError:
raise AttributeError( """No argument named %r left in cConverters: %s"""%(
argName, self.wrappedOperation.argNames,
))
if function is NULL:
del self.cResolvers[i]
else:
self.cResolvers[i] = function
return self
def setStoreValues( self, function=NULL ):
"""Set the storage-of-arguments function for the whole wrapper"""
if function is NULL or ERROR_ON_COPY and not STORE_POINTERS:
try:
del self.storeValues
except Exception, err:
pass
else:
self.storeValues = function
return self
def setReturnValues( self, function=NULL ):
"""Set the return-of-results function for the whole wrapper"""
if function is NULL:
try:
del self.returnValues
except Exception, err:
pass
else:
self.returnValues = function
return self
def finalise( self ):
"""Finalise our various elements into simple index-based operations"""
for attribute in ('pyConverters','cConverters','cResolvers' ):
value = getattr( self, attribute, None )
if value is not None:
for i,item in enumerate(value):
if hasattr( item, 'finalise' ):
try:
item.finalise( self )
except Exception, err:
raise error.Error(
"""Error finalising item %s in %s for %s (%r): %s"""%(
i,attribute,self,item,err,
)
)
if hasattr( self, 'cConverters' ):
for i,converter in enumerate( self.cConverters ):
if isinstance( converter, (type(None),DefaultCConverter )):
self.cConverters[i] = DefaultCConverter( self.pyArgIndex( self.argNames[i]) )
for attribute in ('storeValues','returnValues',):
item = getattr( self, attribute, None )
if hasattr( item, 'finalise' ):
item.finalise( self )
callFunction = self.finaliseCall()
if not callFunction:
raise RuntimeError( """Missing finalised call type for %s"""%( self, ))
else:
#self.__class__.finalize = lambda *args: callFunction
#self.__call__ = callFunction
#self.__class__.__call__ = callFunction
#self.__class__.set_call( callFunction )
#self.__class__.__dict__[ '__call__' ] = callFunction
#print 'setting class call', callFunction
self.setFinalCall( callFunction )
return callFunction
#return self
def finaliseCall( self ):
"""Produce specialised versions of call for finalised wrapper object
This returns a version of __call__ that only does that work which is
required by the particular wrapper object
This is essentially a huge set of expanded nested functions, very
inelegant...
"""
pyConverters = getattr( self, 'pyConverters', None )
cConverters = getattr( self, 'cConverters', None )
cResolvers = getattr( self, 'cResolvers', None )
wrappedOperation = self.wrappedOperation
storeValues = getattr( self, 'storeValues', None )
returnValues = getattr( self, 'returnValues', None )
if pyConverters:
if cWrapper:
calculate_pyArgs = PyArgCalculator(
self,pyConverters,
)
else:
pyConverters_mapped = [
(i,converter,(converter is None))
for (i,converter) in enumerate( pyConverters )
]
pyConverters_length = len(pyConverters)
def calculate_pyArgs( args ):
if pyConverters_length != len(args):
raise ValueError(
"""%s requires %r arguments (%s), received %s: %r"""%(
wrappedOperation.__name__,
pyConverters_length,
", ".join( self.pyConverterNames ),
len(args),
args
)
)
for index,converter,isNone in pyConverters_mapped:
if isNone:
yield args[index]
else:
try:
yield converter(args[index], self, args)
except Exception, err:
if hasattr( err, 'args' ):
err.args += ( converter, )
raise
else:
calculate_pyArgs = None
if cConverters:
if cWrapper:
calculate_cArgs = CArgCalculator( self, cConverters )
else:
cConverters_mapped = [
(i,converter,hasattr(converter,'__call__'))
for (i,converter) in enumerate( cConverters )
]
def calculate_cArgs( pyArgs ):
for index,converter,canCall in cConverters_mapped:
if canCall:
try:
yield converter( pyArgs, index, self )
except Exception, err:
if hasattr( err, 'args' ):
err.args += (
"""Failure in cConverter %r"""%(converter),
pyArgs, index, self,
)
raise
else:
yield converter
else:
calculate_cArgs = None
if cResolvers:
if cWrapper:
calculate_cArguments = CArgumentCalculator( cResolvers )
else:
cResolvers_mapped = list(enumerate(cResolvers))
def calculate_cArguments( cArgs ):
for i,converter in cResolvers_mapped:
if converter is None:
yield cArgs[i]
else:
try:
yield converter( cArgs[i] )
except Exception, err:
err.args += (converter,)
raise
else:
calculate_cArguments = None
if cWrapper:
return cWrapper(
wrappedOperation,
calculate_pyArgs=calculate_pyArgs,
calculate_cArgs=calculate_cArgs,
calculate_cArguments=calculate_cArguments,
storeValues=storeValues,
returnValues=returnValues,
)
if pyConverters:
if cConverters:
# create a map of index,converter, callable
if cResolvers:
if storeValues:
if returnValues:
def wrapperCall( *args ):
"""Wrapper with all possible operations"""
pyArgs = tuple( calculate_pyArgs( args ))
cArgs = tuple(calculate_cArgs( pyArgs ))
cArguments = tuple(calculate_cArguments( cArgs ))
try:
result = self.wrappedOperation( *cArguments )
except ctypes.ArgumentError, err:
err.args = err.args + (cArguments,)
raise err
except error.GLError, err:
err.cArgs = cArgs
err.pyArgs = pyArgs
raise err
# handle storage of persistent argument values...
storeValues(
result,
self,
pyArgs,
cArgs,
)
return returnValues(
result,
self,
pyArgs,
cArgs,
)
return wrapperCall
else:
def wrapperCall( *args ):
"""Wrapper with all save returnValues"""
pyArgs = tuple( calculate_pyArgs( args ))
cArgs = tuple(calculate_cArgs( pyArgs ))
cArguments = tuple(calculate_cArguments( cArgs ))
try:
result = self.wrappedOperation( *cArguments )
except ctypes.ArgumentError, err:
err.args = err.args + (cArguments,)
raise err
except error.GLError, err:
err.cArgs = cArgs
err.pyArgs = pyArgs
raise err
# handle storage of persistent argument values...
storeValues(
result,
self,
pyArgs,
cArgs,
)
return result
return wrapperCall
else: # null storeValues
if returnValues:
def wrapperCall( *args ):
"""Wrapper with all save storeValues"""
pyArgs = tuple( calculate_pyArgs( args ))
cArgs = tuple(calculate_cArgs( pyArgs ))
cArguments = tuple(calculate_cArguments( cArgs ))
try:
result = self.wrappedOperation( *cArguments )
except ctypes.ArgumentError, err:
err.args = err.args + (cArguments,)
raise err
except error.GLError, err:
err.cArgs = cArgs
err.pyArgs = pyArgs
raise err
return returnValues(
result,
self,
pyArgs,
cArgs,
)
return wrapperCall
else:
def wrapperCall( *args ):
"""Wrapper with all save returnValues and storeValues"""
pyArgs = tuple( calculate_pyArgs( args ))
cArgs = tuple(calculate_cArgs( pyArgs ))
cArguments = tuple(calculate_cArguments( cArgs ))
try:
result = self.wrappedOperation( *cArguments )
except ctypes.ArgumentError, err:
err.args = err.args + (cArguments,)
raise err
except error.GLError, err:
err.cArgs = cArgs
err.pyArgs = pyArgs
raise err
return result
return wrapperCall
else:
# null cResolvers
if storeValues:
if returnValues:
def wrapperCall( *args ):
"""Wrapper with all possible operations"""
pyArgs = tuple( calculate_pyArgs( args ))
cArgs = tuple(calculate_cArgs( pyArgs ))
cArguments = cArgs
try:
result = self.wrappedOperation( *cArguments )
except ctypes.ArgumentError, err:
err.args = err.args + (cArguments,)
raise err
except error.GLError, err:
err.cArgs = cArgs
err.pyArgs = pyArgs
raise err
# handle storage of persistent argument values...
storeValues(
result,
self,
pyArgs,
cArgs,
)
return returnValues(
result,
self,
pyArgs,
cArgs,
)
return wrapperCall
else:
def wrapperCall( *args ):
"""Wrapper with all save returnValues"""
pyArgs = tuple( calculate_pyArgs( args ))
cArgs = tuple(calculate_cArgs( pyArgs ))
cArguments = cArgs
try:
result = self.wrappedOperation( *cArguments )
except ctypes.ArgumentError, err:
err.args = err.args + (cArguments,)
raise err
except error.GLError, err:
err.cArgs = cArgs
err.pyArgs = pyArgs
raise err
# handle storage of persistent argument values...
storeValues(
result,
self,
pyArgs,
cArgs,
)
return result
return wrapperCall
else: # null storeValues
if returnValues:
def wrapperCall( *args ):
"""Wrapper with all save storeValues"""
pyArgs = tuple( calculate_pyArgs( args ))
cArgs = tuple(calculate_cArgs( pyArgs ))
cArguments = cArgs
try:
result = self.wrappedOperation( *cArguments )
except ctypes.ArgumentError, err:
err.args = err.args + (cArguments,)
raise err
except error.GLError, err:
err.cArgs = cArgs
err.pyArgs = pyArgs
raise err
return returnValues(
result,
self,
pyArgs,
cArgs,
)
return wrapperCall
else:
def wrapperCall( *args ):
"""Wrapper with all save returnValues and storeValues"""
pyArgs = tuple( calculate_pyArgs( args ))
cArgs = tuple(calculate_cArgs( pyArgs ))
cArguments = cArgs
try:
result = self.wrappedOperation( *cArguments )
except ctypes.ArgumentError, err:
err.args = err.args + (cArguments,)
raise err
except error.GLError, err:
err.cArgs = cArgs
err.pyArgs = pyArgs
raise err
return result
return wrapperCall
else:
# null cConverters
if cResolvers:
if storeValues:
if returnValues:
def wrapperCall( *args ):
"""Wrapper with all possible operations"""
pyArgs = tuple( calculate_pyArgs( args ))
cArgs = pyArgs
cArguments = tuple(calculate_cArguments( cArgs ))
try:
result = self.wrappedOperation( *cArguments )
except ctypes.ArgumentError, err:
err.args = err.args + (cArguments,)
raise err
except error.GLError, err:
err.cArgs = cArgs
err.pyArgs = pyArgs
raise err
# handle storage of persistent argument values...
storeValues(
result,
self,
pyArgs,
cArgs,
)
return returnValues(
result,
self,
pyArgs,
cArgs,
)
return wrapperCall
else:
def wrapperCall( *args ):
"""Wrapper with all save returnValues"""
pyArgs = tuple( calculate_pyArgs( args ))
cArgs = pyArgs
cArguments = tuple(calculate_cArguments( cArgs ))
try:
result = self.wrappedOperation( *cArguments )
except ctypes.ArgumentError, err:
err.args = err.args + (cArguments,)
raise err
except error.GLError, err:
err.cArgs = cArgs
err.pyArgs = pyArgs
raise err
# handle storage of persistent argument values...
storeValues(
result,
self,
pyArgs,
cArgs,
)
return result
return wrapperCall
else: # null storeValues
if returnValues:
def wrapperCall( *args ):
"""Wrapper with all save storeValues"""
pyArgs = tuple( calculate_pyArgs( args ))
cArgs = pyArgs
cArguments = tuple(calculate_cArguments( cArgs ))
try:
result = self.wrappedOperation( *cArguments )
except ctypes.ArgumentError, err:
err.args = err.args + (cArguments,)
raise err
except error.GLError, err:
err.cArgs = cArgs
err.pyArgs = pyArgs
raise err
return returnValues(
result,
self,
pyArgs,
cArgs,
)
return wrapperCall
else:
def wrapperCall( *args ):
"""Wrapper with all save returnValues and storeValues"""
pyArgs = tuple( calculate_pyArgs( args ))
cArgs = pyArgs
cArguments = tuple(calculate_cArguments( cArgs ))
try:
result = self.wrappedOperation( *cArguments )
except ctypes.ArgumentError, err:
err.args = err.args + (cArguments,)
raise err
except error.GLError, err:
err.cArgs = cArgs
err.pyArgs = pyArgs
raise err
return result
return wrapperCall
else:
# null cResolvers
if storeValues:
if returnValues:
def wrapperCall( *args ):
"""Wrapper with all possible operations"""
pyArgs = tuple( calculate_pyArgs( args ))
cArguments = pyArgs
try:
result = self.wrappedOperation( *cArguments )
except ctypes.ArgumentError, err:
err.args = err.args + (cArguments,)
raise err
except error.GLError, err:
err.cArgs = cArguments
err.pyArgs = pyArgs
raise err
# handle storage of persistent argument values...
storeValues(
result,
self,
pyArgs,
cArguments,
)
return returnValues(
result,
self,
pyArgs,
cArguments,
)
return wrapperCall
else:
def wrapperCall( *args ):
"""Wrapper with all save returnValues"""
pyArgs = tuple( calculate_pyArgs( args ))
cArguments = pyArgs
try:
result = self.wrappedOperation( *cArguments )
except ctypes.ArgumentError, err:
err.args = err.args + (cArguments,)
raise err
except error.GLError, err:
err.cArgs = cArguments
err.pyArgs = pyArgs
raise err
# handle storage of persistent argument values...
storeValues(
result,
self,
pyArgs,
cArguments,
)
return result
return wrapperCall
else: # null storeValues
if returnValues:
def wrapperCall( *args ):
"""Wrapper with all save storeValues"""
pyArgs = tuple( calculate_pyArgs( args ))
cArguments = pyArgs
try:
result = self.wrappedOperation( *cArguments )
except ctypes.ArgumentError, err:
err.args = err.args + (cArguments,)
raise err
except error.GLError, err:
err.cArgs = cArguments
err.pyArgs = pyArgs
raise err
return returnValues(
result,
self,
pyArgs,
cArguments,
)
return wrapperCall
else:
def wrapperCall( *args ):
"""Wrapper with all save returnValues and storeValues"""
pyArgs = tuple( calculate_pyArgs( args ))
cArguments = pyArgs
try:
result = self.wrappedOperation( *cArguments )
except ctypes.ArgumentError, err:
err.args = err.args + (cArguments,)
raise err
except error.GLError, err:
err.cArgs = cArguments
err.pyArgs = pyArgs
raise err
return result
return wrapperCall
else:
# null pyConverters
if cConverters:
if cResolvers:
if storeValues:
if returnValues:
def wrapperCall( *args ):
"""Wrapper with all possible operations"""
pyArgs = args
cArgs = []
for (index,converter) in enumerate( cConverters ):
# move enumerate out...
if not hasattr(converter,'__call__'):
cArgs.append( converter )
else:
try:
cArgs.append(
converter( pyArgs, index, self )
)
except Exception, err:
if hasattr( err, 'args' ):
err.args += (
"""Failure in cConverter %r"""%(converter),
pyArgs, index,
)
raise
cArguments = tuple(calculate_cArguments( cArgs ))
try:
result = self.wrappedOperation( *cArguments )
except ctypes.ArgumentError, err:
err.args = err.args + (cArguments,)
raise err
except error.GLError, err:
err.cArgs = cArgs
err.pyArgs = pyArgs
raise err
# handle storage of persistent argument values...
storeValues(
result,
self,
pyArgs,
cArgs,
)
return returnValues(
result,
self,
pyArgs,
cArgs,
)
return wrapperCall
else:
def wrapperCall( *args ):
"""Wrapper with all save returnValues"""
pyArgs = args
cArgs = []
for (index,converter) in enumerate( cConverters ):
# move enumerate out...
if not hasattr(converter,'__call__'):
cArgs.append( converter )
else:
try:
cArgs.append(
converter( pyArgs, index, self )
)
except Exception, err:
if hasattr( err, 'args' ):
err.args += (
"""Failure in cConverter %r"""%(converter),
pyArgs, index,
)
raise
cArguments = tuple(calculate_cArguments( cArgs ))
try:
result = self.wrappedOperation( *cArguments )
except ctypes.ArgumentError, err:
err.args = err.args + (cArguments,)
raise err
except error.GLError, err:
err.cArgs = cArgs
err.pyArgs = pyArgs
raise err
# handle storage of persistent argument values...
storeValues(
result,
self,
pyArgs,
cArgs,
)
return result
return wrapperCall
else: # null storeValues
if returnValues:
def wrapperCall( *args ):
"""Wrapper with all save storeValues"""
pyArgs = args
cArgs = []
for (index,converter) in enumerate( cConverters ):
# move enumerate out...
if not hasattr(converter,'__call__'):
cArgs.append( converter )
else:
try:
cArgs.append(
converter( pyArgs, index, self )
)
except Exception, err:
if hasattr( err, 'args' ):
err.args += (
"""Failure in cConverter %r"""%(converter),
pyArgs, index,
)
raise
cArguments = tuple(calculate_cArguments( cArgs ))
try:
result = self.wrappedOperation( *cArguments )
except ctypes.ArgumentError, err:
err.args = err.args + (cArguments,)
raise err
except error.GLError, err:
err.cArgs = cArgs
err.pyArgs = pyArgs
raise err
return returnValues(
result,
self,
pyArgs,
cArgs,
)
return wrapperCall
else:
def wrapperCall( *args ):
"""Wrapper with all save returnValues and storeValues"""
pyArgs = args
cArgs = []
for (index,converter) in enumerate( cConverters ):
# move enumerate out...
if not hasattr(converter,'__call__'):
cArgs.append( converter )
else:
try:
cArgs.append(
converter( pyArgs, index, self )
)
except Exception, err:
if hasattr( err, 'args' ):
err.args += (
"""Failure in cConverter %r"""%(converter),
pyArgs, index,
)
raise
cArguments = tuple(calculate_cArguments( cArgs ))
try:
result = self.wrappedOperation( *cArguments )
except ctypes.ArgumentError, err:
err.args = err.args + (cArguments,)
raise err
except error.GLError, err:
err.cArgs = cArgs
err.pyArgs = pyArgs
raise err
return result
return wrapperCall
else:
# null cResolvers
if storeValues:
if returnValues:
def wrapperCall( *args ):
"""Wrapper with all possible operations"""
pyArgs = args
cArgs = []
for (index,converter) in enumerate( cConverters ):
# move enumerate out...
if not hasattr(converter,'__call__'):
cArgs.append( converter )
else:
try:
cArgs.append(
converter( pyArgs, index, self )
)
except Exception, err:
if hasattr( err, 'args' ):
err.args += (
"""Failure in cConverter %r"""%(converter),
pyArgs, index,
)
raise
cArguments = cArgs
try:
result = self.wrappedOperation( *cArguments )
except ctypes.ArgumentError, err:
err.args = err.args + (cArguments,)
raise err
except error.GLError, err:
err.cArgs = cArgs
err.pyArgs = pyArgs
raise err
# handle storage of persistent argument values...
storeValues(
result,
self,
pyArgs,
cArgs,
)
return returnValues(
result,
self,
pyArgs,
cArgs,
)
return wrapperCall
else:
def wrapperCall( *args ):
"""Wrapper with all save returnValues"""
pyArgs = args
cArgs = []
for (index,converter) in enumerate( cConverters ):
# move enumerate out...
if not hasattr(converter,'__call__'):
cArgs.append( converter )
else:
try:
cArgs.append(
converter( pyArgs, index, self )
)
except Exception, err:
if hasattr( err, 'args' ):
err.args += (
"""Failure in cConverter %r"""%(converter),
pyArgs, index,
)
raise
cArguments = cArgs
try:
result = self.wrappedOperation( *cArguments )
except ctypes.ArgumentError, err:
err.args = err.args + (cArguments,)
raise err
except error.GLError, err:
err.cArgs = cArgs
err.pyArgs = pyArgs
raise err
# handle storage of persistent argument values...
storeValues(
result,
self,
pyArgs,
cArgs,
)
return result
return wrapperCall
else: # null storeValues
if returnValues:
def wrapperCall( *args ):
"""Wrapper with all save storeValues"""
pyArgs = args
cArgs = []
for (index,converter) in enumerate( cConverters ):
# move enumerate out...
if not hasattr(converter,'__call__'):
cArgs.append( converter )
else:
try:
cArgs.append(
converter( pyArgs, index, self )
)
except Exception, err:
if hasattr( err, 'args' ):
err.args += (
"""Failure in cConverter %r"""%(converter),
pyArgs, index,
)
raise
cArguments = cArgs
try:
result = self.wrappedOperation( *cArguments )
except ctypes.ArgumentError, err:
err.args = err.args + (cArguments,)
raise err
except error.GLError, err:
err.cArgs = cArgs
err.pyArgs = pyArgs
raise err
return returnValues(
result,
self,
pyArgs,
cArgs,
)
return wrapperCall
else:
def wrapperCall( *args ):
"""Wrapper with all save returnValues and storeValues"""
pyArgs = args
cArgs = []
for (index,converter) in enumerate( cConverters ):
# move enumerate out...
if not hasattr(converter,'__call__'):
cArgs.append( converter )
else:
try:
cArgs.append(
converter( pyArgs, index, self )
)
except Exception, err:
if hasattr( err, 'args' ):
err.args += (
"""Failure in cConverter %r"""%(converter),
pyArgs, index,
)
raise
cArguments = cArgs
try:
result = self.wrappedOperation( *cArguments )
except ctypes.ArgumentError, err:
err.args = err.args + (cArguments,)
raise err
except error.GLError, err:
err.cArgs = cArgs
err.pyArgs = pyArgs
raise err
return result
return wrapperCall
else:
# null cConverters
if cResolvers:
if storeValues:
if returnValues:
def wrapperCall( *args ):
"""Wrapper with all possible operations"""
cArgs = args
cArguments = tuple(calculate_cArguments( cArgs ))
try:
result = self.wrappedOperation( *cArguments )
except ctypes.ArgumentError, err:
err.args = err.args + (cArguments,)
raise err
except error.GLError, err:
err.cArgs = cArgs
err.pyArgs = args
raise err
# handle storage of persistent argument values...
storeValues(
result,
self,
args,
cArgs,
)
return returnValues(
result,
self,
args,
cArgs,
)
return wrapperCall
else:
def wrapperCall( *args ):
"""Wrapper with all save returnValues"""
cArgs = args
cArguments = tuple(calculate_cArguments( cArgs ))
try:
result = self.wrappedOperation( *cArguments )
except ctypes.ArgumentError, err:
err.args = err.args + (cArguments,)
raise err
except error.GLError, err:
err.cArgs = cArgs
err.pyArgs = args
raise err
# handle storage of persistent argument values...
storeValues(
result,
self,
args,
cArgs,
)
return result
return wrapperCall
else: # null storeValues
if returnValues:
def wrapperCall( *args ):
"""Wrapper with all save storeValues"""
cArgs = args
cArguments = tuple(calculate_cArguments( cArgs ))
try:
result = self.wrappedOperation( *cArguments )
except ctypes.ArgumentError, err:
err.args = err.args + (cArguments,)
raise err
except error.GLError, err:
err.cArgs = cArgs
err.pyArgs = args
raise err
return returnValues(
result,
self,
args,
cArgs,
)
return wrapperCall
else:
def wrapperCall( *args ):
"""Wrapper with all save returnValues and storeValues"""
cArgs = args
cArguments = tuple(calculate_cArguments( cArgs ))
try:
result = self.wrappedOperation( *cArguments )
except ctypes.ArgumentError, err:
err.args = err.args + (cArguments,)
raise err
except error.GLError, err:
err.cArgs = cArgs
err.pyArgs = args
raise err
return result
return wrapperCall
else:
# null cResolvers
if storeValues:
if returnValues:
def wrapperCall( *args ):
"""Wrapper with all possible operations"""
cArguments = args
try:
result = self.wrappedOperation( *cArguments )
except ctypes.ArgumentError, err:
err.args = err.args + (cArguments,)
raise err
except error.GLError, err:
err.cArgs = cArguments
err.pyArgs = args
raise err
# handle storage of persistent argument values...
storeValues(
result,
self,
args,
cArguments,
)
return returnValues(
result,
self,
args,
cArguments,
)
return wrapperCall
else:
def wrapperCall( *args ):
"""Wrapper with all save returnValues"""
cArguments = args
try:
result = self.wrappedOperation( *cArguments )
except ctypes.ArgumentError, err:
err.args = err.args + (cArguments,)
raise err
except error.GLError, err:
err.cArgs = cArguments
err.pyArgs = args
raise err
# handle storage of persistent argument values...
storeValues(
result,
self,
args,
cArguments,
)
return result
return wrapperCall
else: # null storeValues
if returnValues:
def wrapperCall( *args ):
"""Wrapper with all save storeValues"""
cArguments = args
try:
result = self.wrappedOperation( *cArguments )
except ctypes.ArgumentError, err:
err.args = err.args + (cArguments,)
raise err
except error.GLError, err:
err.cArgs = cArguments
err.pyArgs = args
raise err
return returnValues(
result,
self,
args,
cArguments,
)
return wrapperCall
else:
def wrapperCall( *args ):
"""Wrapper with all save returnValues and storeValues"""
cArguments = args
try:
result = self.wrappedOperation( *cArguments )
except ctypes.ArgumentError, err:
err.args = err.args + (cArguments,)
raise err
except error.GLError, err:
err.cArgs = cArguments
err.pyArgs = args
raise err
return result
return wrapperCall
# def __call__( self, *args, **named ):
# """Finalise the wrapper before calling it"""
# try:
# return self._finalCall( *args, **named )
# except AttributeError, err:
# return self.finalise()( *args, **named )
def _unspecialised__call__( self, *args ):
"""Expand arguments, call the function, store values and check errors"""
pyConverters = getattr( self, 'pyConverters', None )
if pyConverters:
if len(pyConverters) != len(args):
raise ValueError(
"""%s requires %r arguments (%s), received %s: %r"""%(
self.wrappedOperation.__name__,
len(pyConverters),
", ".join( self.pyConverterNames ),
len(args),
args
)
)
pyArgs = []
for (converter,arg) in zip(pyConverters,args):
if converter is None:
pyArgs.append( arg )
else:
pyArgs.append( converter(arg, self, args) )
else:
pyArgs = args
cConverters = getattr( self, 'cConverters', None )
if cConverters:
cArgs = []
for (index,converter) in enumerate( cConverters ):
if not hasattr(converter,'__call__'):
cArgs.append( converter )
else:
try:
cArgs.append(
converter( pyArgs, index, self )
)
except Exception, err:
if hasattr( err, 'args' ):
err.args += (
"""Failure in cConverter %r"""%(converter),
pyArgs, index, self,
)
raise
else:
cArgs = pyArgs
cResolvers = getattr( self, 'cResolvers', None )
if cResolvers:
cArguments = []
for (converter, value) in zip( cResolvers, cArgs ):
if converter is None:
cArguments.append( value )
else:
cArguments.append( converter( value ) )
else:
cArguments = cArgs
try:
result = self.wrappedOperation( *cArguments )
except ctypes.ArgumentError, err:
err.args = err.args + (cArguments,)
raise err
except error.GLError, err:
err.cArgs = cArgs
err.pyArgs = pyArgs
raise err
storeValues = getattr( self, 'storeValues', None )
if storeValues is not None:
# handle storage of persistent argument values...
storeValues(
result,
self,
pyArgs,
cArgs,
)
returnValues = getattr( self, 'returnValues', None )
if returnValues is not None:
return returnValues(
result,
self,
pyArgs,
cArgs,
)
else:
return result
def wrapper( wrappedOperation ):
"""Create a Wrapper sub-class instance for the given wrappedOperation
The purpose of this function is to create a subclass of Wrapper which
has the __doc__ and __name__ of the wrappedOperation so that the instance of
the wrapper will show up as <functionname instance @ address> by default,
and will have the docstring available naturally in pydoc and the like.
"""
if isinstance( wrappedOperation, Wrapper ):
return wrappedOperation
dict = {
'__doc__': wrappedOperation.__doc__,
'__slots__': ('wrappedOperation', ),
}
cls = type( wrappedOperation.__name__, (Wrapper,), dict )
instance = cls(wrappedOperation)
return instance
|