Source code for cata_log_hub.providers.metro

# SPDX-License-Identifier: AGPL-3.0-or-later
#
# Cata-Log - the central hub for digital flyers
# Copyright (C) 2026 David Aderbauer & The Cata-Log Contributors
#
# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU Affero General Public License as
# published by the Free Software Foundation, either version 3 of the
# License, or (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU Affero General Public License for more details.
#
# You should have received a copy of the GNU Affero General Public License
# along with this program. If not, see <https://www.gnu.org/licenses/>.

from calendar import Day
from datetime import datetime, time, timedelta
from typing import override
from urllib.parse import urljoin

from cata_log_hub.exceptions import PagesExhausted
from cata_log_hub.utils import page_numbers

from .base import Preview, Provider
from .regions import Germany




class MetroWochenangebote(Provider):
    """Provider class for Metro Wochenangebote current catalog."""

    uid = "metro-de"
    name = "Metro-Wochenangebote"
    url = "https://www.metro.de/angebote"
    region = Germany
    description = "Metro Wochenangebote"
    first_page_number = 0

    overview_url_format = "https://prospekte.metro.de/wochen-angebote-{valid_since:%y%m%d}-{valid_until:%y%m%d}/spreads.json"

    base_url = "https://prospekte.metro.de/"



    @override
    def _get_catalog_data(self) -> None:
        valid_since = self.get_valid_since()
        valid_until = self.get_valid_until() - timedelta(days=3)
        self.catalog_data = self._client.get(
            self.overview_url_format.format(
                valid_until=valid_until, valid_since=valid_since
            )
        ).json()




    @override
    def _get_page(self, page_number: page_numbers.PageNumber) -> bytes:
        double_page_number = page_number.as_double_page_number()
        try:
            image_url = self.catalog_data[double_page_number.number]["pages"][
                double_page_number.side
            ]["images"]["at2400"]
        except IndexError as error:
            raise PagesExhausted from error
        response = self._client.get(urljoin(self.base_url, image_url))
        return response.content




    @override
    def _get_valid_since(self) -> datetime:
        return datetime.combine(
            self._relevant_datetime
            - timedelta(days=self._relevant_datetime.weekday() - Day.MONDAY),
            time.min,
            self._relevant_datetime.tzinfo,
        )




    @override
    def _get_valid_until(self) -> datetime:
        return self._get_valid_since() + timedelta(days=7)






class MetroWochenangebotePreview(Preview, MetroWochenangebote):
    """Provider class for Metro Wochenangebote preview catalog for next week."""

    uid = MetroWochenangebote.uid + "-preview"
    name = MetroWochenangebote.name + "-Vorschau"
    description = MetroWochenangebote.description + " für nächste Woche"



    @override
    def _get_preview_timedelta(self) -> timedelta:
        return timedelta(days=7)