caisin/sea-orm
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Merge pull request #121 from SeaQL/fmt-doc-comments

Browse Source 
cargo fmt doc comments
This commit is contained in:
Billy Chan 2021-09-03 15:00:38 +08:00 committed by GitHub
commit aa15c44942
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
7 changed files with 87 additions and 70 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
rustfmt.toml Normal file
View File

@ -0,0 +1 @@
format_code_in_doc_comments=true

18
src/entity/base_entity.rs
View File

@ -138,12 +138,17 @@ pub trait EntityTrait: EntityName {
/// db.into_transaction_log(), /// db.into_transaction_log(),
/// vec![ /// vec![
/// Transaction::from_sql_and_values( /// Transaction::from_sql_and_values(
/// DbBackend::Postgres, r#"SELECT "cake"."id", "cake"."name" FROM "cake" LIMIT $1"#, vec![1u64.into()] /// DbBackend::Postgres,
/// r#"SELECT "cake"."id", "cake"."name" FROM "cake" LIMIT $1"#,
/// vec![1u64.into()]
/// ), /// ),
/// Transaction::from_sql_and_values( /// Transaction::from_sql_and_values(
/// DbBackend::Postgres, r#"SELECT "cake"."id", "cake"."name" FROM "cake""#, vec![] /// DbBackend::Postgres,
/// r#"SELECT "cake"."id", "cake"."name" FROM "cake""#,
/// vec![]
/// ), /// ),
/// ]); /// ]
/// );
/// ``` /// ```
fn find() -> Select<Self> { fn find() -> Select<Self> {
Select::new() Select::new()
@ -186,8 +191,11 @@ pub trait EntityTrait: EntityName {
/// assert_eq!( /// assert_eq!(
/// db.into_transaction_log(), /// db.into_transaction_log(),
/// vec![Transaction::from_sql_and_values( /// vec![Transaction::from_sql_and_values(
/// DbBackend::Postgres, r#"SELECT "cake"."id", "cake"."name" FROM "cake" WHERE "cake"."id" = $1"#, vec![11i32.into()] /// DbBackend::Postgres,
/// )]); /// r#"SELECT "cake"."id", "cake"."name" FROM "cake" WHERE "cake"."id" = $1"#,
/// vec![11i32.into()]
/// )]
/// );
/// ``` /// ```
/// Find by composite key /// Find by composite key
/// ``` /// ```

70
src/executor/select.rs
View File

@ -290,11 +290,12 @@ where
/// ///
/// # let _: Result<(), DbErr> = smol::block_on(async { /// # let _: Result<(), DbErr> = smol::block_on(async {
/// # /// #
/// let res: Vec<SelectResult> = cake::Entity::find().from_raw_sql( /// let res: Vec<SelectResult> = cake::Entity::find()
/// Statement::from_sql_and_values( /// .from_raw_sql(Statement::from_sql_and_values(
/// DbBackend::Postgres, r#"SELECT "cake"."name", count("cake"."id") AS "num_of_cakes" FROM "cake""#, vec![] /// DbBackend::Postgres,
/// ) /// r#"SELECT "cake"."name", count("cake"."id") AS "num_of_cakes" FROM "cake""#,
/// ) /// vec![],
/// ))
/// .into_model::<SelectResult>() /// .into_model::<SelectResult>()
/// .all(&db) /// .all(&db)
/// .await?; /// .await?;
@ -318,11 +319,12 @@ where
/// ///
/// assert_eq!( /// assert_eq!(
/// db.into_transaction_log(), /// db.into_transaction_log(),
/// vec![ /// vec![Transaction::from_sql_and_values(
/// Transaction::from_sql_and_values( /// DbBackend::Postgres,
/// DbBackend::Postgres, r#"SELECT "cake"."name", count("cake"."id") AS "num_of_cakes" FROM "cake""#, vec![] /// r#"SELECT "cake"."name", count("cake"."id") AS "num_of_cakes" FROM "cake""#,
/// ), /// vec![]
/// ]); /// ),]
/// );
/// ``` /// ```
pub fn into_model<M>(self) -> SelectorRaw<SelectModel<M>> pub fn into_model<M>(self) -> SelectorRaw<SelectModel<M>>
where where
@ -407,22 +409,26 @@ where
/// ///
/// # let _: Result<(), DbErr> = smol::block_on(async { /// # let _: Result<(), DbErr> = smol::block_on(async {
/// # /// #
/// let _: Option<cake::Model> = cake::Entity::find().from_raw_sql( /// let _: Option<cake::Model> = cake::Entity::find()
/// Statement::from_sql_and_values( /// .from_raw_sql(Statement::from_sql_and_values(
/// DbBackend::Postgres, r#"SELECT "cake"."id", "cake"."name" FROM "cake" WHERE "id" = $1"#, vec![1.into()] /// DbBackend::Postgres,
/// ) /// r#"SELECT "cake"."id", "cake"."name" FROM "cake" WHERE "id" = $1"#,
/// ).one(&db).await?; /// vec![1.into()],
/// ))
/// .one(&db)
/// .await?;
/// # /// #
/// # Ok(()) /// # Ok(())
/// # }); /// # });
/// ///
/// assert_eq!( /// assert_eq!(
/// db.into_transaction_log(), /// db.into_transaction_log(),
/// vec![ /// vec![Transaction::from_sql_and_values(
/// Transaction::from_sql_and_values( /// DbBackend::Postgres,
/// DbBackend::Postgres, r#"SELECT "cake"."id", "cake"."name" FROM "cake" WHERE "id" = $1"#, vec![1.into()] /// r#"SELECT "cake"."id", "cake"."name" FROM "cake" WHERE "id" = $1"#,
/// ), /// vec![1.into()]
/// ]); /// ),]
/// );
/// ``` /// ```
pub async fn one(self, db: &DatabaseConnection) -> Result<Option<S::Item>, DbErr> { pub async fn one(self, db: &DatabaseConnection) -> Result<Option<S::Item>, DbErr> {
let row = db.query_one(self.stmt).await?; let row = db.query_one(self.stmt).await?;
@ -442,22 +448,26 @@ where
/// ///
/// # let _: Result<(), DbErr> = smol::block_on(async { /// # let _: Result<(), DbErr> = smol::block_on(async {
/// # /// #
/// let _: Vec<cake::Model> = cake::Entity::find().from_raw_sql( /// let _: Vec<cake::Model> = cake::Entity::find()
/// Statement::from_sql_and_values( /// .from_raw_sql(Statement::from_sql_and_values(
/// DbBackend::Postgres, r#"SELECT "cake"."id", "cake"."name" FROM "cake""#, vec![] /// DbBackend::Postgres,
/// ) /// r#"SELECT "cake"."id", "cake"."name" FROM "cake""#,
/// ).all(&db).await?; /// vec![],
/// ))
/// .all(&db)
/// .await?;
/// # /// #
/// # Ok(()) /// # Ok(())
/// # }); /// # });
/// ///
/// assert_eq!( /// assert_eq!(
/// db.into_transaction_log(), /// db.into_transaction_log(),
/// vec![ /// vec![Transaction::from_sql_and_values(
/// Transaction::from_sql_and_values( /// DbBackend::Postgres,
/// DbBackend::Postgres, r#"SELECT "cake"."id", "cake"."name" FROM "cake""#, vec![] /// r#"SELECT "cake"."id", "cake"."name" FROM "cake""#,
/// ), /// vec![]
/// ]); /// ),]
/// );
/// ``` /// ```
pub async fn all(self, db: &DatabaseConnection) -> Result<Vec<S::Item>, DbErr> { pub async fn all(self, db: &DatabaseConnection) -> Result<Vec<S::Item>, DbErr> {
let rows = db.query_all(self.stmt).await?; let rows = db.query_all(self.stmt).await?;

6
src/lib.rs
View File

@ -77,10 +77,8 @@
//! let fruits: Vec<fruit::Model> = cheese.find_related(Fruit).all(db).await?; //! let fruits: Vec<fruit::Model> = cheese.find_related(Fruit).all(db).await?;
//! //!
//! // find related models (eager) //! // find related models (eager)
//! let cake_with_fruits: Vec<(cake::Model, Vec<fruit::Model>)> = Cake::find() //! let cake_with_fruits: Vec<(cake::Model, Vec<fruit::Model>)> =
//! .find_with_related(Fruit) //! Cake::find().find_with_related(Fruit).all(db).await?;
//! .all(db)
//! .await?;
//! //!
//! # Ok(()) //! # Ok(())
//! # } //! # }

2
src/query/update.rs
View File

@ -59,7 +59,7 @@ impl Update {
/// Update many ActiveModel /// Update many ActiveModel
/// ///
/// ``` /// ```
/// use sea_orm::{entity::*, query::*, tests_cfg::fruit, sea_query::Expr, DbBackend}; /// use sea_orm::{entity::*, query::*, sea_query::Expr, tests_cfg::fruit, DbBackend};
/// ///
/// assert_eq!( /// assert_eq!(
/// Update::many(fruit::Entity) /// Update::many(fruit::Entity)