shindan-maker 0.1.23

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

ShindanMaker

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

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)

#[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