Crate zantetsu 

Zantetsu

Ultra-fast library for anime metadata extraction and normalization.

Crates:

• zantetsu - unified API surface
• zantetsu-core - parsing engine
• zantetsu-vecdb - canonical title matching

Features

• Heuristic Parsing: Regex-based parsing for fast, reliable extraction (92.38% accuracy)
• Canonical Matching: Local Kitsu dump matching or remote endpoint lookup
• Quality Scoring: Configurable quality profiles for release validation

Quick Start

use zantetsu::{EpisodeSpec, Zantetsu};

let engine = Zantetsu::new()?;
let result = engine.parse("[SubsPlease] Cowboy Bebop - 01 [1080p][HEVC].mkv")?;

assert_eq!(result.title.as_deref(), Some("Cowboy Bebop"));
assert_eq!(result.group.as_deref(), Some("SubsPlease"));
assert_eq!(result.episode, Some(EpisodeSpec::Single(1)));
assert!(result.resolution.is_some());

Structs

AnimeIds

External and internal identifiers for a matched anime.

AnimeTitleMatch

The best-scoring match for a query title.

HeuristicParser

Heuristic parser using optimized regex patterns and scene naming rules.

ParseResult

The primary output of the Zantetsu parsing engine.

QualityProfile

Quality profile defining the relative importance of each dimension.

QualityScores

Scores for individual quality dimensions of a parsed file.

TitleMatcher

Canonical title matcher backed by either a local Kitsu dump or a remote GraphQL endpoint.

Zantetsu

Main entry point for the Zantetsu parsing engine.

Enums

AudioCodec

Audio codec enum with quality scoring.

EpisodeSpec

Episode specification supporting complex numbering schemes found in anime torrent/file names.

MatchProvider

Which backend produced a canonical title match.

MatchSource

Backend choice for canonical title matching.

MatcherError

Errors returned by title matching backends.

MediaSource

Media source enum with quality scoring.

ParseMode

Parse mode selector.

Resolution

Video resolution enum with quality scoring.

VideoCodec

Video codec enum with quality scoring.

ZantetsuError

Errors that can occur during Zantetsu core operations.

Functions

default_kitsu_dump_dir

Returns the default dump directory used by kitsu-sync.

Type Aliases

MatchResult

Result type alias for title matching.

Result

Result type alias for Zantetsu operations.