docs.rs failed to build grpc_graphql_gateway-0.4.5
Please check the build logs for more information.
See Builds for ideas on how to fix a failed build, or Metadata for how to configure docs.rs builds.
If you believe this is docs.rs' fault, open an issue.

grpc_graphql_gateway

High-performance Rust gateway bridging gRPC to GraphQL with Apollo Federation v2.

Transform gRPC microservices into a unified GraphQL API. Zero GraphQL code required.

🚀 Performance at a Glance

Performance Rankings (Rust):
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
1. grpc_graphql_gateway    ████████████████████ 103,000 req/s 🚀
2. async-graphql (Actix)   █████████░░░░░░░░░░░  45,000 req/s
3. Juniper (Actix)         ████████░░░░░░░░░░░░  39,000 req/s

Cross-Language:
grpc_graphql_gateway  ████████████████████████░ 112,313 req/s
Apollo Server         ██░░░░░░░░░░░░░░░░░░░░░░░  4,000 req/s

25x faster than Node.js | 100k+ req/s | 85-95% cost savings Complete 100k req/s Stack: ~$120/mo

💰 Cost Efficiency (100k req/s)

Component	Standard (Node.js)	Optimized (Rust)	Monthly Savings
Compute	~$1,200 (25 instances)	~$300 (3 instances)	$900
Bandwidth	~$46,000 (518 TB)	~$900 (Compressed)	$45,000+
Total	~$47,200/mo	~$1,200/mo	97% Cheaper

See the full Cost Analysis.

✨ Features

Category	Capabilities
Core	Schema generation, Queries/Mutations/Subscriptions, WebSocket, File uploads
Federation	Apollo Federation v2, Entity resolution, DataLoader batching, No N+1
Production	Health checks, Prometheus, OpenTelemetry, Rate limiting, Circuit breaker
Security	Query depth/complexity limits, Introspection control, Query whitelisting
Performance	SIMD JSON, Sharded Cache, Response caching (Redis), APQ, Request collapsing
Connectors	REST APIs, OpenAPI integration, Multi-descriptor stitching

📦 Quick Start

[dependencies]
grpc_graphql_gateway = "0.3.8"
tokio = { version = "1", features = ["full"] }

use grpc_graphql_gateway::{Gateway, GrpcClient};

const DESCRIPTORS: &[u8] = include_bytes!(concat!(env!("OUT_DIR"), "/descriptor.bin"));

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    Gateway::builder()
        .with_descriptor_set_bytes(DESCRIPTORS)
        .add_grpc_client("service", GrpcClient::builder("http://localhost:50051").connect_lazy()?)
        .build()?
        .serve("0.0.0.0:8888")
        .await
}

Endpoints: http://localhost:8888/graphql | ws://localhost:8888/graphql/ws

🌐 Federation

Gateway::builder()
    .enable_federation()
    .with_entity_resolver(Arc::new(resolver))
    .build()?;

🔧 Production Config

Gateway::builder()
    .enable_health_checks()           // /health, /ready
    .enable_metrics()                 // /metrics (Prometheus)
    .enable_tracing()                 // OpenTelemetry
    .with_query_depth_limit(10)       // DoS protection
    .with_query_complexity_limit(100)
    .with_response_cache(CacheConfig::default())
    .with_circuit_breaker(CircuitBreakerConfig::default())
    .build()?;

📚 Examples

cargo run --example greeter      # Basic queries/mutations/subscriptions
cargo run --example federation   # 3 federated subgraphs

🔗 Links

📖 Full Documentation • 📦 Crates.io • 💻 GitHub

Made with ❤️ by Protocol Lattice

grpc_graphql_gateway 0.4.5