psyche-subtitle-toolkit 0.3.1

Extract, translate, and mux ASS/SRT/VTT/PGS subtitles in MKV files via pluggable translation providers
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
64
65
66
67
68
69
70
71
72

use std::io;
use std::path::PathBuf;

/// Errors produced by the subtitle toolkit.
#[derive(Debug, thiserror::Error)]
pub enum SubtitleToolkitError {
    /// Standard I/O error.
    #[error("I/O error: {0}")]
    Io(#[from] io::Error),

    /// HTTP request error (Ollama API).
    #[error("HTTP error: {0}")]
    Http(#[from] reqwest::Error),

    /// JSON serialization/deserialization error.
    #[error("JSON error: {0}")]
    Json(#[from] serde_json::Error),

    /// Required external tool (e.g. `mkvmerge`, `mkvextract`) not found in PATH.
    #[error("required tool `{tool}` was not found in PATH")]
    MissingTool { tool: &'static str },

    /// External command returned a nonzero exit status.
    #[error("command `{program}` failed with status {status}: {stderr}")]
    CommandFailed {
        program: &'static str,
        status: String,
        stderr: String,
    },

    /// No `.mkv` files found at the given path.
    #[error("no MKV files found at {path}")]
    NoMkvFiles { path: PathBuf },

    /// No ASS/SSA subtitle track found in the MKV.
    #[error("no ASS subtitle track found in {path}")]
    NoAssTrack { path: PathBuf },

    /// No supported subtitle track (ASS or SRT) found in the MKV.
    #[error("no supported subtitle track found in {path}")]
    NoSubtitleTrack { path: PathBuf },

    /// Malformed ASS subtitle file.
    #[error("ASS parse error: {message}")]
    AssParse { message: String },

    /// Malformed SRT subtitle file.
    #[error("SRT parse error: {message}")]
    SrtParse { message: String },

    /// Malformed WebVTT subtitle file.
    #[error("WebVTT parse error: {message}")]
    VttParse { message: String },

    /// LLM returned invalid numbered text (missing IDs, duplicates, etc.).
    #[error("translation response is invalid: {message}")]
    InvalidTranslation { message: String },

    /// Translation provider returned an error.
    #[error("{provider} error: {message}")]
    Translation {
        provider: &'static str,
        message: String,
    },

    /// OCR processing error.
    #[error("OCR error: {message}")]
    Ocr { message: String },
}

/// Convenience alias for `Result<T, SubtitleToolkitError>`.
pub type Result<T> = std::result::Result<T, SubtitleToolkitError>;