AnyASCII

Warnings

• breaking Python 2 support was dropped in version 0.2.0. If your project requires Python 2 compatibility, you must pin the `anyascii` version to `<0.2` (e.g., `anyascii==0.1.7`).
  Fix: Upgrade to Python 3 or restrict `anyascii` version to `<0.2` in `requirements.txt`.
• gotcha Transliteration is an inherently lossy process. While `anyascii` provides a robust ASCII representation, it may not perfectly preserve all semantic or linguistic nuances of the original Unicode string. Users should be aware that the output is a best-effort ASCII approximation.
  Fix: Understand that the output is an ASCII approximation and not a round-trip conversion. For critical applications, review the transliterated output.
• gotcha `anyascii` focuses purely on Unicode to ASCII transliteration. It does not perform other text normalization tasks such as lowercasing, stripping extra whitespace, or handling character compositions beyond what's necessary for direct ASCII mapping. For broader text cleaning, combine it with other libraries.
  Fix: If additional text normalization is required, use `anyascii` in conjunction with other string manipulation techniques or libraries (e.g., `str.lower()`, `str.strip()`, `unicodedata.normalize`).

Install

• pip install anyascii Install latest version

Imports

• anyascii

  from anyascii import anyascii

Quickstart

Demonstrates the basic usage of the `anyascii` function to transliterate various Unicode strings into their ASCII equivalents.

from anyascii import anyascii

# Example 1: Basic transliteration
text1 = '你好，世界'
result1 = anyascii(text1)
print(f"'{text1}' -> '{result1}'")

# Example 2: European characters
text2 = 'Hello, world! Pýthön æøåß®©'
result2 = anyascii(text2)
print(f"'{text2}' -> '{result2}'")

# Example 3: Mixed script
text3 = 'Ελληνικά, Русский, 日本語'
result3 = anyascii(text3)
print(f"'{text3}' -> '{result3}'")