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

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

@@ -0,0 +1,284 @@
+import datetime
+
+import requests
+from waste_collection_schedule import Collection, Icons  # type: ignore[attr-defined]
+from waste_collection_schedule.exceptions import (
+    SourceArgumentNotFound,
+    SourceArgumentNotFoundWithSuggestions,
+)
+
+TITLE = "Heimat-Info"
+DESCRIPTION = "Source for Heimat-Info (heimat-info.de) waste collection schedules."
+URL = "https://www.heimat-info.de"
+COUNTRY = "de"
+
+TEST_CASES = {
+    "Gründau – Breitenborn": {
+        "commune": "gruendau",
+        "area": "Breitenborn",
+    },
+    "Gründau – Gettenbach": {
+        "commune": "gruendau",
+        "area": "Gettenbach",
+    },
+    "Salgen": {
+        "commune": "salgen",
+        "area": "Salgen",
+    },
+}
+
+PARAM_TRANSLATIONS = {
+    "en": {
+        "commune": "Commune (slug)",
+        "area": "Collection area",
+    },
+    "de": {
+        "commune": "Gemeinde (Slug)",
+        "area": "Abholbereich",
+    },
+}
+
+PARAM_DESCRIPTIONS = {
+    "en": {
+        "commune": "The URL slug of the commune on heimat-info.de (e.g. 'gruendau'). Find it in the URL https://www.heimat-info.de/gemeinden/<slug>/abfallkalender.",
+        "area": "The name of the collection area / district (e.g. 'Breitenborn'). Leave empty if the commune has only one area.",
+    },
+    "de": {
+        "commune": "Der URL-Slug der Gemeinde auf heimat-info.de (z. B. 'gruendau'). Zu finden in der URL https://www.heimat-info.de/gemeinden/<slug>/abfallkalender.",
+        "area": "Der Name des Abholbereichs (z. B. 'Breitenborn'). Leer lassen, wenn die Gemeinde nur einen Bereich hat.",
+    },
+}
+
+HOW_TO_GET_ARGUMENTS_DESCRIPTION = {
+    "en": "Open https://www.heimat-info.de, search for your commune, and navigate to Abfallkalender. The commune slug is the part of the URL after '/gemeinden/'. If the calendar shows multiple collection areas, pick yours from the list.",
+    "de": "Öffnen Sie https://www.heimat-info.de, suchen Sie Ihre Gemeinde und navigieren Sie zum Abfallkalender. Der Gemeinde-Slug ist der Teil der URL nach '/gemeinden/'. Falls der Kalender mehrere Abholbereiche zeigt, wählen Sie Ihren aus der Liste.",
+}
+
+ICON_MAP = {
+    "Residual": Icons.GENERAL_WASTE,
+    "Organic": Icons.ORGANIC,
+    "Paper": Icons.PAPER,
+    "Recyclable": Icons.RECYCLING,
+    "BulkyWaste": Icons.BULKY,
+    "HazardousWaste": Icons.HAZARDOUS,
+}
+
+API_BASE = "https://heimatinfo-api-platform.azurewebsites.net"
+
+EXTRA_INFO = [
+    {
+        "title": "Aholfing",
+        "url": "https://www.heimat-info.de/gemeinden/aholfing/abfallkalender",
+        "country": "de",
+        "default_params": {"commune": "aholfing"},
+    },
+    {
+        "title": "Bellenberg",
+        "url": "https://www.heimat-info.de/gemeinden/bellenberg/abfallkalender",
+        "country": "de",
+        "default_params": {"commune": "bellenberg"},
+    },
+    {
+        "title": "Buch",
+        "url": "https://www.heimat-info.de/gemeinden/buch/abfallkalender",
+        "country": "de",
+        "default_params": {"commune": "buch"},
+    },
+    {
+        "title": "Eisingen",
+        "url": "https://www.heimat-info.de/gemeinden/eisingen/abfallkalender",
+        "country": "de",
+        "default_params": {"commune": "eisingen"},
+    },
+    {
+        "title": "Feichten a. d. Alz",
+        "url": "https://www.heimat-info.de/gemeinden/feichten-alz/abfallkalender",
+        "country": "de",
+        "default_params": {"commune": "feichten-alz"},
+    },
+    {
+        "title": "Gaimersheim",
+        "url": "https://www.heimat-info.de/gemeinden/gaimersheim/abfallkalender",
+        "country": "de",
+        "default_params": {"commune": "gaimersheim"},
+    },
+    {
+        "title": "Gemeinde Gründau",
+        "url": "https://www.heimat-info.de/gemeinden/gruendau/abfallkalender",
+        "country": "de",
+        "default_params": {"commune": "gruendau"},
+    },
+    {
+        "title": "Halsbach",
+        "url": "https://www.heimat-info.de/gemeinden/halsbach/abfallkalender",
+        "country": "de",
+        "default_params": {"commune": "halsbach"},
+    },
+    {
+        "title": "Hürtgenwald",
+        "url": "https://www.heimat-info.de/gemeinden/hurtgenwald/abfallkalender",
+        "country": "de",
+        "default_params": {"commune": "hurtgenwald"},
+    },
+    {
+        "title": "Kastl (Lkr. AÖ)",
+        "url": "https://www.heimat-info.de/gemeinden/kastl/abfallkalender",
+        "country": "de",
+        "default_params": {"commune": "kastl"},
+    },
+    {
+        "title": "Markt Kastl (Lauterachtal)",
+        "url": "https://www.heimat-info.de/gemeinden/kastl-lauterachtal/abfallkalender",
+        "country": "de",
+        "default_params": {"commune": "kastl-lauterachtal"},
+    },
+    {
+        "title": "Kirchweidach",
+        "url": "https://www.heimat-info.de/gemeinden/kirchweidach/abfallkalender",
+        "country": "de",
+        "default_params": {"commune": "kirchweidach"},
+    },
+    {
+        "title": "Kupferberg",
+        "url": "https://www.heimat-info.de/gemeinden/kupferberg/abfallkalender",
+        "country": "de",
+        "default_params": {"commune": "kupferberg"},
+    },
+    {
+        "title": "Loiching",
+        "url": "https://www.heimat-info.de/gemeinden/loiching/abfallkalender",
+        "country": "de",
+        "default_params": {"commune": "loiching"},
+    },
+    {
+        "title": "Oberrieden",
+        "url": "https://www.heimat-info.de/gemeinden/oberrieden/abfallkalender",
+        "country": "de",
+        "default_params": {"commune": "oberrieden"},
+    },
+    {
+        "title": "Oberroth",
+        "url": "https://www.heimat-info.de/gemeinden/oberroth/abfallkalender",
+        "country": "de",
+        "default_params": {"commune": "oberroth"},
+    },
+    {
+        "title": "Pastetten",
+        "url": "https://www.heimat-info.de/gemeinden/pastetten/abfallkalender",
+        "country": "de",
+        "default_params": {"commune": "pastetten"},
+    },
+    {
+        "title": "Pfaffenhausen",
+        "url": "https://www.heimat-info.de/gemeinden/pfaffenhausen/abfallkalender",
+        "country": "de",
+        "default_params": {"commune": "pfaffenhausen"},
+    },
+    {
+        "title": "Roggenburg",
+        "url": "https://www.heimat-info.de/gemeinden/roggenburg/abfallkalender",
+        "country": "de",
+        "default_params": {"commune": "roggenburg"},
+    },
+    {
+        "title": "Röttenbach",
+        "url": "https://www.heimat-info.de/gemeinden/rottenbach/abfallkalender",
+        "country": "de",
+        "default_params": {"commune": "rottenbach"},
+    },
+    {
+        "title": "Salgen",
+        "url": "https://www.heimat-info.de/gemeinden/salgen/abfallkalender",
+        "country": "de",
+        "default_params": {"commune": "salgen"},
+    },
+    {
+        "title": "Schäftlarn",
+        "url": "https://www.heimat-info.de/gemeinden/schaftlarn/abfallkalender",
+        "country": "de",
+        "default_params": {"commune": "schaftlarn"},
+    },
+    {
+        "title": "Trausnitz",
+        "url": "https://www.heimat-info.de/gemeinden/trausnitz/abfallkalender",
+        "country": "de",
+        "default_params": {"commune": "trausnitz"},
+    },
+    {
+        "title": "Unterroth",
+        "url": "https://www.heimat-info.de/gemeinden/unterroth/abfallkalender",
+        "country": "de",
+        "default_params": {"commune": "unterroth"},
+    },
+    {
+        "title": "Wutach",
+        "url": "https://www.heimat-info.de/gemeinden/wutach/abfallkalender",
+        "country": "de",
+        "default_params": {"commune": "wutach"},
+    },
+]
+
+
+class Source:
+    def __init__(self, commune: str, area: str | None = None):
+        self._commune = commune.strip().lower()
+        self._area = area.strip() if area else None
+
+    def fetch(self) -> list[Collection]:
+        # Fetch all pickup areas for this commune
+        r = requests.get(
+            f"{API_BASE}/communes/{self._commune}/garbagepickupareas",
+            timeout=30,
+        )
+        if r.status_code == 404:
+            raise SourceArgumentNotFound("commune", self._commune)
+        r.raise_for_status()
+
+        areas = r.json()
+        if not areas:
+            raise SourceArgumentNotFound("commune", self._commune)
+
+        # Resolve requested area
+        if self._area is None:
+            if len(areas) == 1:
+                area_id = areas[0]["id"]
+            else:
+                area_names = [a["name"] for a in areas]
+                raise SourceArgumentNotFoundWithSuggestions(
+                    "area",
+                    "",
+                    area_names,
+                )
+        else:
+            match = next(
+                (a for a in areas if a["name"].lower() == self._area.lower()), None
+            )
+            if match is None:
+                area_names = [a["name"] for a in areas]
+                raise SourceArgumentNotFoundWithSuggestions(
+                    "area", self._area, area_names
+                )
+            area_id = match["id"]
+
+        # Fetch pickup dates for the resolved area
+        r2 = requests.get(
+            f"{API_BASE}/communes/{self._commune}/garbagepickupareas/{area_id}/garbagepickupdates",
+            timeout=30,
+        )
+        r2.raise_for_status()
+
+        entries: list[Collection] = []
+        for item in r2.json():
+            date = datetime.datetime.fromisoformat(
+                item["date"].replace("Z", "+00:00")
+            ).date()
+            waste_type: str = item["type"]
+            entries.append(
+                Collection(
+                    date=date,
+                    t=waste_type,
+                    icon=ICON_MAP.get(waste_type),
+                )
+            )
+
+        return entries

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

