feat: generate OpenAPI JSON from APIB

.gitignore

@@ -11,7 +11,6 @@
 /build/out
 /build/*.phar
 /tests/statics/index.*
-src/Michelf/*
 src/.gitignore
 vendor/**
 
@@ -24,3 +23,4 @@ atlassian-ide-plugin.xml
 
 /coverage.xml
 /event.json
+!/src/PHPDraft/Out/

phpdraft

@@ -28,6 +28,7 @@ try
  ->opt('help:h', 'This help text', false)
  ->opt('version:v', 'Print the version for PHPDraft.', false)
  ->opt('file:f', 'Specifies the file to parse.', false)
+ ->opt('openapi:a', 'Output location for an OpenAPI file.', false)
  ->opt('yes:y', 'Always accept using the online mode.', false, 'bool')
  ->opt('online:o', 'Always use the online mode.', false, 'bool')
  ->opt('template:t', 'Specifies the template to use. (defaults to \'default\').', false)
@@ -90,6 +91,11 @@ try
  $data = json_decode($json_string);
  }
 
+ if (isset($args['openapi'])) {
+ $openapi = ParserFactory::getOpenAPI()->init($data);
+ $openapi->write($args['openapi']);
+ }
+
  $html = ParserFactory::getJson()->init($data);
  $name = 'PHPD_SORT_' . strtoupper($args->getOpt('sort', ''));
  $html->sorting = Sorting::${$name} ?? Sorting::PHPD_SORT_NONE->value;

src/PHPDraft/Model/HTTPRequest.php

@@ -12,6 +12,7 @@
 
 namespace PHPDraft\Model;
 
+use PHPDraft\Model\Elements\ObjectStructureElement;
 use PHPDraft\Model\Elements\RequestBodyElement;
 use PHPDraft\Model\Elements\StructureElement;
 
@@ -43,7 +44,7 @@ class HTTPRequest implements Comparable
  *
  * @var string
  */
- public string $description;
+ public string $description = '';
 
  /**
  * Parent class.
@@ -68,9 +69,10 @@ class HTTPRequest implements Comparable
  /**
  * Structure of the request.
  *
- * @var RequestBodyElement[]|RequestBodyElement
+ * @var RequestBodyElement[]|RequestBodyElement|ObjectStructureElement
  */
- public mixed $struct = [];
+ public RequestBodyElement|ObjectStructureElement|array|null $struct = [];
+
  /**
  * Identifier for the request.
  *

src/PHPDraft/Model/Tests/HTTPRequestTest.php

@@ -205,7 +205,7 @@ public function testGetCurlCommandStructBodyFilled(): void
  $struct_ar->expects($this->once())
  ->method('print_request')
  ->with(null)
- ->will($this->returnValue('TEST'));
+ ->willReturn('TEST');
 
  $struct->value = [ $struct_ar ];
  $this->set_reflection_property_value('struct', $struct);

src/PHPDraft/Model/Transition.php

@@ -23,9 +23,9 @@ class Transition extends HierarchyElement
  /**
  * HTTP method used.
  *
- * @var string
+ * @var string|null
  */
- public string $method;
+ public ?string $method = NULL;
 
  /**
  * URI.

src/PHPDraft/Out/BaseTemplateRenderer.php

@@ -24,36 +24,21 @@ abstract class BaseTemplateRenderer
  * @var int
  */
  public int $sorting;
+
  /**
- * CSS Files to load.
- *
- * @var string[]
- */
- public array $css = [];
- /**
- * JS Files to load.
- *
- * @var string[]
- */
- public array $js = [];
- /**
- * The image to use as a logo.
- *
- * @var string|null
- */
- protected ?string $image = null;
- /**
- * The template file to load.
+ * JSON representation of an API Blueprint.
  *
- * @var string
+ * @var object
  */
- protected string $template;
+ protected object $object;
+
  /**
  * The base data of the API.
  *
  * @var array<string, mixed>
  */
- protected array $base_data;
+ protected array $base_data = [];
+
  /**
  * JSON object of the API blueprint.
  *
@@ -66,4 +51,39 @@ abstract class BaseTemplateRenderer
  * @var BasicStructureElement[]
  */
  protected array $base_structures = [];
+
+ /**
+ * Parse base data
+ *
+ * @param object $object
+ */
+ protected function parse_base_data(object $object): void
+ {
+ //Prepare base data
+ if (!is_array($object->content[0]->content)) {
+ return;
+ }
+
+ $this->base_data['TITLE'] = $object->content[0]->meta->title->content ?? '';
+
+ foreach ($object->content[0]->attributes->metadata->content as $meta) {
+ $this->base_data[$meta->content->key->content] = $meta->content->value->content;
+ }
+
+ foreach ($object->content[0]->content as $value) {
+ if ($value->element === 'copy') {
+ $this->base_data['DESC'] = $value->content;
+ continue;
+ }
+
+ $cat = new Category();
+ $cat = $cat->parse($value);
+
+ if (($value->meta->classes->content[0]->content ?? null) === 'dataStructures') {
+ $this->base_structures = array_merge($this->base_structures, $cat->structures);
+ } else {
+ $this->categories[] = $cat;
+ }
+ }
+ }
 }

src/PHPDraft/Out/TemplateRenderer.php → src/PHPDraft/Out/HtmlTemplateRenderer.php

@@ -28,8 +28,36 @@
 use Twig\TwigFilter;
 use Twig\TwigTest;
 
-class TemplateRenderer extends BaseTemplateRenderer
+class HtmlTemplateRenderer extends BaseTemplateRenderer
 {
+
+
+ /**
+ * CSS Files to load.
+ *
+ * @var string[]
+ */
+ public array $css = [];
+
+ /**
+ * JS Files to load.
+ *
+ * @var string[]
+ */
+ public array $js = [];
+ /**
+ * The image to use as a logo.
+ *
+ * @var string|null
+ */
+ protected ?string $image = null;
+ /**
+ * The template file to load.
+ *
+ * @var string
+ */
+ protected string $template;
+
  /**
  * TemplateGenerator constructor.
  *
@@ -106,41 +134,6 @@ public function get(object $object): string
  ]);
  }
 
- /**
- * Parse base data
- *
- * @param object $object
- */
- private function parse_base_data(object $object): void
- {
- //Prepare base data
- if (!is_array($object->content[0]->content)) {
- return;
- }
-
- $this->base_data['TITLE'] = $object->content[0]->meta->title->content ?? '';
-
- foreach ($object->content[0]->attributes->metadata->content as $meta) {
- $this->base_data[$meta->content->key->content] = $meta->content->value->content;
- }
-
- foreach ($object->content[0]->content as $value) {
- if ($value->element === 'copy') {
- $this->base_data['DESC'] = $value->content;
- continue;
- }
-
- $cat = new Category();
- $cat = $cat->parse($value);
-
- if (($value->meta->classes->content[0]->content ?? null) === 'dataStructures') {
- $this->base_structures = array_merge($this->base_structures, $cat->structures);
- } else {
- $this->categories[] = $cat;
- }
- }
- }
-
  /**
  * Get the path to a file to include.
  *