google-cloud-dns-v1 2.0.0

// Copyright 2026 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     https://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
//
// Code generated by sidekick. DO NOT EDIT.

//! Traits to mock the clients in this library.
//!
//! Application developers may need to mock the clients in this library to test
//! how their application works with different (and sometimes hard to trigger)
//! client and service behavior. Such test can define mocks implementing the
//! trait(s) defined in this module, initialize the client with an instance of
//! this mock in their tests, and verify their application responds as expected.

#![allow(rustdoc::broken_intra_doc_links)]

pub(crate) mod dynamic;

/// Defines the trait used to implement [super::client::Changes].
///
/// Application developers may need to implement this trait to mock
/// `client::Changes`.  In other use-cases, application developers only
/// use `client::Changes` and need not be concerned with this trait or
/// its implementations.
///
/// Services gain new RPCs routinely. Consequently, this trait gains new methods
/// too. To avoid breaking applications the trait provides a default
/// implementation of each method. Most of these implementations just return an
/// error.
pub trait Changes: std::fmt::Debug + Send + Sync {
    /// Implements [super::client::Changes::create].
    fn create(
        &self,
        _req: crate::model::changes::CreateRequest,
        _options: crate::RequestOptions,
    ) -> impl std::future::Future<Output = crate::Result<crate::Response<crate::model::Change>>> + Send
    {
        gaxi::unimplemented::unimplemented_stub()
    }

    /// Implements [super::client::Changes::get].
    fn get(
        &self,
        _req: crate::model::changes::GetRequest,
        _options: crate::RequestOptions,
    ) -> impl std::future::Future<Output = crate::Result<crate::Response<crate::model::Change>>> + Send
    {
        gaxi::unimplemented::unimplemented_stub()
    }

    /// Implements [super::client::Changes::list].
    fn list(
        &self,
        _req: crate::model::changes::ListRequest,
        _options: crate::RequestOptions,
    ) -> impl std::future::Future<
        Output = crate::Result<crate::Response<crate::model::ChangesListResponse>>,
    > + Send {
        gaxi::unimplemented::unimplemented_stub()
    }
}

/// Defines the trait used to implement [super::client::DnsKeys].
///
/// Application developers may need to implement this trait to mock
/// `client::DnsKeys`.  In other use-cases, application developers only
/// use `client::DnsKeys` and need not be concerned with this trait or
/// its implementations.
///
/// Services gain new RPCs routinely. Consequently, this trait gains new methods
/// too. To avoid breaking applications the trait provides a default
/// implementation of each method. Most of these implementations just return an
/// error.
pub trait DnsKeys: std::fmt::Debug + Send + Sync {
    /// Implements [super::client::DnsKeys::get].
    fn get(
        &self,
        _req: crate::model::dns_keys::GetRequest,
        _options: crate::RequestOptions,
    ) -> impl std::future::Future<Output = crate::Result<crate::Response<crate::model::DnsKey>>> + Send
    {
        gaxi::unimplemented::unimplemented_stub()
    }

    /// Implements [super::client::DnsKeys::list].
    fn list(
        &self,
        _req: crate::model::dns_keys::ListRequest,
        _options: crate::RequestOptions,
    ) -> impl std::future::Future<
        Output = crate::Result<crate::Response<crate::model::DnsKeysListResponse>>,
    > + Send {
        gaxi::unimplemented::unimplemented_stub()
    }
}

/// Defines the trait used to implement [super::client::ManagedZoneOperations].
///
/// Application developers may need to implement this trait to mock
/// `client::ManagedZoneOperations`.  In other use-cases, application developers only
/// use `client::ManagedZoneOperations` and need not be concerned with this trait or
/// its implementations.
///
/// Services gain new RPCs routinely. Consequently, this trait gains new methods
/// too. To avoid breaking applications the trait provides a default
/// implementation of each method. Most of these implementations just return an
/// error.
pub trait ManagedZoneOperations: std::fmt::Debug + Send + Sync {
    /// Implements [super::client::ManagedZoneOperations::get].
    fn get(
        &self,
        _req: crate::model::managed_zone_operations::GetRequest,
        _options: crate::RequestOptions,
    ) -> impl std::future::Future<Output = crate::Result<crate::Response<crate::model::Operation>>> + Send
    {
        gaxi::unimplemented::unimplemented_stub()
    }

