Class MetaStringEncoder

python/pyfory/meta/metastring.py:259–566

class MetaStringEncoder:
    def __init__(self, special_char1: str, special_char2: str):
        """
        Creates a MetaStringEncoder with specified special characters used for encoding.

        Args:
            special_char1 (str): The first special character used in custom encoding.
            special_char2 (str): The second special character used in custom encoding.
        """
        self.special_char1 = special_char1
        self.special_char2 = special_char2

    def encode(self, input_string: str, encodings: List[Encoding] = None) -> MetaString:
        """
        Encodes the input string into a MetaString object.

        Args:
            input_string (str): The string to encode.

        Returns:
            MetaString: The encoded MetaString object.
        """
        # Long meta string than _METASTRING_NUM_CHARS_LIMIT is not allowed.
        assert len(input_string) < _METASTRING_NUM_CHARS_LIMIT, "Long meta string than _METASTRING_NUM_CHARS_LIMIT is not allowed."

        if not input_string:
            return MetaString(
                input_string,
                Encoding.UTF_8,
                bytes(),
                0,
                self.special_char1,
                self.special_char2,
            )

        encoding = self.compute_encoding(input_string, encodings)
        return self.encode_with_encoding(input_string, encoding)

    def encode_with_encoding(self, input_string: str, encoding: Encoding) -> MetaString:
        """
        Encodes the input string with the specified encoding.

        Args:
            input_string (str): The string to encode.
            encoding (Encoding): The encoding type.

        Returns:
            MetaString: An encoded MetaString object.
        """
        # Long meta string longer than _METASTRING_NUM_CHARS_LIMIT is not allowed.
        assert len(input_string) < _METASTRING_NUM_CHARS_LIMIT, "Long meta string longer than _METASTRING_NUM_CHARS_LIMIT is not allowed."

        if not input_string:
            return MetaString(
                input_string,
                Encoding.UTF_8,
                bytes(),
                0,