First basic ready-to-use implementation

src/Exporters/Abstract/AbstractConverter.php

@@ -0,0 +1,111 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PmConverter\Exporters\Abstract;
+
+use Exception;
+use PmConverter\Exporters\{
+    RequestContract};
+use PmConverter\FileSystem;
+
+/**
+ *
+ */
+abstract class AbstractConverter
+{
+    /**
+     * @var object|null
+     */
+    protected ?object $collection = null;
+
+    /**
+     * @var string
+     */
+    protected string $outputPath;
+
+    /**
+     * @throws Exception
+     */
+    public function convert(object $collection, string $outputPath): void
+    {
+        $outputPath = sprintf('%s%s%s', $outputPath, DIRECTORY_SEPARATOR, static::OUTPUT_DIR);
+        $this->outputPath = FileSystem::makeDir($outputPath);
+        $this->collection = $collection;
+        foreach ($collection->item as $item) {
+            $this->convertItem($item);
+        }
+    }
+
+    /**
+     * @return string
+     */
+    public function getOutputPath(): string
+    {
+        return $this->outputPath;
+    }
+
+    /**
+     * @param object $item
+     * @return bool
+     */
+    protected function isItemFolder(object $item): bool
+    {
+        return !empty($item->item) && empty($item->request);
+    }
+
+    /**
+     * @throws Exception
+     */
+    protected function convertItem(mixed $item): void
+    {
+        if ($this->isItemFolder($item)) {
+            static $dir_tree;
+            foreach ($item->item as $subitem) {
+                $dir_tree[] = $item->name;
+                $path = implode(DIRECTORY_SEPARATOR, $dir_tree);
+                if ($this->isItemFolder($subitem)) {
+                    $this->convertItem($subitem);
+                } else {
+                    $this->writeRequest($this->initRequest($subitem), $path);
+                }
+                array_pop($dir_tree);
+            }
+        } else {
+            $this->writeRequest($this->initRequest($item));
+        }
+    }
+
+    /**
+     * @param object $item
+     * @return RequestContract
+     */
+    protected function initRequest(object $item): RequestContract
+    {
+        $request_class = static::REQUEST;
+        $result = new $request_class();
+        $result->setName($item->name);
+        $result->setDescription($item->request?->description ?? null);
+        $result->setVerb($item->request->method);
+        $result->setUrl($item->request->url->raw);
+        $result->setHeaders($item->request->header);
+        if ($item->request->method !== 'GET' && !empty($item->request->body)) {
+            $result->setBody($item->request->body);
+        }
+        return $result;
+    }
+
+    /**
+     * @param RequestContract $request
+     * @param string|null $subpath
+     * @return bool
+     * @throws Exception
+     */
+    protected function writeRequest(RequestContract $request, string $subpath = null): bool
+    {
+        $filedir = sprintf('%s%s%s', $this->outputPath, DIRECTORY_SEPARATOR, $subpath);
+        $filedir = FileSystem::makeDir($filedir);
+        $filepath = sprintf('%s%s%s.%s', $filedir, DIRECTORY_SEPARATOR, $request->getName(), static::FILE_EXT);
+        return file_put_contents($filepath, (string)$request) > 0;
+    }
+}

src/Exporters/Abstract/AbstractRequest.php

@@ -0,0 +1,164 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PmConverter\Exporters\Abstract;
+
+use PmConverter\Exporters\Http\HttpRequest;
+use PmConverter\Exporters\RequestContract;
+
+/**
+ *
+ */
+abstract class AbstractRequest implements RequestContract
+{
+    /**
+     * @var string
+     */
+    protected string $http = 'HTTP/1.1'; //TODO verb
+
+    /**
+     * @var string
+     */
+    protected string $name;
+
+    /**
+     * @var string|null
+     */
+    protected ?string $description = null;
+
+    /**
+     * @var array
+     */
+    protected array $headers = [];
+
+    /**
+     * @var mixed
+     */
+    protected mixed $body = null;
+
+    /**
+     * @var string
+     */
+    protected string $bodymode = 'raw';
+
+    /**
+     * @var string
+     */
+    protected string $verb;
+
+    /**
+     * @var string
+     */
+    protected string $url;
+
+    /**
+     * @param string $name
+     * @return HttpRequest
+     */
+    public function setName(string $name): static
+    {
+        $this->name = $name;
+        return $this;
+    }
+
+    /**
+     * @return string
+     */
+    public function getName(): string
+    {
+        return str_replace(DIRECTORY_SEPARATOR, '_', $this->name);
+    }
+
+    /**
+     * @param string|null $description
+     * @return HttpRequest
+     */
+    public function setDescription(?string $description): static
+    {
+        $this->description = $description;
+        return $this;
+    }
+
+    /**
+     * @param string $verb
+     * @return HttpRequest
+     */
+    public function setVerb(string $verb): static
+    {
+        $this->verb = $verb;
+        return $this;
+    }
+
+    /**
+     * @param string $url
+     * @return HttpRequest
+     */
+    public function setUrl(string $url): static
+    {
+        $this->url = $url;
+        return $this;
+    }
+
+    /**
+     * @param object[]|null $headers
+     * @return $this
+     */
+    public function setHeaders(?array $headers): static
+    {
+        foreach ($headers as $header) {
+            $this->headers[$header->key] = [
+                'value' => $header->value,
+                'disabled' => $header?->disabled ?? false,
+            ];
+        }
+        return $this;
+    }
+
+    /**
+     * @param string $bodymode
+     * @return HttpRequest
+     */
+    public function setBodymode(string $bodymode): static
+    {
+        $this->bodymode = $bodymode;
+        return $this;
+    }
+
+    /**
+     * @param string $body
+     * @return HttpRequest
+     */
+    public function setBody(object $body): static
+    {
+        $this->setBodymode($body->mode);
+        if (!empty($body->options) && $body->options->{$this->bodymode}->language === 'json') {
+            empty($this->headers['Content-Type']) && $this->setHeaders([
+                (object)[
+                    'key' => 'Content-Type',
+                    'value' => 'application/json',
+                    'disabled' => false,
+                ],
+            ]);
+        }
+        $body->mode === 'formdata' && $this->setHeaders([
+            (object)[
+                'key' => 'Content-Type',
+                'value' => 'multipart/form-data',
+                'disabled' => false,
+            ],
+        ]);
+        $this->body = $body->{$body->mode};
+        return $this;
+    }
+
+    /**
+     * @return string
+     */
+    abstract protected function prepareBody(): ?string;
+
+    /**
+     * @return string
+     */
+    abstract public function __toString(): string;
+}