mychevy 2.1.0

Installation

Installation for this library is just a pip install.

1. pip install mychevy

Usage

Usage is very basic.

from mychevy.mychevy import MyChevy

page = MyChevy("<username>", "<password>")
# This takes up to 2 minutes to return, be patient

# build credentials and starts a session on the mychevy site
page.login()

# gets a list of cars associated with your account
page.get_cars()

# update stats for all cars, and returns the list of cars. This will take
# 60+ seconds per car
cars = page.update_cars()

# Percent battery charge
print(cars[0].percent)

Every invocation of login() creates a whole new session to avoid credential timeouts.

It is not recommended that you run this very frequently. Something like once an hour will give you basic data, and shouldn’t overload anyone’s systems.

Testing

Because there are so many ways this can go wrong, a basic cli tool has been provided.

> mychevy -c config.ini
Loading data, this takes up to 2 minutes...
<EVCar vin="...", range=185 miles, bat=100%, plugged_in=True, mileage=903 miles, charging=Your battery is fully charged., charge_mode=Departure Based, eta=None, state="">

config.ini must include your user and password for the mychevy site in the following format:

[default]
user = my@email.address
passwd = my@wes0mepa55w0rd

Caveats

There are so many caveats…. This software aspires to be the gloriously robust bubble gum and duct tape of which it has heard makes the internet go round.

• JSON formats are guessed at

  The use of the sessions capture and transfer, and inspecting json returned still creates slightly different parameters than are used by the website. The set of keys and values are guessed at. It’s all kind of fragile and heuristic.

• The MyChevy website OnStar link is not robust

  In the first month with the Bolt I’ve seen two multi hour outages of the mychevy website being able to connect to their OnStar backend gateway. One lasted a whole day. The OnStar link from the Android App worked fine during these windows of time. So it’s not an OnStar failure, but it’s a lack of robustness somewhere on the Web side, or the gateway dedicated for serving OnStar requests.

As such, this software will always be classified Alpha on Pypi. It can and will break. For that I’m sorry. But it’s the best I’ve got.

• Free software: Apache Software License 2.0

• Documentation: https://mychevy.readthedocs.io.