cryptologo 0.1.2

Rust client for crypto-logo.com — 413 cryptocurrency logos in SVG, PNG, WebP, ICO
Documentation 
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
73
74

use serde::{Deserialize, Serialize};
use std::fmt;

/// A cryptocurrency coin with logo availability metadata.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Coin {
    /// Display name (e.g., "Bitcoin")
    pub name: String,
    /// Trading symbol (e.g., "BTC")
    pub ticker: String,
    /// URL-safe identifier (e.g., "bitcoin-btc")
    pub slug: String,
    /// Whether a PNG logo is available
    pub has_png: bool,
    /// Whether an SVG logo is available
    pub has_svg: bool,
    /// Localized names for search
    pub search_terms: Vec<String>,
    /// CoinGecko market cap ranking
    pub market_cap_rank: Option<i32>,
}

/// Supported image formats for logo serving.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum LogoFormat {
    Svg,
    Png,
    WebP,
    Jpeg,
    Ico,
}

impl fmt::Display for LogoFormat {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        match self {
            LogoFormat::Svg => write!(f, "svg"),
            LogoFormat::Png => write!(f, "png"),
            LogoFormat::WebP => write!(f, "webp"),
            LogoFormat::Jpeg => write!(f, "jpeg"),
            LogoFormat::Ico => write!(f, "ico"),
        }
    }
}

/// Options for logo requests.
#[derive(Debug, Clone, Default)]
pub struct LogoOptions {
    /// Output width in pixels
    pub width: Option<u32>,
    /// Output height in pixels (defaults to width)
    pub height: Option<u32>,
    /// Background hex color without # (e.g., "FFFFFF")
    pub bg: Option<String>,
}

/// Errors from the CryptoLogo client.
#[derive(Debug, thiserror::Error)]
pub enum Error {
    /// HTTP request failed
    #[error("HTTP error: {0}")]
    Http(#[from] reqwest::Error),

    /// Resource not found (404)
    #[error("Not found: {0}")]
    NotFound(String),

    /// Server returned an error status
    #[error("HTTP {status}: {url}")]
    Status { status: u16, url: String },

    /// I/O error
    #[error("I/O error: {0}")]
    Io(#[from] std::io::Error),
}