module documentation

This module provides some common functionality for the manipulation of formatting states.

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 Alsotwisted.conch.insults.helper._FormattingState
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.
def flatten(output, attrs, attributeRenderer='toVT102'): (source)

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
        A.normal[A.bold[['He'],['ll'], A.fg.magenta['o'], ' ',
                        A.fg.yellow['Wo'],['rl'], A.fg.cyan['d!']]],
ParametersoutputObject returned by accessing attributes of the module-level attributes object.
attrsA formatting state instance used to determine how to serialize output.
attributeRendererName of the method on attrs that should be called to render the attributes during serialization. Defaults to 'toVT102'. (type: str)
ReturnsA string expressing the text and display attributes specified by output.
API Documentation for Twisted, generated by pydoctor 20.12.1 at 2021-02-28 19:53:36.