Add custom generator support to open api spec (#912)

* Add custom generator support to open api spec * Add documentation and improve naming * fix phpdoc * fix override generator * Resolve conflicts --------- Co-authored-by: Shalvah <[email protected]>
knuckleswtf · Feb 3, 2025 · 9323b8b · 9323b8b
1 parent 81bb70b
commit 9323b8b
Show file tree

Hide file tree

Showing 11 changed files with 912 additions and 620 deletions.
diff --git a/config/scribe.php b/config/scribe.php
@@ -157,6 +157,10 @@
         'overrides' => [
             // 'info.version' => '2.0.0',
         ],
+
+        // Additional generators to use when generating the OpenAPI spec.
+        // Should extend `Knuckles\Scribe\Writing\OpenApiSpecGenerators\OpenApiGenerator`.
+        'generators' => [],
     ],
 
     'groups' => [

diff --git a/src/Config/Output.php b/src/Config/Output.php
@@ -86,6 +86,7 @@ public static function postman(
     public static function openApi(
         bool  $enabled = true,
         array $overrides = [],
+        array $generators = [],
     ): array
     {
         return get_defined_vars();

diff --git a/src/Writing/OpenAPISpecWriter.php b/src/Writing/OpenAPISpecWriter.php