Changelog

Author: tyt2y3

changelog/2.0.0-rc.35.md

@@ -21,16 +21,98 @@ Nested transactions correctly fall back to `SAVEPOINT` regardless of the mode.
 
 **Extend `DeriveIntoActiveModel`** (#2961)
 
-`DeriveIntoActiveModel` now supports `set`/`fill`, `default`, `ignore`, and `exhaustive` attributes for more control when converting "form" structs into ActiveModels:
+`DeriveIntoActiveModel` now supports `set`/`fill`, `default`, `ignore`, `skip`, `exhaustive`, and custom `active_model` path attributes for fine-grained control when converting "form" or "input" structs into ActiveModels.
+
+**`set` / `fill`** — always set fields not present on the struct:
+
+```rust
+#[derive(DeriveIntoActiveModel)]
+#[sea_orm(active_model = "fruit::ActiveModel", fill(cake_id = "None"))]
+struct NewFruit {
+    name: String,
+    // cake_id is not on the struct, but will always be Set(None)
+}
+
+NewFruit { name: "Apple".into() }.into_active_model()
+// => ActiveModel { id: NotSet, name: Set("Apple"), cake_id: Set(None) }
+```
+
+Multiple `set` entries can be combined or split across attributes:
+
+```rust
+#[derive(DeriveIntoActiveModel)]
+#[sea_orm(
+    active_model = "fruit::ActiveModel",
+    set(name = "String::from(\"cherry\")", cake_id = "None")
+)]
+struct IdOnlyFruit {
+    id: i32,
+}
+
+IdOnlyFruit { id: 1 }.into_active_model()
+// => ActiveModel { id: Set(1), name: Set("cherry"), cake_id: Set(None) }
+```
+
+**`default`** — fallback value when an `Option<T>` field is `None`:
+
+```rust
+#[derive(DeriveIntoActiveModel)]
+#[sea_orm(active_model = "fruit::ActiveModel")]
+struct NewFruit {
+    #[sea_orm(default = "String::from(\"Unnamed\")")]
+    name: Option<String>,
+}
+
+NewFruit { name: Some("Apple".into()) }.into_active_model()
+// => ActiveModel { id: NotSet, name: Set("Apple"), cake_id: NotSet }
+
+NewFruit { name: None }.into_active_model()
+// => ActiveModel { id: NotSet, name: Set("Unnamed"), cake_id: NotSet }
+```
+
+Bare `#[sea_orm(default)]` (without a value) uses `Default::default()` as the fallback. This also works with custom enum types that implement `Into<Option<T>>`.
+
+**`ignore` / `skip`** — exclude struct fields from the ActiveModel:
 
 ```rust
 #[derive(DeriveIntoActiveModel)]
-#[sea_orm(active_model = "fruit::ActiveModel", set(cake_id = "None"))]
+#[sea_orm(active_model = "fruit::ActiveModel")]
 struct NewFruit {
     name: String,
+    cake_id: i32,
+    #[sea_orm(ignore)]
+    _extra: String,  // not mapped to ActiveModel
+}
+```
+
+**`exhaustive`** — require all ActiveModel fields to be either on the struct or in `set(...)`:
+
+```rust
+#[derive(DeriveIntoActiveModel)]
+#[sea_orm(active_model = "fruit::ActiveModel", exhaustive, set(cake_id = "None"))]
+struct FullFruit {
+    id: i32,
+    name: String,
+    // cake_id is covered by set(...), so all fields are accounted for
+}
+```
+
+**Combining everything** — `set` + `default` + `ignore` + `exhaustive`:
+
+```rust
+#[derive(DeriveIntoActiveModel)]
+#[sea_orm(active_model = "fruit::ActiveModel", exhaustive, set(cake_id = "None"))]
+struct NewFruit {
+    id: i32,
     #[sea_orm(default = "String::from(\"Unnamed\")")]
-    optional_label: Option<String>,
+    name: Option<String>,
 }
+
+NewFruit { id: 1, name: Some("Apple".into()) }.into_active_model()
+// => ActiveModel { id: Set(1), name: Set("Apple"), cake_id: Set(None) }
+
+NewFruit { id: 2, name: None }.into_active_model()
+// => ActiveModel { id: Set(2), name: Set("Unnamed"), cake_id: Set(None) }
 ```
 
 **`IntoSimpleExpr` for `FunctionCall`** (#2822)