Add salvo example (#908)

* Add salvo example

* cargo clippy

* bug fix

README.md

@@ -37,6 +37,7 @@ Integration examples
 + [GraphQL Example](https:/SeaQL/sea-orm/tree/master/examples/graphql_example)
 + [jsonrpsee Example](https:/SeaQL/sea-orm/tree/master/examples/jsonrpsee_example)
 + [Tonic Example](https:/SeaQL/sea-orm/tree/master/examples/tonic_example)
++ [Salvo Example](https:/SeaQL/sea-orm/tree/master/examples/salvo_example)
 
 ## Features
 

examples/salvo_example/.env

@@ -0,0 +1,4 @@
+HOST=127.0.0.1
+PORT=8000
+#DATABASE_URL="mysql://root:@localhost/poem_example"
+DATABASE_URL="sqlite::memory:"

examples/salvo_example/Cargo.toml

@@ -0,0 +1,29 @@
+[package]
+name = "sea-orm-salvo-example"
+version = "0.1.0"
+edition = "2021"
+
+# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
+[workspace]
+members = [".", "entity", "migration"]
+
+[dependencies]
+tokio = { version = "1.15.0", features = ["macros", "rt-multi-thread"] }
+salvo = { version = "0.27", features = ["affix", "serve-static"] }
+tracing-subscriber = { version = "0.3", features = ["env-filter"] }
+serde = { version = "1", features = ["derive"] }
+tera = "1.8.0"
+dotenv = "0.15"
+entity = { path = "entity" }
+migration = { path = "migration" }
+
+[dependencies.sea-orm]
+path = "../../" # remove this line in your own project
+version = "^0.9.1" # sea-orm version
+features = [
+ "debug-print",
+ "runtime-tokio-native-tls",
+ "sqlx-sqlite",
+ # "sqlx-postgres",
+ # "sqlx-mysql",
+]

examples/salvo_example/README.md

@@ -0,0 +1,11 @@
+![screenshot](Screenshot.png)
+
+# Poem with SeaORM example app
+
+1. Modify the `DATABASE_URL` var in `.env` to point to your chosen database
+
+1. Turn on the appropriate database feature for your chosen db in `Cargo.toml` (the `"sqlx-sqlite",` line)
+
+1. Execute `cargo run` to start the server
+
+1. Visit [localhost:8000](http://localhost:8000) in browser after seeing the `server started` line

examples/salvo_example/entity/Cargo.toml

@@ -0,0 +1,16 @@
+[package]
+name = "entity"
+version = "0.1.0"
+edition = "2021"
+publish = false
+
+[lib]
+name = "entity"
+path = "src/lib.rs"
+
+[dependencies]
+serde = { version = "1", features = ["derive"] }
+
+[dependencies.sea-orm]
+path = "../../../" # remove this line in your own project
+version = "^0.9.1" # sea-orm version

examples/salvo_example/entity/src/lib.rs

@@ -0,0 +1 @@
+pub mod post;

examples/salvo_example/entity/src/post.rs

@@ -0,0 +1,18 @@
+use sea_orm::entity::prelude::*;
+use serde::{Deserialize, Serialize};
+
+#[derive(Clone, Debug, PartialEq, DeriveEntityModel, Deserialize, Serialize)]
+#[sea_orm(table_name = "posts")]
+pub struct Model {
+ #[sea_orm(primary_key)]
+ #[serde(skip_deserializing)]
+ pub id: i32,
+ pub title: String,
+ #[sea_orm(column_type = "Text")]
+ pub text: String,
+}
+
+#[derive(Copy, Clone, Debug, EnumIter, DeriveRelation)]
+pub enum Relation {}
+
+impl ActiveModelBehavior for ActiveModel {}

examples/salvo_example/migration/Cargo.toml

@@ -0,0 +1,21 @@
+[package]
+name = "migration"
+version = "0.1.0"
+edition = "2021"
+publish = false
+
+[lib]
+name = "migration"
+path = "src/lib.rs"
+
+[dependencies]
+async-std = { version = "^1", features = ["attributes", "tokio1"] }
+
+[dependencies.sea-orm-migration]
+path = "../../../sea-orm-migration" # remove this line in your own project
+version = "^0.9.1" # sea-orm-migration version
+features = [
+ # Enable following runtime and db backend features if you want to run migration via CLI
+ # "runtime-tokio-native-tls",
+ # "sqlx-sqlite",
+]

examples/salvo_example/migration/README.md

@@ -0,0 +1,37 @@
+# Running Migrator CLI
+
+- Apply all pending migrations
+ ```sh
+ cargo run
+ ```
+ ```sh
+ cargo run -- up
+ ```
+- Apply first 10 pending migrations
+ ```sh
+ cargo run -- up -n 10
+ ```
+- Rollback last applied migrations
+ ```sh
+ cargo run -- down
+ ```
+- Rollback last 10 applied migrations
+ ```sh
+ cargo run -- down -n 10
+ ```
+- Drop all tables from the database, then reapply all migrations
+ ```sh
+ cargo run -- fresh
+ ```
+- Rollback all applied migrations, then reapply all migrations
+ ```sh
+ cargo run -- refresh
+ ```
+- Rollback all applied migrations
+ ```sh
+ cargo run -- reset
+ ```
+- Check the status of all migrations
+ ```sh
+ cargo run -- status
+ ```

examples/salvo_example/migration/src/lib.rs

@@ -0,0 +1,12 @@
+pub use sea_orm_migration::prelude::*;
+
+mod m20220120_000001_create_post_table;
+
+pub struct Migrator;
+
+#[async_trait::async_trait]
+impl MigratorTrait for Migrator {
+ fn migrations() -> Vec<Box<dyn MigrationTrait>> {
+ vec![Box::new(m20220120_000001_create_post_table::Migration)]
+ }
+}

examples/salvo_example/migration/src/m20220120_000001_create_post_table.rs

@@ -0,0 +1,42 @@
+use sea_orm_migration::prelude::*;
+
+#[derive(DeriveMigrationName)]
+pub struct Migration;
+
+#[async_trait::async_trait]
+impl MigrationTrait for Migration {
+ async fn up(&self, manager: &SchemaManager) -> Result<(), DbErr> {
+ manager
+ .create_table(
+ Table::create()
+ .table(Posts::Table)
+ .if_not_exists()
+ .col(
+ ColumnDef::new(Posts::Id)
+ .integer()
+ .not_null()
+ .auto_increment()
+ .primary_key(),
+ )
+ .col(ColumnDef::new(Posts::Title).string().not_null())
+ .col(ColumnDef::new(Posts::Text).string().not_null())
+ .to_owned(),
+ )
+ .await
+ }
+
+ async fn down(&self, manager: &SchemaManager) -> Result<(), DbErr> {
+ manager
+ .drop_table(Table::drop().table(Posts::Table).to_owned())
+ .await
+ }
+}
+
+/// Learn more at https://docs.rs/sea-query#iden
+#[derive(Iden)]
+enum Posts {
+ Table,
+ Id,
+ Title,
+ Text,
+}

examples/salvo_example/migration/src/main.rs

@@ -0,0 +1,6 @@
+use sea_orm_migration::prelude::*;
+
+#[async_std::main]
+async fn main() {
+ cli::run_cli(migration::Migrator).await;
+}