test: add basic tests for cache-search & network fetchers

test: enable debug
test: add pytest.ini to mark tests that require network
fix: cache-search should not aquire full match of artists due to different translations
fix: replace dynamic f-string SQL in track WHERE clauses with parameterized nullable conditions
refactor: lrc.py should never directly call print, return a str instead
chore: add requirements.txt (via 'uv export')
chore: update README.md with dev instructions

tests/conftest.py

@@ -0,0 +1,3 @@
+from lrx_cli.config import enable_debug
+
+enable_debug()

tests/test_cache.py

@@ -289,7 +289,6 @@ def test_search_by_meta_fuzzy_rules_and_duration_sorting(cache_db: CacheEngine)
     )
 
     rows = cache_db.search_by_meta(
-        artist="Ｂ ; A",
         title="  hello world  ",
         length=200000,
     )

tests/test_fetchers.py

@@ -0,0 +1,116 @@
+from pathlib import Path
+import pytest
+from dataclasses import replace
+
+from lrx_cli.fetchers import FetcherMethodType
+from lrx_cli.models import TrackMeta
+from lrx_cli.core import LrcManager
+
+SAMPLE_SPOTIFY_TRACK: TrackMeta = TrackMeta(
+    title="One Last Kiss",
+    artist="Hikaru Utada",
+    album="One Last Kiss",
+    length=252026,
+    trackid="5RhWszHMSKzb7KiXk4Ae0M",
+    url="https://open.spotify.com/track/5RhWszHMSKzb7KiXk4Ae0M",
+)
+
+SAMPLE_SPOTIFY_TRACK_ALBUM_MODIFIED = replace(SAMPLE_SPOTIFY_TRACK, album="BADモード")
+
+SAMPLE_SPOTIFY_TRACK_ARTIST_MODIFIED = replace(
+    SAMPLE_SPOTIFY_TRACK, artist="宇多田ヒカル"
+)
+
+SAMPLE_SPOTIFY_TRACK_ALBUM_ARTIST_MODIFIED = replace(
+    SAMPLE_SPOTIFY_TRACK, artist="宇多田ヒカル", album="BADモード"
+)
+
+
+@pytest.fixture
+def lrc_manager(tmp_path: Path) -> LrcManager:
+    return LrcManager(str(tmp_path / "cache.db"))
+
+
+def _fetch_and_assert(
+    lrc_manager: LrcManager, method: FetcherMethodType, expect_fail: bool = False
+) -> None:
+    result = lrc_manager.fetch_for_track(SAMPLE_SPOTIFY_TRACK, force_method=method)
+    if expect_fail:
+        assert result is None
+    else:
+        assert result is not None
+        assert result.lyrics is not None
+
+
+def test_cache_search_fetcher_without_cache(lrc_manager: LrcManager):
+    _fetch_and_assert(lrc_manager, "cache-search", expect_fail=True)
+
+
+@pytest.mark.parametrize(
+    "query_track",
+    [
+        pytest.param(SAMPLE_SPOTIFY_TRACK, id="exact_match"),
+        pytest.param(SAMPLE_SPOTIFY_TRACK_ARTIST_MODIFIED, id="artist_modified"),
+        pytest.param(SAMPLE_SPOTIFY_TRACK_ALBUM_MODIFIED, id="album_modified"),
+        pytest.param(
+            SAMPLE_SPOTIFY_TRACK_ALBUM_ARTIST_MODIFIED, id="album_artist_modified"
+        ),
+    ],
+)
+def test_cache_search_fetcher_with_fuzzy_metadata(
+    lrc_manager: LrcManager, query_track: TrackMeta
+):
+    expected_lrc = "[00:00.01]lyrics"
+    lrc_manager.manual_insert(SAMPLE_SPOTIFY_TRACK, expected_lrc)
+
+    result = lrc_manager.fetch_for_track(query_track, force_method="cache-search")
+
+    assert result is not None
+    assert result.lyrics is not None
+    assert result.lyrics.to_lrc() == expected_lrc
+
+
+def test_cache_search_fetcher_prefer_better_match(lrc_manager: LrcManager):
+    lrc_manager.manual_insert(
+        SAMPLE_SPOTIFY_TRACK_ARTIST_MODIFIED, "[00:00.01]artist modified"
+    )
+    lrc_manager.manual_insert(
+        SAMPLE_SPOTIFY_TRACK_ALBUM_ARTIST_MODIFIED, "[00:00.01]artist+album modified"
+    )
+
+    result = lrc_manager.fetch_for_track(
+        SAMPLE_SPOTIFY_TRACK, force_method="cache-search"
+    )
+
+    assert result is not None
+    assert result.lyrics is not None
+    assert result.lyrics.to_lrc() == "[00:00.01]artist modified"
+
+
+@pytest.mark.network
+@pytest.mark.parametrize(
+    "method, expect_fail",
+    [
+        ("spotify", False),
+        ("lrclib", False),
+        ("lrclib-search", False),
+        ("musixmatch", False),
+        ("musixmatch-spotify", False),
+        ("netease", False),
+        ("qqmusic", False),
+    ],
+)
+def test_remote_fetchers(
+    lrc_manager: LrcManager, method: FetcherMethodType, expect_fail: bool
+):
+    _fetch_and_assert(lrc_manager, method, expect_fail)
+
+
+@pytest.mark.parametrize(
+    "method, expect_fail",
+    [("local", True)],
+)
+def test_local_fetcher(
+    lrc_manager: LrcManager, method: FetcherMethodType, expect_fail: bool
+):
+    _fetch_and_assert(lrc_manager, method, expect_fail)