shindan-maker

A Rust library for interacting with ShindanMaker, the popular personality quiz service.

• Asynchronous API (Tokio)
• Multi-domain support (JP, EN, CN, KR, TH)
• Easy shindan submission and result parsing
• Currently only supports single-name diagnosis

Usage

[dependencies]
# default feature:   ["segments"]
# optional features: ["html"], ["full"] (segments + html)
shindan-maker = { version = "0.1", features = ["segments"] }

Example

Get title

use anyhow::Result;
use shindan_maker::{ShindanClient, ShindanDomain};

#[tokio::main]
async fn main() -> Result<()> {
    let client = ShindanClient::new(ShindanDomain::En)?;               // Enum variant
    // let client = ShindanClient::new("Jp".parse()?)?;                 // String slice
    // let client = ShindanClient::new("EN".parse()?)?;                 // Case-insensitive
    // let client = ShindanClient::new(String::from("cn").parse()?)?;   // String

    let title = client
        .get_title("1222992")
        .await?;

    assert_eq!("Fantasy Stats", title);
    Ok(())
}

Get segments (need "segments" feature)

use shindan_maker::{ShindanClient, ShindanDomain};

#[tokio::main]
async fn main() {
    let client = ShindanClient::new(ShindanDomain::En).unwrap();

    let (segments, title) = client
        .get_segments_with_title("1222992", "test_user")
        .await
        .unwrap();

    assert_eq!("Fantasy Stats", title);

    println!("Result title: {}", title);
    println!("Result text: {}", segments);
    println!("Result segments: {:#?}", segments);
}

Get HTML string (need "html" feature)

To convert the HTML string to an image, consider using cdp-html-shot.

#[tokio::main]
async fn main() {
    #[cfg(feature = "html")]
    {
        use shindan_maker::{ShindanClient, ShindanDomain};

        let client = ShindanClient::new(ShindanDomain::En).unwrap();

        let (_html_str, title) = client
            .get_html_str_with_title("1222992", "test_user")
            .await
            .unwrap();

        assert_eq!("Fantasy Stats", title);
    }
}

License