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.1.tar.gz (25.6 kB view details)

Uploaded Source

Built Distribution

toyota_na-2.0.1-py3-none-any.whl (19.6 kB view details)

Uploaded Python 3

File details

Details for the file toyota-na-2.0.1.tar.gz.

File metadata

  • Download URL: toyota-na-2.0.1.tar.gz
  • Upload date:
  • Size: 25.6 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.1.tar.gz
Algorithm Hash digest
SHA256 69784626c4ed4d8b2f570f3c01b618859c4f496e1b15aaf2498e1cb3b8432917
MD5 739869b338fe15a71f18f430547b55a4
BLAKE2b-256 2200e22c2b50c684b060769be6cab3930c3d025064a63553592e5d7e2b4ec605

See more details on using hashes here.

File details

Details for the file toyota_na-2.0.1-py3-none-any.whl.

File metadata

  • Download URL: toyota_na-2.0.1-py3-none-any.whl
  • Upload date:
  • Size: 19.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.0 CPython/3.9.12

File hashes

Hashes for toyota_na-2.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 b23483de1be51cb309d879349d5c5215a6bc98659b95097a94254e32db5c5e84
MD5 4efcf840d459768c5210fabd91c558a1
BLAKE2b-256 436c218a1fa495ad27cfb9cd309ec4e62ebc80da6fece4870dad269e5a4663c1

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