mirror of https://github.com/Nezreka/SoulSync.git
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
765 lines
28 KiB
765 lines
28 KiB
"""Tests for core/artists/quality.py — artist quality enhancement helper."""
|
|
|
|
from __future__ import annotations
|
|
|
|
from dataclasses import dataclass
|
|
|
|
import pytest
|
|
|
|
from core.artists import quality as aq
|
|
|
|
|
|
# ---------------------------------------------------------------------------
|
|
# Fakes
|
|
# ---------------------------------------------------------------------------
|
|
|
|
@dataclass
|
|
class _SpotifyTrack:
|
|
id: str = 'sp-1'
|
|
name: str = 'Found'
|
|
artists: list = None
|
|
album: str = 'Album'
|
|
duration_ms: int = 200000
|
|
image_url: str = ''
|
|
popularity: int = 50
|
|
preview_url: str = ''
|
|
external_urls: dict = None
|
|
album_type: str = 'album'
|
|
release_date: str = '2024-01-01'
|
|
|
|
def __post_init__(self):
|
|
if self.artists is None:
|
|
self.artists = ['Artist Name']
|
|
if self.external_urls is None:
|
|
self.external_urls = {}
|
|
|
|
|
|
class _FakeSpotify:
|
|
def __init__(self, track_details=None, search_results=None, album=None):
|
|
self._track_details = track_details
|
|
self._search_results = search_results or []
|
|
self._album = album
|
|
self.search_calls = []
|
|
|
|
def get_track_details(self, track_id):
|
|
return self._track_details
|
|
|
|
def get_album(self, album_id):
|
|
return self._album
|
|
|
|
def search_tracks(self, query, limit=5):
|
|
self.search_calls.append((query, limit))
|
|
return self._search_results
|
|
|
|
|
|
class _FakeMatchingEngine:
|
|
def generate_download_queries(self, track):
|
|
return [f"{track.artists[0]} {track.name}"]
|
|
|
|
def normalize_string(self, s):
|
|
return (s or '').lower().strip()
|
|
|
|
def similarity_score(self, a, b):
|
|
if a == b:
|
|
return 1.0
|
|
if not a or not b:
|
|
return 0.0
|
|
return 0.95 if a in b or b in a else 0.0
|
|
|
|
|
|
class _FakeWishlist:
|
|
def __init__(self):
|
|
self.added = []
|
|
|
|
def add_spotify_track_to_wishlist(self, **kwargs):
|
|
self.added.append(kwargs)
|
|
return True
|
|
|
|
|
|
class _FakeDatabase:
|
|
def __init__(self, artist_detail=None):
|
|
self._artist_detail = artist_detail or {'success': False}
|
|
|
|
def get_artist_full_detail(self, artist_id):
|
|
return self._artist_detail
|
|
|
|
|
|
def _build_deps(
|
|
*,
|
|
spotify=None,
|
|
matching_engine=None,
|
|
artist_detail=None,
|
|
wishlist=None,
|
|
fallback_client=None,
|
|
fallback_source=None,
|
|
search_sources=None,
|
|
profile_id=1,
|
|
quality_tier=('mp3_320', 4),
|
|
):
|
|
"""Build deps for tests.
|
|
|
|
``search_sources`` is the new contract — list of ``(name, client)``
|
|
pairs the multi-source search dispatches across. For convenience,
|
|
``fallback_client`` + ``fallback_source`` are still supported and
|
|
auto-translate to a single-source list when ``search_sources``
|
|
isn't passed (preserves the older test ergonomics).
|
|
"""
|
|
if search_sources is None:
|
|
# Default: build a single-source list from fallback_client +
|
|
# fallback_source, mirroring the legacy single-source contract.
|
|
if fallback_source is None:
|
|
fallback_source = 'spotify' if spotify is not None else 'itunes'
|
|
if fallback_client is None and fallback_source == 'spotify':
|
|
fallback_client = spotify
|
|
search_sources = (
|
|
[(fallback_source, fallback_client)] if fallback_client else []
|
|
)
|
|
# Mirror web_server._resolve_search_sources: Spotify is always
|
|
# added to the source list when a Spotify client is configured,
|
|
# alongside whatever else the user has connected. Tests passing
|
|
# ``spotify=`` get Spotify in the source list automatically so
|
|
# the direct-lookup fast path can find it.
|
|
if spotify is not None and not any(name == 'spotify' for name, _ in search_sources):
|
|
search_sources = [('spotify', spotify)] + list(search_sources)
|
|
deps = aq.ArtistQualityDeps(
|
|
matching_engine=matching_engine or _FakeMatchingEngine(),
|
|
get_database=lambda: _FakeDatabase(artist_detail=artist_detail),
|
|
get_wishlist_service=lambda: wishlist or _FakeWishlist(),
|
|
get_current_profile_id=lambda: profile_id,
|
|
get_quality_tier_from_extension=lambda fp: quality_tier,
|
|
get_metadata_search_sources=lambda: list(search_sources),
|
|
)
|
|
return deps
|
|
|
|
|
|
def _artist_with_track(*, track_id='t1', file_path='/file.mp3',
|
|
spotify_tid=None, deezer_tid=None, itunes_tid=None,
|
|
soul_id=None):
|
|
return {
|
|
'success': True,
|
|
'artist': {'name': 'Artist Name'},
|
|
'albums': [{
|
|
'id': 'a1',
|
|
'title': 'Album X',
|
|
'tracks': [{
|
|
'id': track_id,
|
|
'title': 'Track One',
|
|
'file_path': file_path,
|
|
'spotify_track_id': spotify_tid,
|
|
'deezer_id': deezer_tid,
|
|
'itunes_track_id': itunes_tid,
|
|
'soul_id': soul_id,
|
|
'track_number': 1,
|
|
'duration': 180000,
|
|
'bitrate': 320,
|
|
}],
|
|
}],
|
|
}
|
|
|
|
|
|
# ---------------------------------------------------------------------------
|
|
# Input validation
|
|
# ---------------------------------------------------------------------------
|
|
|
|
def test_no_track_ids_returns_400():
|
|
deps = _build_deps()
|
|
payload, status = aq.enhance_artist_quality('artist-1', [], deps)
|
|
assert status == 400
|
|
assert payload == {"success": False, "error": "No track IDs provided"}
|
|
|
|
|
|
def test_artist_not_found_returns_404():
|
|
deps = _build_deps(artist_detail={'success': False})
|
|
payload, status = aq.enhance_artist_quality('artist-x', ['t1'], deps)
|
|
assert status == 404
|
|
assert payload == {"success": False, "error": "Artist not found"}
|
|
|
|
|
|
# ---------------------------------------------------------------------------
|
|
# Spotify direct lookup (priority 1)
|
|
# ---------------------------------------------------------------------------
|
|
|
|
def test_spotify_direct_lookup_via_track_id_uses_raw_data():
|
|
"""Track has spotify_track_id → get_track_details, raw_data fed to wishlist."""
|
|
raw = {'id': 'sp-stored', 'name': 'Track One', 'artists': [{'name': 'Artist Name'}],
|
|
'album': {'name': 'Album X', 'images': [{'url': 'http://i'}]}, 'duration_ms': 180000}
|
|
spotify = _FakeSpotify(track_details={'raw_data': raw})
|
|
wishlist = _FakeWishlist()
|
|
deps = _build_deps(
|
|
spotify=spotify,
|
|
artist_detail=_artist_with_track(spotify_tid='sp-stored'),
|
|
wishlist=wishlist,
|
|
)
|
|
|
|
payload, status = aq.enhance_artist_quality('artist-1', ['t1'], deps)
|
|
|
|
assert status == 200
|
|
assert payload['enhanced_count'] == 1
|
|
assert wishlist.added[0]['spotify_track_data'] == raw
|
|
|
|
|
|
def test_spotify_direct_lookup_enhanced_format_rebuilds_payload():
|
|
"""Track details without raw_data → rebuild wishlist-shape payload
|
|
from the enhanced top-level fields. Spotify enhanced shape returns
|
|
``artists`` as a list of strings; the converter normalizes to
|
|
Spotify's wishlist shape (``[{'name': ...}]``). Album images stay
|
|
empty when the source doesn't surface them on the enhanced dict —
|
|
the wishlist re-download fetches art at download time."""
|
|
enhanced = {'id': 'sp-stored', 'name': 'Track One',
|
|
'artists': ['Artist Name'],
|
|
'album': {'id': 'alb-id', 'name': 'Album X'},
|
|
'duration_ms': 180000, 'track_number': 1, 'disc_number': 1}
|
|
spotify = _FakeSpotify(track_details=enhanced)
|
|
wishlist = _FakeWishlist()
|
|
deps = _build_deps(
|
|
spotify=spotify,
|
|
artist_detail=_artist_with_track(spotify_tid='sp-stored'),
|
|
wishlist=wishlist,
|
|
)
|
|
|
|
payload, _ = aq.enhance_artist_quality('artist-1', ['t1'], deps)
|
|
|
|
assert payload['enhanced_count'] == 1
|
|
md = wishlist.added[0]['spotify_track_data']
|
|
assert md['id'] == 'sp-stored'
|
|
assert md['name'] == 'Track One'
|
|
# Enhanced format: artists normalized from [str] → [{'name': str}].
|
|
assert md['artists'] == [{'name': 'Artist Name'}]
|
|
assert md['album']['name'] == 'Album X'
|
|
assert md['album']['artists'] == [{'name': 'Artist Name'}]
|
|
|
|
|
|
# ---------------------------------------------------------------------------
|
|
# Spotify search fallback (priority 2)
|
|
# ---------------------------------------------------------------------------
|
|
|
|
def test_spotify_search_fallback_when_no_stored_id():
|
|
"""No spotify_track_id → multi-source text search runs, builds
|
|
wishlist payload from the source-native Track object via
|
|
``_build_payload_from_track`` (not ``get_track_details`` — search
|
|
results already carry enough Track-shape fields, no extra API call
|
|
needed)."""
|
|
track = _SpotifyTrack(id='sp-search', name='Track One',
|
|
artists=['Artist Name'])
|
|
track.album = 'Album X'
|
|
spotify = _FakeSpotify(search_results=[track])
|
|
wishlist = _FakeWishlist()
|
|
deps = _build_deps(
|
|
spotify=spotify,
|
|
artist_detail=_artist_with_track(spotify_tid=None),
|
|
wishlist=wishlist,
|
|
)
|
|
|
|
payload, _ = aq.enhance_artist_quality('artist-1', ['t1'], deps)
|
|
|
|
assert payload['enhanced_count'] == 1
|
|
md = wishlist.added[0]['spotify_track_data']
|
|
assert md['id'] == 'sp-search'
|
|
assert md['name'] == 'Track One'
|
|
assert md['artists'] == [{'name': 'Artist Name'}]
|
|
assert md['album']['name'] == 'Album X'
|
|
|
|
|
|
# ---------------------------------------------------------------------------
|
|
# Fallback source (iTunes/Deezer)
|
|
# ---------------------------------------------------------------------------
|
|
|
|
def test_fallback_source_when_spotify_none():
|
|
"""Spotify client None → iTunes/fallback search runs."""
|
|
fallback_track = _SpotifyTrack(id='it-1', name='Track One', artists=['Artist Name'],
|
|
image_url='http://it')
|
|
fallback_track.track_number = 1
|
|
fallback_track.disc_number = 1
|
|
fallback = type('FB', (), {
|
|
'search_tracks': lambda self, q, limit=5: [fallback_track],
|
|
})()
|
|
wishlist = _FakeWishlist()
|
|
deps = _build_deps(
|
|
spotify=None,
|
|
artist_detail=_artist_with_track(),
|
|
wishlist=wishlist,
|
|
fallback_client=fallback,
|
|
)
|
|
|
|
payload, _ = aq.enhance_artist_quality('artist-1', ['t1'], deps)
|
|
|
|
assert payload['enhanced_count'] == 1
|
|
md = wishlist.added[0]['spotify_track_data']
|
|
assert md['id'] == 'it-1'
|
|
assert md['album']['images'] == [{'url': 'http://it', 'height': 600, 'width': 600}]
|
|
|
|
|
|
def test_dispatches_through_primary_source_not_spotify_specific():
|
|
"""Architectural pin: when the user's primary metadata source is
|
|
Discogs (or any non-Spotify source), the enhance flow searches
|
|
THAT source's client, not Spotify. Pre-fix the flow had a
|
|
hardcoded Spotify-direct → Spotify-search → iTunes-fallback chain
|
|
that ignored the user's actual configured primary source.
|
|
"""
|
|
discogs_track = _SpotifyTrack(id='dc-1', name='Track One',
|
|
artists=['Artist Name'])
|
|
discogs_track.track_number = 1
|
|
discogs_track.disc_number = 1
|
|
discogs_track.album = 'Album X'
|
|
discogs_calls = []
|
|
|
|
class _DiscogsStub:
|
|
def search_tracks(self, q, limit=5):
|
|
discogs_calls.append(q)
|
|
return [discogs_track]
|
|
|
|
wishlist = _FakeWishlist()
|
|
deps = _build_deps(
|
|
spotify=None,
|
|
artist_detail=_artist_with_track(),
|
|
wishlist=wishlist,
|
|
fallback_client=_DiscogsStub(),
|
|
fallback_source='discogs',
|
|
)
|
|
|
|
payload, _ = aq.enhance_artist_quality('artist-1', ['t1'], deps)
|
|
|
|
# Discogs (the configured primary) was the one searched; match queued.
|
|
assert discogs_calls, "Primary source (Discogs) was not searched"
|
|
assert payload['enhanced_count'] == 1
|
|
assert wishlist.added[0]['spotify_track_data']['id'] == 'dc-1'
|
|
|
|
|
|
def test_spotify_direct_lookup_runs_as_fast_path_then_falls_back():
|
|
"""Architectural pin: Spotify direct-lookup is a fast-path
|
|
optimization, NOT a primary-source gate. When the user has Spotify
|
|
configured AND a stored spotify_track_id, direct lookup runs first
|
|
regardless of which other sources are wired. If it returns nothing,
|
|
the multi-source parallel search runs and the cross-source best
|
|
match wins (in this test, Discogs).
|
|
|
|
This pins the post-refactor behavior — pre-refactor direct lookup
|
|
was gated on Spotify being the active primary source, which broke
|
|
enhance for users without Spotify primary even when they had a
|
|
stored Spotify ID.
|
|
"""
|
|
spotify_calls = []
|
|
|
|
class _SpotifyStub:
|
|
def get_track_details(self, tid):
|
|
spotify_calls.append(('details', tid))
|
|
return None
|
|
def search_tracks(self, q, limit=10):
|
|
spotify_calls.append(('search', q))
|
|
return []
|
|
|
|
discogs_track = _SpotifyTrack(id='dc-1', name='Track One',
|
|
artists=['Artist Name'])
|
|
discogs_track.track_number = 1
|
|
discogs_track.disc_number = 1
|
|
discogs_track.album = 'Album X'
|
|
|
|
class _DiscogsStub:
|
|
def search_tracks(self, q, limit=10):
|
|
return [discogs_track]
|
|
|
|
wishlist = _FakeWishlist()
|
|
deps = _build_deps(
|
|
spotify=_SpotifyStub(),
|
|
artist_detail=_artist_with_track(spotify_tid='sp-stored'),
|
|
wishlist=wishlist,
|
|
fallback_client=_DiscogsStub(),
|
|
fallback_source='discogs',
|
|
)
|
|
|
|
payload, _ = aq.enhance_artist_quality('artist-1', ['t1'], deps)
|
|
|
|
# Fast path was attempted (Spotify configured + stored ID present).
|
|
assert ('details', 'sp-stored') in spotify_calls
|
|
# Fast path returned None → multi-source search ran → Discogs won.
|
|
assert payload['enhanced_count'] == 1
|
|
assert wishlist.added[0]['spotify_track_data']['id'] == 'dc-1'
|
|
|
|
|
|
# ---------------------------------------------------------------------------
|
|
# Direct-lookup-by-stored-ID (priority 1) — applies to every source
|
|
# with a stored ID column, not just Spotify
|
|
# ---------------------------------------------------------------------------
|
|
|
|
def test_direct_lookup_via_deezer_id_skips_text_search():
|
|
"""Library track has stored deezer_id + Deezer is configured →
|
|
enhance fast-paths via deezer_client.get_track_details(id) and skips
|
|
fuzzy text search entirely. Mirrors what Download Discography does
|
|
(stable IDs, no fuzzy matching). Pre-fix Deezer-primary users went
|
|
through text search even when the deezer_id was already on the row.
|
|
"""
|
|
deezer_calls = []
|
|
enhanced_dict = {
|
|
'id': '12345', 'name': 'Track One',
|
|
'artists': ['Artist Name'],
|
|
'album': {'id': 'alb-1', 'name': 'Album X'},
|
|
'duration_ms': 180000, 'track_number': 1, 'disc_number': 1,
|
|
}
|
|
|
|
class _DeezerStub:
|
|
def get_track_details(self, tid):
|
|
deezer_calls.append(('details', tid))
|
|
return enhanced_dict
|
|
def search_tracks(self, q, limit=10):
|
|
deezer_calls.append(('search', q))
|
|
return []
|
|
|
|
wishlist = _FakeWishlist()
|
|
deps = _build_deps(
|
|
spotify=None,
|
|
artist_detail=_artist_with_track(deezer_tid='12345'),
|
|
wishlist=wishlist,
|
|
fallback_client=_DeezerStub(),
|
|
fallback_source='deezer',
|
|
)
|
|
|
|
payload, _ = aq.enhance_artist_quality('artist-1', ['t1'], deps)
|
|
|
|
assert payload['enhanced_count'] == 1
|
|
# Direct-lookup ran, text search did NOT (fast path skipped it).
|
|
assert ('details', '12345') in deezer_calls
|
|
assert not any(call[0] == 'search' for call in deezer_calls)
|
|
md = wishlist.added[0]['spotify_track_data']
|
|
assert md['id'] == '12345'
|
|
assert md['artists'] == [{'name': 'Artist Name'}]
|
|
|
|
|
|
def test_direct_lookup_via_itunes_id_skips_text_search():
|
|
"""Stored itunes_track_id triggers iTunes direct lookup. Same
|
|
contract as Spotify / Deezer — get_track_details called, search
|
|
not."""
|
|
itunes_calls = []
|
|
enhanced_dict = {
|
|
'id': 'it-9001', 'name': 'Track One',
|
|
'artists': ['Artist Name'],
|
|
'album': {'id': 'alb-it', 'name': 'Album X'},
|
|
'duration_ms': 180000,
|
|
}
|
|
|
|
class _ItunesStub:
|
|
def get_track_details(self, tid):
|
|
itunes_calls.append(('details', tid))
|
|
return enhanced_dict
|
|
def search_tracks(self, q, limit=10):
|
|
itunes_calls.append(('search', q))
|
|
return []
|
|
|
|
wishlist = _FakeWishlist()
|
|
deps = _build_deps(
|
|
spotify=None,
|
|
artist_detail=_artist_with_track(itunes_tid='it-9001'),
|
|
wishlist=wishlist,
|
|
fallback_client=_ItunesStub(),
|
|
fallback_source='itunes',
|
|
)
|
|
|
|
payload, _ = aq.enhance_artist_quality('artist-1', ['t1'], deps)
|
|
|
|
assert payload['enhanced_count'] == 1
|
|
assert ('details', 'it-9001') in itunes_calls
|
|
assert not any(call[0] == 'search' for call in itunes_calls)
|
|
|
|
|
|
def test_direct_lookup_prefers_user_primary_source():
|
|
"""Track has stored IDs on multiple sources; user's configured
|
|
primary source is tried first. Pin: a Deezer-primary user with
|
|
both spotify_track_id and deezer_id stored gets the Deezer payload
|
|
(correct cover art / album shape for their setup), not whichever
|
|
source happened to come first in registry order.
|
|
"""
|
|
spotify_calls = []
|
|
deezer_calls = []
|
|
|
|
spotify_enhanced = {
|
|
'id': 'sp-1', 'name': 'Track One',
|
|
'artists': ['Artist Name'],
|
|
'album': {'id': 'sp-alb', 'name': 'Album X'},
|
|
}
|
|
deezer_enhanced = {
|
|
'id': 'dz-1', 'name': 'Track One',
|
|
'artists': ['Artist Name'],
|
|
'album': {'id': 'dz-alb', 'name': 'Album X'},
|
|
}
|
|
|
|
class _SpotifyStub:
|
|
def get_track_details(self, tid):
|
|
spotify_calls.append(tid)
|
|
return spotify_enhanced
|
|
|
|
class _DeezerStub:
|
|
def get_track_details(self, tid):
|
|
deezer_calls.append(tid)
|
|
return deezer_enhanced
|
|
|
|
# Patch get_primary_source to return 'deezer' so we don't depend
|
|
# on the test-runner's actual config.
|
|
import core.metadata.registry as registry_mod
|
|
original = registry_mod.get_primary_source
|
|
registry_mod.get_primary_source = lambda **kw: 'deezer'
|
|
try:
|
|
wishlist = _FakeWishlist()
|
|
deps = _build_deps(
|
|
spotify=_SpotifyStub(),
|
|
artist_detail=_artist_with_track(
|
|
spotify_tid='sp-stored', deezer_tid='dz-stored',
|
|
),
|
|
wishlist=wishlist,
|
|
fallback_client=_DeezerStub(),
|
|
fallback_source='deezer',
|
|
)
|
|
payload, _ = aq.enhance_artist_quality('artist-1', ['t1'], deps)
|
|
finally:
|
|
registry_mod.get_primary_source = original
|
|
|
|
assert payload['enhanced_count'] == 1
|
|
# Deezer (primary) tried first and won — Spotify never queried.
|
|
assert deezer_calls == ['dz-stored']
|
|
assert spotify_calls == []
|
|
md = wishlist.added[0]['spotify_track_data']
|
|
assert md['id'] == 'dz-1'
|
|
|
|
|
|
def test_direct_lookup_falls_through_to_text_search_when_no_stored_ids():
|
|
"""Track has ZERO stored source IDs → direct lookup yields nothing
|
|
→ falls through to multi-source text search. Pin the contract:
|
|
direct-lookup is best-effort, not required."""
|
|
text_search_track = _SpotifyTrack(id='dz-search', name='Track One',
|
|
artists=['Artist Name'])
|
|
text_search_track.album = 'Album X'
|
|
|
|
class _DeezerStub:
|
|
def get_track_details(self, tid):
|
|
raise AssertionError("should not be called — no stored ID")
|
|
def search_tracks(self, q, limit=10):
|
|
return [text_search_track]
|
|
|
|
wishlist = _FakeWishlist()
|
|
deps = _build_deps(
|
|
spotify=None,
|
|
artist_detail=_artist_with_track(), # no stored IDs
|
|
wishlist=wishlist,
|
|
fallback_client=_DeezerStub(),
|
|
fallback_source='deezer',
|
|
)
|
|
payload, _ = aq.enhance_artist_quality('artist-1', ['t1'], deps)
|
|
assert payload['enhanced_count'] == 1
|
|
assert wishlist.added[0]['spotify_track_data']['id'] == 'dz-search'
|
|
|
|
|
|
def test_direct_lookup_failure_falls_through_to_text_search():
|
|
"""Stored ID exists but direct lookup returns None (network blip,
|
|
catalog removal, etc.) → flow falls through to text search rather
|
|
than hard-failing. Pin: direct-lookup miss is non-fatal."""
|
|
text_search_track = _SpotifyTrack(id='dz-search', name='Track One',
|
|
artists=['Artist Name'])
|
|
text_search_track.album = 'Album X'
|
|
|
|
class _DeezerStub:
|
|
def get_track_details(self, tid):
|
|
return None # direct lookup miss
|
|
def search_tracks(self, q, limit=10):
|
|
return [text_search_track]
|
|
|
|
wishlist = _FakeWishlist()
|
|
deps = _build_deps(
|
|
spotify=None,
|
|
artist_detail=_artist_with_track(deezer_tid='9999'),
|
|
wishlist=wishlist,
|
|
fallback_client=_DeezerStub(),
|
|
fallback_source='deezer',
|
|
)
|
|
payload, _ = aq.enhance_artist_quality('artist-1', ['t1'], deps)
|
|
assert payload['enhanced_count'] == 1
|
|
# Text-search winner used.
|
|
assert wishlist.added[0]['spotify_track_data']['id'] == 'dz-search'
|
|
|
|
|
|
# ---------------------------------------------------------------------------
|
|
# Failure modes
|
|
# ---------------------------------------------------------------------------
|
|
|
|
def test_track_not_in_artist_detail_marked_failed():
|
|
"""Track ID provided but missing from artist's albums → failed_tracks entry."""
|
|
deps = _build_deps(artist_detail=_artist_with_track(track_id='t1'))
|
|
payload, _ = aq.enhance_artist_quality('artist-1', ['t99'], deps)
|
|
|
|
assert payload['enhanced_count'] == 0
|
|
assert payload['failed_count'] == 1
|
|
assert payload['failed_tracks'][0]['reason'] == 'Track not found'
|
|
|
|
|
|
def test_track_with_no_file_path_marked_failed():
|
|
"""Track has no file_path → failed reason 'No file path'."""
|
|
detail = _artist_with_track()
|
|
detail['albums'][0]['tracks'][0]['file_path'] = None
|
|
deps = _build_deps(artist_detail=detail)
|
|
payload, _ = aq.enhance_artist_quality('artist-1', ['t1'], deps)
|
|
|
|
assert payload['failed_count'] == 1
|
|
assert payload['failed_tracks'][0]['reason'] == 'No file path'
|
|
|
|
|
|
def test_no_match_anywhere_marked_failed():
|
|
"""No source returns a usable match → failed reason lists the
|
|
sources that were searched so user knows what was tried."""
|
|
spotify = _FakeSpotify(track_details=None, search_results=[])
|
|
deps = _build_deps(
|
|
spotify=spotify,
|
|
artist_detail=_artist_with_track(),
|
|
)
|
|
|
|
payload, _ = aq.enhance_artist_quality('artist-1', ['t1'], deps)
|
|
|
|
assert payload['failed_count'] == 1
|
|
reason = payload['failed_tracks'][0]['reason']
|
|
assert 'No usable match across' in reason
|
|
assert 'spotify' in reason
|
|
assert 'try connecting an additional metadata source' in reason
|
|
|
|
|
|
def test_no_match_without_spotify_lists_searched_sources():
|
|
"""When Spotify isn't connected and the configured sources find
|
|
nothing, the failure reason lists every searched source. Discord
|
|
case: user with no Spotify / Deezer saw enhance silently produce
|
|
'unknown artist - unknown album - unknown track' wishlist entries
|
|
instead of a clear failure."""
|
|
fallback = type('FB', (), {
|
|
'search_tracks': lambda self, q, limit=5: [],
|
|
})()
|
|
deps = _build_deps(
|
|
spotify=None,
|
|
artist_detail=_artist_with_track(),
|
|
fallback_client=fallback,
|
|
fallback_source='itunes',
|
|
)
|
|
|
|
payload, _ = aq.enhance_artist_quality('artist-1', ['t1'], deps)
|
|
assert payload['failed_count'] == 1
|
|
reason = payload['failed_tracks'][0]['reason']
|
|
assert 'No usable match across' in reason
|
|
assert 'itunes' in reason
|
|
|
|
|
|
def test_no_match_with_no_sources_configured_prompts_setup():
|
|
"""User with literally zero metadata sources configured gets a
|
|
clear prompt to connect one — instead of a generic 'no match'."""
|
|
deps = _build_deps(
|
|
spotify=None,
|
|
artist_detail=_artist_with_track(),
|
|
search_sources=[],
|
|
)
|
|
|
|
payload, _ = aq.enhance_artist_quality('artist-1', ['t1'], deps)
|
|
assert payload['failed_count'] == 1
|
|
reason = payload['failed_tracks'][0]['reason']
|
|
assert 'No metadata source configured' in reason
|
|
|
|
|
|
def test_fallback_match_with_empty_artist_rejected():
|
|
"""Per the user-reported bug: an iTunes match that clears the 0.7
|
|
confidence threshold but has empty/missing artists is rejected
|
|
instead of producing a wishlist entry with empty artist field
|
|
(which the wishlist payload normalizer happily accepts and the
|
|
UI then displays as 'unknown artist')."""
|
|
fallback_track = _SpotifyTrack(id='it-empty', name='Track One',
|
|
artists=[], # empty artists list
|
|
image_url='')
|
|
fallback_track.track_number = 1
|
|
fallback_track.disc_number = 1
|
|
fallback_track.album = 'Album X'
|
|
fallback = type('FB', (), {
|
|
'search_tracks': lambda self, q, limit=5: [fallback_track],
|
|
})()
|
|
wishlist = _FakeWishlist()
|
|
deps = _build_deps(
|
|
spotify=None,
|
|
artist_detail=_artist_with_track(),
|
|
wishlist=wishlist,
|
|
fallback_client=fallback,
|
|
)
|
|
|
|
payload, _ = aq.enhance_artist_quality('artist-1', ['t1'], deps)
|
|
|
|
# No wishlist entry with empty fields — match was rejected.
|
|
assert payload['enhanced_count'] == 0
|
|
assert payload['failed_count'] == 1
|
|
assert wishlist.added == []
|
|
|
|
|
|
def test_fallback_match_with_empty_album_rejected():
|
|
"""Empty album field on iTunes match → reject (was producing
|
|
'unknown album' wishlist entries)."""
|
|
fallback_track = _SpotifyTrack(id='it-no-album', name='Track One',
|
|
artists=['Artist Name'])
|
|
fallback_track.track_number = 1
|
|
fallback_track.disc_number = 1
|
|
fallback_track.album = '' # empty
|
|
fallback = type('FB', (), {
|
|
'search_tracks': lambda self, q, limit=5: [fallback_track],
|
|
})()
|
|
wishlist = _FakeWishlist()
|
|
deps = _build_deps(
|
|
spotify=None,
|
|
artist_detail=_artist_with_track(),
|
|
wishlist=wishlist,
|
|
fallback_client=fallback,
|
|
)
|
|
|
|
payload, _ = aq.enhance_artist_quality('artist-1', ['t1'], deps)
|
|
assert payload['enhanced_count'] == 0
|
|
assert payload['failed_count'] == 1
|
|
assert wishlist.added == []
|
|
|
|
|
|
def test_fallback_match_with_empty_name_rejected():
|
|
"""Empty title on iTunes match → reject."""
|
|
fallback_track = _SpotifyTrack(id='it-no-name', name='',
|
|
artists=['Artist Name'])
|
|
fallback_track.track_number = 1
|
|
fallback_track.disc_number = 1
|
|
fallback_track.album = 'Album X'
|
|
fallback = type('FB', (), {
|
|
'search_tracks': lambda self, q, limit=5: [fallback_track],
|
|
})()
|
|
wishlist = _FakeWishlist()
|
|
deps = _build_deps(
|
|
spotify=None,
|
|
artist_detail=_artist_with_track(),
|
|
wishlist=wishlist,
|
|
fallback_client=fallback,
|
|
)
|
|
|
|
payload, _ = aq.enhance_artist_quality('artist-1', ['t1'], deps)
|
|
assert payload['enhanced_count'] == 0
|
|
assert payload['failed_count'] == 1
|
|
assert wishlist.added == []
|
|
|
|
|
|
# ---------------------------------------------------------------------------
|
|
# Wishlist source_context payload
|
|
# ---------------------------------------------------------------------------
|
|
|
|
def test_wishlist_source_context_carries_quality_metadata():
|
|
"""source_context includes original_file_path, format tier, bitrate, artist_name."""
|
|
raw = {'id': 'sp-1', 'name': 'Track One', 'artists': [{'name': 'Artist Name'}],
|
|
'album': {'name': 'Album X'}}
|
|
spotify = _FakeSpotify(track_details={'raw_data': raw})
|
|
wishlist = _FakeWishlist()
|
|
deps = _build_deps(
|
|
spotify=spotify,
|
|
artist_detail=_artist_with_track(spotify_tid='sp-1'),
|
|
wishlist=wishlist,
|
|
quality_tier=('mp3_192', 4),
|
|
)
|
|
|
|
aq.enhance_artist_quality('artist-1', ['t1'], deps)
|
|
|
|
ctx = wishlist.added[0]['source_context']
|
|
assert ctx['enhance'] is True
|
|
assert ctx['original_file_path'] == '/file.mp3'
|
|
assert ctx['original_format'] == 'mp3_192'
|
|
assert ctx['original_bitrate'] == 320
|
|
assert ctx['original_tier'] == 4
|
|
assert ctx['artist_name'] == 'Artist Name'
|
|
assert wishlist.added[0]['source_type'] == 'enhance'
|