Add sample per PR request

Author: tanadeau

bin/configs/manual/rust-axum-array-params.yaml

@@ -0,0 +1,11 @@
+generatorName: rust-axum
+outputDir: samples/server/petstore/rust-axum/output/rust-axum-array-params-test
+inputSpec: modules/openapi-generator/src/test/resources/3_0/rust/rust-axum-array-params-test.yaml
+templateDir: modules/openapi-generator/src/main/resources/rust-axum
+generateAliasAsModel: true
+additionalProperties:
+  hideGenerationTimestamp: "true"
+  packageName: rust-axum-array-params-test
+globalProperties:
+  skipFormModel: false
+enablePostProcessFile: true

modules/openapi-generator/src/test/resources/3_0/rust/rust-axum-array-params-test.yaml

@@ -0,0 +1,24 @@
+openapi: 3.0.1
+info:
+  title: Test to check that array query params are rendered correctly.
+  version: 0.0.1
+paths:
+  /endpoint:
+    get:
+      description: Some endpoint.
+      parameters:
+        - name: numbers
+          in: query
+          description: Some numbers.
+          schema:
+            type: array
+            items:
+              type: number
+        - name: multiplier
+          in: query
+          description: Multipler for sum.
+          schema:
+            type: number  
+      responses:
+        '200':
+          description: OK.

samples/server/petstore/rust-axum/output/rust-axum-array-params-test/.gitignore

@@ -0,0 +1,2 @@
+target
+Cargo.lock

samples/server/petstore/rust-axum/output/rust-axum-array-params-test/.openapi-generator-ignore

@@ -0,0 +1,23 @@
+# OpenAPI Generator Ignore
+# Generated by openapi-generator https://github.com/openapitools/openapi-generator
+
+# Use this file to prevent files from being overwritten by the generator.
+# The patterns follow closely to .gitignore or .dockerignore.
+
+# As an example, the C# client generator defines ApiClient.cs.
+# You can make changes and tell OpenAPI Generator to ignore just this file by uncommenting the following line:
+#ApiClient.cs
+
+# You can match any string of characters against a directory, file or extension with a single asterisk (*):
+#foo/*/qux
+# The above matches foo/bar/qux and foo/baz/qux, but not foo/bar/baz/qux
+
+# You can recursively match patterns against a directory, file or extension with a double asterisk (**):
+#foo/**/qux
+# This matches foo/bar/qux, foo/baz/qux, and foo/bar/baz/qux
+
+# You can also negate patterns with an exclamation (!).
+# For example, you can ignore all files in a docs folder with the file extension .md:
+#docs/*.md
+# Then explicitly reverse the ignore rule for a single file:
+#!docs/README.md

samples/server/petstore/rust-axum/output/rust-axum-array-params-test/.openapi-generator/FILES

@@ -0,0 +1,11 @@
+.gitignore
+.openapi-generator-ignore
+Cargo.toml
+README.md
+src/apis/default.rs
+src/apis/mod.rs
+src/header.rs
+src/lib.rs
+src/models.rs
+src/server/mod.rs
+src/types.rs

samples/server/petstore/rust-axum/output/rust-axum-array-params-test/.openapi-generator/VERSION

@@ -0,0 +1 @@
+7.13.0-SNAPSHOT

samples/server/petstore/rust-axum/output/rust-axum-array-params-test/Cargo.toml

@@ -0,0 +1,46 @@
+[package]
+name = "rust-axum-array-params-test"
+version = "0.0.1"
+authors = ["OpenAPI Generator team and contributors"]
+description = "No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)"
+edition = "2021"
+
+[features]
+default = ["server"]
+server = []
+conversion = [
+    "frunk",
+    "frunk_derives",
+    "frunk_core",
+    "frunk-enum-core",
+    "frunk-enum-derive",
+]
+
+[dependencies]
+async-trait = "0.1"
+axum = { version = "0.8", features = ["multipart"] }
+axum-extra = { version = "0.10", features = ["cookie", "query"] }
+base64 = "0.22"
+bytes = "1"
+chrono = { version = "0.4", features = ["serde"] }
+frunk = { version = "0.4", optional = true }
+frunk-enum-core = { version = "0.3", optional = true }
+frunk-enum-derive = { version = "0.3", optional = true }
+frunk_core = { version = "0.4", optional = true }
+frunk_derives = { version = "0.4", optional = true }
+http = "1"
+lazy_static = "1"
+regex = "1"
+serde = { version = "1", features = ["derive"] }
+serde_html_form = "0.2"
+serde_json = { version = "1", features = ["raw_value"] }
+tokio = { version = "1", default-features = false, features = [
+    "signal",
+    "rt-multi-thread",
+] }
+tracing = { version = "0.1", features = ["attributes"] }
+uuid = { version = "1", features = ["serde"] }
+validator = { version = "0.20", features = ["derive"] }
+
+[dev-dependencies]
+tracing-subscriber = "0.3"

samples/server/petstore/rust-axum/output/rust-axum-array-params-test/README.md

