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

teslafleetmanagementapi/http/http_request.py

@@ -0,0 +1,55 @@
+
+"""
+teslafleetmanagementapi
+
+This file was automatically generated by APIMATIC v3.0 (
+ https://www.apimatic.io ).
+"""
+
+from apimatic_core.http.request.http_request import HttpRequest as CoreHttpRequest
+
+
+class HttpRequest(CoreHttpRequest):
+    """
+    Represent an HTTP request to be sent to the server.
+
+    Encapsulates request details such as the HTTP method, target URL, headers,
+     query parameters, body parameters, and any files included with the request.
+
+    Attributes:
+        http_method: The HTTP method to use for the request.
+        query_url (str): The URL to which the request will be sent.
+        headers (dict[str, str] | None): Headers to include with the request.
+        query_parameters (dict[str, str] | None): Query parameters appended
+            to the request URL.
+        parameters (dict[str, str] | None): Form or body parameters sent
+            with the request.
+        files (dict | None): Files to be sent with the request.
+
+    """
+
+    def __init__(self,
+                 http_method,
+                 query_url,
+                 headers=None,
+                 query_parameters=None,
+                 parameters=None,
+                 files=None):
+        """
+        Initialize an HttpRequest instance.
+
+        Args:
+            http_method: The HTTP method to use for the request.
+            query_url: The URL to which the request will be sent.
+            headers: Headers to include with the request.
+            query_parameters: Query parameters appended to the request URL.
+            parameters: Form or body parameters sent with the request.
+            files: Files to be sent with the request.
+
+        """
+        super().__init__(http_method,
+                         query_url,
+                         headers,
+                         query_parameters,
+                         parameters,
+                         files)

teslafleetmanagementapi/http/http_response.py

@@ -0,0 +1,45 @@
+
+"""
+teslafleetmanagementapi
+
+This file was automatically generated by APIMATIC v3.0 (
+ https://www.apimatic.io ).
+"""
+
+from apimatic_core.http.response.http_response import HttpResponse as CoreHttpResponse
+
+
+class HttpResponse(CoreHttpResponse):
+    """
+    Represent an HTTP response returned by the server.
+
+    Stores response metadata such as status code, reason phrase, headers, and
+     the raw response body, along with the originating request.
+
+    Attributes:
+        status_code (int): The HTTP status code returned by the server.
+        reason_phrase (str): The reason phrase associated with the status code.
+        headers (dict[str, str]): Response headers as key-value pairs.
+        text (str): The raw response body as a string.
+        request: The request object that resulted in this response.
+
+    """
+
+    def __init__(self,
+                 status_code,
+                 reason_phrase,
+                 headers,
+                 text,
+                 request):
+        """
+        Initialize an HttpResponse instance.
+
+        Args:
+            status_code: The HTTP status code returned by the server.
+            reason_phrase: The reason phrase associated with the status code.
+            headers: Response headers as key-value pairs.
+            text: The raw response body as a string.
+            request: The request object that resulted in this response.
+
+        """
+        super().__init__(status_code, reason_phrase, headers, text, request)

teslafleetmanagementapi/http/proxy_settings.py

@@ -0,0 +1,50 @@
+"""
+teslafleetmanagementapi
+
+This file was automatically generated by APIMATIC v3.0 (
+ https://www.apimatic.io ).
+"""
+
+import os
+from typing import Optional
+
+from apimatic_core.http.configurations.proxy_settings import (
+    ProxySettings as CoreProxySettings,
+)
+
+
+class ProxySettings(CoreProxySettings):
+    """A simple data model for configuring HTTP(S) proxy settings."""
+
+    @classmethod
+    def from_environment(cls) -> Optional["ProxySettings"]:
+        """
+        Create an instance of this class using environment-based configuration.
+
+        This method attempts to construct and return an instance using relevant
+        environment variables, if available. If the required configuration is
+        not present, it may return `None` to indicate that no valid instance
+        could be created.
+
+        Returns:
+            Optional[cls]: A configured instance of this class, or `None` if
+            configuration data is missing or invalid.
+
+        """
+        address = os.getenv("PROXY_ADDRESS", None)
+        if not address:
+            return None
+
+        port = os.getenv("PROXY_PORT", None)
+        if port is not None:
+            try:
+                port = int(port)
+            except (TypeError, ValueError):
+                port = None
+
+        return cls(
+            address=address,
+            port=port,
+            username=os.getenv("PROXY_USERNAME", None),
+            password=os.getenv("PROXY_PASSWORD", None),
+        )

teslafleetmanagementapi/logging/__init__.py

