tweetapi 2.2.1__tar.gz → 2.3.0__tar.gz

{tweetapi-2.2.1 → tweetapi-2.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: tweetapi
-Version: 2.2.1
+Version: 2.3.0
 Summary: Python SDK for TweetAPI's Twitter/X data and account API
 Project-URL: Homepage, https://tweetapi.com?utm_source=pypi&utm_medium=readme&utm_campaign=python-sdk
 Project-URL: Documentation, https://tweetapi.com/docs?utm_source=pypi&utm_medium=readme&utm_campaign=python-sdk
@@ -65,7 +65,7 @@ next_page = client.user.get_followers(
 ## SDK behavior
 
 - Public methods have type annotations, and response models use `TypedDict`.
-- The client retries rate limits, server errors, timeouts, and connection failures.
+- The client retries rate limits, server errors, timeouts, and connection failures by default; username changes disable automatic retries because the mutation is non-idempotent.
 - `paginate()` yields items from cursor-based responses; `paginate_pages()` yields full response pages.
 - HTTP errors map to exception classes such as `RateLimitError` and `NotFoundError`.
 - Timeouts can use one value or separate connect and read values.
@@ -124,6 +124,7 @@ next_page = client.user.get_followers(
 | `client.profile.banner(auth_token=..., media=..., proxy=...)` | Update profile banner |
 | `client.profile.remove_banner(auth_token=..., proxy=...)` | Remove the profile banner |
 | `client.profile.set_privacy(auth_token=..., is_private=..., proxy=...)` | Make the account public or private |
+| `client.profile.update_username(auth_token=..., password=..., username=..., proxy=...)` | Update the account username |
 
 ### Interaction
 
@@ -253,6 +254,11 @@ client.profile.banner(
 )
 client.profile.remove_banner(auth_token="AUTH_TOKEN")
 client.profile.set_privacy(auth_token="AUTH_TOKEN", is_private=True)
+client.profile.update_username(
+    auth_token="AUTH_TOKEN",
+    password="ACCOUNT_PASSWORD",
+    username="NEW_USERNAME",
+)
 ```
 
 Use `client.list` for list mutations. The older helpers under `client.interaction` remain available:

{tweetapi-2.2.1 → tweetapi-2.3.0}/README.md

@@ -35,7 +35,7 @@ next_page = client.user.get_followers(
 ## SDK behavior
 
 - Public methods have type annotations, and response models use `TypedDict`.
-- The client retries rate limits, server errors, timeouts, and connection failures.
+- The client retries rate limits, server errors, timeouts, and connection failures by default; username changes disable automatic retries because the mutation is non-idempotent.
 - `paginate()` yields items from cursor-based responses; `paginate_pages()` yields full response pages.
 - HTTP errors map to exception classes such as `RateLimitError` and `NotFoundError`.
 - Timeouts can use one value or separate connect and read values.
@@ -94,6 +94,7 @@ next_page = client.user.get_followers(
 | `client.profile.banner(auth_token=..., media=..., proxy=...)` | Update profile banner |
 | `client.profile.remove_banner(auth_token=..., proxy=...)` | Remove the profile banner |
 | `client.profile.set_privacy(auth_token=..., is_private=..., proxy=...)` | Make the account public or private |
+| `client.profile.update_username(auth_token=..., password=..., username=..., proxy=...)` | Update the account username |
 
 ### Interaction
 
@@ -223,6 +224,11 @@ client.profile.banner(
 )
 client.profile.remove_banner(auth_token="AUTH_TOKEN")
 client.profile.set_privacy(auth_token="AUTH_TOKEN", is_private=True)
+client.profile.update_username(
+    auth_token="AUTH_TOKEN",
+    password="ACCOUNT_PASSWORD",
+    username="NEW_USERNAME",
+)
 ```
 
 Use `client.list` for list mutations. The older helpers under `client.interaction` remain available:

{tweetapi-2.2.1 → tweetapi-2.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "tweetapi"
-version = "2.2.1"
+version = "2.3.0"
 description = "Python SDK for TweetAPI's Twitter/X data and account API"
 readme = "README.md"
 license = "MIT"

{tweetapi-2.2.1 → tweetapi-2.3.0}/tweetapi/__init__.py

@@ -37,4 +37,4 @@ __all__ = [
     "paginate_pages",
 ]
 
-__version__ = "2.2.1"
+__version__ = "2.3.0"

{tweetapi-2.2.1 → tweetapi-2.3.0}/tweetapi/client.py

@@ -108,12 +108,18 @@ class TweetAPI:
             }
         return self._request("GET", path, params=clean_params)
 
-    def _post(self, path: str, body: Optional[dict[str, Any]] = None) -> Any:
+    def _post(
+        self,
+        path: str,
+        body: Optional[dict[str, Any]] = None,
+        *,
+        retry: bool = True,
+    ) -> Any:
         """Send a POST request to the API."""
         clean_body = None
         if body:
             clean_body = {k: v for k, v in body.items() if v is not None}
-        return self._request("POST", path, json=clean_body)
+        return self._request("POST", path, json=clean_body, retry=retry)
 
     @property
     def rate_limit_info(self) -> Optional[dict[str, Any]]:
@@ -146,11 +152,13 @@ class TweetAPI:
         path: str,
         params: Optional[dict[str, Any]] = None,
         json: Optional[dict[str, Any]] = None,
+        retry: bool = True,
     ) -> Any:
         url = f"{self._base_url}{path}"
         last_error: Optional[TweetAPIError] = None
+        max_retries = self._max_retries if retry else 0
 
-        for attempt in range(self._max_retries + 1):
+        for attempt in range(max_retries + 1):
             try:
                 response = self._session.request(
                     method,
@@ -163,19 +171,19 @@ class TweetAPI:
                 last_error = ConnectionError_(
                     f"Request timed out ({self._timeout_desc})", e
                 )
-                if attempt < self._max_retries:
+                if attempt < max_retries:
                     time.sleep(self._calculate_retry_delay(last_error, attempt))
                     continue
                 raise last_error from e
             except requests.exceptions.ConnectionError as e:
                 last_error = ConnectionError_(f"Network error: {e}", e)
-                if attempt < self._max_retries:
+                if attempt < max_retries:
                     time.sleep(self._calculate_retry_delay(last_error, attempt))
                     continue
                 raise last_error from e
             except requests.exceptions.RequestException as e:
                 last_error = ConnectionError_(f"Request failed: {e}", e)
-                if attempt < self._max_retries:
+                if attempt < max_retries:
                     time.sleep(self._calculate_retry_delay(last_error, attempt))
                     continue
                 raise last_error from e
@@ -190,7 +198,7 @@ class TweetAPI:
                             "retry_after": err.retry_after,
                             "timestamp": time.time(),
                         }
-                    if attempt < self._max_retries and self._is_retryable(err):
+                    if attempt < max_retries and self._is_retryable(err):
                         time.sleep(self._calculate_retry_delay(err, attempt))
                         continue
                     raise

{tweetapi-2.2.1 → tweetapi-2.3.0}/tweetapi/resources/profile.py

@@ -4,7 +4,12 @@ from typing import Optional, TYPE_CHECKING
 
 if TYPE_CHECKING:
     from ..client import TweetAPI
-    from ..types import ProfileMediaInput, ProfilePrivacyResponse, UserResponse
+    from ..types import (
+        ProfileMediaInput,
+        ProfilePrivacyResponse,
+        ProfileUsernameResponse,
+        UserResponse,
+    )
 
 
 class ProfileResource:
@@ -41,3 +46,12 @@ class ProfileResource:
         return self._client._post("/tw-v2/profile/privacy", {
             "authToken": auth_token, "isPrivate": is_private, "proxy": proxy,
         })
+
+    def update_username(self, *, auth_token: str, password: str, username: str, proxy: Optional[str] = None) -> ProfileUsernameResponse:
+        """Update the authenticated account's username."""
+        return self._client._post("/tw-v2/profile/username", {
+            "authToken": auth_token,
+            "password": password,
+            "username": username,
+            "proxy": proxy,
+        }, retry=False)

{tweetapi-2.2.1 → tweetapi-2.3.0}/tweetapi/types.py

@@ -568,6 +568,14 @@ class ProfilePrivacyResponse(TypedDict):
     data: ProfilePrivacy
 
 
+class ProfileUsername(TypedDict):
+    username: str
+
+
+class ProfileUsernameResponse(TypedDict):
+    data: ProfileUsername
+
+
 class UsersResponse(TypedDict):
     data: list[User]