trkit

Türkçe metin araçları ve Türkiye'ye özgü doğrulayıcılar. Bağımlılığı hafif, tip bilgisi tam, hem kütüphane hem komut satırı aracı olarak kullanılabilir.

Turkish text utilities and Türkiye-specific validators: locale-correct case conversion, slugify, national ID (TCKN) and IBAN validation, licence-plate lookup. Usable as a library or a CLI.

Neden?

Python'un yerleşik metotları Türkçe'nin noktalı/noktasız i ayrımını bilmez:

"istanbul".upper()   # 'ISTANBUL'  ← yanlış
"IĞDIR".lower()      # 'iğdır'     ← yanlış

trkit bu dönüşümleri doğru yapar ve yanına Türkiye'de sık gereken birkaç doğrulayıcı ekler.

Kurulum

pip install trkit

Kütüphane olarak kullanım

from trkit import upper, lower, title, slugify, asciify
from trkit import is_valid_tckn, is_valid_iban
from trkit import city_from_plate, plate_from_city

upper("istanbul")                 # 'İSTANBUL'
lower("IĞDIR")                    # 'ığdır'
title("izmir kuş cenneti")        # 'İzmir Kuş Cenneti'
asciify("Çiğdem Şahin")           # 'Cigdem Sahin'
slugify("Çığır Açan Şeyler")      # 'cigir-acan-seyler'
slugify("Merhaba Dünya", "_")     # 'merhaba_dunya'

is_valid_tckn("10000000146")                       # True
is_valid_iban("TR33 0006 1005 1978 6457 8413 26")  # True

city_from_plate(35)               # 'İzmir'
plate_from_city("İSTANBUL")       # 34

Komut satırından kullanım

$ trkit slug "Çığır Açan Şeyler"
cigir-acan-seyler

$ trkit upper istanbul
İSTANBUL

$ trkit plaka 35
İzmir

$ trkit plaka İzmir
35

$ trkit tckn 10000000146
geçerli

Doğrulama komutları anlamlı çıkış kodu döndürür (geçerli → 0, geçersiz → 1), böylece kabuk betiklerinde doğrudan kullanılabilir:

if trkit iban "$IBAN" > /dev/null; then
    echo "IBAN kabul edildi"
fi

Tüm komutlar için: trkit --help

API

is_valid_tckn yalnızca matematiksel bir kontroldür; numaranın gerçekten birine ait olduğunu göstermez.

Geliştirme

git clone https://github.com/ardazeybek-dev/trkit.git
cd trkit
python -m venv .venv
.venv\Scripts\activate        # Linux/macOS: source .venv/bin/activate
pip install -e ".[dev]"

pytest                          # testler
ruff check .                    # lint

Lisans

MIT © Arda Zeybek