@@ -0,0 +1,6 @@
+# ruff: noqa: D104 | Missing docstring in public package
+# ruff: noqa: RUF022 | `__all__` is not sorted
+__all__ = [
+    "configuration",
+    "sdk_logger",
+]

teslafleetmanagementapi/logging/configuration/__init__.py

@@ -0,0 +1,5 @@
+# ruff: noqa: D104 | Missing docstring in public package
+# ruff: noqa: RUF022 | `__all__` is not sorted
+__all__ = [
+    "api_logging_configuration",
+]

teslafleetmanagementapi/logging/configuration/api_logging_configuration.py

@@ -0,0 +1,398 @@
+
+"""
+teslafleetmanagementapi
+
+This file was automatically generated by APIMATIC v3.0 (
+ https://www.apimatic.io ).
+"""
+
+import logging
+import os
+
+from apimatic_core.logger.configuration.api_logging_configuration import (
+    ApiLoggingConfiguration,
+    ApiRequestLoggingConfiguration,
+    ApiResponseLoggingConfiguration,
+)
+
+
+class RequestLoggingConfiguration(ApiRequestLoggingConfiguration):
+    """
+    Configuration for controlling how API request details are logged.
+    Provides options to include or exclude data such as headers, query
+    parameters and request body to support flexible logging behavior.
+    """
+
+    def __init__(self, log_body=False, log_headers=False, headers_to_include=None,
+                 headers_to_exclude=None, headers_to_unmask=None,
+                 include_query_in_path=False):
+        """
+        Initialize the Request Logging Configuration.
+
+        Args:
+            log_body (bool): Controls the logging of the request body.
+            log_headers (bool): Controls the logging of request headers.
+            headers_to_include (List[str]): Includes only specified headers in
+             the log output.
+            headers_to_exclude (List[str]): Excludes specified headers from
+             the log output.
+            headers_to_unmask (List[str]): Logs specified headers without masking,
+             revealing their actual values.
+            include_query_in_path (bool): Determines whether to include query
+             parameters in the logged request path.
+
+        """
+        super().__init__(
+            log_body,
+            log_headers,
+            headers_to_include,
+            headers_to_exclude,
+            headers_to_unmask,
+            include_query_in_path,
+        )
+
+    def clone_with(self, log_body=None, log_headers=None,
+                   headers_to_include=None, headers_to_exclude=None,
+                   headers_to_unmask=None, include_query_in_path=False):
+        """
+        Create a copy of this configuration with overridden attributes.
+
+        Args:
+            log_body (bool): Optional override for logging the body.
+            log_headers (bool): Optional override for logging headers.
+            headers_to_include (List[str]): Optional override for included headers.
+            headers_to_exclude (List[str]): Optional override for excluded headers.
+            headers_to_unmask (List[str]): Optional override for unmasked headers.
+            include_query_in_path (bool): Optional override for including queries.
+
+        Returns:
+            RequestLoggingConfiguration: A new configuration instance.
+
+        """
+        log_body = log_body or self.log_body
+        log_headers = log_headers or self.log_headers
+        headers_to_include = headers_to_include or self.headers_to_include
+        headers_to_exclude = headers_to_exclude or self.headers_to_exclude
+        headers_to_unmask = headers_to_unmask or self.headers_to_unmask
+        include_query_in_path = include_query_in_path or self.include_query_in_path
+
+        return RequestLoggingConfiguration(
+            log_body,
+            log_headers,
+            headers_to_include,
+            headers_to_exclude,
+            headers_to_unmask,
+            include_query_in_path,
+        )
+
+    @classmethod
+    def from_dict(cls, dictionary):
+        """
+        Create an instance of RequestLoggingConfiguration from a dictionary.
+
+        Args:
+            dictionary (dict): The input data to convert from.
+
+        """
+        if not dictionary:
+            return cls()
+
+        headers_to_include = dictionary.get("headers_to_include")
+        headers_to_include = [
+            v.strip() for v in headers_to_include.split(",") if v.strip()
+        ] if headers_to_include else None
+
+        headers_to_exclude = dictionary.get("headers_to_exclude")
+        headers_to_exclude = [
+            v.strip() for v in headers_to_exclude.split(",") if v.strip()
+        ] if headers_to_exclude else None
+
+        headers_to_unmask = dictionary.get("headers_to_unmask")
+        headers_to_unmask = [
+            v.strip() for v in headers_to_unmask.split(",") if v.strip()
+        ] if headers_to_unmask else None
+
+        return cls(
+            log_body=dictionary.get("log_body", False),
+            log_headers=dictionary.get("log_headers", False),
+            headers_to_include=headers_to_include,
+            headers_to_exclude=headers_to_exclude,
+            headers_to_unmask=headers_to_unmask,
+            include_query_in_path=dictionary.get("include_query_in_path", False),
+        )
+
+class ResponseLoggingConfiguration(ApiResponseLoggingConfiguration):
+    """
+    Configuration for controlling how API response details are logged.
+    Supports selective logging of headers and body data while allowing
+    masking of sensitive response information.
+    """
+
+    def __init__(self, log_body=False, log_headers=False, headers_to_include=None,
+                 headers_to_exclude=None, headers_to_unmask=None):
+        """
+        Initialize the Response Logging Configuration.
+
+        Args:
+            log_body (bool): Controls the logging of the request body.
+            log_headers (bool): Controls the logging of request headers.
+            headers_to_include (List[str]): Includes only specified headers in the log
+             output.
+            headers_to_exclude (List[str]): Excludes specified headers from the log
+             output.
+            headers_to_unmask (List[str]): Logs specified headers without
+             masking, revealing their actual values.
+
+        """
+        super().__init__(
+            log_body,
+            log_headers,
+            headers_to_include,
+            headers_to_exclude,
+            headers_to_unmask,
+        )
+
+    def clone_with(self, log_body=None, log_headers=None,
+                   headers_to_include=None, headers_to_exclude=None,
+                   headers_to_unmask=None):
+        """
+        Create a copy of this configuration with overridden attributes.
+
+        Args:
+            log_body (bool): Optional override for logging the body.
+            log_headers (bool): Optional override for logging headers.
+            headers_to_include (List[str]): Optional override for included headers.
+            headers_to_exclude (List[str]): Optional override for excluded headers.
+            headers_to_unmask (List[str]): Optional override for unmasked headers.
+
+        Returns:
+            ResponseLoggingConfiguration: A new configuration instance.
+
+        """
+        log_body = log_body or self.log_body
+        log_headers = log_headers or self.log_headers
+        headers_to_include = headers_to_include or self.headers_to_include
+        headers_to_exclude = headers_to_exclude or self.headers_to_exclude
+        headers_to_unmask = headers_to_unmask or self.headers_to_unmask
+
+        return ResponseLoggingConfiguration(
+            log_body,
+            log_headers,
+            headers_to_include,
+            headers_to_exclude,
+            headers_to_unmask,
+        )
+
+    @classmethod
+    def from_dict(cls, dictionary):
+        """
+        Create an instance of ResponseLoggingConfiguration from a dictionary.
+
+        Args:
+            dictionary (dict): The input data to convert from.
+
+        """
+        if not dictionary:
+            return cls()
+
+        headers_to_include = dictionary.get("headers_to_include")
+        headers_to_include = [
+            v.strip() for v in headers_to_include.split(",") if v.strip()
+        ] if headers_to_include else None
+
+        headers_to_exclude = dictionary.get("headers_to_exclude")
+        headers_to_exclude = [
+            v.strip() for v in headers_to_exclude.split(",") if v.strip()
+        ] if headers_to_exclude else None
+
+        headers_to_unmask = dictionary.get("headers_to_unmask")
+        headers_to_unmask = [
+            v.strip() for v in headers_to_unmask.split(",") if v.strip()
+        ] if headers_to_unmask else None
+
+        return cls(
+            log_body=dictionary.get("log_body", False),
+            log_headers=dictionary.get("log_headers", False),
+            headers_to_include=headers_to_include,
+            headers_to_exclude=headers_to_exclude,
+            headers_to_unmask=headers_to_unmask,
+        )
+
+class LoggingConfiguration(ApiLoggingConfiguration):
+    """
+    High-level configuration for API logging behavior. Aggregates both
+    request and response logging settings and applies shared options such
+    as log level and header masking across log events.
+    """
+
+    def __init__(self, logger=None, log_level=None, mask_sensitive_headers=True,
+                 request_logging_config=None, response_logging_config=None):
+        """
+        Initialize the Logging Configuration.
+
+        Args:
+            logger (Logger): The logging implementation to log with.
+            log_level (LogLevel): The log level to apply to the log message.
+            mask_sensitive_headers (bool): Flag to control masking of sensitive headers.
+            request_logging_config (RequestLoggingConfiguration): The API request
+             logging configuration.
+            response_logging_config (ResponseLoggingConfiguration): The API response
+             logging configuration.
+
+        """
+        request_logging_config = request_logging_config or RequestLoggingConfiguration()
+        response_logging_config =\
+            response_logging_config or ResponseLoggingConfiguration()
+        super().__init__(
+            logger,
+            log_level,
+            mask_sensitive_headers,
+            request_logging_config,
+            response_logging_config,
+        )
+
+    def clone_with(self, logger=None, log_level=None, mask_sensitive_headers=None,
+                   request_logging_config=None, response_logging_config=None):
+        """
+        Create a copy of this configuration with overridden attributes.
+
+        Args:
+            logger (Logger): Optional override for the logging implementation.
+            log_level (bool): Optional override for logging level.
+            mask_sensitive_headers (bool): Optional override for masking headers.
+            request_logging_config (RequestLoggingConfiguration): Optional
+             override for request logging configuration.
+            response_logging_config (ResponseLoggingConfiguration): Optional
+             override for response logging configuration.
+
+        Returns:
+            LoggingConfiguration: A new configuration instance.
+
+        """
+        logger = logger or self.logger
+        log_level = log_level or self.log_level
+        mask_sensitive_headers = mask_sensitive_headers or self.mask_sensitive_headers
+        request_logging_config = request_logging_config or self.request_logging_config
+        response_logging_config =\
+            response_logging_config or self.response_logging_config
+
+        return LoggingConfiguration(
+            logger,
+            log_level,
+            mask_sensitive_headers,
+            request_logging_config,
+            response_logging_config,
+        )
+
+    @classmethod
+    def from_dict(cls, dictionary):
+        """
+        Create an instance of LoggingConfiguration from a dictionary.
+        Supports nested request/response logging config dictionaries.
+
+        Args:
+            dictionary (dict): The input data to convert from.
+
+        """
+        if not dictionary:
+            return None
+
+        req_config_dict = dictionary.get("request_logging_config") or {}
+        res_config_dict = dictionary.get("response_logging_config") or {}
+
+        return cls(
+            logger=dictionary.get("logger"),
+            log_level=dictionary.get("log_level"),
+            mask_sensitive_headers=dictionary.get("mask_sensitive_headers", True),
+            request_logging_config=RequestLoggingConfiguration.from_dict(req_config_dict),
+            response_logging_config=ResponseLoggingConfiguration.from_dict(res_config_dict),
+        )
+
+    @classmethod
+    def from_environment(cls):
+        """
+        Create a LoggingConfiguration instance based on environment variables.
+        Environment flags determine whether logging is enabled and how it is
+        configured for requests and responses.
+        """
+        request_logging_env = {
+            "log_body": os.getenv("REQUEST_LOG_BODY", None),
+            "log_headers": os.getenv("REQUEST_LOG_HEADERS", None),
+            "headers_to_include": os.getenv("REQUEST_HEADERS_TO_INCLUDE", None),
+            "headers_to_exclude": os.getenv("REQUEST_HEADERS_TO_EXCLUDE", None),
+            "headers_to_unmask": os.getenv("REQUEST_HEADERS_TO_UNMASK", None),
+            "include_query_in_path": os.getenv("REQUEST_INCLUDE_QUERY_IN_PATH", None),
+        }
+        # Only include if at least one env var is set
+        request_logging_config = (
+                {k: (v.lower() == "true" if v and v.lower() in ["true", "false"] else v)
+                 for k, v in request_logging_env.items() if v is not None}
+                or None
+        )
+
+        # Collect environment variables for response logging
+        response_logging_env = {
+            "log_body": os.getenv("RESPONSE_LOG_BODY", None),
+            "log_headers": os.getenv("RESPONSE_LOG_HEADERS", None),
+            "headers_to_include": os.getenv("RESPONSE_HEADERS_TO_INCLUDE", None),
+            "headers_to_exclude": os.getenv("RESPONSE_HEADERS_TO_EXCLUDE", None),
+            "headers_to_unmask": os.getenv("RESPONSE_HEADERS_TO_UNMASK", None),
+        }
+        response_logging_config = (
+                {k: (v.lower() == "true" if v and v.lower() in ["true", "false"] else v)
+                 for k, v in response_logging_env.items() if v is not None}
+                or None
+        )
+
+        # Determine if any logging-related env variable is set
+        has_logging_env = any([
+            os.getenv("LOG_LEVEL", None),
+            os.getenv("MASK_SENSITIVE_HEADERS", None),
+            request_logging_config,
+            response_logging_config,
+        ])
+
+        log_level = cls._resolve_level(os.getenv("LOG_LEVEL", None))
+
+        # Only instantiate LoggingConfiguration if something is configured
+        return cls.from_dict({
+            "log_level": log_level,
+            "mask_sensitive_headers": os.getenv("MASK_SENSITIVE_HEADERS",
+                                                "true").lower() == "true",
+            "request_logging_config": request_logging_config,
+            "response_logging_config": response_logging_config,
+        }) if has_logging_env else None
+
+    @staticmethod
+    def _resolve_level(value):
+        """
+        Resolve a log level from a string or numeric representation.
+
+        Args:
+            value (str|int): The desired level or its textual name.
+
+        Returns:
+            int: The resolved Python logging level constant.
+
+        """
+        if value is None:
+            return None
+
+        possible_levels = {
+            logging.CRITICAL,
+            logging.ERROR,
+            logging.WARNING,
+            logging.INFO,
+            logging.DEBUG,
+            logging.NOTSET,
+        }
+        # handle numeric values (string or int)
+        if value.isdigit():
+            return int(value) if int(value) in possible_levels else logging.INFO
+        # handle string log level names
+        if isinstance(value, str):
+            level = logging.getLevelName(value.upper())
+            if isinstance(level, int):
+                return level
+
+        return logging.INFO

