dballe cursors

class dballe.CursorStation

This cursor is the iterable result of a query_stations operation performed outside a database, like dballe.Message.query_stations().

Each iteration returns the cursor itself, that can be used to access the current values.

Data is read from the using dict-like access or the various enq* functions. For the keys available, see Parameters used when reading station query results.

For example:

with msg.query_stations(...) as cur:
    for row in cur:
        print("Station:", cur["station"])

enqd(key: str) → Union[float, None]

Return the float value for a keyword

enqf(key: str) → Union[str, None]

Return the formatted string value for a keyword

enqi(key: str) → Union[int, None]

Return the integer value for a keyword

enqs(key: str) → Union[str, None]

Return the string value for a keyword

query

return a dict with a query to select exactly the current value at this cursor

remaining

number of results still to be returned

class dballe.CursorStationDB

This cursor is the iterable result of a query_stations operation performed in a database, like dballe.Transaction.query_stations().

Each iteration returns the cursor itself, that can be used to access the current values.

Data is read from the using dict-like access or the various enq* functions. For the keys available, see Parameters used when reading station query results.

For example:

with tr.query_stations(...) as cur:
    for row in cur:
        print("Station:", cur["station"])

enqd(key: str) → Union[float, None]

Return the float value for a keyword

enqf(key: str) → Union[str, None]

Return the formatted string value for a keyword

enqi(key: str) → Union[int, None]

Return the integer value for a keyword

enqs(key: str) → Union[str, None]

Return the string value for a keyword

query

return a dict with a query to select exactly the current value at this cursor

remaining

number of results still to be returned

remove()

Remove the data currently addressed by the cursor

class dballe.CursorStationData

This cursor is the iterable result of a query_station_data operation performed outside a database, like dballe.Message.query_station_data().

Each iteration returns the cursor itself, that can be used to access the current values.

Data is read from the using dict-like access or the various enq* functions. For the keys available, see Parameters used when reading query results for station values.

For example:

with msg.query_station_data(...) as cur:
    for row in cur:
        print("Station:", cur["station"])

data

return a dballe.Data which can be used to insert into a database the current cursor value

data_dict

return a dict which can be used to insert into a database the current cursor value

enqd(key: str) → Union[float, None]

Return the float value for a keyword

enqf(key: str) → Union[str, None]

Return the formatted string value for a keyword

enqi(key: str) → Union[int, None]

Return the integer value for a keyword

enqs(key: str) → Union[str, None]

Return the string value for a keyword

query

return a dict with a query to select exactly the current value at this cursor

remaining

number of results still to be returned

class dballe.CursorStationDataDB

This cursor is the iterable result of a query_station_data operation performed in a database, like dballe.Transaction.query_station_data().

Each iteration returns the cursor itself, that can be used to access the current values.

Data is read from the using dict-like access or the various enq* functions. For the keys available, see Parameters used when reading query results for station values.

For example:

with tr.query_station_data(...) as cur:
    for row in cur:
        print("Station:", cur["station"])

data

return a dballe.Data which can be used to insert into a database the current cursor value

data_dict

return a dict which can be used to insert into a database the current cursor value

enqd(key: str) → Union[float, None]

Return the float value for a keyword

enqf(key: str) → Union[str, None]

Return the formatted string value for a keyword

enqi(key: str) → Union[int, None]

Return the integer value for a keyword

enqs(key: str) → Union[str, None]

Return the string value for a keyword

insert_attrs(attrs: Dict[str, Any])

Insert or update attributes for the current variable

query

return a dict with a query to select exactly the current value at this cursor

remaining

number of results still to be returned

remove()

Remove the data currently addressed by the cursor

remove_attrs(attrs: Iterable[str])

Remove attributes from the current variable

class dballe.CursorData

This cursor is the iterable result of a query_data operation performed outside a database, like dballe.Message.query_data().

Each iteration returns the cursor itself, that can be used to access the current values.

Data is read from the using dict-like access or the various enq* functions. For the keys available, see Parameters used when reading query results for data values.

For example:

with msg.query_data(...) as cur:
    for row in cur:
        print("Station:", cur["station"])

data

return a dballe.Data which can be used to insert into a database the current cursor value

data_dict

return a dict which can be used to insert into a database the current cursor value

enqd(key: str) → Union[float, None]

Return the float value for a keyword

enqf(key: str) → Union[str, None]

Return the formatted string value for a keyword

enqi(key: str) → Union[int, None]

Return the integer value for a keyword

enqs(key: str) → Union[str, None]

Return the string value for a keyword

query

return a dict with a query to select exactly the current value at this cursor

remaining

number of results still to be returned

