Juniper — Biblioteca GraphQL para Rust

Juniper es una biblioteca potente y de alto rendimiento para crear APIs GraphQL en el lenguaje Rust. Proporciona a los desarrolladores macros y tipos convenientes para construir rápidamente esquemas, resolvers y procesar consultas. Juniper es ideal para proyectos donde la velocidad, la seguridad de tipos y el bajo consumo de memoria son críticos — las fortalezas de Rust.

La biblioteca admite tanto resolvers síncronos como asíncronos (a través de async-trait), integración con frameworks web populares (Actix-web, Rocket, Warp, Axum), así como funcionalidades avanzadas: suscripciones (Subscriptions), fragmentos, directivas y escalares personalizados.

Características principales de Juniper

Macros para desarrollo rápido: #[derive(GraphQLObject)], #[derive(GraphQLInputObject)], #[graphql_interface] generan automáticamente tipos GraphQL a partir de estructuras de Rust.
Seguridad de tipos en tiempo de compilación: todos los errores de discrepancia de esquema y tipos de datos se detectan en la etapa de compilación, no en tiempo de ejecución.
Soporte de asincronía: integración incorporada con async/await a través de juniper::graphql_object y async-graphql.
Resolvers flexibles: posibilidad de usar contexto, bases de datos, APIs externas y lógica de negocio compleja.
Suscripciones (WebSockets): implementación de notificaciones en tiempo real usando futures.
Soporte de GraphQL Playground y GraphiQL: herramientas integradas para probar consultas.

Instalación y configuración

Agregue Juniper a su proyecto a través de Cargo.toml:

[dependencies]juniper = "0.16"# Para soporte asíncrono:juniper = { version = "0.16", features = ["async-trait"] }# Para integración con Actix-web:actix-web = "4"juniper-actix = "2"

La estructura básica del esquema consta de tres elementos: Query (consultas), Mutation (mutaciones) y Subscription (suscripciones). A continuación se muestra un ejemplo de una API simple para gestionar una lista de libros.

Ejemplo de código: creación de una API GraphQL simple

use juniper::{graphql_object, FieldResult, GraphQLObject, RootNode};

// Modelo de datos#[derive(GraphQLObject)]struct Book {    id: String,    title: String,    author: String,    year: i32,}

// Contexto (por ejemplo, acceso a BD)struct Context {    pub books: Vec<Book>,}impl juniper::Context for Context {}

// Resolvers para Querystruct Query;#[graphql_object]#[graphql(context = Context)]impl Query {    fn books(context: &Context) -> &Vec<Book> {        &context.books    }

    fn book_by_id(context: &Context, id: String) -> FieldResult<&Book> {        context.books.iter()            .find(|b| b.id == id)            .ok_or_else(|| juniper::FieldError::new("Book not found", graphql_value!({"code": "NOT_FOUND"})))    }}

// Resolvers para Mutationstruct Mutation;#[graphql_object]#[graphql(context = Context)]impl Mutation {    fn add_book(context: &mut Context, title: String, author: String, year: i32) -> FieldResult<Book> {        let new_book = Book {            id: uuid::Uuid::new_v4().to_string(),            title,            author,            year,        };        context.books.push(new_book);        Ok(new_book)    }}

// Creación del nodo raízpub type Schema = RootNode<'static, Query, Mutation>;

// Punto de entrada para procesar la consultapub fn create_schema() -> Schema {    Schema::new(Query, Mutation)}

Para ejecutar el servidor en Actix-web, use el conector listo: