genebears 0.3.0

Lightweight Rust client for the GeneBe genetic variant annotation API with DuckDB caching and rate limiting
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

use thiserror::Error;

#[derive(Debug, Error)]
pub enum GeneBearError {
    /// HTTP / network errors from reqwest.
    #[error("HTTP error: {0}")]
    Http(#[from] reqwest::Error),
    /// JSON serialization / deserialization errors.
    #[error("JSON error: {0}")]
    Json(#[from] serde_json::Error),
    /// DuckDB cache errors.
    #[error("Cache error: {0}")]
    Cache(#[from] duckdb::Error),
    /// The GeneBe API rejected the request (4xx) — likely bad input.
    #[error("API client error (HTTP {status}): {message}")]
    ApiClientError { status: u16, message: String },
    /// The GeneBe API failed to process the request (5xx) — e.g. unknown contig.
    #[error("API server error (HTTP {status}): {message}")]
    ApiServerError { status: u16, message: String },
    /// Requested batch exceeds the API limit of 1 000 variants.
    #[error("Batch too large: {requested} variants requested, maximum is 1 000")]
    BatchTooLarge { requested: usize },
    /// Catch-all for miscellaneous errors.
    #[error("{0}")]
    Other(String),
}