Skip to main content

Python client for Toyota Connected Services.

Project description

License PyPI version PyPI - Python Version Github Actions Build Code Coverage CodeQL

Toyota Connected Services Europe Python module

⚠️ This is still in beta ⚠️ Only EU is supported, other regions are not possible so far.

Description

Python 3 package to communicate with Toyota Connected Europe Services. This is an unofficial package and Toyota can change their API at any point without warning.

Installation

This package can be installed through pip.

pip install pytoyoda

Docs

https://pytoyoda.github.io/pytoyoda/pytoyoda.html

Usage

For a quick start on how to use the package take a look at the simple_client_example.py file contained in the report. You can also use and execute this file directly by using the following commands:

python -m venv pytoyoda
source pytoyoda/bin/activate
python -m pip install "pytoyoda@git+https://github.com/pytoyoda/pytoyoda@main"
curl -LO https://raw.githubusercontent.com/pytoyoda/pytoyoda/main/simple_client_example.py
# Create a credentials.json file with {"username":"your@mail.tld","password":"yourpassword"}
python simple_client_example.py

Please note that the simple_client_example.py file is only to be regarded as a playground and is intended to provide an initial insight into the possibilities. It is not an officially supported interface of the pytoyoda API! For an overview of the current official interfaces, please take a look at our documentation.

Known issues

  • Statistical endpoint will return None if no trip have been performed in the requested timeframe. This problem will often happen at the start of each week, month or year. Also daily stats will of course also be unavailable if no trip have been performed.
  • Currently, it is only possible to get various vehicle information. Functions for controlling and setting vehicle properties have not yet been implemented.

Contributing

This python module uses poetry (>= 2.0.0) and pre-commit.

To start contributing, fork this repository and run poetry install. Then create a new branch. Before making a PR, please run pre-commit poetry run pre-commit run --all-files and make sure that all tests passes locally first by running pytest tests/.

Note

This is a friendly community fork of the original project by @DurgNomis-drol, to ease up on maintenance and the bus factor for this project.

Credits

Special thanks go @DurgNomis-drol for starting this project! A huge thanks go to @calmjm for making tojota.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pytoyoda-3.0.0.tar.gz (41.1 kB view details)

Uploaded Source

Built Distribution

pytoyoda-3.0.0-py3-none-any.whl (55.5 kB view details)

Uploaded Python 3

File details

Details for the file pytoyoda-3.0.0.tar.gz.

File metadata

  • Download URL: pytoyoda-3.0.0.tar.gz
  • Upload date:
  • Size: 41.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for pytoyoda-3.0.0.tar.gz
Algorithm Hash digest
SHA256 b65253df12b9d9c53ff7f3b8f07c0218901e1e7bd7238049434054015d77da70
MD5 236c6496872ff94ce7ca99fb502e6adf
BLAKE2b-256 9b2a2b9dad705f9297b3543f8a15d7bbab3a3dd805f76a3cb9f165ac508a214d

See more details on using hashes here.

Provenance

The following attestation bundles were made for pytoyoda-3.0.0.tar.gz:

Publisher: python-publish.yml on pytoyoda/pytoyoda

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file pytoyoda-3.0.0-py3-none-any.whl.

File metadata

  • Download URL: pytoyoda-3.0.0-py3-none-any.whl
  • Upload date:
  • Size: 55.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for pytoyoda-3.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 867eb9faa33796c49e25f506cfe63dc526361cc5ea681d9fdfce20338201600d
MD5 796b248fca9cdf30d6b28c0ee0e024f5
BLAKE2b-256 7b95fdd8015cf24fe6d1a571e870d316e4b4b639a817c240cf1c04ae7139fd35

See more details on using hashes here.

Provenance

The following attestation bundles were made for pytoyoda-3.0.0-py3-none-any.whl:

Publisher: python-publish.yml on pytoyoda/pytoyoda

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page