Method append

rich/text.py:964–1006

Add text with an optional style. Args: text (Union[Text, str]): A str or Text to append. style (str, optional): A style name. Defaults to None. Returns: Text: Returns self for chaining.

(
        self, text: Union["Text", str], style: Optional[Union[str, "Style"]] = None
    )

                self.pad_left(excess_space, character)

    def append(
        self, text: Union[class="st">"Text", str], style: Optional[Union[str, class="st">"Style"]] = None
    ) -> class="st">"Text":
        class="st">"""Add text with an optional style.

        Args:
            text (Union[Text, str]): A str or Text to append.
            style (str, optional): A style name. Defaults to None.

        Returns:
            Text: Returns self for chaining.
        class="st">"""

        if not isinstance(text, (str, Text)):
            raise TypeError(class="st">"Only str or Text can be appended to Text")

        if len(text):
            if isinstance(text, str):
                sanitized_text = strip_control_codes(text)
                self._text.append(sanitized_text)
                offset = len(self)
                text_length = len(sanitized_text)
                if style:
                    self._spans.append(Span(offset, offset + text_length, style))
                self._length += text_length
            elif isinstance(text, Text):
                _Span = Span
                if style is not None:
                    raise ValueError(
                        class="st">"style must not be set when appending Text instance"
                    )
                text_length = self._length
                if text.style:
                    self._spans.append(
                        _Span(text_length, text_length + len(text), text.style)
                    )
                self._text.append(text.plain)
                self._spans.extend(
                    _Span(start + text_length, end + text_length, style)
                    for start, end, style in text._spans.copy()
                )
                self._length += len(text)
        return self

    def append_text(self, text: class="st">"Text") -> class="st">"Text":
        class="st">"""Append another Text instance. This method is more performant than Text.append, but