toronto-hydro-green-button
Export Green Button (ESPI) energy usage data from your Toronto Hydro account.
Toronto Hydro offers a Green Button XML export through the customer portal, but does not offer programmatic API access. This script logs into the dashboard with Selenium, then downloads the report with Requests.
Requirements
- a Toronto Hydro account
- Python 3.6+
- Firefox 57+ or Google Chrome and ChromeDriver
Installation
Install with pip:
pip install toronto-hydro-green-button
Usage
The script needs your username and password to log into the dashboard. It will check, in order of precedence:
--username/-uand--password/-pargumentsTORONTO_HYDRO_USERNAMEandTORONTO_HYDRO_PASSWORDenvironment variables- prompt input
Use --start-date and --end-date to query data between two dates (inclusive).
$ toronto-hydro-green-button --start-date 2019-11-01 --end-date 2019-11-31
If ChromeDriver is installed, the script attempts to use it by default. Otherwise it falls back on headless Firefox. ChromeDriver was slightly faster in my limited testing.
Run toronto-hydro-green-button --help for additional usage information.
Tips
Toronto Hydro usage data lags by 2–3 days. This script defaults to querying data from two days ago.
If you run this script frequently, you may not always see fresh data. It should be sufficient to run it daily.
License
MIT
Metadata
Release files for toronto-hydro-green-button 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| toronto-hydro-green-button-0.1.0.tar.gz | 4.1 kB | Without provenance | Details for toronto-hydro-green-button-0.1.0.tar.gz |
Security for toronto-hydro-green-button 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.