Skip to main content

Python client for Toyota North America service API

Project description

toyota-na

Python client for Toyota North America service API

Install

pip install toyota-na

Usage

python -m toyota_na.app -h  # Get help
python -m toyota_na.app authorize <username> <passworde>
python -m toyota_na.app get_user_vehicle_list  # List vehicle
python -m toyota_na.app get_vehicle_status <vin>  # Get vehcicle status
...

Known Issues

  1. Door/window status not always up-to-date unless you call send_refresh_status first and wait for it to complete (there is no notification that it completed successfully).

Developer Guide

Quick Start

from toyota_na.client import ToyotaOneClient

async def main():
    cli = ToyotaOneClient()
    await cli.auth.login(USERNAME, PASSWORD)
    vehicle_list = await cli.get_user_vehicle_list()
    vehicle_status = await cli.get_vehicle_status(vehicle_list[0]["vin"])
    ...

Abstracted Interface Example

from toyota_na.client import ToyotaOneClient
from toyota_na.vehicle.vehicle import get_vehicles

async def main():
    cli = ToyotaOneClient()

Contributing

We use black and isort for opinionated formatting to ensure a consistent look and feel throughout the codebase no matter the contributor. Pre-commit is used to guarantee the files being check in to the repo are formatted correctly.

For convenience a vscode project settings file is included as well. Editors other than vscode will require some setup if you wish to have formatting take place while working.

Getting started:

  • Clone the repo
  • pip3 install black isort pre-commit
  • pre-commit install

Samples

Sample responses from API calls are stored in samples folder. The data is from Toyota app's "Demo Mode"

Credits:

Thanks @DurgNomis-drol for making the original Toyota module and bring up the discussing of Toyota North America.

Thanks @visualage for finding the way to authenticate headlessly.

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

toyota-na-2.0.2.dev2.tar.gz (25.7 kB view details)

Uploaded Source

Built Distribution

toyota_na-2.0.2.dev2-py3-none-any.whl (19.7 kB view details)

Uploaded Python 3

File details

Details for the file toyota-na-2.0.2.dev2.tar.gz.

File metadata

  • Download URL: toyota-na-2.0.2.dev2.tar.gz
  • Upload date:
  • Size: 25.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.0 CPython/3.9.12

File hashes

Hashes for toyota-na-2.0.2.dev2.tar.gz
Algorithm Hash digest
SHA256 d6570918977256776c73e75926d7a3d206161248fa8c244ddc8164471d7df722
MD5 8f8630fba7f5c09ad2b782ae66f0005c
BLAKE2b-256 0e1790574182278dedc508523b9e42121fed02dbda9f3c6c875f836012b7c613

See more details on using hashes here.

File details

Details for the file toyota_na-2.0.2.dev2-py3-none-any.whl.

File metadata

File hashes

Hashes for toyota_na-2.0.2.dev2-py3-none-any.whl
Algorithm Hash digest
SHA256 8f402cf5044073493815f11f3fbb7d59bf421a06fcb391621b9c0dcd01cc83bb
MD5 f52e1e031d5a0f36aa9ebd5caa1a35d9
BLAKE2b-256 49f037f58523db1b4c342182315278c20339933c7e65037856b752b112cec696

See more details on using hashes here.

Supported by

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