tdk-sdk v1.0.0

tdk-sdk

tdk-sdk, Türk Dil Kurumu (TDK) veritabanına kolayca erişim sağlamak için geliştirilmiş bir SDK'dır. Bu modül, kelime anlamları, atasözleri, deyimler, bilim ve sanat terimleri gibi çeşitli sözlük verilerine ulaşmanızı sağlar.

Özellikler

• Güncel Türkçe Sözlük: Türkçe kelimelerin anlamlarına, lisanlarına ve birleşik kelimelerine erişin.
• Atasözleri ve Deyimler Sözlüğü: Kelimeyle ilgili atasözleri ve deyimler listesine ulaşın.
• Derleme Sözlüğü: Türk halk dilinde kullanılan kelimelerin derlenmiş haline erişin.
• Bilim ve Sanat Terimleri Sözlüğü: Bilim ve sanat dallarında kullanılan terimlerin anlamlarına ulaşın.
• Türkçede Batı Kökenli Kelimeler: Batı kökenli kelimelerin Türkçe karşılıklarına erişin.
• Etimolojik Sözlük: Kelimenin kökenine dair etimolojik bilgiler edinin.

Kurulum

Modülü projene eklemek için NPM kullanarak aşağıdaki komutu çalıştırın:

npm install tdk-sdk

Kullanım

Aşağıdaki örnek, tdk-sdk modülünün nasıl kullanılacağını göstermektedir:

Basit Kullanım

const tdk = require('tdk-sdk');

(async () => {
  const wordData = await tdk.sozlukAra('umut');

  console.log(wordData);
})();

Detaylı Örnek

Kelime ile ilgili tüm sözlük verilerini almak için:

const tdk = require('tdk-sdk');

(async () => {
  const kelime = 'umut';

  try {
    const result = await tdk.sozlukAra(kelime);
    console.log('Kelime:', result.word);
    console.log('Anlamlar:', result.means);
    console.log('Atasözleri ve Deyimler:', result.proverbs);
    console.log('Bilim ve Sanat Terimleri:', result.glossaryOfScienceAndArtTerms);
    console.log('Batı Kökenli Kelimeler:', result.westOpposite);
    console.log('Etimolojik Bilgiler:', result.etymological);
  } catch (error) {
    console.error('Hata oluştu:', error);
  }
})();

Dataların Dosyaya Kaydedilmesi

Verileri bir dosyaya kaydetmek için aşağıdaki örneği kullanabilirsiniz:

const tdk = require('tdk-sdk');
const fs = require('fs');

(async () => {
  const kelime = 'sevgi';
  
  try {
    const result = await tdk.sozlukAra(kelime);
    
    fs.writeFileSync('genel_sozluk.txt', JSON.stringify(result, null, 2));
    console.log(`${kelime} için sözlük verileri 'genel_sozluk.txt' dosyasına kaydedildi.`);
  } catch (error) {
    console.error('Hata oluştu:', error);
  }
})();

API

sozlukAra(word, [uri])

Verilen kelimeyi Türk Dil Kurumu sözlüklerinden sorgular ve aşağıdaki verileri döner:

• word: Kelime
• lisan: Kelimenin lisanı
• means: Kelimenin anlamları listesi
• compounds: Birleşik kelimeler
• proverbs: Atasözleri ve deyimler
• compilation: Derleme sözlüğü verileri
• glossaryOfScienceAndArtTerms: Bilim ve sanat terimleri sözlüğü
• westOpposite: Batı kökenli kelimelerin karşılıkları
• guide: Yabancı sözlere karşılıklar kılavuzu
• etymological: Etimolojik sözlük verileri

Parametreler

• word: (string) Sorgulanacak kelime.
• uri: (optional, string) TDK'nın API base URL'si. Varsayılan olarak https://sozluk.gov.tr/ kullanılır.

Döndürülen Değer

Bir Promise döner ve veritabanındaki ilgili kelimenin tüm verilerini içeren bir nesne sağlar.

Hata Yönetimi

Herhangi bir hata meydana gelirse, try/catch yapısı kullanılarak yakalanabilir. Örneğin:

try {
  const result = await tdk.sozlukAra('umut');
} catch (error) {
  console.error('Bir hata oluştu:', error);
}

Bağımlılıklar

• axios: HTTP isteklerini yapmak için kullanılır. Axios'un en güncel sürümünü kullanmaktadır.

Lisans

Bu proje MIT Lisansı ile lisanslanmıştır.