@@ -0,0 +1,90 @@
+import json
+from datetime import datetime
+
+import requests
+from waste_collection_schedule import Collection, Icons  # type: ignore[attr-defined]
+
+TITLE = "Heinz-Entsorgung (Landkreis Freising)"
+DESCRIPTION = "Source for Heinz-Entsorgung (Landkreis Freising) waste collection."
+URL = "https://abfallkalender.heinz-entsorgung.de/"
+TEST_CASES = {
+    "Test_Freising": {
+        "param": "yesJWYk53alJXaiMiOMJWYk53alJXagMnRlJXapNmbicCLvJnciQiOBJGblxncoNXYzVWZi4CLzJHdhJ3clNjIioWTv93c0Nici4CLqJWYyhjIiojMyASN9J"
+    }
+}
+
+HOW_TO_GET_ARGUMENTS_DESCRIPTION = {
+    "en": """To get the required parameter:
+1. Open https://abfallkalender.heinz-entsorgung.de/ in your browser
+2. Open the browser's Developer Tools (F12)
+3. Go to the 'Network' tab
+4. Select your location (Ort) and street (Straße)
+5. Look for a request to 'api-enttermine.heinz-entsorgung.net/termine'
+6. Copy the 'param' value from the URL query string
+7. Use this value as the 'param' argument
+
+Note: The parameter is encrypted and specific to your location and street selection.
+""",
+    "de": """So erhalten Sie den erforderlichen Parameter:
+1. Öffnen Sie https://abfallkalender.heinz-entsorgung.de/ in Ihrem Browser
+2. Öffnen Sie die Entwicklertools des Browsers (F12)
+3. Gehen Sie zum Tab 'Netzwerk'
+4. Wählen Sie Ihren Ort und Ihre Straße aus
+5. Suchen Sie nach einer Anfrage an 'api-enttermine.heinz-entsorgung.net/termine'
+6. Kopieren Sie den 'param'-Wert aus der URL-Abfragezeichenfolge
+7. Verwenden Sie diesen Wert als 'param'-Argument
+
+Hinweis: Der Parameter ist verschlüsselt und spezifisch für Ihre Orts- und Straßenauswahl.
+""",
+}
+
+ICON_MAP = {
+    "Restabfall": Icons.GENERAL_WASTE,
+    "Gelber Sack": Icons.PLASTIC_PACKAGING,
+    "Bioabfall": Icons.BIO_KITCHEN,
+    "BIO": Icons.ORGANIC,
+    "Papier": Icons.PAPER,
+    "Problemmüll": Icons.HAZARDOUS,
+    "Sperrmüll": Icons.BULKY,
+}
+
+API_URL = "https://api-enttermine.heinz-entsorgung.net/termine"
+
+
+class Source:
+    def __init__(self, param: str):
+        self._param = param
+
+    def fetch(self) -> list[Collection]:
+        # Make API request
+        r = requests.get(API_URL, params={"param": self._param})
+        r.raise_for_status()
+
+        data = json.loads(r.text)
+
+        entries = []
+        for item in data:
+            date_str = item.get("termin")
+            if not date_str:
+                continue
+
+            # Parse date (format: YYYY-MM-DD)
+            date = datetime.strptime(date_str, "%Y-%m-%d").date()
+
+            # Get waste type
+            waste_type = item.get("fraktion", "Unknown")
+
+            # Get additional info if available
+            zusatz = item.get("zusatz", "")
+            if zusatz:
+                waste_type = f"{waste_type} ({zusatz})"
+
+            entries.append(
+                Collection(
+                    date=date,
+                    t=waste_type,
+                    icon=ICON_MAP.get(waste_type.split(" (")[0], "mdi:trash-can"),
+                )
+            )
+
+        return entries

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

