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

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

@@ -0,0 +1,92 @@
+import logging
+from datetime import datetime
+
+import requests
+from bs4 import BeautifulSoup
+from waste_collection_schedule import Collection, Icons  # type: ignore[attr-defined]
+
+TITLE = "Wyndham City Council, Melbourne"
+DESCRIPTION = "Source for Wyndham City Council rubbish collection."
+URL = "https://wyndham.vic.gov.au"
+TEST_CASES = {
+    "Truganina South Primary School": {
+        "street_address": "3-19 Parkvista Drive TRUGANINA 3029"
+    },
+    "Westbourne Grammar School": {"street_address": "300 Sayers Road TRUGANINA 3029"},
+    "Werribee Mercy Hospital": {
+        "street_address": "300-310 Princes Highway WERRIBEE 3030"
+    },
+    "Wyndham Park Primary School": {
+        "street_address": "59-77 Kookaburra Avenue WERRIBEE 3030"
+    },
+}
+
+API_URL = "https://digital.wyndham.vic.gov.au/myWyndham/"
+ICON_MAP = {
+    "Green Waste": Icons.GARDEN,
+    "Garbage": Icons.GENERAL_WASTE,
+    "Recycling": Icons.RECYCLING,
+}
+
+_LOGGER = logging.getLogger(__name__)
+
+
+class Source:
+    def __init__(self, street_address):
+        self._street_address = street_address
+
+    def fetch(self):
+        session = requests.Session()
+        response = session.get(API_URL)
+        response.raise_for_status()
+        response = session.get(
+            "https://digital.wyndham.vic.gov.au/myWyndham/ajax/address-search-suggestions.asp?",
+            params={"ASEARCH": self._street_address},
+        )
+        response.raise_for_status()
+        html = response.content
+        property_address = BeautifulSoup(html, "html.parser").find("li").get_text()
+        _LOGGER.debug("Fetched Property Address: %s", property_address)
+        if (
+            property_address == "No match found."
+            or property_address.upper() != self._street_address.upper()
+        ):
+            raise Exception(
+                f"Address search for '{self._street_address}' returned no results. Check your address on "
+                f"https://digital.wyndham.vic.gov.au/myWyndham/ "
+            )
+
+        property_number = BeautifulSoup(html, "html.parser").find("span").get_text()
+        _LOGGER.debug("Fetched Property Number: %s", property_number)
+        response = session.get(
+            "https://digital.wyndham.vic.gov.au/myWyndham/init-map-data.asp",
+            params={
+                "propnum": property_number,
+                "radius": "1000",
+                "mapfeatures": "23,37,22,33,35",
+            },
+        )
+        response.raise_for_status()
+        wasteApiResult = response.content
+        soup = BeautifulSoup(wasteApiResult, "html.parser")
+        entries = []
+
+        for article in soup.findAll("div", {"class": "waste"}):
+            if article.get_text().startswith("Next"):
+                waste_type = (
+                    article.get_text()
+                    .strip()
+                    .split(":")[0][5:]
+                    .replace(" Collection", "")
+                )
+                _LOGGER.debug("Waste Type: %s", waste_type)
+                icon = ICON_MAP.get(waste_type)
+                _LOGGER.debug("Icon: %s", icon)
+                next_pickup_date = datetime.strptime(
+                    article.get_text().split(":")[1].strip(), "%A, %d %B %Y"
+                ).date()
+                _LOGGER.debug("Next Pickup Date: %s", next_pickup_date)
+                entries.append(
+                    Collection(date=next_pickup_date, t=waste_type, icon=icon)
+                )
+        return entries

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

