sfq 0.0.9__py3-none-any.whl → 0.0.11__py3-none-any.whl

sfq/__init__.py

@@ -1,14 +1,19 @@
+import base64
 import http.client
 import json
 import logging
 import os
 import time
+import warnings
+from queue import Empty, Queue
 from typing import Any, Dict, Optional
 from urllib.parse import quote, urlparse
 
 TRACE = 5
 logging.addLevelName(TRACE, "TRACE")
 
+class ExperimentalWarning(Warning):
+    pass
 
 def trace(self: logging.Logger, message: str, *args: Any, **kwargs: Any) -> None:
     """Custom TRACE level logging function with redaction."""
@@ -16,25 +21,33 @@ def trace(self: logging.Logger, message: str, *args: Any, **kwargs: Any) -> None
     def _redact_sensitive(data: Any) -> Any:
         """Redacts sensitive keys from a dictionary or query string."""
         REDACT_VALUE = "*" * 8
+        REDACT_KEYS = [
+            "access_token",
+            "authorization",
+            "set-cookie",
+            "cookie",
+            "refresh_token",
+        ]
         if isinstance(data, dict):
             return {
-                k: (
-                    REDACT_VALUE
-                    if k.lower() in ["access_token", "authorization", "refresh_token"]
-                    else v
-                )
+                k: (REDACT_VALUE if k.lower() in REDACT_KEYS else v)
                 for k, v in data.items()
             }
+        elif isinstance(data, (list, tuple)):
+            return type(data)(
+                (
+                    (item[0], REDACT_VALUE)
+                    if isinstance(item, tuple) and item[0].lower() in REDACT_KEYS
+                    else item
+                    for item in data
+                )
+            )
         elif isinstance(data, str):
             parts = data.split("&")
             for i, part in enumerate(parts):
                 if "=" in part:
                     key, value = part.split("=", 1)
-                    if key.lower() in [
-                        "access_token",
-                        "authorization",
-                        "refresh_token",
-                    ]:
+                    if key.lower() in REDACT_KEYS:
                         parts[i] = f"{key}={REDACT_VALUE}"
             return "&".join(parts)
         return data
@@ -70,7 +83,7 @@ class SFAuth:
         access_token: Optional[str] = None,
         token_expiration_time: Optional[float] = None,
         token_lifetime: int = 15 * 60,
-        user_agent: str = "sfq/0.0.9",
+        user_agent: str = "sfq/0.0.11",
         proxy: str = "auto",
     ) -> None:
         """
@@ -84,7 +97,7 @@ class SFAuth:
         :param access_token: The access token for the current session (default is None).
         :param token_expiration_time: The expiration time of the access token (default is None).
         :param token_lifetime: The lifetime of the access token in seconds (default is 15 minutes).
-        :param user_agent: Custom User-Agent string (default is "sfq/0.0.9").
+        :param user_agent: Custom User-Agent string (default is "sfq/0.0.11").
         :param proxy: The proxy configuration, "auto" to use environment (default is "auto").
         """
         self.instance_url = instance_url
@@ -139,7 +152,7 @@ class SFAuth:
             logger.trace("Direct connection to %s", netloc)
         return conn
 
-    def _post_token_request(self, payload: Dict[str, str]) -> Optional[Dict[str, Any]]:
+    def _new_token_request(self, payload: Dict[str, str]) -> Optional[Dict[str, Any]]:
         """
         Send a POST request to the Salesforce token endpoint using http.client.
 
@@ -178,6 +191,7 @@ class SFAuth:
             logger.exception("Error during token request: %s", err)
 
         finally:
+            logger.trace("Closing connection.")
             conn.close()
 
         return None
@@ -229,7 +243,7 @@ class SFAuth:
 
         logger.trace("Access token expired or missing, refreshing...")
         payload = self._prepare_payload()
-        token_data = self._post_token_request(payload)
+        token_data = self._new_token_request(payload)
 
         if token_data:
             self.access_token = token_data.get("access_token")
@@ -239,7 +253,10 @@ class SFAuth:
                 self.org_id = token_data.get("id").split("/")[4]
                 self.user_id = token_data.get("id").split("/")[5]
                 logger.trace(
-                    "Authenticated as user %s in org %s", self.user_id, self.org_id
+                    "Authenticated as user %s for org %s (%s)",
+                    self.user_id,
+                    self.org_id,
+                    token_data.get("instance_url"),
                 )
             except (IndexError, KeyError):
                 logger.error("Failed to extract org/user IDs from token response.")
@@ -264,16 +281,194 @@ class SFAuth:
             logger.warning("Token expiration check failed. Treating token as expired.")
             return True
 
-    def tooling_query(self, query: str) -> Optional[Dict[str, Any]]:
+    def read_static_resource_name(
+        self, resource_name: str, namespace: Optional[str] = None
+    ) -> Optional[str]:
         """
