myskoda 0.7.3

Library for interaction with the MySkoda APIs.

MySkoda

This Python library can be used to work with the MySkoda API.

• MySkoda
  • Get In Touch
  • Quick Start
    • Basic example
  • Documentation
  • As Library
  • As CLI
  • Contribute your Fixtures

Get In Touch

We have an active community in our discord. Feel free to join.

If you have any issues, please report them in our issue tracker.

Quick Start

The MySkoda package is published to Pypi and can be found here.

It can be installed the usual way:

pip install myskoda

Basic example

from aiohttp import ClientSession
from myskoda import MySkoda

session = ClientSession()
myskoda = MySkoda(session)
await myskoda.connect(email, password)

for vin in await myskoda.list_vehicle_vins():
    print(vin)

myskoda.disconnect()
await session.close()

Documentation

Detailed documentation is available at read the docs:

• Fetching Data
• Subscribing to Events
• Primer

As Library

MySkoda relies on aiohttp which must be installed. A ClientSession must be opened and passed to MySkoda upon initialization.

After connecting, operations can be performed, events can be subscribed to and data can be loaded from the API.

Don't forget to close the session and disconnect MySkoda after you're done.

As CLI

The MySkoda package features a CLI. You will have to install it with extras cli:

pip install myskoda[cli]

Afterwards, the CLI is available in your current environment by invoking myskoda.

Username and password must be provided to the CLI for every request as options, before selecting a sub command:

myskoda --user "[e-mail]" --password "super secret" list-vehicles

Help can be accessed the usual way:

myskoda --help

Contribute your Fixtures

Please contribute fixtures for our tests by running the script:

python scripts/gen_fixtures.py \
    --user [e-mail] \
    --password super_secret \
    --name name_of_your_test \
    --description "This is an initial test case for this vehicle. The vehicle was in motion"

This will call all get-routes and load all data from your vehicles (no actions will be performed).

The data will be anonymized (vin and personal data are replaced) and serves as unit tests.

Please create a pull request with the resulting data to help us cover more vehicles.