diesel-rs/diesel
Diesel
This project is a type-safe database toolkit and object-relational mapper designed to enforce structural consistency between database schemas and application code. By leveraging compile-time validation, it ensures that SQL queries and data structures remain synchronized, preventing common errors before the application executes. It provides a comprehensive framework for relational data modeling, allowing developers to define table associations and map database results directly into strongly-typed language objects.
The library distinguishes itself through its focus on compile-time safety and automated schema management. It utilizes procedural macros to inspect database tables and generate corresponding code structures, eliminating the need for manual type definitions. Its expression-based query builder allows for the construction of complex, modular SQL statements that are automatically parameterized to mitigate security risks like SQL injection. Furthermore, the system supports extensive customization, enabling developers to register custom functions and operators or extend the query builder interface to accommodate specific database requirements.
Beyond its core mapping and validation capabilities, the toolkit provides a full suite of operations for managing data persistence. This includes support for batch insertions, relational joins, upsert operations, and the retrieval of related records. The library also handles the bidirectional transformation of data, automatically mapping application structures to database columns for updates and insertions while inferring return types for query results.
Comprehensive documentation and tooling are provided to assist with schema synchronization, ensuring that local code representations remain aligned with the underlying database throughout the development lifecycle.
Features
- Object-Relational Mappers - Maps relational database results into strongly-typed objects and manages complex table associations.
- Type-Safe Query Builders - Provides a type-safe database interaction layer that validates queries at compile time.
- Database Schema - Automatically derives type-safe code definitions from database schemas to ensure structural consistency.
- Database Schema Validators - Ensures SQL queries and data structures remain synchronized through compile-time validation.
- SQL Injection Prevention - Provides automated parameter binding for all database queries to prevent SQL injection vulnerabilities.
- Database ORMs - Acts as a type-safe database abstraction layer that ensures structural alignment between schemas and application models.
- Database Query Builders - Constructs SQL statements using a fluent, expression-based interface for secure and efficient database commands.
- Database Injection Prevention - Uses automated parameterization for all inputs to prevent SQL injection vulnerabilities.
- Procedural Macro Generators - Uses procedural macros to automatically generate type-safe structures from database tables.
- Row-to-Struct Mappers - Automatically maps database result rows to strongly-typed application objects.
- Database Schema Migrations - Maintains local code representations by automatically updating definitions when migrations are applied.
- Database Schema Definitions - Generates type-safe representations of database tables to keep application code synchronized with the schema.
- Relational Data Modeling - Provides a framework for defining table associations and mapping relational data to application structures.
- Table-to-Code Mappers - Defines type-safe structures for database tables to ensure compile-time query validation.
- Databases and Data Tools - Safe ORM and query builder for Rust.
- Database Query Execution - Executes constructed queries and maps results into native language structures.
- Database Relationship Mappings - Declares parent-child relationships between data models to enable automated foreign key mapping.
- Result Converters - Converts query results into typed data structures by matching database columns to object fields.
- Changeset Generators - Automatically generates update statements from data structures while handling optional values.
- Struct-to-Row Mappers - Enables type-safe insertion of records by mapping application structures to database columns.
- Query Composition - Enables modular and reusable SQL query construction through trait-based composition.
- Batch Insertion Interfaces - Supports efficient batch insertion of multiple records to reduce query overhead.
- Data Type Mappings - Defines column structures that enforce SQL type safety during query building and data conversion.
- Query Scopes - Encapsulates common filtering and expression logic into reusable query components.
- Database Query Joins - Constructs inner or left join queries to combine related data into single result sets.
- Query Builders - Extends the query builder DSL to support complex SQL patterns and custom operations.
- Record Updating - Enables type-safe modification of database rows using fluent query construction methods.
- Upsert Strategies - Handles record conflicts during write operations to ensure data consistency.
- Database Function Inference - Automatically infers return types for database expressions to simplify data retrieval.
- Model Persistence - Saves the state of identified records directly to the database by synchronizing fields with table rows.
- Inserted Record Retrievers - Returns values of newly created rows or specific columns immediately after an insertion operation.
- Single Record Retrievers - Retrieves child records for parents using efficient batching to prevent performance-degrading query patterns.
- Custom SQL Function Registrars - Allows registration of custom SQL functions with defined signatures for use in queries.
- Custom SQL Operator Registrars - Supports registration of custom SQL operators to extend query builder capabilities.
