cnb 0.2.2

CNB (cnb.cool) API client for Rust — typed, async, production-ready
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
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140

// @generated DO NOT EDIT.
//
// Generated from the CNB OpenAPI specification by `cnb-codegen`.
// Run `cargo run -p cnb-codegen --manifest-path codegen/Cargo.toml \
//      -- --spec codegen/spec/swagger.json --out src` to refresh.

#![allow(clippy::all)]
#![allow(missing_docs)]
#![allow(unused_imports)]
#![allow(unused_mut)]

use reqwest::Method;
use serde::Serialize;

use crate::error::{ApiError, Result};
use crate::http::HttpInner;
use crate::models;

// `RepoLabels` resource client (generated, 4 operations).

/// Resource client.
#[derive(Debug, Clone)]
pub struct RepoLabelsClient {
    inner: HttpInner,
}

impl RepoLabelsClient {
    /// Construct a new resource client. Normally obtained
    /// via [`crate::ApiClient`] rather than directly.
    pub fn new(inner: HttpInner) -> Self {
        Self { inner }
    }

    /// 删除指定的仓库标签。Delete the specified repository label.
    ///
    /// `DELETE /{repo}/-/labels/{name}`
    pub async fn delete_label(&self, repo: String, name: String) -> Result<serde_json::Value> {
        let path = format!("/{}/-/labels/{}", repo, name);
        let mut url = self.inner.url(&path)?;
        self.inner
            .execute::<serde_json::Value>(Method::DELETE, url)
            .await
    }

    /// 查询仓库的标签列表。List repository labels.
    ///
    /// `GET /{repo}/-/labels`
    pub async fn list_labels(
        &self,
        repo: String,
        query: &ListLabelsQuery,
    ) -> Result<Vec<crate::models::Label>> {
        let path = format!("/{}/-/labels", repo);
        let mut url = self.inner.url(&path)?;
        {
            let mut pairs = url.query_pairs_mut();
            if let Some(v) = query.page {
                pairs.append_pair("page", &v.to_string());
            }
            if let Some(v) = query.page_size {
                pairs.append_pair("page_size", &v.to_string());
            }
            if let Some(ref v) = query.keyword {
                pairs.append_pair("keyword", v);
            }
            drop(pairs);
        }
        self.inner
            .execute::<Vec<crate::models::Label>>(Method::GET, url)
            .await
    }

    /// 更新标签信息。Update label information.
    ///
    /// `PATCH /{repo}/-/labels/{name}`
    pub async fn patch_label(
        &self,
        repo: String,
        name: String,
        body: &crate::models::PatchLabelForm,
    ) -> Result<crate::models::Label> {
        let path = format!("/{}/-/labels/{}", repo, name);
        let mut url = self.inner.url(&path)?;
        self.inner
            .execute_with_body::<crate::models::Label, _>(Method::PATCH, url, body)
            .await
    }

    /// 创建一个 标签。Create a label.
    ///
    /// `POST /{repo}/-/labels`
    pub async fn post_label(
        &self,
        repo: String,
        body: &crate::models::PostLabelForm,
    ) -> Result<crate::models::Label> {
        let path = format!("/{}/-/labels", repo);
        let mut url = self.inner.url(&path)?;
        self.inner
            .execute_with_body::<crate::models::Label, _>(Method::POST, url, body)
            .await
    }
}

/// Query parameters for the matching method on the resource client.
#[derive(Debug, Clone, Default, Serialize)]
#[non_exhaustive]
pub struct ListLabelsQuery {
    /// 分页页码。
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub page: Option<i64>,
    /// 分页页大小。
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub page_size: Option<i64>,
    /// 标签搜索关键词，支持模糊匹配。
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub keyword: Option<String>,
}

impl ListLabelsQuery {
    /// Construct an empty query.
    pub fn new() -> Self {
        Self::default()
    }
    /// Set `page` query parameter.
    pub fn page(mut self, v: impl Into<i64>) -> Self {
        self.page = Some(v.into());
        self
    }
    /// Set `page_size` query parameter.
    pub fn page_size(mut self, v: impl Into<i64>) -> Self {
        self.page_size = Some(v.into());
        self
    }
    /// Set `keyword` query parameter.
    pub fn keyword(mut self, v: impl Into<String>) -> Self {
        self.keyword = Some(v.into());
        self
    }
}