absinthe-graphql/absinthe
Absinthe
Absinthe is a GraphQL server implementation and query engine for the Elixir ecosystem. It provides the fundamental toolkit for building GraphQL APIs, including a processing engine that parses, validates, and executes documents against a defined application schema.
The project includes a batch resolver to optimize database performance by grouping field requests and a complexity guard to protect system resources by rejecting queries that exceed defined cost thresholds. It also features a schema adapter that translates internal Elixir naming conventions to external GraphQL casing for client compatibility.
The execution model supports asynchronous field resolution and a middleware-based pipeline for custom query processing. Additional capabilities cover query cost analysis, schema-driven resolution, and the ability to customize the parser and validation logic.
Features
- GraphQL Servers - Implements a full-featured GraphQL server in Elixir to handle flexible data queries and mutations.
- Field Resolution Optimizations - Optimizes data retrieval paths through asynchronous execution and batch-based field resolution.
- Batch Field Resolution - Groups multiple requests for the same data type into a single call to prevent N+1 query problems.
- Parallel Resolver Execution - Runs independent data resolvers in parallel using Elixir processes to reduce response latency.
- N+1 Query Prevention - Prevents N+1 query problems by batching requests for nested data during field resolution.
- GraphQL Execution Engines - Provides the runtime engine that executes GraphQL operations against a defined application schema.
- GraphQL Operation Execution - Provides the end-to-end processing engine for parsing, validating, and executing GraphQL queries.
- Schema-Driven - Maps GraphQL fields to executable Elixir functions using a predefined schema.
- GraphQL Query Cost Analyzers - Calculates numerical weights for GraphQL fields to reject overly complex requests before execution.
- GraphQL Execution Pipelines - Processes queries through a sequence of interchangeable stages for parsing, validation, and custom transformation.
- GraphQL Query Complexity Protection - Protects server resources by limiting the depth and complexity of GraphQL query selections.
- Query Complexity Protections - Implements a complexity guard that calculates the cost of incoming GraphQL queries and rejects those exceeding defined resource thresholds.
- Query Processing Pipelines - Allows modifying the processing pipeline by swapping or removing the parser, validations, and resolution logic.
- GraphQL Schema Configurations - Provides settings for customizing the behavior of the GraphQL schema, parser, and validation logic.
- Domain Specific Languages - Implements the GraphQL specification.
- Elixir GraphQL Tools - Full-featured GraphQL library for Elixir.