teslafleetmanagementapi/logging/sdk_logger.py

@@ -0,0 +1,28 @@
+
+"""
+teslafleetmanagementapi
+
+This file was automatically generated by APIMATIC v3.0 (
+ https://www.apimatic.io ).
+"""
+
+from abc import abstractmethod
+
+from apimatic_core_interfaces.logger.logger import Logger
+
+
+class AbstractLogger(Logger):
+    """An abstract class for custom logger implementation."""
+
+    @abstractmethod
+    def log(self, level, message, params):
+        """
+        Log a message with a specified log level and additional parameters.
+
+        Args:
+            level (int): The log level of the message.
+            message (str): The message to log.
+            params (dict): Additional parameters to include in the log message.
+
+        """
+        ...

teslafleetmanagementapi/models/__init__.py

@@ -0,0 +1,85 @@
+# ruff: noqa: D104 | Missing docstring in public package
+# ruff: noqa: RUF022 | `__all__` is not sorted
+__all__ = [
+    "api_1_dx_vehicles_options_response",
+    "api_1_dx_warranty_details_response",
+    "api_1_vehicles_mobile_enabled_response",
+    "api_1_vehicles_nearby_charging_sites_response",
+    "api_1_vehicles_response",
+    "api_1_vehicles_response_get_vehicle",
+    "api_1_vehicles_wake_up_response",
+    "backup_request",
+    "backup_response",
+    "calendar_history_response",
+    "charge_duration",
+    "charge_history",
+    "charge_history_response",
+    "charge_start_time",
+    "charging_dimension",
+    "charging_fee",
+    "charging_history_data",
+    "charging_history_item",
+    "charging_history_response",
+    "charging_invoice",
+    "charging_location",
+    "charging_period",
+    "charging_session",
+    "charging_sessions_data",
+    "charging_sessions_response",
+    "default_real_mode",
+    "driver",
+    "drivers_response",
+    "enterprise_payer_request",
+    "event",
+    "fleet_status_request",
+    "fleet_telemetry_error",
+    "fleet_telemetry_errors_response",
+    "fleet_telemetry_jws_request",
+    "generic_update_response",
+    "kind",
+    "kind_get_wall_connector_charging_history",
+    "live_status_response",
+    "location",
+    "location_1",
+    "me_response",
+    "mobile_enabled",
+    "oauth_provider_error",
+    "oauth_token",
+    "off_grid_vehicle_charging_reserve_request",
+    "operation_request",
+    "orders_response",
+    "pagination",
+    "price_component",
+    "products_response",
+    "public_key_response",
+    "region_response",
+    "register_partner_request",
+    "register_partner_response",
+    "response",
+    "response_1",
+    "response_2",
+    "response_3",
+    "response_api_1_dx_vehicles_options_response",
+    "response_api_1_dx_warranty_details_response",
+    "response_calendar_history_response",
+    "response_charge_history_response",
+    "response_fleet_telemetry_errors_response",
+    "response_live_status_response",
+    "response_me_response",
+    "response_orders_response",
+    "response_public_key_response",
+    "response_region_response",
+    "response_register_partner_response",
+    "signaling",
+    "simple_ok_response",
+    "site_info_response",
+    "storm_mode_request",
+    "tariff_element",
+    "tariffs",
+    "time_of_use_settings_request",
+    "total_cost",
+    "tou_settings",
+    "vehicle_base",
+    "vehicle_option",
+    "warranty_item",
+]