dune-api 0.1.0

Unofficial Rust client for the Dune Analytics API
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
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119

//! Materialized Views API implementation

use super::types::*;
use crate::client::Client;
use crate::error::{self, Error, Result};

/// Materialized Views API
pub struct MatviewsApi<'a> {
    client: &'a Client,
}

impl<'a> MatviewsApi<'a> {
    pub(crate) fn new(client: &'a Client) -> Self {
        Self { client }
    }

    /// Create or update a materialized view
    pub async fn upsert(&self, request: &UpsertMatviewRequest) -> Result<UpsertMatviewResponse> {
        let url = format!("{}/v1/materialized-views", self.client.base_url());
        let response = self.client.http().post(&url).json(request).send().await?;

        if response.status().is_success() {
            Ok(response.json().await?)
        } else {
            let status = response.status().as_u16();
            let message = response.text().await.unwrap_or_default();
            Err(Error::api(status, message))
        }
    }

    /// Get a materialized view by name
    pub async fn get(&self, name: &str) -> Result<Matview> {
        let url = format!("{}/v1/materialized-views/{}", self.client.base_url(), name);
        let response = self.client.http().get(&url).send().await?;

        if response.status().is_success() {
            Ok(response.json().await?)
        } else if response.status() == 404 {
            Err(error::not_found(format!("Matview {}", name)))
        } else {
            let status = response.status().as_u16();
            let message = response.text().await.unwrap_or_default();
            Err(Error::api(status, message))
        }
    }

    /// List all materialized views
    pub async fn list(&self) -> Result<ListMatviewsResponse> {
        self.list_with_options(&ListMatviewsOptions::default())
            .await
    }

    /// List materialized views with options
    pub async fn list_with_options(
        &self,
        options: &ListMatviewsOptions,
    ) -> Result<ListMatviewsResponse> {
        let url = format!(
            "{}/v1/materialized-views{}",
            self.client.base_url(),
            options.to_query_string()
        );
        let response = self.client.http().get(&url).send().await?;

        if response.status().is_success() {
            Ok(response.json().await?)
        } else {
            let status = response.status().as_u16();
            let message = response.text().await.unwrap_or_default();
            Err(Error::api(status, message))
        }
    }

    /// Refresh a materialized view
    pub async fn refresh(&self, name: &str) -> Result<RefreshMatviewResponse> {
        self.refresh_with_options(name, &RefreshMatviewRequest::default())
            .await
    }

    /// Refresh a materialized view with options
    pub async fn refresh_with_options(
        &self,
        name: &str,
        request: &RefreshMatviewRequest,
    ) -> Result<RefreshMatviewResponse> {
        let url = format!(
            "{}/v1/materialized-views/{}/refresh",
            self.client.base_url(),
            name
        );
        let response = self.client.http().post(&url).json(request).send().await?;

        if response.status().is_success() {
            Ok(response.json().await?)
        } else if response.status() == 404 {
            Err(error::not_found(format!("Matview {}", name)))
        } else {
            let status = response.status().as_u16();
            let message = response.text().await.unwrap_or_default();
            Err(Error::api(status, message))
        }
    }

    /// Delete a materialized view
    pub async fn delete(&self, name: &str) -> Result<DeleteMatviewResponse> {
        let url = format!("{}/v1/materialized-views/{}", self.client.base_url(), name);
        let response = self.client.http().delete(&url).send().await?;

        if response.status().is_success() {
            Ok(response.json().await?)
        } else if response.status() == 404 {
            Err(error::not_found(format!("Matview {}", name)))
        } else {
            let status = response.status().as_u16();
            let message = response.text().await.unwrap_or_default();
            Err(Error::api(status, message))
        }
    }
}