ruby-grape/grape

Features

• API Versioning - Supports multiple concurrent API versions managed via URL paths, request parameters, or custom headers.
• RESTful API Development - Provides a declarative framework for building scalable web services using standard HTTP methods and architectural patterns.
• Routing DSLs - Provides a declarative domain-specific language for mapping HTTP verbs and paths to logic handlers.
• Version-Aware Route Dispatching - Selects endpoints based on versions extracted from the URL path, headers, or request parameters.
• Data Validation Schemas - Enforces data constraints and required fields using a declarative parameter specification.
• Endpoint Routing - Maps incoming URL paths to specific logic handlers and endpoints.
• Request Middleware - Adds custom logic at specific points in the execution stack to modify the request-response flow.
• Type Coercion Utilities - Transforms input strings into specific data types or custom classes using defined parsing methods.
• API Parameter Validation - Implements advanced rules for input data, including mutual exclusivity and dependency between different parameters.
• Request Body Parsers - Processes incoming data based on the content-type using JSON, XML, or custom parsers.
• Query Parameter Validations - Implements strict constraints on query and request parameters using regular expressions and length limits.
• Parameter Coercion and Validation - Features a declarative system for coercing, validating, and filtering incoming request parameters using specific types and constraints.
• Middleware Pipelines - Inserts custom logic into the processing flow by implementing a base middleware class.
• Modular API Composition - Provides a modular architecture allowing large services to be constructed by nesting smaller API definitions.
• Request Middleware - Provides an interceptor stack for injecting custom logic into the request-response execution pipeline.
• Request Parameter Parsers - Provides a declarative system for defining required fields, types, and default values for incoming request data.
• Request Validation - Ensures incoming data meets specific type, presence, and format requirements before reaching business logic.
• Response Formatters - Converts output data into specified media types like JSON or XML using built-in or custom formatters.
• Response Formatting - Provides built-in mechanisms to convert output data into specified media types like JSON or XML using customizable formatters.
• REST API Frameworks - Offers a declarative Ruby framework for building structured HTTP endpoints that handle parameter validation and data serialization.
• REST Frameworks - Provides a comprehensive framework for building RESTful web services with integrated content negotiation and formatting.
• HTTP Routing - Directs incoming HTTP traffic to specific handlers based on the request method and path.
• HTTP Request Filtering - Includes mechanisms to intercept and filter incoming HTTP requests for authentication and logging purposes.
• Request Authentication Middleware - Protects API endpoints using built-in HTTP Basic authentication and customizable authentication middleware strategies.
• Error Mapping Strategies - Catches errors raised during execution and maps them to specific response handlers or generic errors.
• Nested API Definitions - Allows large services to be constructed by nesting smaller, modular API definitions.
• API Endpoint Metadata - Attaches metadata and security requirements to routes to create automatic documentation for users.
• Specification Generators - Uses endpoint metadata to automatically produce standardized, machine-readable API specifications.
• API Specification Generation - Uses endpoint metadata to automatically produce standardized, machine-readable API specifications for external consumers.
• Middleware Pipelines - Utilizes a middleware-based request pipeline to inject custom logic and filters into the HTTP execution flow.
• Response Header Modifiers - Provides utilities to set and merge HTTP response headers, including during error transitions.
• Content Negotiation - Determines the appropriate response format by matching request headers against supported media types.
• Custom Content Negotiators - Allows the definition of supported media types and configuration of custom parsers for non-standard input formats.
• Entity-Based Response Formatters - Implements a transformation layer to map internal Ruby objects to specific public attributes for consistent output.
• Entity-Based Response Formatting - Transforms raw objects into structured responses using representative entities to expose specific attributes.
• Error Response Mappers - Customizes the structure and content of error responses using a standardized response object.
• HTTP Content Negotiation - Determines the response format by interpreting the Accept header according to standard web specifications.
• Media Type Restrictions - Manages the media types a service accepts or produces to ensure compatible communication between clients.
• Request Lifecycle Hooks - Provides hooks to execute custom logic before or after endpoint processing to handle cross-cutting concerns.
• Request Parameter Filtering - Extracts only the explicitly defined parameters from a request while removing all undeclared data.
• API Development - Microframework for creating RESTful APIs.
• API Frameworks - A micro-framework for creating REST-like APIs in Ruby.
• Language Toolkits - Opinionated framework for creating REST-like APIs.

Star history