universal-mcp-applications 0.1.33__py3-none-any.whl → 0.1.39rc16__py3-none-any.whl

universal_mcp/applications/twilio/app.py

@@ -1,17 +1,13 @@
 from collections.abc import Callable
 from datetime import datetime
 from typing import Any
-
 from loguru import logger
 
 try:
     from twilio.rest import Client as TwilioClient
 except ImportError:
     TwilioClient = None
-    logger.error(
-        "Twilio SDK is not installed. Please install 'twilio' to use TwilioApp."
-    )
-
+    logger.error("Twilio SDK is not installed. Please install 'twilio' to use TwilioApp.")
 from universal_mcp.applications.application import APIApplication
 from universal_mcp.exceptions import NotAuthorizedError, ToolError
 from universal_mcp.integrations import Integration
@@ -29,12 +25,9 @@ class TwilioApp(APIApplication):
         self._account_sid: str | None = None
         self._auth_token: str | None = None
         if TwilioClient is None:
-            logger.warning(
-                "Twilio SDK is not available. Twilio tools will not function."
-            )
+            logger.warning("Twilio SDK is not available. Twilio tools will not function.")
 
-    @property
-    def account_sid(self) -> str:
+    async def account_sid(self) -> str:
         """
         Retrieves and caches the Twilio Account SID from the integration credentials.
         """
@@ -42,24 +35,16 @@ class TwilioApp(APIApplication):
             if not self.integration:
                 raise NotAuthorizedError("Integration not configured for Twilio App.")
             try:
-                credentials = self.integration.get_credentials()
+                credentials = await self.integration.get_credentials_async()
             except Exception as e:
                 raise NotAuthorizedError(f"Failed to get Twilio credentials: {e}")
-
-            sid = (
-                credentials.get("account_sid")
-                or credentials.get("ACCOUNT_SID")
-                or credentials.get("TWILIO_ACCOUNT_SID")
-            )
+            sid = credentials.get("account_sid") or credentials.get("ACCOUNT_SID") or credentials.get("TWILIO_ACCOUNT_SID")
             if not sid:
-                raise NotAuthorizedError(
-                    "Twilio Account SID is missing. Please set it in the integration."
-                )
+                raise NotAuthorizedError("Twilio Account SID is missing. Please set it in the integration.")
             self._account_sid = sid
         return self._account_sid
 
-    @property
-    def auth_token(self) -> str:
+    async def auth_token(self) -> str:
         """
         Retrieves and caches the Twilio Auth Token from the integration credentials.
         """
@@ -67,34 +52,26 @@ class TwilioApp(APIApplication):
             if not self.integration:
                 raise NotAuthorizedError("Integration not configured for Twilio App.")
             try:
-                credentials = self.integration.get_credentials()
+                credentials = await self.integration.get_credentials_async()
             except Exception as e:
                 raise NotAuthorizedError(f"Failed to get Twilio credentials: {e}")
-
-            token = (
-                credentials.get("auth_token")
-                or credentials.get("AUTH_TOKEN")
-                or credentials.get("TWILIO_AUTH_TOKEN")
-            )
+            token = credentials.get("auth_token") or credentials.get("AUTH_TOKEN") or credentials.get("TWILIO_AUTH_TOKEN")
             if not token:
-                raise NotAuthorizedError(
-                    "Twilio Auth Token is missing. Please set it in the integration."
-                )
+                raise NotAuthorizedError("Twilio Auth Token is missing. Please set it in the integration.")
             self._auth_token = token
         return self._auth_token
 
-    @property
-    def twilio_client(self) -> Any:
+    async def twilio_client(self) -> Any:
         """
         Returns a cached Twilio Client instance.
         """
         if self._twilio_client is None:
             if TwilioClient is None:
                 raise ToolError("Twilio SDK is not installed.")
-            self._twilio_client = TwilioClient(self.account_sid, self.auth_token)
+            self._twilio_client = TwilioClient(await self.account_sid, await self.auth_token)
         return self._twilio_client
 
-    def create_message(self, from_: str, to: str, body: str) -> dict[str, Any]:
+    async def create_message(self, from_: str, to: str, body: str) -> dict[str, Any]:
         """
         Sends a new SMS or MMS message using Twilio.
 
@@ -114,12 +91,8 @@ class TwilioApp(APIApplication):
             create, message, sms, mms, send, twilio, api, important
         """
         try:
