rust-ef 1.7.0

Rust Entity Framework - An EFCore-inspired ORM for Rust
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
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149

//! Cascade test entity definitions shared across cascade_save_*.rs test files.

use rust_ef::prelude::*;

// ── One-to-many entities ──
#[derive(Debug, Clone, EntityType)]
#[table("cascade_blogs")]
pub struct CascadeBlog {
    #[primary_key]
    #[auto_increment]
    pub blog_id: i32,
    #[required]
    pub url: String,
    #[navigation]
    pub posts: HasMany<CascadePost>,
}

#[derive(Debug, Clone, EntityType)]
#[table("cascade_posts")]
pub struct CascadePost {
    #[primary_key]
    #[auto_increment]
    pub post_id: i32,
    #[required]
    pub title: String,
    #[foreign_key(CascadeBlog)]
    pub blog_id: i32,
    #[navigation]
    pub blog: BelongsTo<CascadeBlog>,
}

// ── Self-referential entity ──
#[derive(Debug, Clone, EntityType)]
#[table("cascade_categories")]
pub struct CascadeCategory {
    #[primary_key]
    #[auto_increment]
    pub category_id: i32,
    #[required]
    pub name: String,
    #[foreign_key(CascadeCategory)]
    pub parent_id: i32,
    #[navigation]
    pub children: HasMany<CascadeCategory>,
}

// ── Many-to-many entities ──
#[derive(Debug, Clone, EntityType)]
#[table("cascade_students")]
pub struct CascadeStudent {
    #[primary_key]
    #[auto_increment]
    pub student_id: i32,
    #[required]
    pub name: String,
    #[navigation]
    pub courses: HasMany<CascadeCourse, CascadeEnrollment>,
}

#[derive(Debug, Clone, EntityType)]
#[table("cascade_courses")]
pub struct CascadeCourse {
    #[primary_key]
    #[auto_increment]
    pub course_id: i32,
    #[required]
    pub title: String,
}

#[derive(Debug, Clone, EntityType)]
#[table("cascade_enrollments")]
pub struct CascadeEnrollment {
    #[primary_key]
    #[auto_increment]
    pub enrollment_id: i32,
    #[foreign_key(CascadeStudent)]
    pub student_id: i32,
    #[foreign_key(CascadeCourse)]
    pub course_id: i32,
}

// ── Nested cascade entities (Blog → Post → Comment) ──
#[derive(Debug, Clone, EntityType)]
#[table("cascade_nest_blogs")]
pub struct CascadeNestBlog {
    #[primary_key]
    #[auto_increment]
    pub blog_id: i32,
    #[required]
    pub url: String,
    #[navigation]
    pub posts: HasMany<CascadeNestPost>,
}

#[derive(Debug, Clone, EntityType)]
#[table("cascade_nest_posts")]
pub struct CascadeNestPost {
    #[primary_key]
    #[auto_increment]
    pub post_id: i32,
    #[required]
    pub title: String,
    #[foreign_key(CascadeNestBlog)]
    pub blog_id: i32,
    #[navigation]
    pub blog: BelongsTo<CascadeNestBlog>,
    #[navigation]
    pub comments: HasMany<CascadeNestComment>,
}

#[derive(Debug, Clone, EntityType)]
#[table("cascade_nest_comments")]
pub struct CascadeNestComment {
    #[primary_key]
    #[auto_increment]
    pub comment_id: i32,
    #[required]
    pub text: String,
    #[foreign_key(CascadeNestPost)]
    pub post_id: i32,
}

// ── SetNull cascade entities (nullable FK + #[on_delete(SetNull)]) ──
#[derive(Debug, Clone, EntityType)]
#[table("cascade_optional_blogs")]
pub struct CascadeOptionalBlog {
    #[primary_key]
    #[auto_increment]
    pub blog_id: i32,
    #[required]
    pub url: String,
    #[navigation]
    #[on_delete(SetNull)]
    pub posts: HasMany<CascadeOptionalPost>,
}

#[derive(Debug, Clone, EntityType)]
#[table("cascade_optional_posts")]
pub struct CascadeOptionalPost {
    #[primary_key]
    #[auto_increment]
    pub post_id: i32,
    #[required]
    pub title: String,
    #[foreign_key(CascadeOptionalBlog)]
    pub blog_id: Option<i32>,
    #[navigation]
    pub blog: BelongsTo<CascadeOptionalBlog>,
}