    /// Implements [super::client::ManagedZoneOperations::list].
    fn list(
        &self,
        _req: crate::model::managed_zone_operations::ListRequest,
        _options: crate::RequestOptions,
    ) -> impl std::future::Future<
        Output = crate::Result<crate::Response<crate::model::ManagedZoneOperationsListResponse>>,
    > + Send {
        gaxi::unimplemented::unimplemented_stub()
    }
}

/// Defines the trait used to implement [super::client::ManagedZones].
///
/// Application developers may need to implement this trait to mock
/// `client::ManagedZones`.  In other use-cases, application developers only
/// use `client::ManagedZones` and need not be concerned with this trait or
/// its implementations.
///
/// Services gain new RPCs routinely. Consequently, this trait gains new methods
/// too. To avoid breaking applications the trait provides a default
/// implementation of each method. Most of these implementations just return an
/// error.
pub trait ManagedZones: std::fmt::Debug + Send + Sync {
    /// Implements [super::client::ManagedZones::create].
    fn create(
        &self,
        _req: crate::model::managed_zones::CreateRequest,
        _options: crate::RequestOptions,
    ) -> impl std::future::Future<Output = crate::Result<crate::Response<crate::model::ManagedZone>>>
    + Send {
        gaxi::unimplemented::unimplemented_stub()
    }

    /// Implements [super::client::ManagedZones::delete].
    fn delete(
        &self,
        _req: crate::model::managed_zones::DeleteRequest,
        _options: crate::RequestOptions,
    ) -> impl std::future::Future<Output = crate::Result<crate::Response<()>>> + Send {
        gaxi::unimplemented::unimplemented_stub()
    }

    /// Implements [super::client::ManagedZones::get].
    fn get(
        &self,
        _req: crate::model::managed_zones::GetRequest,
        _options: crate::RequestOptions,
    ) -> impl std::future::Future<Output = crate::Result<crate::Response<crate::model::ManagedZone>>>
    + Send {
        gaxi::unimplemented::unimplemented_stub()
    }

    /// Implements [super::client::ManagedZones::get_iam_policy].
    fn get_iam_policy(
        &self,
        _req: crate::model::managed_zones::GetIamPolicyRequest,
        _options: crate::RequestOptions,
    ) -> impl std::future::Future<
        Output = crate::Result<crate::Response<crate::model::GoogleIamV1Policy>>,
    > + Send {
        gaxi::unimplemented::unimplemented_stub()
    }

    /// Implements [super::client::ManagedZones::list].
    fn list(
        &self,
        _req: crate::model::managed_zones::ListRequest,
        _options: crate::RequestOptions,
    ) -> impl std::future::Future<
        Output = crate::Result<crate::Response<crate::model::ManagedZonesListResponse>>,
    > + Send {
        gaxi::unimplemented::unimplemented_stub()
    }

    /// Implements [super::client::ManagedZones::patch].
    fn patch(
        &self,
        _req: crate::model::managed_zones::PatchRequest,
        _options: crate::RequestOptions,
    ) -> impl std::future::Future<Output = crate::Result<crate::Response<crate::model::Operation>>> + Send
    {
        gaxi::unimplemented::unimplemented_stub()
    }

    /// Implements [super::client::ManagedZones::set_iam_policy].
    fn set_iam_policy(
        &self,
        _req: crate::model::managed_zones::SetIamPolicyRequest,
        _options: crate::RequestOptions,
    ) -> impl std::future::Future<
        Output = crate::Result<crate::Response<crate::model::GoogleIamV1Policy>>,
    > + Send {
        gaxi::unimplemented::unimplemented_stub()
    }

    /// Implements [super::client::ManagedZones::test_iam_permissions].
    fn test_iam_permissions(
        &self,
        _req: crate::model::managed_zones::TestIamPermissionsRequest,
        _options: crate::RequestOptions,
    ) -> impl std::future::Future<
        Output = crate::Result<
            crate::Response<crate::model::GoogleIamV1TestIamPermissionsResponse>,
        >,
    > + Send {
        gaxi::unimplemented::unimplemented_stub()
    }

    /// Implements [super::client::ManagedZones::update].
    fn update(
        &self,
        _req: crate::model::managed_zones::UpdateRequest,
        _options: crate::RequestOptions,
    ) -> impl std::future::Future<Output = crate::Result<crate::Response<crate::model::Operation>>> + Send
    {
        gaxi::unimplemented::unimplemented_stub()
    }

