diesel-selectable-macro 1.0.0

A derivable `Serialize` macro that selects precise fields.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48

# diesel-selectable-macro

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

```rs
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:

```rs
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.