pyomo.common.formatting
This module provides general utilities for producing formatted I/O
tostr (value[, quote_str]) |
Convert a value to a string |
tabular_writer (ostream, prefix, data, ...) |
Output data in tabular form |
StreamIndenter (ostream[, indent]) |
Mock-up of a file-like object that wraps another file-like object and indents all data using the specified string before passing it to the underlying file. |
-
pyomo.common.formatting.
tostr
(value, quote_str=False)[source] Convert a value to a string
This function is a thin wrapper around str(value) to resolve a problematic __str__ implementation in the standard Python container types (tuple, list, and dict). Those classes implement __str__ the same as __repr__ (by calling repr() on each contained object). That is frequently undesirable, as you may wish the string representation of a container to contain the string representations of the contained objects.
This function generates string representations for native Python containers (tuple, list, and dict) that contains the string representations of the contained objects. In addition, it also applies the same special handling to any types that derive from the standard containers without overriding either __repn__ or __str__.
Parameters: Return type:
-
pyomo.common.formatting.
tabular_writer
(ostream, prefix, data, header, row_generator)[source] Output data in tabular form
Parameters: - ostream (io.TextIOBase) – the stream to write to
- prefix (str) – prefix each generated line with this string
- data (iterable) – an iterable object that returns (key, value) pairs (e.g., from iteritems()) defining each row in the table
- header (List[str]) – list of column headers
- row_generator (function) – a function that accepts the key and value from data and returns either a tuple defining the entries for a single row, or a generator that returns a sequence of table rows to be output for the specified key
-
class
pyomo.common.formatting.
StreamIndenter
(ostream, indent=' ')[source] Mock-up of a file-like object that wraps another file-like object and indents all data using the specified string before passing it to the underlying file. Since this presents a full file interface, StreamIndenter objects may be arbitrarily nested.