azure_data_cosmos_driver 0.5.0

Core implementation layer for Azure Cosmos DB - provides transport, routing, and protocol handling for cross-language SDK reuse
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

// Copyright (c) Microsoft Corporation. All rights reserved.
// Licensed under the MIT License.

//! Configuration options for the Cosmos DB driver.
//!
//! This module contains types for configuring driver instances and individual operations.
//! Options follow a four-level hierarchy with layered resolution:
//!
//! **Environment → Runtime → Account (Driver) → Operation** (lowest to highest priority)
//!
//! [`OperationOptions`] is the single option group for all layered configuration.
//! It uses `#[derive(CosmosOptions)]` to generate an [`OperationOptionsView`],
//! [`OperationOptionsBuilder`], `Default`, and `from_env()` constructors.
//!
//! [`ConnectionPoolOptions`] and [`DiagnosticsOptions`] are captured once at
//! initialization time and do not participate in per-operation layered resolution.

mod availability_strategy;
mod connection_pool;
mod diagnostics_options;
mod driver_options;
pub(crate) mod env_parsing;
mod identity;
mod operation_options;
mod partition_failover;
mod policies;
mod priority;
mod read_consistency;
mod region;
mod throughput_control;

pub use availability_strategy::{AvailabilityStrategy, HedgeThreshold, HedgingStrategy};
pub use connection_pool::{ConnectionPoolOptions, ConnectionPoolOptionsBuilder};
pub use diagnostics_options::{
    DiagnosticsOptions, DiagnosticsOptionsBuilder, DiagnosticsVerbosity,
};
pub use driver_options::{DriverOptions, DriverOptionsBuilder};
pub(crate) use env_parsing::parse_duration_millis_from_env;
pub use identity::{CorrelationId, UserAgentSuffix, WorkloadId};
pub use operation_options::{
    OperationOptions, OperationOptionsBuilder, OperationOptionsView, ThrottlingRetryOptions,
    ThrottlingRetryOptionsBuilder, ThrottlingRetryOptionsView, ThroughputControlOptions,
    ThroughputControlOptionsBuilder, ThroughputControlOptionsView,
};
pub use partition_failover::{PartitionFailoverOptions, PartitionFailoverOptionsBuilder};
pub use policies::{
    ContentResponseOnWrite, EndToEndOperationLatencyPolicy, ExcludedRegions,
    ServerCertificateValidation,
};
pub use priority::PriorityLevel;
pub use read_consistency::ReadConsistencyStrategy;
pub use region::Region;
pub use throughput_control::ThroughputControlGroupOptions;
pub(crate) use throughput_control::{
    ResolvedThroughputControl, ThroughputControlGroupRegistry, ThroughputControlGroupSnapshot,
};