turkce-adres 0.2.0__tar.gz

turkce_adres-0.2.0/.gitignore

@@ -0,0 +1,10 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+build/
+dist/
+.venv/
+.pytest_cache/
+ham/
+deneme/
+.env

turkce_adres-0.2.0/CHANGELOG.md

@@ -0,0 +1,23 @@
+# Changelog
+
+## 0.2.0 (2026-11-09), first release as turkce-adres
+
+- Renamed: package `turkce-adres`, module `turkce_adres`, command `turkce-adres` (the name `tr-adres` on PyPI belongs to an independent project).
+- Neighbourhood/village gazetteer from OpenStreetMap: 66,687 entries in 81 provinces and 973 districts, with centre points. Validates the neighbourhood, infers a missing district or province, restores correct spelling.
+- Offline approximate geocoding (`konum` / `geocode`): street (14,777 OSM streets), neighbourhood/village, district or province level.
+- Address matching (`benzerlik`, `ayni_mi`) and duplicate grouping in the CLI (`--tekil`).
+- Privacy generalisation (`genellestir`) to province, district, neighbourhood or street level.
+- Delivery check (`eksikler`): missing or inconsistent elements.
+- Parser: labelled fields ("Mahalle: X, Cadde: Y"), typo tolerance for province/district names, ASCII spelling restored with a word list from OSM, site/block, village ("Köyü"), dead end, square, "Kat: Zemin", landmark phrases ("X karşısı"), "12/3" read as house 12 unit 3, postcode to district (OSM-derived), aliases (K.Maraş, Antep, İst.).
+- `guven` (confidence) and `notlar` (notes) in every result; official output style (`bicimle(a, "resmi")`).
+- New hand-labelled hard set `bench/zor.tsv` (58 addresses). Held-out OSM set: 99.5% of addresses with every field correct.
+
+## 0.1.0 (2026-11-09)
+
+- First release: rule-based parser (`ayristir` / `parse`), formatter (`bicimle` / `format_address`), command line tool with CSV support.
+- Turkish and English field names and CLI messages (`dil="en"`, `--lang en`).
+- 5-digit street names (`14027 Sk.`) are no longer mistaken for postcodes; postcode must start with a valid province code (01-81). Province is inferred from the postcode.
+- Ordinal and slashed street numbers kept as written (`716. Sk.`, `678/2. Sk.`, `451/A Sk.`).
+- "Province District Neighbourhood" prefixes split off (`Samsun 19 Mayıs Fındıklı Mah.`), while real names starting with a place name are kept (`Fatih Sultan Mehmet Mah.`, `Gürpınar Yolu Cad.`).
+- Building names no longer swallow the street before them; house number without "No" after the street (`Ziya Gökalp Cd 12`).
+- Held-out evaluation set (6,000 OpenStreetMap addresses): 99.5% of addresses with every field correct. The earlier browser prototype scored 74.5% on the development set.

turkce_adres-0.2.0/LICENSE

