Method parse

rich/style.py:498–561

Parse a style definition. Args: style_definition (str): A string containing a style. Raises: errors.StyleSyntaxError: If the style definition syntax is invalid. Returns: `Style`: A Style instance.

(cls, style_definition: str)

    @classmethod
    @lru_cache(maxsize=4096)
    def parse(cls, style_definition: str) -> class="st">"Style":
        class="st">"""Parse a style definition.

        Args:
            style_definition (str): A string containing a style.

        Raises:
            errors.StyleSyntaxError: If the style definition syntax is invalid.

        Returns:
            `Style`: A Style instance.
        class="st">"""
        if style_definition.strip() == class="st">"none" or not style_definition:
            return cls.null()

        STYLE_ATTRIBUTES = cls.STYLE_ATTRIBUTES
        color: Optional[str] = None
        bgcolor: Optional[str] = None
        attributes: Dict[str, Optional[Any]] = {}
        link: Optional[str] = None

        words = iter(style_definition.split())
        for original_word in words:
            word = original_word.lower()
            if word == class="st">"on":
                word = next(words, class="st">"")
                if not word:
                    raise errors.StyleSyntaxError(class="st">"color expected after &class="cm">#x27;on'")
                try:
                    Color.parse(word)
                except ColorParseError as error:
                    raise errors.StyleSyntaxError(
                        fclass="st">"unable to parse {word!r} as background color; {error}"
                    ) from None
                bgcolor = word

            elif word == class="st">"not":
                word = next(words, class="st">"")
                attribute = STYLE_ATTRIBUTES.get(word)
                if attribute is None:
                    raise errors.StyleSyntaxError(
                        fclass="st">"expected style attribute after &class="cm">#x27;not', found {word!r}"
                    )
                attributes[attribute] = False

            elif word == class="st">"link":
                word = next(words, class="st">"")
                if not word:
                    raise errors.StyleSyntaxError(class="st">"URL expected after &class="cm">#x27;link'")
                link = word

            elif word in STYLE_ATTRIBUTES:
                attributes[STYLE_ATTRIBUTES[word]] = True

            else:
                try:
                    Color.parse(word)
                except ColorParseError as error: