    def parse(self):
        """
        Generator to return coloured text from raw text.

        Generally returns a stream of text/color tuple/offset tuples.  If there is a colour update with no
        visible text, the first element of the tuple may be None.

        :returns: a 3-tuple of (start offset in raw text, command to execute, parameters)
        """
Generator to return coloured text from raw text.

Generally returns a stream of text/color tuple/offset tuples.  If there is a colour update with no
visible text, the first element of the tuple may be None.

:returns: a 3-tuple of (start offset in raw text, command to execute, parameters)
asciimatics/parsers.py