@@ -0,0 +1,50 @@
+import requests
+from bs4 import BeautifulSoup
+from dateutil import parser
+from waste_collection_schedule import Collection, Icons
+
+TITLE = "Wyre Borough Council"  # Title will show up in README.md and info.md
+DESCRIPTION = "Source script for wyre.gov.uk"  # Describe your source
+URL = "https://www.wyre.gov.uk"  # Insert url to service homepage. URL will show up in README.md and info.md
+TEST_CASES = {"Test_001": {"uprn": "10094000847"}, "Test_002": {"uprn": "100010727065"}}
+HEADERS = {"user-agent": "Mozilla/5.0"}
+ICON_MAP = {
+    "Grey Bin": Icons.GENERAL_WASTE,
+    "Blue Bin": Icons.RECYCLING,
+    "Red Bin": Icons.RECYCLING,
+    "Green Bin": Icons.ORGANIC,
+}
+
+
+API_URL = "https://www.wyre.gov.uk/bincollections"
+
+
+class Source:
+    def __init__(self, uprn):
+        self._uprn = str(uprn).zfill(12)
+
+    def fetch(self):
+        response = requests.get(
+            "https://www.wyre.gov.uk/bincollections",
+            headers=HEADERS,
+            params={"uprn": self._uprn},
+        )
+        soup = BeautifulSoup(response.text, "html.parser")
+
+        entries = []
+
+        bins = soup.find_all("h3", class_="bin-collection-tasks__heading")
+        dates = soup.find_all("p", class_="bin-collection-tasks__date")
+        for date_tag, bin_tag in zip(dates, bins, strict=False):
+            bint = " ".join(bin_tag.text.split()[2:4])
+            date = parser.parse(date_tag.text).date()
+
+            entries.append(
+                Collection(
+                    date=date,
+                    t=bint,
+                    icon=ICON_MAP.get(bint),
+                )
+            )
+
+        return entries

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