@@ -0,0 +1,190 @@
+import logging
+from datetime import datetime
+
+import requests
+from bs4 import BeautifulSoup
+from waste_collection_schedule import Collection, Icons
+from waste_collection_schedule.exceptions import (
+    SourceArgumentNotFound,
+    SourceArgumentNotFoundWithSuggestions,
+)
+
+TITLE = "Herefordshire City Council"
+DESCRIPTION = "Source for herefordshire.gov.uk services for hereford"
+URL = "https://herefordshire.gov.uk"
+TEST_CASES = {
+    "houseNumber": {"post_code": "hr49js", "number": "52"},
+    "uprn": {"post_code": "hr49js", "number": "200002607460"},
+}
+
+PARAM_DESCRIPTIONS = {
+    "en": {
+        "post_code": "Postcode of the property, e.g. HR4 9JS",
+        "number": (
+            "House number, house name, or UPRN (Unique Property Reference "
+            "Number) of the property. If your property only has a name and "
+            "no number, enter the name; if it is still not found, the error "
+            "message will list the full addresses found for your postcode "
+            "so you can copy the UPRN or exact wording from there."
+        ),
+    },
+}
+
+PARAM_TRANSLATIONS = {
+    "en": {
+        "post_code": "Postcode",
+        "number": "House Number / Name / UPRN",
+    },
+}
+
+API_URLS = {
+    "address_search": "https://trsewmllv7.execute-api.eu-west-2.amazonaws.com/dev/address",
+    "collection": "https://www.herefordshire.gov.uk/rubbish-recycling/check-bin-collection-day",  # ?blpu_uprn=200002607454",
+}
+HEADER = {"user-agent": "Mozilla/5.0"}
+ICON_MAP = {
+    "General": Icons.GENERAL_WASTE,
+    "Recycling": Icons.RECYCLING,
+    "Garden": Icons.GARDEN,
+}
+
+_LOGGER = logging.getLogger(__name__)
+
+
+class Source:
+    def __init__(self, post_code: str, number: str):
+        self._post_code = post_code
+        # keep the value exactly as entered (only trim whitespace) so error
+        # messages show the user's own input; all matching below is done
+        # case-insensitively.
+        self._number = str(number).strip()
+
+    def fetch(self):
+        # fetch location id
+        r = requests.get(
+            API_URLS["address_search"],
+            headers=HEADER,
+            params={"postcode": self._post_code, "type": "standard"},
+        )
+        r.raise_for_status()
+        addresses = r.json()
+        if (
+            (addresses.get("error"))
+            or "results" not in addresses
+            or len(addresses["results"]) == 0
+        ):
+            raise SourceArgumentNotFound("post_code", self._post_code)
+
+        results = addresses["results"]
+
+        # `number` may be a classic house number (PAO_START_NUMBER), a house
+        # name (PAO_TEXT for named properties, or SAO_TEXT for named
+        # sub-units such as flats), or the property's UPRN directly -
+        # accepting the UPRN lets users bypass name/number matching entirely
+        # when they already know it (e.g. from findmyaddress.co.uk).
+        target = self._number.lower()
+
+        def matches_exact(lpi: dict) -> bool:
+            for field in ("UPRN", "PAO_TEXT", "PAO_START_NUMBER", "SAO_TEXT"):
+                value = lpi.get(field)
+                if value is not None and str(value).strip().lower() == target:
+                    return True
+            return False
+
+        address_ids = [x for x in results if matches_exact(x["LPI"])]
+
+        # Fall back to a substring match against the full address string.
+        # This helps house-name-only properties whose name is not cleanly
+        # isolated into PAO_TEXT/SAO_TEXT (e.g. extra punctuation/spacing).
+        if not address_ids and len(target) >= 3:
+            address_ids = [
+                x
+                for x in results
+                if x["LPI"].get("ADDRESS")
+                and target in str(x["LPI"]["ADDRESS"]).lower()
+            ]
+
+        if len(address_ids) == 0:
+            # Show the full address strings (rather than bare fragments) so
+            # users without a house number can identify their property and
+            # either enter its house name verbatim or its UPRN instead.
+            suggestions = sorted(
+                {
+                    x["LPI"]["ADDRESS"]
+                    for x in results
+                    if x["LPI"].get("ADDRESS") is not None
+                }
+            )
+            raise SourceArgumentNotFoundWithSuggestions(
+                "number", self._number, suggestions
+            )
+
+        q = str(API_URLS["collection"])
+        r = requests.get(
+            q, headers=HEADER, params={"blpu_uprn": address_ids[0]["LPI"]["UPRN"]}
+        )
+        r.raise_for_status()
+
+        # --- Updated DOM parsing (site changed) ---
+        soup = BeautifulSoup(r.text, "html.parser")
+        container = soup.find(id="binCollectionDetails")
+        if not container:
+            # fall back to legacy wrapper if council reverts
+            legacy = soup.find(id="wasteCollectionDates")
+            if not legacy:
+                raise Exception(
+                    "Could not find bin collection section on the council page (IDs changed)."
+                )
+            container = legacy
+
+        # Extract first <li> date under each heading
+        def first_li_after_heading(heading_keyword: str) -> list[str]:
+            # find <h3> that contains the keyword, then take first <li> in the next <ul>
+            resulsts = []
+            for h3 in container.find_all("h3"):
+                title = h3.get_text(strip=True).lower()
+                if heading_keyword.lower() in title:
+                    ul = h3.find_next_sibling("ul")
+                    if ul:
+                        lis = ul.find_all("li")
+                        for li in lis:
+                            # strip any "(next collection)" etc.
+                            text = li.get_text(strip=True)
+                            cut = text.find("(")
+                            resulsts.append(
+                                text[:cut].strip() if cut != -1 else text.strip()
+                            )
+            return resulsts
+
+        sections = (
+            ("General", "General rubbish", first_li_after_heading("general rubbish")),
+            ("Recycling", "Recycling", first_li_after_heading("recycling")),
+            ("Garden", "Garden", first_li_after_heading("garden waste")),
+        )
+
+        entries = []
+        for icon_key, waste_type, date_strs in sections:
+            for date_str in date_strs:
+                try:
+                    date = datetime.strptime(date_str, "%A %d %B %Y").date()
+                except ValueError:
+                    # Not every heading lists dates. Properties without a garden
+                    # waste subscription get a link to the calendar instead, so
+                    # skip anything that is not a date rather than failing.
+                    _LOGGER.debug(
+                        "Skipping non-date entry under %s: %r", waste_type, date_str
+                    )
+                    continue
+                entries.append(
+                    Collection(
+                        date=date,
+                        t=waste_type,
+                        icon=ICON_MAP[icon_key],
+                    ),
+                )
+        if not entries:
+            raise Exception(
+                "No collection dates found for this address, make sure there are any concrete collection dates listed on the website for this address."
+            )
+
+        return entries

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

