rust-ef 1.5.1

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

//! Compile-time entity registration via `inventory`.
//!
//! The `#[derive(EntityType)]` macro emits an `inventory::submit!` for each
//! entity type, registering a type-erased [`EntityRegistration`]. The
//! `DbContext` discovers these at runtime via
//! `inventory::iter::<EntityRegistration>()` (see `DbContext::discover_entities`).
//!
//! Similarly, `#[entity(T)]` applied to `impl IEntityTypeConfiguration<T>`
//! blocks emits an [`EntityConfigRegistration`], whose `apply_fn` is invoked by
//! `DbContext::discover_entities()` to apply Fluent API overrides to the
//! `ModelBuilder`.

use crate::metadata::EntityTypeMeta;
use crate::model_builder::ModelBuilder;
use std::any::TypeId;

/// Type-erased registration for an entity type.
///
/// Emitted automatically by `#[derive(EntityType)]`. Collected at link time
/// via `inventory::collect!`, so every entity type compiled into the final
/// binary is visible to `DbContext::discover_entities()`.
#[derive(Debug)]
pub struct EntityRegistration {
    pub type_id: TypeId,
    pub type_name: &'static str,
    pub meta_fn: fn() -> EntityTypeMeta,
    /// Which DbContext key this entity belongs to.
    /// `None` = default context; `Some("key")` = keyed context.
    /// Set by `#[context("key")]` on the entity struct.
    pub context_key: Option<&'static str>,
}

impl EntityRegistration {
    pub fn meta(&self) -> EntityTypeMeta {
        (self.meta_fn)()
    }
}

inventory::collect!(EntityRegistration);

/// Type-erased registration for an `IEntityTypeConfiguration<T>` impl block.
///
/// Emitted by the `#[entity(T)]` attribute macro. The `apply_fn`
/// instantiates the configuration via `Default::default()` and invokes
/// `IEntityTypeConfiguration::configure(&mut EntityTypeBuilder)` on a
/// freshly-borrowed `ModelBuilder`.
#[derive(Clone, Copy)]
pub struct EntityConfigRegistration {
    pub type_id: TypeId,
    pub type_name: &'static str,
    pub apply_fn: fn(&mut ModelBuilder),
    /// Which DbContext key this configuration applies to.
    /// `None` = default context; `Some("key")` = keyed context.
    /// Set by `#[entity(T, "key")]` attribute's optional second argument.
    pub context_key: Option<&'static str>,
}

impl std::fmt::Debug for EntityConfigRegistration {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        f.debug_struct("EntityConfigRegistration")
            .field("type_id", &self.type_id)
            .field("type_name", &self.type_name)
            .finish()
    }
}

inventory::collect!(EntityConfigRegistration);