@camstack/addon-waste-collections 0.0.0-stage → 0.1.1

package/python/vendor/waste_collection_schedule/source/ecoszczecin_pl.py

@@ -0,0 +1,135 @@
+from datetime import datetime
+
+import requests
+from waste_collection_schedule import Collection, Icons  # type: ignore[attr-defined]
+from waste_collection_schedule.exceptions import SourceArgumentNotFoundWithSuggestions
+
+TITLE = "EcoSzczecin"
+DESCRIPTION = "Source for waste collection schedules in Szczecin, Poland, provided by ecoszczecin.pl."
+URL = "https://ecoszczecin.pl"
+COUNTRY = "pl"
+TEST_CASES = {
+    "Tczewska 7A": {"street": "TCZEWSKA", "house_number": "7A"},
+    "Aleja Piastów 1": {"street": "ALEJA PIASTÓW", "house_number": "1"},
+    "Bolesława Krzywoustego 1": {
+        "street": "Bolesława Krzywoustego",
+        "house_number": "1",
+    },
+}
+
+API_URL = "https://api.ecoszczecin.pl/api/v1"
+LOCATION = "SZCZECIN"
+
+ICON_MAP = {
+    "Odpady zmieszane": Icons.GENERAL_WASTE,
+    "Bioodpady": Icons.ORGANIC,
+    "Metale i tworzywa sztuczne": Icons.PLASTIC_PACKAGING,
+    "Papier": Icons.PAPER,
+    "Szkło": Icons.GLASS,
+    "Odpady wielkogabarytowe": Icons.BULKY,
+}
+
+PARAM_TRANSLATIONS = {
+    "en": {
+        "street": "Street",
+        "house_number": "House Number",
+    },
+}
+
+PARAM_DESCRIPTIONS = {
+    "en": {
+        "street": (
+            "Street name in Szczecin, as shown on ecoszczecin.pl "
+            "(e.g. 'TCZEWSKA'). Not case-sensitive."
+        ),
+        "house_number": (
+            "House number for the given street, as shown on ecoszczecin.pl (e.g. '7A')."
+        ),
+    },
+}
+
+HOW_TO_GET_ARGUMENTS_DESCRIPTION = {
+    "en": (
+        "Open https://ecoszczecin.pl/harmonogramy/, choose your street and "
+        "house number from the dropdowns, and copy their values exactly as "
+        "shown."
+    ),
+}
+
+
+class Source:
+    def __init__(self, street: str, house_number: str):
+        self._street = street.strip()
+        self._house_number = house_number.strip()
+        self._session = requests.Session()
+        self._session.headers.update({"User-Agent": "Mozilla/5.0"})
+
+    def _get_streets(self) -> list[str]:
+        response = self._session.get(f"{API_URL}/search/locations", timeout=30)
+        response.raise_for_status()
+        return response.json().get("data", [])
+
+    def _resolve_street(self) -> str:
+        streets = self._get_streets()
+        target = self._street.strip().casefold()
+        for street in streets:
+            if street.casefold() == target:
+                return street
+        raise SourceArgumentNotFoundWithSuggestions(
+            "street", self._street, suggestions=streets
+        )
+
+    def _get_house_numbers(self, street: str) -> list[str]:
+        response = self._session.get(
+            f"{API_URL}/search/number",
+            params={"filter[location]": LOCATION, "filter[street]": street},
+            timeout=30,
+        )
+        response.raise_for_status()
+        return response.json().get("data", [])
+
+    def _resolve_house_number(self, street: str) -> str:
+        numbers = self._get_house_numbers(street)
+        target = self._house_number.strip().casefold()
+        for number in numbers:
+            if number.casefold() == target:
+                return number
+        raise SourceArgumentNotFoundWithSuggestions(
+            "house_number", self._house_number, suggestions=numbers
+        )
+
+    def fetch(self) -> list[Collection]:
+        street = self._resolve_street()
+        house_number = self._resolve_house_number(street)
+
+        response = self._session.get(
+            f"{API_URL}/search/calendar",
+            params={
+                "filter[location]": LOCATION,
+                "filter[street]": street,
+                "filter[number]": house_number,
+            },
+            timeout=30,
+        )
+        response.raise_for_status()
+        data = response.json()
+
+        calendar = data.get("calendar")
+        entries: list[Collection] = []
+        if not isinstance(calendar, dict):
+            return entries
+
+        for months in calendar.values():
+            for days in months.values():
+                for day in days:
+                    collection_date = datetime.strptime(day["date"], "%Y-%m-%d").date()
+                    for waste_type in day.get("types", []):
+                        entries.append(
+                            Collection(
+                                date=collection_date,
+                                t=waste_type,
+                                icon=ICON_MAP.get(waste_type),
+                            )
+                        )
+
+        return entries

