tyta-cli 0.1.0__tar.gz

tyta_cli-0.1.0/PKG-INFO

@@ -0,0 +1,267 @@
+Metadata-Version: 2.4
+Name: tyta-cli
+Version: 0.1.0
+Summary: CLI tool for Toyota Connected Services (EU)
+License: MIT
+Author: Stepan Bolotnikov
+Requires-Python: >=3.10,<4.0
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Dist: httpx (>=0.27)
+Requires-Dist: loguru (>=0.7)
+Requires-Dist: pydantic (>=2.0)
+Requires-Dist: pyjwt (>=2.8)
+Requires-Dist: typer[all] (>=0.9)
+Description-Content-Type: text/markdown
+
+# tyta-cli
+
+A command-line interface for Toyota Connected Services (EU). Communicate with your Toyota vehicle
+directly from the terminal or from automation scripts.
+
+> **Note:** EU region only. Requires a Toyota Connected Services account.
+
+## Install
+
+```bash
+pipx install tyta-cli
+```
+
+Or for development:
+
+```bash
+pipx install --editable .
+```
+
+## Quick Start
+
+```bash
+# Authenticate
+tyta auth login
+
+# Check auth status
+tyta auth status
+
+# List your vehicles
+tyta vehicles list
+
+# Set a default vehicle (so you don't need --vin on every command)
+tyta vehicles use JTDKB3FU803012345
+
+# Show vehicle status
+tyta status
+```
+
+## Global Options
+
+These options are accepted by every command:
+
+| Option | Env Var | Default | Description |
+|---|---|---|---|
+| `--auth-file PATH` | `TOYOTA_AUTH_FILE` | `~/.config/tyta-cli/auth.json` | Path to auth token file |
+| `--config-file PATH` | `TOYOTA_CONFIG_FILE` | `~/.config/tyta-cli/config.json` | Path to config file |
+| `--debug` | — | off | Enable debug logs to stderr; show tracebacks on error |
+
+## Environment Variables
+
+| Variable | Description |
+|---|---|
+| `TOYOTA_USERNAME` | Toyota account email. Used for non-interactive login and headless re-auth. |
+| `TOYOTA_PASSWORD` | Toyota account password. Used for non-interactive login and headless re-auth. |
+| `TOYOTA_AUTH_FILE` | Override path to the auth token file. |
+| `TOYOTA_CONFIG_FILE` | Override path to the config file. |
+| `TOYOTA_VIN` | Default VIN for per-vehicle commands. Overridden by `--vin` flag; overrides config default. |
+
+### Headless / CI environments
+
+If `TOYOTA_USERNAME` and `TOYOTA_PASSWORD` are both set, the CLI will re-authenticate
+automatically whenever tokens expire — no manual intervention needed.
+
+```bash
+export TOYOTA_USERNAME="user@example.com"
+export TOYOTA_PASSWORD="secret"
+tyta status   # re-auths silently if tokens have expired
+```
+
+## Commands
+
+### Auth
+
+```bash
+tyta auth login       # Authenticate and save tokens
+tyta auth logout      # Delete saved tokens
+tyta auth status      # Show authentication state and token expiry
+```
+
+`tyta auth login` supports non-interactive mode via `TOYOTA_USERNAME` and `TOYOTA_PASSWORD`
+environment variables.
+
+### Vehicles
+
+```bash
+tyta vehicles list            # List all vehicles linked to the account
+tyta vehicles use <VIN>       # Set the default VIN (validates against API)
+```
+
+### Status
+
+```bash
+tyta status [--vin VIN]
+```
+
+Returns dashboard (odometer, fuel level), location, lock status, and vehicle health.
+
+### Electric
+
+```bash
+tyta electric status [--vin VIN]
+tyta electric refresh [--vin VIN]     # Real-time refresh (warns about 12V drain)
+tyta electric charge-now [--vin VIN]
+
+tyta electric reserve-charge \
+    --day MONDAY --start 07:00 [--end 08:00] [--charge-type startOnly|startEnd] \
+    [--vin VIN]
+
+tyta electric set-charging-time \
+    --day MONDAY --start 07:00 [--end 08:00] [--charge-type startOnly|startEnd] \
+    [--vin VIN]
+```
+
+`--day` accepts uppercase weekday names: `MONDAY`, `TUESDAY`, `WEDNESDAY`, `THURSDAY`, `FRIDAY`,
+`SATURDAY`, `SUNDAY`.
+
+`--start` / `--end` accept 24-hour time as `HH:MM` (e.g. `07:30`).
+
+`--charge-type` defaults to `startOnly`; use `startEnd` when `--end` is provided.
+
+### Climate
+
+```bash
+tyta climate status [--vin VIN]
+tyta climate settings [--vin VIN]
+tyta climate set [--temperature FLOAT] [--unit C|F] [--on | --off] [--vin VIN]
+tyta climate on [--vin VIN]
+tyta climate off [--vin VIN]
+```
+
+`tyta climate set` performs a read-modify-write: it fetches current settings, applies your
+changes, and POSTs them back. All flags are optional; omitting `--on`/`--off` leaves the on/off
+state unchanged.
+
+### Trips
+
+```bash
+tyta trips list [--from YYYY-MM-DD] [--to YYYY-MM-DD] [--routes] [--vin VIN]
+tyta trips summary [--period day|week|month|year] [--vin VIN]
+```
+
+`trips list` defaults to the last 30 days. `--routes` includes per-trip route geometry.
+
+`trips summary` defaults to the current month. Other periods:
+- `day` — today only
+- `week` — Monday through Sunday of the current week
+- `month` — first to last day of the current month
+- `year` — 1 January to 31 December of the current year
+
+### Remote
+
+All remote commands are fire-and-forget. The API acknowledges immediately; vehicle execution is
+asynchronous.
+
+```bash
+tyta remote lock [--vin VIN]
+tyta remote unlock [--vin VIN]
+tyta remote horn [--vin VIN]
+tyta remote find [--vin VIN]          # Flash lights + sound horn
+tyta remote headlights on [--vin VIN]
+tyta remote headlights off [--vin VIN]
+tyta remote hazard on [--vin VIN]
+tyta remote hazard off [--vin VIN]
+```
+
+## VIN Resolution
+
+For all per-vehicle commands, the VIN is resolved in this order:
+
+1. `--vin` flag on the command
+2. `TOYOTA_VIN` environment variable
+3. `default_vin` from config file (set via `tyta vehicles use <vin>`)
+4. Auto-select if the account has exactly one vehicle (emits a warning)
+
+## Output Format
+
+All output is **JSON** printed to stdout. Scripts and LLMs always receive parseable output.
+
+### Success
+
+```json
+{
+  "ok": true,
+  "warnings": [],
+  "data": { ... }
+}
+```
+
+### Success with warnings
+
+```json
+{
+  "ok": true,
+  "warnings": ["No default vehicle set, using only available vehicle: VIN XXXXXXX"],
+  "data": { ... }
+}
+```
+
+### Error
+
+```json
+{
+  "ok": false,
+  "error": {
+    "code": "not_authenticated",
+    "message": "Not authenticated. Run `tyta auth login`."
+  }
+}
+```
+
+### Error Codes
+
+| Code | Meaning |
+|---|---|
+| `not_authenticated` | No token file found |
+| `token_expired` | Tokens expired and refresh failed |
+| `api_error` | Toyota API returned a non-2xx response |
+| `vehicle_not_found` | Specified VIN not found in account |
+| `no_vehicles` | Account has no linked vehicles |
+| `invalid_config` | Config or token file is malformed |
+| `invalid_input` | User-supplied input is invalid |
+| `unknown_error` | Unexpected exception |
+
+### Exit Codes
+
+| Code | Meaning |
+|---|---|
+| `0` | Success |
+| `1` | Operational error (`ok: false`) |
+| `2` | Usage error (bad arguments) |
+
+## Debugging
+
+Pass `--debug` to enable verbose logs on stderr and print tracebacks on error:
+
+```bash
+tyta --debug status
+tyta --debug auth login
+```
+
+Logs go to **stderr**; JSON output always goes to **stdout**.
+
+## License
+
+MIT
+

