metabase 0.1.1

Ergonomic Rust SDK for Metabase's HTTP API, with async and blocking clients.
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

use http::{HeaderMap, HeaderValue};
use secrecy::{ExposeSecret, SecretString};

use crate::error::Error;

/// Authentication methods for the Metabase API.
#[derive(Clone, Debug, Default)]
#[non_exhaustive]
pub enum Auth {
    /// No authentication (public endpoints only).
    #[default]
    None,
    /// Metabase session token (`X-Metabase-Session`).
    Session { token: SecretString },
    /// Metabase API key (typically `X-API-KEY`).
    ApiKey { key: SecretString },
}

impl Auth {
    /// No authentication (public endpoints only).
    pub fn none() -> Self {
        Self::None
    }

    /// Create an auth config from a Metabase session token.
    pub fn session(token: impl Into<String>) -> Self {
        Self::Session {
            token: SecretString::from(token.into()),
        }
    }

    /// Create an auth config from a Metabase API key.
    pub fn api_key(key: impl Into<String>) -> Self {
        Self::ApiKey {
            key: SecretString::from(key.into()),
        }
    }

    pub(crate) fn apply(&self, headers: &mut HeaderMap) -> Result<(), Error> {
        match self {
            Auth::None => Ok(()),
            Auth::Session { token } => {
                let value = HeaderValue::from_str(token.expose_secret())
                    .map_err(|source| Error::invalid_header_value("X-Metabase-Session", source))?;
                headers.insert("X-Metabase-Session", value);
                Ok(())
            }
            Auth::ApiKey { key } => {
                let value = HeaderValue::from_str(key.expose_secret())
                    .map_err(|source| Error::invalid_header_value("X-API-KEY", source))?;
                headers.insert("X-API-KEY", value);
                Ok(())
            }
        }
    }
}