Further tweaks to rust-server HTTPS feature flagging

Author: dsteeley

modules/openapi-generator/src/main/resources/rust-server/Cargo.mustache

@@ -32,7 +32,7 @@ homepage = "{{.}}"
 {{/homePageUrl}}
 
 [features]
-default = ["client", "server"]
+default = ["client", "server", "client-tls"]
 client = [
 {{#apiUsesMultipartFormData}}
     "multipart", "multipart/client", "swagger/multipart_form",
@@ -172,13 +172,15 @@ clap = "4.5"
 env_logger = "0.11"
 tokio = { version = "1.49", features = ["full"] }
 native-tls = "0.2"
-openssl = "0.10"
-tokio-openssl = "0.6"
 pin-project = "1.1.10"
 
 # Bearer authentication, used in examples
 jsonwebtoken = {version = "10.0.0", features = ["rust_crypto"]}
 
+[target.'cfg(not(any(target_os = "macos", target_os = "windows", target_os = "ios")))'.dev-dependencies]
+openssl = "0.10"
+tokio-openssl = "0.6"
+
 [[example]]
 name = "client"
 required-features = ["client"]

modules/openapi-generator/src/main/resources/rust-server/README.mustache

@@ -139,13 +139,13 @@ The generated library has a few optional features that can be activated through
     * This defaults to disabled and allows JSON Schema validation of received data using `MakeService::set_validation` or `Service::set_validation`.
     * Note, enabling validation will have a performance penalty, especially if the API heavily uses regex based checks.
 
-### Enabling HTTPS/TLS Support
+### HTTPS/TLS Support
 
-By default, only HTTP support is included. To enable HTTPS, add the `client-tls` feature:
+HTTPS support is included by default. To disable it (for example, to reduce dependencies), you can:
 
 ```toml
 [dependencies]
-{{{packageName}}} = { version = "{{{packageVersion}}}", features = ["client-tls"] }
+{{{packageName}}} = { version = "{{{packageVersion}}}", default-features = false, features = ["client", "server"] }
 ```
 
 **For server with callbacks that need HTTPS:**
@@ -158,8 +158,6 @@ The TLS backend is automatically selected based on your target platform:
 - **macOS, Windows, iOS**: Uses `native-tls` (system TLS libraries)
 - **Linux, Unix, other platforms**: Uses `openssl`
 
-This ensures the best compatibility and native integration on each platform.
-
 See https://doc.rust-lang.org/cargo/reference/manifest.html#the-features-section for how to use features in your `Cargo.toml`.
 
 ## Documentation for API Endpoints

modules/openapi-generator/src/main/resources/rust-server/client-mod.mustache

@@ -241,7 +241,7 @@ impl<C> Client<
 > where
     C: Clone + Send + Sync + 'static
 {
-    /// Create a client with a TLS connection to the server using native-tls.
+    /// Create a client with a TLS connection to the server.
     ///
     /// # Arguments
     /// * `base_path` - base path of the client API, i.e. "<https://www.my-api-implementation.com>"
@@ -255,7 +255,7 @@ impl<C> Client<
         Self::try_new_with_connector(base_path, Some("https"), https_connector)
     }
 
-    /// Create a client with a TLS connection to the server using OpenSSL.
+    /// Create a client with a TLS connection to the server using OpenSSL via swagger.
     ///
     /// # Arguments
     /// * `base_path` - base path of the client API, i.e. "<https://www.my-api-implementation.com>"
@@ -269,7 +269,7 @@ impl<C> Client<
         Self::try_new_with_connector(base_path, Some("https"), https_connector)
     }
 
-    /// Create a client with a TLS connection to the server using a pinned certificate
+    /// Create a client with a TLS connection to the server using a pinned certificate.
     ///
     /// # Arguments
     /// * `base_path` - base path of the client API, i.e. "<https://www.my-api-implementation.com>"

samples/server/petstore/rust-server/output/multipart-v3/Cargo.toml

@@ -8,7 +8,7 @@ license = "Unlicense"
 edition = "2018"
 
 [features]
-default = ["client", "server"]
+default = ["client", "server", "client-tls"]
 client = [
     "multipart", "multipart/client", "swagger/multipart_form",
     "mime_multipart", "swagger/multipart_related",
@@ -105,13 +105,15 @@ clap = "4.5"
 env_logger = "0.11"
 tokio = { version = "1.49", features = ["full"] }
 native-tls = "0.2"
-openssl = "0.10"
-tokio-openssl = "0.6"
 pin-project = "1.1.10"
 
 # Bearer authentication, used in examples
 jsonwebtoken = {version = "10.0.0", features = ["rust_crypto"]}
 
+[target.'cfg(not(any(target_os = "macos", target_os = "windows", target_os = "ios")))'.dev-dependencies]
+openssl = "0.10"
+tokio-openssl = "0.6"
+
 [[example]]
 name = "client"
 required-features = ["client"]

samples/server/petstore/rust-server/output/multipart-v3/README.md

@@ -124,13 +124,13 @@ The generated library has a few optional features that can be activated through
     * This defaults to disabled and allows JSON Schema validation of received data using `MakeService::set_validation` or `Service::set_validation`.
     * Note, enabling validation will have a performance penalty, especially if the API heavily uses regex based checks.
 
-### Enabling HTTPS/TLS Support
+### HTTPS/TLS Support
 
-By default, only HTTP support is included. To enable HTTPS, add the `client-tls` feature:
+HTTPS support is included by default. To disable it (for example, to reduce dependencies), you can:
 
 ```toml
 [dependencies]
-multipart-v3 = { version = "1.0.7", features = ["client-tls"] }
+multipart-v3 = { version = "1.0.7", default-features = false, features = ["client", "server"] }
 ```
 
 **For server with callbacks that need HTTPS:**
@@ -143,8 +143,6 @@ The TLS backend is automatically selected based on your target platform:
 - **macOS, Windows, iOS**: Uses `native-tls` (system TLS libraries)
 - **Linux, Unix, other platforms**: Uses `openssl`
 
-This ensures the best compatibility and native integration on each platform.
-
 See https://doc.rust-lang.org/cargo/reference/manifest.html#the-features-section for how to use features in your `Cargo.toml`.
 
 ## Documentation for API Endpoints

samples/server/petstore/rust-server/output/multipart-v3/src/client/mod.rs

@@ -283,7 +283,7 @@ impl<C> Client<
 > where
     C: Clone + Send + Sync + 'static
 {
-    /// Create a client with a TLS connection to the server using native-tls.
+    /// Create a client with a TLS connection to the server.
     ///
     /// # Arguments
     /// * `base_path` - base path of the client API, i.e. "<https://www.my-api-implementation.com>"
@@ -297,7 +297,7 @@ impl<C> Client<
         Self::try_new_with_connector(base_path, Some("https"), https_connector)
     }
 
-    /// Create a client with a TLS connection to the server using OpenSSL.
+    /// Create a client with a TLS connection to the server using OpenSSL via swagger.
     ///
     /// # Arguments
     /// * `base_path` - base path of the client API, i.e. "<https://www.my-api-implementation.com>"
@@ -311,7 +311,7 @@ impl<C> Client<
         Self::try_new_with_connector(base_path, Some("https"), https_connector)
     }
 
-    /// Create a client with a TLS connection to the server using a pinned certificate
+    /// Create a client with a TLS connection to the server using a pinned certificate.
     ///
     /// # Arguments
     /// * `base_path` - base path of the client API, i.e. "<https://www.my-api-implementation.com>"

samples/server/petstore/rust-server/output/no-example-v3/Cargo.toml

@@ -8,7 +8,7 @@ license = "Unlicense"
 edition = "2018"
 
 [features]
-default = ["client", "server"]
+default = ["client", "server", "client-tls"]
 client = [
     "hyper", "percent-encoding", "hyper-util/http1", "hyper-util/http2", "url"
 ]
@@ -99,13 +99,15 @@ clap = "4.5"
 env_logger = "0.11"
 tokio = { version = "1.49", features = ["full"] }
 native-tls = "0.2"
-openssl = "0.10"
-tokio-openssl = "0.6"
 pin-project = "1.1.10"
 
 # Bearer authentication, used in examples
 jsonwebtoken = {version = "10.0.0", features = ["rust_crypto"]}
 
+[target.'cfg(not(any(target_os = "macos", target_os = "windows", target_os = "ios")))'.dev-dependencies]
+openssl = "0.10"
+tokio-openssl = "0.6"
+
 [[example]]
 name = "client"
 required-features = ["client"]

samples/server/petstore/rust-server/output/no-example-v3/README.md

@@ -121,13 +121,13 @@ The generated library has a few optional features that can be activated through
     * This defaults to disabled and allows JSON Schema validation of received data using `MakeService::set_validation` or `Service::set_validation`.
     * Note, enabling validation will have a performance penalty, especially if the API heavily uses regex based checks.
 
-### Enabling HTTPS/TLS Support
+### HTTPS/TLS Support
 
-By default, only HTTP support is included. To enable HTTPS, add the `client-tls` feature:
+HTTPS support is included by default. To disable it (for example, to reduce dependencies), you can:
 
 ```toml
 [dependencies]
-no-example-v3 = { version = "0.0.1", features = ["client-tls"] }
+no-example-v3 = { version = "0.0.1", default-features = false, features = ["client", "server"] }
 ```
 
 **For server with callbacks that need HTTPS:**
@@ -140,8 +140,6 @@ The TLS backend is automatically selected based on your target platform:
 - **macOS, Windows, iOS**: Uses `native-tls` (system TLS libraries)
 - **Linux, Unix, other platforms**: Uses `openssl`
 
-This ensures the best compatibility and native integration on each platform.
-
 See https://doc.rust-lang.org/cargo/reference/manifest.html#the-features-section for how to use features in your `Cargo.toml`.
 
 ## Documentation for API Endpoints

samples/server/petstore/rust-server/output/no-example-v3/src/client/mod.rs

@@ -276,7 +276,7 @@ impl<C> Client<
 > where
     C: Clone + Send + Sync + 'static
 {
-    /// Create a client with a TLS connection to the server using native-tls.
+    /// Create a client with a TLS connection to the server.
     ///
     /// # Arguments
     /// * `base_path` - base path of the client API, i.e. "<https://www.my-api-implementation.com>"
@@ -290,7 +290,7 @@ impl<C> Client<
         Self::try_new_with_connector(base_path, Some("https"), https_connector)
     }
 
-    /// Create a client with a TLS connection to the server using OpenSSL.
+    /// Create a client with a TLS connection to the server using OpenSSL via swagger.
     ///
     /// # Arguments
     /// * `base_path` - base path of the client API, i.e. "<https://www.my-api-implementation.com>"
@@ -304,7 +304,7 @@ impl<C> Client<
         Self::try_new_with_connector(base_path, Some("https"), https_connector)
     }
 
-    /// Create a client with a TLS connection to the server using a pinned certificate
+    /// Create a client with a TLS connection to the server using a pinned certificate.
     ///
     /// # Arguments
     /// * `base_path` - base path of the client API, i.e. "<https://www.my-api-implementation.com>"

samples/server/petstore/rust-server/output/openapi-v3/Cargo.toml

@@ -8,7 +8,7 @@ license = "Unlicense"
 edition = "2018"
 
 [features]
-default = ["client", "server"]
+default = ["client", "server", "client-tls"]
 client = [
     "serde_urlencoded",
     "serde_ignored", "percent-encoding", 
@@ -104,13 +104,15 @@ clap = "4.5"
 env_logger = "0.11"
 tokio = { version = "1.49", features = ["full"] }
 native-tls = "0.2"
-openssl = "0.10"
-tokio-openssl = "0.6"
 pin-project = "1.1.10"
 
 # Bearer authentication, used in examples
 jsonwebtoken = {version = "10.0.0", features = ["rust_crypto"]}
 
+[target.'cfg(not(any(target_os = "macos", target_os = "windows", target_os = "ios")))'.dev-dependencies]
+openssl = "0.10"
+tokio-openssl = "0.6"
+
 [[example]]
 name = "client"
 required-features = ["client"]