bpi-rs 0.2.0

Bilibili API client library for Rust
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

use serde::{Deserialize, Serialize};

#[cfg(test)]
use super::params::VideoRankingListParams;

// --- 获取分区视频排行榜列表 ---

/// 排行榜列表中的单个视频
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct RankingVideoItem {
    // 文档未提供具体字段，通常与视频详细信息相似
    // 这里用 serde_json::Value 代替
    #[serde(flatten)]
    pub inner: serde_json::Value,
}

/// 排行榜列表数据
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct RankingListData {
    /// 备注信息
    pub note: String,
    /// 视频列表
    pub list: Vec<RankingVideoItem>,
}

#[cfg(test)]
mod tests {
    use super::super::params::VideoRankingType;
    use super::*;
    use crate::BpiClient;
    use tracing::info;

    #[ignore = "legacy live API test; requires explicit BPI_LIVE_TEST review"]
    #[tokio::test]
    async fn test_video_ranking_list() {
        let bpi = BpiClient::new().expect("client should build");
        // 获取全站排行榜
        let resp = bpi
            .video_ranking()
            .ranking_list(VideoRankingListParams::new())
            .await;

        info!("{:?}", resp);
        assert!(resp.is_ok());

        let data = resp.unwrap();
        info!("note: {}", data.note);
        info!("排行榜视频数: {}", data.list.len());
        if let Some(first_item) = data.list.first() {
            info!(
                "first item: {}",
                serde_json::to_string_pretty(&first_item).unwrap()
            );
        }
    }

    #[ignore = "legacy live API test; requires explicit BPI_LIVE_TEST review"]
    #[tokio::test]
    async fn test_video_ranking_list_with_rid() {
        let bpi = BpiClient::new().expect("client should build");
        // 获取日常分区排行榜 (rid=21)
        let params = VideoRankingListParams::new()
            .with_rid(21)
            .expect("rid is valid");
        let resp = bpi.video_ranking().ranking_list(params).await;

        info!("{:?}", resp);
        assert!(resp.is_ok());

        let data = resp.unwrap();
        info!("note: {}", data.note);
        info!("排行榜视频数: {}", data.list.len());
    }

    #[ignore = "legacy live API test; requires explicit BPI_LIVE_TEST review"]
    #[tokio::test]
    async fn test_video_ranking_list_with_type() {
        let bpi = BpiClient::new().expect("client should build");
        // 获取新人排行榜
        let params = VideoRankingListParams::new().with_type(VideoRankingType::Rookie);
        let resp = bpi.video_ranking().ranking_list(params).await;

        info!("{:?}", resp);
        assert!(resp.is_ok());

        let data = resp.unwrap();
        info!("note: {}", data.note);
        info!("排行榜视频数: {}", data.list.len());
    }
}