package/python/vendor/waste_collection_schedule/source/edlitz_at.py

@@ -0,0 +1,21 @@
+from waste_collection_schedule import Icons  # type: ignore[attr-defined]
+from waste_collection_schedule.service.RiSKommunalAT import RiSKommunalSource
+
+TITLE = "Marktgemeinde Edlitz"
+DESCRIPTION = "Source for Marktgemeinde Edlitz, AT"
+URL = "https://edlitz.at"
+COUNTRY = "at"
+TEST_CASES = {"TestSource": {}}
+ICON_MAP = {
+    "Biomüllabfuhr": Icons.BIO_KITCHEN,
+    "Papier Tonne": Icons.PAPER,
+    "Grüne Tonne": Icons.RECYCLING,
+    "Gelber Sack": Icons.PLASTIC_PACKAGING,
+    "Restmüll": Icons.GENERAL_WASTE,
+    "Restmüll mit Panoramastraße": Icons.GENERAL_WASTE,
+}
+
+
+class Source(RiSKommunalSource):
+    BASE_URL = "https://www.edlitz.at"
+    ICON_MAP = ICON_MAP

package/python/vendor/waste_collection_schedule/source/edpevent_se.py

@@ -0,0 +1,409 @@
+import json
+import logging
+from datetime import datetime
+
+import requests
+from waste_collection_schedule import Collection, Icons  # type: ignore[attr-defined]
+from waste_collection_schedule.exceptions import (
+    SourceArgumentException,
+    SourceArgumentExceptionMultiple,
+    SourceArgumentNotFoundWithSuggestions,
+)
+
+TITLE = "EDPEvent - Multi Source"
+DESCRIPTION = "Source for all EDPEvent waste collection sources. This included multiple municipalities in Sweden."
+URL = "https://www.edpevent.se"
+TEST_CASES = {
+    "https://edpmypage.roslagsvatten.se/FutureWebOS/SimpleWastePickup, Andromedavägen 1, Åkersberga": {
+        "street_address": "Andromedavägen 1",
+        "url": "https://edpmypage.roslagsvatten.se/FutureWebOS/SimpleWastePickup",
+    },
+    "Boden - Bodens Kommun": {
+        "street_address": "KYRKGATAN 24",
+        "service_provider": "boden",
+    },
+    "Boden - Gymnasiet": {
+        "street_address": "IDROTTSGATAN 4",
+        "url": "https://edpmobile.boden.se/FutureWeb/SimpleWastePickup",
+    },
+    "Uppsalavatten - Test1": {
+        "street_address": "SADELVÄGEN 1",
+        "url": "https://futureweb.uppsalavatten.se/Uppsala/FutureWeb/SimpleWastePickup",
+    },
+    "Uppsalavatten - Test2": {
+        "street_address": "BJÖRKLINGE-GRÄNBY 33",
+        "service_provider": "uppsalavatten",
+    },
+    "Uppsalavatten - Test3": {
+        "street_address": "BJÖRKLINGE-GRÄNBY 20",
+        "service_provider": "uppsalavatten",
+    },
+    "SSAM - Home": {
+        "street_address": "Asteroidvägen 1, Växjö",
+        "service_provider": "ssam",
+    },
+    "SSAM - Slambrunn": {
+        "street_address": "Svanebro Ormesberga, Ör",
+        "service_provider": "ssam",
+    },
+    "Skelleftea - Test1": {
+        "street_address": "Frögatan 76 -150",
+        "service_provider": "skelleftea",
+    },
+    "Borås - Test1": {
+        "street_address": "Länghemsgatan 10",
+        "service_provider": "boras",
+    },
+    "Borås - Test2": {
+        "street_address": "Yttre Näs 1, Seglora",
+        "service_provider": "boras",
+    },
+    "Borås - Test3": {
+        "street_address": "Stora Hyberg 1, Brämhult",
+        "url": "https://kundportal.borasem.se/EDPFutureWeb/SimpleWastePickup",
+    },
+    "Kretslopp Sydost Hägnevägen 1, Sävsjö": {
+        "street_address": "Hägnevägen 1, Sävsjö",
+        "service_provider": "kretslopp-sydost",
+    },
+    "marks-kommun": {
+        "street_address": "Habyvägen 13, skene",
+        "service_provider": "marks-kommun",
+    },
+    "Lycksele": {
+        "street_address": "STORGATAN   efter nr 103, LYCKSELE",
+        "service_provider": "lycksele-kommun",
+    },
+    "Kiruna - Tekniska Verken": {
+        "street_address": "Värmeverksvägen 12, Kiruna",
+        "service_provider": "kiruna-kommun",
+    },
+    "Lidköping - Stadshuset": {
+        "street_address": "SKARAGATAN 8 -12, STADSHUSET",
+        "service_provider": "lidkopings-kommun",
+    },
+    "Stenungsund - Kommunhuset": {
+        "street_address": "Strandvägen 15, Stenungsund",
+        "service_provider": "stenungsund-kommun",
+    },
+    "Orust - Kommunhuset": {
+        "street_address": "ÅVÄGEN 2 -6, Henån",
+        "service_provider": "orust-kommun",
+    },
+    "Ljungby kommun - kommunhuset": {
+        "street_address": "Olofsgatan 9 / Kommunhuset, Ljungby",
+        "service_provider": "ljungby-kommun",
+    },
+    "Örebro - Kommunstyrelsen": {
+        "street_address": "Ringgatan 32",
+        "service_provider": "orebro-kommun",
+    },
+    "Herrljunga": {
+        "street_address": "Storgatan 5, Herrljunga",
+        "url": "https://edpfuture.remondis.se/EDPFutureWeb/SimpleWastePickup",
+    },
+    "Vårgårda": {
+        "street_address": "Vårgårda Herrgård, VÅRGÅRDA",
+        "url": "https://edpfuture.remondis.se/EDPFutureWeb/SimpleWastePickup",
+    },
+    "Vafab Miljö - Test": {
+        "street_address": "Gasverksgatan 7, Västerås",
+        "service_provider": "vafabmiljo",
+    },
+    "NVOA - Nacka (Fogdevägen)": {
+        "street_address": "Fogdevägen 13, Saltsjö-Duvnäs",
+        "service_provider": "nvoa",
+    },
+    "Danderyd - Banérvägen 6": {
+        "street_address": "Banérvägen 6",
+        "service_provider": "danderyd",
+    },
+}
+
+COUNTRY = "se"
+_LOGGER = logging.getLogger(__name__)
+
+# This maps the icon based on the waste type
+ICON_MAP = {
+    "Brännbart": Icons.GENERAL_WASTE,
+    "Matavfall tätt": Icons.BIO_KITCHEN,
+    "Deponi": Icons.RECYCLING,
+    "Restavfall": Icons.GENERAL_WASTE,
+    "Matavfall": Icons.BIO_KITCHEN,
+    "Slam": Icons.GENERAL_WASTE,
+    "Trädgårdsavfall": Icons.GARDEN,
+    "Glas/Glas/Metal": Icons.RECYCLING,
+    "Papper/Plast": Icons.RECYCLING,
+}
+
+# This can be used to rename the waste types to something more user friendly
+WASTE_TYPE_REPLACEMENTS = {
+    "FNI1": "Kärl 1",
+    "FNI2": "Kärl 2",
+}
+
+MONTH_MAP = {
+    "Jan": 1,
+    "Feb": 2,
+    "Mar": 3,
+    "Apr": 4,
+    "Maj": 5,
+    "Jun": 6,
+    "Jul": 7,
+    "Aug": 8,
+    "Sep": 9,
+    "Okt": 10,
+    "Nov": 11,
+    "Dec": 12,
+}
+
+SERVICE_PROVIDERS = {
+    "skelleftea": {
+        "title": "Skellefteå",
+        "url": "https://skelleftea.se",
+        "api_url": "https://wwwtk2.skelleftea.se/FutureWeb/SimpleWastePickup",
+    },
+    "boden": {
+        "title": "Boden",
+        "url": "https://boden.se",
+        "api_url": "https://edpmobile.boden.se/FutureWeb/SimpleWastePickup",
+    },
+    "ssam": {
+        "title": "SSAM Södra Smalånds Avfall & Miljö",
+        "url": "https://ssam.se",
+        "api_url": "https://edpfuture.ssam.se/FutureWeb/SimpleWastePickup",
+    },
+    "uppsalavatten": {
+        "title": "Uppsala Vatten",
+        "url": "https://uppsalavatten.se",
+        "api_url": "https://futureweb.uppsalavatten.se/Uppsala/FutureWeb/SimpleWastePickup",
+    },
+    "boras": {
+        "title": "Borås Energi och Miljö",
+        "url": "https://www.borasem.se",
+        "api_url": "https://kundportal.borasem.se/EDPFutureWeb/SimpleWastePickup",
+    },
+    "roslagsvatten": {
+        "title": "Roslagsvatten",
+        "url": "https://roslagsvatten.se",
+        "api_url": "https://edpmypage.roslagsvatten.se/FutureWebOS/SimpleWastePickup",
+    },
+    "kretslopp-sydost": {
+        "title": "Kretslopp Sydost",
+        "url": "https://kretsloppsydost.se",
+        "api_url": "https://kundportal.kretsloppsydost.se/FutureWeb/SimpleWastePickup",
+    },
+    "marks-kommun": {
+        "title": "Marks kommun",
+        "url": "https://www.mark.se",
+        "api_url": "https://va-renhallning.mark.se/FutureWeb/SimpleWastePickup",
+    },
+    "lycksele-kommun": {
+        "title": "Lycksele Kommun",
+        "url": "https://www.lycksele.se",
+        "api_url": "https://future.lycksele.se/FutureWeb/SimpleWastePickup",
+    },
+    "kiruna-kommun": {
+        "title": "Kiruna - Tekniska Verken",
+        "url": "https://www.tekniskaverkenikiruna.se",
+        "api_url": "https://kund.tekniskaverkenikiruna.se/FutureWebBasic/SimpleWastePickup",
+    },
+    "lidkopings-kommun": {
+        "title": "Lidköpings kommun",
+        "url": "https://lidkoping.se",
+        "api_url": "https://futureweb.lidkoping.se/FutureWebBasic/SimpleWastePickup",
+    },
+    "stenungsund-kommun": {
+        "title": "Stenungsunds kommun",
+        "url": "https://www.stenungsund.se/",
+        "api_url": "https://futureweb.stenungsund.se/FutureWebBasic/SimpleWastePickup",
+    },
+    "orust-kommun": {
+        "title": "Orust kommun",
+        "url": "https://orust.se/",
+        "api_url": "https://va-renhallning-minasidor.orust.se/FutureWebBasic/SimpleWastePickup",
+    },
+    "ljungby-kommun": {
+        "title": "Ljungby kommun",
+        "url": "https://ljungby.se/",
+        "api_url": "https://edpwebb.ljungby.se/FutureWeb/SimpleWastePickup",
+    },
+    "orebro-kommun": {
+        "title": "Örebro kommun",
+        "url": "https://www.orebro.se",
+        "api_url": "https://futureweb.orebro.se/FutureWeb/SimpleWastePickup",
+    },
+    "herrljunga-vargarda": {
+        "title": "Herrljunga & Vårgårda kommun",
+        "url": "https://www.remondisrecycling.se/hushallsavfall/herrljunga-vargarda/",
+        "api_url": "https://edpfuture.remondis.se/EDPFutureWeb/SimpleWastePickup",
+    },
+    "vafabmiljo": {
+        "title": "Vafab Miljö",
+        "url": "https://vafabmiljo.se",
+        "api_url": "https://services.vafabmiljo.se/FutureWebVKFHus/SimpleWastePickup",
+    },
+    "nvoa": {
+        "title": "NVOA - Nacka Vatten och Avfall",
+        "url": "https://www.nacka.se/nackavattenavfall/avfall/sophamtning/tomningsdag/",
+        "api_url": "https://futureweb.nvoa.se/EDP/FutureWebBasic/SimpleWastePickup",
+    },
+    "danderyd": {
+        "title": "Danderyds kommun",
+        "url": "https://www.danderyd.se",
+        "api_url": "https://future.danderyd.se/Danderyd/EDPFutureweb/SimpleWastePickup",
+    },
+}
+
+EXTRA_INFO = [
+    {
+        "title": data["title"],
+        "url": data["url"],
+        "default_params": {"service_provider": provider},
+    }
+    for provider, data in SERVICE_PROVIDERS.items()
+]
+
+
+class Source:
+    def __init__(
+        self,
+        street_address: str,
+        service_provider: str | None = None,
+        url: str | None = None,
+    ):
+        self._street_address = street_address
+        self._url = url
+        # Check if the user provided a url
+        if url is None:
+            # Raise an exception if the user did not provide a service provider (or url)
+            if service_provider is None:
+                raise SourceArgumentExceptionMultiple(
+                    ["service_provider", "url"],
+                    "You must provide either a service provider or a url",
+                )
+            # Get the api url using the service provider
+            self._url = SERVICE_PROVIDERS.get(service_provider.lower(), {}).get(
+                "api_url"
+            )
+        if self._url is None:
+            raise SourceArgumentNotFoundWithSuggestions(
+                "service_provider",
+                service_provider,
+                SERVICE_PROVIDERS.keys(),
+            )
+        # Remove trailing slash from the url if present
+        if self._url.endswith("/"):
+            self._url = self._url[:-1]
+
+    def fetch(self):
+        params = {"searchText": self._street_address}
+        # Use the street address to find the full street address with the building ID
+        searchUrl = self._url + "/SearchAdress"
+        # Search for the address
+        response = requests.post(searchUrl, params=params, timeout=30)
+
+        address_data = json.loads(response.text)
+        address = None
+        # Make sure the response is valid and contains data
+        if address_data and len(address_data) > 0:
+            # Check if the request was successful
+            if address_data["Succeeded"]:
+                # The request can be successful but still not return any buildings at the specified address
+                if len(address_data["Buildings"]) > 0:
+                    address = address_data["Buildings"][0]
+                else:
+                    raise SourceArgumentException(
+                        "street_address",
+                        f"No returned building address for: {self._street_address}",
+                    )
+            else:
+                raise SourceArgumentException(
+                    "street_address",
+                    f"The server failed to fetch the building data for: {self._street_address}",
+                )
+
+        # Raise exception if all the above checks failed
+        if not address:
+            raise SourceArgumentException(
+                "street_address",
+                f"Failed to find building address for: {self._street_address}",
+            )
+
+        # Use the address we got to get the waste collection schedule
+        params = {"address": address}
+        getUrl = self._url + "/GetWastePickupSchedule"
+        # Get the waste collection schedule
+        response = requests.get(getUrl, params=params, timeout=30)
+
+        data = json.loads(response.text)
+
+        entries = []
+        for item in data["RhServices"]:
+            waste_type = ""
+            next_pickup = item["NextWastePickup"]
+
+            # When no explicit pickup date is provided (e.g. for sludge/slam),
+            # fall back to the week number given in the frequency, e.g. "Vecka 27".
+            if not next_pickup and "v" in item["WastePickupFrequency"].lower():
+                next_pickup = item["WastePickupFrequency"]
+            try:
+                if "v" in next_pickup.lower():
+                    date_parts = next_pickup.split()
+                    # "Vecka 27": derive a date from the ISO week number.
+                    if date_parts[0].lower() == "vecka":
+                        current_year = datetime.now().year
+                        next_pickup_date = datetime.strptime(
+                            f"{current_year} {date_parts[1]} 1", "%Y %W %w"
+                        ).date()
+                    # "v32 Aug 2024": derive a date from week, month and year.
+                    elif date_parts[1] in MONTH_MAP:
+                        month = MONTH_MAP[date_parts[1]]
+                        date_joined = "-".join(
+                            [date_parts[0], str(month), date_parts[2]]
+                        )
+                        next_pickup_date = datetime.strptime(
+                            date_joined, "v%W-%m-%Y"
+                        ).date()
+                    else:
+                        _LOGGER.warning("Failed to parse pickup date: %s", next_pickup)
+                        continue
+                elif not next_pickup:
+                    continue
+                else:
+                    next_pickup_date = datetime.strptime(next_pickup, "%Y-%m-%d").date()
+            except ValueError:
+                # In some cases the date is just a month, so parse this as the
+                # first of the month to at least get something close
+                try:
+                    next_pickup_date = datetime.strptime(next_pickup, "%b %Y").date()
+                except ValueError as month_parse_error:
+                    _LOGGER.warning(
+                        "Failed to parse date %s, %s,",
+                        next_pickup,
+                        str(month_parse_error),
+                    )
+                    continue
+
+            waste_type_prefix = item["WasteType"]
+            if item["WasteType"] in WASTE_TYPE_REPLACEMENTS:
+                waste_type_prefix = WASTE_TYPE_REPLACEMENTS[item["WasteType"]]
+            waste_type = (
+                waste_type_prefix
+                + ", "
+                + (item["BinType"]["ContainerType"] or "")
+                + " "
+                + (str(item["BinType"]["Size"]) or "")
+                + (item["BinType"]["Unit"] or "")
+            )
+            # Get the icon for the waste type, default to help icon if not found
+            icon = ICON_MAP.get(item["WasteType"], "mdi:help")
+
+            found = any(
+                x.date == next_pickup_date and x.type == waste_type for x in entries
+            )
+            if not found:
+                entries.append(
+                    Collection(date=next_pickup_date, t=waste_type, icon=icon)
+                )
+        return entries

