Kaalin

A Python toolkit for the Karakalpak language. Zero dependencies, Python 3.10+.

Installation

pip install kaalin

Script Conversion

Bidirectional Latin ↔ Cyrillic conversion. Loanwords with special characters (ь, ъ, э, ё, щ) are handled automatically.

from kaalin.converter import latin2cyrillic, cyrillic2latin

latin2cyrillic("Assalawma áleykum")  # Ассалаўма әлейкум
cyrillic2latin("Ассалаўма әлейкум")  # Assalawma áleykum

# You can extend the built-in loanword dictionary with your own entries
latin2cyrillic("stilistika", custom_loanwords={"stilistika": "стилистика"})

Number to Words

Converts numbers to Karakalpak words. Supports integers, floats, and negatives up to 10³⁰.

from kaalin.number import to_word

to_word(123)                   # bir júz jigirma úsh
to_word(999, num_type="cyr")   # тоғыз жүз тоқсан тоғыз

Syllabification

Splits words into syllables. Works with both Latin and Cyrillic input.

from kaalin.syllable import syllabify

syllabify("qaraqalpaqstan")   # ['qa', 'ra', 'qal', 'paq', 'stan']
syllabify("Шарапат")          # ['Ша', 'ра', 'пат']

String Utilities

Karakalpak-aware upper() / lower() that correctly handle the dotless ı ↔ Í pair.

from kaalin.string import upper, lower

upper("Assalawma áleykum")   # ASSALAWMA ÁLEYKUM
lower("ASSALAWMA ÁLEYKUM")   # assalawma áleykum

CLI

Convert text files between scripts from the terminal:

cyr2lat input.txt              # writes input-lat.txt
lat2cyr input.txt              # writes input-cyr.txt

License

MIT

Metadata

Release files for kaalin 3.3.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for kaalin 3.3.4
File	Size	Uploaded
kaalin-3.3.4.tar.gz	22.5 kB	Sep 27, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for kaalin 3.3.4
File	Interpreter	ABI	Platform	Reset
kaalin-3.3.4-py3-none-any.whl 18.1 kB Sep 27, 2026	Python 3	none	any	Details

Total release size: 40.6 kB

Release files / kaalin-3.3.4.tar.gz

Download URL	kaalin-3.3.4.tar.gz
Size	22.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`0430e7965d9c3ed8411465e1454ff26c37d31f36a1d8dc34d88497e5f3c7b835`
BLAKE2b-256 checksum How to use checksums	`0699ea66c83953a4fc1e2ae02b829c8c4e2338d37b9c60a9d2fea82220f12ed3`
Upload date	Sep 27, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.14.7`

Release files / kaalin-3.3.4-py3-none-any.whl

Download URL	kaalin-3.3.4-py3-none-any.whl
Size	18.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`766f997a7efecabb65cfacecff7c0d5b99ba67debcec84662424446f9334c4b6`
BLAKE2b-256 checksum How to use checksums	`ba41a4d234275f0d23adb7aac7d24554030592a4c919f3d2e95a9515873eecff`
Upload date	Sep 27, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.14.7`