Skip to main content

No project description provided

Project description

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/-u and --password/-p arguments
  • TORONTO_HYDRO_USERNAME and TORONTO_HYDRO_PASSWORD environment 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

Project details


Release history Release notifications

This version

0.1.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for toronto-hydro-green-button, version 0.1.0
Filename, size File type Python version Upload date Hashes
Filename, size toronto-hydro-green-button-0.1.0.tar.gz (4.1 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page