    /// Implements [super::client::ManagedZones::get_operation].
    fn get_operation(
        &self,
        _req: crate::model::managed_zone_operations::GetRequest,
        _options: crate::RequestOptions,
    ) -> impl std::future::Future<Output = crate::Result<crate::Response<crate::model::Operation>>> + Send
    {
        gaxi::unimplemented::unimplemented_stub()
    }

    /// Returns the polling error policy.
    ///
    /// When mocking, this method is typically irrelevant. Do not try to verify
    /// it is called by your mocks.
    fn get_polling_error_policy(
        &self,
        _options: &crate::RequestOptions,
    ) -> std::sync::Arc<dyn google_cloud_gax::polling_error_policy::PollingErrorPolicy> {
        std::sync::Arc::new(google_cloud_gax::polling_error_policy::Aip194Strict)
    }

    /// Returns the polling backoff policy.
    ///
    /// When mocking, this method is typically irrelevant. Do not try to verify
    /// it is called by your mocks.
    fn get_polling_backoff_policy(
        &self,
        _options: &crate::RequestOptions,
    ) -> std::sync::Arc<dyn google_cloud_gax::polling_backoff_policy::PollingBackoffPolicy> {
        std::sync::Arc::new(google_cloud_gax::exponential_backoff::ExponentialBackoff::default())
    }

    #[doc(hidden)]
    /// Returns the poller options.
    ///
    /// When mocking, this method is typically irrelevant. Do not try to verify
    /// it is called by your mocks.
    fn get_poller_options(
        &self,
        _options: &crate::RequestOptions,
    ) -> google_cloud_lro::PollerOptions {
        google_cloud_lro::PollerOptions::default()
    }
}

/// Defines the trait used to implement [super::client::Policies].
///
/// Application developers may need to implement this trait to mock
/// `client::Policies`.  In other use-cases, application developers only
/// use `client::Policies` and need not be concerned with this trait or
/// its implementations.
///
/// Services gain new RPCs routinely. Consequently, this trait gains new methods
/// too. To avoid breaking applications the trait provides a default
/// implementation of each method. Most of these implementations just return an
/// error.
pub trait Policies: std::fmt::Debug + Send + Sync {
    /// Implements [super::client::Policies::create].
    fn create(
        &self,
        _req: crate::model::policies::CreateRequest,
        _options: crate::RequestOptions,
    ) -> impl std::future::Future<Output = crate::Result<crate::Response<crate::model::Policy>>> + Send
    {
        gaxi::unimplemented::unimplemented_stub()
    }

    /// Implements [super::client::Policies::delete].
    fn delete(
        &self,
        _req: crate::model::policies::DeleteRequest,
        _options: crate::RequestOptions,
    ) -> impl std::future::Future<Output = crate::Result<crate::Response<()>>> + Send {
        gaxi::unimplemented::unimplemented_stub()
    }

    /// Implements [super::client::Policies::get].
    fn get(
        &self,
        _req: crate::model::policies::GetRequest,
        _options: crate::RequestOptions,
    ) -> impl std::future::Future<Output = crate::Result<crate::Response<crate::model::Policy>>> + Send
    {
        gaxi::unimplemented::unimplemented_stub()
    }

    /// Implements [super::client::Policies::list].
    fn list(
        &self,
        _req: crate::model::policies::ListRequest,
        _options: crate::RequestOptions,
    ) -> impl std::future::Future<
        Output = crate::Result<crate::Response<crate::model::PoliciesListResponse>>,
    > + Send {
        gaxi::unimplemented::unimplemented_stub()
    }

    /// Implements [super::client::Policies::patch].
    fn patch(
        &self,
        _req: crate::model::policies::PatchRequest,
        _options: crate::RequestOptions,
    ) -> impl std::future::Future<
        Output = crate::Result<crate::Response<crate::model::PoliciesPatchResponse>>,
    > + Send {
        gaxi::unimplemented::unimplemented_stub()
    }

    /// Implements [super::client::Policies::update].
    fn update(
        &self,
        _req: crate::model::policies::UpdateRequest,
        _options: crate::RequestOptions,
    ) -> impl std::future::Future<
        Output = crate::Result<crate::Response<crate::model::PoliciesUpdateResponse>>,
    > + Send {
        gaxi::unimplemented::unimplemented_stub()
    }
}