@@ -0,0 +1,171 @@
+import logging
+import re
+from datetime import date, datetime, timedelta
+
+import requests
+from bs4 import BeautifulSoup
+from waste_collection_schedule import Collection, Icons  # type: ignore[attr-defined]
+
+TITLE = "Wyre Forest District Council"
+DESCRIPTION = "Source for wyreforestdc.gov.uk, Wyre Forest District Council, UK"
+URL = "https://www.wyreforestdc.gov.uk"
+
+TEST_CASES = {
+    "2 Kinver Avenue, Kidderminster": {
+        "street": "hilltop avenue",
+        "town": "BEWDLEY",
+        "garden_cutomer": "308072",
+    },
+}
+
+API_URLS = {
+    "waste": "https://forms.wyreforestdc.gov.uk/querybin.asp",
+    "garden_waste": "https://forms.wyreforestdc.gov.uk/GardenWasteChecker/Home/Details",
+}
+
+ICON_MAP = {
+    "rubbish (black bin)": Icons.GENERAL_WASTE,
+    "recycling (green bin)": Icons.RECYCLING,
+    "garden waste (brown bin)": Icons.BIO_KITCHEN,
+}
+
+DAYS = ["MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY", "SATURDAY", "SUNDAY"]
+
+# Next Rubbish Collection
+REGEX_GET_BIN_TYPE = re.compile(r"Next (.*?) Collection")
+# collection is on a WEDNESDAY and will be collected on the same week as your rubbish bin collection
+REGEX_GET_GARDEN_DAY = re.compile(
+    r"collection is on a\s*(.*?)\s*and will be collected on the same week as"
+)
+REGEX_GET_GARDEN_SAME_WEEK_AS = re.compile(
+    r"collected on the same week as your\s*(.*?)\s*(bin)?\s*collection"
+)
+
+_LOGGER = logging.getLogger(__name__)
+
+
+def get_date_by_weekday(weekday: str) -> date:
+    if weekday.strip().upper() == "TODAY":
+        return date.today()
+    if weekday.strip().upper() == "TOMORROW":
+        return date.today() + timedelta(days=1)
+
+    this_week = re.match("This (.*?)$", weekday, re.IGNORECASE)
+    next_week = re.match("Next (.*?)$", weekday, re.IGNORECASE)
+    if this_week:
+        weekday_idx = DAYS.index(this_week.group(1).upper())
+        offset = 0
+    elif next_week:
+        weekday_idx = DAYS.index(next_week.group(1).upper())
+        offset = 7
+    else:
+        # Try to parse as an absolute date (e.g., "07 January 2026")
+        try:
+            return datetime.strptime(weekday.strip(), "%d %B %Y").date()
+        except ValueError:
+            pass
+        # Try alternative format with abbreviated month (e.g., "07 Jan 2026")
+        try:
+            return datetime.strptime(weekday.strip(), "%d %b %Y").date()
+        except ValueError:
+            pass
+        raise ValueError(f"Invalid weekday: {weekday}")
+
+    d = date.today() + timedelta(days=offset)
+    while d.weekday() != weekday_idx:
+        d += timedelta(days=1)
+    return d
+
+
+def predict_next_collections(first_date: date, day_interval: int = 14):
+    return [first_date + timedelta(days=i * day_interval) for i in range(5)]
+
+
+class Source:
+    def __init__(self, street: str, town: str, garden_cutomer: str | int | None = None):
+        self._street = street.upper().strip()
+        self._town = town.upper().strip()
+        self._garden_cutomer = str(garden_cutomer).strip() if garden_cutomer else None
+
+    def get_garden_waste(self, type_to_day: dict[str, str]) -> list[Collection]:
+        data = {
+            "CUST_No": self._garden_cutomer,
+        }
+        r = requests.post(API_URLS["garden_waste"], data=data)
+        r.raise_for_status()
+        soup = BeautifulSoup(r.text, "html.parser")
+
+        day = REGEX_GET_GARDEN_DAY.search(soup.text)
+        same_week_as = REGEX_GET_GARDEN_SAME_WEEK_AS.search(soup.text)
+        if not day or not same_week_as:
+            raise ValueError(
+                f"Could not find garden waste collection days: {day} {same_week_as}"
+            )
+
+        relevant_coll_date = get_date_by_weekday(
+            type_to_day[same_week_as.group(1).lower()]
+        )
+        monday_of_garden_week = relevant_coll_date - timedelta(
+            days=relevant_coll_date.weekday()
+        )
+
+        garden_day = monday_of_garden_week + timedelta(DAYS.index(day.group(1).upper()))
+        entries = []
+        for coll_date in predict_next_collections(garden_day):
+            entries.append(
+                Collection(
+                    date=coll_date,
+                    icon=ICON_MAP.get("garden waste"),
+                    t="Garden waste",
+                )
+            )
+        return entries
+
+    def fetch(self) -> list[Collection]:
+        entries: list[Collection] = []
+        params = {
+            "txtStreetName": self._street,
+            "select": "yes",
+            "town": self._town,
+        }
+        r = requests.post(API_URLS["waste"], params=params)
+        r.raise_for_status()
+        type_to_day: dict[str, str] = {}
+
+        soup = BeautifulSoup(r.text, "html.parser")
+        coll_day_header_p = soup.find("p", text="Collection Day")
+
+        if not coll_day_header_p:
+            raise ValueError("Could not find collection day header")
+        coll_day_table = coll_day_header_p.find_parent("table")
+        if not coll_day_table:
+            raise ValueError("Could not find collection day table")
+        coll_day_rows = coll_day_table.find_all("tr")
+        if not len(coll_day_rows) == 2:
+            raise ValueError("Could not find collection day rows")
+
+        headings = [td.text.strip() for td in coll_day_rows[0].find_all("td")]
+        values = [td.text.strip() for td in coll_day_rows[1].find_all("td")]
+
+        for heading, value in list(zip(headings, values, strict=False)):
+            if REGEX_GET_BIN_TYPE.match(heading):
+                bin_type_match = REGEX_GET_BIN_TYPE.match(heading)
+                if not bin_type_match:
+                    raise ValueError(f"Could not find bin type in heading: {heading}")
+                bin_type = bin_type_match.group(1)
+
+                type_to_day[bin_type.lower()] = value
+
+                for coll_date in predict_next_collections(get_date_by_weekday(value)):
+                    entries.append(
+                        Collection(
+                            date=coll_date,
+                            icon=ICON_MAP.get(bin_type),
+                            t=bin_type,
+                        )
+                    )
+
+        if self._garden_cutomer:
+            entries += self.get_garden_waste(type_to_day)
+
+        return entries

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

