opower
A Python library and command-line tool for getting historical and forecasted usage/cost data from utilities that use opower.com.
This library is used by the Opower integration in Home Assistant.
Supported Utilities
- American Electric Power (AEP) subsidiaries
- AEP Ohio
- AEP Texas
- Appalachian Power
- Indiana Michigan Power
- Kentucky Power
- Public Service Company of Oklahoma (PSO)
- Southwestern Electric Power Company (SWEPCO)
- Burbank Water and Power (BWP)
- City of Austin Utilities
- Clark Public Utilities
- Consolidated Edison (ConEd) and subsidiaries
- Orange & Rockland Utilities (ORU)
- Duquesne Light Company (DQE)
- Evergy
- Eversource
- Exelon subsidiaries
- Atlantic City Electric
- Baltimore Gas and Electric (BGE)
- Commonwealth Edison (ComEd)
- Delmarva Power
- PECO Energy Company (PECO)
- Potomac Electric Power Company (Pepco)
- Glendale Water and Power (GWP)
- National Grid US subsidiaries
- National Grid Massachusetts
- National Grid NY Long Island
- National Grid NY Metro
- National Grid NY Upstate
- Northern Indiana Public Service Company (NIPSCO)
- Pacific Gas & Electric (PG&E)
- Portland General Electric (PGE)
- Puget Sound Energy (PSE)
- Rhode Island Energy (RIEnergy)
- Sacramento Municipal Utility District (SMUD)
- Seattle City Light (SCL)
- Southern Maryland Electric Cooperative (SMECO)
- Southwest Gas
Contributing
Contributions are welcome! Please feel free to submit a pull request.
Adding a New Utility
To add support for a new Opower-based utility, follow these steps:
- Verify it's an Opower utility: Use your browser's developer tools on your utility's website. If the network tab shows requests to a domain like
utility.opower.com, it's a good candidate. - Create a utility file: Add a new file in
src/opower/utilitiesthat inherits fromUtilityBase. Name the file after the utility's website (e.g.,newutility.pyfornewutility.com). - Respect scraping limitations: This library is used by Home Assistant and must adhere to its architecture rules. A headless browser cannot be a dependency, and HTML parsing is only allowed for the authentication phase.
An exception is made for the authentication phase. An integration is allowed to extract fields from forms. To make it more robust, data should not be gathered by scraping individual fields but instead scrape all fields at once.
Development environment
python3 -m venv .venv
source .venv/bin/activate
# for Windows CMD:
# .venv\Scripts\activate.bat
# for Windows PowerShell:
# .venv\Scripts\Activate.ps1
# Install dependencies
python -m pip install --upgrade pip
python -m pip install -e .
# Run pre-commit
python -m pip install pre-commit
pre-commit install
pre-commit run --all-files
# Run tests
python -m pip install -e ".[test]"
pytest
# Run command line
python -m opower --help
# To output debug logs and API responses to a file run:
python -m opower -vv 2> out.txt
# Build package
python -m pip install build
python -m build
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file opower-0.19.0.tar.gz.
File metadata
- Download URL: opower-0.19.0.tar.gz
- Upload date:
- Size: 58.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e354572960ab8a897d467630d126fa04d1f0bf351d94b420d5dd74368a4eb93d
|
|
| MD5 |
24186849c79348081cee3ae0168c701a
|
|
| BLAKE2b-256 |
dcbd5a2c392a8745a3402bc40ceed2f0f3e1e6534544dffeb2bb46bb88ca4496
|
Provenance
The following attestation bundles were made for opower-0.19.0.tar.gz:
Publisher:
python-publish.yml on tronikos/opower
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
opower-0.19.0.tar.gz -
Subject digest:
e354572960ab8a897d467630d126fa04d1f0bf351d94b420d5dd74368a4eb93d - Sigstore transparency entry: 2255746796
- Sigstore integration time:
-
Permalink:
tronikos/opower@59c66282d3b5ea3a0c1d4c452371f5d5ca4b82fb -
Branch / Tag:
refs/tags/v0.19.0 - Owner: https://github.com/tronikos
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
python-publish.yml@59c66282d3b5ea3a0c1d4c452371f5d5ca4b82fb -
Trigger Event:
release
-
Statement type:
File details
Details for the file opower-0.19.0-py3-none-any.whl.
File metadata
- Download URL: opower-0.19.0-py3-none-any.whl
- Upload date:
- Size: 75.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
484af9529b9ce277ef9bd61eb278f2e9128b00e74f958b522a07084f2b7a9715
|
|
| MD5 |
da18a5e567fa94a53b645a9d80156401
|
|
| BLAKE2b-256 |
9e4116f6dd51dd32c22fd190577d4fe9035661898ca9179cc8e06fb1c627cf08
|
Provenance
The following attestation bundles were made for opower-0.19.0-py3-none-any.whl:
Publisher:
python-publish.yml on tronikos/opower
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
opower-0.19.0-py3-none-any.whl -
Subject digest:
484af9529b9ce277ef9bd61eb278f2e9128b00e74f958b522a07084f2b7a9715 - Sigstore transparency entry: 2255746809
- Sigstore integration time:
-
Permalink:
tronikos/opower@59c66282d3b5ea3a0c1d4c452371f5d5ca4b82fb -
Branch / Tag:
refs/tags/v0.19.0 - Owner: https://github.com/tronikos
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
python-publish.yml@59c66282d3b5ea3a0c1d4c452371f5d5ca4b82fb -
Trigger Event:
release
-
Statement type:
