Skip to content

deconfuse()

slugany.deconfuse 

deconfuse(text: str) -> str

Replace confusable Unicode characters with their Latin equivalents.

Converts Cyrillic homoglyphs and Greek letters that visually resemble Latin characters to their ASCII equivalents.

Parameters:

Name Type Description Default
text str

The text to deconfuse.

 required

Returns:

Type Description
str

The text with confusable characters replaced.

Raises:

Type Description
TypeError

If text is not a string.

Examples:

>>> deconfuse("саfe")
'cafe'
>>> deconfuse("αβγ")
'abg'
Source code in slugany/_slugify.py 
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
def deconfuse(text: str) -> str:
    """Replace confusable Unicode characters with their Latin equivalents.

    Converts Cyrillic homoglyphs and Greek letters that visually resemble
    Latin characters to their ASCII equivalents.

    Args:
        text: The text to deconfuse.

    Returns:
        The text with confusable characters replaced.

    Raises:
        TypeError: If ``text`` is not a string.

    Examples:
        >>> deconfuse("саfe")
        'cafe'
        >>> deconfuse("αβγ")
        'abg'
    """
    if not isinstance(text, str):
        msg = f"text must be a string, got {type(text).__name__}"
        raise TypeError(msg)
    from slugany._tables import _CONFUSABLES

    return text.translate(_CONFUSABLES)