Module refinery.units.pattern.mimewords

Expand source code Browse git 
from __future__ import annotations

import re
import codecs

from email.header import decode_header

from refinery.units import Unit
from refinery.lib.decorators import unicoded


class mimewords(Unit):
    """
    Implements the decoding of MIME encoded-word syntax from RFC-2047.
    """
    @classmethod
    def convert(cls, word: str) -> str:
        """
        Converts the MIME word.
        """
        def replacer(match):
            decoded, = decode_header(match[0])
            raw, codec = decoded
            if not isinstance(codec, str):
                codec = cls.codec
            return codecs.decode(raw, codec, errors='surrogateescape')
        return re.sub(R"=(?:\?[^\?]*){3}\?=", replacer, word)

    @unicoded
    def process(self, data):
        return self.convert(data)

Classes

class mimewords

Implements the decoding of MIME encoded-word syntax from RFC-2047.

Expand source code Browse git 
class mimewords(Unit):
    """
    Implements the decoding of MIME encoded-word syntax from RFC-2047.
    """
    @classmethod
    def convert(cls, word: str) -> str:
        """
        Converts the MIME word.
        """
        def replacer(match):
            decoded, = decode_header(match[0])
            raw, codec = decoded
            if not isinstance(codec, str):
                codec = cls.codec
            return codecs.decode(raw, codec, errors='surrogateescape')
        return re.sub(R"=(?:\?[^\?]*){3}\?=", replacer, word)

    @unicoded
    def process(self, data):
        return self.convert(data)

Ancestors

Subclasses

Class variables

var required_dependencies
var optional_dependencies
var console
var reverse

Static methods

def convert(word)

Converts the MIME word.

Inherited members