Skip to main content

Kaalin

PyPI version Python License: MIT

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, also with a suffix (eksportqa → экспортқа). The apostrophe spelling (so'z) and the letters of old fonts (ѳ, ӊ) are read too.

from kaalin.converter import latin2cyrillic, cyrillic2latin

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

latin2cyrillic("Ag'ash ko'l")        # Ағаш көл
cyrillic2latin("Нѳкис")              # Nókis

# 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.4.0

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.4.0
File Size Uploaded Provenance Actions
kaalin-3.4.0.tar.gz 29.9 kB Without provenance Details for kaalin-3.4.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for kaalin 3.4.0
File Interpreter ABI Platform Actions
kaalin-3.4.0-py3-none-any.whl Python 3 none any Details for kaalin-3.4.0-py3-none-any.whl

Total release size: 53.5 kB

Release files / kaalin-3.4.0.tar.gz

Download URL kaalin-3.4.0.tar.gz
Size 29.9 kB
Tags Source
SHA-256 checksum
How to use checksums
9510aef7a7062c86f84f51ad92464b58bdda4f6cd7280f572cb8305a6e5d6152
BLAKE2b-256 checksum
How to use checksums
a4df093c92962d7d3124a374a1060db44dd7fbb47a7b29ba6259db2be0003603
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.15.2

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

Download URL kaalin-3.4.0-py3-none-any.whl
Size 23.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
01102b5a474f0eb41dcc6eb7bcc79ef39d2e31849be2cc8c65ea716834ef210a
BLAKE2b-256 checksum
How to use checksums
54b0a157b70b45c3927d9667308b691839771f13c74b8cde9154588a253b2453
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.15.2

Security for kaalin 3.4.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page