/// Defines the trait used to implement [super::client::Projects].
///
/// Application developers may need to implement this trait to mock
/// `client::Projects`.  In other use-cases, application developers only
/// use `client::Projects` and need not be concerned with this trait or
/// its implementations.
///
/// Services gain new RPCs routinely. Consequently, this trait gains new methods
/// too. To avoid breaking applications the trait provides a default
/// implementation of each method. Most of these implementations just return an
/// error.
pub trait Projects: std::fmt::Debug + Send + Sync {
    /// Implements [super::client::Projects::get].
    fn get(
        &self,
        _req: crate::model::projects::GetRequest,
        _options: crate::RequestOptions,
    ) -> impl std::future::Future<Output = crate::Result<crate::Response<crate::model::Project>>> + Send
    {
        gaxi::unimplemented::unimplemented_stub()
    }
}

/// Defines the trait used to implement [super::client::ResourceRecordSets].
///
/// Application developers may need to implement this trait to mock
/// `client::ResourceRecordSets`.  In other use-cases, application developers only
/// use `client::ResourceRecordSets` and need not be concerned with this trait or
/// its implementations.
///
/// Services gain new RPCs routinely. Consequently, this trait gains new methods
/// too. To avoid breaking applications the trait provides a default
/// implementation of each method. Most of these implementations just return an
/// error.
pub trait ResourceRecordSets: std::fmt::Debug + Send + Sync {
    /// Implements [super::client::ResourceRecordSets::create].
    fn create(
        &self,
        _req: crate::model::resource_record_sets::CreateRequest,
        _options: crate::RequestOptions,
    ) -> impl std::future::Future<
        Output = crate::Result<crate::Response<crate::model::ResourceRecordSet>>,
    > + Send {
        gaxi::unimplemented::unimplemented_stub()
    }

    /// Implements [super::client::ResourceRecordSets::delete].
    fn delete(
        &self,
        _req: crate::model::resource_record_sets::DeleteRequest,
        _options: crate::RequestOptions,
    ) -> impl std::future::Future<
        Output = crate::Result<crate::Response<crate::model::ResourceRecordSetsDeleteResponse>>,
    > + Send {
        gaxi::unimplemented::unimplemented_stub()
    }

    /// Implements [super::client::ResourceRecordSets::get].
    fn get(
        &self,
        _req: crate::model::resource_record_sets::GetRequest,
        _options: crate::RequestOptions,
    ) -> impl std::future::Future<
        Output = crate::Result<crate::Response<crate::model::ResourceRecordSet>>,
    > + Send {
        gaxi::unimplemented::unimplemented_stub()
    }

    /// Implements [super::client::ResourceRecordSets::list].
    fn list(
        &self,
        _req: crate::model::resource_record_sets::ListRequest,
        _options: crate::RequestOptions,
    ) -> impl std::future::Future<
        Output = crate::Result<crate::Response<crate::model::ResourceRecordSetsListResponse>>,
    > + Send {
        gaxi::unimplemented::unimplemented_stub()
    }

    /// Implements [super::client::ResourceRecordSets::patch].
    fn patch(
        &self,
        _req: crate::model::resource_record_sets::PatchRequest,
        _options: crate::RequestOptions,
    ) -> impl std::future::Future<
        Output = crate::Result<crate::Response<crate::model::ResourceRecordSet>>,
    > + Send {
        gaxi::unimplemented::unimplemented_stub()
    }
}

/// Defines the trait used to implement [super::client::ResponsePolicies].
///
/// Application developers may need to implement this trait to mock
/// `client::ResponsePolicies`.  In other use-cases, application developers only
/// use `client::ResponsePolicies` and need not be concerned with this trait or
/// its implementations.
///
/// Services gain new RPCs routinely. Consequently, this trait gains new methods
/// too. To avoid breaking applications the trait provides a default
/// implementation of each method. Most of these implementations just return an
/// error.
pub trait ResponsePolicies: std::fmt::Debug + Send + Sync {
    /// Implements [super::client::ResponsePolicies::create].
    fn create(
        &self,
        _req: crate::model::response_policies::CreateRequest,
        _options: crate::RequestOptions,
    ) -> impl std::future::Future<
        Output = crate::Result<crate::Response<crate::model::ResponsePolicy>>,
    > + Send {
        gaxi::unimplemented::unimplemented_stub()
    }

    /// Implements [super::client::ResponsePolicies::delete].
    fn delete(
        &self,
        _req: crate::model::response_policies::DeleteRequest,
        _options: crate::RequestOptions,
    ) -> impl std::future::Future<Output = crate::Result<crate::Response<()>>> + Send {
        gaxi::unimplemented::unimplemented_stub()
    }

