import time from typing import Optional, Union try: import requests except ImportError: requests = None from ._version import VERSION from ._exceptions import APIException from .actions.client import ActionsClient from .certificates.client import CertificatesClient from .datacenters.client import DatacentersClient from .firewalls.client import FirewallsClient from .floating_ips.client import FloatingIPsClient from .images.client import ImagesClient from .isos.client import IsosClient from .load_balancer_types.client import LoadBalancerTypesClient from .load_balancers.client import LoadBalancersClient from .locations.client import LocationsClient from .networks.client import NetworksClient from .placement_groups.client import PlacementGroupsClient from .primary_ips.client import PrimaryIPsClient from .server_types.client import ServerTypesClient from .servers.client import ServersClient from .ssh_keys.client import SSHKeysClient from .volumes.client import VolumesClient class Client: """Base Client for accessing the Hetzner Cloud API""" _version = VERSION _retry_wait_time = 0.5 __user_agent_prefix = "hcloud-python" def __init__( self, token: str, api_endpoint: str = "https://api.hetzner.cloud/v1", application_name: Optional[str] = None, application_version: Optional[str] = None, poll_interval: int = 1, ): """Create an new Client instance :param token: Hetzner Cloud API token :param api_endpoint: Hetzner Cloud API endpoint :param application_name: Your application name :param application_version: Your application _version :param poll_interval: Interval for polling information from Hetzner Cloud API in seconds """ self.token = token self._api_endpoint = api_endpoint self._application_name = application_name self._application_version = application_version self._requests_session = requests.Session() self.poll_interval = poll_interval self.datacenters = DatacentersClient(self) """DatacentersClient Instance :type: :class:`DatacentersClient ` """ self.locations = LocationsClient(self) """LocationsClient Instance :type: :class:`LocationsClient ` """ self.servers = ServersClient(self) """ServersClient Instance :type: :class:`ServersClient ` """ self.server_types = ServerTypesClient(self) """ServerTypesClient Instance :type: :class:`ServerTypesClient ` """ self.volumes = VolumesClient(self) """VolumesClient Instance :type: :class:`VolumesClient ` """ self.actions = ActionsClient(self) """ActionsClient Instance :type: :class:`ActionsClient ` """ self.images = ImagesClient(self) """ImagesClient Instance :type: :class:`ImagesClient ` """ self.isos = IsosClient(self) """ImagesClient Instance :type: :class:`IsosClient ` """ self.ssh_keys = SSHKeysClient(self) """SSHKeysClient Instance :type: :class:`SSHKeysClient ` """ self.floating_ips = FloatingIPsClient(self) """FloatingIPsClient Instance :type: :class:`FloatingIPsClient ` """ self.primary_ips = PrimaryIPsClient(self) """PrimaryIPsClient Instance :type: :class:`PrimaryIPsClient ` """ self.networks = NetworksClient(self) """NetworksClient Instance :type: :class:`NetworksClient ` """ self.certificates = CertificatesClient(self) """CertificatesClient Instance :type: :class:`CertificatesClient ` """ self.load_balancers = LoadBalancersClient(self) """LoadBalancersClient Instance :type: :class:`LoadBalancersClient ` """ self.load_balancer_types = LoadBalancerTypesClient(self) """LoadBalancerTypesClient Instance :type: :class:`LoadBalancerTypesClient ` """ self.firewalls = FirewallsClient(self) """FirewallsClient Instance :type: :class:`FirewallsClient ` """ self.placement_groups = PlacementGroupsClient(self) """PlacementGroupsClient Instance :type: :class:`PlacementGroupsClient ` """ def _get_user_agent(self) -> str: """Get the user agent of the hcloud-python instance with the user application name (if specified) :return: The user agent of this hcloud-python instance """ user_agents = [] for name, version in [ (self._application_name, self._application_version), (self.__user_agent_prefix, self._version), ]: if name is not None: user_agents.append(name if version is None else f"{name}/{version}") return " ".join(user_agents) def _get_headers(self) -> dict: headers = { "User-Agent": self._get_user_agent(), "Authorization": f"Bearer {self.token}", } return headers def _raise_exception_from_response(self, response): raise APIException( code=response.status_code, message=response.reason, details={"content": response.content}, ) def _raise_exception_from_content(self, content: dict): raise APIException( code=content["error"]["code"], message=content["error"]["message"], details=content["error"]["details"], ) def request( self, method: str, url: str, tries: int = 1, **kwargs, ) -> Union[bytes, dict]: """Perform a request to the Hetzner Cloud API, wrapper around requests.request :param method: HTTP Method to perform the Request :param url: URL of the Endpoint :param tries: Tries of the request (used internally, should not be set by the user) :return: Response """ response = self._requests_session.request( method=method, url=self._api_endpoint + url, headers=self._get_headers(), **kwargs, ) content = response.content try: if len(content) > 0: content = response.json() except (TypeError, ValueError): self._raise_exception_from_response(response) if not response.ok: if content: if content["error"]["code"] == "rate_limit_exceeded" and tries < 5: time.sleep(tries * self._retry_wait_time) tries = tries + 1 return self.request(method, url, tries, **kwargs) else: self._raise_exception_from_content(content) else: self._raise_exception_from_response(response) return content