Python 3 package to retrieve public EV charger data from Shell Recharge
Project description
Python: Shell Recharge
Python 3 package to retrieve public EV charger data from Shell Recharge
About
This package allows you to request data from public EV chargers using Shell Recharge. I build it to create a home-assistant integration, it can be done with rest calls only, but then options are limited.
Installation
pip3 install shellrecharge
Development
To create a development environment to commit code.
python3 -m venv .venv
source .venv/bin/activate
pip3 install pdm
pip3 install ruff
pdm init
sudo apt install pre-commit
pip3 install pre-commit
Run checks before PR/Commit:
make all
Example
Below provides example on how to use the library.
#!/usr/bin/env python3
"""Example code."""
import asyncio
import logging
import sys
from asyncio import CancelledError
import aiohttp
from aiohttp.client_exceptions import ClientError
import shellrecharge
from shellrecharge import LocationEmptyError, LocationValidationError
async def main():
"""Main module."""
# Some random stations
location_ids = ["9b9428ab-1dfd-4230-a024-084eacf776ff", "682154", "9cf6c16b-b043-4ba8-b7ca-872f82a0faf4"]
async with aiohttp.ClientSession() as session:
try:
api = shellrecharge.Api(session)
for location_id in location_ids:
location = await api.location_by_id(location_id)
logging.info(location)
except LocationEmptyError:
logging.error("No data returned, check location id")
except LocationValidationError as err:
logging.error("Location validation error {}, report locaton id" % err)
except (ClientError, TimeoutError, CancelledError) as err:
logging.error(err)
if __name__ == "__main__":
logging.basicConfig(stream=sys.stdout, level=logging.DEBUG)
loop = asyncio.new_event_loop()
loop.run_until_complete(main())
Donations
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
shellrecharge-0.1.17.tar.gz
(4.6 kB
view details)
Built Distribution
File details
Details for the file shellrecharge-0.1.17.tar.gz
.
File metadata
- Download URL: shellrecharge-0.1.17.tar.gz
- Upload date:
- Size: 4.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.11.2
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3919c2ade39cf1fc1fe2103884dbdaa8f5ae3f62d55bba0bc49a52ecbfa6c9e7 |
|
MD5 | bd1b6c20dc3667839a8ce0580915a57b |
|
BLAKE2b-256 | b9fa2b0411ef13ad57c88c0390064a0f52d32d4cb989c0d2240511bb4a544aa7 |
File details
Details for the file shellrecharge-0.1.17-py3-none-any.whl
.
File metadata
- Download URL: shellrecharge-0.1.17-py3-none-any.whl
- Upload date:
- Size: 5.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.11.2
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | cb95cd55d8a9d9a4e6283731e0aed602dc5949496b771e53cb71e34c45f5345d |
|
MD5 | 761162f2223aa7523f4b768a922117c2 |
|
BLAKE2b-256 | d958c7e992b400d8b6679842e07f61012ae400bc997bbb84670f6f3a328b078b |