Source code for cata_log_hub.providers.norma

# 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 cata_log_hub.utils.dates import get_calendar_week_number
from cata_log_hub.utils.page_numbers import PageNumber

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



[docs]
class Norma(Provider):
    """Provider class for Norma catalog."""

    uid = "norma-de"
    name = "Norma"
    description = "Norma Angebote"
    region = Germany
    url = "https://www.norma-online.de/de/angebote/onlineprospekt/"

    catalog_url_format = "https://www.norma-online.de/de/angebote/online-prospekt/{relevant_datetime:%Y}-{week_number:02}_FG/files/page/{page_number}.jpg"


[docs]
    @override
    def _get_catalog_data(self) -> None:
        pass



[docs]
    @override
    def _get_page(self, page_number: PageNumber) -> bytes:
        response = self._client.get(
            url=self.catalog_url_format.format(
                relevant_datetime=self._relevant_datetime,
                week_number=get_calendar_week_number(
                    self._relevant_datetime, self.region.week_counting_startpoint
                ),
                page_number=page_number,
            ),
        )
        return response.content



[docs]
    @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,
        )



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





[docs]
class NormaPreview(Preview, Norma):
    """Provider class for Norma preview catalog for next week."""

    uid = Norma.uid + "-preview"
    name = Norma.name + "-Vorschau"
    description = Norma.description + " nächste Woche"


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





[docs]
class NormaPrepreview(NormaPreview):
    """Provider class for Norma preview catalog for second-next week."""

    uid = NormaPreview.uid + "-2"
    name = Norma.name + "-Vorvorschau"
    description = Norma.description + " übernächste Woche"


[docs]
    @override
    def _get_preview_timedelta(self) -> timedelta:
        return timedelta(days=14)





[docs]
class NormaRetrospect(NormaPreview):
    """Provider class for Norma retrospect catalog for last week."""

    uid = Norma.uid + "-retrospect"
    name = Norma.name + "-Rückschau"
    description = Norma.description + " letzte Woche"


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





[docs]
class NormaRetrospect2(NormaPreview):
    """Provider class for Norma retrospect catalog for second-last week."""

    uid = NormaRetrospect.uid + "-2"
    name = Norma.name + "-Rückrückschau"
    description = Norma.description + " vorletzte Woche"


[docs]
    @override
    def _get_preview_timedelta(self) -> timedelta:
        return timedelta(days=14)