Tangled Up in Unicode

0.2.0 · active · verified Wed Apr 15

Tangled Up in Unicode is a Python library, currently at version 0.2.0, that provides access to the Unicode Character Database (UCD). It serves as an alternative to Python's standard `unicodedata` module, offering the latest UCD versions and extended character properties. Releases are typically aligned with new Unicode Standard versions.

Warnings

gotcha Installing `tangled-up-in-unicode` can result in a very large `site-packages` directory (up to 1.8GB or more in a `venv`) due to the size of generated `.pyc` files from large internal data dictionaries.
Fix: Be aware of disk space consumption when including this library, especially in constrained environments or when creating many virtual environments. Consider if the full UCD data is necessary or if a more lightweight approach is feasible for specific use cases. Future versions may address this by changing data storage formats.
gotcha Prior to version 0.0.7, querying for a script that was not in the lookup table would raise an `IndexError`. From version 0.0.7 onwards, this behavior changed to return the string 'Unknown' instead.
Fix: If your application relies on catching `IndexError` for unknown scripts, update your code to expect 'Unknown' for versions 0.0.7 and later. For backward compatibility, check the library version or explicitly handle both `IndexError` (for older versions) and the 'Unknown' string (for newer versions).

Install

pip install tangled-up-in-unicode Install latest version

Imports

tangled_up_in_unicode
```
import tangled_up_in_unicode as unicodedata
```
Commonly imported as 'unicodedata' for compatibility and ease of use, replacing the standard library module with an updated and extended version.

Quickstart

Demonstrates how to import and use `tangled-up-in-unicode` to retrieve character properties, including extended ones and aliases not available in the standard `unicodedata` module, and to check the UCD version.

import tangled_up_in_unicode as unicodedata

char = '$'
print(f"--- Properties for '{char}' ---")
print(f"Name: {unicodedata.name(char)}")
print(f"Category (Short): {unicodedata.category(char)}")
print(f"Bidirectional (Short): {unicodedata.bidirectional(char)}")

# This library provides more properties and aliases than standard unicodedata
print(f"Script (Long): {unicodedata.script(char, long=True)}")
print(f"Block (Long): {unicodedata.block(char, long=True)}")
print(f"UCD Version: {unicodedata.unidata_version}")

view raw JSON →