-        Execute a SOQL query using the Tooling API.
+        Read a static resource for a given name from the Salesforce instance.
 
-        :param query: The SOQL query string.
+        :param resource_name: Name of the static resource to read.
+        :param namespace: Namespace of the static resource to read (default is None).
+        :return: Static resource content or None on failure.
+        """
+        _safe_resource_name = quote(resource_name, safe="")
+        query = f"SELECT Id FROM StaticResource WHERE Name = '{_safe_resource_name}'"
+        if namespace:
+            query += f" AND NamespacePrefix = '{namespace}'"
+        query += " LIMIT 1"
+        _static_resource_id_response = self.query(query)
+
+        if (
+            _static_resource_id_response
+            and _static_resource_id_response.get("records")
+            and len(_static_resource_id_response["records"]) > 0
+        ):
+            return self.read_static_resource_id(
+                _static_resource_id_response["records"][0].get("Id")
+            )
+
+        logger.error(f"Failed to read static resource with name {_safe_resource_name}.")
+        return None
+
+    def read_static_resource_id(self, resource_id: str) -> Optional[str]:
+        """
+        Read a static resource for a given ID from the Salesforce instance.
+
+        :param resource_id: ID of the static resource to read.
+        :return: Static resource content or None on failure.
+        """
+        self._refresh_token_if_needed()
+
+        if not self.access_token:
+            logger.error("No access token available for limits.")
+            return None
+
+        endpoint = f"/services/data/{self.api_version}/sobjects/StaticResource/{resource_id}/Body"
+        headers = {
+            "Authorization": f"Bearer {self.access_token}",
+            "User-Agent": self.user_agent,
+            "Accept": "application/json",
+        }
+
+        parsed_url = urlparse(self.instance_url)
+        conn = self._create_connection(parsed_url.netloc)
+
+        try:
+            logger.trace("Request endpoint: %s", endpoint)
+            logger.trace("Request headers: %s", headers)
+            conn.request("GET", endpoint, headers=headers)
+            response = conn.getresponse()
+            data = response.read().decode("utf-8")
+            self._http_resp_header_logic(response)
+
+            if response.status == 200:
+                logger.debug("Get Static Resource Body API request successful.")
+                logger.trace("Response body: %s", data)
+                return data
+
+            logger.error(
+                "Get Static Resource Body API request failed: %s %s",
+                response.status,
+                response.reason,
+            )
+            logger.debug("Response body: %s", data)
+
+        except Exception as err:
+            logger.exception(
+                "Error during Get Static Resource Body API request: %s", err
+            )
+
+        finally:
+            logger.trace("Closing connection...")
+            conn.close()
+
+        return None
+
+    def update_static_resource_name(
+        self, resource_name: str, data: str, namespace: Optional[str] = None
+    ) -> Optional[Dict[str, Any]]:
+        """
+        Update a static resource for a given name in the Salesforce instance.
+
+        :param resource_name: Name of the static resource to update.
+        :param data: Content to update the static resource with.
+        :param namespace: Optional namespace to search for the static resource.
+        :return: Static resource content or None on failure.
+        """
+        safe_resource_name = quote(resource_name, safe="")
+        query = f"SELECT Id FROM StaticResource WHERE Name = '{safe_resource_name}'"
+        if namespace:
+            query += f" AND NamespacePrefix = '{namespace}'"
+        query += " LIMIT 1"
+
+        static_resource_id_response = self.query(query)
+
+        if (
+            static_resource_id_response
+            and static_resource_id_response.get("records")
+            and len(static_resource_id_response["records"]) > 0
+        ):
+            return self.update_static_resource_id(
+                static_resource_id_response["records"][0].get("Id"), data
+            )
+
+        logger.error(
+            f"Failed to update static resource with name {safe_resource_name}."
+        )
+        return None
+
+    def update_static_resource_id(
+        self, resource_id: str, data: str
+    ) -> Optional[Dict[str, Any]]:
+        """
+        Replace the content of a static resource in the Salesforce instance by ID.
+
+        :param resource_id: ID of the static resource to update.
+        :param data: Content to update the static resource with.
         :return: Parsed JSON response or None on failure.
         """
-        return self.query(query, tooling=True)
+        self._refresh_token_if_needed()
+
+        if not self.access_token:
+            logger.error("No access token available for limits.")
+            return None
+
+        payload = {"Body": base64.b64encode(data.encode("utf-8"))}
+
+        endpoint = (
+            f"/services/data/{self.api_version}/sobjects/StaticResource/{resource_id}"
+        )
+        headers = {
+            "Authorization": f"Bearer {self.access_token}",
+            "User-Agent": self.user_agent,
+            "Content-Type": "application/json",
+            "Accept": "application/json",
+        }
+
+        parsed_url = urlparse(self.instance_url)
+        conn = self._create_connection(parsed_url.netloc)
+
+        try:
+            logger.trace("Request endpoint: %s", endpoint)
+            logger.trace("Request headers: %s", headers)
+            logger.trace("Request payload: %s", payload)
+            conn.request(
+                "PATCH",
+                endpoint,
+                headers=headers,
+                body=json.dumps(payload, default=lambda x: x.decode("utf-8")),
+            )
+            response = conn.getresponse()
+            data = response.read().decode("utf-8")
+            self._http_resp_header_logic(response)
+
+            if response.status == 200:
+                logger.debug("Patch Static Resource request successful.")
+                logger.trace("Response body: %s", data)
+                return json.loads(data)
+
+            logger.error(
+                "Patch Static Resource API request failed: %s %s",
+                response.status,
+                response.reason,
+            )
+            logger.debug("Response body: %s", data)
+
+        except Exception as err:
+            logger.exception("Error during patch request: %s", err)
+
+        finally:
+            logger.trace("Closing connection.")
+            conn.close()
+
+        return None
 
     def limits(self) -> Optional[Dict[str, Any]]:
+        """
+        Execute a GET request to the Salesforce Limits API.
+
+        :return: Parsed JSON response or None on failure.
+        """
         self._refresh_token_if_needed()
 
         if not self.access_token:
@@ -284,7 +479,6 @@ class SFAuth:
         headers = {
             "Authorization": f"Bearer {self.access_token}",
             "User-Agent": self.user_agent,
-            "Content-Type": "application/x-www-form-urlencoded",
             "Accept": "application/json",
         }
 
@@ -304,13 +498,16 @@ class SFAuth:
                 logger.trace("Response body: %s", data)
                 return json.loads(data)
 
-            logger.error("Limits API request failed: %s %s", response.status, response.reason)
+            logger.error(
+                "Limits API request failed: %s %s", response.status, response.reason
+            )
             logger.debug("Response body: %s", data)
 
         except Exception as err:
             logger.exception("Error during limits request: %s", err)
 
         finally:
+            logger.debug("Closing connection...")
             conn.close()
 
         return None
@@ -338,7 +535,6 @@ class SFAuth:
         headers = {
             "Authorization": f"Bearer {self.access_token}",
             "User-Agent": self.user_agent,
-            "Content-Type": "application/x-www-form-urlencoded",
             "Accept": "application/json",
         }
 
@@ -393,6 +589,243 @@ class SFAuth:
             logger.exception("Exception during query: %s", err)
 
         finally:
+            logger.trace("Closing connection...")
             conn.close()
 
         return None
+
+    def tooling_query(self, query: str) -> Optional[Dict[str, Any]]:
+        """
+        Execute a SOQL query using the Tooling API.
+
+        :param query: The SOQL query string.
+        :return: Parsed JSON response or None on failure.
+        """
+        return self.query(query, tooling=True)
+
+    def _reconnect_with_backoff(self, attempt: int) -> None:
+        wait_time = min(2**attempt, 60)
+        logger.warning(
+            f"Reconnecting after failure, backoff {wait_time}s (attempt {attempt})"
+        )
+        time.sleep(wait_time)
+        self._refresh_token_if_needed()
+
+    def _subscribe_topic(
+        self,
+        topic: str,
+        queue_timeout: int = 90,
+        max_runtime: Optional[int] = None,
+    ):
+        """
+        Yields events from a subscribed Salesforce CometD topic.
+
+        :param topic: Topic to subscribe to, e.g. '/event/MyEvent__e'
+        :param queue_timeout: Seconds to wait for a message before logging heartbeat
+        :param max_runtime: Max total time to listen in seconds (None = unlimited)
+        """
+        warnings.warn(
+            "The _subscribe_topic method is experimental and subject to change in future versions.",
+            ExperimentalWarning,
+            stacklevel=2,
+        )
+
+        self._refresh_token_if_needed()
+        self._msg_count: int = 0
+
+        if not self.access_token:
+            logger.error("No access token available for event stream.")
+            return
+
+        start_time = time.time()
+        message_queue = Queue()
+        headers = {
+            "Authorization": f"Bearer {self.access_token}",
+            "Content-Type": "application/json",
+            "Accept": "application/json",
+            "User-Agent": self.user_agent,
+        }
+
+        parsed_url = urlparse(self.instance_url)
+        conn = self._create_connection(parsed_url.netloc)
+        _API_VERSION = str(self.api_version).removeprefix("v")
+        client_id = str()
+
+        try:
+            logger.trace("Starting handshake with Salesforce CometD server.")
+            handshake_payload = json.dumps(
+                {
+                    "id": str(self._msg_count + 1),
+                    "version": "1.0",
+                    "minimumVersion": "1.0",
+                    "channel": "/meta/handshake",
+                    "supportedConnectionTypes": ["long-polling"],
+                    "advice": {"timeout": 60000, "interval": 0},
+                }
+            )
+            conn.request(
+                "POST",
+                f"/cometd/{_API_VERSION}/meta/handshake",
+                headers=headers,
+                body=handshake_payload,
+            )
+            response = conn.getresponse()
+            self._http_resp_header_logic(response)
+
+            logger.trace("Received handshake response.")
+            for name, value in response.getheaders():
+                if name.lower() == "set-cookie" and "BAYEUX_BROWSER=" in value:
+                    _bayeux_browser_cookie = value.split("BAYEUX_BROWSER=")[1].split(
+                        ";"
+                    )[0]
+                    headers["Cookie"] = f"BAYEUX_BROWSER={_bayeux_browser_cookie}"
+                    break
+
+            data = json.loads(response.read().decode("utf-8"))
+            if not data or not data[0].get("successful"):
+                logger.error("Handshake failed: %s", data)
+                return
+
+            client_id = data[0]["clientId"]
+            logger.trace(f"Handshake successful, client ID: {client_id}")
+
+            logger.trace(f"Subscribing to topic: {topic}")
+            subscribe_message = {
+                "channel": "/meta/subscribe",
+                "clientId": client_id,
+                "subscription": topic,
+                "id": str(self._msg_count + 1),
+            }
+            conn.request(
+                "POST",
+                f"/cometd/{_API_VERSION}/meta/subscribe",
+                headers=headers,
+                body=json.dumps(subscribe_message),
+            )
+            response = conn.getresponse()
+            self._http_resp_header_logic(response)
+
+            sub_response = json.loads(response.read().decode("utf-8"))
+            if not sub_response or not sub_response[0].get("successful"):
+                logger.error("Subscription failed: %s", sub_response)
+                return
+
+            logger.info(f"Successfully subscribed to topic: {topic}")
+            logger.trace("Entering event polling loop.")
+
+            try:
+                while True:
+                    if max_runtime and (time.time() - start_time > max_runtime):
+                        logger.info(
+                            f"Disconnecting after max_runtime={max_runtime} seconds"
+                        )
+                        break
+
+                    logger.trace("Sending connection message.")
+                    connect_payload = json.dumps(
+                        [
+                            {
+                                "channel": "/meta/connect",
+                                "clientId": client_id,
+                                "connectionType": "long-polling",
+                                "id": str(self._msg_count + 1),
+                            }
+                        ]
+                    )
+
+                    max_retries = 5
+                    attempt = 0
+
+                    while attempt < max_retries:
+                        try:
+                            conn.request(
+                                "POST",
+                                f"/cometd/{_API_VERSION}/meta/connect",
+                                headers=headers,
+                                body=connect_payload,
+                            )
+                            response = conn.getresponse()
+                            self._http_resp_header_logic(response)
+                            self._msg_count += 1
+
+                            events = json.loads(response.read().decode("utf-8"))
+                            for event in events:
+                                if event.get("channel") == topic and "data" in event:
+                                    logger.trace(
+                                        f"Event received for topic {topic}, data: {event['data']}"
+                                    )
+                                    message_queue.put(event)
+                            break
+                        except (
+                            http.client.RemoteDisconnected,
+                            ConnectionResetError,
+                            TimeoutError,
+                            http.client.BadStatusLine,
+                            http.client.CannotSendRequest,
+                            ConnectionAbortedError,
+                            ConnectionRefusedError,
+                            ConnectionError,
+                        ) as e:
+                            logger.warning(
+                                f"Connection error (attempt {attempt + 1}): {e}"
+                            )
+                            conn.close()
+                            conn = self._create_connection(parsed_url.netloc)
+                            self._reconnect_with_backoff(attempt)
+                            attempt += 1
+                        except Exception as e:
+                            logger.exception(
+                                f"Connection error (attempt {attempt + 1}): {e}"
+                            )
+                            break
+                    else:
+                        logger.error("Max retries reached. Exiting event stream.")
+                        break
+
+                    while True:
+                        try:
+                            msg = message_queue.get(timeout=queue_timeout, block=True)
+                            yield msg
+                        except Empty:
+                            logger.debug(
+                                f"Heartbeat: no message in last {queue_timeout} seconds"
+                            )
+                            break
+            except KeyboardInterrupt:
+                logger.info("Received keyboard interrupt, disconnecting...")
+
+            except Exception as e:
+                logger.exception(f"Polling error: {e}")
+
+        finally:
+            if client_id:
+                try:
+                    logger.trace(
+                        f"Disconnecting from server with client ID: {client_id}"
+                    )
+                    disconnect_payload = json.dumps(
+                        [
+                            {
+                                "channel": "/meta/disconnect",
+                                "clientId": client_id,
+                                "id": str(self._msg_count + 1),
+                            }
+                        ]
+                    )
+                    conn.request(
+                        "POST",
+                        f"/cometd/{_API_VERSION}/meta/disconnect",
+                        headers=headers,
+                        body=disconnect_payload,
+                    )
+                    response = conn.getresponse()
+                    self._http_resp_header_logic(response)
+                    _ = response.read()
+                    logger.trace("Disconnected successfully.")
+                except Exception as e:
+                    logger.warning(f"Exception during disconnect: {e}")
+            if conn:
+                logger.trace("Closing connection.")
+                conn.close()
+
+            logger.trace("Leaving event polling loop.")

{sfq-0.0.9.dist-info → sfq-0.0.11.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sfq
-Version: 0.0.9
+Version: 0.0.11
 Summary: Python wrapper for the Salesforce's Query API.
 Author-email: David Moruzzi <sfq.pypi@dmoruzi.com>
 Keywords: salesforce,salesforce query

sfq-0.0.11.dist-info/RECORD

@@ -0,0 +1,5 @@
+sfq/__init__.py,sha256=QkMVcIOaQO7XP29zK9l7uQCTx0NcqIDBNj8V08Llu24,31595
+sfq/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sfq-0.0.11.dist-info/METADATA,sha256=F1sqI833stEXIk9Z7jtG6q0F8dPuEGMDW8xgFgGxa4M,5067
+sfq-0.0.11.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+sfq-0.0.11.dist-info/RECORD,,

sfq-0.0.9.dist-info/RECORD

@@ -1,5 +0,0 @@
-sfq/__init__.py,sha256=TUhdE13kmM814DmbYgDHtQogRm461k17YKr7YKzBNho,15101
-sfq/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-sfq-0.0.9.dist-info/METADATA,sha256=DCsSMcv_Nzq2JJinOYzab8Q7MU0jjFQ27lGgMZjUnEI,5066
-sfq-0.0.9.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-sfq-0.0.9.dist-info/RECORD,,