@@ -0,0 +1,24 @@
+MIT License
+
+Copyright (c) 2026 Mehmet Veysel Delibaş
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+The data files in src/turkce_adres/veri/ and bench/*.jsonl are not
+covered by this license; see LICENSE-DATA.md (ODbL 1.0).

turkce_adres-0.2.0/LICENSE-DATA.md

@@ -0,0 +1,24 @@
+# Data license / Veri lisansı
+
+The following files are derived from OpenStreetMap data and are made available
+under the Open Database License (ODbL) 1.0:
+
+- `src/turkce_adres/veri/gazetteer.json` (province and district names)
+- `src/turkce_adres/veri/mahalle.json.gz` (neighbourhoods, villages and their centre points)
+- `src/turkce_adres/veri/sokak.json.gz` (street centre points, postcode to district table)
+- `src/turkce_adres/veri/kelime.json.gz` (spelling list built from OSM place and street names)
+- `bench/gelistirme.jsonl`, `bench/sinama.jsonl` (test sets)
+
+© OpenStreetMap contributors. https://www.openstreetmap.org/copyright
+
+Full license text: https://opendatacommons.org/licenses/odbl/1-0/
+
+If you publicly use a modified version of these files, you must share that
+version under the ODbL as well. The Python code is MIT licensed (see LICENSE).
+
+---
+
+Yukarıdaki dosyalar OpenStreetMap verisinden türetilmiştir ve Open Database
+License (ODbL) 1.0 ile sunulur. © OpenStreetMap katkıcıları. Değiştirilmiş
+sürümünü herkese açık kullanırsanız o sürümü de ODbL ile paylaşmanız gerekir.
+Python kodu MIT lisanslıdır.

turkce_adres-0.2.0/PKG-INFO

@@ -0,0 +1,150 @@
+Metadata-Version: 2.5
+Name: turkce-adres
+Version: 0.2.0
+Summary: Turkish address toolkit: parse messy Turkish addresses, fix spelling, validate against 66,000+ neighbourhoods and villages, offline geocoding to street/neighbourhood level, duplicate matching, KVKK-friendly generalisation. Offline, no dependencies.
+Project-URL: Homepage, https://github.com/mveyseldelibas/turkce-adres
+Project-URL: Issues, https://github.com/mveyseldelibas/turkce-adres/issues
+Project-URL: Changelog, https://github.com/mveyseldelibas/turkce-adres/blob/main/CHANGELOG.md
+Author: Mehmet Veysel Delibaş
+License: MIT AND ODbL-1.0
+License-File: LICENSE
+License-File: LICENSE-DATA.md
+Keywords: address,address-parser,adres,deduplication,geocoding,gis,kvkk,mahalle,offline-geocoding,openstreetmap,turkey,turkish
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
+Classifier: Natural Language :: Turkish
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: GIS
+Classifier: Topic :: Text Processing :: Linguistic
+Requires-Python: >=3.10
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# turkce-adres
+
+[English](README.en.md)
+
+Türkçe adresler için internetsiz, ek paket gerektirmeyen bir Python kütüphanesi ve komut satırı aracı:
+
+- **Ayrıştırır:** dağınık yazılmış adresi il, ilçe, mahalle/köy, cadde/sokak/bulvar/çıkmaz/meydan, kapı no, blok, kat, daire, bina, posta kodu ve "Migros karşısı" gibi tarif ifadelerine ayırır.
+- **Düzeltir:** BÜYÜK ASCII yazımı Türkçe harflerine kavuşturur (`CAFERAGA` → `Caferağa`, `BUYUKDERE` → `Büyükdere`), il ve ilçe adlarındaki yazım hatalarını düzeltir (`Istnbul` → `İstanbul`), standart (kargo) ya da resmî yazıma çevirir.
+- **Doğrular:** 66.687 mahalle, köy ve semtlik sözlükle mahallenin o ilçede olup olmadığına bakar; il ya da ilçe yazılmamışsa mahalleden ya da posta kodundan bulur.
+- **Konum verir (internetsiz):** adresin yaklaşık koordinatını sokak, mahalle, ilçe ya da il düzeyinde döndürür. Hiçbir servise istek atmaz.
+- **Eşleştirir:** iki adresin aynı yeri gösterip göstermediğini söyler; CSV'de tekrarlanan kayıtları gruplar.
+- **KVKK için genelleştirir:** paylaşmadan önce kapı no, daire, posta kodu gibi ayrıntıları atıp adresi mahalle, ilçe ya da il düzeyine indirir.
+- **Teslimat denetimi:** kargo için eksik ya da çelişkili öğeleri listeler (kapı no yok, ilçe bu ile ait değil...).
+- **İki dil:** alan adları, notlar ve komut satırı Türkçe ya da İngilizce.
+
+```bash
+pip install turkce-adres
+```
+
+## Kullanım
+
+```python
+from turkce_adres import ayristir, bicimle, konum, benzerlik, genellestir, eksikler
+
+a = ayristir("ISTANBUL BESIKTAS LEVENT MAH. BUYUKDERE CAD NO 185 D 4")
+a["il"], a["ilce"], a["mahalle"], a["yol"], a["no"], a["ic_kapi"]
+# ('İstanbul', 'Beşiktaş', 'Levent', 'Büyükdere', '185', '4')
+
+bicimle(a)                 # 'Levent Mah. Büyükdere Cad. No:185 D:4, Beşiktaş/İstanbul'
+bicimle(a, "resmi")        # 'Levent Mahallesi Büyükdere Caddesi Dış Kapı No: 185 İç Kapı No: 4, Beşiktaş/İSTANBUL'
+
+konum(a)                   # {'enlem': ..., 'boylam': ..., 'duzey': 'sokak', 'kaynak': 'OpenStreetMap (ODbL)'}
+
+benzerlik("CAFERAGA MH MODA CD NO 12 KADIKOY ISTANBUL",
+          "Caferağa Mahallesi, Moda Caddesi No:12, Kadıköy/İstanbul")      # 1.0
+benzerlik("Moda Cad. No:12 Kadıköy", "Moda Cad. No:14 Kadıköy")             # 0.6 (başka bina)
+
+genellestir("Caferağa Mah. Moda Cad. No:12 D:3 Kadıköy/İstanbul 34710")["metin"]
+# 'Caferağa Mah., Kadıköy/İstanbul'
+
+eksikler("Moda Cad. Kadıköy")
+# ['mahalle ya da köy yok', 'dış kapı numarası yok', 'posta kodu yok (önerilir)']
+```
+
+Her sonuçta ayrıca `guven` (0-1) ve `notlar` vardır: ne düzeltildi, il nereden bulundu ("il ilçeden bulundu", "yazım düzeltildi: Istnbul -> İstanbul").
+`duzelt=False` verilirse sözcükler yazıldığı gibi kalır. İngilizce alan adları için `parse(metin)` ya da `ayristir(metin, dil="en")`.
+
+### Komut satırı
+
+```bash
+# tek adres
+turkce-adres "kızılay meydanı ziya gökalp cd 12 çankaya ankara" --bicim --konum
+
+# CSV: adres sütununun yanına alanları, standart yazımı, konumu, eksikleri ve tekrar gruplarını ekler
+turkce-adres musteriler.csv --sutun adres --bicim --konum --eksik --tekil -o musteriler_ayrik.csv
+
+# KVKK: yalnız mahalle düzeyine kadar yaz
+turkce-adres musteriler.csv --sutun adres --genellestir mahalle -o paylasim.csv
+
+# İngilizce sütun adları ve mesajlar
+turkce-adres customers.csv --column address --lang en --geocode -o out.csv
+```
+
+Excel'den "CSV UTF-8" olarak kaydedilen dosyalar doğrudan okunur; çıktı Excel'in Türkçe karakterleri doğru açacağı biçimde yazılır. Dosyanızda `il`, `no` gibi aynı adlı bir sütun varsa hiçbir sütun ezilmez, yeni sütunlar `adres_` ön ekiyle yazılır.
+
+## Alanlar
+
+| Türkçe | English | Örnek |
+|---|---|---|
+| `il` / `ilce` | `province` / `district` | İstanbul / Kadıköy |
+| `mahalle` / `koy` | `neighbourhood` / `village` | Caferağa / Yeşilyurt |
+| `yol`, `yol_turu` | `street`, `street_type` | Moda, cadde (sokak, cadde, bulvar, cikmaz, meydan, yol) |
+| `ust_yol` | `parent_street` | "Kızılay Meydanı Ziya Gökalp Cd." içindeki Kızılay Meydanı |
+| `no`, `ic_kapi` | `number`, `unit` | 12/3 → no 12/3, iç kapı 3 |
+| `kat`, `blok`, `bina` | `floor`, `block`, `building` | Zemin, B, Levent Plaza |
+| `posta_kodu` | `postcode` | 34710 |
+| `tarif` | `landmark` | Migros karşısı |
+| `kalan` | `unparsed` | ayrılamayan sözcükler |
+| `guven`, `notlar` | `confidence`, `notes` | 0,95, ["il ilçeden bulundu"] |
+
+## Ölçüm
+
+Üç sette ölçüldü. Karşılaştırma büyük/küçük harf ve Türkçe karakter farkını yok sayar. "Tüm alanlar doğru", adresin etiketlenmiş bütün alanlarının birlikte doğru olduğu adres oranıdır.
+
+| Set | Nasıl üretildi | Tüm alanlar doğru |
+|---|---|---|
+| `bench/sinama.jsonl` (6.000) | OpenStreetMap'teki Türkiye adreslerinden şablonla; geliştirme sırasında hiç bakılmadı | **%99,5 (5.969 / 6.000)** |
+| `bench/gelistirme.jsonl` (6.000) | Aynı yöntem; kurallar bu sette düzeltildi | %99,5 (5.973 / 6.000) |
+| `bench/zor.tsv` (58) | Elle yazılmış ve elle etiketlenmiş dağınık adresler (etiketli yazım, yazım hatası, il yazılmadan ilçe, site/blok, köy, çıkmaz, tarif) | %100 (58 / 58), aşağıdaki nota bakın |
+
+Yeniden ölçmek için: `python bench/degerlendir.py sinama` ve `python bench/zor_degerlendir.py`.
+
+**Sınırlar, dürüstçe:**
+
+- İlk iki set şablonla üretildi. Üçüncü seti bu projeyi geliştiren kişi yazdı ve bazı kurallar o sete bakılarak düzeltildi; bağımsız bir ölçüm değildir. Gerçek kullanıcı yazımında sonuç daha düşük olur. Yanlış ayrılan adres örnekleri (kişisel veri içermeden) çok değerli.
+- Mahalle sözlüğü, konum ve yazım düzeltmesi OpenStreetMap'te ne varsa ona dayanır. OSM'de olmayan mahalle doğrulanamaz; sokak düzeyinde konum yalnız OSM'de adresi girilmiş sokaklarda vardır (14.777 sokak). Konum **yaklaşıktır**: mahalle/köy için OSM'deki merkez noktası, ilçe ve il için mahalle merkezlerinin ortancası.
+- Mahalle adları zamanla değişir, birleşir. Sözlük Kasım 2026 tarihli OSM verisidir; `scripts/` altındaki betiklerle yenilenebilir.
+- Posta kodundan ilçe tablosu yalnız OSM'deki adres etiketlerinden türetildi (792 posta kodu); PTT listesi kullanılmadı.
+- `genellestir` bir **genelleştirmedir**, tek başına anonimleştirme sayılmaz: az nüfuslu bir mahalle ya da başka verilerle birleşince kişi yine belirlenebilir.
+- Resmî adres kaydıyla (UAVT) doğrulama yapmaz; o veri herkese açık değildir.
+
+## Verinin yeniden üretilmesi
+
+```bash
+pip install requests
+python scripts/osm_cek.py                         # il il adresler ve yer adları (Overpass API, ~125 MB, ham/)
+python scripts/osm_mahalle_cek.py                 # her ilçenin mahalle ve köyleri, merkez koordinatlarıyla
+python scripts/hazirla.py --ad gelistirme --atla 0
+python scripts/hazirla.py --ad sinama --atla 6000
+python scripts/sozluk_kur.py --ham ham            # mahalle, sokak, posta kodu ve yazım sözlükleri
+```
+
+## Ad hakkında
+
+Bu proje GitHub'da önce `tr-adres` adıyla açıldı. PyPI'daki `tr-adres` paketi başka bir geliştiricinin bağımsız projesidir; karışmaması için bu paket `turkce-adres` adıyla yayımlanır (modül `turkce_adres`, komut `turkce-adres`).
+
+## Lisans
+
+- Kod: [MIT](LICENSE).
+- `src/turkce_adres/veri/` altındaki sözlükler ve `bench/*.jsonl` sınama setleri OpenStreetMap verisinden türetilmiştir, **© OpenStreetMap katkıcıları**, [ODbL 1.0](LICENSE-DATA.md).

turkce_adres-0.2.0/README.en.md

@@ -0,0 +1,76 @@
+# turkce-adres
+
+[Türkçe](README.md)
+
+An offline, dependency-free Python library and command line tool for Turkish addresses:
+
+- **Parse** free-text addresses into province, district, neighbourhood/village, street (street, avenue, boulevard, dead end, square), house number, block, floor, unit, building, postcode, and landmark phrases such as "Migros karşısı" (opposite Migros).
+- **Fix** all-caps ASCII spelling (`CAFERAGA` → `Caferağa`, `BUYUKDERE` → `Büyükdere`) and typos in province and district names (`Istnbul` → `İstanbul`); format to a standard (cargo) or official style.
+- **Validate** the neighbourhood against a list of 66,687 neighbourhoods, villages and quarters; infer a missing district or province from the neighbourhood or postcode.
+- **Geocode offline:** approximate coordinates at street, neighbourhood, district or province level. No request leaves your machine.
+- **Match** two addresses ("same place?") and group duplicates in a CSV file.
+- **Generalise for privacy (KVKK/GDPR):** drop house number, unit and postcode and keep only neighbourhood, district or province before sharing data.
+- **Delivery check:** list what is missing or inconsistent (no house number, district not in this province...).
+- **Two languages:** field names, notes and CLI messages in English or Turkish.
+
+```bash
+pip install turkce-adres
+```
+
+## Usage
+
+```python
+from turkce_adres import parse, format_address, geocode, similarity, generalise, missing
+
+a = parse("ISTANBUL BESIKTAS LEVENT MAH. BUYUKDERE CAD NO 185 D 4")
+a["province"], a["district"], a["neighbourhood"], a["street"], a["number"], a["unit"]
+# ('İstanbul', 'Beşiktaş', 'Levent', 'Büyükdere', '185', '4')
+
+format_address(a)            # 'Levent Mah. Büyükdere Cad. No:185 D:4, Beşiktaş/İstanbul'
+geocode(a, "en")             # {'lat': ..., 'lon': ..., 'level': 'street', 'source': 'OpenStreetMap (ODbL)'}
+similarity("CAFERAGA MH MODA CD NO 12 KADIKOY ISTANBUL",
+           "Caferağa Mahallesi, Moda Caddesi No:12, Kadıköy/İstanbul")       # 1.0
+generalise("Caferağa Mah. Moda Cad. No:12 D:3 Kadıköy/İstanbul 34710", dil="en")["text"]
+# 'Caferağa Mah., Kadıköy/İstanbul'
+missing("Moda Cad. Kadıköy", dil="en")
+# ['neighbourhood or village missing', 'house number missing', 'postcode missing (recommended)']
+```
+
+Every result also carries `confidence` (0-1) and `notes` (what was corrected or inferred). Pass `fix=False` to keep words as written. Turkish field names: `from turkce_adres import ayristir`.
+
+### Command line
+
+```bash
+turkce-adres "kızılay meydanı ziya gökalp cd 12 çankaya ankara" --lang en --format --geocode
+turkce-adres customers.csv --column address --lang en --format --geocode --missing --dedupe -o out.csv
+turkce-adres customers.csv --column address --lang en --generalise mahalle -o shareable.csv
+```
+
+If your file already has a column with the same name as a new field, nothing is overwritten: new columns get the `adres_` prefix.
+
+## Evaluation
+
+Comparison ignores case and Turkish diacritics. "All fields correct" is the share of addresses where every labelled field is right.
+
+| Set | How it was made | All fields correct |
+|---|---|---|
+| `bench/sinama.jsonl` (6,000) | Turkish OpenStreetMap addresses rendered with templates; never looked at during development | **99.5% (5,969 / 6,000)** |
+| `bench/gelistirme.jsonl` (6,000) | Same method; rules were tuned on this set | 99.5% (5,973 / 6,000) |
+| `bench/zor.tsv` (58) | Hand-written, hand-labelled messy addresses (labelled fields, typos, district without province, site/block, villages, dead ends, landmarks) | 100% (58 / 58), see the note below |
+
+**Limits:**
+
+- The first two sets are template-generated. The third was written by the author of this project and some rules were fixed after looking at it, so it is not an independent benchmark. Real-world input will score lower.
+- Neighbourhood validation, geocoding and spelling fixes only know what OpenStreetMap knows. Street-level coordinates exist only for streets with addresses in OSM (14,777 streets). Coordinates are **approximate**: OSM centre points for neighbourhoods and villages, medians of those for districts and provinces.
+- The postcode-to-district table is derived only from OSM address tags (792 postcodes); the PTT list is not used.
+- `generalise` is generalisation, not anonymisation on its own.
+- No validation against the official national address registry (UAVT), which is not public.
+
+## About the name
+
+This project was first opened on GitHub as `tr-adres`. The `tr-adres` package on PyPI is an independent project by another developer; to avoid confusion this package is published as `turkce-adres` (module `turkce_adres`, command `turkce-adres`).
+
+## License
+
+- Code: [MIT](LICENSE).
+- The gazetteers in `src/turkce_adres/veri/` and the test sets in `bench/*.jsonl` are derived from OpenStreetMap data, **© OpenStreetMap contributors**, [ODbL 1.0](LICENSE-DATA.md).

turkce_adres-0.2.0/README.md

@@ -0,0 +1,120 @@
+# turkce-adres
+
+[English](README.en.md)
+
+Türkçe adresler için internetsiz, ek paket gerektirmeyen bir Python kütüphanesi ve komut satırı aracı:
+
+- **Ayrıştırır:** dağınık yazılmış adresi il, ilçe, mahalle/köy, cadde/sokak/bulvar/çıkmaz/meydan, kapı no, blok, kat, daire, bina, posta kodu ve "Migros karşısı" gibi tarif ifadelerine ayırır.
+- **Düzeltir:** BÜYÜK ASCII yazımı Türkçe harflerine kavuşturur (`CAFERAGA` → `Caferağa`, `BUYUKDERE` → `Büyükdere`), il ve ilçe adlarındaki yazım hatalarını düzeltir (`Istnbul` → `İstanbul`), standart (kargo) ya da resmî yazıma çevirir.
+- **Doğrular:** 66.687 mahalle, köy ve semtlik sözlükle mahallenin o ilçede olup olmadığına bakar; il ya da ilçe yazılmamışsa mahalleden ya da posta kodundan bulur.
+- **Konum verir (internetsiz):** adresin yaklaşık koordinatını sokak, mahalle, ilçe ya da il düzeyinde döndürür. Hiçbir servise istek atmaz.
+- **Eşleştirir:** iki adresin aynı yeri gösterip göstermediğini söyler; CSV'de tekrarlanan kayıtları gruplar.
+- **KVKK için genelleştirir:** paylaşmadan önce kapı no, daire, posta kodu gibi ayrıntıları atıp adresi mahalle, ilçe ya da il düzeyine indirir.
+- **Teslimat denetimi:** kargo için eksik ya da çelişkili öğeleri listeler (kapı no yok, ilçe bu ile ait değil...).
+- **İki dil:** alan adları, notlar ve komut satırı Türkçe ya da İngilizce.
+
+```bash
+pip install turkce-adres
+```
+
+## Kullanım
+
+```python
+from turkce_adres import ayristir, bicimle, konum, benzerlik, genellestir, eksikler
+
+a = ayristir("ISTANBUL BESIKTAS LEVENT MAH. BUYUKDERE CAD NO 185 D 4")
+a["il"], a["ilce"], a["mahalle"], a["yol"], a["no"], a["ic_kapi"]
+# ('İstanbul', 'Beşiktaş', 'Levent', 'Büyükdere', '185', '4')
+
+bicimle(a)                 # 'Levent Mah. Büyükdere Cad. No:185 D:4, Beşiktaş/İstanbul'
+bicimle(a, "resmi")        # 'Levent Mahallesi Büyükdere Caddesi Dış Kapı No: 185 İç Kapı No: 4, Beşiktaş/İSTANBUL'
+
+konum(a)                   # {'enlem': ..., 'boylam': ..., 'duzey': 'sokak', 'kaynak': 'OpenStreetMap (ODbL)'}
+
+benzerlik("CAFERAGA MH MODA CD NO 12 KADIKOY ISTANBUL",
+          "Caferağa Mahallesi, Moda Caddesi No:12, Kadıköy/İstanbul")      # 1.0
+benzerlik("Moda Cad. No:12 Kadıköy", "Moda Cad. No:14 Kadıköy")             # 0.6 (başka bina)
+
+genellestir("Caferağa Mah. Moda Cad. No:12 D:3 Kadıköy/İstanbul 34710")["metin"]
+# 'Caferağa Mah., Kadıköy/İstanbul'
+
+eksikler("Moda Cad. Kadıköy")
+# ['mahalle ya da köy yok', 'dış kapı numarası yok', 'posta kodu yok (önerilir)']
+```
+
+Her sonuçta ayrıca `guven` (0-1) ve `notlar` vardır: ne düzeltildi, il nereden bulundu ("il ilçeden bulundu", "yazım düzeltildi: Istnbul -> İstanbul").
+`duzelt=False` verilirse sözcükler yazıldığı gibi kalır. İngilizce alan adları için `parse(metin)` ya da `ayristir(metin, dil="en")`.
+
+### Komut satırı
+
+```bash
+# tek adres
+turkce-adres "kızılay meydanı ziya gökalp cd 12 çankaya ankara" --bicim --konum
+
+# CSV: adres sütununun yanına alanları, standart yazımı, konumu, eksikleri ve tekrar gruplarını ekler
+turkce-adres musteriler.csv --sutun adres --bicim --konum --eksik --tekil -o musteriler_ayrik.csv
+
+# KVKK: yalnız mahalle düzeyine kadar yaz
+turkce-adres musteriler.csv --sutun adres --genellestir mahalle -o paylasim.csv
+
+# İngilizce sütun adları ve mesajlar
+turkce-adres customers.csv --column address --lang en --geocode -o out.csv
+```
+
+Excel'den "CSV UTF-8" olarak kaydedilen dosyalar doğrudan okunur; çıktı Excel'in Türkçe karakterleri doğru açacağı biçimde yazılır. Dosyanızda `il`, `no` gibi aynı adlı bir sütun varsa hiçbir sütun ezilmez, yeni sütunlar `adres_` ön ekiyle yazılır.
+
+## Alanlar
+
+| Türkçe | English | Örnek |
+|---|---|---|
+| `il` / `ilce` | `province` / `district` | İstanbul / Kadıköy |
+| `mahalle` / `koy` | `neighbourhood` / `village` | Caferağa / Yeşilyurt |
+| `yol`, `yol_turu` | `street`, `street_type` | Moda, cadde (sokak, cadde, bulvar, cikmaz, meydan, yol) |
+| `ust_yol` | `parent_street` | "Kızılay Meydanı Ziya Gökalp Cd." içindeki Kızılay Meydanı |
+| `no`, `ic_kapi` | `number`, `unit` | 12/3 → no 12/3, iç kapı 3 |
+| `kat`, `blok`, `bina` | `floor`, `block`, `building` | Zemin, B, Levent Plaza |
+| `posta_kodu` | `postcode` | 34710 |
+| `tarif` | `landmark` | Migros karşısı |
+| `kalan` | `unparsed` | ayrılamayan sözcükler |
+| `guven`, `notlar` | `confidence`, `notes` | 0,95, ["il ilçeden bulundu"] |
+
+## Ölçüm
+
+Üç sette ölçüldü. Karşılaştırma büyük/küçük harf ve Türkçe karakter farkını yok sayar. "Tüm alanlar doğru", adresin etiketlenmiş bütün alanlarının birlikte doğru olduğu adres oranıdır.
+
+| Set | Nasıl üretildi | Tüm alanlar doğru |
+|---|---|---|
+| `bench/sinama.jsonl` (6.000) | OpenStreetMap'teki Türkiye adreslerinden şablonla; geliştirme sırasında hiç bakılmadı | **%99,5 (5.969 / 6.000)** |
+| `bench/gelistirme.jsonl` (6.000) | Aynı yöntem; kurallar bu sette düzeltildi | %99,5 (5.973 / 6.000) |
+| `bench/zor.tsv` (58) | Elle yazılmış ve elle etiketlenmiş dağınık adresler (etiketli yazım, yazım hatası, il yazılmadan ilçe, site/blok, köy, çıkmaz, tarif) | %100 (58 / 58), aşağıdaki nota bakın |
+
+Yeniden ölçmek için: `python bench/degerlendir.py sinama` ve `python bench/zor_degerlendir.py`.
+
+**Sınırlar, dürüstçe:**
+
+- İlk iki set şablonla üretildi. Üçüncü seti bu projeyi geliştiren kişi yazdı ve bazı kurallar o sete bakılarak düzeltildi; bağımsız bir ölçüm değildir. Gerçek kullanıcı yazımında sonuç daha düşük olur. Yanlış ayrılan adres örnekleri (kişisel veri içermeden) çok değerli.
+- Mahalle sözlüğü, konum ve yazım düzeltmesi OpenStreetMap'te ne varsa ona dayanır. OSM'de olmayan mahalle doğrulanamaz; sokak düzeyinde konum yalnız OSM'de adresi girilmiş sokaklarda vardır (14.777 sokak). Konum **yaklaşıktır**: mahalle/köy için OSM'deki merkez noktası, ilçe ve il için mahalle merkezlerinin ortancası.
+- Mahalle adları zamanla değişir, birleşir. Sözlük Kasım 2026 tarihli OSM verisidir; `scripts/` altındaki betiklerle yenilenebilir.
+- Posta kodundan ilçe tablosu yalnız OSM'deki adres etiketlerinden türetildi (792 posta kodu); PTT listesi kullanılmadı.
+- `genellestir` bir **genelleştirmedir**, tek başına anonimleştirme sayılmaz: az nüfuslu bir mahalle ya da başka verilerle birleşince kişi yine belirlenebilir.
+- Resmî adres kaydıyla (UAVT) doğrulama yapmaz; o veri herkese açık değildir.
+
+## Verinin yeniden üretilmesi
+
+```bash
+pip install requests
+python scripts/osm_cek.py                         # il il adresler ve yer adları (Overpass API, ~125 MB, ham/)
+python scripts/osm_mahalle_cek.py                 # her ilçenin mahalle ve köyleri, merkez koordinatlarıyla
+python scripts/hazirla.py --ad gelistirme --atla 0
+python scripts/hazirla.py --ad sinama --atla 6000
+python scripts/sozluk_kur.py --ham ham            # mahalle, sokak, posta kodu ve yazım sözlükleri
+```
+
+## Ad hakkında
+
+Bu proje GitHub'da önce `tr-adres` adıyla açıldı. PyPI'daki `tr-adres` paketi başka bir geliştiricinin bağımsız projesidir; karışmaması için bu paket `turkce-adres` adıyla yayımlanır (modül `turkce_adres`, komut `turkce-adres`).
+
+## Lisans
+
+- Kod: [MIT](LICENSE).
+- `src/turkce_adres/veri/` altındaki sözlükler ve `bench/*.jsonl` sınama setleri OpenStreetMap verisinden türetilmiştir, **© OpenStreetMap katkıcıları**, [ODbL 1.0](LICENSE-DATA.md).

turkce_adres-0.2.0/bench/zor.tsv

@@ -0,0 +1,61 @@
+# Elle yazılmış ve elle etiketlenmiş "zor" adresler. Şablonla üretilmedi. Kişisel veri yoktur; adresler genel
+# örneklerdir, gerçek bir kişiyi ya da kurumu göstermez. Sütunlar: metin, sonra alan=değer çiftleri.
+# no = dış kapı numarası; "12/3" yazımı dış kapı 12, iç kapı 3 sayılır. mahalle alanı köyleri de kapsar.
+caferaga mh moda cd no 12 d 3 kadikoy istanbul	il=İstanbul	ilce=Kadıköy	mahalle=Caferağa	yol=Moda	yol_turu=cadde	no=12	ic_kapi=3
+ISTANBUL BESIKTAS LEVENT MAH. BUYUKDERE CAD NO 185	il=İstanbul	ilce=Beşiktaş	mahalle=Levent	yol=Büyükdere	yol_turu=cadde	no=185
+Kızılay Mah. Atatürk Bulvarı No:115 Kat:4 Çankaya/ANKARA	il=Ankara	ilce=Çankaya	mahalle=Kızılay	yol=Atatürk	yol_turu=bulvar	no=115	kat=4
+alsancak mah 1469 sk no 8 d 2 konak izmir	il=İzmir	ilce=Konak	mahalle=Alsancak	yol=1469	yol_turu=sokak	no=8	ic_kapi=2
+Bağdat Caddesi No:350 Daire:12 Kat:5 Suadiye Mahallesi Kadıköy İstanbul 34740	il=İstanbul	ilce=Kadıköy	mahalle=Suadiye	yol=Bağdat	yol_turu=cadde	no=350	ic_kapi=12	kat=5	posta_kodu=34740
+Kadikoy Caferaga Mah Moda Cad 12/3	il=İstanbul	ilce=Kadıköy	mahalle=Caferağa	yol=Moda	yol_turu=cadde	no=12	ic_kapi=3
+Levent Mah. Büyükdere Cad. No:185 Besiktas/Istnbul	il=İstanbul	ilce=Beşiktaş	mahalle=Levent	yol=Büyükdere	yol_turu=cadde	no=185
+Mahalle: Caferağa, Cadde: Moda, No: 5, İlçe: Kadıköy, İl: İstanbul	il=İstanbul	ilce=Kadıköy	mahalle=Caferağa	yol=Moda	yol_turu=cadde	no=5
+Bostanlı Mah. 1203/2 Sk. No:6 D:3 Karşıyaka İzmir	il=İzmir	ilce=Karşıyaka	mahalle=Bostanlı	yol=1203/2	yol_turu=sokak	no=6	ic_kapi=3
+Moda Cad. No:5 34710	il=İstanbul	ilce=Kadıköy	yol=Moda	yol_turu=cadde	no=5	posta_kodu=34710
+100. Yıl Mah. 29 Ekim Cad. No:4 Bağlar/Diyarbakır	il=Diyarbakır	ilce=Bağlar	mahalle=100. Yıl	yol=29 Ekim	yol_turu=cadde	no=4
+Hayrullah Mah. Trabzon Cad. No:20 Onikişubat/K.Maraş	il=Kahramanmaraş	ilce=Onikişubat	mahalle=Hayrullah	yol=Trabzon	yol_turu=cadde	no=20
+adapazarı tığcılar mahallesi uzun çarşı no 45	il=Sakarya	ilce=Adapazarı	mahalle=Tığcılar	no=45
+600 Evler Mah. 2114 Sk. no 3 Bandırma/Balıkesir	il=Balıkesir	ilce=Bandırma	mahalle=600 Evler	yol=2114	yol_turu=sokak	no=3
+kızılay meydanı ziya gökalp cd 12 çankaya ankara	il=Ankara	ilce=Çankaya	yol=Ziya Gökalp	yol_turu=cadde	no=12
+Fatih Sultan Mehmet mah, Poligon Caddesi, No.8C/1, Ümraniye, İstanbul	il=İstanbul	ilce=Ümraniye	mahalle=Fatih Sultan Mehmet	yol=Poligon	yol_turu=cadde	no=8C	ic_kapi=1
+Esentepe Mahallesi Büyükdere Caddesi Levent Plaza No 173 Şişli İstanbul Türkiye	il=İstanbul	ilce=Şişli	mahalle=Esentepe	yol=Büyükdere	yol_turu=cadde	no=173
+Yıldız Sit. B Blk. Kat 2 D:5, Çankaya / ANKARA	il=Ankara	ilce=Çankaya	kat=2	ic_kapi=5	blok=B
+Cumhuriyet Mah. Gazi Cad. No:15-A Kat: Zemin Bayraklı İzmir	il=İzmir	ilce=Bayraklı	mahalle=Cumhuriyet	yol=Gazi	yol_turu=cadde	no=15/A
+Merkez mah. Okul sok. no 3 Kuyucak Aydın	il=Aydın	ilce=Kuyucak	mahalle=Merkez	yol=Okul	yol_turu=sokak	no=3
+Atatürk Mah. Cumhuriyet Cad. No:15/3 Serdivan/Sakarya	il=Sakarya	ilce=Serdivan	mahalle=Atatürk	yol=Cumhuriyet	yol_turu=cadde	no=15	ic_kapi=3
+Yeni Mah. 1203 Sok. No 4 Daire 7 Merkez/Kırşehir	il=Kırşehir	ilce=Kırşehir Merkez	mahalle=Yeni	yol=1203	yol_turu=sokak	no=4	ic_kapi=7
+Bahçelievler mh 7. sk no5 kat3 daire9 bahçelievler istanbul	il=İstanbul	ilce=Bahçelievler	mahalle=Bahçelievler	yol=7.	yol_turu=sokak	no=5	ic_kapi=9	kat=3
+KONAK MAH. 1453 SOKAK NO:22 D:4 NILUFER/BURSA 16110	il=Bursa	ilce=Nilüfer	mahalle=Konak	yol=1453	yol_turu=sokak	no=22	ic_kapi=4	posta_kodu=16110
+Barbaros Bulvarı Yıldız İş Merkezi No:145 Kat:4 Beşiktaş	il=İstanbul	ilce=Beşiktaş	yol=Barbaros	yol_turu=bulvar	no=145	kat=4
+Yeşilyurt Köyü Merkez Sokak No:7 Kızılcahamam Ankara	il=Ankara	ilce=Kızılcahamam	mahalle=Yeşilyurt	yol=Merkez	yol_turu=sokak	no=7
+Şemsi Paşa Çıkmazı No:4 Üsküdar İstanbul	il=İstanbul	ilce=Üsküdar	yol=Şemsi Paşa	yol_turu=cikmaz	no=4
+ANKARA CANKAYA KAVAKLIDERE MAH TUNALI HILMI CAD NO 88 D 4	il=Ankara	ilce=Çankaya	mahalle=Kavaklıdere	yol=Tunalı Hilmi	yol_turu=cadde	no=88	ic_kapi=4
+Göztepe mahallesi, Fahrettin Kerim Gökay caddesi no:120/5 Kadıköy	il=İstanbul	ilce=Kadıköy	mahalle=Göztepe	yol=Fahrettin Kerim Gökay	yol_turu=cadde	no=120	ic_kapi=5
+Kemeraltı Cad. No 12 Kat 3 Daire 6 Beyoğlu İst.	il=İstanbul	ilce=Beyoğlu	yol=Kemeraltı	yol_turu=cadde	no=12	kat=3	ic_kapi=6
+Sanayi Mah. 1. Sanayi Sitesi 5. Blok No:12 Eskişehir	il=Eskişehir	mahalle=Sanayi	no=12	blok=5
+Mimar Sinan Mah. Ankara Yolu Cad. No:45 Osmangazi/Bursa	il=Bursa	ilce=Osmangazi	mahalle=Mimar Sinan	yol=Ankara Yolu	yol_turu=cadde	no=45
+Ziya Gökalp Mah. Süleyman Demirel Blv. No:7 Başakşehir İSTANBUL	il=İstanbul	ilce=Başakşehir	mahalle=Ziya Gökalp	yol=Süleyman Demirel	yol_turu=bulvar	no=7
+Konyaaltı/Antalya, Hurma Mahallesi, 195/1 Sokak, No: 5	il=Antalya	ilce=Konyaaltı	mahalle=Hurma	yol=195/1	yol_turu=sokak	no=5
+Çarşı Mah. Uzunçarşı Cad. No:24 Ortahisar Trabzon	il=Trabzon	ilce=Ortahisar	mahalle=Çarşı	yol=Uzunçarşı	yol_turu=cadde	no=24
+inönü mah. atatürk cad. no:67 merkez/afyon	il=Afyonkarahisar	ilce=Afyonkarahisar Merkez	mahalle=İnönü	yol=Atatürk	yol_turu=cadde	no=67
+Kültür Mah. 1375. Sk. No:8/2 Konak/İzmir 35220	il=İzmir	ilce=Konak	mahalle=Kültür	yol=1375.	yol_turu=sokak	no=8	ic_kapi=2	posta_kodu=35220
+Hürriyet Mah, Dr. Sadık Ahmet Cad. No:12, Bağcılar, İstanbul	il=İstanbul	ilce=Bağcılar	mahalle=Hürriyet	yol=Dr. Sadık Ahmet	yol_turu=cadde	no=12
+GAZIOSMANPASA MAH. CINNAH CAD. NO:30/7 CANKAYA ANKARA	il=Ankara	ilce=Çankaya	mahalle=Gaziosmanpaşa	yol=Cinnah	yol_turu=cadde	no=30	ic_kapi=7
+Selçuklu Konya Yazır Mah. Kule Sk. No 3	il=Konya	ilce=Selçuklu	mahalle=Yazır	yol=Kule	yol_turu=sokak	no=3
+Atakum Samsun Mimar Sinan mh. 105. sk no 9 daire 2	il=Samsun	ilce=Atakum	mahalle=Mimar Sinan	yol=105.	yol_turu=sokak	no=9	ic_kapi=2
+Turgutreis Mah. Atatürk Cad. No: 52 Bodrum MUĞLA	il=Muğla	ilce=Bodrum	mahalle=Turgutreis	yol=Atatürk	yol_turu=cadde	no=52
+Yenimahalle Ankara Demetevler mah 402. cad no 15	il=Ankara	ilce=Yenimahalle	mahalle=Demetevler	yol=402.	yol_turu=cadde	no=15
+Mustafa Kemal Paşa Bulvarı No:200 Merkezefendi Denizli	il=Denizli	ilce=Merkezefendi	yol=Mustafa Kemal Paşa	yol_turu=bulvar	no=200
+Akçaabat Trabzon, Yaylacık Mah. Sahil Cad. 14/1	il=Trabzon	ilce=Akçaabat	mahalle=Yaylacık	yol=Sahil	yol_turu=cadde	no=14	ic_kapi=1
+Harbiye Mah. Kurtuluş Cd. Nu:5 Antakya-Hatay	il=Hatay	ilce=Antakya	mahalle=Harbiye	yol=Kurtuluş	yol_turu=cadde	no=5
+Zafer Mh. Gazi Blv. No:44 Bağlar DİYARBAKIR 21100	il=Diyarbakır	ilce=Bağlar	mahalle=Zafer	yol=Gazi	yol_turu=bulvar	no=44	posta_kodu=21100
+Ataşehir Barbaros Mah. Begonya Sk. No: 3 Kat:-1	il=İstanbul	ilce=Ataşehir	mahalle=Barbaros	yol=Begonya	yol_turu=sokak	no=3	kat=-1
+Eskişehir Odunpazarı Vişnelik Mah. Cumhuriyet Blv. No:18	il=Eskişehir	ilce=Odunpazarı	mahalle=Vişnelik	yol=Cumhuriyet	yol_turu=bulvar	no=18
+Yalı Mah. Sahil Yolu No:3 Mudanya/Bursa	il=Bursa	ilce=Mudanya	mahalle=Yalı	yol=Sahil	yol_turu=yol	no=3
+Cumhuriyet Mh 2250 Sk No:5 Daire:2 Esenyurt İstanbul	il=İstanbul	ilce=Esenyurt	mahalle=Cumhuriyet	yol=2250	yol_turu=sokak	no=5	ic_kapi=2
+Sahrayıcedit mah. atatürk cad. no.45 d.3 kadıköy/ist	il=İstanbul	ilce=Kadıköy	mahalle=Sahrayıcedit	yol=Atatürk	yol_turu=cadde	no=45	ic_kapi=3
+Kocatepe Mahallesi Mithatpaşa Caddesi No: 33/6 06420 Çankaya Ankara	il=Ankara	ilce=Çankaya	mahalle=Kocatepe	yol=Mithatpaşa	yol_turu=cadde	no=33	ic_kapi=6	posta_kodu=06420
+Merkez Mah. Hal Yolu Cad. No:2 Silivri İstanbul	il=İstanbul	ilce=Silivri	mahalle=Merkez	yol=Hal Yolu	yol_turu=cadde	no=2
+İzmir Karşıyaka Mavişehir Mah. 2050 Sk. No:9 K:3 D:12	il=İzmir	ilce=Karşıyaka	mahalle=Mavişehir	yol=2050	yol_turu=sokak	no=9	ic_kapi=12	kat=3
+Bahçelievler Mah. 3. Cadde No:22 Sur Diyarbakır Kaya Market karşısı	il=Diyarbakır	ilce=Sur	mahalle=Bahçelievler	yol=3.	yol_turu=cadde	no=22
+Sakarya Mah. Necatibey Cd. No:5 Çankaya Ankara	il=Ankara	ilce=Çankaya	mahalle=Sakarya	yol=Necatibey	yol_turu=cadde	no=5
+Aydın Mah. 1500 Sk. No:3 Turgutlu Manisa	il=Manisa	ilce=Turgutlu	mahalle=Aydın	yol=1500	yol_turu=sokak	no=3

turkce_adres-0.2.0/pyproject.toml

@@ -0,0 +1,51 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "turkce-adres"
+version = "0.2.0"
+description = "Turkish address toolkit: parse messy Turkish addresses, fix spelling, validate against 66,000+ neighbourhoods and villages, offline geocoding to street/neighbourhood level, duplicate matching, KVKK-friendly generalisation. Offline, no dependencies."
+readme = "README.md"
+license = { text = "MIT AND ODbL-1.0" }
+requires-python = ">=3.10"
+authors = [{ name = "Mehmet Veysel Delibaş" }]
+keywords = ["turkish", "turkey", "address", "address-parser", "adres", "geocoding", "offline-geocoding", "deduplication", "kvkk", "gis", "openstreetmap", "mahalle"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "Intended Audience :: Science/Research",
+  "Natural Language :: Turkish",
+  "Natural Language :: English",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Topic :: Scientific/Engineering :: GIS",
+  "Topic :: Text Processing :: Linguistic",
+]
+dependencies = []
+
+[project.optional-dependencies]
+dev = ["pytest>=7"]
+
+[project.scripts]
+turkce-adres = "turkce_adres.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/mveyseldelibas/turkce-adres"
+Issues = "https://github.com/mveyseldelibas/turkce-adres/issues"
+Changelog = "https://github.com/mveyseldelibas/turkce-adres/blob/main/CHANGELOG.md"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/turkce_adres"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src", "tests", "bench/zor.tsv", "README.md", "README.en.md", "LICENSE", "LICENSE-DATA.md", "CHANGELOG.md"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests", "src"]
+pythonpath = ["src"]
+addopts = "--doctest-modules"