@@ -0,0 +1,183 @@
+from datetime import datetime, timedelta
+
+import requests
+from waste_collection_schedule import Collection  # type: ignore[attr-defined]
+
+TITLE = "Ximmio"
+DESCRIPTION = "Source for Ximmio B.V. waste collection."
+URL = "https://www.ximmio.nl"
+
+
+def EXTRA_INFO():
+    return [
+        {
+            "title": s["title"],
+            "url": s["url"],
+            "default_params": {"company": s["company"]},
+        }
+        for s in SERVICE_MAP
+    ]
+
+
+TEST_CASES = {
+    "ACV Group": {"company": "acv", "post_code": "6721MH", "house_number": 1},
+    "Meerlanden": {"company": "meerlanden", "post_code": "1435BX", "house_number": 650},
+    "Almere": {"company": "almere", "post_code": "1318NG", "house_number": 15},
+    "Woerden": {
+        "company": "woerdenoudewater",
+        "post_code": "3441AX",
+        "house_number": 1,
+    },
+}
+
+
+SERVICE_URLS = {
+    "avalex": "https://wasteprod2api.ximmio.com",
+    "meerlanden": "https://wasteprod2api.ximmio.com",
+    "mijnblink": "https://wasteprod2api.ximmio.com",
+    "rad": "https://wasteprod2api.ximmio.com",
+    "westland": "https://wasteprod2api.ximmio.com",
+    "woerdenoudewater": "https://wasteprod2api.ximmio.com",
+}
+
+SERVICE_MAP = [
+    {
+        "title": "ACV Group",
+        "url": "https://www.acv-afvalkalender.nl/",
+        "uuid": "f8e2844a-095e-48f9-9f98-71fceb51d2c3",
+        "company": "acv",
+    },
+    {
+        "title": "Gemeente Almere",
+        "url": "https://www.almere.nl/",
+        "uuid": "53d8db94-7945-42fd-9742-9bbc71dbe4c1",
+        "company": "almere",
+    },
+    {
+        "title": "Area Afval",
+        "url": "https://www.area-afval.nl/",
+        "uuid": "adc418da-d19b-11e5-ab30-625662870761",
+        "company": "areareiniging",
+    },
+    {
+        "title": "Avalex",
+        "url": "https://www.avalex.nl/",
+        "uuid": "f7a74ad1-fdbf-4a43-9f91-44644f4d4222",
+        "company": "avalex",
+    },
+    {
+        "title": "Avri",
+        "url": "https://www.avri.nl/",
+        "uuid": "78cd4156-394b-413d-8936-d407e334559a",
+        "company": "avri",
+    },
+    {
+        "title": "Bar Afvalbeheer",
+        "url": "https://www.bar-afvalbeheer.nl/",
+        "uuid": "bb58e633-de14-4b2a-9941-5bc419f1c4b0",
+        "company": "bar",
+    },
+    {
+        "title": "Gemeente Hellendoorn",
+        "url": "https://www.hellendoorn.nl/",
+        "uuid": "24434f5b-7244-412b-9306-3a2bd1e22bc1",
+        "company": "hellendoorn",
+    },
+    {
+        "title": "Meerlanden",
+        "url": "https://meerlanden.nl/",
+        "uuid": "800bf8d7-6dd1-4490-ba9d-b419d6dc8a45",
+        "company": "meerlanden",
+    },
+    {
+        "title": "Gemeente Meppel",
+        "url": "https://www.meppel.nl/",
+        "uuid": "b7a594c7-2490-4413-88f9-94749a3ec62a",
+        "company": "meppel",
+    },
+    {
+        "title": "Mijn Blink",
+        "url": "https://mijnblink.nl/",
+        "uuid": "252d30d0-2e74-469c-8f1e-c0e2e434eb58",
+        "company": "mijnblink",
+    },
+    {
+        "title": "RAD BV",
+        "url": "https://www.radbv.nl",
+        "uuid": "13a2cad9-36d0-4b01-b877-efcb421a864d",
+        "company": "rad",
+    },
+    {
+        "title": "Twente Milieu",
+        "url": "https://www.twentemilieu.nl/",
+        "uuid": "8d97bb56-5afd-4cbc-a651-b4f7314264b4",
+        "company": "twentemilieu",
+    },
+    {
+        "title": "Waardlanden",
+        "url": "https://www.waardlanden.nl/",
+        "uuid": "942abcf6-3775-400d-ae5d-7380d728b23c",
+        "company": "waardlanden",
+    },
+    {
+        "title": "Gemeente Westland",
+        "url": "https://www.gemeentewestland.nl/",
+        "uuid": "6fc75608-126a-4a50-9241-a002ce8c8a6c",
+        "company": "westland",
+    },
+    {
+        "title": "Gemeente Venlo",
+        "url": "https://www.venlo.nl/",
+        "uuid": "280affe9-1428-443b-895a-b90431b8ca31",
+        "company": "venlo",
+    },
+    {
+        "title": "Woerden / Oudewater",
+        "url": "https://www.woerden.nl/",
+        "uuid": "06856f74-6826-4c6a-aabf-69bc9d20b5a6",
+        "company": "woerdenoudewater",
+    },
+]
+
+
+def get_service_name_map():
+    return {s["company"]: s["uuid"] for s in SERVICE_MAP}
+
+
+class Source:
+    def __init__(self, company, post_code, house_number):
+        self._post_code = post_code
+        self._house_number = house_number
+        self._url = SERVICE_URLS.get(company, "https://wasteapi.ximmio.com")
+        self._company_code = get_service_name_map()[company]
+
+    def fetch(self):
+        data = {
+            "postCode": self._post_code,
+            "houseNumber": self._house_number,
+            "companyCode": self._company_code,
+        }
+        r = requests.post(f"{self._url}/api/FetchAdress", data=data)
+        d = r.json()
+
+        dataList = d["dataList"][0]
+        data = {
+            "uniqueAddressID": dataList["UniqueId"],
+            "startDate": datetime.now().strftime("%Y-%m-%d"),
+            "endDate": (datetime.now() + timedelta(days=365)).strftime("%Y-%m-%d"),
+            "companyCode": self._company_code,
+            "community": dataList.get("Community", ""),
+        }
+        r = requests.post(f"{self._url}/api/GetCalendar", data=data)
+        d = r.json()
+
+        entries = []
+        for wasteType in d["dataList"]:
+            for date in wasteType["pickupDates"]:
+                entries.append(
+                    Collection(
+                        date=datetime.strptime(date, "%Y-%m-%dT%H:%M:%S").date(),
+                        t=wasteType["_pickupTypeText"],
+                    )
+                )
+        return entries

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