package/python/vendor/waste_collection_schedule/source/eggelsberg_at.py

@@ -0,0 +1,73 @@
+from typing import ClassVar
+
+from waste_collection_schedule import Icons  # type: ignore[attr-defined]
+from waste_collection_schedule.exceptions import SourceArgumentNotFoundWithSuggestions
+from waste_collection_schedule.service.RiSKommunalAT import RiSKommunalSource
+
+TITLE = "Marktgemeinde Eggelsberg"
+DESCRIPTION = "Source for Marktgemeinde Eggelsberg waste collection."
+URL = "https://www.eggelsberg.at"
+COUNTRY = "at"
+
+TEST_CASES = {
+    "Zone A": {"zone": "A"},
+    "Zone B": {"zone": "B"},
+}
+
+ICON_MAP = {
+    "Bioabfall": Icons.BIO_KITCHEN,
+    "Altpapier": Icons.PAPER,
+    "Gelber Sack": Icons.PLASTIC_PACKAGING,
+    "Restabfall 2-wöchentlich": Icons.GENERAL_WASTE,
+    "Restabfall 4-wöchentlich": Icons.GENERAL_WASTE,
+    "Restabfall 6-wöchentlich": Icons.GENERAL_WASTE,
+}
+
+HOW_TO_GET_ARGUMENTS_DESCRIPTION = {
+    "en": "Select your zone (A or B). This determines your Bioabfall (organic waste) "
+    "collection schedule. All other waste types apply to all zones.",
+    "de": "Wählen Sie Ihre Zone (A oder B). Dies bestimmt Ihren Bioabfall-"
+    "Abholplan. Alle anderen Abfallarten gelten für alle Zonen.",
+}
+
+PARAM_DESCRIPTIONS = {
+    "en": {
+        "zone": "Collection zone (A or B)",
+    },
+    "de": {
+        "zone": "Abholzone (A oder B)",
+    },
+}
+
+PARAM_TRANSLATIONS = {
+    "en": {
+        "zone": "Zone",
+    },
+    "de": {
+        "zone": "Zone",
+    },
+}
+
+VALID_ZONES = ["A", "B"]
+
+
+class Source(RiSKommunalSource):
+    BASE_URL = "https://www.eggelsberg.at"
+    ICON_MAP = ICON_MAP
+    VDATUM_TODAY = True
+    QUERY_PARAMS: ClassVar = {
+        "bdatum": "31.12.9999",
+        "blnr": "",
+        "gnr_search": "0",
+        "menuonr": "224085238",
+        "umkreis": "",
+        "useronr": "0",
+    }
+
+    def __init__(self, zone: str):
+        zone = zone.strip().upper()
+        if zone not in VALID_ZONES:
+            raise SourceArgumentNotFoundWithSuggestions(
+                "zone", zone, suggestions=VALID_ZONES
+            )
+        super().__init__(zone=zone)