Init open-api with an example. (#290)

Cargo.toml

@@ -29,6 +29,7 @@ log = "0.4.14"
 nix = "0.20.0"
 num_enum = "0.5.1"
 orchestra = { git = "https://github.com/fluidex/orchestra.git", branch = "master", features = [ "exchange" ] }
+paperclip = { git = "https://github.com/fluidex/paperclip.git", features = ["actix"] }
 qstring = "0.7.2"
 rand = "0.8.3"
 serde = { version = "1.0.124", features = [ "derive" ] }
@@ -42,6 +43,10 @@ tracing-appender = "0.1"
 tracing-subscriber = "0.2"
 ttl_cache = "0.5.1"
 
+[[bin]]
+name = "openapi"
+path = "src/bin/openapi.rs"
+
 [[bin]]
 name = "restapi"
 path = "src/bin/restapi.rs"

src/bin/openapi.rs

@@ -0,0 +1,32 @@
+use actix_web::{App, HttpServer};
+use paperclip::actix::{
+    api_v2_operation,
+    web::{self, Json},
+    Apiv2Schema, OpenApiExt,
+};
+use serde::{Deserialize, Serialize};
+
+#[derive(Serialize, Deserialize, Apiv2Schema)]
+struct Pet {
+    name: String,
+    id: Option<i64>,
+}
+
+#[api_v2_operation]
+async fn echo_pet(body: Json<Pet>) -> Result<Json<Pet>, actix_web::Error> {
+    Ok(body)
+}
+
+#[actix_web::main]
+async fn main() -> std::io::Result<()> {
+    HttpServer::new(|| {
+        App::new()
+            .wrap_api()
+            .service(web::resource("/pets").route(web::post().to(echo_pet)))
+            .with_json_spec_at("/api/spec")
+            .build()
+    })
+    .bind("0.0.0.0:50054")?
+    .run()
+    .await
+}