@@ -0,0 +1,40 @@
+from waste_collection_schedule import Collection, Icons  # type: ignore[attr-defined]
+from waste_collection_schedule.service.OpenCities import (
+    OpenCitiesClient,
+    OpenCitiesConfig,
+)
+
+TITLE = "Yarra Ranges Council"
+DESCRIPTION = "Source for Yarra Ranges Council rubbish collection."
+URL = "https://www.yarraranges.vic.gov.au"
+TEST_CASES = {
+    "Petstock Lilydale": {
+        "street_address": "5/447-449 Maroondah Highway Lilydale 3140"
+    },
+    "Beechworth Bakery Healesville": {
+        "street_address": "316 Maroondah Highway Healesville 3777"
+    },
+}
+
+ICON_MAP = {
+    "New weekly FOGO collection": Icons.BIO_KITCHEN,
+    "Rubbish Collection": Icons.GENERAL_WASTE,
+    "Recycling Collection": Icons.RECYCLING,
+}
+
+_CONFIG = OpenCitiesConfig(
+    domain="https://www.yarraranges.vic.gov.au",
+    argument_name="street_address",
+    warm_up_url="https://www.yarraranges.vic.gov.au/Environment/Waste/Find-your-waste-collection-and-burning-off-dates",
+    icon_keywords=ICON_MAP,
+    exclude_types=("Burning off",),
+)
+
+
+class Source:
+    def __init__(self, street_address: str):
+        self._street_address = street_address
+        self._client = OpenCitiesClient(_CONFIG)
+
+    def fetch(self) -> list[Collection]:
+        return self._client.fetch(address=self._street_address)