87 lines
2.6 KiB
Python
87 lines
2.6 KiB
Python
"""The catalogue registry.
|
|
|
|
Beefy Player speaks to internet radio through :class:`RadioProvider`
|
|
implementations (see :mod:`beefy_player.providers.base`). Each provider is
|
|
registered here once; the app looks its provider up by slug, and ``--provider``
|
|
on the command line is validated against :func:`available_providers`.
|
|
|
|
Adding a catalogue is meant to be a small, contained change:
|
|
|
|
1. write the package (``beefy_player/providers/<slug>/``) with a
|
|
:class:`~beefy_player.providers.base.RadioProvider` subclass,
|
|
2. add one instance to :data:`PROVIDERS` below,
|
|
3. that is it — the UI, the player, the spectrum and the media session do not
|
|
care where the stations came from.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
from .base import RadioProvider
|
|
from .bassdrive import BassdriveProvider
|
|
from .community import (
|
|
AnonradioProvider,
|
|
CashmereProvider,
|
|
DatafruitsProvider,
|
|
DublabProvider,
|
|
LotProvider,
|
|
LylProvider,
|
|
RefugeProvider,
|
|
RinseProvider,
|
|
)
|
|
from .radiobrowser import RadioBrowserProvider
|
|
from .radioparadise import RadioParadiseProvider
|
|
from .somafm import SomaFMProvider
|
|
from .tilderadio import TilderadioProvider
|
|
|
|
__all__ = [
|
|
"DEFAULT_PROVIDER",
|
|
"PROVIDERS",
|
|
"RadioProvider",
|
|
"available_providers",
|
|
"get_provider",
|
|
]
|
|
|
|
#: Every catalogue the app can talk to, keyed by its slug. The picker, the
|
|
#: help screen and ``--list`` all read this order: alphabetical by name.
|
|
PROVIDERS: dict[str, RadioProvider] = {
|
|
provider.id: provider
|
|
for provider in sorted(
|
|
(
|
|
SomaFMProvider(),
|
|
TilderadioProvider(),
|
|
BassdriveProvider(),
|
|
RadioBrowserProvider(),
|
|
RadioParadiseProvider(),
|
|
DublabProvider(),
|
|
RinseProvider(),
|
|
RefugeProvider(),
|
|
LylProvider(),
|
|
LotProvider(),
|
|
CashmereProvider(),
|
|
DatafruitsProvider(),
|
|
AnonradioProvider(),
|
|
),
|
|
key=lambda provider: provider.name.casefold(),
|
|
)
|
|
}
|
|
|
|
#: Provider used when nothing else is configured.
|
|
DEFAULT_PROVIDER = SomaFMProvider.id
|
|
|
|
|
|
def available_providers() -> tuple[str, ...]:
|
|
"""Registered provider slugs, for ``--provider`` and the config file."""
|
|
return tuple(PROVIDERS)
|
|
|
|
|
|
def get_provider(provider_id: str | None = None) -> RadioProvider:
|
|
"""Look a provider up by slug, falling back to the default one.
|
|
|
|
An unknown slug is a stale config file or a typo, not a reason to refuse to
|
|
start; the help screen and ``--list`` always name what is in use.
|
|
"""
|
|
key = (provider_id or "").strip().lower()
|
|
if key in PROVIDERS:
|
|
return PROVIDERS[key]
|
|
return PROVIDERS[DEFAULT_PROVIDER]
|