test: poc openapi v3 codegen

As a start try to generate the same code as https://github.com/openebs/openapi-generator/blob/rust_mayastor/modules/openapi-generator/src/main/java/org/openapitools/codegen/languages/RustMayastorCodegen.java

Signed-off-by: Tiago Castro <[email protected]>

Cargo.toml

@@ -16,11 +16,15 @@ name = "paperclip"
 path = "src/bin/main.rs"
 required-features = ["cli"]
 
+
 [dependencies]
+ramhorns = { path = "../ramhorns/ramhorns", default-features = false }
+ramhorns-derive = { path = "../ramhorns/ramhorns-derive" }
+
+
 paperclip-actix = { path = "plugins/actix-web", version = "0.6.0", optional = true }
 paperclip-core = { path = "core", version = "0.6.0" }
 paperclip-macros = { path = "macros", version = "0.6.2", optional = true }
-
 env_logger = { version = "0.8", optional = true }
 git2 = { version = "0.15", optional = true }
 heck = { version = "0.4", optional = true }
@@ -40,7 +44,8 @@ url_dep = { version = ">=1.7,<3", package = "url" }
 thiserror = "1.0"
 anyhow = "1.0"
 once_cell = "1.4"
-openapiv3 = { version = "1.0.2", optional = true }
+#openapiv3 = { version = "1.0.2", optional = true }
+openapiv3 = { path = "../openapiv3", optional = true }
 indexmap = { version = "1.0", features = ["serde-1", "std"], optional = true }
 
 [dev-dependencies]
@@ -107,6 +112,7 @@ members = [
     "core",
     "macros",
     "plugins/actix-web",
+    "testgen"
 ]
 
 [[test]]

core/src/v2/mod.rs

@@ -24,9 +24,9 @@ pub use self::{
 pub use paperclip_macros::*;
 
 #[cfg(feature = "codegen")]
-use self::resolver::Resolver;
+pub(crate) use self::resolver::Resolver;
 #[cfg(feature = "codegen")]
-use crate::error::ValidationError;
+pub(crate) use crate::error::ValidationError;
 
 #[cfg(feature = "codegen")]
 impl<S: Schema + Default> ResolvableApi<S> {

core/src/v3/mod.rs

@@ -2,27 +2,8 @@
 //! Conversion traits and helps functions that help converting openapi v2 types to openapi v3.
 //! For the OpenAPI v3 types the crate `openapiv3` is used.
 
-mod contact;
-mod external_documentation;
-mod header;
-mod info;
-mod license;
-mod openapi;
-mod operation;
-mod parameter;
-mod paths;
-mod reference;
-mod request_body;
-mod response;
-mod schema;
-mod security_scheme;
-mod tag;
-
-use super::v2::{models as v2, models::Either};
-
-use parameter::non_body_parameter_to_v3_parameter;
-use reference::invalid_referenceor;
-use response::OperationEitherResponse;
+use super::v2::models as v2;
+mod models;
 
 /// Convert this crates openapi v2 (`DefaultApiRaw`) to `openapiv3::OpenAPI`
 pub fn openapiv2_to_v3(v2: v2::DefaultApiRaw) -> openapiv3::OpenAPI {

core/src/v3/models/mod.rs

@@ -0,0 +1,21 @@
+mod contact;
+mod external_documentation;
+mod header;
+mod info;
+mod license;
+mod openapi;
+mod operation;
+mod parameter;
+mod paths;
+mod reference;
+mod request_body;
+mod response;
+mod schema;
+mod security_scheme;
+mod tag;
+
+pub use super::super::v2::{models as v2, models::Either};
+
+use parameter::non_body_parameter_to_v3_parameter;
+use reference::invalid_referenceor;
+use response::OperationEitherResponse;

shell.nix

@@ -11,6 +11,7 @@ pkgs.mkShell {
     nixpkgs-fmt
     openssl
     pkg-config
+    libiconv
   ] ++ pkgs.lib.optional (!rustup) rust
   ++ pkgs.lib.optional (system == "aarch64-darwin") darwin.apple_sdk.frameworks.Security;
   shellHook = ''

src/bin/main.rs

@@ -26,6 +26,10 @@ fn parse_spec(s: &str) -> Result<ResolvableApi<DefaultSchema>, Error> {
     let fd = File::open(s)?;
     Ok(v2::from_reader(fd)?)
 }
+fn parse_spec_v3(s: &str) -> Result<openapiv3::OpenAPI, Error> {
+    let fd = File::open(s)?;
+    Ok(v2::from_reader_v3(fd)?)
+}
 
 #[derive(Debug)]
 enum OApiVersion {
@@ -36,8 +40,8 @@ enum OApiVersion {
 #[derive(Debug, StructOpt)]
 struct Opt {
     /// Path to OpenAPI spec in JSON/YAML format (also supports publicly accessible URLs).
-    #[structopt(parse(try_from_str = parse_spec))]
-    spec: ResolvableApi<DefaultSchema>,
+    #[structopt(long)]
+    spec: std::path::PathBuf,
     /// OpenAPI version (e.g., v2).
     #[structopt(long = "api", parse(try_from_str = parse_version))]
     api: OApiVersion,
@@ -47,6 +51,9 @@ struct Opt {
     /// Emit CLI target instead.
     #[structopt(long = "cli")]
     cli: bool,
+    /// Render.
+    #[structopt(long)]
+    models: bool,
     /// Do not make the crate a root crate.
     #[structopt(long = "no-root")]
     no_root: bool,
@@ -60,12 +67,15 @@ struct Opt {
 }
 
 fn parse_args_and_run() -> Result<(), Error> {
-    let opt = Opt::from_args();
+    let opt: Opt = Opt::from_args();
+
     if let OApiVersion::V3 = opt.api {
-        return Err(PaperClipError::UnsupportedOpenAPIVersion.into());
+        let spec = parse_spec_v3(&opt.spec.to_string_lossy().to_string())?;
+        paperclip::v3::OpenApiV3::new(spec, opt.output).run(opt.models)?;
+        return Ok(());
     }
 
-    let spec = opt.spec.resolve()?;
+    let spec = parse_spec(&opt.spec.to_string_lossy().to_string())?.resolve()?;
     let mut state = EmitterState::default();
 
     if let Some(o) = opt.output {

src/lib.rs

@@ -32,3 +32,6 @@ pub mod actix {
     #[cfg(feature = "actix4")]
     pub use paperclip_core::v2::HttpResponseWrapper;
 }
+
+#[cfg(feature = "openapiv3")]
+pub mod v3;

src/v2/mod.rs

@@ -133,3 +133,30 @@ where
     api.spec_format = fmt;
     Ok(api)
 }
+
+/// Deserialize the schema from the given reader. Currently, this only supports
+/// JSON and YAML formats.
+pub fn from_reader_v3<R>(mut reader: R) -> Result<openapiv3::OpenAPI, PaperClipError>
+where
+    R: Read,
+{
+    let mut buf = [b' '];
+    while buf[0].is_ascii_whitespace() {
+        reader.read_exact(&mut buf)?;
+    }
+    let reader = buf.as_ref().chain(reader);
+
+    let (api, _fmt) = if buf[0] == b'{' {
+        (
+            serde_json::from_reader::<_, openapiv3::OpenAPI>(reader)?,
+            SpecFormat::Json,
+        )
+    } else {
+        (
+            serde_yaml::from_reader::<_, openapiv3::OpenAPI>(reader)?,
+            SpecFormat::Yaml,
+        )
+    };
+
+    Ok(api)
+}