lyrics-search 0.3.1

Lyrics search functionality for various platforms
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106

use async_trait::async_trait;

use super::Searchers;
use super::search_result::SearchResult;
use super::searcher::Searcher;
use crate::error::SearchError;
use crate::providers::web::lrclib::api;
use lyrics_core::models::TrackMetadata;

/// LRCLIB 歌词搜索器。
pub struct LRCLIBSearcher;

#[async_trait]
impl Searcher for LRCLIBSearcher {
    fn name(&self) -> &str {
        "LRCLIB"
    }

    fn display_name(&self) -> &str {
        "LRCLIB"
    }

    fn searcher_type(&self) -> Searchers {
        Searchers::LRCLIB
    }

    async fn search_for_results_str(
        &self,
        search_string: &str,
    ) -> Result<Vec<SearchResult>, SearchError> {
        let results = api::search(search_string, None, None, None).await?;
        Ok(map_results(results))
    }

    /// 依次尝试精确获取、带过滤的搜索、不带过滤的搜索。
    ///
    /// 缺少曲名时无法构造任何查询，此时属于「没有结果」而非失败，返回 `Ok(vec![])`。
    async fn search_for_results(
        &self,
        track: &TrackMetadata,
    ) -> Result<Vec<SearchResult>, SearchError> {
        let Some(title) = track.title.as_deref() else {
            return Ok(Vec::new());
        };
        let artist = track.artist.as_deref().unwrap_or("");
        let album = track.album.as_deref();
        let duration = track.duration_ms.map(|ms| ms as f64 / 1000.0);

        if let Some(result) = api::get(title, artist, album, duration).await? {
            let item = super::search_result::SearchResult {
                searcher_type: Searchers::LRCLIB,
                title: result.track_name,
                artists: parse_artists(&result.artist_name),
                album: result.album_name,
                album_artists: None,
                duration_ms: Some((result.duration * 1000.0) as i32),
                match_type: None,
                id: result.id.to_string(),
                numeric_id: None,
            };
            return Ok(vec![item]);
        }

        let results = api::search(title, Some(artist), album, duration).await?;
        if !results.is_empty() {
            return Ok(map_results(results));
        }

        let search_string = format!("{} {}", title, artist)
            .replace(" - ", " ")
            .trim()
            .to_string();
        let results = api::search(&search_string, None, None, None).await?;
        Ok(map_results(results))
    }
}

fn parse_artists(artist_str: &str) -> Vec<String> {
    artist_str
        .split(", ")
        .flat_map(|s| s.split(" & "))
        .flat_map(|s| s.split(" feat. "))
        .flat_map(|s| s.split(" ft. "))
        .map(|s| s.trim().to_string())
        .filter(|s| !s.is_empty())
        .collect()
}

fn map_results(
    results: Vec<super::super::providers::web::lrclib::response::SearchResultItem>,
) -> Vec<SearchResult> {
    results
        .into_iter()
        .map(|item| SearchResult {
            searcher_type: Searchers::LRCLIB,
            title: item.track_name,
            artists: parse_artists(&item.artist_name),
            album: item.album_name,
            album_artists: None,
            duration_ms: Some((item.duration * 1000.0) as i32),
            match_type: None,
            id: item.id.to_string(),
            numeric_id: None,
        })
        .collect()
}