First basic ready-to-use implementation

src/Exceptions/CannotCreateDirectoryException.php

@@ -0,0 +1,11 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PmConverter\Exceptions;
+
+use Exception;
+
+class CannotCreateDirectoryException extends Exception
+{
+}

src/Exceptions/DirectoryIsNotReadableException.php

@@ -0,0 +1,11 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PmConverter\Exceptions;
+
+use Exception;
+
+class DirectoryIsNotReadableException extends Exception
+{
+}

src/Exceptions/DirectoryIsNotWriteableException.php

@@ -0,0 +1,11 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PmConverter\Exceptions;
+
+use Exception;
+
+class DirectoryIsNotWriteableException extends Exception
+{
+}

src/Exceptions/DirectoryNotExistsException.php

@@ -0,0 +1,11 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PmConverter\Exceptions;
+
+use Exception;
+
+class DirectoryNotExistsException extends Exception
+{
+}

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;
+}

src/Exporters/ConvertFormat.php

@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PmConverter\Exporters;
+
+
+use PmConverter\Exporters\Curl\CurlConverter;
+use PmConverter\Exporters\Http\HttpConverter;
+use PmConverter\Exporters\Wget\WgetConverter;
+
+enum ConvertFormat: string
+{
+    case Http = HttpConverter::class;
+    case Curl = CurlConverter::class;
+    case Wget = WgetConverter::class;
+}

src/Exporters/ConverterContract.php

@@ -0,0 +1,11 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PmConverter\Exporters;
+
+interface ConverterContract
+{
+    public function convert(object $collection, string $outputPath): void;
+    public function getOutputPath(): string;
+}

src/Exporters/Curl/CurlConverter.php

@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PmConverter\Exporters\Curl;
+
+use PmConverter\Exporters\{
+    Abstract\AbstractConverter,
+    ConverterContract};
+
+class CurlConverter extends AbstractConverter implements ConverterContract
+{
+    protected const FILE_EXT = 'sh';
+    protected const OUTPUT_DIR = 'curl';
+
+    protected const REQUEST = CurlRequest::class;
+}

src/Exporters/Curl/CurlRequest.php

@@ -0,0 +1,65 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PmConverter\Exporters\Curl;
+
+use PmConverter\Exporters\Abstract\AbstractRequest;
+
+/**
+ *
+ */
+class CurlRequest extends AbstractRequest
+{
+    /**
+     * @return string
+     */
+    protected function prepareBody(): ?string
+    {
+        switch ($this->bodymode) {
+            case 'formdata':
+                $body = [];
+                foreach ($this->body as $data) {
+                    $body[] = sprintf(
+                        "%s\t--form '%s=%s' \ ",
+                        isset($data->disabled) ? '# ' : '',
+                        $data->key,
+                        $data->type === 'file' ? "@$data->src" : $data->value
+                    );
+                }
+                return implode(PHP_EOL, $body);
+            default:
+                return $this->body;
+        }
+    }
+
+    /**
+     * @return string
+     */
+    public function __toString(): string
+    {
+        $output[] = '#!/bin/sh';
+        if ($this->description) {
+            $output[] = '# ' . str_replace("\n", "\n# ", $this->description);
+            $output[] = '';
+        }
+        $output[] = "curl \ ";
+        $output[] = "\t--http1.1 \ "; //TODO verb
+        $output[] = "\t--request $this->verb \ ";
+        $output[] = "\t--location $this->url \ ";
+        foreach ($this->headers as $header_key => $header) {
+            if ($header['disabled']) {
+                continue;
+            }
+            $output[] = sprintf("\t--header '%s=%s' \ ", $header_key, $header['value']);
+        }
+        if (!is_null($body = $this->prepareBody())) {
+            $output[] = match ($this->bodymode) {
+                'formdata' => $body,
+                default => "\t--data '$body'",
+            };
+        }
+        $output[] = rtrim(array_pop($output), '\ ');
+        return implode(PHP_EOL, $output);
+    }
+}

src/Exporters/Http/HttpConverter.php

