pytable.dbcursor
index
p:\table\pytable\dbcursor.py

Cursor object which retains link to connection object

 
Modules
       
basicproperty.basic
basicproperty.propertied

 
Classes
       
Propertied(object)
DBCursor

 
class DBCursor(Propertied)
    DBConnection-aware cursor-object wrapper
 
The DBCursor object provides a few extended DB-API
features, particularly retaining a link to the connection
which created the cursor, and providing for iteration
across a cursor's result set.
 
Cursor Attributes .connection
 
        This read-only attribute return a reference to the Connection
        object on which the cursor was created.
 
        The attribute simplifies writing polymorphic code in
        multi-connection environments.
 
Cursor Method .__iter__()
 
 
Method resolution order:
DBCursor
Propertied
object

Methods defined here:
__getattr__(self, key)
Defer to the connection for attribute lookup
__iter__(self)
Create an iterator for the cursor
 
This method creates a generator which yields
fetchone() until fetchone returns None
(or fails).  If fetchone fails the exception
is ignored and the iterator terminates.
parameterFormat(self, name, position=0)
Format paramname for the driver
 
returns (positional (boolean), formattedName)
 
XXX Note: this isn't AFAIK actually used anywhere, so
        it could quite easily be dropped.

Data and other attributes defined here:
connection = <BasicProperty 'connection'>
Pointer to the DBConnection instance which created the cursor
 
This implements the .connection DB-API extension
cursor = <BasicProperty 'cursor'>
Pointer to the underlying DB-API cursor object

Methods inherited from Propertied:
__init__(self, *arguments, **namedarguments)
Propertied object initialisation, allows passing in initial values for properties by name
__str__(self)
Get a friendly representation of the object
clone(self, **newValues)
Clone this object, with optional new property values
 
This method calls the __init__ method of your class with
the current property values of your class.  Providing newValues
(a dictionary) overrides property settings with new values.
getCloneProperties(self)
Get properties dictionary (key:value) for use in cloning of the instance
 
By default you get getProperties()' values, with an
attempt made to use the property's name, then the property's
direct "__get__" method.
toString(self, indentation='', alreadyDone=None, indentString=' ')
Get a nicely formatted representation of this object
 
This version assumes that getProperties returns
the list of properties which should be presented,
it recursively calls it's children with greater
indents to get their representations.
 
indentation -- current string indentation level
alreadyDone -- set of object ids which are already finished
 
XXX Needs a far better API, likely a stand-alone class
        without the automatic inheritance problems here :(

Class methods inherited from Propertied:
getProperties(cls) from type
Get the BasicProperty properties for a particular object's class

Data and other attributes inherited from Propertied:
__dict__ = <dictproxy object at 0x01DF38F0>
dictionary for instance variables (if defined)
__weakref__ = <attribute '__weakref__' of 'Propertied' objects>
list of weak references to the object (if defined)

 
Data
        _formatMap = {'format': (1, '%%s'), 'named': (0, ':%(name)s'), 'numeric': (1, ':%(position)s'), 'pyformat': (0, '%%(%(name)s)s'), 'qmark': (1, '?')}
generators = _Feature((2, 2, 0, 'alpha', 1), (2, 3, 0, 'final', 0), 4096)