Trakt

"""Shared formatting utilities for Trakt MCP server.""" from datetime import datetime from typing import TypeVar from models.types.pagination import PaginatedResponse T = TypeVar("T") def format_pagination_header(results: PaginatedResponse[T]) -> str: """Format pagination metadata and navigation hints. Args: results: Paginated response with metadata Returns: Formatted markdown string with page info and navigation """ message = f"📄 **{results.page_info_summary()}**\n\n" # Add navigation hints if applicable if results.pagination.has_previous_page or results.pagination.has_next_page: nav_parts: list[str] = [] if results.pagination.has_previous_page: nav_parts.append(f"Previous: page {results.pagination.previous_page()}") if results.pagination.has_next_page: nav_parts.append(f"Next: page {results.pagination.next_page()}") message += f"📍 **Navigation:** {' | '.join(nav_parts)}\n\n" return message def format_display_time(timestamp: str) -> str: """Format ISO 8601 timestamp for display. Handles Trakt API timestamp format (ISO 8601 with 'Z' timezone). Args: timestamp: ISO 8601 timestamp string (e.g., "2023-01-01T12:34:56.789Z") Returns: Formatted timestamp string (e.g., "2023-01-01 12:34:56") Falls back to original string if parsing fails """ try: # Support 'Z' timezone notation normalized = timestamp.replace("Z", "+00:00") dt = datetime.fromisoformat(normalized) return dt.strftime("%Y-%m-%d %H:%M:%S") except ValueError: # Fallback to original timestamp if parsing fails return timestamp