Struct ProviderService 

pub struct ProviderService { /* private fields */ }

Provider service and immutable expected endpoint identity.

Implementations

impl ProviderService

pub const fn new( provider: Provider, family: ApiFamily, endpoint: EndpointIdentity<'static>, ) -> Self

Binds a provider API family to one normalized expected endpoint.

Examples found in repository

examples/prepared_request.rs (line 62)

    fn prepare<'storage>(
        &self,
        storage: PreparationStorage<'storage>,
    ) -> Result<PreparedRequest<'storage>, Self::Error> {
        let (target_storage, _body_storage) = storage.into_parts();
        let target = target_storage
            .get_mut(..17)
            .ok_or(PrepareError::TargetBuffer)?;
        target.copy_from_slice(b"/resources?page=1");
        let target = core::str::from_utf8(target).map_err(|_| PrepareError::InvalidTarget)?;
        let target = RequestTarget::new(target).map_err(|_| PrepareError::InvalidTarget)?;
        let request = TransportRequest::new(Method::Get, target);
        let metadata = OperationMetadata::new(
            OperationImpact::ReadOnly,
            RequestSemantics::Safe,
            RetryEligibility::ExplicitPolicy,
            CostIntent::NoKnownCost,
        )
        .map_err(|_| PrepareError::InvalidMetadata)?;
        let response_policy = ResponsePolicy::new(
            &OK_STATUS,
            ContentTypePolicy::Required(&JSON_MEDIA),
            ResponseBodyPolicy::Required,
            65_536,
        )
        .map_err(|_| PrepareError::InvalidResponsePolicy)?;
        let endpoint =
            EndpointIdentity::new(EndpointScheme::Https, "api.example.invalid", 443, "/v1")
                .map_err(|_| PrepareError::InvalidEndpoint)?;
        Ok(PreparedRequest::new(
            request,
            ProviderService::new(Provider::Hetzner, ApiFamily::Cloud, endpoint),
            metadata,
            response_policy,
        ))
    }

pub const fn provider(self) -> Provider

Returns the provider namespace.

pub const fn family(self) -> ApiFamily

Returns the provider API family.

pub const fn endpoint(self) -> EndpointIdentity<'static>

Returns the immutable expected endpoint identity.

Trait Implementations

impl Clone for ProviderService

fn clone(&self) -> ProviderService

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for ProviderService

impl Debug for ProviderService

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for ProviderService

impl PartialEq for ProviderService

fn eq(&self, other: &ProviderService) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for ProviderService