Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tronikos/opower
A Python library for getting historical and forecasted usage/cost from utilities that use opower.com such as PG&E
https://github.com/tronikos/opower
Last synced: about 1 month ago
JSON representation
A Python library for getting historical and forecasted usage/cost from utilities that use opower.com such as PG&E
- Host: GitHub
- URL: https://github.com/tronikos/opower
- Owner: tronikos
- License: apache-2.0
- Created: 2023-03-26T22:46:38.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-05-12T19:49:40.000Z (about 1 month ago)
- Last Synced: 2024-05-13T20:05:22.238Z (about 1 month ago)
- Language: Python
- Homepage:
- Size: 156 KB
- Stars: 48
- Watchers: 2
- Forks: 49
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Lists
- awesome-stars - tronikos/opower - A Python library for getting historical and forecasted usage/cost from utilities that use opower.com such as PG&E (Python)
README
# opower
A Python library for getting historical and forecasted usage/cost from utilities that use opower.com such as PG&E.
Supported utilities (in alphabetical order):
- 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)
- City of Austin Utilities
- Consolidated Edison (ConEd)
- Orange & Rockland Utilities (ORU)
- Duquesne Light Company (DQE)
- Enmax Energy
- Evergy
- Exelon subsidiaries
- Atlantic City Electric
- Baltimore Gas and Electric (BGE)
- Commonwealth Edison (ComEd)
- Delmarva Power
- PECO Energy Company (PECO)
- Potomac Electric Power Company (Pepco)
- Pacific Gas & Electric (PG&E)
- Portland General Electric (PGE)
- Puget Sound Energy (PSE)
- Sacramento Municipal Utility District (SMUD)
- Seattle City Light (SCL)
## Support a new utility
To add support for a new utility that uses opower JSON API (you can tell if the energy dashboard of your utility makes network requests to opower.com, e.g. pge.opower.com in the network tab of your browser's developer tools) add a file similar to
[pge.py](https://github.com/tronikos/opower/blob/main/src/opower/utilities/pge.py)
or [pse.py](https://github.com/tronikos/opower/blob/main/src/opower/utilities/pse.py)
or [bge.py](https://github.com/tronikos/opower/blob/main/src/opower/utilities/bge.py)
etc.
Name the file after the utility website, e.g. pge.py for pge.com.
Since this library is used by Home Assistant, see , per we cannot have a dependency on a headless browser and we can only parse HTML during login.
> 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.
So follow that advice and try to scrape all fields at once, similar to the `get_form_action_url_and_hidden_inputs` in helpers.py.
## Example
See [demo.py](https://github.com/tronikos/opower/blob/main/src/demo.py)
## Development environment
```sh
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 .
# Run pre-commit
python -m pip install pre-commit
pre-commit install
pre-commit run --all-files
# Alternative: run formatter, lint, and type checking
python -m pip install isort black flake8 ruff mypy
isort . ; black . ; flake8 . ; ruff . --fix ; mypy --install-types .
# Run tests
python -m pip install pytest python-dotenv
pytest
# Run demo
python src/demo.py --help
# To output debug logs and API responses to a file run:
python src/demo.py -vv 2> out.txt
# Build package
python -m pip install build
python -m build
```