🤖Newser - Discord News Bot

Bot Discordowy, który pobiera najnowsze wiadomości z NewsData.io i umożliwia ich redakcję za pomocą AI (Google Gemini). Użytkownicy mogą także zapisywać ulubione artykuły i przeglądać je później.

---

🧩 Funkcje

• !news <temat> – Wyszukaj najnowsze wiadomości na dany temat (domyślnie 3 artykuły)
• !news <temat> [liczba] – Wyszukaj określoną liczbę wiadomości (1–10) na dany temat
• !news redaguj <temat> – Pobierz wiadomości i zredaguj ich treść za pomocą AI
• !news redaguj <numer> – Zredaguj wiadomość z ostatnio wyświetlonych wyników
• !news dodaj <numer> – Dodaj wskazaną wiadomość z listy do ulubionych
• !news usun <numer> – Usuń wskazaną wiadomość z listy ulubionych
• !news ulubione – Zobacz swoje zapisane ulubione wiadomości

---

🚀 Jak uruchomić

1. Sklonuj repozytorium

   git clone https://github.com/Kvmyk/Newser.git
   cd Newser

2. Utwórz plik .env w katalogu newser-bot z taką zawartością, albo skorzystaj z pliku .env-template dostępnego w repozytorium:

   DISCORD_TOKEN=twoj_token_z_discorda
   NEWSDATA_API_KEY=twoj_klucz_z_newsdata.io
   GOOGLE_API_KEY=twoj_klucz_z_google_generative_ai

3. Zainstaluj zależności

   pip install -r requirements.txt

4. Uruchom bota

   python newser.py

---

🗂️ Plik .env-template

W projekcie znajduje się plik .env-template, który możesz wykorzystać jako wzór do stworzenia własnego pliku .env. Plik ten zawiera wszystkie wymagane zmienne środowiskowe, które należy uzupełnić przed uruchomieniem bota.

Jak użyć .env-template?

1. Skopiuj plik .env-template i zmień jego nazwę na .env:

   cp .env-template .env

2. Uzupełnij wartości zmiennych w pliku .env:

   DISCORD_TOKEN=twój_token_z_discorda
   NEWSDATA_API_KEY=twój_klucz_z_newsdata.io
   GOOGLE_API_KEY=twój_klucz_z_google_generative_ai
   

3. Upewnij się, że plik .env znajduje się w katalogu głównym projektu.

---

📦 Wymagane zależności

Plik requirements.txt powinien zawierać:

discord.py>=2.3.2
requests>=2.31.0
python-dotenv>=1.0.1
google-generativeai>=0.3.2
anyio
pytest-asyncio
pytest-trio
pytest-twisted

---

🐳 Uruchomienie w Dockerze

Jeśli chcesz uruchomić projekt w kontenerze Docker, wykonaj poniższe kroki:

1. Zbuduj obraz Dockera:

   docker build -t newser-bot .

2. Uruchom kontener:

   docker run --env-file .env -d --name newser-container newser-bot

---

🤖 Automatyzacja z Azure Pipelines

Projekt zawiera skonfigurowany plik azure-pipelines.yml, który umożliwia automatyzację procesów CI/CD. Dzięki temu możesz:

1. Uruchamiać testy jednostkowe i sprawdzać formatowanie kodu:

   • Testy są uruchamiane za pomocą pytest.
   • Formatowanie kodu jest sprawdzane za pomocą black.

2. Budować obraz Dockera:

   • Obraz Dockera jest tworzony i oznaczany unikalnym tagiem.

3. Publikować obraz Dockera:

   • Obraz jest przesyłany do zarejestrowanego rejestru kontenerów (np. Docker Hub).

4. Wdrażać aplikację:

   • Kontener Dockera jest uruchamiany na podstawie obrazu z rejestru.
   • Możesz wybrać operację wdrożenia: Install, Uninstall, Reinstall.

🚀 Jak skonfigurować Azure Pipelines?

1. Dodaj plik azure-pipelines.yml do repozytorium: Plik znajduje się już w katalogu projektu i jest gotowy do użycia.

2. Skonfiguruj zmienne środowiskowe w Azure Pipelines:

   • DISCORD_TOKEN: Twój token bota Discord.
   • NEWSDATA_API_KEY: Klucz API z NewsData.io.
   • GOOGLE_API_KEY: Klucz API z Google Generative AI.

3. Uruchom pipeline:

   • Pipeline automatycznie uruchomi się na gałęziach main i develop.

4. Monitoruj wyniki:

   • Wyniki testów i procesów budowania są dostępne w Azure DevOps.

---

🧠 Wykorzystywane API

• NewsData.io – agregator wiadomości z całego świata
• Google Gemini (Generative AI) – do redagowania wiadomości przez AI

---

💾 Informacje o danych

• Dane ulubionych wiadomości i ostatnich wyników są przechowywane w bazie danych

---

🪪 Licencja

MIT © 2025 — Jakub Kamionka