turkicase 0.1.0

Pure-Python Unicode-aware casing for Turkic Latin text

turkicase

A tiny, dependency-free Python package for Unicode-aware Turkic casing.

It preserves the two distinct Latin I case pairs used by Turkish, Azerbaijani, and Common Turkic Alphabet text:

• I ↔ ı
• İ ↔ i

Python's default str.lower() and str.casefold() are locale-independent, so "I".lower() becomes "i". This package applies the Turkic special-casing rules from Unicode while retaining Python's normal casing behavior for all other characters.

Installation

From a local checkout:

python -m pip install .

After publication on PyPI:

python -m pip install turkicase

Usage

from turkicase import lower, upper, casefold

lower("IĞDIR")       # "ığdır"
lower("İSTANBUL")    # "istanbul"
upper("izmir")       # "İZMİR"
upper("ışık")        # "IŞIK"

casefold("I") == casefold("ı")  # True
casefold("İ") == casefold("i")  # True

The longer aliases are also available:

from turkicase import common_turkic_lower, common_turkic_upper, common_turkic_casefold

Combining marks

The implementation includes Unicode's contextual Before_Dot and After_I rules, so canonically equivalent decomposed input is handled correctly:

lower("I\u0307")  # "i"

The result is normalized to NFC by default. Casing contexts are always evaluated on the original input code points. Pass normalization=None to skip result normalization.

Development

python -m pip install -e ".[dev]"
pytest
python -m build
python -m twine check dist/*

License

MIT