Script when run goes the the Harlow Local Authority website collects the bin collection dates for a given UPRN then sends a notification to ntfy.sh if required. This script can either be run locally or as with this repository as a GitHub action.
This script can be run two ways either as a stand alone script that's scheduled using a cron job or as with this Repository a GitHub Action.
There is a workflow within this repository check-binday.yaml which is scheduled for early morning each day to check for bin collections. This workflow requires two secrets, firsly the UPRN to be checked for, and the ntfy.sh topic to publish the message to. Then you'll start recieving notifications when you'll need to put bins out and which bin it is.
The script requires additional tools to run, in order to load the webpage that provides the bin information from Harlow Local Authority which is the chromium-chromedriver, just run the command below.
sudo apt-get install chromium-chromedriver
Install Harlow Bindicator
pip install harlow-bindicator
The set up is very similar to how it's run on GitHub actions, with the requirement of a uprn and a ntfy.sh topic. Running the script is as simple as
harlow-bindicator--uprn "12379870" --topic "topic-name"
Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".
Don't forget to give the project a star! Thanks again!
- Fork the Project
- Create your Feature Branch (git checkout -b feature/AmazingFeature)
- Commit your Changes (git commit -m 'Add some AmazingFeature')
- Push to the Branch (git push origin feature/AmazingFeature)
- Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.