@@ -0,0 +1,93 @@
+# Rust API for rust-axum-array-params-test
+
+No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+
+## Overview
+
+This server was generated by the [openapi-generator]
+(https://openapi-generator.tech) project. By using the
+[OpenAPI-Spec](https://github.com/OAI/OpenAPI-Specification) from a remote
+server, you can easily generate a server stub.
+
+To see how to make this your own, look here: [README]((https://openapi-generator.tech))
+
+- API version: 0.0.1
+- Generator version: 7.13.0-SNAPSHOT
+
+
+
+This autogenerated project defines an API crate `rust-axum-array-params-test` which contains:
+* An `Api` trait defining the API in Rust.
+* Data types representing the underlying data model.
+* Axum router which accepts HTTP requests and invokes the appropriate `Api` method for each operation.
+  * Request validations (path, query, body params) are included.
+
+## Using the generated library
+
+The generated library has a few optional features that can be activated through Cargo.
+
+* `server`
+    * This defaults to enabled and creates the basic skeleton of a server implementation based on Axum.
+    * To create the server stack you'll need to provide an implementation of the API trait to provide the server function.
+* `conversions`
+    * This defaults to disabled and creates extra derives on models to allow "transmogrification" between objects of structurally similar types.
+
+See https://doc.rust-lang.org/cargo/reference/manifest.html#the-features-section for how to use features in your `Cargo.toml`.
+
+### Example
+
+```rust
+struct ServerImpl {
+   // database: sea_orm::DbConn,
+}
+
+#[allow(unused_variables)]
+#[async_trait]
+impl rust_axum_array_params_test::apis::default::Api for ServerImpl {
+  // API implementation goes here
+}
+
+impl rust_axum_array_params_test::apis::ErrorHandler for ServerImpl {}
+
+pub async fn start_server(addr: &str) {
+    // initialize tracing
+    tracing_subscriber::fmt::init();
+
+    // Init Axum router
+    let app = rust_axum_array_params_test::server::new(Arc::new(ServerImpl));
+
+    // Add layers to the router
+    let app = app.layer(...);
+
+    // Run the server with graceful shutdown
+    let listener = TcpListener::bind(addr).await.unwrap();
+    axum::serve(listener, app)
+        .with_graceful_shutdown(shutdown_signal())
+        .await
+        .unwrap();
+}
+
+async fn shutdown_signal() {
+    let ctrl_c = async {
+        signal::ctrl_c()
+            .await
+            .expect("failed to install Ctrl+C handler");
+    };
+
+    #[cfg(unix)]
+    let terminate = async {
+        signal::unix::signal(signal::unix::SignalKind::terminate())
+            .expect("failed to install signal handler")
+            .recv()
+            .await;
+    };
+
+    #[cfg(not(unix))]
+    let terminate = std::future::pending::<()>();
+
+    tokio::select! {
+        _ = ctrl_c => {},
+        _ = terminate => {},
+    }
+}
+```

samples/server/petstore/rust-axum/output/rust-axum-array-params-test/src/apis/default.rs

@@ -0,0 +1,30 @@
+use async_trait::async_trait;
+use axum::extract::*;
+use axum_extra::extract::{CookieJar, Host};
+use bytes::Bytes;
+use http::Method;
+use serde::{Deserialize, Serialize};
+
+use crate::{models, types::*};
+
+#[derive(Debug, PartialEq, Serialize, Deserialize)]
+#[must_use]
+#[allow(clippy::large_enum_variant)]
+pub enum EndpointGetResponse {
+    /// OK.
+    Status200_OK,
+}
+
+/// Default
+#[async_trait]
+#[allow(clippy::ptr_arg)]
+pub trait Default<E: std::fmt::Debug + Send + Sync + 'static = ()>: super::ErrorHandler<E> {
+    /// EndpointGet - GET /endpoint
+    async fn endpoint_get(
+        &self,
+        method: &Method,
+        host: &Host,
+        cookies: &CookieJar,
+        query_params: &models::EndpointGetQueryParams,
+    ) -> Result<EndpointGetResponse, E>;
+}

samples/server/petstore/rust-axum/output/rust-axum-array-params-test/src/apis/mod.rs

@@ -0,0 +1,21 @@
+pub mod default;
+
+// Error handler for unhandled errors.
+#[async_trait::async_trait]
+pub trait ErrorHandler<E: std::fmt::Debug + Send + Sync + 'static = ()> {
+    #[allow(unused_variables)]
+    #[tracing::instrument(skip_all)]
+    async fn handle_error(
+        &self,
+        method: &::http::Method,
+        host: &axum_extra::extract::Host,
+        cookies: &axum_extra::extract::CookieJar,
+        error: E,
+    ) -> Result<axum::response::Response, http::StatusCode> {
+        tracing::error!("Unhandled error: {:?}", error);
+        axum::response::Response::builder()
+            .status(http::StatusCode::INTERNAL_SERVER_ERROR)
+            .body(axum::body::Body::empty())
+            .map_err(|_| http::StatusCode::INTERNAL_SERVER_ERROR)
+    }
+}