How azure/azure-sdk-for-rust works
The repository is the Azure SDK for Rust: service crates expose client APIs, with shared HTTP/runtime foundations beneath them. The tree and excerpts support a detailed Cosmos DB workflow—client operations, query/feed handling, driver execution, routing and transport—plus the shared HTTP layer and emulator. Some service-crate internals are not sampled, so the map focuses on supported paths and documented workspace structure; unsampled subsystem wiring is left out.
Main entry points: operation_pipeline.rs Operation pipeline · clients Cosmos clients · transport_pipeline.rs Transport pipeline · pipeline.rs Core HTTP pipeline
Components 17
Cosmos SDK API
- Cosmos clients
sdk/cosmos/azure_data_cosmos/src/clients - Queries and feeds
sdk/cosmos/azure_data_cosmos/src/feed - Cosmos models
sdk/cosmos/azure_data_cosmos/src/models - Driver bridge
sdk/cosmos/azure_data_cosmos/src/driver_bridge.rs
Cosmos Driver
- Operation pipeline
sdk/cosmos/azure_data_cosmos_driver/src/driver/pipeline/operation_pipeline.rs - Query planning
sdk/cosmos/azure_data_cosmos_driver/src/driver/cosmos_driver/query_planning.rs - Query dataflow
sdk/cosmos/azure_data_cosmos_driver/src/driver/dataflow/pipeline.rs - Routing and sessions
sdk/cosmos/azure_data_cosmos_driver/src/driver/routing - Session management
sdk/cosmos/azure_data_cosmos_driver/src/driver/routing/session_manager.rs - Transport pipeline
sdk/cosmos/azure_data_cosmos_driver/src/driver/transport/transport_pipeline.rs - Cosmos diagnostics
sdk/cosmos/azure_data_cosmos/src/diagnostics
Shared Core
- Azure Core
sdk/core/azure_core/src - Core HTTP pipeline
sdk/core/azure_core/src/http/pipeline.rs - TypeSpec HTTP
sdk/core/typespec_client_core/src/http/pipeline.rs
Cosmos Runtime
- Cosmos emulator
sdk/cosmos/azure_data_cosmos_emulator/src/main.rs
Other components
- SDK application
- Azure Cosmos DB
Connections 16
- SDK application → Cosmos clients: uses clients
- Cosmos clients → Driver bridge: bridges operations
- Cosmos clients → Queries and feeds: exposes feeds
- Cosmos clients → Cosmos models: uses models
- Driver bridge → Operation pipeline: dispatches operations
- Queries and feeds → Query planning: defines queries
- Query planning → Query dataflow: plans query
- Operation pipeline → Routing and sessions: resolves routing
- Operation pipeline → Session management: resolves sessions
- Operation pipeline → Transport pipeline: executes attempts
- Transport pipeline → Azure Cosmos DB: sends requests
- Operation pipeline → Cosmos diagnostics: records diagnostics
- Azure Core → Core HTTP pipeline: provides pipeline
- Transport pipeline → Core HTTP pipeline: uses HTTP types
- Core HTTP pipeline → TypeSpec HTTP: uses client core
- Cosmos emulator → Azure Cosmos DB: emulates service