tdk-py

Python API for the Turkish Language Foundation

tdk-py is a Python package allowing access to Turkish dictionaries of the TDK, the Turkish Language Association.

tdk-py provides both synchronous and asynchronous interfaces to the TDK's APIs and parses their responses into Python class objects based on Pydantic, so you can do things like .model_dump_json() them, or use them in your API endpoints and generate beautiful schemas.

Quick start

tdk-py is supported on Python 3.10+. First, make sure you have a Python environment set up.

# in the shell
poetry add tdk-py      # if using python-poetry.org (recommended)
pipenv install tdk-py  # if using pipenv.pypa.io
pip install tdk-py     # straight pip.pypa.io

# in Python
import tdk

Examples

import tdk

results = tdk.search_gts_sync("merkeziyetçilik")
print(results[0].meanings[0].meaning)

Otoritenin ve işin tek bir merkezde toplanmasını amaçlayan görüş; merkeziyet, merkezcilik

You can query suggestions for misspelt words or for other similar words.

from difflib import get_close_matches
import tdk

# Calculate suggestions locally using the index:
words = get_close_matches("feldispat", tdk.get_gts_index_sync())
assert words == ['feldspat', 'ispat', 'fesat']

# Use the TDK API: (sometimes errors out)
words = tdk.get_gts_suggestions_sync("feldispat")
assert words == ['feldspat', 'felekiyat', 'ispat']

You can perform complex analyses very easily. Let's see the distribution of entries by the number of maximum consecutive consonants.

import tdk

annotated_dict = {}
for entry in tdk.get_gts_index_sync():
    streaks = tdk.tools.max_streak(entry)
    if streaks not in annotated_dict:
        annotated_dict[streaks] = [entry]
    else:
        annotated_dict[streaks].append(entry)
for i in set(annotated_dict):
    print(i, len(annotated_dict[i]))

License

tdk-py's source code is provided under the MIT License

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tdk_py-2.0.1.tar.gz (22.2 kB view details)

Uploaded Aug 7, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

tdk_py-2.0.1-py3-none-any.whl (30.6 kB view details)

Uploaded Aug 7, 2026 Python 3

File details

Details for the file tdk_py-2.0.1.tar.gz.

File metadata

Download URL: tdk_py-2.0.1.tar.gz
Upload date: Aug 7, 2026
Size: 22.2 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for tdk_py-2.0.1.tar.gz
Algorithm	Hash digest
SHA256	`e4e03133d1009e339bcb91aca1bf78e45b43ff71ee5b990ce04d3b079d099fa0`
MD5	`9ed23e97237d9020f302b0da3c821437`
BLAKE2b-256	`5305ab10aeab208788b2512d1864d9163b83e90211f3e2d8cb7c9eccc3d945e6`

See more details on using hashes here.

Provenance

The following attestation bundles were made for tdk_py-2.0.1.tar.gz:

Publisher: publish.yml on emreozcan/tdk-py

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: tdk_py-2.0.1.tar.gz
- Subject digest: e4e03133d1009e339bcb91aca1bf78e45b43ff71ee5b990ce04d3b079d099fa0
- Sigstore transparency entry: 2372743123
- Sigstore integration time: Aug 7, 2026
Source repository:
- Permalink: emreozcan/tdk-py@3b0a0579138a3ab059fdce412bbf4bde6a3ea4da
- Branch / Tag: refs/tags/v2.0.1
- Owner: https://github.com/emreozcan
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@3b0a0579138a3ab059fdce412bbf4bde6a3ea4da
- Trigger Event: push