marqetive-lib 0.1.2__py3-none-any.whl → 0.1.4__py3-none-any.whl

marqetive/platforms/twitter/__init__.py

@@ -1,7 +1,5 @@
 """Twitter/X platform integration."""
 
-from src.marqetive.platforms.twitter.client import TwitterClient
-from src.marqetive.platforms.twitter.factory import TwitterAccountFactory
-from src.marqetive.platforms.twitter.manager import TwitterPostManager
+from marqetive.platforms.twitter.client import TwitterClient
 
-__all__ = ["TwitterClient", "TwitterAccountFactory", "TwitterPostManager"]
+__all__ = ["TwitterClient"]

marqetive/platforms/twitter/client.py

@@ -13,8 +13,8 @@ import httpx
 import tweepy
 from pydantic import HttpUrl
 
-from src.marqetive.platforms.base import SocialMediaPlatform
-from src.marqetive.platforms.exceptions import (
+from marqetive.platforms.base import ProgressCallback, SocialMediaPlatform
+from marqetive.platforms.exceptions import (
     MediaUploadError,
     PlatformAuthError,
     PlatformError,
@@ -22,7 +22,7 @@ from src.marqetive.platforms.exceptions import (
     RateLimitError,
     ValidationError,
 )
-from src.marqetive.platforms.models import (
+from marqetive.platforms.models import (
     AuthCredentials,
     Comment,
     CommentStatus,
@@ -33,12 +33,7 @@ from src.marqetive.platforms.models import (
     PostStatus,
     PostUpdateRequest,
 )
-from src.marqetive.platforms.twitter.media import TwitterMediaManager
-from src.marqetive.platforms.twitter.threads import (
-    ThreadResult,
-    TweetData,
-    TwitterThreadManager,
-)
+from marqetive.platforms.twitter.media import TwitterMediaManager
 
 
 class TwitterClient(SocialMediaPlatform):
@@ -72,12 +67,15 @@ class TwitterClient(SocialMediaPlatform):
         self,
         credentials: AuthCredentials,
         timeout: float = 30.0,
+        progress_callback: ProgressCallback | None = None,
     ) -> None:
         """Initialize Twitter client.
 
         Args:
             credentials: Twitter authentication credentials
             timeout: Request timeout in seconds
+            progress_callback: Optional callback for progress updates during
+                long-running operations like media uploads.
 
         Raises:
             PlatformAuthError: If credentials are invalid
@@ -88,15 +86,15 @@ class TwitterClient(SocialMediaPlatform):
             credentials=credentials,
             base_url=base_url,
             timeout=timeout,
+            progress_callback=progress_callback,
         )
 
         # Initialize tweepy client
         self._tweepy_client: tweepy.Client | None = None
         self._setup_tweepy_client()
 
-        # Initialize media and thread managers
+        # Initialize media manager
         self._media_manager: TwitterMediaManager | None = None
-        self._thread_manager: TwitterThreadManager | None = None
 
     def _setup_tweepy_client(self) -> None:
         """Setup tweepy Client with credentials."""
@@ -107,7 +105,7 @@ class TwitterClient(SocialMediaPlatform):
         )
 
     async def _setup_managers(self) -> None:
-        """Setup media and thread managers."""
+        """Setup media manager."""
         if not self._tweepy_client:
             return
 
@@ -117,15 +115,11 @@ class TwitterClient(SocialMediaPlatform):
             timeout=self.timeout,
         )
 
-        # Initialize thread manager
-        self._thread_manager = TwitterThreadManager(self._tweepy_client)
-
     async def _cleanup_managers(self) -> None:
-        """Cleanup media and thread managers."""
+        """Cleanup media manager."""
         if self._media_manager:
             await self._media_manager.__aexit__(None, None, None)
             self._media_manager = None
-        self._thread_manager = None
 
     async def __aenter__(self) -> "TwitterClient":
         """Async context manager entry."""
@@ -138,42 +132,6 @@ class TwitterClient(SocialMediaPlatform):
         await self._cleanup_managers()
         await super().__aexit__(exc_type, exc_val, exc_tb)
 
-    # ==================== Thread Methods ====================
-
-    async def create_thread(
-        self,
-        tweets: list[TweetData],
-        *,
-        auto_number: bool = False,
-        number_format: str = "{index}/{total}",
-    ) -> ThreadResult:
-        """Create a Twitter thread from multiple tweets."""
-        if not self._thread_manager:
-            raise RuntimeError("Client must be used as async context manager")
-
-        return await self._thread_manager.create_thread(
-            tweets,
-            auto_number=auto_number,
-            number_format=number_format,
-        )
-
-    async def delete_thread(
-        self,
-        thread_id: str,
-        tweet_ids: list[str],
-        *,
-        continue_on_error: bool = True,
-    ) -> dict[str, bool]:
-        """Delete all tweets in a thread."""
-        if not self._thread_manager:
-            raise RuntimeError("Client must be used as async context manager")
-
-        return await self._thread_manager.delete_thread(
-            thread_id,
-            tweet_ids,
-            continue_on_error=continue_on_error,
-        )
-
     # ==================== Authentication Methods ====================
 
     async def authenticate(self) -> AuthCredentials:

marqetive/platforms/twitter/exceptions.py

@@ -9,7 +9,7 @@ This module provides comprehensive error handling for Twitter API errors includi
 
 from typing import Any
 
-from src.marqetive.platforms.exceptions import (
+from marqetive.platforms.exceptions import (
     MediaUploadError,
     PlatformAuthError,
     PlatformError,

marqetive/platforms/twitter/media.py

@@ -18,17 +18,17 @@ from typing import Any, Literal
 
 import httpx
 
-from src.marqetive.platforms.exceptions import (
+from marqetive.platforms.exceptions import (
     InvalidFileTypeError,
     MediaUploadError,
 )
-from src.marqetive.utils.file_handlers import download_file
-from src.marqetive.utils.media import (
+from marqetive.utils.file_handlers import download_file
+from marqetive.utils.media import (
     detect_mime_type,
     format_file_size,
     get_chunk_count,
 )
-from src.marqetive.utils.retry import STANDARD_BACKOFF, retry_async
+from marqetive.utils.retry import STANDARD_BACKOFF, retry_async
 
 logger = logging.getLogger(__name__)
 

marqetive/utils/__init__.py

@@ -1,6 +1,6 @@
 """Utility functions for MarqetiveLib."""
 
-from src.marqetive.utils.file_handlers import (
+from marqetive.utils.file_handlers import (
     TempFileManager,
     download_file,
     download_to_memory,
@@ -9,8 +9,8 @@ from src.marqetive.utils.file_handlers import (
     stream_file_upload,
     write_file_bytes,
 )
-from src.marqetive.utils.helpers import format_response, parse_query_params
-from src.marqetive.utils.media import (
+from marqetive.utils.helpers import format_response, parse_query_params
+from marqetive.utils.media import (
     MediaValidator,
     chunk_file,
     detect_mime_type,

marqetive/utils/file_handlers.py

@@ -17,7 +17,7 @@ from typing import Any
 import aiofiles
 import httpx
 
-from src.marqetive.utils.media import detect_mime_type, format_file_size
+from marqetive.utils.media import detect_mime_type, format_file_size
 
 
 class DownloadProgress:

marqetive/utils/oauth.py

@@ -10,8 +10,8 @@ from typing import Any
 
 import httpx
 
-from src.marqetive.platforms.exceptions import PlatformAuthError
-from src.marqetive.platforms.models import AuthCredentials
+from marqetive.platforms.exceptions import PlatformAuthError
+from marqetive.platforms.models import AuthCredentials
 
 logger = logging.getLogger(__name__)
 

marqetive/utils/token_validator.py

@@ -8,7 +8,7 @@ import re
 from datetime import datetime, timedelta
 from typing import Any
 
-from src.marqetive.platforms.models import AuthCredentials
+from marqetive.platforms.models import AuthCredentials
 
 
 def is_token_expired(

{marqetive_lib-0.1.2.dist-info → marqetive_lib-0.1.4.dist-info}/METADATA

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

marqetive_lib-0.1.4.dist-info/RECORD

@@ -0,0 +1,35 @@
+marqetive/__init__.py,sha256=LaGrC2HSkbpJBj9mKWuVOflTSN1upTzHowZm6Aw0nOY,2923
+marqetive/core/__init__.py,sha256=qOC6JhGjWOpj9_7umtc6VGH16ZJZE6iNDhA6iDZm8kg,113
+marqetive/core/client.py,sha256=2_FoNpqaRglsWg10i5RTbyDg_kRQKhgWjYs6iDdFxLg,3210
+marqetive/factory.py,sha256=W-8O7eowx_M5ykmL9ZEnjZVoMqNKq8rsDWpyU6X7mxg,14107
+marqetive/platforms/__init__.py,sha256=jMzSg8fI5nCO20aTNaoF6cQ6RIZoxzVhEDvq3ZpAbXc,1327
+marqetive/platforms/base.py,sha256=o0bY9tcV350uGYOHpo3SbSYI61gvx6Ll9KyHaSYFXko,13258
+marqetive/platforms/exceptions.py,sha256=Xyj0bzNiZm5VTErmzXgVW8T6IQnOpF92-HJiKPKjIio,7076
+marqetive/platforms/instagram/__init__.py,sha256=7ClfTovAcCHac2DzKS7z1MFuZpy9lcwet7YP5d6MPeY,135
+marqetive/platforms/instagram/client.py,sha256=Y7jnIDoIRnzwP3QtubwKd8aRi89zrxr5ZLgCqS43xwI,25202
+marqetive/platforms/instagram/exceptions.py,sha256=zwTc90VbG8uz_6O5bKw68Pp53SoevLQUqPiXj4ZgThU,8983
+marqetive/platforms/instagram/media.py,sha256=JDRFB66UlhSjAf0PFR3raGqYxtNTSd5yIZ_2xTGmZRk,21166
+marqetive/platforms/linkedin/__init__.py,sha256=zCnokoPYs56iA1sBSYIlaZW2J50L3CbnQpJSaOLrzP8,131
+marqetive/platforms/linkedin/client.py,sha256=GSWUq66KkerS4H9Vh8j3F6KrMzrlz1DYokbERNyrrCc,23821
+marqetive/platforms/linkedin/exceptions.py,sha256=WHjMZ-XJnKgT6uzzi7LXqFt4lD7nSCjzMzaqtOQA3hM,9767
+marqetive/platforms/linkedin/media.py,sha256=360OT1sdBuJRjuL3wJ-T1irAX5gHmcf4AwAU__cvwwA,16901
+marqetive/platforms/models.py,sha256=W_yOuRWItWSn82n8vXRNN_ScdNkzY1De2qqXaVN2RGU,10974
+marqetive/platforms/tiktok/__init__.py,sha256=BQtxdECd2bW9_vV9W-MY4A1rdXi_xurGWWmzTjTUpMM,123
+marqetive/platforms/tiktok/client.py,sha256=UkljwzrSybIgm4opT5ItT_EXdGx3OGbV4ig8yPoaCbM,17041
+marqetive/platforms/tiktok/exceptions.py,sha256=yOjkZgHyo_t9Chrhws_2n-2sbiDDkCUBv5fdW2nfiHI,10129
+marqetive/platforms/tiktok/media.py,sha256=pAT9AVZX7ZnAnhgoameFLszKDyX16nY43we_CHc5z9s,23771
+marqetive/platforms/twitter/__init__.py,sha256=AA5BELRvZyl2WE_7-puSEWArxZjaXcTJ_i8NGOWrv6k,129
+marqetive/platforms/twitter/client.py,sha256=vZ9wvFPaTOuBD-L48RD1UH6MCPZoF2EHRvFWe0m_cfc,19642
+marqetive/platforms/twitter/exceptions.py,sha256=aKrjUZL07KWQ8hatj5-U7UfnSTl-n8DnTgGGigYCrIY,8931
+marqetive/platforms/twitter/media.py,sha256=16atvKwSukvK_YC_gIm2qsl3pmidWEBAwIfJBPG9HQo,24968
+marqetive/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+marqetive/utils/__init__.py,sha256=bSrNajbxYBSKQayrPviLz8JeGjplnyK8y_NGDtgb7yQ,977
+marqetive/utils/file_handlers.py,sha256=4TP5kmWofNTSZmlS683CM1UYP83WvRd_NubMbqtXv-g,12568
+marqetive/utils/helpers.py,sha256=8-ljhL47SremKcQO2GF8DIHOPODEv1rSioVNuSPCbec,2634
+marqetive/utils/media.py,sha256=Rvxw9XKU65n-z4G1bEihG3wXZBmjSDZUqClfjGFrg6k,12013
+marqetive/utils/oauth.py,sha256=NjHh3o5iKlXMJmzSFJHq-pn5yn82DvmpB7DMTJT0ht8,12105
+marqetive/utils/retry.py,sha256=lAniJLMNWp9XsHrvU0XBNifpNEjfde4MGfd5hlFTPfA,7636
+marqetive/utils/token_validator.py,sha256=pNimFr_FNJLcYGV5oADhoBjflKfEbLQ3Epwnwg_nTbg,6703
+marqetive_lib-0.1.4.dist-info/METADATA,sha256=KawBEFdT6w-WUGCF5ulti5nfi6cWer0oOqP-DFXDDaM,7798
+marqetive_lib-0.1.4.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
+marqetive_lib-0.1.4.dist-info/RECORD,,

marqetive/core/account_factory.py

@@ -1,212 +0,0 @@
-"""Base account factory for managing platform credentials and client creation.
-
-This module provides an abstract base class for platform-specific account
-factories that handle credential management, token refresh, and client creation.
-"""
-
-import logging
-from abc import ABC, abstractmethod
-from collections.abc import Callable
-from typing import Any
-
-from src.marqetive.platforms.exceptions import PlatformAuthError
-from src.marqetive.platforms.models import AccountStatus, AuthCredentials
-
-logger = logging.getLogger(__name__)
-
-
-class BaseAccountFactory(ABC):
-    """Abstract base class for platform account factories.
-
-    Account factories manage the lifecycle of platform credentials including:
-    - Token expiry checking and automatic refresh
-    - Account status management
-    - Platform-specific client creation
-
-    Subclasses must implement:
-    - refresh_token(): Platform-specific token refresh logic
-    - create_client(): Create platform-specific API client
-    - validate_credentials(): Check if credentials are valid
-
-    Example:
-        >>> class TwitterAccountFactory(BaseAccountFactory):
-        ...     async def refresh_token(self, credentials):
-        ...         # Implement Twitter OAuth token refresh
-        ...         pass
-        ...
-        ...     async def create_client(self, credentials):
-        ...         return TwitterClient(credentials=credentials)
-        ...
-        ...     async def validate_credentials(self, credentials):
-        ...         # Check if credentials work
-        ...         pass
-    """
-
-    def __init__(
-        self,
-        on_status_update: Callable[[str, AccountStatus], None] | None = None,
-    ) -> None:
-        """Initialize the account factory.
-
-        Args:
-            on_status_update: Optional callback when account status changes.
-                            Called with (user_id, new_status).
-        """
-        self.on_status_update = on_status_update
-
-    @property
-    @abstractmethod
-    def platform_name(self) -> str:
-        """Get the name of the platform this factory manages.
-
-        Returns:
-            Platform name (e.g., "twitter", "linkedin").
-        """
-        pass
-
-    @abstractmethod
-    async def refresh_token(self, credentials: AuthCredentials) -> AuthCredentials:
-        """Refresh the OAuth access token.
-
-        Args:
-            credentials: Current credentials with expired token.
-
-        Returns:
-            Updated credentials with new token.
-
-        Raises:
-            PlatformAuthError: If token refresh fails.
-        """
-        pass
-
-    @abstractmethod
-    async def create_client(self, credentials: AuthCredentials) -> Any:
-        """Create a platform-specific API client.
-
-        Args:
-            credentials: Valid credentials for the platform.
-
-        Returns:
-            Platform-specific API client instance.
-
-        Raises:
-            PlatformAuthError: If credentials are invalid.
-        """
-        pass
-
-    @abstractmethod
-    async def validate_credentials(self, credentials: AuthCredentials) -> bool:
-        """Validate that credentials are working.
-
-        Args:
-            credentials: Credentials to validate.
-
-        Returns:
-            True if credentials are valid, False otherwise.
-        """
-        pass
-
-    async def get_credentials(
-        self,
-        credentials: AuthCredentials,
-        auto_refresh: bool = True,
-    ) -> AuthCredentials:
-        """Get credentials, refreshing if necessary.
-
-        This method checks if credentials are expired and automatically
-        refreshes them if auto_refresh is True.
-
-        Args:
-            credentials: Current credentials.
-            auto_refresh: Whether to automatically refresh expired tokens.
-
-        Returns:
-            Valid credentials (refreshed if necessary).
-
-        Raises:
-            PlatformAuthError: If refresh fails or credentials are invalid.
-        """
-        # Check if token needs refresh
-        if credentials.needs_refresh():
-            if not auto_refresh:
-                logger.warning(
-                    f"Credentials for {credentials.platform} are expired "
-                    "but auto_refresh is disabled"
-                )
-                return credentials
-
-            logger.info(
-                f"Token expired for {credentials.platform}, attempting refresh..."
-            )
-            try:
-                refreshed_creds = await self.refresh_token(credentials)
-                refreshed_creds.mark_valid()
-
-                # Notify status update
-                if self.on_status_update and refreshed_creds.user_id:
-                    self.on_status_update(refreshed_creds.user_id, AccountStatus.VALID)
-
-                logger.info(f"Successfully refreshed token for {credentials.platform}")
-                return refreshed_creds
-
-            except PlatformAuthError as e:
-                # Determine if this is an OAuth error requiring reconnection
-                if "oauth" in str(e).lower() or "authorization" in str(e).lower():
-                    credentials.mark_reconnection_required()
-                    if self.on_status_update and credentials.user_id:
-                        self.on_status_update(
-                            credentials.user_id, AccountStatus.RECONNECTION_REQUIRED
-                        )
-                    logger.error(
-                        f"OAuth error refreshing token for {credentials.platform}: {e}"
-                    )
-                else:
-                    credentials.mark_error()
-                    if self.on_status_update and credentials.user_id:
-                        self.on_status_update(credentials.user_id, AccountStatus.ERROR)
-                    logger.error(
-                        f"Error refreshing token for {credentials.platform}: {e}"
-                    )
-                raise
-
-        return credentials
-
-    async def create_authenticated_client(
-        self,
-        credentials: AuthCredentials,
-        auto_refresh: bool = True,
-    ) -> Any:
-        """Create an authenticated client, refreshing credentials if needed.
-
-        This is the main method to use for getting a ready-to-use client.
-
-        Args:
-            credentials: Platform credentials.
-            auto_refresh: Whether to automatically refresh expired tokens.
-
-        Returns:
-            Authenticated platform client.
-
-        Raises:
-            PlatformAuthError: If authentication fails.
-        """
-        # Get valid credentials (refresh if needed)
-        valid_creds = await self.get_credentials(credentials, auto_refresh=auto_refresh)
-
-        # Create client
-        client = await self.create_client(valid_creds)
-
-        return client
-
-    def _update_status(self, user_id: str | None, status: AccountStatus) -> None:
-        """Internal method to update account status.
-
-        Args:
-            user_id: User ID for the account.
-            status: New status.
-        """
-        if self.on_status_update and user_id:
-            try:
-                self.on_status_update(user_id, status)
-            except Exception as e:
-                logger.error(f"Error calling status update callback: {e}")