Skip to content

Latest commit

 

History

History
91 lines (72 loc) · 4.05 KB

README_TR.md

File metadata and controls

91 lines (72 loc) · 4.05 KB
Raw

TCDD Bilet Bulucu

Genel Bakış

TCDD Tren Koltuk Bulucu, kullanıcıların mevcut API servisinden yararlanarak Türkiye Cumhuriyeti Devlet Demiryolları (TCDD) trenlerinde boş koltuk bulmasına yardımcı olan Python tabanlı bir araçtır. Belirli güzergahlar, tarihler ve isteğe bağlı olarak saatler için koltuk müsaitliğini kontrol etme işlemini otomatikleştirir. Müsait bir koltuk bulunduğunda, araç kullanıcıyı e-posta yoluyla bilgilendirir ve tren adı, yolculuk tarihi, vagon numarası ve koltuk numarası gibi detayları sağlar.

Özellikler

  • Otomatik Koltuk Kontrolü: Belirtilen tren güzergahlarında müsait koltukları otomatik olarak kontrol eder.
  • E-posta Bildirimleri: Müsait koltuklar bulunduğunda detaylı bilgilerle e-posta uyarıları gönderir.
  • Yapılandırılabilir Aramalar: Kalkış ve varış istasyonlarını, yolculuk tarihlerini ve isteğe bağlı olarak tercih edilen kalkış saatlerini belirleyebilirsiniz.
  • API Odaklı Basitlik: Hafif ve güvenilir işlemler için doğrudan API çağrıları kullanır. Bu yaklaşım, bağımlılıkları en aza indirir ve web sitesi değişikliklerinden kaynaklanabilecek sorunların potansiyelini azaltarak Selenium gibi web kazıma tekniklerine dayanan araçlardan ayrışır.

Kurulum

Gereksinimler

  • Python 3.x
  • Pip (Python paket yükleyicisi)
  • Email (@outlook.com ile biten) & şifre

Kurulum Adımları

  1. Depoyu yerel makinenize klonlayın: 
    git clone https://github.com/rburaksaritas/tcdd-bilet-bulucu
  2. Proje dizinine gidin: 
    cd tcdd-bilet-bulucu
  3. Gerekli bağımlılıkları yükleyin: 
    pip3 install -r requirements.txt

Yapılandırma (config.py)

Araçları kullanmadan önce, src dizininde bulunan config.py dosyasını düzenleyerek yapılandırmanız gerekir. Aşağıdaki parametreleri tercihlerinize göre ayarlayın:

  • binis_istasyon_adi: Kalkış istasyonunun adı.
  • inis_istasyon_adi: Varış istasyonunun adı.
  • date: Yolculuk tarihi (format: YYYY-AA-GG).
  • check_specific_hour: Belirli bir saatte trenleri kontrol etmek istiyorsanız True olarak ayarlayın, aksi takdirde False.
  • hour: Tercih edilen kalkış saati (format: SS:DD), check_specific_hour True ise gereklidir.
  • email_address: Bildirimin gönderileceği e-posta adresiniz.
  • email_password: Yukarıdaki e-posta hesabının şifresi.
  • destination_address: Bildirimi alacak e-posta adresi.

Not: binis_istasyon_adi ve inis_istasyon_adi geçerli istasyon adları olmalıdır. Mevcut istasyon adları için stations.json dosyasına bakınız. Eğer istediğiniz istasyon yeni bir istasyonsa ve listede bulunmuyorsa aşağıdaki komutla istasyon listesini güncelleyebilirsiniz:

python3 util/fetch_stations.py

Komut stations.json içerisindeki istasyon listesini TCDD API üzerinden güncelleyecektir.

Örnek 1: 2 Şubat 2024 tarihli tüm seferleri kontrol eder.

binis_istasyon_adi = "İstanbul(Söğütlüçeşme)"
inis_istasyon_adi = "Ankara Gar"
date = "2024-02-02"

check_specific_hour = False

email_address = "sender_mail@outlook.com" 
email_password = "sender_password"
destination_address = "receiver@gmail.com"

sleep_time = 10

Örnek 2: 2 Şubat 2024 tarihli ve 08:04 kalkış saatli seferi kontrol eder.

binis_istasyon_adi = "İstanbul(Söğütlüçeşme)"
inis_istasyon_adi = "Ankara Gar"
date = "2024-02-02"

check_specific_hour = True
hour = "08:02"

email_address = "sender_mail@outlook.com" 
email_password = "sender_password"
destination_address = "receiver@gmail.com"

sleep_time = 10

Kullanım

Bilet bulucuyu başlatmak için main.py dosyasını çalıştırın:

python3 main.py

Araç, belirtilen yapılandırmaya göre periyodik olarak müsait koltukları kontrol edecek ve bir koltuk bulunduğunda e-posta ile bildirim gönderecektir.

Sorumluluk Reddi Beyanı

Bu araç yalnızca eğitimsel amaçlar içindir ve kesinlikle TCDD ile hiçbir ilişiği bulunmamaktadır. Lütfen sorumlu bir şekilde ve TCDD'nin hizmet şartlarına uygun olarak kullanın.