-            message = self.twilio_client.messages.create(
-                from_=from_,
-                to=to,
-                body=body,
-            )
-            # Convert the Twilio MessageInstance to a dict
+            client = await self.twilio_client()
+            message = await client.messages.create(from_=from_, to=to, body=body)
             return {
                 "sid": message.sid,
                 "status": message.status,
@@ -137,7 +110,7 @@ class TwilioApp(APIApplication):
                 raise NotAuthorizedError(f"Twilio authentication failed: {e}")
             raise ToolError(f"Failed to send message: {e}")
 
-    def fetch_message(self, message_sid: str) -> dict[str, Any]:
+    async def fetch_message(self, message_sid: str) -> dict[str, Any]:
         """
         Fetches the details of a specific message by its SID.
 
@@ -155,7 +128,8 @@ class TwilioApp(APIApplication):
             fetch, message, sms, mms, read, twilio, api, important
         """
         try:
-            message = self.twilio_client.messages(message_sid).fetch()
+            client = await self.twilio_client()
+            message = await client.messages(message_sid).fetch()
             return {
                 "sid": message.sid,
                 "status": message.status,
@@ -173,11 +147,8 @@ class TwilioApp(APIApplication):
                 raise NotAuthorizedError(f"Twilio authentication failed: {e}")
             raise ToolError(f"Failed to fetch message: {e}")
 
-    def list_messages(
-        self,
-        limit: int = 20,
-        date_sent_before: datetime | None = None,
-        date_sent_after: datetime | None = None,
+    async def list_messages(
+        self, limit: int = 20, date_sent_before: datetime | None = None, date_sent_after: datetime | None = None
     ) -> list[dict[str, Any]]:
         """
         Lists messages from your Twilio account, optionally filtered by date.
@@ -198,15 +169,13 @@ class TwilioApp(APIApplication):
             list, message, sms, mms, read, twilio, api, important
         """
         try:
-            params = {
-                "limit": limit,
-            }
+            params = {"limit": limit}
             if date_sent_before:
                 params["date_sent_before"] = date_sent_before
             if date_sent_after:
                 params["date_sent_after"] = date_sent_after
-
-            messages = self.twilio_client.messages.list(**params)
+            client = await self.twilio_client()
+            messages = await client.messages.list(**params)
             result = []
             for msg in messages:
                 result.append(
@@ -229,7 +198,7 @@ class TwilioApp(APIApplication):
                 raise NotAuthorizedError(f"Twilio authentication failed: {e}")
             raise ToolError(f"Failed to list messages: {e}")
 
-    def delete_message(self, message_sid: str) -> bool:
+    async def delete_message(self, message_sid: str) -> bool:
         """
         Deletes a specific message from your Twilio account.
 
@@ -247,7 +216,8 @@ class TwilioApp(APIApplication):
             delete, message, sms, mms, remove, twilio, api, important
         """
         try:
-            result = self.twilio_client.messages(message_sid).delete()
+            client = await self.twilio_client()
+            result = await client.messages(message_sid).delete()
             return bool(result)
         except Exception as e:
             if "Authenticate" in str(e) or "401" in str(e):
@@ -261,9 +231,4 @@ class TwilioApp(APIApplication):
         Returns:
             A list of callable tool methods.
         """
-        return [
-            self.create_message,
-            self.fetch_message,
-            self.list_messages,
-            self.delete_message,
-        ]
+        return [self.create_message, self.fetch_message, self.list_messages, self.delete_message]

universal_mcp/applications/twitter/api_segments/compliance_api.py

@@ -7,9 +7,7 @@ class ComplianceApi(APISegmentBase):
     def __init__(self, main_app_client: Any):
         super().__init__(main_app_client)
 
-    def list_batch_compliance_jobs(
-        self, type, status=None, compliance_job_fields=None
-    ) -> dict[str, Any]:
+    def list_batch_compliance_jobs(self, type, status=None, compliance_job_fields=None) -> dict[str, Any]:
         """
         Retrieves a list of compliance jobs, requiring a job `type` ('tweets' or 'users') and allowing optional filtering by `status`. This function fetches multiple jobs, distinguishing it from `get_batch_compliance_job` which retrieves a single job by its unique ID.
 
@@ -42,9 +40,7 @@ class ComplianceApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def create_batch_compliance_job(
-        self, type, name=None, resumable=None
-    ) -> dict[str, Any]:
+    def create_batch_compliance_job(self, type, name=None, resumable=None) -> dict[str, Any]:
         """
         Creates a new batch compliance job for a specified type ('tweets' or 'users'). A custom name can be provided, and resumable uploads can be enabled. This initiates the job creation process, differing from functions that list or retrieve existing jobs.
 
@@ -65,9 +61,7 @@ class ComplianceApi(APISegmentBase):
         """
         request_body_data = None
         request_body_data = {"name": name, "resumable": resumable, "type": type}
-        request_body_data = {
-            k: v for k, v in request_body_data.items() if v is not None
-        }
+        request_body_data = {k: v for k, v in request_body_data.items() if v is not None}
         url = f"{self.main_app_client.base_url}/2/compliance/jobs"
         query_params = {}
         response = self._post(
@@ -100,11 +94,7 @@ class ComplianceApi(APISegmentBase):
         if id is None:
             raise ValueError("Missing required parameter 'id'.")
         url = f"{self.main_app_client.base_url}/2/compliance/jobs/{id}"
-        query_params = {
-            k: v
-            for k, v in [("compliance_job.fields", compliance_job_fields)]
-            if v is not None
-        }
+        query_params = {k: v for k, v in [("compliance_job.fields", compliance_job_fields)] if v is not None}
         response = self._get(url, params=query_params)
         response.raise_for_status()
         return response.json()

universal_mcp/applications/twitter/api_segments/dm_conversations_api.py

@@ -7,9 +7,7 @@ class DmConversationsApi(APISegmentBase):
     def __init__(self, main_app_client: Any):
         super().__init__(main_app_client)
 
-    def create_dm_conversation(
-        self, conversation_type=None, message=None, participant_ids=None
-    ) -> dict[str, Any]:
+    def create_dm_conversation(self, conversation_type=None, message=None, participant_ids=None) -> dict[str, Any]:
         """
         Creates a new group Direct Message conversation with specified participants and sends an initial message. This function specifically handles the creation of new multi-participant conversations, distinct from other methods in this class that add messages to existing one-to-one or group DMs.
 
@@ -34,9 +32,7 @@ class DmConversationsApi(APISegmentBase):
             "message": message,
             "participant_ids": participant_ids,
         }
-        request_body_data = {
-            k: v for k, v in request_body_data.items() if v is not None
-        }
+        request_body_data = {k: v for k, v in request_body_data.items() if v is not None}
         url = f"{self.main_app_client.base_url}/2/dm_conversations"
         query_params = {}
         response = self._post(
@@ -105,9 +101,7 @@ class DmConversationsApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def send_dm_by_participant_id(
-        self, participant_id, attachments=None, text=None
-    ) -> dict[str, Any]:
+    def send_dm_by_participant_id(self, participant_id, attachments=None, text=None) -> dict[str, Any]:
         """
         Sends a direct message to a user specified by their participant ID. It creates a new one-on-one conversation or appends the message to an existing one. Unlike other functions, this method identifies the conversation using the participant's ID rather than a pre-existing conversation ID.
 
@@ -130,9 +124,7 @@ class DmConversationsApi(APISegmentBase):
             raise ValueError("Missing required parameter 'participant_id'.")
         request_body_data = None
         request_body_data = {"attachments": attachments, "text": text}
-        request_body_data = {
-            k: v for k, v in request_body_data.items() if v is not None
-        }
+        request_body_data = {k: v for k, v in request_body_data.items() if v is not None}
         url = f"{self.main_app_client.base_url}/2/dm_conversations/with/{participant_id}/messages"
         query_params = {}
         response = self._post(
@@ -144,9 +136,7 @@ class DmConversationsApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def add_message_to_dm_conversation(
-        self, dm_conversation_id, attachments=None, text=None
-    ) -> dict[str, Any]:
+    def add_message_to_dm_conversation(self, dm_conversation_id, attachments=None, text=None) -> dict[str, Any]:
         """
         Sends a new message with optional text and attachments to an existing Direct Message conversation. The target conversation is specified by its `dm_conversation_id`, distinguishing it from functions that create new conversations or send one-to-one messages using a participant ID.
 
@@ -169,9 +159,7 @@ class DmConversationsApi(APISegmentBase):
             raise ValueError("Missing required parameter 'dm_conversation_id'.")
         request_body_data = None
         request_body_data = {"attachments": attachments, "text": text}
-        request_body_data = {
-            k: v for k, v in request_body_data.items() if v is not None
-        }
+        request_body_data = {k: v for k, v in request_body_data.items() if v is not None}
         url = f"{self.main_app_client.base_url}/2/dm_conversations/{dm_conversation_id}/messages"
         query_params = {}
         response = self._post(

universal_mcp/applications/twitter/api_segments/likes_api.py

@@ -7,9 +7,7 @@ class LikesApi(APISegmentBase):
     def __init__(self, main_app_client: Any):
         super().__init__(main_app_client)
 
-    def get_likes_compliance_stream(
-        self, backfill_minutes=None, start_time=None, end_time=None
-    ) -> Any:
+    def get_likes_compliance_stream(self, backfill_minutes=None, start_time=None, end_time=None) -> Any:
         """
         Streams compliance-related data for 'like' events, such as un-likes, with optional time and backfill filters. This endpoint is for compliance monitoring, differing from the firehose and sample streams which provide real-time like creation events.
 

universal_mcp/applications/twitter/api_segments/lists_api.py

@@ -32,9 +32,7 @@ class ListsApi(APISegmentBase):
             "name": name,
             "private": private,
         }
-        request_body_data = {
-            k: v for k, v in request_body_data.items() if v is not None
-        }
+        request_body_data = {k: v for k, v in request_body_data.items() if v is not None}
         url = f"{self.main_app_client.base_url}/2/lists"
         query_params = {}
         response = self._post(
@@ -71,9 +69,7 @@ class ListsApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def get_list_by_id(
-        self, id, list_fields=None, expansions=None, user_fields=None
-    ) -> dict[str, Any]:
+    def get_list_by_id(self, id, list_fields=None, expansions=None, user_fields=None) -> dict[str, Any]:
         """
         Retrieves detailed information for a specific list by its ID. This function allows for response customization by specifying which list and user fields to return and supports expansions to include related objects like the owner's user data.
 
@@ -109,9 +105,7 @@ class ListsApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def update_list(
-        self, id, description=None, name=None, private=None
-    ) -> dict[str, Any]:
+    def update_list(self, id, description=None, name=None, private=None) -> dict[str, Any]:
         """
         Modifies an existing Twitter list identified by its unique ID. This function updates the list's name, description, or privacy status by sending a PUT request to the API and returns the updated list data upon success.
 
@@ -139,9 +133,7 @@ class ListsApi(APISegmentBase):
             "name": name,
             "private": private,
         }
-        request_body_data = {
-            k: v for k, v in request_body_data.items() if v is not None
-        }
+        request_body_data = {k: v for k, v in request_body_data.items() if v is not None}
         url = f"{self.main_app_client.base_url}/2/lists/{id}"
         query_params = {}
         response = self._put(
@@ -271,9 +263,7 @@ class ListsApi(APISegmentBase):
             raise ValueError("Missing required parameter 'id'.")
         request_body_data = None
         request_body_data = {"user_id": user_id}
-        request_body_data = {
-            k: v for k, v in request_body_data.items() if v is not None
-        }
+        request_body_data = {k: v for k, v in request_body_data.items() if v is not None}
         url = f"{self.main_app_client.base_url}/2/lists/{id}/members"
         query_params = {}
         response = self._post(

universal_mcp/applications/twitter/api_segments/trends_api.py

@@ -28,9 +28,7 @@ class TrendsApi(APISegmentBase):
         if woeid is None:
             raise ValueError("Missing required parameter 'woeid'.")
         url = f"{self.main_app_client.base_url}/2/trends/by/woeid/{woeid}"
-        query_params = {
-            k: v for k, v in [("trend.fields", trend_fields)] if v is not None
-        }
+        query_params = {k: v for k, v in [("trend.fields", trend_fields)] if v is not None}
         response = self._get(url, params=query_params)
         response.raise_for_status()
         return response.json()

universal_mcp/applications/twitter/api_segments/tweets_api.py

@@ -111,9 +111,7 @@ class TweetsApi(APISegmentBase):
             "reply_settings": reply_settings,
             "text": text,
         }
-        request_body_data = {
-            k: v for k, v in request_body_data.items() if v is not None
-        }
+        request_body_data = {k: v for k, v in request_body_data.items() if v is not None}
         url = f"{self.main_app_client.base_url}/2/tweets"
         query_params = {}
         response = self._post(
@@ -125,9 +123,7 @@ class TweetsApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def get_tweets_compliance_stream(
-        self, partition, backfill_minutes=None, start_time=None, end_time=None
-    ) -> Any:
+    def get_tweets_compliance_stream(self, partition, backfill_minutes=None, start_time=None, end_time=None) -> Any:
         """
         Streams real-time compliance events for tweets, such as deletions and user updates, from a specified partition. Unlike other stream functions that return tweet content, this provides metadata about content and user status changes, supporting optional time-based filtering and backfilling.
 
@@ -569,9 +565,7 @@ class TweetsApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def stream_labeled_tweets(
-        self, backfill_minutes=None, start_time=None, end_time=None
-    ) -> Any:
+    def stream_labeled_tweets(self, backfill_minutes=None, start_time=None, end_time=None) -> Any:
         """
         Streams real-time Tweet objects labeled for compliance reasons, such as withheld content. Unlike `get_tweets_compliance_stream`, which provides events, this returns the actual tweets. Supports filtering by a time window and backfilling missed data upon reconnection.
 
@@ -917,9 +911,7 @@ class TweetsApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def get_filtered_stream_rules(
-        self, ids=None, max_results=None, pagination_token=None
-    ) -> dict[str, Any]:
+    def get_filtered_stream_rules(self, ids=None, max_results=None, pagination_token=None) -> dict[str, Any]:
         """
         Retrieves the active filtering rules for a Twitter API v2 filtered stream. It can fetch all rules or a subset specified by rule IDs, with support for pagination to manage large rule sets, complementing the `add_or_delete_rules` and `search_stream` functions.
 
@@ -952,9 +944,7 @@ class TweetsApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def update_stream_rules(
-        self, dry_run=None, delete_all=None, add=None, delete=None
-    ) -> dict[str, Any]:
+    def update_stream_rules(self, dry_run=None, delete_all=None, add=None, delete=None) -> dict[str, Any]:
         """
         Adds or removes filtering rules for a tweet stream. Supports a dry-run mode to validate rule syntax without application and an option to delete all existing rules. This function directly modifies the active rule set used by the `search_stream` function.
 
@@ -976,15 +966,9 @@ class TweetsApi(APISegmentBase):
         """
         request_body_data = None
         request_body_data = {"add": add, "delete": delete}
-        request_body_data = {
-            k: v for k, v in request_body_data.items() if v is not None
-        }
+        request_body_data = {k: v for k, v in request_body_data.items() if v is not None}
         url = f"{self.main_app_client.base_url}/2/tweets/search/stream/rules"
-        query_params = {
-            k: v
-            for k, v in [("dry_run", dry_run), ("delete_all", delete_all)]
-            if v is not None
-        }
+        query_params = {k: v for k, v in [("dry_run", dry_run), ("delete_all", delete_all)] if v is not None}
         response = self._post(
             url,
             data=request_body_data,
@@ -1012,11 +996,7 @@ class TweetsApi(APISegmentBase):
             General
         """
         url = f"{self.main_app_client.base_url}/2/tweets/search/stream/rules/counts"
-        query_params = {
-            k: v
-            for k, v in [("rules_count.fields", rules_count_fields)]
-            if v is not None
-        }
+        query_params = {k: v for k, v in [("rules_count.fields", rules_count_fields)] if v is not None}
         response = self._get(url, params=query_params)
         response.raise_for_status()
         return response.json()
@@ -1332,9 +1312,7 @@ class TweetsApi(APISegmentBase):
             raise ValueError("Missing required parameter 'tweet_id'.")
         request_body_data = None
         request_body_data = {"hidden": hidden}
-        request_body_data = {
-            k: v for k, v in request_body_data.items() if v is not None
-        }
+        request_body_data = {k: v for k, v in request_body_data.items() if v is not None}
         url = f"{self.main_app_client.base_url}/2/tweets/{tweet_id}/hidden"
         query_params = {}
         response = self._put(

universal_mcp/applications/twitter/api_segments/usage_api.py

@@ -26,11 +26,7 @@ class UsageApi(APISegmentBase):
             Usage
         """
         url = f"{self.main_app_client.base_url}/2/usage/tweets"
-        query_params = {
-            k: v
-            for k, v in [("days", days), ("usage.fields", usage_fields)]
-            if v is not None
-        }
+        query_params = {k: v for k, v in [("days", days), ("usage.fields", usage_fields)] if v is not None}
         response = self._get(url, params=query_params)
         response.raise_for_status()
         return response.json()

universal_mcp/applications/twitter/api_segments/users_api.py

@@ -7,9 +7,7 @@ class UsersApi(APISegmentBase):
     def __init__(self, main_app_client: Any):
         super().__init__(main_app_client)
 
-    def get_users_by_ids(
-        self, ids, user_fields=None, expansions=None, tweet_fields=None
-    ) -> dict[str, Any]:
+    def get_users_by_ids(self, ids, user_fields=None, expansions=None, tweet_fields=None) -> dict[str, Any]:
         """
         Retrieves detailed information for multiple users in a single API request, specified by a list of their unique IDs. Unlike `find_user_by_id`, which fetches a single user, this function performs a bulk lookup and allows for response customization with optional fields and expansions.
 
@@ -44,9 +42,7 @@ class UsersApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def get_users_by_usernames(
-        self, usernames, user_fields=None, expansions=None, tweet_fields=None
-    ) -> dict[str, Any]:
+    def get_users_by_usernames(self, usernames, user_fields=None, expansions=None, tweet_fields=None) -> dict[str, Any]:
         """
         Fetches public data for a batch of users specified by their usernames. This function supports retrieving multiple users in a single request, unlike `find_user_by_username`. It allows for data customization through optional fields and expansions.
 
@@ -81,9 +77,7 @@ class UsersApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def find_user_by_username(
-        self, username, user_fields=None, expansions=None, tweet_fields=None
-    ) -> dict[str, Any]:
+    def find_user_by_username(self, username, user_fields=None, expansions=None, tweet_fields=None) -> dict[str, Any]:
         """
         Retrieves detailed information for a single user specified by their username, with options to include additional user, tweet, and expansion fields. This differs from `find_users_by_username`, which fetches data for multiple users in a single request.
 
@@ -119,9 +113,7 @@ class UsersApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def get_users_compliance_stream(
-        self, partition, backfill_minutes=None, start_time=None, end_time=None
-    ) -> Any:
+    def get_users_compliance_stream(self, partition, backfill_minutes=None, start_time=None, end_time=None) -> Any:
         """
         Streams real-time user compliance events, such as account deletions or suspensions, from a specified data partition. Allows for backfilling missed data after a disconnection and filtering the event stream by a specific time range for targeted data retrieval.
 
@@ -156,9 +148,7 @@ class UsersApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def get_authenticated_user(
-        self, user_fields=None, expansions=None, tweet_fields=None
-    ) -> dict[str, Any]:
+    def get_authenticated_user(self, user_fields=None, expansions=None, tweet_fields=None) -> dict[str, Any]:
         """
         Retrieves detailed information about the authenticated user making the request. Optional parameters allow for customizing the returned user and tweet data fields and including expanded objects. This differs from other 'find' functions as it requires no ID or username.
 
@@ -238,9 +228,7 @@ class UsersApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def find_user_by_id(
-        self, id, user_fields=None, expansions=None, tweet_fields=None
-    ) -> dict[str, Any]:
+    def find_user_by_id(self, id, user_fields=None, expansions=None, tweet_fields=None) -> dict[str, Any]:
         """
         Retrieves detailed information for a single user specified by their unique ID. This function allows for response customization using optional fields and expansions. It differs from `find_users_by_id`, which fetches data for multiple users in a single request.
 
@@ -403,9 +391,7 @@ class UsersApi(APISegmentBase):
             raise ValueError("Missing required parameter 'id'.")
         request_body_data = None
         request_body_data = {"tweet_id": tweet_id}
-        request_body_data = {
-            k: v for k, v in request_body_data.items() if v is not None
-        }
+        request_body_data = {k: v for k, v in request_body_data.items() if v is not None}
         url = f"{self.main_app_client.base_url}/2/users/{id}/bookmarks"
         query_params = {}
         response = self._post(
@@ -515,9 +501,7 @@ class UsersApi(APISegmentBase):
             raise ValueError("Missing required parameter 'id'.")
         request_body_data = None
         request_body_data = {"list_id": list_id}
-        request_body_data = {
-            k: v for k, v in request_body_data.items() if v is not None
-        }
+        request_body_data = {k: v for k, v in request_body_data.items() if v is not None}
         url = f"{self.main_app_client.base_url}/2/users/{id}/followed_lists"
         query_params = {}
         response = self._post(
@@ -675,9 +659,7 @@ class UsersApi(APISegmentBase):
             raise ValueError("Missing required parameter 'id'.")
         request_body_data = None
         request_body_data = {"target_user_id": target_user_id}
-        request_body_data = {
-            k: v for k, v in request_body_data.items() if v is not None
-        }
+        request_body_data = {k: v for k, v in request_body_data.items() if v is not None}
         url = f"{self.main_app_client.base_url}/2/users/{id}/following"
         query_params = {}
         response = self._post(
@@ -768,9 +750,7 @@ class UsersApi(APISegmentBase):
             raise ValueError("Missing required parameter 'id'.")
         request_body_data = None
         request_body_data = {"tweet_id": tweet_id}
-        request_body_data = {
-            k: v for k, v in request_body_data.items() if v is not None
-        }
+        request_body_data = {k: v for k, v in request_body_data.items() if v is not None}
         url = f"{self.main_app_client.base_url}/2/users/{id}/likes"
         query_params = {}
         response = self._post(
@@ -997,9 +977,7 @@ class UsersApi(APISegmentBase):
             raise ValueError("Missing required parameter 'id'.")
         request_body_data = None
         request_body_data = {"target_user_id": target_user_id}
-        request_body_data = {
-            k: v for k, v in request_body_data.items() if v is not None
-        }
+        request_body_data = {k: v for k, v in request_body_data.items() if v is not None}
         url = f"{self.main_app_client.base_url}/2/users/{id}/muting"
         query_params = {}
         response = self._post(
@@ -1059,9 +1037,7 @@ class UsersApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def get_user_pinned_lists(
-        self, id, list_fields=None, expansions=None, user_fields=None
-    ) -> dict[str, Any]:
+    def get_user_pinned_lists(self, id, list_fields=None, expansions=None, user_fields=None) -> dict[str, Any]:
         """
         Retrieves the collection of lists pinned by a specific user, identified by their ID. Optional parameters allow for customizing the returned list and user data fields, and including expansions. This is distinct from fetching lists a user follows or owns.
 
@@ -1119,9 +1095,7 @@ class UsersApi(APISegmentBase):
             raise ValueError("Missing required parameter 'id'.")
         request_body_data = None
         request_body_data = {"list_id": list_id}
-        request_body_data = {
-            k: v for k, v in request_body_data.items() if v is not None
-        }
+        request_body_data = {k: v for k, v in request_body_data.items() if v is not None}
         url = f"{self.main_app_client.base_url}/2/users/{id}/pinned_lists"
         query_params = {}
         response = self._post(
@@ -1183,9 +1157,7 @@ class UsersApi(APISegmentBase):
             raise ValueError("Missing required parameter 'id'.")
         request_body_data = None
         request_body_data = {"tweet_id": tweet_id}
-        request_body_data = {
-            k: v for k, v in request_body_data.items() if v is not None
-        }
+        request_body_data = {k: v for k, v in request_body_data.items() if v is not None}
         url = f"{self.main_app_client.base_url}/2/users/{id}/retweets"
         query_params = {}
         response = self._post(