Package glue :: Package ligolw :: Module tokenizer :: Class RowDumper
[hide private]
[frames] | no frames]

Class RowDumper

object --+

An iterator for converting row objects into string tokens.


>>> class Row(object):
...     pass
>>> rows = [Row(), Row(), Row()]
>>> rows[0].snr = 10.1
>>> rows[1].snr = 15.2
>>> rows[2].snr = 20.3
>>> rows[0].status = "bad"
>>> rows[1].status = "bad"
>>> rows[2].status = "good"
>>> rowdumper = RowDumper(("snr", "status"), ("%.16g".__mod__, "\"%s\"".__mod__))
>>> for line in rowdumper.dump(rows):
...     print line

An instance of RowDumper is initialized with two arguments and an optional third argument. The first argument is a sequence of attribute names. The second argument is a sequence of Python format strings. The third, optional, argument is the unicode string to use as the delimiter between tokens (the default is u","). The row dumper is started by calling the .dump() method which takes a Python iterable as its single argument. After the .dump() method has been called, when a RowDumper instance is iterated over it retrieves objects, one-by-one, from the iterable passed to the .dump() method and yields a sequence of unicode strings containing the delimited string representations of the values of the attributes of those objects. The attribute values are printed in the order specified when the RowDumper was created, and using the formats specified. An attribute whose value is None is printed as an empty string regardless of the requested format.

Instance Methods [hide private]
x.__init__(...) initializes x; see help(type(x)) for signature
a new object with type S, a subtype of T
__new__(T, S, ...)
Set the Python iterable from which row objects will be retrieved for dumping.
the next value, or raise StopIteration

Inherited from object: __delattr__, __format__, __getattribute__, __hash__, __reduce__, __reduce_ex__, __repr__, __setattr__, __sizeof__, __str__, __subclasshook__

Properties [hide private]
In-order tuple of attribute names as strings.
The delimiter as a unicode string.
In-order tuple of row element format functions.
The iterator being used to provide rows for conversion.
Count of rows converted.
In-order tuple of unicode tokens from most recently converted row.

Inherited from object: __class__

Method Details [hide private]



x.__init__(...) initializes x; see help(type(x)) for signature

Overrides: object.__init__

__new__(T, S, ...)

Returns: a new object with type S, a subtype of T
Overrides: object.__new__