tyta_cli-0.1.0/README.md

@@ -0,0 +1,245 @@
+# tyta-cli
+
+A command-line interface for Toyota Connected Services (EU). Communicate with your Toyota vehicle
+directly from the terminal or from automation scripts.
+
+> **Note:** EU region only. Requires a Toyota Connected Services account.
+
+## Install
+
+```bash
+pipx install tyta-cli
+```
+
+Or for development:
+
+```bash
+pipx install --editable .
+```
+
+## Quick Start
+
+```bash
+# Authenticate
+tyta auth login
+
+# Check auth status
+tyta auth status
+
+# List your vehicles
+tyta vehicles list
+
+# Set a default vehicle (so you don't need --vin on every command)
+tyta vehicles use JTDKB3FU803012345
+
+# Show vehicle status
+tyta status
+```
+
+## Global Options
+
+These options are accepted by every command:
+
+| Option | Env Var | Default | Description |
+|---|---|---|---|
+| `--auth-file PATH` | `TOYOTA_AUTH_FILE` | `~/.config/tyta-cli/auth.json` | Path to auth token file |
+| `--config-file PATH` | `TOYOTA_CONFIG_FILE` | `~/.config/tyta-cli/config.json` | Path to config file |
+| `--debug` | — | off | Enable debug logs to stderr; show tracebacks on error |
+
+## Environment Variables
+
+| Variable | Description |
+|---|---|
+| `TOYOTA_USERNAME` | Toyota account email. Used for non-interactive login and headless re-auth. |
+| `TOYOTA_PASSWORD` | Toyota account password. Used for non-interactive login and headless re-auth. |
+| `TOYOTA_AUTH_FILE` | Override path to the auth token file. |
+| `TOYOTA_CONFIG_FILE` | Override path to the config file. |
+| `TOYOTA_VIN` | Default VIN for per-vehicle commands. Overridden by `--vin` flag; overrides config default. |
+
+### Headless / CI environments
+
+If `TOYOTA_USERNAME` and `TOYOTA_PASSWORD` are both set, the CLI will re-authenticate
+automatically whenever tokens expire — no manual intervention needed.
+
+```bash
+export TOYOTA_USERNAME="user@example.com"
+export TOYOTA_PASSWORD="secret"
+tyta status   # re-auths silently if tokens have expired
+```
+
+## Commands
+
+### Auth
+
+```bash
+tyta auth login       # Authenticate and save tokens
+tyta auth logout      # Delete saved tokens
+tyta auth status      # Show authentication state and token expiry
+```
+
+`tyta auth login` supports non-interactive mode via `TOYOTA_USERNAME` and `TOYOTA_PASSWORD`
+environment variables.
+
+### Vehicles
+
+```bash
+tyta vehicles list            # List all vehicles linked to the account
+tyta vehicles use <VIN>       # Set the default VIN (validates against API)
+```
+
+### Status
+
+```bash
+tyta status [--vin VIN]
+```
+
+Returns dashboard (odometer, fuel level), location, lock status, and vehicle health.
+
+### Electric
+
+```bash
+tyta electric status [--vin VIN]
+tyta electric refresh [--vin VIN]     # Real-time refresh (warns about 12V drain)
+tyta electric charge-now [--vin VIN]
+
+tyta electric reserve-charge \
+    --day MONDAY --start 07:00 [--end 08:00] [--charge-type startOnly|startEnd] \
+    [--vin VIN]
+
+tyta electric set-charging-time \
+    --day MONDAY --start 07:00 [--end 08:00] [--charge-type startOnly|startEnd] \
+    [--vin VIN]
+```
+
+`--day` accepts uppercase weekday names: `MONDAY`, `TUESDAY`, `WEDNESDAY`, `THURSDAY`, `FRIDAY`,
+`SATURDAY`, `SUNDAY`.
+
+`--start` / `--end` accept 24-hour time as `HH:MM` (e.g. `07:30`).
+
+`--charge-type` defaults to `startOnly`; use `startEnd` when `--end` is provided.
+
+### Climate
+
+```bash
+tyta climate status [--vin VIN]
+tyta climate settings [--vin VIN]
+tyta climate set [--temperature FLOAT] [--unit C|F] [--on | --off] [--vin VIN]
+tyta climate on [--vin VIN]
+tyta climate off [--vin VIN]
+```
+
+`tyta climate set` performs a read-modify-write: it fetches current settings, applies your
+changes, and POSTs them back. All flags are optional; omitting `--on`/`--off` leaves the on/off
+state unchanged.
+
+### Trips
+
+```bash
+tyta trips list [--from YYYY-MM-DD] [--to YYYY-MM-DD] [--routes] [--vin VIN]
+tyta trips summary [--period day|week|month|year] [--vin VIN]
+```
+
+`trips list` defaults to the last 30 days. `--routes` includes per-trip route geometry.
+
+`trips summary` defaults to the current month. Other periods:
+- `day` — today only
+- `week` — Monday through Sunday of the current week
+- `month` — first to last day of the current month
+- `year` — 1 January to 31 December of the current year
+
+### Remote
+
+All remote commands are fire-and-forget. The API acknowledges immediately; vehicle execution is
+asynchronous.
+
+```bash
+tyta remote lock [--vin VIN]
+tyta remote unlock [--vin VIN]
+tyta remote horn [--vin VIN]
+tyta remote find [--vin VIN]          # Flash lights + sound horn
+tyta remote headlights on [--vin VIN]
+tyta remote headlights off [--vin VIN]
+tyta remote hazard on [--vin VIN]
+tyta remote hazard off [--vin VIN]
+```
+
+## VIN Resolution
+
+For all per-vehicle commands, the VIN is resolved in this order:
+
+1. `--vin` flag on the command
+2. `TOYOTA_VIN` environment variable
+3. `default_vin` from config file (set via `tyta vehicles use <vin>`)
+4. Auto-select if the account has exactly one vehicle (emits a warning)
+
+## Output Format
+
+All output is **JSON** printed to stdout. Scripts and LLMs always receive parseable output.
+
+### Success
+
+```json
+{
+  "ok": true,
+  "warnings": [],
+  "data": { ... }
+}
+```
+
+### Success with warnings
+
+```json
+{
+  "ok": true,
+  "warnings": ["No default vehicle set, using only available vehicle: VIN XXXXXXX"],
+  "data": { ... }
+}
+```
+
+### Error
+
+```json
+{
+  "ok": false,
+  "error": {
+    "code": "not_authenticated",
+    "message": "Not authenticated. Run `tyta auth login`."
+  }
+}
+```
+
+### Error Codes
+
+| Code | Meaning |
+|---|---|
+| `not_authenticated` | No token file found |
+| `token_expired` | Tokens expired and refresh failed |
+| `api_error` | Toyota API returned a non-2xx response |
+| `vehicle_not_found` | Specified VIN not found in account |
+| `no_vehicles` | Account has no linked vehicles |
+| `invalid_config` | Config or token file is malformed |
+| `invalid_input` | User-supplied input is invalid |
+| `unknown_error` | Unexpected exception |
+
+### Exit Codes
+
+| Code | Meaning |
+|---|---|
+| `0` | Success |
+| `1` | Operational error (`ok: false`) |
+| `2` | Usage error (bad arguments) |
+
+## Debugging
+
+Pass `--debug` to enable verbose logs on stderr and print tracebacks on error:
+
+```bash
+tyta --debug status
+tyta --debug auth login
+```
+
+Logs go to **stderr**; JSON output always goes to **stdout**.
+
+## License
+
+MIT

