feat: annotated file updating made optional by argument

Author: aoisupersix

openapi-generator/lib/src/models/generator_arguments.dart

@@ -47,6 +47,11 @@ class GeneratorArguments {
   /// Default: false
   final bool skipValidation;
 
+  /// Write the last run placeholder to the annotated file.
+  ///
+  /// Default: true
+  final bool updateAnnotatedFile;
+
   /// Provides an OAS spec file.
   ///
   /// When the [useNextGen] flag is set this should be the spec file configuration
@@ -104,6 +109,8 @@ class GeneratorArguments {
             annotations.readPropertyOrDefault('runSourceGenOnOutput', true),
         shouldFetchDependencies =
             annotations.readPropertyOrDefault('fetchDependencies', true),
+        updateAnnotatedFile =
+            annotations.readPropertyOrDefault('updateAnnotatedFile', true),
         outputDirectory = annotations.readPropertyOrNull('outputDirectory'),
         cachePath =
             annotations.readPropertyOrDefault('cachePath', defaultCachedPath),

openapi-generator/lib/src/openapi_generator_runner.dart

@@ -220,24 +220,35 @@ class OpenapiGenerator extends GeneratorForAnnotation<annots.Openapi> {
           ),
         ),
       );
-      await updateAnnotatedFile(annotatedPath: annotatedPath).then(
-        (_) => logOutputMessage(
-          log: log,
-          communication: OutputMessage(
-            message: 'Successfully updated annotated file.',
-            level: Level.CONFIG,
+      if (args.updateAnnotatedFile) {
+        await updateAnnotatedFile(annotatedPath: annotatedPath).then(
+          (_) => logOutputMessage(
+            log: log,
+            communication: OutputMessage(
+              message: 'Successfully updated annotated file.',
+              level: Level.CONFIG,
+            ),
           ),
-        ),
-        onError: (e, st) => logOutputMessage(
+          onError: (e, st) => logOutputMessage(
+            log: log,
+            communication: OutputMessage(
+              message: 'Failed to update annotated class file.',
+              level: Level.WARNING,
+              additionalContext: e,
+              stackTrace: st,
+            ),
+          ),
+        );
+      } else {
+        logOutputMessage(
           log: log,
           communication: OutputMessage(
-            message: 'Failed to update annotated class file.',
+            message:
+                'Skipped updating annotated file step because flag was set.',
             level: Level.WARNING,
-            additionalContext: e,
-            stackTrace: st,
           ),
-        ),
-      );
+        );
+      }
     }
     return '';
   }