Add generatemodels and generateapis options (#897)

Author: andybarilla

client/deployment/src/main/java/io/quarkiverse/openapi/generator/deployment/CodegenConfig.java

@@ -71,6 +71,8 @@ public enum ConfigName {
         REMOVE_OPERATION_ID_PREFIX("remove-operation-id-prefix"),
         REMOVE_OPERATION_ID_PREFIX_DELIMITER("remove-operation-id-prefix-delimiter"),
         REMOVE_OPERATION_ID_PREFIX_COUNT("remove-operation-id-prefix-count"),
+        GENERATE_APIS("generate-apis"),
+        GENERATE_MODELS("generate-models"),
         BEAN_VALIDATION("use-bean-validation");
 
         private final String name;

client/deployment/src/main/java/io/quarkiverse/openapi/generator/deployment/CommonItemConfig.java

@@ -160,4 +160,16 @@ public class CommonItemConfig {
      */
     @ConfigItem(name = "use-bean-validation")
     public Optional<Boolean> useBeanValidation;
+
+    /**
+     * Enable the generation of APIs. If you set this to {@code false}, APIs will not be generated.
+     */
+    @ConfigItem(name = "generate-apis")
+    public Optional<Boolean> generateApis;
+
+    /**
+     * Enable the generation of models. If you set this to {@code false}, models will not be generated.
+     */
+    @ConfigItem(name = "generate-models")
+    public Optional<Boolean> generateModels;
 }

client/deployment/src/main/java/io/quarkiverse/openapi/generator/deployment/codegen/OpenApiGeneratorCodeGenBase.java

@@ -300,6 +300,12 @@ protected void generate(OpenApiGeneratorOptions options) {
         getValues(config, openApiFilePath, CodegenConfig.ConfigName.BEAN_VALIDATION, Boolean.class)
                 .ifPresent(generator::withUseBeanValidation);
 
+        getValues(config, openApiFilePath, CodegenConfig.ConfigName.GENERATE_APIS, Boolean.class)
+                .ifPresent(generator::withGenerateApis);
+
+        getValues(config, openApiFilePath, CodegenConfig.ConfigName.GENERATE_MODELS, Boolean.class)
+                .ifPresent(generator::withGenerateModels);
+
         SmallRyeConfig smallRyeConfig = config.unwrap(SmallRyeConfig.class);
 
         getValues(smallRyeConfig, openApiFilePath, CodegenConfig.ConfigName.TYPE_MAPPINGS, String.class, String.class)

client/deployment/src/main/java/io/quarkiverse/openapi/generator/deployment/wrapper/OpenApiClientGeneratorWrapper.java

@@ -275,6 +275,16 @@ public OpenApiClientGeneratorWrapper withUseBeanValidation(Boolean config) {
         return this;
     }
 
+    public OpenApiClientGeneratorWrapper withGenerateApis(Boolean config) {
+        configurator.addAdditionalProperty("generate-apis", config);
+        return this;
+    }
+
+    public OpenApiClientGeneratorWrapper withGenerateModels(Boolean config) {
+        configurator.addAdditionalProperty("generate-models", config);
+        return this;
+    }
+
     public OpenApiClientGeneratorWrapper withApiNameSuffix(final String apiNameSuffix) {
         this.configurator.setApiNameSuffix(apiNameSuffix);
         return this;

client/deployment/src/main/java/io/quarkiverse/openapi/generator/deployment/wrapper/QuarkusJavaClientCodegen.java

@@ -70,6 +70,8 @@ private void replaceWithQuarkusTemplateFiles() {
         supportingFiles.clear();
 
         Boolean enableSecurityGeneration = (Boolean) this.additionalProperties.get("enable-security-generation");
+        Boolean generateApis = (Boolean) this.additionalProperties.getOrDefault("generate-apis", Boolean.TRUE);
+        Boolean generateModels = (Boolean) this.additionalProperties.getOrDefault("generate-models", Boolean.TRUE);
 
         if (enableSecurityGeneration == null || enableSecurityGeneration) {
             if (ProcessUtils.hasHttpBasicMethods(this.openAPI) ||
@@ -92,10 +94,14 @@ private void replaceWithQuarkusTemplateFiles() {
         }
 
         apiTemplateFiles.clear();
-        apiTemplateFiles.put("api.qute", ".java");
+        if (generateApis) {
+            apiTemplateFiles.put("api.qute", ".java");
+        }
 
         modelTemplateFiles.clear();
-        modelTemplateFiles.put("model.qute", ".java");
+        if (generateModels) {
+            modelTemplateFiles.put("model.qute", ".java");
+        }
     }
 
     public String authFileFolder() {

client/deployment/src/test/java/io/quarkiverse/openapi/generator/deployment/OpenApiConfigValidatorTest.java

@@ -18,7 +18,7 @@ class OpenApiConfigValidatorTest {
             "quarkus.openapi-generator.codegen.additional-api-type-annotations",
             "quarkus.openapi-generator.codegen.spec.spec_yaml.enable-security-generation",
             "quarkus.openapi-generator.codegen.type-mappings.UUID=String",
-            "quarkus.openapi-generator.codegen.spec.spec_yaml.type-mappings.UUID=String"
+            "quarkus.openapi-generator.codegen.spec.spec_yaml.type-mappings.UUID=String",
     })
     void test_known_configs_ok(String validConfiguration) {
         assertThatCode(() -> OpenApiConfigValidator.validateInputConfiguration(List.of(validConfiguration)))

client/integration-tests/generate-flags/pom.xml

@@ -0,0 +1,97 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <parent>
+        <artifactId>quarkus-openapi-generator-integration-tests</artifactId>
+        <groupId>io.quarkiverse.openapi.generator</groupId>
+        <version>3.0.0-SNAPSHOT</version>
+    </parent>
+    <modelVersion>4.0.0</modelVersion>
+
+    <artifactId>quarkus-openapi-generator-it-generate-flags</artifactId>
+    <name>Quarkus - Openapi Generator - Integration Tests - Client - Generate Flags</name>
+    <description>Example project for usage of the generate-models and generate-apis properties</description>
+
+    <dependencies>
+        <dependency>
+            <groupId>io.quarkiverse.openapi.generator</groupId>
+            <artifactId>quarkus-openapi-generator</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.assertj</groupId>
+            <artifactId>assertj-core</artifactId>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>io.quarkus</groupId>
+            <artifactId>quarkus-junit5</artifactId>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>io.quarkus</groupId>
+            <artifactId>quarkus-hibernate-validator</artifactId>
+        </dependency>
+    </dependencies>
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>io.quarkus</groupId>
+                <artifactId>quarkus-maven-plugin</artifactId>
+                <extensions>true</extensions>
+                <executions>
+                    <execution>
+                        <goals>
+                            <goal>build</goal>
+                            <goal>generate-code</goal>
+                            <goal>generate-code-tests</goal>
+                        </goals>
+                    </execution>
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
+    <profiles>
+        <profile>
+            <id>native-image</id>
+            <activation>
+                <property>
+                    <name>native</name>
+                </property>
+            </activation>
+            <build>
+                <plugins>
+                    <plugin>
+                        <artifactId>maven-surefire-plugin</artifactId>
+                        <configuration>
+                            <skipTests>${native.surefire.skip}</skipTests>
+                        </configuration>
+                    </plugin>
+                    <plugin>
+                        <artifactId>maven-failsafe-plugin</artifactId>
+                        <executions>
+                            <execution>
+                                <goals>
+                                    <goal>integration-test</goal>
+                                    <goal>verify</goal>
+                                </goals>
+                                <configuration>
+                                    <systemPropertyVariables>
+                                        <native.image.path>
+                                            ${project.build.directory}/${project.build.finalName}-runner
+                                        </native.image.path>
+                                        <java.util.logging.manager>org.jboss.logmanager.LogManager
+                                        </java.util.logging.manager>
+                                        <maven.home>${maven.home}</maven.home>
+                                    </systemPropertyVariables>
+                                </configuration>
+                            </execution>
+                        </executions>
+                    </plugin>
+                </plugins>
+            </build>
+            <properties>
+                <quarkus.package.type>native</quarkus.package.type>
+            </properties>
+        </profile>
+    </profiles>
+
+</project>

client/integration-tests/generate-flags/src/main/openapi/generate_apis_false.yaml

@@ -0,0 +1,60 @@
+---
+openapi: 3.0.3
+info:
+  title: Test API
+  version: "1.0"
+paths:
+  /{pathParam}:
+    get:
+      tags:
+        - NonExistentEndpoint
+      operationId: test
+      parameters:
+        - name: pathParam
+          in: path
+          required: true
+          schema:
+            type: string
+            minimum: 5
+        - name: headerParam
+          in: header
+          required: false
+          schema:
+            type: integer
+            maximum: 5
+        - name: cookieParam
+          in: cookie
+          required: true
+          schema:
+            type: string
+            minLength: 10
+      responses:
+        "200":
+          description: OK
+          content:
+            text/plain:
+              schema:
+                type: string
+components:
+  schemas:
+    ExistentObject:
+      type: object
+      description: Some object not to be validated
+      required:
+        - id
+        - name
+        - size
+      properties:
+        id:
+          type: integer
+          minimum: 1
+          maximum: 100
+        name:
+          type: string
+          pattern: "[a-zA-Z]*"
+          minLength: 1
+          maxLength: 10
+        size:
+          type: number
+          minimum: 1.0
+          maximum: 10.0

client/integration-tests/generate-flags/src/main/openapi/generate_models_false.yaml

@@ -0,0 +1,60 @@
+---
+openapi: 3.0.3
+info:
+  title: Test API
+  version: "1.0"
+paths:
+  /{pathParam}:
+    get:
+      tags:
+        - ExistentEndpoint
+      operationId: test
+      parameters:
+        - name: pathParam
+          in: path
+          required: true
+          schema:
+            type: string
+            minimum: 5
+        - name: headerParam
+          in: header
+          required: false
+          schema:
+            type: integer
+            maximum: 5
+        - name: cookieParam
+          in: cookie
+          required: true
+          schema:
+            type: string
+            minLength: 10
+      responses:
+        "200":
+          description: OK
+          content:
+            text/plain:
+              schema:
+                type: string
+components:
+  schemas:
+    NonExistentObject:
+      type: object
+      description: Some object not to be validated
+      required:
+        - id
+        - name
+        - size
+      properties:
+        id:
+          type: integer
+          minimum: 1
+          maximum: 100
+        name:
+          type: string
+          pattern: "[a-zA-Z]*"
+          minLength: 1
+          maxLength: 10
+        size:
+          type: number
+          minimum: 1.0
+          maximum: 10.0

client/integration-tests/generate-flags/src/main/resources/application.properties

@@ -0,0 +1,2 @@
+quarkus.openapi-generator.codegen.spec.generate_models_false_yaml.generate-models = false
+quarkus.openapi-generator.codegen.spec.generate_apis_false_yaml.generate-apis = false