tesla-api-sdk 1.0.0__py3-none-any.whl → 1.0.1__py3-none-any.whl

teslafleetmanagementapi/controllers/vehicles_controller.py

@@ -4,6 +4,9 @@ This file was automatically generated by APIMATIC v3.0 ( https://www.apimatic.io
 """
 
 # ruff: noqa: D410, E501, E101, D206
+from apimatic_core.authentication.multiple.and_auth_group import (
+    And,
+)
 from apimatic_core.authentication.multiple.single_auth import (
     Single,
 )
@@ -82,7 +85,7 @@ class VehiclesController(BaseController):
             .header_param(Parameter()
                 .key("accept")
                 .value("application/json"))
-            .auth(Single("bearerAuth")),
+            .auth(And(Single("bearerAuth"), Single("oauth2"))),
         ).response(
             ResponseHandler()
             .deserializer(APIHelper.json_deserialize)
@@ -119,7 +122,7 @@ class VehiclesController(BaseController):
             .header_param(Parameter()
                 .key("accept")
                 .value("application/json"))
-            .auth(Single("bearerAuth")),
+            .auth(And(Single("bearerAuth"), Single("oauth2"))),
         ).response(
             ResponseHandler()
             .deserializer(APIHelper.json_deserialize)
@@ -157,7 +160,7 @@ class VehiclesController(BaseController):
             .header_param(Parameter()
                 .key("accept")
                 .value("application/json"))
-            .auth(Single("bearerAuth")),
+            .auth(And(Single("bearerAuth"), Single("oauth2"))),
         ).response(
             ResponseHandler()
             .deserializer(APIHelper.json_deserialize)
@@ -195,7 +198,7 @@ class VehiclesController(BaseController):
             .header_param(Parameter()
                 .key("accept")
                 .value("application/json"))
-            .auth(Single("bearerAuth")),
+            .auth(And(Single("bearerAuth"), Single("oauth2"))),
         ).response(
             ResponseHandler()
             .deserializer(APIHelper.json_deserialize)
@@ -232,7 +235,7 @@ class VehiclesController(BaseController):
             .header_param(Parameter()
                 .key("accept")
                 .value("application/json"))
-            .auth(Single("bearerAuth")),
+            .auth(And(Single("bearerAuth"), Single("oauth2"))),
         ).response(
             ResponseHandler()
             .deserializer(APIHelper.json_deserialize)
@@ -269,7 +272,7 @@ class VehiclesController(BaseController):
             .header_param(Parameter()
                 .key("accept")
                 .value("application/json"))
-            .auth(Single("bearerAuth")),
+            .auth(And(Single("bearerAuth"), Single("oauth2"))),
         ).response(
             ResponseHandler()
             .deserializer(APIHelper.json_deserialize)
@@ -306,7 +309,7 @@ class VehiclesController(BaseController):
             .header_param(Parameter()
                 .key("accept")
                 .value("application/json"))
-            .auth(Single("bearerAuth")),
+            .auth(And(Single("bearerAuth"), Single("oauth2"))),
         ).response(
             ResponseHandler()
             .deserializer(APIHelper.json_deserialize)
@@ -342,7 +345,7 @@ class VehiclesController(BaseController):
             .header_param(Parameter()
                 .key("accept")
                 .value("application/json"))
-            .auth(Single("bearerAuth")),
+            .auth(And(Single("bearerAuth"), Single("oauth2"))),
         ).response(
             ResponseHandler()
             .deserializer(APIHelper.json_deserialize)
@@ -370,7 +373,7 @@ class VehiclesController(BaseController):
             .header_param(Parameter()
                 .key("accept")
                 .value("application/json"))
-            .auth(Single("bearerAuth")),
+            .auth(And(Single("bearerAuth"), Single("oauth2"))),
         ).response(
             ResponseHandler()
             .deserializer(APIHelper.json_deserialize)
@@ -407,7 +410,7 @@ class VehiclesController(BaseController):
             .header_param(Parameter()
                 .key("accept")
                 .value("application/json"))
-            .auth(Single("bearerAuth")),
+            .auth(And(Single("bearerAuth"), Single("oauth2"))),
         ).response(
             ResponseHandler()
             .deserializer(APIHelper.json_deserialize)
@@ -444,7 +447,7 @@ class VehiclesController(BaseController):
             .header_param(Parameter()
                 .key("accept")
                 .value("application/json"))
-            .auth(Single("bearerAuth")),
+            .auth(And(Single("bearerAuth"), Single("oauth2"))),
         ).response(
             ResponseHandler()
             .deserializer(APIHelper.json_deserialize)
@@ -481,7 +484,7 @@ class VehiclesController(BaseController):
             .header_param(Parameter()
                 .key("accept")
                 .value("application/json"))
-            .auth(Single("bearerAuth")),
+            .auth(And(Single("bearerAuth"), Single("oauth2"))),
         ).response(
             ResponseHandler()
             .deserializer(APIHelper.json_deserialize)
@@ -517,7 +520,7 @@ class VehiclesController(BaseController):
             .header_param(Parameter()
                 .key("accept")
                 .value("application/json"))
-            .auth(Single("bearerAuth")),
+            .auth(And(Single("bearerAuth"), Single("oauth2"))),
         ).response(
             ResponseHandler()
             .deserializer(APIHelper.json_deserialize)
@@ -560,7 +563,7 @@ class VehiclesController(BaseController):
                 .value(body)
                 .is_required(True))
             .body_serializer(APIHelper.json_serialize)
-            .auth(Single("bearerAuth")),
+            .auth(And(Single("bearerAuth"), Single("oauth2"))),
         ).response(
             ResponseHandler()
             .is_api_response(True),
@@ -595,7 +598,7 @@ class VehiclesController(BaseController):
             .header_param(Parameter()
                 .key("accept")
                 .value("application/json"))
-            .auth(Single("bearerAuth")),
+            .auth(And(Single("bearerAuth"), Single("oauth2"))),
         ).response(
             ResponseHandler()
             .deserializer(APIHelper.json_deserialize)
@@ -633,7 +636,7 @@ class VehiclesController(BaseController):
                 .key("accept")
                 .value("application/json"))
             .body_serializer(APIHelper.json_serialize)
-            .auth(Single("bearerAuth")),
+            .auth(And(Single("bearerAuth"), Single("oauth2"))),
         ).response(
             ResponseHandler()
             .deserializer(APIHelper.json_deserialize)
@@ -672,7 +675,7 @@ class VehiclesController(BaseController):
                 .key("accept")
                 .value("application/json"))
             .body_serializer(APIHelper.json_serialize)
-            .auth(Single("bearerAuth")),
+            .auth(And(Single("bearerAuth"), Single("oauth2"))),
         ).response(
             ResponseHandler()
             .deserializer(APIHelper.json_deserialize)
@@ -710,7 +713,7 @@ class VehiclesController(BaseController):
             .header_param(Parameter()
                 .key("accept")
                 .value("application/json"))
-            .auth(Single("bearerAuth")),
+            .auth(And(Single("bearerAuth"), Single("oauth2"))),
         ).response(
             ResponseHandler()
             .deserializer(APIHelper.json_deserialize)
@@ -747,7 +750,7 @@ class VehiclesController(BaseController):
             .header_param(Parameter()
                 .key("accept")
                 .value("application/json"))
-            .auth(Single("bearerAuth")),
+            .auth(And(Single("bearerAuth"), Single("oauth2"))),
         ).response(
             ResponseHandler()
             .deserializer(APIHelper.json_deserialize)
@@ -787,7 +790,7 @@ class VehiclesController(BaseController):
                 .key("accept")
                 .value("application/json"))
             .body_serializer(APIHelper.json_serialize)
-            .auth(Single("bearerAuth")),
+            .auth(And(Single("bearerAuth"), Single("oauth2"))),
         ).response(
             ResponseHandler()
             .deserializer(APIHelper.json_deserialize)
@@ -824,7 +827,7 @@ class VehiclesController(BaseController):
             .header_param(Parameter()
                 .key("accept")
                 .value("application/json"))
-            .auth(Single("bearerAuth")),
+            .auth(And(Single("bearerAuth"), Single("oauth2"))),
         ).response(
             ResponseHandler()
             .deserializer(APIHelper.json_deserialize)

teslafleetmanagementapi/exceptions/__init__.py

@@ -2,5 +2,5 @@
 # ruff: noqa: RUF022 | `__all__` is not sorted
 __all__ = [
     "api_exception",
-    "oauth_provider_exception",
+    "o_auth_provider_exception",
 ]

teslafleetmanagementapi/exceptions/{oauth_provider_exception.py → o_auth_provider_exception.py}

@@ -12,9 +12,9 @@ from teslafleetmanagementapi.exceptions.api_exception import (
 )
 
 
-class OauthProviderException(ApiException):
+class OAuthProviderException(ApiException):
     def __init__(self, reason, response):
-        """Initialize OauthProviderException object.
+        """Initialize OAuthProviderException object.
 
         Args:
             reason (string): The reason (or error message) for the Exception
@@ -22,7 +22,7 @@ class OauthProviderException(ApiException):
             response (HttpResponse): The HttpResponse of the API call.
 
         """
-        super(OauthProviderException, self).__init__(reason, response)
+        super(OAuthProviderException, self).__init__(reason, response)
         dictionary = APIHelper.json_deserialize(self.response.text)
         if isinstance(dictionary, dict):
             self.unbox(dictionary)

teslafleetmanagementapi/http/auth/oauth_2.py

@@ -21,11 +21,11 @@ from teslafleetmanagementapi.api_helper import (
 from teslafleetmanagementapi.configuration import (
     Server,
 )
-from teslafleetmanagementapi.controllers.oauth_authorization_controller import (
-    OauthAuthorizationController,
+from teslafleetmanagementapi.controllers.o_auth_authorization_controller import (
+    OAuthAuthorizationController,
 )
-from teslafleetmanagementapi.models.oauth_token import (
-    OauthToken,
+from teslafleetmanagementapi.models.o_auth_token import (
+    OAuthToken,
 )
 
 
@@ -51,25 +51,30 @@ class Oauth2(HeaderAuth):
             config: The configuration instance.
 
         """
-        self._oauth_client_id = auth_credentials_model.oauth_client_id \
+        self._o_auth_client_id = auth_credentials_model.o_auth_client_id \
             if auth_credentials_model is not None else None
-        self._oauth_client_secret = auth_credentials_model.oauth_client_secret \
+        self._o_auth_client_secret = auth_credentials_model.o_auth_client_secret \
             if auth_credentials_model is not None else None
-        self._oauth_redirect_uri = auth_credentials_model.oauth_redirect_uri \
+        self._o_auth_redirect_uri = auth_credentials_model.o_auth_redirect_uri \
             if auth_credentials_model is not None else None
         if auth_credentials_model is not None \
-                and isinstance(auth_credentials_model.oauth_token, OauthToken):
-            self._oauth_token = OauthToken.from_dictionary(
-                APIHelper.to_dictionary(auth_credentials_model.oauth_token))
+                and isinstance(auth_credentials_model.o_auth_token, OAuthToken):
+            self._o_auth_token = OAuthToken.from_dictionary(
+                APIHelper.to_dictionary(auth_credentials_model.o_auth_token))
         else:
-            self._oauth_token = auth_credentials_model.oauth_token \
+            self._o_auth_token = auth_credentials_model.o_auth_token \
                 if auth_credentials_model is not None else None
+        if auth_credentials_model is not None \
+                and isinstance(auth_credentials_model.o_auth_scopes, list):
+            self._o_auth_scopes = auth_credentials_model.o_auth_scopes
+        else:
+            self._o_auth_scopes = None
         self._config = config
-        self._o_auth_api = OauthAuthorizationController(config)
+        self._o_auth_api = OAuthAuthorizationController(config)
         auth_params = {}
-        if (isinstance(self._oauth_token, OauthToken)
-                and hasattr(self._oauth_token, "access_token")):
-            auth_params = {"Authorization": f"Bearer {self._oauth_token.access_token}"}
+        if (isinstance(self._o_auth_token, OAuthToken)
+                and hasattr(self._o_auth_token, "access_token")):
+            auth_params = {"Authorization": f"Bearer {self._o_auth_token.access_token}"}
         super().__init__(auth_params=auth_params)
 
     def is_valid(self):
@@ -80,8 +85,8 @@ class Oauth2(HeaderAuth):
             bool: True if the credentials are valid, False otherwise.
 
         """
-        return (self._oauth_token and isinstance(self._oauth_token, OauthToken)
-                and not self.is_token_expired(self._oauth_token))
+        return (self._o_auth_token and isinstance(self._o_auth_token, OAuthToken)
+                and not self.is_token_expired(self._o_auth_token))
 
     def get_authorization_url(self, state=None, additional_params=None):
         """
@@ -102,9 +107,11 @@ class Oauth2(HeaderAuth):
         auth_url += "/authorize"
         query_params = {
             "response_type": "code",
-            "client_id": self._oauth_client_id,
-            "redirect_uri": self._oauth_redirect_uri,
+            "client_id": self._o_auth_client_id,
+            "redirect_uri": self._o_auth_redirect_uri,
         }
+        if self._o_auth_scopes:
+            query_params["scope"] = " ".join(self._o_auth_scopes)
         if state:
             query_params["state"] = state
         if additional_params:
@@ -122,8 +129,8 @@ class Oauth2(HeaderAuth):
 
         """
         encoded = AuthHelper.get_base64_encoded_value(
-            self._oauth_client_id,
-            self._oauth_client_secret,
+            self._o_auth_client_id,
+            self._o_auth_client_secret,
         )
         return f"Basic {encoded}"
 
@@ -142,7 +149,7 @@ class Oauth2(HeaderAuth):
         token = self._o_auth_api.request_token_oauth_2(
             self.build_basic_auth_header(),
             auth_code,
-            self._oauth_redirect_uri,
+            self._o_auth_redirect_uri,
             _optional_form_parameters=additional_params,
         ).body
         if hasattr(token, "expires_in"):
@@ -153,25 +160,25 @@ class Oauth2(HeaderAuth):
             )
         return token
 
-    def is_token_expired(self, oauth_token=None):
+    def is_token_expired(self, o_auth_token=None):
         """
         Check if OAuth token has expired.
 
         Args:
-            oauth_token (OauthToken): The OAuth token whose expiry is to be checked.
+            o_auth_token (OAuthToken): The OAuth token whose expiry is to be checked.
 
         Returns:
             bool: True if OAuth token has expired, False otherwise.
 
         """
-        if oauth_token is None:
-            return (hasattr(self._oauth_token, "expiry")
+        if o_auth_token is None:
+            return (hasattr(self._o_auth_token, "expiry")
                     and AuthHelper.is_token_expired(
-                        self._oauth_token.expiry))
+                        self._o_auth_token.expiry))
 
-        return (hasattr(oauth_token, "expiry")
+        return (hasattr(o_auth_token, "expiry")
                 and AuthHelper.is_token_expired(
-                    oauth_token.expiry))
+                    o_auth_token.expiry))
 
     def refresh_token(self, additional_params=None):
         """
@@ -186,7 +193,8 @@ class Oauth2(HeaderAuth):
         """
         token = self._o_auth_api.refresh_token_oauth_2(
             self.build_basic_auth_header(),
-            self._oauth_token.refresh_token,
+            self._o_auth_token.refresh_token,
+            " ".join(self._o_auth_scopes) if self._o_auth_scopes else None,
             _optional_form_parameters=additional_params,
         ).body
         if hasattr(token, "expires_in"):
@@ -206,76 +214,88 @@ class Oauth2Credentials:
     """
 
     @property
-    def oauth_client_id(self):
+    def o_auth_client_id(self):
         """
         OAuth 2 Client ID.
         """
-        return self._oauth_client_id
+        return self._o_auth_client_id
 
     @property
-    def oauth_client_secret(self):
+    def o_auth_client_secret(self):
         """
         OAuth 2 Client Secret.
         """
-        return self._oauth_client_secret
+        return self._o_auth_client_secret
 
     @property
-    def oauth_redirect_uri(self):
+    def o_auth_redirect_uri(self):
         """
         OAuth 2 Redirection endpoint or Callback Uri.
         """
-        return self._oauth_redirect_uri
+        return self._o_auth_redirect_uri
 
     @property
-    def oauth_token(self):
+    def o_auth_token(self):
         """
         Object for storing information about the OAuth token.
         """
-        return self._oauth_token
+        return self._o_auth_token
 
-    def __init__(self, oauth_client_id, oauth_client_secret, oauth_redirect_uri,
-                 oauth_token=None):
+    @property
+    def o_auth_scopes(self):
+        """
+        List of scopes that apply to the OAuth token.
+        """
+        return self._o_auth_scopes
+
+    def __init__(self, o_auth_client_id, o_auth_client_secret,
+                 o_auth_redirect_uri, o_auth_token=None, o_auth_scopes=None):
         """
         Initialize the credentials.
 
         Args:
-            oauth_client_id: The oauth_client_id property value to set.
-            oauth_client_secret: The oauth_client_secret property value to set.
-            oauth_redirect_uri: The oauth_redirect_uri property value to set.
-            oauth_token: The oauth_token property value to set.
+            o_auth_client_id: The o_auth_client_id property value to set.
+            o_auth_client_secret: The o_auth_client_secret property value to set.
+            o_auth_redirect_uri: The o_auth_redirect_uri property value to set.
+            o_auth_token: The o_auth_token property value to set.
+            o_auth_scopes: The o_auth_scopes property value to set.
 
         Raises:
             ValueError: If any required value is missing.
 
         """
-        if oauth_client_id is None:
-            raise ValueError("oauth_client_id cannot be None")
-        if oauth_client_secret is None:
-            raise ValueError("oauth_client_secret cannot be None")
-        if oauth_redirect_uri is None:
-            raise ValueError("oauth_redirect_uri cannot be None")
-        self._oauth_client_id = oauth_client_id
-        self._oauth_client_secret = oauth_client_secret
-        self._oauth_redirect_uri = oauth_redirect_uri
-        self._oauth_token = oauth_token
+        if o_auth_client_id is None:
+            raise ValueError("o_auth_client_id cannot be None")
+        if o_auth_client_secret is None:
+            raise ValueError("o_auth_client_secret cannot be None")
+        if o_auth_redirect_uri is None:
+            raise ValueError("o_auth_redirect_uri cannot be None")
+        self._o_auth_client_id = o_auth_client_id
+        self._o_auth_client_secret = o_auth_client_secret
+        self._o_auth_redirect_uri = o_auth_redirect_uri
+        self._o_auth_token = o_auth_token
+        self._o_auth_scopes = o_auth_scopes
 
-    def clone_with(self, oauth_client_id=None, oauth_client_secret=None,
-                   oauth_redirect_uri=None, oauth_token=None):
+    def clone_with(self, o_auth_client_id=None, o_auth_client_secret=None,
+                   o_auth_redirect_uri=None, o_auth_token=None,
+                   o_auth_scopes=None):
         """
         Return a new instance with optional value overrides.
 
         Args:
-            oauth_client_id: The oauth_client_id property value to set.
-            oauth_client_secret: The oauth_client_secret property value to set.
-            oauth_redirect_uri: The oauth_redirect_uri property value to set.
-            oauth_token: The oauth_token property value to set.
+            o_auth_client_id: The o_auth_client_id property value to set.
+            o_auth_client_secret: The o_auth_client_secret property value to set.
+            o_auth_redirect_uri: The o_auth_redirect_uri property value to set.
+            o_auth_token: The o_auth_token property value to set.
+            o_auth_scopes: The o_auth_scopes property value to set.
 
         """
         return Oauth2Credentials(
-            oauth_client_id or self.oauth_client_id,
-            oauth_client_secret or self.oauth_client_secret,
-            oauth_redirect_uri or self.oauth_redirect_uri,
-            oauth_token or self.oauth_token)
+            o_auth_client_id or self.o_auth_client_id,
+            o_auth_client_secret or self.o_auth_client_secret,
+            o_auth_redirect_uri or self.o_auth_redirect_uri,
+            o_auth_token or self.o_auth_token,
+            o_auth_scopes or self.o_auth_scopes)
 
     @classmethod
     def from_environment(cls):
@@ -286,26 +306,35 @@ class Oauth2Credentials:
             A credentials instance or ``None`` if values are missing.
 
         """
-        oauth_client_id = os.getenv(
-            "OAUTH_2_OAUTH_CLIENT_ID",
+        o_auth_client_id = os.getenv(
+            "OAUTH_2_O_AUTH_CLIENT_ID",
+            None,
+        )
+        o_auth_client_secret = os.getenv(
+            "OAUTH_2_O_AUTH_CLIENT_SECRET",
             None,
         )
-        oauth_client_secret = os.getenv(
-            "OAUTH_2_OAUTH_CLIENT_SECRET",
+        o_auth_redirect_uri = os.getenv(
+            "OAUTH_2_O_AUTH_REDIRECT_URI",
             None,
         )
-        oauth_redirect_uri = os.getenv(
-            "OAUTH_2_OAUTH_REDIRECT_URI",
+        o_auth_scopes = os.getenv(
+            "OAUTH_2_O_AUTH_SCOPES",
             None,
         )
 
-        if (oauth_client_id is None
-                or oauth_client_secret is None
-                or oauth_redirect_uri is None):
+        if (o_auth_client_id is None
+                or o_auth_client_secret is None
+                or o_auth_redirect_uri is None):
             return None
 
+        o_auth_scopes = [
+            v.strip() for v in o_auth_scopes.split(",") if v.strip()
+        ] if o_auth_scopes else None
+
         return cls(
-            oauth_client_id=oauth_client_id,
-            oauth_client_secret=oauth_client_secret,
-            oauth_redirect_uri=oauth_redirect_uri,
+            o_auth_client_id=o_auth_client_id,
+            o_auth_client_secret=o_auth_client_secret,
+            o_auth_redirect_uri=o_auth_redirect_uri,
+            o_auth_scopes=o_auth_scopes,
         )

teslafleetmanagementapi/models/__init__.py

@@ -1,6 +1,10 @@
 # ruff: noqa: D104 | Missing docstring in public package
 # ruff: noqa: RUF022 | `__all__` is not sorted
 __all__ = [
+    "actuate_trunk_request",
+    "add_charge_schedule_request",
+    "add_precondition_schedule_request",
+    "adjust_volume_request",
     "api_1_dx_vehicles_options_response",
     "api_1_dx_warranty_details_response",
     "api_1_vehicles_mobile_enabled_response",
@@ -26,6 +30,8 @@ __all__ = [
     "charging_session",
     "charging_sessions_data",
     "charging_sessions_response",
+    "command_response",
+    "command_result",
     "default_real_mode",
     "driver",
     "drivers_response",
@@ -36,6 +42,7 @@ __all__ = [
     "fleet_telemetry_errors_response",
     "fleet_telemetry_jws_request",
     "generic_update_response",
+    "guest_mode_request",
     "kind",
     "kind_get_wall_connector_charging_history",
     "live_status_response",
@@ -43,8 +50,9 @@ __all__ = [
     "location_1",
     "me_response",
     "mobile_enabled",
-    "oauth_provider_error",
-    "oauth_token",
+    "o_auth_provider_error",
+    "o_auth_scope_oauth_2",
+    "o_auth_token",
     "off_grid_vehicle_charging_reserve_request",
     "operation_request",
     "orders_response",
@@ -81,5 +89,6 @@ __all__ = [
     "tou_settings",
     "vehicle_base",
     "vehicle_option",
-    "warranty_item",
+    "warranty_item",
+    "which_trunk",
 ]