class dballe.CursorDataDB

This cursor is the iterable result of a query_data operation performed in a database, like dballe.Transaction.query_data().

Each iteration returns the cursor itself, that can be used to access the current values.

Data is read from the using dict-like access or the various enq* functions. For the keys available, see Parameters used when reading query results for data values.

For example:

with tr.query_data(...) as cur:
    for row in cur:
        print("Station:", cur["station"])

data

return a dballe.Data which can be used to insert into a database the current cursor value

data_dict

return a dict which can be used to insert into a database the current cursor value

enqd(key: str) → Union[float, None]

Return the float value for a keyword

enqf(key: str) → Union[str, None]

Return the formatted string value for a keyword

enqi(key: str) → Union[int, None]

Return the integer value for a keyword

enqs(key: str) → Union[str, None]

Return the string value for a keyword

insert_attrs(attrs: Dict[str, Any])

Insert or update attributes for the current variable

query

return a dict with a query to select exactly the current value at this cursor

remaining

number of results still to be returned

remove()

Remove the data currently addressed by the cursor

remove_attrs(attrs: Iterable[str])

Remove attributes from the current variable

class dballe.CursorSummaryDB

This cursor is the iterable result of a query_summary operation performed in a database, like dballe.Transaction.query_summary().

Each iteration returns the cursor itself, that can be used to access the current values.

Data is read from the using dict-like access or the various enq* functions. For the keys available, see Parameters used when reading query results for summary values.

For example:

with tr.query_summary(...) as cur:
    for row in cur:
        print("Station:", cur["station"])

enqd(key: str) → Union[float, None]

Return the float value for a keyword

enqf(key: str) → Union[str, None]

Return the formatted string value for a keyword

enqi(key: str) → Union[int, None]

Return the integer value for a keyword

enqs(key: str) → Union[str, None]

Return the string value for a keyword

query

return a dict with a query to select exactly the current value at this cursor

remaining

number of results still to be returned

remove()

Remove the data currently addressed by the cursor

class dballe.CursorSummarySummary

This cursor is the iterable result of a dballe.Explorer query_*. like dballe.Explorer.query_summary() or dballe.Explorer.query_summary_all().

Each iteration returns the cursor itself, that can be used to access the current values.

Data is read from the using dict-like access or the various enq* functions. For the keys available, see Parameters used when reading query results for summary values.

For example:

with explorer.query_summary_all(...) as cur:
    for row in cur:
        print("Station:", cur["station"])

enqd(key: str) → Union[float, None]

Return the float value for a keyword

enqf(key: str) → Union[str, None]

Return the formatted string value for a keyword

enqi(key: str) → Union[int, None]

Return the integer value for a keyword

enqs(key: str) → Union[str, None]

Return the string value for a keyword

query

return a dict with a query to select exactly the current value at this cursor

remaining

number of results still to be returned

class dballe.CursorSummaryDBSummary

This cursor is the iterable result of a dballe.DBExplorer query_*. like dballe.DBExplorer.query_summary() or dballe.DBExplorer.query_summary_all().

Each iteration returns the cursor itself, that can be used to access the current values.

Data is read from the using dict-like access or the various enq* functions. For the keys available, see Parameters used when reading query results for summary values.

For example:

with explorer.query_summary_all(...) as cur:
    for row in cur:
        print("Station:", cur["station"])

enqd(key: str) → Union[float, None]

Return the float value for a keyword

enqf(key: str) → Union[str, None]

Return the formatted string value for a keyword

enqi(key: str) → Union[int, None]

Return the integer value for a keyword

enqs(key: str) → Union[str, None]

Return the string value for a keyword

query

return a dict with a query to select exactly the current value at this cursor

remaining

number of results still to be returned

class dballe.CursorMessage

This cursor is the iterable result of a query_messages operation, like dballe.Transaction.query_messages().

Each iteration returns the cursor itself, that can be used to access the current values.

Data is read from the cursor using the message property. The dict-like access and the various enq* functions are present for uniformity with other cursors, but there are currently no valid keys that can be used.

For example:

exporter = dballe.Exporter("BUFR")
with open("file.bufr", "wb") as outfile:
    for cur in tr.query_messages(...):
        outfile.write(exporter.to_binary(cur.message))

enqd(key: str) → Union[float, None]

Return the float value for a keyword

enqf(key: str) → Union[str, None]

Return the formatted string value for a keyword

enqi(key: str) → Union[int, None]

Return the integer value for a keyword

enqs(key: str) → Union[str, None]

Return the string value for a keyword

message

dballe.Message object with the current message

query

return a dict with a query to select exactly the current value at this cursor

remaining

number of results still to be returned