    /// Implements [super::client::ResponsePolicies::get].
    fn get(
        &self,
        _req: crate::model::response_policies::GetRequest,
        _options: crate::RequestOptions,
    ) -> impl std::future::Future<
        Output = crate::Result<crate::Response<crate::model::ResponsePolicy>>,
    > + Send {
        gaxi::unimplemented::unimplemented_stub()
    }

    /// Implements [super::client::ResponsePolicies::list].
    fn list(
        &self,
        _req: crate::model::response_policies::ListRequest,
        _options: crate::RequestOptions,
    ) -> impl std::future::Future<
        Output = crate::Result<crate::Response<crate::model::ResponsePoliciesListResponse>>,
    > + Send {
        gaxi::unimplemented::unimplemented_stub()
    }

    /// Implements [super::client::ResponsePolicies::patch].
    fn patch(
        &self,
        _req: crate::model::response_policies::PatchRequest,
        _options: crate::RequestOptions,
    ) -> impl std::future::Future<
        Output = crate::Result<crate::Response<crate::model::ResponsePoliciesPatchResponse>>,
    > + Send {
        gaxi::unimplemented::unimplemented_stub()
    }

    /// Implements [super::client::ResponsePolicies::update].
    fn update(
        &self,
        _req: crate::model::response_policies::UpdateRequest,
        _options: crate::RequestOptions,
    ) -> impl std::future::Future<
        Output = crate::Result<crate::Response<crate::model::ResponsePoliciesUpdateResponse>>,
    > + Send {
        gaxi::unimplemented::unimplemented_stub()
    }
}

/// Defines the trait used to implement [super::client::ResponsePolicyRules].
///
/// Application developers may need to implement this trait to mock
/// `client::ResponsePolicyRules`.  In other use-cases, application developers only
/// use `client::ResponsePolicyRules` and need not be concerned with this trait or
/// its implementations.
///
/// Services gain new RPCs routinely. Consequently, this trait gains new methods
/// too. To avoid breaking applications the trait provides a default
/// implementation of each method. Most of these implementations just return an
/// error.
pub trait ResponsePolicyRules: std::fmt::Debug + Send + Sync {
    /// Implements [super::client::ResponsePolicyRules::create].
    fn create(
        &self,
        _req: crate::model::response_policy_rules::CreateRequest,
        _options: crate::RequestOptions,
    ) -> impl std::future::Future<
        Output = crate::Result<crate::Response<crate::model::ResponsePolicyRule>>,
    > + Send {
        gaxi::unimplemented::unimplemented_stub()
    }

    /// Implements [super::client::ResponsePolicyRules::delete].
    fn delete(
        &self,
        _req: crate::model::response_policy_rules::DeleteRequest,
        _options: crate::RequestOptions,
    ) -> impl std::future::Future<Output = crate::Result<crate::Response<()>>> + Send {
        gaxi::unimplemented::unimplemented_stub()
    }

    /// Implements [super::client::ResponsePolicyRules::get].
    fn get(
        &self,
        _req: crate::model::response_policy_rules::GetRequest,
        _options: crate::RequestOptions,
    ) -> impl std::future::Future<
        Output = crate::Result<crate::Response<crate::model::ResponsePolicyRule>>,
    > + Send {
        gaxi::unimplemented::unimplemented_stub()
    }

    /// Implements [super::client::ResponsePolicyRules::list].
    fn list(
        &self,
        _req: crate::model::response_policy_rules::ListRequest,
        _options: crate::RequestOptions,
    ) -> impl std::future::Future<
        Output = crate::Result<crate::Response<crate::model::ResponsePolicyRulesListResponse>>,
    > + Send {
        gaxi::unimplemented::unimplemented_stub()
    }

    /// Implements [super::client::ResponsePolicyRules::patch].
    fn patch(
        &self,
        _req: crate::model::response_policy_rules::PatchRequest,
        _options: crate::RequestOptions,
    ) -> impl std::future::Future<
        Output = crate::Result<crate::Response<crate::model::ResponsePolicyRulesPatchResponse>>,
    > + Send {
        gaxi::unimplemented::unimplemented_stub()
    }

    /// Implements [super::client::ResponsePolicyRules::update].
    fn update(
        &self,
        _req: crate::model::response_policy_rules::UpdateRequest,
        _options: crate::RequestOptions,
    ) -> impl std::future::Future<
        Output = crate::Result<crate::Response<crate::model::ResponsePolicyRulesUpdateResponse>>,
    > + Send {
        gaxi::unimplemented::unimplemented_stub()
    }
}