rapidata 2.27.0__py3-none-any.whl → 2.44.4__py3-none-any.whl

{rapidata-2.27.0.dist-info → rapidata-2.44.4.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: poetry-core 2.1.3
+Generator: hatchling 1.28.0
 Root-Is-Purelib: true
 Tag: py3-none-any

rapidata/rapidata_client/api/rapidata_exception.py

@@ -1,107 +0,0 @@
-from typing import Optional, Any
-from rapidata.api_client.api_client import ApiClient, rest, ApiResponse, ApiResponseT
-from rapidata.api_client.exceptions import ApiException
-import json
-from rapidata.rapidata_client.logging import logger
-
-class RapidataError(Exception):
-    """Custom error class for Rapidata API errors."""
-    
-    def __init__(
-        self, 
-        status_code: Optional[int] = None, 
-        message: str | None = None, 
-        original_exception: Exception | None = None,
-        details: Any = None
-    ):
-        self.status_code = status_code
-        self.message = message
-        self.original_exception = original_exception
-        self.details = details
-        
-        # Create a nice error message
-        error_msg = "Rapidata API Error"
-        if status_code:
-            error_msg += f" ({status_code})"
-        if message:
-            error_msg += f": {message}"
-            
-        super().__init__(error_msg)
-
-    def __str__(self):
-        """Return a string representation of the error."""        
-        # Extract information from message if available
-        title = None
-        errors = None
-        trace_id = None
-        
-        # Try to extract from details if available and is a dict
-        if self.details and isinstance(self.details, dict):
-            title = self.details.get('title')
-            errors = self.details.get('errors')
-            trace_id = self.details.get('traceId')
-        
-        # Build the error string
-        error_parts = []
-        
-        # Main error line
-        if title:
-            error_parts.append(f"{title}")
-        else:
-            error_parts.append(f"{self.message or 'Unknown error'}")
-        
-        # Reasons
-        if errors:
-            if isinstance(errors, dict):
-                error_parts.append(f"Reasons: {json.dumps({'errors': errors})}")
-            else:
-                error_parts.append(f"Reasons: {errors}")
-        
-        # Trace ID
-        if trace_id:
-            error_parts.append(f"Trace Id: {trace_id}")
-        else:
-            error_parts.append("Trace Id: N/A")
-        
-        return "\n".join(error_parts)
-
-class RapidataApiClient(ApiClient):
-    """Custom API client that wraps errors in RapidataError."""
-
-    def response_deserialize(
-        self,
-        response_data: rest.RESTResponse,
-        response_types_map: Optional[dict[str, ApiResponseT]] = None
-    ) -> ApiResponse[ApiResponseT]:
-        """Override the response_deserialize method to catch and convert exceptions."""
-        try:
-            return super().response_deserialize(response_data, response_types_map)
-        except ApiException as e:
-            status_code = getattr(e, 'status', None)
-            message = str(e)
-            details = None
-            
-            # Extract more detailed error message from response body if available
-            if hasattr(e, 'body') and e.body:
-                try:
-                    body_json = json.loads(e.body)
-                    if isinstance(body_json, dict):
-                        if 'message' in body_json:
-                            message = body_json['message']
-                        elif 'error' in body_json:
-                            message = body_json['error']
-                        
-                        # Store the full error details for debugging
-                        details = body_json
-                except (json.JSONDecodeError, AttributeError):
-                    # If we can't parse the body as JSON, use the original message
-                    pass
-            
-            error_formatted =  RapidataError(
-                status_code=status_code, 
-                message=message, 
-                original_exception=e,
-                details=details
-            )
-            logger.error(f"Error: {error_formatted}")
-            raise error_formatted from None

rapidata/rapidata_client/assets/__init__.py

@@ -1,10 +0,0 @@
-"""Assets Package
-
-This package provides classes for different types of assets, including MediaAsset, TextAsset, and MultiAsset.
-"""
-from ._base_asset import BaseAsset
-from ._media_asset import MediaAsset
-from ._text_asset import TextAsset
-from ._multi_asset import MultiAsset
-from .data_type_enum import RapidataDataTypes
-from ._sessions import SessionManager

rapidata/rapidata_client/assets/_base_asset.py

@@ -1,11 +0,0 @@
-"""Base Asset Module
-
-Defines the BaseAsset class, which serves as the abstract base class for all asset types.
-"""
-
-class BaseAsset:
-    """BaseAsset Class
-
-    An abstract base class for different types of assets. This class is intended to be subclassed by specific asset types.
-    """
-    pass

rapidata/rapidata_client/assets/_media_asset.py

@@ -1,306 +0,0 @@
-"""Media Asset Module with Lazy Loading
-
-Defines the MediaAsset class for handling media file paths within assets.
-Implements lazy loading for URL-based media to prevent unnecessary downloads.
-"""
-
-from typing import Optional, cast
-import os
-from io import BytesIO
-from rapidata.rapidata_client.assets._base_asset import BaseAsset
-import requests
-import re
-from PIL import Image
-from tinytag import TinyTag
-import tempfile
-from pydantic import StrictStr, StrictBytes
-import logging
-from functools import cached_property
-from rapidata.rapidata_client.assets._sessions import SessionManager
-from rapidata.rapidata_client.logging import logger
-
-class MediaAsset(BaseAsset):
-    """MediaAsset Class with Lazy Loading
-
-    Represents a media asset by storing the file path or URL.
-    Only downloads URL content when needed.
-    Supports local files and URLs for images, MP3, and MP4.
-
-    Args:
-        path (str): The file system path to the media asset or URL.
-
-    Raises:
-        FileNotFoundError: If the provided file path does not exist.
-    """
-    _logger = logging.getLogger(__name__ + '.MediaAsset')
-
-    ALLOWED_TYPES = [
-        'image/', 
-        'audio/mp3',      # MP3
-        'video/mp4',       # MP4
-    ]
-
-    MIME_TYPES = {
-        'jpg': 'image/jpeg',
-        'jpeg': 'image/jpeg',
-        'png': 'image/png',
-        'gif': 'image/gif',
-        'webp': 'image/webp',
-        'mp3': 'audio/mp3',
-        'mp4': 'video/mp4'
-    }
-
-    FILE_SIGNATURES = {
-        b'\xFF\xD8\xFF': 'image/jpeg',
-        b'\x89PNG\r\n\x1a\n': 'image/png',
-        b'GIF87a': 'image/gif',
-        b'GIF89a': 'image/gif',
-        b'RIFF': 'image/webp',
-        b'ID3': 'audio/mp3',
-        b'\xFF\xFB': 'audio/mp3',
-        b'\xFF\xF3': 'audio/mp3',
-        b'ftyp': 'video/mp4',
-    }
-
-    def __init__(self, path: str):
-        """
-        Initialize a MediaAsset instance.
-
-        Args:
-            path (str): The file system path to the media asset or a URL.
-
-        Raises:
-            FileNotFoundError: If the provided file path does not exist.
-            ValueError: If path is not a string.
-        """
-        if not isinstance(path, str):
-            raise ValueError("Media must be a string, either a local file path or a URL")
-        
-        self._url = None
-        self._content = None
-        self.session: requests.Session  = SessionManager.get_session()
-        
-        if re.match(r'^https?://', path):
-            self._url = path
-            self.name = path.split('/')[-1]
-            self.name = self.__check_name_ending(self.name)
-            self.path = path
-            return
-        
-        if not os.path.exists(path):
-            raise FileNotFoundError(f"File not found: {path}")
-        
-        self.path = path
-        self.name = path
-
-    @cached_property
-    def content(self) -> bytes:
-        """
-        Lazy loader for URL content. Only downloads when first accessed.
-        Uses cached_property to store the result after first download.
-        """
-        if self._url is None:
-            self.path = cast(str, self.path)
-            with open(self.path, 'rb') as f:
-                return f.read()
-            
-        return self.__get_media_bytes(self._url)
-
-    def get_duration(self) -> int:
-        """
-        Get the duration of audio/video files in milliseconds.
-        Returns 0 for static images.
-
-        Returns:
-            int: Duration in milliseconds for audio/video, 0 for static images
-
-        Raises:
-            ValueError: If the duration cannot be determined
-        """
-        path_to_check = self.name.lower()
-        
-        # Return 0 for static images
-        if any(path_to_check.endswith(ext) for ext in ('.jpg', '.jpeg', '.png', '.webp', '.gif')):
-            return 0
-
-        try:
-            # Create temporary file from content
-            with tempfile.NamedTemporaryFile(suffix=os.path.splitext(self.name)[1], delete=False) as tmp:
-                tmp.write(self.content)
-                tmp.flush()
-                tmp_path = tmp.name
-                
-            try:
-                tag = TinyTag.get(tmp_path)
-            finally:
-                # Clean up the temporary file
-                os.unlink(tmp_path)
-            
-            if tag.duration is None:
-                raise ValueError("Could not read duration from file")
-                
-            return int(tag.duration * 1000)  # Convert to milliseconds
-            
-        except Exception as e:
-            raise ValueError(f"Could not determine media duration: {str(e)}")
-
-    def get_image_dimension(self) -> tuple[int, int] | None:
-        """
-        Get the dimensions (width, height) of an image file.
-        Returns None for non-image files or if dimensions can't be determined.
-        """
-        if not any(self.name.lower().endswith(ext) for ext in ('.jpg', '.jpeg', '.png', '.gif', '.webp')):
-            return None
-            
-        try:
-            img = Image.open(BytesIO(self.content))
-            return img.size
-        except Exception:
-            return None
-
-    def set_custom_name(self, name: str) -> 'MediaAsset':
-        """Set a custom name for the media asset (only works with URLs)."""
-        if self._url is not None:
-            self.name = self.__check_name_ending(name)
-        else:
-            raise ValueError("Custom name can only be set for URLs.")
-        return self
-    
-    def __check_name_ending(self, name: str) -> str:
-        """Check if the media path is valid."""
-        if not name.endswith(('.jpg', '.jpeg', '.png', '.gif', '.mp3', '.mp4', '.webp')):
-            logger.warning("Warning: Supported file types: jpg, jpeg, png, gif, mp3, mp4. Image might not be displayed correctly.")
-            name = name + '.jpg'
-        return name
-
-    def __get_media_type_from_extension(self, url: str) -> Optional[str]:
-        """
-        Determine media type from URL file extension.
-        
-        Args:
-            url: The URL to check
-            
-        Returns:
-            Optional[str]: MIME type if valid extension found, None otherwise
-        """
-        try:
-            ext = url.lower().split('?')[0].split('.')[-1]
-            return self.MIME_TYPES.get(ext)
-        except IndexError:
-            return None
-        
-    def __validate_image_content(self, content: bytes) -> bool:
-        """
-        Validate image content using PIL.
-        
-        Args:
-            content: Image bytes to validate
-            
-        Returns:
-            bool: True if valid image, False otherwise
-        """
-        try:
-            img = Image.open(BytesIO(content))
-            img.verify()
-            return True
-        except Exception as e:
-            self._logger.debug(f"Image validation failed: {str(e)}")
-            return False
-        
-    def __get_media_type_from_signature(self, content: bytes) -> Optional[str]:
-        """
-        Determine media type from file signature.
-        
-        Args:
-            content: File content bytes
-            
-        Returns:
-            Optional[str]: MIME type if valid signature found, None otherwise
-        """
-        file_start = content[:32]
-        for signature, mime_type in self.FILE_SIGNATURES.items():
-            if file_start.startswith(signature) or (signature in file_start[:10]):
-                return mime_type
-        return None
-
-    def __get_media_bytes(self, url: str) -> bytes:
-        """
-        Downloads and validates media files from URL with retry logic and session reuse.
-        
-        Args:
-            url: URL of the media file
-            
-        Returns:
-            bytes: Validated media content
-            
-        Raises:
-            ValueError: If media type is unsupported or content validation fails
-            requests.exceptions.RequestException: If download fails after all retries
-        """
-        # Use existing session or throw error if not set
-        if self.session is None:
-            raise RuntimeError("HTTP session not configured")
-
-        try:
-            response = self.session.get(
-                url, 
-                stream=False,
-                timeout=(5, 30)  # (connect timeout, read timeout)
-            )
-            response.raise_for_status()
-        except requests.exceptions.RequestException as e:
-            self._logger.error(f"Failed to download media from {url} after retries: {str(e)}")
-            raise
-
-        content = response.content
-        content_type = response.headers.get('content-type', '').lower()
-
-        # Case 1: Content-type is already allowed
-        if any(content_type.startswith(t) for t in self.ALLOWED_TYPES):
-            self._logger.debug(f"Content-type {content_type} is allowed")
-            return content
-
-        # Case 2: Try to validate based on extension
-        mime_type = self.__get_media_type_from_extension(url)
-        if mime_type and mime_type.startswith(tuple(self.ALLOWED_TYPES)):
-            self._logger.debug(f"Found valid mime type from extension: {mime_type}")
-            return content
-
-        # Case 3: Try to validate based on file signature
-        mime_type = self.__get_media_type_from_signature(content)
-        if mime_type and mime_type.startswith(tuple(self.ALLOWED_TYPES)):
-            self._logger.debug(f"Found valid mime type from signature: {mime_type}")
-            return content
-
-        # Case 4: Last resort - try direct image validation
-        if self.__validate_image_content(content):
-            self._logger.debug("Content validated as image through direct validation")
-            return content
-
-        # If we get here, validation failed
-        error_msg = (
-            f'Could not validate media type from content.\n'
-            f'Content-Type: {content_type}\n'
-            f'URL extension: {url.split("?")[0].split(".")[-1]}\n'
-            f'Allowed types: {self.ALLOWED_TYPES}'
-        )
-        self._logger.error(error_msg)
-        raise ValueError(error_msg)
-    
-    def is_local(self) -> bool:
-        """Check if the media asset is a local file."""
-        return self._url is None
-    
-    def to_file(self) -> StrictStr | tuple[StrictStr, StrictBytes] | StrictBytes:
-        """Convert the media asset to a file representation."""
-        if self._url is None:
-            self.path = cast(str, self.path)
-            return self.path
-        else:
-            return (self.name, self.content)
-        
-    def __str__(self) -> str:
-        return f"MediaAsset(path={self.path})"
-    
-    def __repr__(self) -> str:
-        return f"MediaAsset(path={self.path})"

rapidata/rapidata_client/assets/_multi_asset.py

@@ -1,61 +0,0 @@
-"""Multi Asset Module
-
-Defines the MultiAsset class for handling multiple BaseAsset instances.
-"""
-
-from rapidata.rapidata_client.assets._base_asset import BaseAsset
-from rapidata.rapidata_client.assets import MediaAsset, TextAsset
-from typing import Iterator, Sequence, cast
-
-
-class MultiAsset(BaseAsset):
-    """MultiAsset Class
-
-    Represents a collection of multiple BaseAsset instances.
-
-    Args:
-        assets (List[BaseAsset]): A list of BaseAsset instances to be managed together.
-    """
-
-    def __init__(self, assets: Sequence[BaseAsset]) -> None:
-        """
-        Initialize a MultiAsset instance.
-
-        Args:
-            assets (List[BaseAsset]): A list of BaseAsset instances to be managed together.
-        """
-        if len(assets) != 2:
-            raise ValueError("Assets must come in pairs for comparison tasks.")
-        
-        for asset in assets:
-            if not isinstance(asset, (TextAsset, MediaAsset)):
-                raise TypeError("All assets must be a TextAsset or MediaAsset.")    
-        
-        if not all(isinstance(asset, type(assets[0])) for asset in assets):
-            raise ValueError("All assets must be of the same type.")
-        
-        self.assets = assets
-        
-    def __len__(self) -> int:
-        """
-        Get the number of assets in the MultiAsset.
-
-        Returns:
-            int: The number of assets.
-        """
-        return len(self.assets)
-
-    def __iter__(self) -> Iterator[BaseAsset]:
-        """
-        Return an iterator over the assets in the MultiAsset.
-
-        Returns:
-            Iterator[BaseAsset]: An iterator over the assets.
-        """
-        return iter(self.assets)
-
-    def __str__(self) -> str:
-        return f"MultiAsset(assets={self.assets})"
-    
-    def __repr__(self) -> str:
-        return f"MultiAsset(assets={self.assets})"

rapidata/rapidata_client/assets/_sessions.py

@@ -1,35 +0,0 @@
-import requests
-from requests.adapters import HTTPAdapter
-from urllib3.util.retry import Retry
-
-class SessionManager:
-    _session = None
-    
-    @classmethod
-    def get_session(cls, ) -> requests.Session:
-        """Get a singleton requests session with retry logic.
-
-        Returns:
-            requests.Session: A singleton requests session with retry logic.
-        """
-        if cls._session is None:
-            max_retries: int = 5 
-            max_workers: int = 10
-            cls._session = requests.Session()
-            retries = Retry(
-                total=max_retries,
-                backoff_factor=1,
-                status_forcelist=[500, 502, 503, 504],
-                allowed_methods=["GET"],
-                respect_retry_after_header=True
-            )
-
-            adapter = HTTPAdapter(
-                pool_connections=max_workers * 2,
-                pool_maxsize=max_workers * 4,
-                max_retries=retries
-            )
-            cls._session.mount('http://', adapter)
-            cls._session.mount('https://', adapter)
-
-        return cls._session

rapidata/rapidata_client/assets/_text_asset.py

@@ -1,34 +0,0 @@
-"""Text Asset Module
-
-Defines the TextAsset class for handling textual data within assets.
-"""
-
-from rapidata.rapidata_client.assets._base_asset import BaseAsset
-
-
-class TextAsset(BaseAsset):
-    """TextAsset Class
-
-    Represents a textual asset.
-
-    Args:
-        text (str): The text content of the asset.
-    """
-
-    def __init__(self, text: str):
-        """
-        Initialize a TextAsset instance.
-
-        Args:
-            text (str): The textual content of the asset.
-        """
-        if not isinstance(text, str):
-            raise ValueError("Text must be a string")
-        
-        self.text = text
-
-    def __str__(self) -> str:
-        return f"TextAsset(text={self.text})"
-    
-    def __repr__(self) -> str:
-        return f"TextAsset(text={self.text})"

rapidata/rapidata_client/assets/data_type_enum.py

@@ -1,7 +0,0 @@
-class RapidataDataTypes:
-    MEDIA = "media" # any form of image, video or audio
-    TEXT = "text"
-
-    @classmethod
-    def _possible_values(cls):
-        return [cls.MEDIA, cls.TEXT]

rapidata/rapidata_client/country_codes/__init__.py

@@ -1 +0,0 @@
-from .country_codes import CountryCodes

rapidata/rapidata_client/country_codes/country_codes.py

@@ -1,19 +0,0 @@
-class CountryCodes:
-
-    ENGLISH_SPEAKING = [
-        "AU",
-        "BE",
-        "CA",
-        "DK",
-        "FI",
-        "IE",
-        "LU",
-        "NL",
-        "NZ",
-        "NO",
-        "SG",
-        "SE",
-        "GB",
-        "US",
-    ]
-    GERMAN_SPEAKING = ["AT", "DE"]

rapidata/rapidata_client/logging/__init__.py

@@ -1,2 +0,0 @@
-from .logger import configure_logger, logger
-from .output_manager import managed_print, RapidataOutputManager

rapidata/rapidata_client/logging/logger.py

@@ -1,47 +0,0 @@
-import logging
-import os
-from typing import Optional
-
-# Create module-level logger
-logger = logging.getLogger("rapidata")
-
-def configure_logger(
-    level: str = "WARNING",
-    log_file: Optional[str] = None,
-    format_string: str = "%(asctime)s - %(name)s - %(levelname)s - %(message)s"
-):
-    """Configure the Rapidata logger with custom settings."""
-    # Convert string level to logging level
-    level_map = {
-        "DEBUG": logging.DEBUG,
-        "INFO": logging.INFO, 
-        "WARNING": logging.WARNING,
-        "ERROR": logging.ERROR,
-        "CRITICAL": logging.CRITICAL
-    }
-    
-    numeric_level = level_map.get(level.upper(), logging.INFO)
-    logger.setLevel(numeric_level)
-    
-    # Remove existing handlers if any
-    for handler in logger.handlers[:]:
-        logger.removeHandler(handler)
-    
-    # Create formatter
-    formatter = logging.Formatter(format_string)
-    
-    # Console handler
-    console_handler = logging.StreamHandler()
-    console_handler.setFormatter(formatter)
-    logger.addHandler(console_handler)
-    
-    # File handler (optional)
-    if log_file:
-        log_dir = os.path.dirname(log_file)
-        if log_dir:
-            os.makedirs(log_dir, exist_ok=True)
-        file_handler = logging.FileHandler(log_file)
-        file_handler.setFormatter(formatter)
-        logger.addHandler(file_handler)
-
-configure_logger()

rapidata/rapidata_client/logging/output_manager.py

@@ -1,16 +0,0 @@
-class RapidataOutputManager:
-    silent_mode = False
-    
-    @classmethod
-    def enable_silent_mode(cls):
-        cls.silent_mode = True
-        
-    @classmethod
-    def disable_silent_mode(cls):
-        cls.silent_mode = False
-
-def managed_print(*args, **kwargs):
-    if not RapidataOutputManager.silent_mode:
-        print(*args, **kwargs)
-
-