dominospl-promo 0.1.0

Scraper for Domino's Pizza Poland promotions

dominospl_promo — skaner promocji Domino's Pizza

Biblioteka Pythona i narzędzie CLI do pobierania aktualnych promocji pizzowych z dominospizza.pl.

🇬🇧 English version (README-EN.md)

Wymagania

pip install playwright pyyaml beautifulsoup4
playwright install chromium

Użycie jako biblioteka

from dominospl_promo import get_promotions

promos = get_promotions()

for promo in promos:
    print(promo["description"])
    print(promo["price"], "zł /", promo["pizzas"], "szt. →", promo["price_per_pizza"], "zł/pizza")

Struktura zwracanego słownika

Klucz	Typ	Opis
description	str	Tekst promocji (maks. 300 znaków)
price	float	Łączna cena w PLN
pizzas	int	Liczba pizz w ofercie
price_per_pizza	float	Cena za jedną pizzę

Wyniki posortowane rosnąco po price_per_pizza.

Użycie jako CLI

Opcje (config.yaml)

Pole	Opis
language	Język komunikatów: pl lub en
debug	Tryb debugowania parsera: true / false

Struktura projektu

dominospl_promo/
    __init__.py     # Publiczne API: get_promotions()
    scraper.py      # Pobieranie strony (Playwright)
    parser.py       # Parsowanie HTML
cli.py              # Interfejs wiersza poleceń
i18n.py             # Tłumaczenia (tylko CLI)
config.py           # Ładowanie konfiguracji (tylko CLI)
config.yaml