dlsite 0.2.0

DLsite client
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

pub mod interface;
#[cfg(test)]
mod test;

use crate::{DlsiteClient, DlsiteError, Result};

use self::interface::ProductApiContent;

impl DlsiteClient {
    /// Get product detail using api.
    ///
    /// # Arguments
    /// * `id` - Product ID.
    ///
    /// # Returns
    /// * `ProductApiContent` - Product details.
    ///
    /// # Note
    /// This api does not return dl count.
    /// And because of confusing specification of api, serde::Value is used in some place.
    /// Instead of this you also can use `DlsiteClient.get_product` which scrapes html.
    ///
    /// # Example
    /// ```
    /// use dlsite::{DlsiteClient, product::Product};
    /// use tokio;
    /// #[tokio::main]
    /// async fn main() {
    ///     let client = DlsiteClient::default();
    ///     let product = client.get_product_api("RJ01014447").await.unwrap();
    ///     assert_eq!(product.creators.unwrap().voice_by.unwrap()[0].name, "佐倉綾音");
    /// }
    /// ```
    pub async fn get_product_api(&self, id: &str) -> Result<ProductApiContent> {
        let json = self
            .get(&format!("/api/=/product.json?workno={}", id))
            .await?;
        let jd = &mut serde_json::Deserializer::from_str(&json);
        #[cfg(feature = "unknown-field-log")]
        let result: std::result::Result<Vec<ProductApiContent>, _> = serde_ignored::deserialize(
            jd,
            |path| {
                tracing::error!("Ignored path: '{}' for '{id}'. Please report this to https://github.com/ozonezone/dlsite-rs", path.to_string());
            },
        );
        #[cfg(not(feature = "unknown-field-log"))]
        let result: std::result::Result<Vec<ProductApiContent>, _> =
            serde_path_to_error::deserialize(jd);
        match result {
            Ok(result) => {
                let Some(json) = result.into_iter().next() else {
                    return Err(DlsiteError::ParseError("No product found".to_string()));
                };

                Ok(json)
            }
            Err(e) => Err(DlsiteError::ParseError(format!(
                "Failed to parse json: {}",
                e
            ))),
        }
    }
}