feat: adds support for required supporting files

Author: NickUfer

modules/openapi-generator/src/main/java/org/openapitools/codegen/DefaultGenerator.java

@@ -703,18 +703,16 @@ void generateApis(List<File> files, List<OperationsMap> allOperations, List<Mode
     }
 
     private void generateSupportingFiles(List<File> files, Map<String, Object> bundle) {
-        if (!generateSupportingFiles) {
-            // TODO: process these anyway and report via dryRun?
-            LOGGER.info("Skipping generation of supporting files.");
-            return;
-        }
         Set<String> supportingFilesToGenerate = null;
         String supportingFiles = GlobalSettings.getProperty(CodegenConstants.SUPPORTING_FILES);
         if (supportingFiles != null && !supportingFiles.isEmpty()) {
             supportingFilesToGenerate = new HashSet<>(Arrays.asList(supportingFiles.split(",")));
         }
 
         for (SupportingFile support : config.supportingFiles()) {
+            if (!generateSupportingFiles && !support.isRequired()) {
+                continue;
+            }
             try {
                 String outputFolder = config.outputFolder();
                 if (StringUtils.isNotEmpty(support.getFolder())) {
@@ -747,6 +745,12 @@ private void generateSupportingFiles(List<File> files, Map<String, Object> bundl
             }
         }
 
+        if (!generateSupportingFiles) {
+            // TODO: process these anyway and report via dryRun?
+            LOGGER.info("Skipping generation of not required supporting files.");
+            return;
+        }
+
         // Consider .openapi-generator-ignore a supporting file
         // Output .openapi-generator-ignore if it doesn't exist and wasn't explicitly created by a generator
         final String openapiGeneratorIgnore = ".openapi-generator-ignore";

modules/openapi-generator/src/main/java/org/openapitools/codegen/SupportingFile.java

@@ -32,15 +32,28 @@
  */
 public class SupportingFile extends TemplateDefinition {
     private boolean canOverwrite = true;
+    /**
+     * Whether the {@link SupportingFile} is required for all generated code.
+     */
+    private boolean required = false;
 
     public SupportingFile(String templateFile, String destinationFilename) {
         this(templateFile, "", destinationFilename);
     }
 
+    public SupportingFile(String templateFile, String destinationFilename, boolean required) {
+        this(templateFile, "", destinationFilename, required);
+    }
+
     public SupportingFile(String templateFile, String folder, String destinationFilename) {
         super(templateFile, folder, destinationFilename);
     }
 
+    public SupportingFile(String templateFile, String folder, String destinationFilename, boolean required) {
+        super(templateFile, folder, destinationFilename);
+        this.required = required;
+    }
+
     /**
      * Identifies this instance as referring to a supporting file which should not overwrite a file of the same name.
      *
@@ -84,6 +97,13 @@ public boolean isCanOverwrite() {
         return canOverwrite;
     }
 
+    /**
+     * @return whether the {@link SupportingFile} is required for all generated code.
+     */
+    public boolean isRequired() {
+        return required;
+    }
+
     @Override
     public int hashCode() {
         return Objects.hash(super.hashCode(), isCanOverwrite());