{"id":22026482,"url":"https://github.com/dp247/leedsbinidfinder","last_synced_at":"2025-08-21T03:06:02.591Z","repository":{"id":86138617,"uuid":"581354404","full_name":"dp247/LeedsBinIDFinder","owner":"dp247","description":"Search the premises.csv file to find the property reference for council managed bin collections in Leeds.","archived":false,"fork":false,"pushed_at":"2022-12-23T14:27:06.000Z","size":12,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-19T22:04:25.844Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dp247.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-12-23T00:22:06.000Z","updated_at":"2022-12-23T00:45:20.000Z","dependencies_parsed_at":null,"dependency_job_id":"4b36e4de-3dcf-4658-abec-35bc48c4f255","html_url":"https://github.com/dp247/LeedsBinIDFinder","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dp247%2FLeedsBinIDFinder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dp247%2FLeedsBinIDFinder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dp247%2FLeedsBinIDFinder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dp247%2FLeedsBinIDFinder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dp247","download_url":"https://codeload.github.com/dp247/LeedsBinIDFinder/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245090875,"owners_count":20559298,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-30T07:28:00.246Z","updated_at":"2025-03-23T11:15:39.051Z","avatar_url":"https://github.com/dp247.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Leeds Bins Property ID Finder\nSearch the premises.csv file hosted by [LCC/Data Mill North](https://datamillnorth.org/dataset/household-waste-collections) to find a property's unique reference (different to the actual UPRN).\nThis is used in the collections.csv to find bin collections for a property.\n\nIntended for use with the Leeds scraper in [UK Bin Collection Data](https://github.com/robbrad/UKBinCollectionData).\n\n# Setup\n1) Download a zip of this repo from the `Code...` menu and extract to a folder somewhere on your computer.\n2) Open your favorite terminal/CMD and run `pip install -r requirements.txt` to install the necessary packages.\n\n# Usage\n```commandline\npython bins.py\nusage: Leeds Bins Property ID Finder [-h] [-p POSTCODE] [-n NUMBER] [-o {json,txt}]\n\nSearch the premises.csv file hosted by LCC/Data Mill North to find a property's unique reference (different to the\nactual UPRN). This is used in the collections.csv to find bin collections for a property.\n\noptions:\n  -h, --help                            show this help message and exit\n  -p POSTCODE, --postcode POSTCODE      Postcode: remove any spaces\n  -n NUMBER, --number NUMBER            House number or name\n  -o {json,txt}, --output {json,txt}    Choice of json or txt for output\n```\n## Automatic\nThe script has support for argparse, which can be used to pass a postcode and house number/name at runtime to bypass\nthe interactive prompts:\n```commandline\npython bins.py -p LS18BB -n 4   # Runs the script with postcode as \"LS1 8BB\" and house number 4\n```\nThe output format can be changed between json and txt as well, by passing `-o json` for JSON or `-o txt` for plain text.\n\n## Interactive\nThe basic way of running the script is:\n```commandline\npython bins.py\n```\nThis will cause the script to run in interactive mode, which will require your postcode and house number being entered\nat prompts.\n\n## Notes\n- The script will only work for *household* properties whose waste management is provided by LCC.\n- Internet is needed to run the script:\n    - To open the hosted csv\n    - To verify and format the given postcode with [Postcodes.io](https://postcodes.io/). This makes it easier to check it exists\n      and match the format to the one used in the CSV. No data is otherwise processed or retained.\n- Most people will only see one result for their property, but if the script cannot find an exact match for your address, it may return multiple results.\n  This depends on how the data is stored in the CSV - it first tries to find exact matches in the PAON and SAON columns, but will then find any for the given postcode.\n- The necessary ID is the leftmost number in the results table.\n\n# Issues\nIf you encounter an issue with the script, please open a [new issue](https://github.com/dp247/LeedsBinIDFinder/issues/new), including any messages or data.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdp247%2Fleedsbinidfinder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdp247%2Fleedsbinidfinder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdp247%2Fleedsbinidfinder/lists"}