@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PmConverter\Exporters\Http;
+
+use PmConverter\Exporters\{
+    Abstract\AbstractConverter,
+    ConverterContract};
+
+class HttpConverter extends AbstractConverter implements ConverterContract
+{
+    protected const FILE_EXT = 'http';
+    protected const OUTPUT_DIR = 'http';
+
+    protected const REQUEST = HttpRequest::class;
+}

src/Exporters/Http/HttpRequest.php

@@ -0,0 +1,53 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PmConverter\Exporters\Http;
+
+use PmConverter\Exporters\Abstract\AbstractRequest;
+
+/**
+ *
+ */
+class HttpRequest extends AbstractRequest
+{
+    /**
+     * @return string
+     */
+    protected function prepareBody(): ?string
+    {
+        switch ($this->bodymode) {
+            case 'formdata':
+                $body = [];
+                foreach ($this->body as $data) {
+                    $body[] = sprintf(
+                        '%s%s=%s',
+                        empty($data->disabled) ? '' : '# ',
+                        $data->key,
+                        $data->type === 'file' ? "$data->src" : $data->value
+                    );
+                }
+                return implode(PHP_EOL, $body);
+            default:
+                return $this->body;
+        }
+    }
+
+    /**
+     * @return string
+     */
+    public function __toString(): string
+    {
+        if ($this->description) {
+            $output[] = '# ' . str_replace("\n", "\n# ", $this->description);
+            $output[] = '';
+        }
+        $output[] = "$this->verb $this->url $this->http";
+        foreach ($this->headers as $header_key => $header) {
+            $output[] = sprintf('%s%s: %s', $header['disabled'] ? '# ' : '', $header_key, $header['value']);
+        }
+        $output[] = '';
+        $output[] = (string)$this->prepareBody();
+        return implode(PHP_EOL, $output);
+    }
+}

src/Exporters/RequestContract.php

@@ -0,0 +1,18 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PmConverter\Exporters;
+
+interface RequestContract
+{
+    public function setName(string $name): static;
+    public function getName(): string;
+    public function setDescription(?string $description): static;
+    public function setVerb(string $verb): static;
+    public function setUrl(string $url): static;
+    public function setHeaders(?array $headers): static;
+    public function setBodymode(string $bodymode): static;
+    public function setBody(object $body): static;
+    public function __toString(): string;
+}

src/Exporters/Wget/WgetConverter.php

@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PmConverter\Exporters\Wget;
+
+use PmConverter\Exporters\{
+    Abstract\AbstractConverter,
+    ConverterContract};
+
+class WgetConverter extends AbstractConverter implements ConverterContract
+{
+    protected const FILE_EXT = 'sh';
+    protected const OUTPUT_DIR = 'wget';
+
+    protected const REQUEST = WgetRequest::class;
+}

src/Exporters/Wget/WgetRequest.php

@@ -0,0 +1,63 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PmConverter\Exporters\Wget;
+
+use PmConverter\Exporters\Abstract\AbstractRequest;
+
+/**
+ *
+ */
+class WgetRequest extends AbstractRequest
+{
+    /**
+     * @return string
+     */
+    protected function prepareBody(): ?string
+    {
+        switch ($this->bodymode) {
+            case 'formdata':
+                $lines = [];
+                foreach ($this->body as &$data) {
+                    if ($data->type === 'file') {
+                        continue;
+                    }
+                    $lines[$data->key] = $data->value;
+                }
+                $body[] = http_build_query($lines);
+                return implode(PHP_EOL, $body);
+            default:
+                return $this->body;
+        }
+    }
+
+    /**
+     * @return string
+     */
+    public function __toString(): string
+    {
+        $output[] = '#!/bin/sh';
+        if ($this->description) {
+            $output[] = '# ' . str_replace("\n", "\n# ", $this->description);
+            $output[] = '';
+        }
+        $output[] = 'wget \ ';
+        $output[] = "\t--no-check-certificate \ ";
+        $output[] = "\t--quiet \ ";
+        $output[] = "\t--timeout=0 \ ";
+        $output[] = "\t--method $this->verb \ ";
+        foreach ($this->headers as $header_key => $header) {
+            if ($header['disabled']) {
+                continue;
+            }
+            $output[] = sprintf("\t--header '%s=%s' \ ", $header_key, $header['value']);
+        }
+        if (!is_null($body = $this->prepareBody())) {
+            $output[] = "\t--body-data '$body' \ ";
+        }
+        $output[] = rtrim(array_pop($output), '\ ');
+        $output[] = "\t'$this->url'";
+        return implode(PHP_EOL, $output);
+    }
+}