tyta_cli-0.1.0/pyproject.toml

@@ -0,0 +1,43 @@
+[project]
+name = "tyta-cli"
+version = "0.1.0"
+description = "CLI tool for Toyota Connected Services (EU)"
+authors = [{ name = "Stepan Bolotnikov" }]
+license = { text = "MIT" }
+readme = "README.md"
+requires-python = ">=3.10,<4.0"
+dependencies = [
+    "typer[all]>=0.9",
+    "httpx>=0.27",
+    "pyjwt>=2.8",
+    "pydantic>=2.0",
+    "loguru>=0.7",
+]
+
+[project.scripts]
+tyta = "tyta.cli.main:app"
+
+[tool.poetry]
+packages = [{ include = "tyta" }]
+
+[tool.poetry.group.dev.dependencies]
+pytest = ">=8.0"
+pytest-asyncio = ">=0.23"
+pytest-cov = ">=5.0"
+respx = ">=0.21"
+ruff = ">=0.9"
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B", "SIM"]
+ignore = ["E501"]
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"

tyta_cli-0.1.0/tyta/__init__.py

@@ -0,0 +1,3 @@
+"""tyta-cli — Toyota Connected Services CLI."""
+
+__version__ = "0.1.0"

tyta_cli-0.1.0/tyta/cli/__init__.py

