Part of twisted.python View Source
Defining the mechanism by which text containing character attributes is
constructed begins by subclassing CharacterAttributesMixin
.
Defining how a single formatting state is to be serialized begins by
subclassing _FormattingStateMixin
.
Serializing a formatting structure is done with flatten
.
See Also | twisted.conch.insults.helper._FormattingState | |
twisted.conch.insults.text._CharacterAttributes | ||
twisted.words.protocols.irc._FormattingState | ||
twisted.words.protocols.irc._CharacterAttributes |
Class | CharacterAttributesMixin | No summary |
Class | DefaultFormattingState | A character attribute that does nothing, thus applying no attributes to text. |
Function | flatten | Serialize a sequence of characters with attribute information |
Class | _Attribute | A text attribute. |
Class | _NormalAttr | A text attribute for normal text. |
Class | _OtherAttr | A text attribute for text with formatting attributes. |
Class | _ColorAttr | Generic color attribute. |
Class | _ForegroundColorAttr | Foreground color attribute. |
Class | _BackgroundColorAttr | Background color attribute. |
Class | _ColorAttribute | A color text attribute. |
Class | _FormattingStateMixin | Mixin for the formatting state/attributes of a single character. |
Serialize a sequence of characters with attribute information
The resulting string can be interpreted by compatible software so that
the contained characters are displayed and, for those attributes which are
supported by the software, the attributes expressed. The exact result of
the serialization depends on the behavior of the method specified by
attributeRenderer
.
For example, if your terminal is VT102 compatible, you might run this for a colorful variation on the "hello world" theme:
from twisted.conch.insults.text import flatten, attributes as A from twisted.conch.insults.helper import CharacterAttribute print flatten( A.normal[A.bold[A.fg.red['He'], A.fg.green['ll'], A.fg.magenta['o'], ' ', A.fg.yellow['Wo'], A.fg.blue['rl'], A.fg.cyan['d!']]], CharacterAttribute())
Parameters | output | Object returned by accessing attributes of the module-level attributes object. |
attrs | A formatting state instance used to determine how to serialize
output . | |
attributeRenderer | Name of the method on attrs that should be called to render
the attributes during serialization. Defaults to 'toVT102' . (type: str ) | |
Returns | A string expressing the text and display attributes specified by
output . |