src/FileSystem.php

@@ -0,0 +1,95 @@
+<?php
+
+declare(strict_types = 1);
+
+namespace PmConverter;
+
+use PmConverter\Exceptions\{
+    CannotCreateDirectoryException,
+    DirectoryIsNotReadableException,
+    DirectoryIsNotWriteableException,
+    DirectoryNotExistsException};
+
+class FileSystem
+{
+    public static function normalizePath(string $path): string
+    {
+        $path = str_replace('~', $_SERVER['HOME'], $path);
+        return rtrim($path, DIRECTORY_SEPARATOR);
+    }
+
+    /**
+     * @param string $path
+     * @return string
+     * @throws CannotCreateDirectoryException
+     * @throws DirectoryIsNotWriteableException
+     */
+    public static function makeDir(string $path): string
+    {
+        $path = static::normalizePath($path);
+        if (!file_exists($path)) {
+            mkdir($path, recursive: true)
+                || throw new CannotCreateDirectoryException("cannot create output directory: $path");
+        }
+        if (!is_writable($path)) {
+            throw new DirectoryIsNotWriteableException("output directory permissions are not valid: $path");
+        }
+        return $path;
+    }
+
+    /**
+     * @param string $path
+     * @return void
+     * @throws DirectoryIsNotReadableException
+     * @throws DirectoryIsNotWriteableException
+     * @throws DirectoryNotExistsException
+     */
+    public static function removeDir(string $path): void
+    {
+        $path = static::normalizePath($path);
+        $dir_contents = static::dirContents($path);
+        foreach ($dir_contents as $record) {
+            is_dir($record) ? static::removeDir($record) : @unlink($record);
+        }
+        file_exists($path) && @rmdir($path);
+    }
+
+    /**
+     * @param string $path
+     * @return bool
+     * @throws DirectoryIsNotWriteableException
+     * @throws DirectoryNotExistsException
+     * @throws DirectoryIsNotReadableException
+     */
+    public static function checkDir(string $path): bool
+    {
+        $path = static::normalizePath($path);
+        if (!file_exists($path)) {
+            throw new DirectoryNotExistsException("output directory is not exist: $path");
+        }
+        if (!is_readable($path)) {
+            throw new DirectoryIsNotReadableException("output directory permissions are not valid: $path");
+        }
+        if (!is_writable($path)) {
+            throw new DirectoryIsNotWriteableException("output directory permissions are not valid: $path");
+        }
+        return true;
+    }
+
+    /**
+     * @param string $path
+     * @return array
+     * @throws DirectoryIsNotReadableException
+     * @throws DirectoryIsNotWriteableException
+     * @throws DirectoryNotExistsException
+     */
+    public static function dirContents(string $path): array
+    {
+        $path = static::normalizePath($path);
+        $records = array_diff(@scandir($path) ?: [], ['.', '..']);
+        foreach ($records as &$record) {
+            $record = sprintf('%s%s%s', $path, DIRECTORY_SEPARATOR, $record);
+        }
+        return $records;
+    }
+}

src/Processor.php

