fasting-tracker/README.md

Türkiye'deki şehirler için iftar ve sahur saatlerini getiren, hatırlatma ve Discord Webhook desteği sunan Node.js paketi.

# Fasting Tracker 🌙  

✅ **Ücretsiz Kullanım!**
🕌 **Fasting Tracker**, Türkiye'deki şehirler için **iftar ve sahur saatlerini** hızlıca öğrenmenizi sağlayan bir **Node.js paketi**dir.  
Ayrıca **CLI, hatırlatıcı ve Discord Webhook desteği** ile geliyor!  

![NPM Version](https://img.shields.io/npm/v/fasting-tracker?color=blue&style=flat-square)
![Downloads](https://img.shields.io/npm/dt/fasting-tracker?color=green&style=flat-square)
![License](https://img.shields.io/npm/l/fasting-tracker?style=flat-square)

---


## 📦 Kurulum  

```sh
npm install fasting-tracker -g
```

---


## 🚀 Özellikler  
✅ **Şehir ismi girerek iftar ve sahur saatlerini öğrenme**  
✅ **Terminal üzerinden sorgulama (CLI desteği)**  
✅ **Otomatik iftar/sahur hatırlatıcı**  
✅ **Discord Webhook ile bildirim gönderme**  

---


## 🔥 Kullanım  

### 📌 **İftar ve Sahur Saatlerini Getirme**  

```js
const { getFastTrack } = require("fasting-tracker");

async function main() {
  const result = await getFastTrack("Istanbul");
  console.log(result);
}

main();
```

📌 **Örnek Çıktı:**  
```json
{
  "city": "Istanbul",
  "imsak": "04:50",
  "iftar": "19:35"
}
```

---


### ⏰ **İftar & Sahur Hatırlatıcısı**  

Belirttiğiniz şehir için iftar veya sahur saatinden belirli bir süre önce **otomatik bildirim** alabilirsiniz.  

```js
const { setReminder } = require("fasting-tracker");

setReminder("Istanbul", "iftar", 10);
```

📌 **Bu komut, İstanbul'da iftardan 10 dakika önce terminale hatırlatma mesajı gönderecektir.**  

---


### 🔔 **Discord Webhook ile Hatırlatma Gönderme**  

Hatırlatıcı mesajınızı **Discord kanalınıza otomatik gönderebilirsiniz!**  

```js
setReminder("Istanbul", "iftar", 10, "YOUR_DISCORD_WEBHOOK_URL");
```

📌 **Bu komut, iftardan 10 dakika önce verilen Discord webhook adresine mesaj gönderecektir.**  

---


### 🖥️ **CLI Kullanımı**  

Terminalden hızlıca sorgu yapabilirsiniz:  

```sh
npx fasting-tracker istanbul
```

📌 **Örnek Çıktı:**  
```
🌙 FastingTracker - İstanbul
🕓 Sahur: 04:50
🌅 İftar: 19:35
```

---


## 📜 Lisans  

Bu proje **MIT Lisansı** ile sunulmaktadır.  

🚀 **Hayırlı Ramazanlar dileriz!**  
```