turkiye-iban-python

Python 3.10+ istemcisi: Türkiye IBAN normalleştirme, doğrulama, biçimlendirme, maskeleme ve kuruluş kodu eşleştirmesi.

Ne yapar? · Kurulum · Hızlı kullanım · Public API · Test ve kalite · Topluluk

Önemli sınır Bu paket IBAN biçimini ve MOD 97-10 kontrolünü doğrular; hesabın varlığını, hesap sahibini, lisans durumunu veya transfer yapılabilirliğini doğrulamaz. provider_status: "unknown", checksum hatası değil, kodun sabitlenmiş veri kümesinde bulunmadığı anlamına gelir. Paket TCMB tarafından onaylanmış değildir.

Ne yapar?

• Türkiye IBAN yapısını ve kontrol rakamlarını doğrular.
• Beş haneli kuruluş kodunu çıkarır ve sabitlenmiş veriyle eşleştirir.
• Bilinen ve bilinmeyen kuruluşları ayrı sonuçlarla bildirir.
• IBAN'ı dörder karakterlik gruplara ayırır veya maskeleyerek gösterir.
• Veriyi runtime sırasında ağdan indirmez; turkiye-iban v0.2.1 release verisini kullanır.

Ne yapmaz?

• Hesabın varlığını, sahibini, bakiyesini veya transfer yapılabilirliğini doğrulamaz.
• TCMB, banka veya ödeme kuruluşu adına resmî onay ya da hesap doğrulama sunmaz.
• Gerçek IBAN, müşteri kaydı veya kişisel finansal veri toplamaz.
• provider_status: "unknown" sonucunda otomatik kuruluş seçimi yapmaz.

Türkiye IBAN yapısı

Türkiye IBAN'ı TR ülke kodu, iki kontrol rakamı, beş haneli kuruluş kodu, bir rezerv rakamı ve 16 karakterlik hesap alanından oluşur. MOD 97-10, IBAN'ın yazım bütünlüğünü matematiksel olarak kontrol eder; bir hesabın bankada gerçekten var olduğunu kanıtlamaz.

Kurulum

PyPI kaydı henüz doğrulanmadığı için bugün doğrulanmış GitHub release wheel assetini kullanın:

python -m pip install https://github.com/trugurpala/turkiye-iban-python/releases/download/v0.1.5/turkiye_iban-0.1.5-py3-none-any.whl

PyPI kaydı doğrulandıktan sonra kısa kurulum yolu şu olacaktır:

python -m pip install turkiye-iban

Güncel durum ve Trusted Publisher adımları için PUBLISHING.md ve ana projenin Packagist/PyPI yayın belgesine bakın.

Hızlı kullanım

from turkiye_iban import identify_bank_from_iban, mask_iban

iban = "TR280000109999000000000001"  # yalnızca sentetik örnek
result = identify_bank_from_iban(iban)

if result["parsed"]["is_valid"] and result["provider_status"] == "known":
    print(result["provider"]["nameOfficial"])

print(mask_iban(iban))

Public API

Detaylı davranış ve sentetik fixture sözleşmesi için ana repository'deki API belgesine ve conformance belgesine ve Python test raporuna bakın.

Sonuçları nasıl yorumlamalısınız?

İlgili projeler

• Ana veri ve TypeScript/NPM paket: trugurpala/turkiye-iban
• Aynı sözleşmenin PHP istemcisi: turkiye-iban-php
• Ortak veri kaynakları: DATA_SOURCES.md
• Güvenlik bildirimi: SECURITY.md
• Katkı rehberi: CONTRIBUTING.md
• Yayınlama: PUBLISHING.md
• Destek: SUPPORT.md
• Davranış kuralları: CODE_OF_CONDUCT.md

Geliştirme ve kalite

python -m pip install -e ".[dev]"
python -m pytest
python -m pytest --cov=turkiye_iban --cov-report=term-missing
python -m mypy src
python -m build
python -m twine check dist/*

Her public API fonksiyonunun kontrol edildiği TEST_REPORT.md belgesinde Python CI, build ve paket metadata kanıtları bulunur. Gerçek IBAN, müşteri adı veya kişisel finansal veri issue, test veya PR içinde kullanmayın.

Release

Son doğrulanmış release v0.1.5'dir. Release assetleri ve test sonucu TEST_REPORT.md içinde kayıtlıdır. Release geçmişi CHANGELOG.md dosyasındadır. GitHub Release workflow'u yalnızca v*.*.* tag'lerinde arşiv üretir; PyPI yayını ise ayrı, ortam korumalı Trusted Publisher workflow'unda yapılır.

Lisans

MIT. Ayrıntılar için LICENSE ve NOTICE dosyalarına bakın.