Barbagus
56c1e8468a
Significant rewrite after model modification: introducing `*Sources` objects that encapsulate metadata and fetch information (urls, protocols). The API (#20) is organized as pipe elements with sources being what flows through the pipe. 1. fetch program sources 2. fetch rendition sources 3. fetch variant sources 4. fetch targets 5. process (download+mux) targets Some user selection filter or modifiers could then be applied at any step of the pipe. Our __main__.py is an implementation of that scheme. Implied modifications include: - Later failure on unsupported protocols, used to be in `api`, now in `hls`. This offers the possibility to filter and/or support them later. - Give up honoring the http ranges for mp4 download, stream-download them by fixed chunk instead. - Cleaning up of the `hls` module moving the main download function to __init__ and specific (mp4/vtt) download functions to a new `download` module. On the side modifications include: - The progress handler showing downloading rates. - The naming utilities providing rendition and variant code insertion. - Download parts to working directories and skip unnecessary re-downloads on failure. This was a big change for a single commit... too big of a change maybe.
138 lines
2.4 KiB
Python
138 lines
2.4 KiB
Python
# License: GNU AGPL v3: http://www.gnu.org/licenses/
|
|
# This file is part of `delarte` (https://git.afpy.org/fcode/delarte.git)
|
|
|
|
"""Provide data model types."""
|
|
|
|
|
|
from typing import NamedTuple, Optional
|
|
|
|
|
|
#
|
|
# Metadata objects
|
|
#
|
|
class Program(NamedTuple):
|
|
"""A program metadata."""
|
|
|
|
id: str
|
|
language: str
|
|
title: str
|
|
subtitle: str
|
|
|
|
|
|
class Rendition(NamedTuple):
|
|
"""A program rendition metadata."""
|
|
|
|
code: str
|
|
label: str
|
|
|
|
|
|
class Variant(NamedTuple):
|
|
"""A program variant metadata."""
|
|
|
|
code: str
|
|
average_bandwidth: int
|
|
|
|
|
|
#
|
|
# Track objects
|
|
#
|
|
class VideoTrack(NamedTuple):
|
|
"""A video track."""
|
|
|
|
width: int
|
|
height: int
|
|
frame_rate: float
|
|
|
|
|
|
class AudioTrack(NamedTuple):
|
|
"""An audio track."""
|
|
|
|
name: str
|
|
language: str
|
|
original: bool
|
|
visual_impaired: bool
|
|
|
|
|
|
class SubtitlesTrack(NamedTuple):
|
|
"""A subtitles track."""
|
|
|
|
name: str
|
|
language: str
|
|
hearing_impaired: bool
|
|
|
|
|
|
#
|
|
# Source objects
|
|
#
|
|
class ProgramSource(NamedTuple):
|
|
"""A program source item."""
|
|
|
|
program: Program
|
|
player_config_url: str
|
|
|
|
|
|
class RenditionSource(NamedTuple):
|
|
"""A rendition source item."""
|
|
|
|
program: Program
|
|
rendition: Rendition
|
|
protocol: str
|
|
program_index_url: Program
|
|
|
|
|
|
class VariantSource(NamedTuple):
|
|
"""A variant source item."""
|
|
|
|
class VideoMedia(NamedTuple):
|
|
"""A video media."""
|
|
|
|
track: VideoTrack
|
|
track_index_url: str
|
|
|
|
class AudioMedia(NamedTuple):
|
|
"""An audio media."""
|
|
|
|
track: AudioTrack
|
|
track_index_url: str
|
|
|
|
class SubtitlesMedia(NamedTuple):
|
|
"""A subtitles media."""
|
|
|
|
track: SubtitlesTrack
|
|
track_index_url: str
|
|
|
|
program: Program
|
|
rendition: Rendition
|
|
variant: Variant
|
|
video_media: VideoMedia
|
|
audio_media: AudioMedia
|
|
subtitles_media: Optional[SubtitlesMedia]
|
|
|
|
|
|
class Target(NamedTuple):
|
|
"""A download target item."""
|
|
|
|
class VideoInput(NamedTuple):
|
|
"""A video input."""
|
|
|
|
track: VideoTrack
|
|
url: str
|
|
|
|
class AudioInput(NamedTuple):
|
|
"""An audio input."""
|
|
|
|
track: AudioTrack
|
|
url: str
|
|
|
|
class SubtitlesInput(NamedTuple):
|
|
"""A subtitles input."""
|
|
|
|
track: SubtitlesTrack
|
|
url: str
|
|
|
|
video_input: VideoInput
|
|
audio_input: AudioInput
|
|
subtitles_input: Optional[SubtitlesInput]
|
|
title: str | tuple[str, str]
|
|
output: str
|