#diesel #select #field #macro #table #struct-fields #selectable

macro diesel-selectable-macro

A derivable Serialize macro that selects precise fields

3 releases (1 stable)

1.0.0 Dec 21, 2022
0.3.0 Sep 23, 2022
0.2.0 Sep 23, 2022
0.1.0 Jun 30, 2022

#1956 in Procedural macros

MIT license

9KB
142 lines

diesel-selectable-macro

When inserting, Diesel allows you to derive the Insertable trait, which inserts keys by name:

use diesel::prelude::*;

#[derive(Insertable)]
#[diesel(table_name = users)]
struct User {
  email: String,
  password_hash: String,
  // There's another field, `phone`, but we are not writing it.
}

// later on...

fn write(user: User) -> QueryResult<usize> {
  diesel::insert_into(users::table).values(user).execute(conn)
}

This crate offers a similar derive trait for reading data. Diesel's Queryable trait reads by position rather than field name, but sometimes field name is more convenient:

use diesel::prelude::*;
use diesel_selectable_macro::Selectable;

#[derive(Queryable, Selectable)]
#[diesel(table_name = users)]
struct User {
  email: String,
  password_hash: String,
  // There's another field, `phone`, but we do not need to read it.
}

// later on...

fn read(email: String) -> QueryResult<User> {
  User::select().filter(crate::schema::users::email.eq(&email)).get_result(conn)
}

The automatically derived select method provides the explicit fields to Diesel, corresponding to the struct fields.

Dependencies

~2MB
~44K SLoC