@@ -0,0 +1,41 @@
+from typing import ClassVar
+
+from waste_collection_schedule import Icons  # type: ignore[attr-defined]
+from waste_collection_schedule.service.RiSKommunalAT import RiSKommunalSource
+
+TITLE = "Herzogsdorf"
+DESCRIPTION = "Source for Herzogsdorf, Austria."
+URL = "https://www.herzogsdorf.ooe.gv.at"
+COUNTRY = "at"
+
+TEST_CASES = {
+    "Herzogsdorf": {},
+}
+
+ICON_MAP = {
+    "Restabfall wöchentlich": Icons.GENERAL_WASTE,
+    "Restabfall 2-wöchentlich": Icons.GENERAL_WASTE,
+    "Restabfall 4-wöchentlich": Icons.GENERAL_WASTE,
+    "Restabfall 6-wöchentlich": Icons.GENERAL_WASTE,
+    "Restabfall": Icons.GENERAL_WASTE,
+    "Restmüll": Icons.GENERAL_WASTE,
+    "Bioabfall": Icons.BIO_KITCHEN,
+    "Biomüll": Icons.BIO_KITCHEN,
+    "Altpapier": Icons.PAPER,
+    "Papier": Icons.PAPER,
+    "Gelber Sack": Icons.PLASTIC_PACKAGING,
+    "Gelbe Tonne": Icons.PLASTIC_PACKAGING,
+    "Sperrmüll": Icons.BULKY,
+    "Altglas": Icons.GLASS,
+    "Problemstoff": Icons.HAZARDOUS,
+}
+
+
+class Source(RiSKommunalSource):
+    BASE_URL = "https://www.herzogsdorf.ooe.gv.at"
+    ICON_MAP = ICON_MAP
+    RAISE_ON_EMPTY = True
+    QUERY_PARAMS: ClassVar = {
+        "menuonr": "225680057",
+        "bdatum": "31.12.9999",
+    }