Skip to main content

rust_ef/
lib.rs

1//! # Rust Entity Framework (rust-ef)
2//!
3//! An EFCore-inspired ORM for Rust, bringing the familiar
4//! DbContext/DbSet/EntityType patterns to the Rust ecosystem.
5//!
6//! ## Example
7//!
8//! ```rust,ignore
9//! use rust_ef::prelude::*;
10//!
11//! #[derive(EntityType)]
12//! #[table("blogs")]
13//! pub struct Blog {
14//!     #[primary_key]
15//!     #[auto_increment]
16//!     pub blog_id: i32,
17//!     #[required]
18//!     #[max_length(200)]
19//!     pub url: String,
20//!     pub rating: i32,
21//!     #[navigation]
22//!     pub posts: HasMany<Post>,
23//! }
24//! ```
25
26pub mod cascade;
27pub mod change_executor;
28pub mod db_context;
29pub mod db_set;
30pub mod dependency_graph;
31pub mod di;
32pub mod entity;
33pub mod entity_snapshot;
34pub mod error;
35pub mod interceptor;
36pub mod lazy;
37pub mod metadata;
38pub(crate) mod metadata_cache;
39pub mod migration;
40pub mod model_builder;
41pub mod navigation_loader;
42pub mod observability;
43pub mod provider;
44pub mod query;
45pub mod registration;
46pub mod relations;
47pub mod tracking;
48pub mod transaction;
49
50pub use async_trait;
51
52pub use inventory;
53
54pub use rust_ef_macros::{column, entity, linq, EntityType};
55
56/// Re-exports of the most commonly used types.
57pub mod prelude {
58    pub use crate::db_context::{
59        DbContext, DbContextOptions, DbContextOptionsBuilder, SaveChangesResult,
60    };
61    pub use crate::db_set::{DbSet, IDbSet};
62    pub use crate::di::DbContextServiceCollectionExt;
63    pub use crate::entity::{
64        EntityState, IEntitySnapshot, IEntityType, IFromRow, IGetKeyValues, ILazyInit,
65        INavigationSetter,
66    };
67    pub use crate::entity_snapshot::EntitySnapshot;
68    pub use crate::error::{EFError, EFErrorCode, EFResult};
69    pub use crate::interceptor::{
70        ISaveChangesInterceptor, SaveChangesContext, SaveChangesResultContext,
71    };
72    pub use crate::lazy::{LazyContext, LazyContextImpl, MAX_LAZY_DEPTH};
73    pub use crate::metadata::EntityTypeMeta;
74    pub use crate::metadata::NavigationMeta;
75    pub use crate::metadata::PropertyMeta;
76    pub use crate::model_builder::{
77        EntityTypeBuilder, IEntityTypeConfiguration, ModelBuilder, PropertyBuilder,
78    };
79    pub use crate::provider::DbValue;
80    pub use crate::provider::IDatabaseProvider;
81    pub use crate::provider::IsolationLevel;
82    pub use crate::query::{
83        BoolExpr, CteSpec, LinqSource, SetOpSpec, SetOperator, WindowFuncKind, WindowSpec,
84    };
85    pub use crate::registration::{EntityConfigRegistration, EntityRegistration};
86    pub use crate::relations::{BelongsTo, DeleteBehavior, HasMany, HasOne};
87    pub use crate::tracking::ChangeTracker;
88    pub use crate::transaction::{DbTransaction, ITransaction};
89    pub use rust_ef_macros::column;
90    pub use rust_ef_macros::entity;
91    pub use rust_ef_macros::linq;
92    pub use rust_ef_macros::EntityType;
93}