Phase 4 - Stream Health and Fallback: - StreamHealthChecker with partial GET validation of m3u8 content - Bitrate extraction from BANDWIDTH tags - Response time measurement for quality ranking - Fallback ordering: live first, fastest response time first - GET /streams now only returns health-verified streams Phase 5 - HLS Proxy Core: - GET /proxy?url= - m3u8 playlist fetch with full URI rewriting - GET /relay?url= - chunked segment relay (never buffers full segment) - m3u8 rewriter handles master, variant, and segment URIs - Base64url encoding for URL parameters - CORS middleware for browser playback - Range header forwarding for seeking support
35 lines
1.3 KiB
Python
35 lines
1.3 KiB
Python
"""Data models for the stream extraction framework."""
|
|
|
|
from dataclasses import dataclass, field
|
|
from datetime import datetime, timezone
|
|
|
|
|
|
@dataclass
|
|
class ExtractedStream:
|
|
"""Represents a single stream URL discovered by an extractor."""
|
|
|
|
url: str # The HLS/m3u8 URL
|
|
site_key: str # Which extractor found it
|
|
site_name: str # Human-readable name
|
|
quality: str = "" # e.g., "720p", "1080p", or empty
|
|
title: str = "" # e.g., "F1 Race Live"
|
|
extracted_at: str = field(default_factory=lambda: datetime.now(timezone.utc).isoformat())
|
|
is_live: bool = False # Whether it passed health check
|
|
response_time_ms: int = 0 # Health check response time (lower = better)
|
|
checked_at: str = "" # ISO timestamp of last health check
|
|
bitrate: int = 0 # Bitrate in bps if detectable from m3u8 playlist
|
|
|
|
def to_dict(self) -> dict:
|
|
"""Serialize to a plain dictionary for JSON responses."""
|
|
return {
|
|
"url": self.url,
|
|
"site_key": self.site_key,
|
|
"site_name": self.site_name,
|
|
"quality": self.quality,
|
|
"title": self.title,
|
|
"extracted_at": self.extracted_at,
|
|
"is_live": self.is_live,
|
|
"response_time_ms": self.response_time_ms,
|
|
"checked_at": self.checked_at,
|
|
"bitrate": self.bitrate,
|
|
}
|