vn

Crates.iovn
lib.rsvn
version0.5.0
created_at2024-11-27 20:51:41.799938+00
updated_at2025-08-12 22:44:12.539529+00
descriptionVNDB for Rust
homepagehttps://github.com/ferreira-tb/vn
repositoryhttps://github.com/ferreira-tb/vn
max_upload_size
id1463610
size152,264
Andrew Ferreira (ferreira-tb)

documentation

README

vn

[dependencies]
vn = 0.4

Usage

Create a new VNDB client:

use vn::Vndb;
use std::time::Duration;

let vndb = Vndb::builder()
  .max_concurrent_requests(5)
  .timeout(Duration::from_secs(10))
  .token("abcd-efghi-jklmn-opqrs-tuvx-z1234-5678")
  .user_agent("some-user-agent/v5.0")
  .build();

Find a visual novel by its id:

use vn::{Vndb, VisualNovelField};

let vndb = Vndb::new();
let results = vndb
  .find_visual_novel(1194)
  .fields(VisualNovelField::Title)
  .send()
  .await
  .unwrap()
  .results;

let visual_novel = results.first().unwrap();
let title = visual_novel.title.as_deref().unwrap();
assert_eq!(title, "Yosuga no Sora");

Search characters by their name:

use vn::{Vndb, CharacterField, SortCharacterBy};

let vndb = Vndb::new();
let results = vndb
  .search_character("Minazuki Shigure")
  .fields([CharacterField::Name, CharacterField::Original])
  .results(10)
  .sort(SortCharacterBy::Name)
  .send()
  .await
  .unwrap()
  .results;

let character = results.first().unwrap();
let name = character.name.as_deref().unwrap();
let original = character.original.as_deref().unwrap();

assert_eq!(name, "Minazuki Shigure");
assert_eq!(original, "水無月 時雨");
Commit count: 28

cargo fmt