uk_bin_collection 0.152.1__py3-none-any.whl → 0.152.2__py3-none-any.whl

uk_bin_collection/uk_bin_collection/councils/CheshireEastCouncil.py

@@ -9,7 +9,6 @@ from uk_bin_collection.uk_bin_collection.get_bin_data import AbstractGetBinDataC
 This module provides bin collection data for Cheshire East Council.
 """
 
-
 class CouncilClass(AbstractGetBinDataClass):
     """
     A class to fetch and parse bin collection data for Cheshire East Council.

uk_bin_collection/uk_bin_collection/councils/NorthLincolnshireCouncil.py

@@ -46,7 +46,8 @@ class CouncilClass(AbstractGetBinDataClass):
                     "type": bin_type,
                     "collectionDate": get_next_occurrence_from_day_month(
                         datetime.strptime(
-                            c["BinCollectionDate"].replace(" (*)", "").strip()
+                            remove_ordinal_indicator_from_date_string(
+                                c["BinCollectionDate"].replace(" (*)", "").strip())
                             + " "
                             + datetime.now().strftime("%Y"),
                             "%A %d %B %Y",

{uk_bin_collection-0.152.1.dist-info → uk_bin_collection-0.152.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: uk_bin_collection
-Version: 0.152.1
+Version: 0.152.2
 Summary: Python Lib to collect UK Bin Data
 Author: Robert Bradley
 Author-email: robbrad182@gmail.com
@@ -398,6 +398,184 @@ Open the map viewer in VS Code:
 ![Test Results Map](test_results_map.png)
 
 ---
+## ICS Calendar Generation
+
+You can convert bin collection data to an ICS calendar file that can be imported into calendar applications like Google Calendar, Apple Calendar, Microsoft Outlook, etc.
+
+### Overview
+
+The `bin_to_ics.py` script allows you to:
+- Convert JSON output from bin collection data into ICS calendar events
+- Group multiple bin collections on the same day into a single event
+- Create all-day events (default) or timed events
+- Add optional reminders/alarms to events
+- Customize the calendar name
+
+### Requirements
+
+- Python 3.6 or higher
+- The `icalendar` package, which can be installed with:
+  ```bash
+  pip install icalendar
+  ```
+
+### Basic Usage
+
+```bash
+# Basic usage with stdin input and default output file (bin.ics)
+python bin_to_ics.py < bin_data.json
+
+# Specify input and output files
+python bin_to_ics.py -i bin_data.json -o my_calendar.ics
+
+# Custom calendar name
+python bin_to_ics.py -i bin_data.json -o my_calendar.ics -n "My Bin Collections"
+```
+
+### Options
+
+```
+--input, -i        Input JSON file (if not provided, read from stdin)
+--output, -o       Output ICS file (default: bin.ics)
+--name, -n         Calendar name (default: Bin Collections)
+--alarms, -a       Comma-separated list of alarm times before event (e.g., "1d,2h,30m")
+--no-all-day       Create timed events instead of all-day events
+```
+
+### Examples
+
+#### Adding Reminders (Alarms)
+
+Add reminders 1 day and 2 hours before each collection:
+
+```bash
+python bin_to_ics.py -i bin_data.json -a "1d,2h"
+```
+
+The time format supports:
+- Days: `1d`, `2day`, `3days`
+- Hours: `1h`, `2hour`, `3hours`
+- Minutes: `30m`, `45min`, `60mins`, `90minutes`
+
+#### Creating Timed Events
+
+By default, events are created as all-day events. To create timed events instead (default time: 7:00 AM):
+
+```bash
+python bin_to_ics.py -i bin_data.json --no-all-day
+```
+
+### Integration with Bin Collection Data Retriever
+
+You can pipe the output from the bin collection data retriever directly to the ICS generator. The required parameters (postcode, house number, UPRN, etc.) depend on the specific council implementation - refer to the [Quickstart](#quickstart) section above or check the [project wiki](https://github.com/robbrad/UKBinCollectionData/wiki) for details about your council.
+
+```bash
+python uk_bin_collection/uk_bin_collection/collect_data.py CouncilName "URL" [OPTIONS] | 
+  python bin_to_ics.py [OPTIONS]
+```
+
+#### Complete Example for a Council
+
+```bash
+python uk_bin_collection/uk_bin_collection/collect_data.py CouncilName \
+  "council_url" \
+  -p "YOUR_POSTCODE" \
+  -n "YOUR_HOUSE_NUMBER" \
+  -w "http://localhost:4444/wd/hub" |
+  python bin_to_ics.py \
+    --name "My Bin Collections" \
+    --output my_bins.ics \
+    --alarms "1d,12h"
+```
+
+This will:
+1. Fetch bin collection data for your address from your council's website
+2. Convert it to an ICS file named "my_bins.ics"
+3. Set the calendar name to "My Bin Collections"
+4. Add reminders 1 day and 12 hours before each collection
+
+For postcode lookup and UPRN information, please check the [UPRN Finder](#uprn-finder) section above.
+
+### Using the Calendar
+
+You have two options for using the generated ICS file:
+
+#### 1. Importing the Calendar
+
+You can directly import the ICS file into your calendar application:
+
+- **Google Calendar**: Go to Settings > Import & export > Import
+- **Apple Calendar**: File > Import
+- **Microsoft Outlook**: File > Open & Export > Import/Export > Import an iCalendar (.ics)
+
+Note: Importing creates a static copy of the calendar events. If bin collection dates change, you'll need to re-import the calendar.
+
+#### 2. Subscribing to the Calendar
+
+If you host the ICS file on a publicly accessible web server, you can subscribe to it as an internet calendar:
+
+- **Google Calendar**: Go to "Other calendars" > "+" > "From URL" > Enter the URL of your hosted ICS file
+- **Apple Calendar**: File > New Calendar Subscription > Enter the URL
+- **Microsoft Outlook**: File > Account Settings > Internet Calendars > New > Enter the URL
+
+Benefits of subscribing:
+- Calendar automatically updates when the source file changes
+- No need to manually re-import when bin collection dates change
+- Easily share the calendar with household members
+
+You can set up a cron job or scheduled task to regularly:
+1. Retrieve the latest bin collection data
+2. Generate a fresh ICS file
+3. Publish it to a web-accessible location
+
+### Additional Examples and Use Cases
+
+#### Automation with Cron Jobs
+
+Create a weekly update script on a Linux/Mac system:
+
+```bash
+#!/bin/bash
+# File: update_bin_calendar.sh
+
+# Set variables
+COUNCIL="YourCouncilName"
+COUNCIL_URL="https://your-council-website.gov.uk/bins"
+POSTCODE="YOUR_POSTCODE"
+HOUSE_NUMBER="YOUR_HOUSE_NUMBER"
+OUTPUT_DIR="/var/www/html/calendars"  # Web-accessible directory
+CALENDAR_NAME="Household Bins"
+
+# Ensure output directory exists
+mkdir -p $OUTPUT_DIR
+
+# Run the collector and generate the calendar
+cd /path/to/UKBinCollectionData && \
+python uk_bin_collection/uk_bin_collection/collect_data.py $COUNCIL "$COUNCIL_URL" \
+  -p "$POSTCODE" -n "$HOUSE_NUMBER" | \
+python bin_to_ics.py --name "$CALENDAR_NAME" --output "$OUTPUT_DIR/bins.ics" --alarms "1d,6h"
+
+# Add timestamp to show last update time
+echo "Calendar last updated: $(date)" > "$OUTPUT_DIR/last_update.txt"
+```
+
+Make the script executable:
+```bash
+chmod +x update_bin_calendar.sh
+```
+
+Add to crontab to run weekly (every Monday at 2 AM):
+```bash
+0 2 * * 1 /path/to/update_bin_calendar.sh
+```
+
+**Google Assistant/Alexa Integration**
+
+If you have your calendar connected to Google Calendar or Outlook, you can ask your smart assistant about upcoming bin collections:
+
+- "Hey Google, when is my next bin collection?"
+- "Alexa, what's on my calendar tomorrow?" (will include bin collections)
+
 ## Docker API Server
 We have created an API for this located under [uk_bin_collection_api_server](https://github.com/robbrad/UKBinCollectionData/uk_bin_collection_api_server)
 

{uk_bin_collection-0.152.1.dist-info → uk_bin_collection-0.152.2.dist-info}/RECORD

@@ -76,7 +76,7 @@ uk_bin_collection/uk_bin_collection/councils/CharnwoodBoroughCouncil.py,sha256=F
 uk_bin_collection/uk_bin_collection/councils/ChelmsfordCityCouncil.py,sha256=EB88D0MNJwuDZ2GX1ENc5maGYx17mnHTCtNl6s-v11E,5090
 uk_bin_collection/uk_bin_collection/councils/CheltenhamBoroughCouncil.py,sha256=bGxfMO4PpTd6ZTfm1hA9tmNUFDKGt20CMJolZ3K_CeM,16411
 uk_bin_collection/uk_bin_collection/councils/CherwellDistrictCouncil.py,sha256=VxTe9qk93MFgtELEgVrEz3W0vYaG_32EpPmky_b4j0k,2590
-uk_bin_collection/uk_bin_collection/councils/CheshireEastCouncil.py,sha256=wGklkIdrhcS8OH9QjrMnyjsrUzNr3Nb1WE0oacgEr78,2496
+uk_bin_collection/uk_bin_collection/councils/CheshireEastCouncil.py,sha256=RoybPitUD4u0xk4Kc9hXqHbUXCqGJG9Z4uRHWKj4ttk,2495
 uk_bin_collection/uk_bin_collection/councils/CheshireWestAndChesterCouncil.py,sha256=5mKZf22NgdyBY-SqV0c2q8b8IJobkoZrsfGEVUcxUyM,3544
 uk_bin_collection/uk_bin_collection/councils/ChesterfieldBoroughCouncil.py,sha256=mZiM8Ugm_OP0JkC5pLaQmi4i79mAp4SNNrcIdsREjHw,7198
 uk_bin_collection/uk_bin_collection/councils/ChichesterDistrictCouncil.py,sha256=bvtqXSZN64jSND0NxwzJ-WA9H49FwARQMGS3PlUSiUg,6311
@@ -216,7 +216,7 @@ uk_bin_collection/uk_bin_collection/councils/NorthEastLincs.py,sha256=fYf438VZIa
 uk_bin_collection/uk_bin_collection/councils/NorthHertfordshireDistrictCouncil.py,sha256=dFgvZqVKEVEP0zSPeh2s9xIWSCGbhYHpXn2U6Nk0HXM,2847
 uk_bin_collection/uk_bin_collection/councils/NorthKestevenDistrictCouncil.py,sha256=vYOCerJXr9LTP6F2wm4vpYNYbQaWNZ6yfHEQ33N_hTw,1681
 uk_bin_collection/uk_bin_collection/councils/NorthLanarkshireCouncil.py,sha256=npK1V8D3SLNTSSKkfEpEPvVgXDFyhH_tAsuGogsVKQY,1763
-uk_bin_collection/uk_bin_collection/councils/NorthLincolnshireCouncil.py,sha256=kCT82SU-etoGBehoIbbzGw_XS2YHllTw7lCCbdQj7UE,2467
+uk_bin_collection/uk_bin_collection/councils/NorthLincolnshireCouncil.py,sha256=MPzrfdo9YQFVlqBUOM-jDQkacz2DXnygLILQ_ojZeJo,2543
 uk_bin_collection/uk_bin_collection/councils/NorthNorfolkDistrictCouncil.py,sha256=VV_zqVZYv8ekXcUHhrBlTX_W5qLYE9IA3mT2xmrZqoI,4315
 uk_bin_collection/uk_bin_collection/councils/NorthNorthamptonshireCouncil.py,sha256=kcMN-5GBjYDM9F1BKfHoYeydub8SuDxHamJbSvJRZ68,2337
 uk_bin_collection/uk_bin_collection/councils/NorthSomersetCouncil.py,sha256=RNfvvmsBCTJ4GpkvuueF6d9UdJOhp5zzlhzTg2bTO_M,2937
@@ -346,8 +346,8 @@ uk_bin_collection/uk_bin_collection/councils/YorkCouncil.py,sha256=I2kBYMlsD4bId
 uk_bin_collection/uk_bin_collection/councils/council_class_template/councilclasstemplate.py,sha256=QD4v4xpsEE0QheR_fGaNOIRMc2FatcUfKkkhAhseyVU,1159
 uk_bin_collection/uk_bin_collection/create_new_council.py,sha256=m-IhmWmeWQlFsTZC4OxuFvtw5ZtB8EAJHxJTH4O59lQ,1536
 uk_bin_collection/uk_bin_collection/get_bin_data.py,sha256=YvmHfZqanwrJ8ToGch34x-L-7yPe31nB_x77_Mgl_vo,4545
-uk_bin_collection-0.152.1.dist-info/LICENSE,sha256=vABBUOzcrgfaTKpzeo-si9YVEun6juDkndqA8RKdKGs,1071
-uk_bin_collection-0.152.1.dist-info/METADATA,sha256=xnLFeqyv9EVCTF0Dlt3Sm4bkJvVr9LB-yljHL4f_xto,20914
-uk_bin_collection-0.152.1.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
-uk_bin_collection-0.152.1.dist-info/entry_points.txt,sha256=36WCSGMWSc916S3Hi1ZkazzDKHaJ6CD-4fCEFm5MIao,90
-uk_bin_collection-0.152.1.dist-info/RECORD,,
+uk_bin_collection-0.152.2.dist-info/LICENSE,sha256=vABBUOzcrgfaTKpzeo-si9YVEun6juDkndqA8RKdKGs,1071
+uk_bin_collection-0.152.2.dist-info/METADATA,sha256=TkzzP87OZ_9Mqtlf7CjxJSstnyQJveMZzCV_yXX7zHM,26688
+uk_bin_collection-0.152.2.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
+uk_bin_collection-0.152.2.dist-info/entry_points.txt,sha256=36WCSGMWSc916S3Hi1ZkazzDKHaJ6CD-4fCEFm5MIao,90
+uk_bin_collection-0.152.2.dist-info/RECORD,,