@@ -0,0 +1 @@
+"""CLI layer for tyta-cli."""

tyta_cli-0.1.0/tyta/cli/auth.py

@@ -0,0 +1,140 @@
+"""tyta auth subcommands: login, logout, status."""
+
+from __future__ import annotations
+
+import asyncio
+import getpass
+import json
+import os
+import sys
+
+import typer
+from loguru import logger
+
+from tyta.core import auth as core_auth
+from tyta.core import envelope as env
+
+app = typer.Typer(
+    name="auth",
+    help="Manage Toyota account authentication.",
+    no_args_is_help=True,
+)
+
+
+def _get_debug() -> bool:
+    from tyta.cli.main import _get_state
+
+    return _get_state().get("debug", False)
+
+
+def _get_auth_path_override() -> str | None:
+    from tyta.cli.main import _get_state
+
+    return _get_state().get("auth_file")
+
+
+def _emit_and_exit(data: dict, exit_code: int = 0) -> None:
+    """Print JSON envelope and raise SystemExit directly."""
+    print(json.dumps(data, indent=2))
+    sys.exit(exit_code)
+
+
+@app.command("login")
+def login() -> None:
+    """Authenticate with Toyota and save credentials."""
+    debug = _get_debug()
+    auth_path = core_auth.get_auth_path(_get_auth_path_override())
+
+    # Collect credentials — use env vars if available
+    username = os.environ.get("TOYOTA_USERNAME")
+    password = os.environ.get("TOYOTA_PASSWORD")
+
+    if not username:
+        username = typer.prompt("Toyota username (email)")
+    if not password:
+        password = getpass.getpass("Toyota password: ")
+
+    try:
+        token_data = asyncio.run(core_auth.login(username, password, auth_path))
+    except core_auth.InvalidUsernameError as exc:
+        if debug:
+            import traceback
+
+            traceback.print_exc(file=sys.stderr)
+        _emit_and_exit(env.error(exc.code, exc.message), exit_code=1)
+        return
+    except core_auth.AuthError as exc:
+        if debug:
+            import traceback
+
+            traceback.print_exc(file=sys.stderr)
+        _emit_and_exit(env.error(exc.code, exc.message), exit_code=1)
+        return
+    except json.JSONDecodeError:
+        if debug:
+            import traceback
+
+            traceback.print_exc(file=sys.stderr)
+        _emit_and_exit(
+            env.error("invalid_config", "Received malformed JSON from Toyota API."), exit_code=1
+        )
+        return
+    except Exception as exc:
+        if debug:
+            import traceback
+
+            traceback.print_exc(file=sys.stderr)
+        logger.debug(f"Unexpected error during login: {exc}")
+        _emit_and_exit(env.error("unknown_error", str(exc)), exit_code=1)
+        return
+
+    _emit_and_exit(
+        env.ok(
+            {
+                "message": "Logged in successfully.",
+                "username": token_data["username"],
+                "expires_at": token_data["expires_at"],
+            }
+        )
+    )
+
+
+@app.command("logout")
+def logout() -> None:
+    """Delete saved credentials."""
+    debug = _get_debug()
+    auth_path = core_auth.get_auth_path(_get_auth_path_override())
+
+    try:
+        deleted = core_auth.logout(auth_path)
+    except Exception as exc:
+        if debug:
+            import traceback
+
+            traceback.print_exc(file=sys.stderr)
+        _emit_and_exit(env.error("unknown_error", str(exc)), exit_code=1)
+        return
+
+    if deleted:
+        _emit_and_exit(env.ok({"message": "Logged out successfully."}))
+    else:
+        _emit_and_exit(env.ok({"message": "Already logged out (no token file found)."}))
+
+
+@app.command("status")
+def auth_status() -> None:
+    """Show current authentication status."""
+    debug = _get_debug()
+    auth_path = core_auth.get_auth_path(_get_auth_path_override())
+
+    try:
+        result = core_auth.status(auth_path)
+    except Exception as exc:
+        if debug:
+            import traceback
+
+            traceback.print_exc(file=sys.stderr)
+        _emit_and_exit(env.error("unknown_error", str(exc)), exit_code=1)
+        return
+
+    _emit_and_exit(env.ok(result))