Aplikacja do wyszukiwania filmów

Aplikacja do wyszukiwania filmów
Konsolowe narzędzie do wyszukiwania i eksportowania danych o filmach z bazy TMDb.

Repozytorium GitHub: https://github.com/fedyaqq34356/Movie-Search-App

Aplikacja do wyszukiwania filmów — narzędzie wiersza poleceń do pracy z bazą danych The Movie Database (TMDb). Aplikacja umożliwia wyszukiwanie filmów według gatunków, uzyskiwanie szczegółowych informacji i eksportowanie danych do plików tekstowych. Projekt demonstruje umiejętności pracy z REST API, architekturą modułową, przetwarzaniem danych i logowaniem.

Główne możliwości:
wyszukiwanie według gatunków, paginacja (1 strona = 20 filmów), eksport danych (tytuły, opisy, oceny, dostawcy), wsparcie dla regionów, logowanie operacji, obsługa błędów.

Używane technologie:
Python 3.7+, biblioteki requests, python-dotenv, logging. API TMDb v3, token Bearer. Zasady rozwoju: modułowość, czytelność, DRY.

Struktura projektu:
Movie-Search-App/
├── main.py # Punkt wejścia i koordynacja przepływu pracy
├── api.py # Żądania i odpowiedzi API TMDb
├── config.py # Konfiguracja i zmienne środowiskowe
├── display.py # Interfejs użytkownika i obsługa wejścia
├── export.py # Operacje zapisu do plików
├── logger.py # Konfiguracja logowania
├── .env # Poświadczenia API (nie śledzone)
├── requirements.txt # Zależności Pythona
└── README.md # Dokumentacja

Kluczowe decyzje:
przechowywanie tokenów w .env, opóźnienia między żądaniami (0.5 sek), zbieranie wszystkich typów dostawców (subskrypcja, darmowe, z reklamą, wynajem, zakup), wielopoziomowe logowanie (DEBUG, INFO, WARNING, ERROR), obsługa błędów z try-except i ponownymi próbami.

Przykłady użycia:
wybór gatunku, wprowadzenie liczby stron, eksport danych do plików (tytuły, opisy, oceny, dostawcy). Można zmieniać region i język w konfiguracji dla poprawnego wyświetlania dostawców.

Wydajność:
1 strona (20 filmów) ~1 sekunda, 10 stron ~10 sekund, 50 stron ~50 sekund. Niezawodność i skalowalność zapewnione, wsparcie do 500 stron, efektywna pamięć, minimalne obciążenie API.

Możliwe ulepszenia:
krótkoterminowe — eksport JSON, argumenty CLI, wsparcie dla seriali, buforowanie gatunków; długoterminowe — GUI, baza danych SQLite, równoległe żądania, wrapper REST API, testy jednostkowe i integracyjne.

Instalacja:
git clone https://github.com/fedyaqq34356/Movie-Search-App.git
cd Movie-Search-App
pip install -r requirements.txt

Linki:
GitHub https://github.com/fedyaqq34356/Movie-Search-App

Licencja:
GNU General Public License v3.0. Projekt jest wolny, można go używać, modyfikować i rozpowszechniać zgodnie z warunkami GPL v3.