Initial commit: Email alerts application

2025-07-25 11:31:36 +01:00
commit adfb625ae9
6322 changed files with 2882826 additions and 0 deletions
@@ -0,0 +1,114 @@
+import logging
+from typing import Dict, Optional, Tuple
+
+from requests import Request, Session, hooks
+from requests.adapters import HTTPAdapter
+
+from twilio.http import HttpClient
+from twilio.http.request import Request as TwilioRequest
+from twilio.http.response import Response
+
+_logger = logging.getLogger("twilio.http_client")
+
+
+class TwilioHttpClient(HttpClient):
+    """
+    General purpose HTTP Client for interacting with the Twilio API
+    """
+
+    def __init__(
+        self,
+        pool_connections: bool = True,
+        request_hooks: Optional[Dict[str, object]] = None,
+        timeout: Optional[float] = None,
+        logger: logging.Logger = _logger,
+        proxy: Optional[Dict[str, str]] = None,
+        max_retries: Optional[int] = None,
+    ):
+        """
+        Constructor for the TwilioHttpClient
+
+        :param pool_connections
+        :param request_hooks
+        :param timeout: Timeout for the requests.
+                        Timeout should never be zero (0) or less.
+        :param logger
+        :param proxy: Http proxy for the requests session
+        :param max_retries: Maximum number of retries each request should attempt
+        """
+        super().__init__(logger, False, timeout)
+        self.session = Session() if pool_connections else None
+        if self.session and max_retries is not None:
+            self.session.mount("https://", HTTPAdapter(max_retries=max_retries))
+
+        self.request_hooks = request_hooks or hooks.default_hooks()
+        self.proxy = proxy if proxy else {}
+
+    def request(
+        self,
+        method: str,
+        url: str,
+        params: Optional[Dict[str, object]] = None,
+        data: Optional[Dict[str, object]] = None,
+        headers: Optional[Dict[str, str]] = None,
+        auth: Optional[Tuple[str, str]] = None,
+        timeout: Optional[float] = None,
+        allow_redirects: bool = False,
+    ) -> Response:
+        """
+        Make an HTTP Request with parameters provided.
+
+        :param method: The HTTP method to use
+        :param url: The URL to request
+        :param params: Query parameters to append to the URL
+        :param data: Parameters to go in the body of the HTTP request
+        :param headers: HTTP Headers to send with the request
+        :param auth: Basic Auth arguments
+        :param timeout: Socket/Read timeout for the request
+        :param allow_redirects: Whether or not to allow redirects
+        See the requests documentation for explanation of all these parameters
+
+        :return: An http response
+        """
+        if timeout is None:
+            timeout = self.timeout
+        elif timeout <= 0:
+            raise ValueError(timeout)
+
+        kwargs = {
+            "method": method.upper(),
+            "url": url,
+            "params": params,
+            "data": data,
+            "headers": headers,
+            "auth": auth,
+            "hooks": self.request_hooks,
+        }
+
+        self.log_request(kwargs)
+
+        self._test_only_last_response = None
+        session = self.session or Session()
+        request = Request(**kwargs)
+        self._test_only_last_request = TwilioRequest(**kwargs)
+
+        prepped_request = session.prepare_request(request)
+
+        settings = session.merge_environment_settings(
+            prepped_request.url, self.proxy, None, None, None
+        )
+
+        response = session.send(
+            prepped_request,
+            allow_redirects=allow_redirects,
+            timeout=timeout,
+            **settings
+        )
+
+        self.log_response(response.status_code, response)
+
+        self._test_only_last_response = Response(
+            int(response.status_code), response.text, response.headers
+        )
+
+        return self._test_only_last_response