marqetive-lib 0.1.22__tar.gz → 0.2.2__tar.gz

{marqetive_lib-0.1.22 → marqetive_lib-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: marqetive-lib
-Version: 0.1.22
+Version: 0.2.2
 Summary: Modern Python utilities for web APIs
 Keywords: api,utilities,web,http,marqetive
 Requires-Python: >=3.12

{marqetive_lib-0.1.22 → marqetive_lib-0.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "poetry.core.masonry.api"
 
 [project]
 name = "marqetive-lib"
-version = "0.1.22"
+version = "0.2.2"
 description = "Modern Python utilities for web APIs"
 readme = "README.md"
 requires-python = ">=3.12"

{marqetive_lib-0.1.22 → marqetive_lib-0.2.2}/src/marqetive/__init__.py

@@ -47,6 +47,7 @@ from marqetive.core.exceptions import (
     PlatformError,
     PostNotFoundError,
     RateLimitError,
+    ThreadCancelledException,
     ValidationError,
 )
 
@@ -79,7 +80,7 @@ from marqetive.utils.helpers import format_response
 # Retry utilities
 from marqetive.utils.retry import STANDARD_BACKOFF, BackoffConfig, retry_async
 
-__version__ = "0.2.0"
+__version__ = "0.2.2"
 
 __all__ = [
     # Core
@@ -119,6 +120,7 @@ __all__ = [
     "MediaUploadError",
     "ValidationError",
     "InvalidFileTypeError",
+    "ThreadCancelledException",
     # Types
     "ProgressCallback",
     # Utilities

{marqetive_lib-0.1.22 → marqetive_lib-0.2.2}/src/marqetive/core/base.py

@@ -389,6 +389,7 @@ class SocialMediaPlatform(ABC):
     async def create_thread(
         self,
         posts: list[PostCreateRequest],
+        cancellation_check: Callable[[], Awaitable[bool]] | None = None,
     ) -> list[Post]:
         """Create a thread of connected posts.
 
@@ -400,6 +401,8 @@ class SocialMediaPlatform(ABC):
             posts: List of post requests to create as a thread.
                    Each post can have its own content, media, etc.
                    First post is the head of the thread.
+            cancellation_check: Optional async callback that returns True if the
+                   thread creation should be cancelled. Called before each post.
 
         Returns:
             List of Post objects for each post in the thread.
@@ -408,6 +411,7 @@ class SocialMediaPlatform(ABC):
             NotImplementedError: If platform doesn't support threads.
             ValidationError: If posts list is empty.
             PlatformAuthError: If not authenticated.
+            ThreadCancelledException: If cancelled mid-thread (includes posted items).
 
         Example:
             >>> # Twitter thread example

{marqetive_lib-0.1.22 → marqetive_lib-0.2.2}/src/marqetive/core/exceptions.py

@@ -4,6 +4,13 @@ This module defines platform-specific exceptions for handling errors
 that may occur during API interactions with various social media platforms.
 """
 
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from marqetive.core.models import Post
+
 
 class PlatformError(Exception):
     """Base exception for all platform-related errors.
@@ -266,3 +273,42 @@ class InvalidFileTypeError(PlatformError):
         if self.file_type:
             return f"{base_message} | File type: {self.file_type}"
         return base_message
+
+
+class ThreadCancelledException(PlatformError):
+    """Raised when a thread is cancelled mid-posting.
+
+    This exception is raised when:
+    - A cancellation callback returns True during thread creation
+    - Thread posting is interrupted before completion
+
+    The exception includes the list of posts that were successfully
+    created before cancellation, allowing the caller to handle rollback.
+
+    Args:
+        message: Human-readable error message
+        platform: Name of the platform where cancellation occurred
+        posted_tweets: List of Post objects that were created before cancellation
+
+    Example:
+        >>> try:
+        ...     await client.create_thread(tweets, cancellation_check=check_cancel)
+        ... except ThreadCancelledException as e:
+        ...     for post in e.posted_tweets:
+        ...         await client.delete_post(post.post_id)
+    """
+
+    def __init__(
+        self,
+        message: str,
+        platform: str | None = None,
+        posted_tweets: list[Post] | None = None,
+    ) -> None:
+        self.posted_tweets = posted_tweets or []
+        super().__init__(message, platform)
+
+    def _format_message(self) -> str:
+        """Format the error message with posted tweet count."""
+        base_message = super()._format_message()
+        count = len(self.posted_tweets)
+        return f"{base_message} | Posted tweets: {count}"

{marqetive_lib-0.1.22 → marqetive_lib-0.2.2}/src/marqetive/platforms/twitter/client.py

@@ -6,6 +6,7 @@ ABC for Twitter (X), using the Twitter API v2 via tweepy.
 API Documentation: https://developer.x.com/en/docs/twitter-api
 """
 
+from collections.abc import Awaitable, Callable
 from datetime import datetime
 from typing import Any
 
@@ -20,6 +21,7 @@ from marqetive.core.exceptions import (
     PlatformError,
     PostNotFoundError,
     RateLimitError,
+    ThreadCancelledException,
     ValidationError,
 )
 from marqetive.core.models import (
@@ -681,6 +683,7 @@ class TwitterClient(SocialMediaPlatform):
     async def create_thread(
         self,
         posts: list[PostCreateRequest],
+        cancellation_check: Callable[[], Awaitable[bool]] | None = None,
     ) -> list[Post]:
         """Create a Twitter thread (multiple linked tweets).
 
@@ -691,6 +694,8 @@ class TwitterClient(SocialMediaPlatform):
             posts: List of PostCreateRequest objects to create as a thread.
                    First tweet is the head of the thread.
                    Use TwitterPostRequest for Twitter-specific features.
+            cancellation_check: Optional async callback that returns True if the
+                   thread creation should be cancelled. Called before each tweet.
 
         Returns:
             List of Post objects for each tweet in the thread.
@@ -699,6 +704,7 @@ class TwitterClient(SocialMediaPlatform):
             ValidationError: If posts list is empty.
             PlatformAuthError: If not authenticated.
             MediaUploadError: If media upload fails.
+            ThreadCancelledException: If cancelled mid-thread (includes posted tweets).
             RuntimeError: If client not used as context manager.
 
         Example:
@@ -723,6 +729,14 @@ class TwitterClient(SocialMediaPlatform):
         reply_to_id: str | None = None
 
         for idx, post_request in enumerate(posts):
+            # Check cancellation BEFORE posting each tweet
+            if cancellation_check is not None and await cancellation_check():
+                raise ThreadCancelledException(
+                    f"Thread cancelled after {len(created_posts)} of {len(posts)} tweets",
+                    platform=self.platform_name,
+                    posted_tweets=created_posts,
+                )
+
             # Convert to TwitterPostRequest if needed and set reply chain
             if isinstance(post_request, TwitterPostRequest):
                 if reply_to_id is not None: