Tesla

require 'tesla'

Tesla.access_token = 'eyJhbGciOiJSUzI1NiIs...'

# Return the vehicles of the account.
car = Tesla.vehicles.first
car.vin              # => "5YJSA11111111111"
car.display_name     # => "Nikola 2.0"
car.state            # => "asleep"

# Wake the car, and wait up to a minute for it to be online.
car = Tesla.wake_up car, timeout: 60
car.online?          # => true

# Pop the trunk. A powered liftgate that is open closes again.
Tesla.actuate_trunk car

# Open the frunk.
Tesla.open_frunk car

# Set the temperature, in degrees Celsius, and turn on the climate control.
Tesla.set_temperature car, 21.5
Tesla.start_climate car

# Heat the driver's seat, and the steering wheel.
Tesla.set_seat_heater car, :front_left, 3
Tesla.set_steering_wheel_heater car, on: true

# Keep the dog cool.
Tesla.set_climate_keeper_mode car, :dog

# Lock and unlock the doors.
Tesla.lock_doors car
Tesla.unlock_doors car

# Vent the windows, and close them again.
Tesla.vent_windows car
Tesla.close_windows car

# Find the car in a parking lot.
Tesla.flash_lights car
Tesla.honk_horn car

# Charge to 80%, at 32 amps.
Tesla.set_charge_limit car, 80
Tesla.set_charging_amps car, 32
Tesla.open_charge_port car
Tesla.start_charging car

# Send a destination to the navigation.
Tesla.navigate_to car, '3500 Deer Creek Road, Palo Alto, CA'

# Turn on Sentry Mode.
Tesla.set_sentry_mode car, on: true

# A VIN stands in for the car wherever one is expected.
Tesla.lock_doors '5YJSA11111111111'

# Send a command the library has no method for.
Tesla.command car, :set_vehicle_name, vehicle_name: 'Nikola 2.0'

data = Tesla.vehicle_data car

data.charge_state.battery_level        # => 59
data.charge_state.battery_range        # => 149.92, in miles
data.charge_state.charging_state       # => "Charging"
data.climate_state.inside_temp         # => 22.1, in degrees Celsius
data.climate_state.climate_on?         # => false
data.vehicle_state.locked?             # => true
data.vehicle_state.trunk_open?         # => false
data.vehicle_state.odometer            # => 57869.762487, in miles
data.vehicle_config.car_type           # => "modely"
data.gui_settings.temperature_units    # => "F"

# The Fleet API answers with the position of the car only when it is asked for,
# for an access token with the vehicle_location scope.
data = Tesla.vehicle_data car, endpoints: %i[location_data drive_state]
data.drive_state.latitude              # => 33.111111

# The charging sites near the car.
Tesla.nearby_charging_sites(car).superchargers.map(&:name)

# The user the access token was issued for.
Tesla.me.email

data.charge_state[:charge_energy_added]   # => 2.42
data.to_h                                 # => {"id" => 12345678901234567, ...}

case Tesla.vehicle(car)
in {state: "online"} then puts "ready"
in {state:} then puts "the car is #{state}"
end

Tesla.configure do |config|
  config.client_id = '81527cff06843c8634fdc09e8ac0abef'
  config.client_secret = 'ta-secret.7vx6VkVvk2gBgSrN'
  config.redirect_uri = 'https://example.com/auth/callback'
end

# 1. Register the application in the region it is used in, once.
Tesla.register_partner 'example.com'

# 2. Send the owner of the car to authorize the application.
state = SecureRandom.hex
redirect_to Tesla.authorization_url(state: state)

# 3. Tesla sends them back to the redirect URI with a code. Check the state, and exchange the code for tokens.
response = SimpleOAuth::OAuth2::AuthorizationResponse.parse(request.query_string, state: state)
token = Tesla.exchange_code response.code

token.access_token    # lasts eight hours
token.refresh_token   # lasts three months, and is used once
token.expires_at      # => 2026-10-04 20:00:00 UTC

Tesla.configure do |config|
  config.access_token = stored.access_token
  config.refresh_token = stored.refresh_token
end

Tesla.on_token_refresh = ->(token) { store(token.access_token, token.refresh_token) }

# Refresh ahead of time, rather than when a request is turned away.
Tesla.refresh_access_token

Tesla.configure do |config|
  config.host = 'https://localhost:4443'
  # Trust the certificate the proxy was started with. TLS verification is never turned off.
  config.ca_file = 'config/tls-cert.pem'
  # Tokens are issued for the Fleet API of your region rather than for the proxy.
  config.audience = Tesla::Configuration::NORTH_AMERICA_HOST
end

Tesla.configure do |config|
  # The Fleet API of your region: NORTH_AMERICA_HOST (the default), EUROPE_HOST, or CHINA_HOST.
  # Tesla.region.fleet_api_base_url names the one an account is served by.
  config.host = Tesla::Configuration::EUROPE_HOST

  config.open_timeout = 10      # seconds, 60 by default
  config.read_timeout = 30      # seconds, 60 by default
  config.write_timeout = 30     # seconds, 60 by default
  config.keep_alive_timeout = 2 # seconds an idle connection is kept open, the default; 0 opens one per request
  config.max_redirects = 10     # the default
  config.proxy_url = 'http://proxy.example.com:8080'
  config.user_agent = 'MyApp/1.0'
  config.max_retries = 2        # the default; 0 turns retrying off
  config.max_retry_delay = 60   # seconds, the default
end

client = Tesla::Client.new(access_token: 'eyJhbGciOiJSUzI1NiIs...', host: Tesla::Configuration::EUROPE_HOST)
client.vehicles
client.actuate_trunk '5YJSA11111111111'

# A request of your own, for an endpoint the library has no method for.
client.get '/api/1/vehicles/5YJSA11111111111/release_notes'

Tesla::Client.new(access_token: 'eyJhbGciOiJSUzI1NiIs...') do |client|
  client.vehicles.each { |car| puts client.vehicle_data(car).charge_state.battery_level }
end

Tesla.debug_output = $stderr

begin
  Tesla.start_charging car
rescue Tesla::CommandFailed => e
  e.reason            # => "disconnected": the car read the command and refused
rescue Tesla::RequestTimeout
  Tesla.wake_up car, timeout: 60   # the car is asleep or offline
  retry
rescue Tesla::TooManyRequests => e
  sleep e.retry_after
  retry
rescue Tesla::HTTPError => e
  e.code              # => 403
  e.message           # => the error the Fleet API describes
end