@@ -0,0 +1,264 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PmConverter;
+
+use Exception;
+use InvalidArgumentException;
+use JsonException;
+use PmConverter\Exceptions\CannotCreateDirectoryException;
+use PmConverter\Exceptions\DirectoryIsNotReadableException;
+use PmConverter\Exceptions\DirectoryIsNotWriteableException;
+use PmConverter\Exceptions\DirectoryNotExistsException;
+use PmConverter\Exporters\ConverterContract;
+use PmConverter\Exporters\ConvertFormat;
+
+/**
+ *
+ */
+class Processor
+{
+    /**
+     * Converter version
+     */
+    public const VERSION = '1.0.0';
+
+    /**
+     * @var string[] Paths to collection files
+     */
+    protected array $collectionPaths;
+
+    /**
+     * @var string Output path where to put results in
+     */
+    protected string $outputPath;
+
+    /**
+     * @var bool Flag to remove output directories or not before conversion started
+     */
+    protected bool $preserveOutput = false;
+
+    /**
+     * @var ConvertFormat[] Formats to convert a collections into
+     */
+    protected array $formats;
+
+    /**
+     * @var ConverterContract[] Converters will be used for conversion according to choosen formats
+     */
+    protected array $converters = [];
+
+    /**
+     * @var object[] Collections that will be converted into choosen formats
+     */
+    protected array $collections;
+
+    /**
+     * Constructor
+     *
+     * @param array $argv Arguments came from cli
+     */
+    public function __construct(protected array $argv)
+    {
+    }
+
+    /**
+     * Parses an array of arguments came from cli
+     *
+     * @return void
+     * @throws DirectoryIsNotWriteableException
+     * @throws DirectoryNotExistsException
+     * @throws DirectoryIsNotReadableException
+     */
+    protected function parseArgs(): void
+    {
+        if (count($this->argv) < 2) {
+            die(implode(PHP_EOL, $this->usage()) . PHP_EOL);
+        }
+        foreach ($this->argv as $idx => $arg) {
+            switch ($arg) {
+                case '-f':
+                case '--file':
+                    $path = $this->argv[$idx + 1];
+                    if (empty($path) || !str_ends_with($path, '.json') || !file_exists($path) || !is_readable($path)) {
+                        throw new InvalidArgumentException('a valid json-file path is expected for -f (--file)');
+                    }
+                    $this->collectionPaths[] = $this->argv[$idx + 1];
+                    break;
+                case '-o':
+                case '--output':
+                    if (empty($this->argv[$idx + 1])) {
+                        throw new InvalidArgumentException('-o expected');
+                    }
+                    $this->outputPath = $this->argv[$idx + 1];
+                    break;
+                case '-d':
+                case '--dir':
+                    if (empty($this->argv[$idx + 1])) {
+                        throw new InvalidArgumentException('a directory path is expected for -d (--dir)');
+                    }
+                    $path = $this->argv[$idx + 1];
+                    if (FileSystem::checkDir($path)) {
+                        $files = array_filter(
+                            FileSystem::dirContents($path),
+                            static fn($filename) => str_ends_with($filename, '.json')
+                        );
+                        $this->collectionPaths = array_unique(array_merge($this?->collectionPaths ?? [], $files));
+                    }
+                    break;
+                case '-p':
+                case '--preserve':
+                    $this->preserveOutput = true;
+                    break;
+                case '--http':
+                    $this->formats[ConvertFormat::Http->name] = ConvertFormat::Http;
+                    break;
+                case '--curl':
+                    $this->formats[ConvertFormat::Curl->name] = ConvertFormat::Curl;
+                    break;
+                case '--wget':
+                    $this->formats[ConvertFormat::Wget->name] = ConvertFormat::Wget;
+                    break;
+                case '-v':
+                case '--version':
+                    die(implode(PHP_EOL, $this->version()) . PHP_EOL);
+                case '-h':
+                case '--help':
+                    die(implode(PHP_EOL, $this->usage()) . PHP_EOL);
+            }
+        }
+        if (empty($this->formats)) {
+            $this->formats = [ConvertFormat::Http->name => ConvertFormat::Http];
+        }
+    }
+
+    /**
+     * @return void
+     * @throws CannotCreateDirectoryException
+     * @throws DirectoryIsNotWriteableException
+     * @throws DirectoryNotExistsException
+     * @throws DirectoryIsNotReadableException
+     */
+    protected function initOutputDirectory(): void
+    {
+        if (isset($this?->outputPath) && !$this->preserveOutput) {
+            FileSystem::removeDir($this->outputPath);
+        }
+        FileSystem::makeDir($this->outputPath);
+    }
+
+    /**
+     * Initializes converters according to choosen formats
+     *
+     * @return void
+     */
+    protected function initConverters(): void
+    {
+        foreach ($this->formats as $type) {
+            $this->converters[$type->name] = new $type->value($this->preserveOutput);
+        }
+    }
+
+    /**
+     * @throws JsonException
+     */
+    protected function initCollections(): void
+    {
+        foreach ($this->collectionPaths as $collectionPath) {
+            $content = file_get_contents(FileSystem::normalizePath($collectionPath));
+            $content = json_decode($content, flags: JSON_THROW_ON_ERROR);
+            if (!property_exists($content, 'collection') || empty($content?->collection)) {
+                throw new JsonException("not a valid collection: $collectionPath");
+            }
+            $this->collections[$content->collection->info->name] = $content->collection;
+        }
+    }
+
+    /**
+     * Begins a conversion
+     *
+     * @throws Exception
+     */
+    public function start(): void
+    {
+        $this->parseArgs();
+        $this->initOutputDirectory();
+        $this->initConverters();
+        $this->initCollections();
+        print(implode(PHP_EOL, array_merge($this->version(), $this->copyright())) . PHP_EOL . PHP_EOL);
+        foreach ($this->collections as $collectionName => $collection) {
+            print("Converting '$collectionName':" . PHP_EOL);
+            foreach ($this->converters as $type => $exporter) {
+                print("\t-> " . strtolower($type));
+                $outputPath = sprintf('%s%s%s', $this->outputPath, DIRECTORY_SEPARATOR, $collectionName);
+                $exporter->convert($collection, $outputPath);
+                printf("\t- OK: %s%s", $exporter->getOutputPath(), PHP_EOL);
+            }
+        }
+    }
+
+    /**
+     * @return string[]
+     */
+    protected function version(): array
+    {
+        return ["Postman collection converter v" . self::VERSION];
+    }
+
+    /**
+     * @return string[]
+     */
+    protected function copyright(): array
+    {
+        return [
+            'Anthony Axenov (c) ' . date('Y') . ", MIT license",
+            'https://git.axenov.dev/anthony/pm-convert'
+        ];
+    }
+
+    /**
+     * @return array
+     */
+    protected function usage(): array
+    {
+        return array_merge($this->version(), [
+            'Usage:',
+            "\t./pm-convert -f|-d PATH -o OUTPUT_PATH [ARGUMENTS] [FORMATS]",
+            "\tphp pm-convert -f|-d PATH -o OUTPUT_PATH [ARGUMENTS] [FORMATS]",
+            "\tcomposer pm-convert -f|-d PATH -o OUTPUT_PATH [ARGUMENTS] [FORMATS]",
+            "\t./vendor/bin/pm-convert -f|-d PATH -o OUTPUT_PATH [ARGUMENTS] [FORMATS]",
+            '',
+            'Possible ARGUMENTS:',
+            "\t-f, --file       - a PATH to single collection located in PATH to convert from",
+            "\t-d, --dir        - a directory with collections located in COLLECTION_FILEPATH to convert from",
+            "\t-o, --output     - a directory OUTPUT_PATH to put results in",
+            "\t-p, --preserve   - do not delete OUTPUT_PATH (if exists)",
+            "\t-h, --help       - show this help message and exit",
+            "\t-v, --version    - show version info and exit",
+            '',
+            'If no ARGUMENTS passed then --help implied.',
+            'If both -c and -d are specified then only unique set of files will be converted.',
+            '-f or -d are required to be specified at least once, but each may be specified multiple times.',
+            'PATH must be a valid path to readable json-file or directory.',
+            'OUTPUT_PATH must be a valid path to writeable directory.',
+            'If -o is specified several times then only last one will be used.',
+            '',
+            'Possible FORMATS:',
+            "\t--http   - generate raw *.http files (default)",
+            "\t--curl   - generate shell scripts with curl command",
+            "\t--wget   - generate shell scripts with wget command",
+            'If no FORMATS specified then --http implied.',
+            'Any of FORMATS can be specified at the same time.',
+            '',
+            'Example:',
+            "    ./pm-convert \ ",
+            "        -f ~/dir1/first.postman_collection.json \ ",
+            "        --directory ~/team \ ",
+            "        --file ~/dir2/second.postman_collection.json \ ",
+            "        -d ~/personal \ ",
+            "        -o ~/postman_export ",
+            "",
+        ], $this->copyright());
+    }
+}