google_cloud_api_servicecontrol_v1/
stub.rs

1// Copyright 2025 Google LLC
2//
3// Licensed under the Apache License, Version 2.0 (the "License");
4// you may not use this file except in compliance with the License.
5// You may obtain a copy of the License at
6//
7//     https://www.apache.org/licenses/LICENSE-2.0
8//
9// Unless required by applicable law or agreed to in writing, software
10// distributed under the License is distributed on an "AS IS" BASIS,
11// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12// See the License for the specific language governing permissions and
13// limitations under the License.
14//
15// Code generated by sidekick. DO NOT EDIT.
16
17//! Traits to mock the clients in this library.
18//!
19//! Application developers may need to mock the clients in this library to test
20//! how their application works with different (and sometimes hard to trigger)
21//! client and service behavior. Such test can define mocks implementing the
22//! trait(s) defined in this module, initialize the client with an instance of
23//! this mock in their tests, and verify their application responds as expected.
24
25#![allow(rustdoc::broken_intra_doc_links)]
26
27use gax::error::Error;
28
29pub(crate) mod dynamic;
30
31/// Defines the trait used to implement [super::client::QuotaController].
32///
33/// Application developers may need to implement this trait to mock
34/// `client::QuotaController`.  In other use-cases, application developers only
35/// use `client::QuotaController` and need not be concerned with this trait or
36/// its implementations.
37///
38/// Services gain new RPCs routinely. Consequently, this trait gains new methods
39/// too. To avoid breaking applications the trait provides a default
40/// implementation of each method. Most of these implementations just return an
41/// error.
42pub trait QuotaController: std::fmt::Debug + Send + Sync {
43    /// Implements [super::client::QuotaController::allocate_quota].
44    fn allocate_quota(
45        &self,
46        _req: crate::model::AllocateQuotaRequest,
47        _options: gax::options::RequestOptions,
48    ) -> impl std::future::Future<
49        Output = crate::Result<gax::response::Response<crate::model::AllocateQuotaResponse>>,
50    > + Send {
51        std::future::ready::<
52            crate::Result<gax::response::Response<crate::model::AllocateQuotaResponse>>,
53        >(Err(Error::other("unimplemented")))
54    }
55}
56
57/// Defines the trait used to implement [super::client::ServiceController].
58///
59/// Application developers may need to implement this trait to mock
60/// `client::ServiceController`.  In other use-cases, application developers only
61/// use `client::ServiceController` and need not be concerned with this trait or
62/// its implementations.
63///
64/// Services gain new RPCs routinely. Consequently, this trait gains new methods
65/// too. To avoid breaking applications the trait provides a default
66/// implementation of each method. Most of these implementations just return an
67/// error.
68pub trait ServiceController: std::fmt::Debug + Send + Sync {
69    /// Implements [super::client::ServiceController::check].
70    fn check(
71        &self,
72        _req: crate::model::CheckRequest,
73        _options: gax::options::RequestOptions,
74    ) -> impl std::future::Future<
75        Output = crate::Result<gax::response::Response<crate::model::CheckResponse>>,
76    > + Send {
77        std::future::ready::<crate::Result<gax::response::Response<crate::model::CheckResponse>>>(
78            Err(Error::other("unimplemented")),
79        )
80    }
81
82    /// Implements [super::client::ServiceController::report].
83    fn report(
84        &self,
85        _req: crate::model::ReportRequest,
86        _options: gax::options::RequestOptions,
87    ) -> impl std::future::Future<
88        Output = crate::Result<gax::response::Response<crate::model::ReportResponse>>,
89    > + Send {
90        std::future::ready::<crate::Result<gax::response::Response<crate::model::ReportResponse>>>(
91            Err(Error::other("unimplemented")),
92        )
93    }
94}