Merge pull request 'v1.6.0' (#16) from dev into master

Reviewed-on: #16

.gitignore

@@ -1,3 +1,5 @@
 /.idea
 /.vscode
 /vendor
+.phpunit.result.cache
+.phpunit.cache

README.md

@@ -8,14 +8,17 @@ Without 3rd-party dependencies.
 
 These formats are supported for now: `http`, `curl`, `wget`.
 
-> This project was quickly written in my spare time to solve one exact problem in one NDA-project, so it may
-> contain stupid errors and (for sure) doesn't cover all possible cases according to collection schema.
-> So feel free to propose your improvements.
+> This project has been started and quickly written in my spare time to solve one exact problem in one NDA-project,
+> so it may contain stupid errors and (for sure) doesn't cover all possible cases according to collection schema.
+> Feel free to propose your improvements.
+
+Versions older than the latest are not supported, only current one is.
+If you found an error in old version please ensure if an error you found has been fixed in latest version.
+So please always use the latest version of `pm-convert`.
 
 ## Supported features
 
-* [collection schema **v2.1**](https://schema.postman.com/json/collection/v2.1.0/collection.json);
-* `Bearer` auth;
+* collection schemas [**v2.1**](https://schema.postman.com/json/collection/v2.1.0/collection.json) and [**v2.0**](https://schema.postman.com/json/collection/v2.0.0/collection.json);
 * replace vars in requests by stored in collection and environment file;
 * export one or several collections (or even whole directories) into one or all of formats supported at the same time;
 * all headers (including disabled for `http`-format);
@@ -25,17 +28,18 @@ These formats are supported for now: `http`, `curl`, `wget`.
 ## Planned features
 
 - support as many as possible/necessary of authentication kinds (_currently only `Bearer` supported_);
-- support as many as possible/necessary of body formats (_currently only `json` and `formdata`_);
-- documentation generation support (markdown) with responce examples (if present);
+- support as many as possible/necessary of body formats (_currently only `json` and `formdata` supported_);
+- documentation generation support (markdown) with response examples (if present) (#6);
 - maybe some another convert formats (like httpie or something...);
 - better logging;
-- tests, phpcs, psalm, etc.;
+- 90%+ test coverage, phpcs, psalm, etc.;
 - web version.
 
-## Installation
+## Install and upgrade
 
 ```
-composer global r axenov/pm-convert
+composer global r axenov/pm-convert   # install
+composer global u axenov/pm-convert   # upgrade
 ```
 
 Make sure your `~/.config/composer/vendor/bin` is in `$PATH` env:
@@ -58,45 +62,145 @@ Usage:
         ./vendor/bin/pm-convert -f|-d PATH -o OUTPUT_PATH [ARGUMENTS] [FORMATS]
 
 Possible ARGUMENTS:
-        -f, --file       - a PATH to single collection located in PATH to convert from
-        -d, --dir        - a directory with collections located in COLLECTION_FILEPATH to convert from
-        -o, --output     - a directory OUTPUT_PATH to put results in
-        -e, --env        - use environment file with variable values to replace in request
-        -p, --preserve   - do not delete OUTPUT_PATH (if exists)
-        -h, --help       - show this help message and exit
-        -v, --version    - show version info and exit
+        -f, --file          - a PATH to a single collection file to convert from
+        -d, --dir           - a PATH to a directory with collections to convert from
+        -o, --output        - a directory OUTPUT_PATH to put results in
+        -e, --env           - use environment file with variables to replace in requests
+        --var "NAME=VALUE"  - force replace specified env variable called NAME with custom VALUE
+        -p, --preserve      - do not delete OUTPUT_PATH (if exists)
+            --dump          - convert provided arguments into settings file in `pwd`
+        -h, --help          - show this help message and exit
+        -v, --version       - show version info and exit
 
 If no ARGUMENTS passed then --help implied.
-If both -f and -d are specified then only unique set of files will be converted.
+If both -f and -d are specified then only unique set of files from both arguments 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.
-If -e is specified several times then only last one will be used.
-If -e is not specified then only collection vars will be replaced (if any).
+If -o or -e was specified several times then only last one will be used.
 
 Possible FORMATS:
-        --http   - generate raw *.http files (default)
-        --curl   - generate shell scripts with curl command
-        --wget   - generate shell scripts with wget command
+        --http     - generate raw *.http files (default)
+        --curl     - generate shell scripts with curl command
+        --wget     - generate shell scripts with wget command
+        --v2.0     - convert from Postman Collection Schema v2.1 into v2.0
+        --v2.1     - convert from Postman Collection Schema v2.0 into v2.1
+        -a, --all  - convert to all of formats listed above
+
 If no FORMATS specified then --http implied.
-Any of FORMATS can be specified at the same time.
+Any of FORMATS can be specified at the same time or replaced by --all.
 
 Example:
-    ./pm-convert \ 
-        -f ~/dir1/first.postman_collection.json \ 
-        --directory ~/team \ 
-        --file ~/dir2/second.postman_collection.json \ 
-        --env ~/localhost.postman_environment.json \ 
-        -d ~/personal \ 
-        -o ~/postman_export 
+    ./pm-convert \
+        -f ~/dir1/first.postman_collection.json \
+        --directory ~/team \
+        --file ~/dir2/second.postman_collection.json \
+        --env ~/localhost.postman_environment.json \
+        -d ~/personal \
+        --var "myvar=some value" \
+        -o ~/postman_export \
+        --all
+```
+
+### Notices
+
+1. Result of `pm-convert` execution is bunch of generated files.
+   Most likely they will contain errors such as not interpolated `{{variables}}` values (due to missed ones in collection),
+   wrong command format or `GET`s with bodies.
+   You must review any generated file before using.
+2. Make sure every (I mean _every_) collection (not collection file), its folders and/or requests has unique names.
+   If not, you can rename them in Postman or convert collections with similar names into different directories.
+   Otherwise any generated file may be accidently overwritten by another one.
+
+## Notes about variable interpolation
+
+1. You can use -e to tell where to find variables to replace in requests.
+2. You can use one or several --var to replace specific env variables to your own value.
+3. Correct syntax is `--var "NAME=VALUE"`. `NAME` may be in curly braces like `{{NAME}}`.
+4. Since -e is optional, a bunch of `--var` will emulate an environment. Also it does not matter if there is `--var` in environment file you provided or not.
+5. Even if you (not) provided -e and/or `--var`, any of variable may still be overridden from collection (if any), so last ones has top priority.
+
+### Notes about conversion between Postman Schemas
+
+You can use `--v2.1` to convert v2.1 into v2.1 (and this is not a typo).
+Same applies to `--v2.0`.
+
+There is a case when a collection has been exported via Postman API.
+In such case collection itself places in single root object called `collection` like this:
 
 ```
-### Notice
+{
+   "collection": {
+      // your actual collection here
+   }
+}
+```
 
-Make sure every (I mean _every_) collection (not collection file), its folders and/or requests has unique names.
-If not, you can rename them in Postman or convert collections with similar names into different directories.
-Otherwise converted files may be overwritten by each other.
+So, pm-convert will just raise actual data up on top level and write into disk.
+
+## Settings file
+
+You may want to specify parameters once and just use them everytime without explicit defining arguments to `pm-convert`.
+
+This might be done in several ways.
+
+1. Save this file as `pm-convert-settings.json` in your project directory:
+
+   ```json
+   {
+       "directories": [],
+       "files": [],
+       "environment": "",
+       "output": "",
+       "preserveOutput": false,
+       "formats": [],
+       "vars": {}
+   }
+   ```
+   
+   Fill it with values you need.
+
+2. Add `--dump` at the end of your command and all arguments you provided will be converted and saved as
+   `pm-convert-settings.json` in your curent working directory. For example in `--help` file will contain this:
+
+   ```json
+   {
+       "directories": [
+           "~/team",
+           "~/personal"
+       ],
+       "files": [
+           "~/dir1/first.postman_collection.json",
+           "~/dir2/second.postman_collection.json"
+       ],
+       "environment": "~/localhost.postman_environment.json",
+       "output": "~/postman_export",
+       "preserveOutput": false,
+       "formats": [
+           "http",
+           "curl",
+           "wget",
+           "v2.0",
+           "v2.1"
+       ],
+       "vars": {
+           "myvar": "some value"
+       }
+   }
+   ```
+
+   If settings file already exists then you will be asked what to do: overwrite it, back it up or exit.
+
+Once settings file saved in current you can just run `pm-convert`.
+Settings will be applied like if you pass them explicitly via arguments.
+
+## How to implement a new format
+
+1. Create new namespace in `./src/Converters` and name it according to format of your choice.
+2. Create two classes for converter and request object which extends `Converters\Abstract\Abstract{Converter, Request}` respectively.
+3. Change constants values in your new request class according to format you want to implement.
+4. Add your converter class name in `Converters\ConvertFormat`.
+5. Write your own logic in converter, write new methods and override abstract ones.
 
 ## License
 

composer.json

@@ -1,7 +1,7 @@
 {
     "name": "axenov/pm-convert",
     "type": "library",
-    "description": "Postman collection coverter",
+    "description": "Postman collection converter",
     "license": "MIT",
     "homepage": "https://axenov.dev/",
     "authors": [
@@ -13,11 +13,11 @@
     "keywords": ["postman", "collection", "converter", "http", "wget", "curl", "api", "convert"],
     "require": {
         "php": "^8.1",
-        "ext-json": "*"
+        "ext-json": "*",
+        "ext-mbstring": "*",
+        "ext-readline": "*"
     },
-    "bin": [
-        "pm-convert"
-    ],
+    "bin": ["pm-convert"],
     "autoload": {
         "psr-4": {
             "PmConverter\\": "src\\"
@@ -30,5 +30,8 @@
         "optimize-autoloader": true,
         "preferred-install": "dist",
         "sort-packages": true
+    },
+    "require-dev": {
+        "phpunit/phpunit": "^10.3"
     }
 }

phpunit.xml

@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/10.3/phpunit.xsd"
+         bootstrap="vendor/autoload.php"
+         cacheDirectory=".phpunit.cache"
+         executionOrder="depends,defects"
+         requireCoverageMetadata="true"
+         beStrictAboutCoverageMetadata="true"
+         beStrictAboutOutputDuringTests="true"
+         failOnRisky="true"
+         failOnWarning="true">
+    <testsuites>
+        <testsuite name="Main">
+<!--            <directory>tests</directory>-->
+            <file>tests/AbstractRequestTest.php</file>
+            <file>tests/HttpRequestTest.php</file>
+            <file>tests/WgetRequestTest.php</file>
+        </testsuite>
+    </testsuites>
+
+    <source restrictDeprecations="true" restrictNotices="true" restrictWarnings="true">
+        <include>
+            <directory>src</directory>
+        </include>
+    </source>
+</phpunit>

pm-convert

@@ -2,6 +2,8 @@
 <?php
 
 declare(strict_types=1);
+const EOL = PHP_EOL;
+const DS = DIRECTORY_SEPARATOR;
 
 use PmConverter\Processor;
 
@@ -22,12 +24,12 @@ is_null($file) && throw new RuntimeException('Unable to locate autoload.php file
 
 $processor = new Processor($argv);
 try {
-    $processor->convert();
+    $processor->handle();
 } catch (InvalidArgumentException $e) {
-    fwrite(STDERR, sprintf('ERROR: %s%s', $e->getMessage(), PHP_EOL));
-    print(implode(PHP_EOL, $processor->usage()));
+    fwrite(STDERR, sprintf('ERROR: %s%s', $e->getMessage(), EOL));
+    print(implode(EOL, Processor::usage()));
     die(1);
 } catch (Exception $e) {
-    fwrite(STDERR, sprintf('ERROR: %s%s', $e->getMessage(), PHP_EOL));
+    fwrite(STDERR, sprintf('ERROR: %s%s', $e->getMessage(), EOL));
     die(1);
 }

src/Collection.php

@@ -0,0 +1,172 @@
+<?php
+
+declare(strict_types = 1);
+
+namespace PmConverter;
+
+use Exception;
+use Generator;
+use JsonException;
+use Stringable;
+
+/**
+ * Class that describes a request collection
+ *
+ * @property array|object $item
+ * @property object $info
+ * @property object|null $variable
+ */
+class Collection implements Stringable
+{
+    public readonly CollectionVersion $version;
+
+    /**
+     * Closed constructor so that we could use factory methods
+     *
+     * @param object $json
+     */
+    private function __construct(protected object $json)
+    {
+        // specific case when collection has been exported via postman api
+        if (property_exists($json, 'collection')) {
+            $json = $json->collection;
+        }
+        $this->json = $json;
+        $this->version = $this->detectVersion();
+    }
+
+    /**
+     * Factory that creates new Collection from content read from file path
+     *
+     * @param string $path
+     * @return static
+     * @throws JsonException
+     */
+    public static function fromFile(string $path): static
+    {
+        $content = file_get_contents(FileSystem::normalizePath($path));
+        $json = json_decode($content, flags: JSON_THROW_ON_ERROR);
+        return new static($json);
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function __toString(): string
+    {
+        return json_encode($this->json, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES);
+    }
+
+    /**
+     * Returns reference to the parsed json structure
+     *
+     * @return object
+     */
+    public function &raw(): object
+    {
+        return $this->json;
+    }
+
+    /**
+     * Returns reference to any part of the parsed json structure
+     *
+     * @param string $name
+     * @return mixed
+     */
+    public function &__get(string $name): mixed
+    {
+        return $this->json->$name;
+    }
+
+    /**
+     * Returns collection name
+     *
+     * @return string
+     */
+    public function name(): string
+    {
+        return $this->json->info->name;
+    }
+
+    /**
+     * Returns the collection version
+     *
+     * @return CollectionVersion
+     */
+    protected function detectVersion(): CollectionVersion
+    {
+        return match (true) {
+            str_contains($this->json->info->schema, '/v2.0.') => CollectionVersion::Version20,
+            str_contains($this->json->info->schema, '/v2.1.') => CollectionVersion::Version21,
+            default => CollectionVersion::Unknown
+        };
+    }
+
+    /**
+     * Returns the collection version from raw file
+     *
+     * @param string $filepath
+     * @return CollectionVersion
+     * @throws Exception
+     */
+    public static function detectFileVersion(string $filepath): CollectionVersion
+    {
+        $handle = fopen($filepath, 'r');
+        if ($handle === false) {
+            throw new Exception("Cannot open file for reading: $filepath");
+        }
+        $content = '';
+        // Postman collection files may be HUGE and I don't need to parse
+        // them here to find value .info.schema field because normally it
+        // is stored at the beginning of a file, so if it's not then this
+        // is a user problem, not mine.
+        while (\mb_strlen($content) <= 2048) {
+            $content .= fgets($handle, 50);
+            if (str_contains($content, 'https://schema.getpostman.com/json/collection')) {
+                if (str_contains($content, '/v2.0.')) {
+                    return CollectionVersion::Version20;
+                }
+                if (str_contains($content, '/v2.1.')) {
+                    return CollectionVersion::Version21;
+                }
+            }
+        }
+        return CollectionVersion::Unknown;
+    }
+
+    /**
+     * Iterates over collection request items and returns item associated by its path in folder
+     *
+     * @param mixed|null $item
+     * @return Generator
+     */
+    public function iterate(mixed $item = null): Generator
+    {
+        $is_recursive = !is_null($item);
+        $folder = $is_recursive ? $item : $this->json;
+        static $dir_tree;
+        $path = DS . ($is_recursive ? implode(DS, $dir_tree ?? []) : '');
+        foreach ($folder->item as $subitem) {
+            if ($this->isItemFolder($subitem)) {
+                $dir_tree[] = $subitem->name;
+                yield from $this->iterate($subitem);
+                continue;
+            }
+            yield $path => $subitem;
+        }
+        $is_recursive && array_pop($dir_tree);
+    }
+
+    /**
+     * Checks whether item contains another items or not
+     *
+     * @param object $item
+     * @return bool
+     */
+    protected function isItemFolder(object $item): bool
+    {
+        return !empty($item->item)
+            && is_array($item->item)
+            && empty($item->request);
+    }
+}

src/CollectionVersion.php

@@ -0,0 +1,12 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PmConverter;
+
+enum CollectionVersion: string
+{
+    case Version20 = 'v2.0';
+    case Version21 = 'v2.1';
+    case Unknown = 'unknown';
+}

src/Converters/Abstract/AbstractConverter.php

@@ -0,0 +1,189 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PmConverter\Converters\Abstract;
+
+use Exception;
+use Iterator;
+use PmConverter\Collection;
+use PmConverter\Converters\RequestContract;
+use PmConverter\Environment;
+use PmConverter\Exceptions\CannotCreateDirectoryException;
+use PmConverter\Exceptions\DirectoryIsNotWriteableException;
+use PmConverter\Exceptions\InvalidHttpVersionException;
+use PmConverter\FileSystem;
+
+/**
+ *
+ */
+abstract class AbstractConverter
+{
+    /**
+     * @var Collection|null
+     */
+    protected ?Collection $collection = null;
+
+    /**
+     * @var string
+     */
+    protected string $outputPath;
+
+    /**
+     * @var RequestContract[] Converted requests
+     */
+    protected array $requests = [];
+
+    /**
+     * Sets output path
+     *
+     * @param string $outputPath
+     * @return $this
+     */
+    public function to(string $outputPath): self
+    {
+        $this->outputPath = sprintf('%s%s%s', $outputPath, DS, static::OUTPUT_DIR);
+        return $this;
+    }
+
+    /**
+     * Converts requests from collection
+     *
+     * @param Collection $collection
+     * @return static
+     * @throws CannotCreateDirectoryException
+     * @throws DirectoryIsNotWriteableException
+     * @throws Exception
+     */
+    public function convert(Collection $collection): static
+    {
+        $this->collection = $collection;
+        $this->outputPath = FileSystem::makeDir($this->outputPath);
+        $this->setCollectionVars();
+        foreach ($collection->iterate() as $path => $item) {
+            // $this->requests[$path][] = $this->makeRequest($item);
+            $this->writeRequest($this->makeRequest($item), $path);
+        }
+        return $this;
+    }
+
+    /**
+     * Returns converted requests
+     *
+     * @return Iterator<string, RequestContract>
+     */
+    public function converted(): Iterator
+    {
+        foreach ($this->requests as $path => $requests) {
+            foreach ($requests as $request) {
+                yield $path => $request;
+            }
+        }
+    }
+
+    /**
+     * Writes requests on disk
+     *
+     * @throws Exception
+     */
+    public function flush(): void
+    {
+        foreach ($this->converted() as $path => $request) {
+            $this->writeRequest($request, $path);
+        }
+    }
+
+    /**
+     * Prepares collection variables
+     *
+     * @return $this
+     */
+    protected function setCollectionVars(): static
+    {
+        foreach ($this->collection?->variable ?? [] as $var) {
+            Environment::instance()->setCustomVar($var->key, $var->value);
+        }
+        return $this;
+    }
+
+    /**
+     * Returns output path
+     *
+     * @return string
+     */
+    public function getOutputPath(): string
+    {
+        return $this->outputPath;
+    }
+
+    /**
+     * Checks whether item contains another items or not
+     *
+     * @param object $item
+     * @return bool
+     */
+    protected function isItemFolder(object $item): bool
+    {
+        return !empty($item->item)
+            && is_array($item->item)
+            && empty($item->request);
+    }
+
+    /**
+     * Initialiazes request object to be written in file
+     *
+     * @param object $item
+     * @return RequestContract
+     * @throws InvalidHttpVersionException
+     */
+    protected function makeRequest(object $item): RequestContract
+    {
+        $request_class = static::REQUEST_CLASS;
+
+        /** @var RequestContract $request */
+        $request = new $request_class();
+        $request->setName($item->name);
+        $request->setVersion($this->collection->version);
+        $request->setHttpVersion(1.1); //TODO http version?
+        $request->setDescription($item->request?->description ?? null);
+        $request->setVerb($item->request->method);
+        $request->setUrl($item->request->url);
+        $request->setHeaders($item->request->header);
+        $request->setAuth($item->request?->auth ?? $this->collection?->auth ?? null);
+        if ($item->request->method !== 'GET' && !empty($item->request->body)) {
+            $request->setBody($item->request->body);
+        }
+        return $request;
+    }
+
+    /**
+     * Writes converted request object to file
+     *
+     * @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, DS, $subpath);
+        $filedir = FileSystem::makeDir($filedir);
+        $filepath = sprintf('%s%s%s.%s', $filedir, DS, $request->getName(), static::FILE_EXT);
+        $content = $this->interpolate((string)$request);
+        return file_put_contents($filepath, $content) > 0;
+    }
+
+    /**
+     * Replaces variables in request with values from collection or environment
+     *
+     * @param string $content
+     * @return string
+     */
+    protected function interpolate(string $content): string
+    {
+        $replace = static fn ($a) => Environment::instance()->var($var = $a[0]) ?: $var;
+        return Environment::instance()->hasVars()
+            ? preg_replace_callback('/\{\{.*}}/m', $replace, $content)
+            : $content;
+    }
+}

src/Converters/Abstract/AbstractRequest.php

@@ -0,0 +1,309 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PmConverter\Converters\Abstract;
+
+use PmConverter\CollectionVersion;
+use PmConverter\Converters\RequestContract;
+use PmConverter\Exceptions\EmptyHttpVerbException;
+use PmConverter\Exceptions\InvalidHttpVersionException;
+use PmConverter\HttpVersion;
+use Stringable;
+
+/**
+ * Class to determine file content with any request format
+ */
+abstract class AbstractRequest implements Stringable, RequestContract
+{
+    /**
+     * @var string HTTP verb (GET, POST, etc.)
+     */
+    protected string $verb;
+
+    /**
+     * @var object|string URL where to send a request
+     */
+    protected object|string $url;
+
+    /**
+     * @var float HTTP protocol version
+     */
+    protected float $httpVersion = 1.1;
+
+    /**
+     * @var string Request name
+     */
+    protected string $name;
+
+    /**
+     * @var string|null Request description
+     */
+    protected ?string $description = null;
+
+    /**
+     * @var array Request headers
+     */
+    protected array $headers = [];
+
+    /**
+     * @var mixed Request body
+     */
+    protected mixed $body = null;
+
+    /**
+     * @var string Request body type
+     */
+    protected string $bodymode = 'raw';
+
+
+    protected CollectionVersion $version;
+
+    public function setVersion(CollectionVersion $version): static
+    {
+        $this->version = $version;
+        return $this;
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function setHttpVersion(float $version): static
+    {
+        if (!in_array($version, HttpVersion::values())) {
+            throw new InvalidHttpVersionException(
+                'Only these HTTP versions are supported: ' . implode(', ', HttpVersion::values())
+            );
+        }
+        $this->httpVersion = $version;
+        return $this;
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function getHttpVersion(): float
+    {
+        return $this->httpVersion;
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function setName(string $name): static
+    {
+        $this->name = $name;
+        return $this;
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function getName(): string
+    {
+        return str_replace(DS, '_', $this->name);
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function setDescription(?string $description): static
+    {
+        $this->description = $description;
+        return $this;
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function getDescription(): ?string
+    {
+        return $this->description;
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function setVerb(string $verb): static
+    {
+        $this->verb = $verb;
+        return $this;
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function getVerb(): string
+    {
+        empty($this->verb) && throw new EmptyHttpVerbException('Request HTTP verb must be defined before conversion');
+        return $this->verb;
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function setUrl(object|string $url): static
+    {
+        $this->url = $url;
+        return $this;
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function getRawUrl(): string
+    {
+        return is_object($this->url) ? $this->url->raw : $this->url;
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function setHeaders(?array $headers): static
+    {
+        foreach ($headers as $header) {
+            $this->setHeader($header->key, $header->value, $header?->disabled ?? false);
+        }
+        return $this;
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function setHeader(string $name, mixed $value, bool $disabled = false): static
+    {
+        $this->headers[$name] = [
+            'value' => $value,
+            'disabled' => $disabled,
+        ];
+        return $this;
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function getHeaders(): array
+    {
+        return $this->headers;
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function setAuth(?object $auth): static
+    {
+        if (!empty($auth)) {
+            switch ($auth->type) {
+                case 'bearer':
+                    $this->setHeader('Authorization', 'Bearer ' . match ($this->version) {
+                        CollectionVersion::Version20 => $auth->{$auth->type}->token,
+                        CollectionVersion::Version21 => $auth->{$auth->type}[0]->value,
+                        default => null
+                    });
+                    break;
+                default:
+                    break;
+            }
+        }
+        return $this;
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function setBodymode(string $bodymode): static
+    {
+        $this->bodymode = $bodymode;
+        return $this;
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function getBodymode(): string
+    {
+        return $this->bodymode;
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function setBody(object $body): static
+    {
+        $this->setBodymode($body->mode);
+        if ($body->mode === 'formdata') {
+            $this->setHeader('Content-Type', 'multipart/form-data')->setFormdataBody($body);
+        } elseif ($body->mode === 'raw') {
+            $this->setBodyAsIs($body);
+            if (!empty($body->options) && $body->options->{$this->bodymode}->language === 'json') {
+                $this->setHeader('Content-Type', 'application/json');
+            }
+        }
+        return $this;
+    }
+
+    /**
+     * Sets body content from multipart/formdata
+     *
+     * @param object $body
+     * @return $this
+     */
+    protected function setFormdataBody(object $body): static
+    {
+        foreach ($body->formdata as $field) {
+            $this->body[$field->key] = [
+                'value' => $field->type === 'file' ? $field->src : $field->value,
+                'type' => $field->type,
+            ];
+        }
+        return $this;
+    }
+
+    /**
+     * Sets body content from application/json
+     *
+     * @param object $body
+     * @return $this
+     */
+    protected function setBodyAsIs(object $body): static
+    {
+        $this->body = $body->{$this->getBodymode()};
+        return $this;
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function getBody(): mixed
+    {
+        return $this->body;
+    }
+
+    /**
+     * Returns array of description lines
+     *
+     * @return array
+     */
+    abstract protected function prepareDescription(): array;
+
+    /**
+     * Returns array of headers
+     *
+     * @return array
+     */
+    abstract protected function prepareHeaders(): array;
+
+    /**
+     * Returns array of request body lines
+     *
+     * @return array
+     */
+    abstract protected function prepareBody(): array;
+
+    /**
+     * Converts request object to string to be written in result file
+     *
+     * @return string
+     */
+    abstract public function __toString(): string;
+}

src/Converters/ConvertFormat.php

@@ -0,0 +1,43 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PmConverter\Converters;
+
+
+use PmConverter\Converters\Curl\CurlConverter;
+use PmConverter\Converters\Http\HttpConverter;
+use PmConverter\Converters\Postman20\Postman20Converter;
+use PmConverter\Converters\Postman21\Postman21Converter;
+use PmConverter\Converters\Wget\WgetConverter;
+
+enum ConvertFormat: string
+{
+    case Http = HttpConverter::class;
+    case Curl = CurlConverter::class;
+    case Wget = WgetConverter::class;
+    case Postman20 = Postman20Converter::class;
+    case Postman21 = Postman21Converter::class;
+
+    public static function fromArg(string $arg): self
+    {
+        return match ($arg) {
+            'http' => ConvertFormat::Http,
+            'curl' => ConvertFormat::Curl,
+            'wget' => ConvertFormat::Wget,
+            'v2.0' => ConvertFormat::Postman20,
+            'v2.1' => ConvertFormat::Postman21,
+        };
+    }
+
+    public function toArg(): string
+    {
+        return match ($this) {
+            ConvertFormat::Http => 'http',
+            ConvertFormat::Curl => 'curl',
+            ConvertFormat::Wget => 'wget',
+            ConvertFormat::Postman20 => 'v2.0',
+            ConvertFormat::Postman21 => 'v2.1',
+        };
+    }
+}

src/Converters/ConverterContract.php

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

src/Converters/Curl/CurlConverter.php

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

src/Converters/Curl/CurlRequest.php

@@ -2,9 +2,9 @@
 
 declare(strict_types=1);
 
-namespace PmConverter\Exporters\Curl;
+namespace PmConverter\Converters\Curl;
 
-use PmConverter\Exporters\Abstract\AbstractRequest;
+use PmConverter\Converters\Abstract\AbstractRequest;
 
 /**
  * Class to determine file content with curl request format
@@ -31,7 +31,7 @@ class CurlRequest extends AbstractRequest
             if ($header['disabled']) {
                 continue;
             }
-            $output[] = sprintf("\t--header '%s=%s' \ ", $header_key, $header['value']);
+            $output[] = sprintf("\t--header '%s: %s' \ ", $header_key, $header['value']);
         }
         return $output;
     }
@@ -44,12 +44,12 @@ class CurlRequest extends AbstractRequest
         $output = [];
         switch ($this->bodymode) {
             case 'formdata':
-                foreach ($this->body as $data) {
+                foreach ($this->body as $key => $data) {
                     $output[] = sprintf(
                         "%s\t--form '%s=%s' \ ",
-                        isset($data->disabled) ? '# ' : '',
-                        $data->key,
-                        $data->type === 'file' ? "@$data->src" : $data->value
+                        isset($data['disabled']) ? '# ' : '',
+                        $key,
+                        $data['type'] === 'file' ? "@" . $data['value'] : $data['value']
                     );
                 }
                 break;
@@ -72,12 +72,12 @@ class CurlRequest extends AbstractRequest
                 "curl \ ",
                 "\t--http1.1 \ ", //TODO proto
                 "\t--request $this->verb \ ",
-                "\t--location $this->url \ ",
+                "\t--location {$this->getRawUrl()} \ ",
             ],
             $this->prepareHeaders(),
             $this->prepareBody()
         );
         $output[] = rtrim(array_pop($output), '\ ');
-        return implode(PHP_EOL, array_merge($output, ['']));
+        return implode(EOL, array_merge($output, ['']));
     }
 }

src/Converters/Http/HttpConverter.php

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

src/Converters/Http/HttpRequest.php

@@ -2,9 +2,10 @@
 
 declare(strict_types=1);
 
-namespace PmConverter\Exporters\Http;
+namespace PmConverter\Converters\Http;
 
-use PmConverter\Exporters\Abstract\AbstractRequest;
+use PmConverter\Converters\Abstract\AbstractRequest;
+use PmConverter\Exceptions\EmptyHttpVerbException;
 
 /**
  * Class to determine file content with http request format
@@ -23,12 +24,13 @@ class HttpRequest extends AbstractRequest
 
     /**
      * @inheritDoc
+     * @throws EmptyHttpVerbException
      */
     protected function prepareHeaders(): array
     {
-        $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[] = sprintf('%s %s HTTP/%s', $this->getVerb(), $this->getRawUrl(), $this->getHttpVersion());
+        foreach ($this->headers as $name => $data) {
+            $output[] = sprintf('%s%s: %s', $data['disabled'] ? '# ' : '', $name, $data['value']);
         }
         return $output;
     }
@@ -38,15 +40,15 @@ class HttpRequest extends AbstractRequest
      */
     protected function prepareBody(): array
     {
-        switch ($this->bodymode) {
+        switch ($this->getBodymode()) {
             case 'formdata':
                 $output = [''];
-                foreach ($this->body as $data) {
+                foreach ($this->body as $key => $data) {
                     $output[] = sprintf(
                         '%s%s=%s',
-                        empty($data->disabled) ? '' : '# ',
-                        $data->key,
-                        $data->type === 'file' ? $data->src : $data->value
+                        empty($data['disabled']) ? '' : '# ',
+                        $key,
+                        $data['type'] === 'file' ? '@' . $data['value'] : $data['value']
                     );
                 }
                 return $output;
@@ -57,6 +59,7 @@ class HttpRequest extends AbstractRequest
 
     /**
      * @inheritDoc
+     * @throws EmptyHttpVerbException
      */
     public function __toString(): string
     {
@@ -65,6 +68,6 @@ class HttpRequest extends AbstractRequest
             $this->prepareHeaders(),
             $this->prepareBody()
         );
-        return implode(PHP_EOL, $output);
+        return implode(EOL, $output);
     }
 }

src/Converters/Postman20/Postman20Converter.php

@@ -0,0 +1,135 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PmConverter\Converters\Postman20;
+
+use PmConverter\Collection;
+use PmConverter\CollectionVersion;
+use PmConverter\Converters\Abstract\AbstractConverter;
+use PmConverter\Exceptions\CannotCreateDirectoryException;
+use PmConverter\Exceptions\DirectoryIsNotWriteableException;
+use PmConverter\FileSystem;
+
+/**
+ * Converts Postman Collection v2.1 to v2.0
+ */
+class Postman20Converter extends AbstractConverter
+{
+    protected const FILE_EXT = 'v20.postman_collection.json';
+
+    protected const OUTPUT_DIR = 'pm-v2.0';
+
+    /**
+     * Converts collection requests
+     *
+     * @param Collection $collection
+     * @return static
+     * @throws CannotCreateDirectoryException
+     * @throws DirectoryIsNotWriteableException
+     */
+    public function convert(Collection $collection): static
+    {
+        $this->collection = $collection;
+        // if data was exported from API, here is already valid json to
+        // just flush it in file, otherwise we need to convert it deeper
+        if ($this->collection->version === CollectionVersion::Version21) {
+            $this->collection->info->schema = str_replace('/v2.1.', '/v2.0.', $this->collection->info->schema);
+            $this->convertAuth($this->collection->raw());
+            foreach ($this->collection->item as $item) {
+                $this->convertItem($item);
+            }
+        }
+        $this->outputPath = FileSystem::makeDir($this->outputPath);
+        $this->writeCollection();
+        return $this;
+    }
+
+    /**
+     * Writes converted collection into file
+     *
+     * @return bool
+     * @throws CannotCreateDirectoryException
+     * @throws DirectoryIsNotWriteableException
+     */
+    protected function writeCollection(): bool
+    {
+        $filedir = FileSystem::makeDir($this->outputPath);
+        $filepath = sprintf('%s%s%s.%s', $filedir, DS, $this->collection->name(), static::FILE_EXT);
+        return file_put_contents($filepath, $this->collection) > 0;
+    }
+
+    /**
+     * Changes some requests fields in place
+     *
+     * @param mixed $item
+     * @return void
+     */
+    protected function convertItem(mixed $item): void
+    {
+        if ($this->isItemFolder($item)) {
+            foreach ($item->item as $subitem) {
+                if ($this->isItemFolder($subitem)) {
+                    $this->convertItem($subitem);
+                } else {
+                    $this->convertAuth($subitem->request);
+                    $this->convertRequestUrl($subitem->request);
+                    $this->convertResponseUrls($subitem->response);
+                }
+            }
+        } else {
+            $this->convertAuth($item->request);
+            $this->convertRequestUrl($item->request);
+            $this->convertResponseUrls($item->response);
+        }
+    }
+
+    /**
+     * Converts auth object from v2.1 to v2.0
+     *
+     * @param object $request
+     * @return void
+     */
+    protected function convertAuth(object $request): void
+    {
+        if (empty($request->auth)) {
+            return;
+        }
+        $auth = ['type' => 'noauth'];
+        $type = strtolower($request->auth->type);
+        if ($type !== 'noauth') {
+            foreach ($request->auth->$type as $param) {
+                $auth[$param->key] = $param->value ?? '';
+            }
+            $request->auth->$type = (object)$auth;
+        }
+    }
+
+    /**
+     * Converts requests URLs from object v2.1 to string v2.0
+     *
+     * @param object $request
+     * @return void
+     */
+    protected function convertRequestUrl(object $request): void
+    {
+        if (is_object($request->url)) {
+            $request->url = $request->url->raw;
+        }
+    }
+
+    /**
+     * Converts URLs response examples from object v2.1 to string v2.0
+     *
+     * @param array $responses
+     * @return void
+     */
+    protected function convertResponseUrls(array $responses): void
+    {
+        foreach ($responses as $response) {
+            if (is_object($response->originalRequest->url)) {
+                $response->originalRequest->url = $response->originalRequest->url->raw;
+            }
+        }
+    }
+}

src/Converters/Postman21/Postman21Converter.php

@@ -0,0 +1,167 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PmConverter\Converters\Postman21;
+
+use PmConverter\Collection;
+use PmConverter\CollectionVersion;
+use PmConverter\Converters\Abstract\AbstractConverter;
+use PmConverter\Exceptions\CannotCreateDirectoryException;
+use PmConverter\Exceptions\DirectoryIsNotWriteableException;
+use PmConverter\FileSystem;
+
+/**
+ * Converts Postman Collection v2.0 to v2.1
+ */
+class Postman21Converter extends AbstractConverter
+{
+    protected const FILE_EXT = 'v21.postman_collection.json';
+
+    protected const OUTPUT_DIR = 'pm-v2.1';
+
+    /**
+     * Converts collection requests
+     *
+     * @param Collection $collection
+     * @return static
+     * @throws CannotCreateDirectoryException
+     * @throws DirectoryIsNotWriteableException
+     */
+    public function convert(Collection $collection): static
+    {
+        $this->collection = $collection;
+        // if data was exported from API, here is already valid json to
+        // just flush it in file, otherwise we need to convert it deeper
+        if ($this->collection->version === CollectionVersion::Version20) {
+            $this->collection->info->schema = str_replace('/v2.0.', '/v2.1.', $this->collection->info->schema);
+            $this->convertAuth($this->collection->raw());
+            foreach ($this->collection->item as $item) {
+                $this->convertItem($item);
+            }
+        }
+        $this->outputPath = FileSystem::makeDir($this->outputPath);
+        $this->writeCollection();
+        return $this;
+    }
+
+    /**
+     * Writes converted collection into file
+     *
+     * @return bool
+     * @throws CannotCreateDirectoryException
+     * @throws DirectoryIsNotWriteableException
+     */
+    protected function writeCollection(): bool
+    {
+        $filedir = FileSystem::makeDir($this->outputPath);
+        $filepath = sprintf('%s%s%s.%s', $filedir, DS, $this->collection->name(), static::FILE_EXT);
+        return file_put_contents($filepath, $this->collection) > 0;
+    }
+
+    /**
+     * Changes some requests fields in place
+     *
+     * @param mixed $item
+     * @return void
+     */
+    protected function convertItem(mixed $item): void
+    {
+        if ($this->isItemFolder($item)) {
+            foreach ($item->item as $subitem) {
+                if ($this->isItemFolder($subitem)) {
+                    $this->convertItem($subitem);
+                } else {
+                    $this->convertAuth($subitem->request);
+                    $this->convertRequestUrl($subitem->request);
+                    $this->convertResponseUrls($subitem->response);
+                }
+            }
+        } else {
+            $this->convertAuth($item->request);
+            $this->convertRequestUrl($item->request);
+            $this->convertResponseUrls($item->response);
+        }
+    }
+
+    /**
+     * Converts auth object from v2.0 to v2.1
+     *
+     * @param object $request
+     * @return void
+     */
+    protected function convertAuth(object $request): void
+    {
+        if (empty($request->auth)) {
+            return;
+        }
+        $type = $request->auth->type;
+        if ($type !== 'noauth' && isset($request->auth->$type)) {
+            $auth = [];
+            foreach ($request->auth->$type as $key => $value) {
+                $auth[] = (object)[
+                    'key' => $key,
+                    'value' => $value,
+                    'type' => 'string',
+                ];
+            }
+            $request->auth->$type = $auth;
+        }
+    }
+
+    /**
+     * Converts requests URLs from string v2.0 to object v2.1
+     *
+     * @param object $request
+     * @return void
+     */
+    protected function convertRequestUrl(object $request): void
+    {
+        if (is_string($request->url) && mb_strlen($request->url) > 0) {
+            $data = array_values(array_filter(explode('/', $request->url))); //TODO URL parsing
+            if (count($data) === 1) {
+                $url = [
+                    'raw' => $request->url,
+                    'host' => [$data[0] ?? $request->url],
+                ];
+            } else {
+                $url = [
+                    'raw' => $request->url,
+                    'protocol' => str_replace(':', '', $data[0]),
+                    'host' => [$data[1] ?? $request->url],
+                    'path' => array_slice($data, 2),
+                ];
+            }
+            $request->url = (object)$url;
+        }
+    }
+
+    /**
+     * Converts URLs response examples from string v2.0 to object v2.1
+     *
+     * @param array $responses
+     * @return void
+     */
+    protected function convertResponseUrls(array $responses): void
+    {
+        foreach ($responses as $response) {
+            if (is_string($response->originalRequest->url)) {
+                $data = array_values(array_filter(explode('/', $response->originalRequest->url))); //TODO URL parsing
+                if (count($data) === 1) {
+                    $url = [
+                        'raw' => $response->originalRequest->url,
+                        'host' => [$data[0] ?? $response->originalRequest->url],
+                    ];
+                } else {
+                    $url = [
+                        'raw' => $response->originalRequest->url,
+                        'protocol' => str_replace(':', '', $data[0]),
+                        'host' => [$data[1] ?? $response->originalRequest->url],
+                        'path' => array_slice($data, 2),
+                    ];
+                }
+                $response->originalRequest->url = (object)$url;
+            }
+        }
+    }
+}

src/Converters/RequestContract.php

@@ -0,0 +1,153 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PmConverter\Converters;
+
+use PmConverter\Converters\Http\HttpRequest;
+use PmConverter\Exceptions\{
+    EmptyHttpVerbException,
+    InvalidHttpVersionException};
+
+interface RequestContract
+{
+    /**
+     * Sets HTTP protocol version
+     *
+     * @param float $version
+     * @return $this
+     * @throws InvalidHttpVersionException
+     */
+    public function setHttpVersion(float $version): static;
+
+    /**
+     * Returns HTTP protocol version
+     *
+     * @return float
+     */
+    public function getHttpVersion(): float;
+
+    /**
+     * Sets name from collection item to request object
+     *
+     * @param string $name
+     * @return HttpRequest
+     */
+    public function setName(string $name): static;
+
+    /**
+     * Returns name of request
+     *
+     * @return string
+     */
+    public function getName(): string;
+
+    /**
+     * Sets description from collection item to request object
+     *
+     * @param string|null $description
+     * @return HttpRequest
+     */
+    public function setDescription(?string $description): static;
+
+    /**
+     * Returns description request
+     *
+     * @return string|null
+     */
+    public function getDescription(): ?string;
+
+    /**
+     * Sets HTTP verb from collection item to request object
+     *
+     * @param string $verb
+     * @return HttpRequest
+     */
+    public function setVerb(string $verb): static;
+
+    /**
+     * Returns HTTP verb of request
+     *
+     * @return string
+     * @throws EmptyHttpVerbException
+     */
+    public function getVerb(): string;
+
+    /**
+     * Sets URL from collection item to request object
+     *
+     * @param string $url
+     * @return HttpRequest
+     */
+    public function setUrl(string $url): static;
+
+    /**
+     * Returns URL of request
+     *
+     * @return string
+     */
+    public function getRawUrl(): string;
+
+    /**
+     * Sets headers from collection item to request object
+     *
+     * @param object[]|null $headers
+     * @return $this
+     */
+    public function setHeaders(?array $headers): static;
+
+    /**
+     * Sets one header to request object
+     *
+     * @param string $name Header's name
+     * @param mixed $value Header's value
+     * @param bool $disabled Pass true to skip (or comment out) this header
+     * @return $this
+     */
+    public function setHeader(string $name, mixed $value, bool $disabled = false): static;
+
+    /**
+     * Returns array of prepared headers
+     *
+     * @return array
+     */
+    public function getHeaders(): array;
+
+    /**
+     * Sets authorization headers
+     *
+     * @param object $auth
+     * @return $this
+     */
+    public function setAuth(object $auth): static;
+
+    /**
+     * Sets body mode from collection item to request object
+     *
+     * @param string $bodymode
+     * @return HttpRequest
+     */
+    public function setBodymode(string $bodymode): static;
+
+    /**
+     * Returns body mode of request
+     *
+     * @return HttpRequest
+     */
+    public function getBodymode(): string;
+
+    /**
+     * Sets body from collection item to request object
+     *
+     * @param object $body
+     * @return $this
+     */
+    public function setBody(object $body): static;
+
+    /**
+     * Returns body content
+     *
+     * @return mixed
+     */
+    public function getBody(): mixed;
+}

src/Converters/Wget/WgetConverter.php

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

src/Converters/Wget/WgetRequest.php

@@ -2,9 +2,10 @@
 
 declare(strict_types=1);
 
-namespace PmConverter\Exporters\Wget;
+namespace PmConverter\Converters\Wget;
 
-use PmConverter\Exporters\Abstract\AbstractRequest;
+use PmConverter\Converters\Abstract\AbstractRequest;
+use PmConverter\Exceptions\EmptyHttpVerbException;
 
 /**
  * Class to determine file content with wget request format
@@ -31,7 +32,7 @@ class WgetRequest extends AbstractRequest
             if ($header['disabled']) {
                 continue;
             }
-            $output[] = sprintf("\t--header '%s=%s' \ ", $header_key, $header['value']);
+            $output[] = sprintf("\t--header '%s: %s' \ ", $header_key, $header['value']);
         }
         return $output;
     }
@@ -43,22 +44,22 @@ class WgetRequest extends AbstractRequest
     {
         switch ($this->bodymode) {
             case 'formdata':
-                $params = [];
-                foreach ($this->body as $data) {
-                    if ($data->type === 'file') {
+                $output = [];
+                foreach ($this->body as $key => $data) {
+                    if ($data['type'] === 'file') {
                         continue;
                     }
-                    $params[$data->key] = $data->value;
+                    $output[$key] = $data['value'];
                 }
-                $output[] = http_build_query($params);
                 return $output;
             default:
-                return ["\t$this->body"];
+                return [$this->body];
         }
     }
 
     /**
      * @inheritDoc
+     * @throws EmptyHttpVerbException
      */
     public function __toString(): string
     {
@@ -68,15 +69,26 @@ class WgetRequest extends AbstractRequest
             [
                 'wget \ ',
                 "\t--no-check-certificate \ ",
-                "\t--quiet \ ",
-                "\t--timeout=0 \ ",
+                "\t--timeout 0 \ ",
                 "\t--method $this->verb \ ",
             ],
             $this->prepareHeaders(),
-            $this->prepareBody()
         );
-        $output[] = rtrim(array_pop($output), '\ ');
-        $output[] = "\t'$this->url'";
-        return implode(PHP_EOL, array_merge($output, ['']));
+        if ($this->getBodymode() === 'formdata') {
+            if ($this->getBody()) {
+                if ($this->getVerb() === 'GET') {
+                    $output[] = sprintf("\t%s?%s", $this->getRawUrl(), http_build_query($this->prepareBody()));
+                } else {
+                    $output[] = sprintf("\t--body-data '%s' \ ", http_build_query($this->prepareBody()));
+                    $output[] = sprintf("\t%s", $this->getRawUrl());
+                }
+            }
+        } else {
+            if ($this->getVerb() !== 'GET') {
+                $output[] = sprintf("\t--body-data '%s' \ ", implode("\n", $this->prepareBody()));
+                $output[] = sprintf("\t%s", $this->getRawUrl());
+            }
+        }
+        return implode(EOL, array_merge($output, ['']));
     }
 }

src/Environment.php

@@ -4,21 +4,138 @@ declare(strict_types=1);
 
 namespace PmConverter;
 
-class Environment implements \ArrayAccess
+use ArrayAccess;
+use JsonException;
+
+/**
+ *
+ */
+class Environment implements ArrayAccess
 {
+    /**
+     * @var string Path to env file
+     */
+    protected static string $filepath = '';
+
+    /**
+     * @var Environment
+     */
+    protected static Environment $instance;
+
     /**
      * @var array
      */
-    protected array $vars = [];
+    protected array $ownVars = [];
 
     /**
-     * @param object $env
+     * @var array
      */
-    public function __construct(protected object $env)
+    protected array $customVars = [];
+
+    public static function instance(): static
     {
-        foreach ($env->values as $var) {
-            $this->vars["{{{$var->key}}}"] = $var->value;
+        return static::$instance ??= new static();
+    }
+
+    /**
+     * @param string $filepath
+     * @return $this
+     * @throws JsonException
+     */
+    public function readFromFile(string $filepath): static
+    {
+        $content = file_get_contents(static::$filepath = $filepath);
+        $content = json_decode($content, flags: JSON_THROW_ON_ERROR); //TODO try-catch
+        $content || throw new JsonException("not a valid environment: $filepath");
+        property_exists($content, 'environment') && $content = $content->environment;
+        if (!property_exists($content, 'id') && !property_exists($content, 'name')) {
+            throw new JsonException("not a valid environment: $filepath");
         }
+        return $this->setOwnVars($content->values);
+    }
+
+    /**
+     * @param array $vars
+     * @return $this
+     */
+    protected function setOwnVars(array $vars): static
+    {
+        foreach ($vars as $key => $value) {
+            is_object($value) && [$key, $value] = [$value->key, $value->value];
+            $this->setOwnVar($key, $value);
+        }
+        return $this;
+    }
+
+    /**
+     * Sets value to some environment own variable
+     *
+     * @param string $name
+     * @param string $value
+     * @return $this
+     */
+    protected function setOwnVar(string $name, string $value): static
+    {
+        $this->ownVars[static::formatKey($name)] = $value;
+        return $this;
+    }
+
+    /**
+     * @param array $vars
+     * @return $this
+     */
+    public function setCustomVars(array $vars): static
+    {
+        foreach ($vars as $key => $value) {
+            is_object($value) && [$key, $value] = [$value->key, $value->value];
+            $this->setCustomVar($key, $value);
+        }
+        return $this;
+    }
+
+    /**
+     * Sets value to some environment own variable
+     *
+     * @param string $name
+     * @param string $value
+     * @return $this
+     */
+    public function setCustomVar(string $name, string $value): static
+    {
+        $this->customVars[static::formatKey($name)] = $value;
+        return $this;
+    }
+
+    /**
+     * Returns value of specific variable
+     *
+     * @param string $name
+     * @return mixed
+     */
+    public function var(string $name): mixed
+    {
+        $format_key = static::formatKey($name);
+        return $this->ownVars[$format_key] ?? $this->customVars[$format_key] ?? null;
+    }
+
+    /**
+     * Returns array of own and custom variables
+     *
+     * @return string[]
+     */
+    public function vars(): array
+    {
+        return array_merge($this->ownVars, $this->customVars);
+    }
+
+    /**
+     * Returns array of custom variables
+     *
+     * @return string[]
+     */
+    public function customVars(): array
+    {
+        return $this->customVars;
     }
 
     /**
@@ -28,15 +145,35 @@ class Environment implements \ArrayAccess
      */
     public function hasVars(): bool
     {
-        return !empty($this->vars);
+        return !empty($this->ownVars) && !empty($this->customVars);
     }
 
+
+
+
+
+
+
+
+
+
+
+
+
+    /**
+     * Closed constructor
+     */
+    protected function __construct()
+    {
+    }
+
+
     /**
      * @inheritDoc
      */
     public function offsetExists(mixed $offset): bool
     {
-        return array_key_exists($offset, $this->vars);
+        return array_key_exists(static::formatKey($offset), $this->vars());
     }
 
     /**
@@ -44,7 +181,7 @@ class Environment implements \ArrayAccess
      */
     public function offsetGet(mixed $offset): mixed
     {
-        return $this->vars[$offset];
+        return $this->var($offset);
     }
 
     /**
@@ -52,7 +189,7 @@ class Environment implements \ArrayAccess
      */
     public function offsetSet(mixed $offset, mixed $value): void
     {
-        $this->vars[$offset] = $value;
+        $this->customVars[static::formatKey($offset)] = $value;
     }
 
     /**
@@ -60,6 +197,17 @@ class Environment implements \ArrayAccess
      */
     public function offsetUnset(mixed $offset): void
     {
-        unset($this->vars[$offset]);
+        unset($this->customVars[static::formatKey($offset)]);
+    }
+
+    /**
+     * Returns correct variable {{name}}
+     *
+     * @param string $key
+     * @return string
+     */
+    public static function formatKey(string $key): string
+    {
+        return sprintf('{{%s}}', str_replace(['{', '}'], '', $key));
     }
 }

src/Exceptions/EmptyHttpVerbException.php

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

src/Exceptions/EmptyURLException.php

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

src/Exceptions/IncorrectSettingsFileException.php

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

src/Exceptions/InvalidHttpVersionException.php

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

src/Exporters/Abstract/AbstractConverter.php

@@ -1,193 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace PmConverter\Exporters\Abstract;
-
-use Exception;
-use PmConverter\Environment;
-use PmConverter\Exporters\{
-    ConverterContract,
-    RequestContract};
-use PmConverter\FileSystem;
-
-/**
- *
- */
-abstract class AbstractConverter implements ConverterContract
-{
-    /**
-     * @var object|null
-     */
-    protected ?object $collection = null;
-
-    /**
-     * @var string
-     */
-    protected string $outputPath;
-
-    /**
-     * @var string[]
-     */
-    protected array $vars = [];
-
-    /**
-     * @var Environment
-     */
-    protected Environment $env;
-
-    /**
-     * Sets an environment with vars
-     *
-     * @param Environment $env
-     * @return $this
-     */
-    public function withEnv(Environment $env): static
-    {
-        $this->env = $env;
-        return $this;
-    }
-
-    /**
-     * Converts collection requests
-     *
-     * @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;
-        $this->setVariables();
-        foreach ($collection->item as $item) {
-            $this->convertItem($item);
-        }
-    }
-
-    /**
-     * Prepares collection variables
-     *
-     * @return $this
-     */
-    protected function setVariables(): static
-    {
-        if ($this->collection->variable) {
-            foreach ($this->collection->variable as $var) {
-                $this->vars["{{{$var->key}}}"] = $var->value;
-            }
-        }
-        return $this;
-    }
-
-    /**
-     * Returns output path
-     *
-     * @return string
-     */
-    public function getOutputPath(): string
-    {
-        return $this->outputPath;
-    }
-
-    /**
-     * Checks whether item contains another items or not
-     *
-     * @param object $item
-     * @return bool
-     */
-    protected function isItemFolder(object $item): bool
-    {
-        return !empty($item->item) && empty($item->request);
-    }
-
-    /**
-     * Converts an item to request object and writes it into file
-     *
-     * @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));
-        }
-    }
-
-    /**
-     * Initialiazes request object to be written in file
-     *
-     * @param object $item
-     * @return RequestContract
-     */
-    protected function initRequest(object $item): RequestContract
-    {
-        $request_class = static::REQUEST_CLASS;
-
-        /** @var RequestContract $result */
-        $result = new $request_class($this->vars);
-        $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);
-        $result->setAuth($item->request?->auth ?? $this->collection?->auth ?? null);
-        if ($item->request->method !== 'GET' && !empty($item->request->body)) {
-            $result->setBody($item->request->body);
-        }
-        return $result;
-    }
-
-    /**
-     * Writes converted request object to file
-     *
-     * @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);
-        $content = $this->interpolate((string)$request);
-        return file_put_contents($filepath, $content) > 0;
-    }
-
-    /**
-     * Replaces variables in request with values from collection or environment
-     *
-     * @param string $content
-     * @return string
-     */
-    protected function interpolate(string $content): string
-    {
-        if (empty($this->vars) && $this->env->hasVars()) {
-            return $content;
-        }
-        $matches = [];
-        if (preg_match_all('/\{\{[a-zA-Z][a-zA-Z0-9]+}}/', $content, $matches, PREG_PATTERN_ORDER) > 0) {
-            foreach ($matches[0] as $key => $var) {
-                if (str_contains($content, $var)) {
-                    $content = str_replace($var, $this->vars[$var] ?? $this->env[$var] ?? $var, $content);
-                    unset($matches[0][$key]);
-                }
-            }
-        }
-        // if (!empty($matches[0])) {
-        //     fwrite(STDERR, sprintf('  No values found: %s%s', implode(', ', $matches[0]), PHP_EOL));
-        // }
-        return $content;
-    }
-}

src/Exporters/Abstract/AbstractRequest.php

@@ -1,222 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace PmConverter\Exporters\Abstract;
-
-use PmConverter\Exporters\Http\HttpRequest;
-use PmConverter\Exporters\RequestContract;
-
-/**
- * Class to determine file content with any request format
- */
-abstract class AbstractRequest implements RequestContract
-{
-    /**
-     * @var string
-     */
-    protected string $http = 'HTTP/1.1'; //TODO proto
-
-    /**
-     * @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;
-
-    /**
-     * Sets name from collection item to request object
-     *
-     * @param string $name
-     * @return HttpRequest
-     */
-    public function setName(string $name): static
-    {
-        $this->name = $name;
-        return $this;
-    }
-
-    /**
-     * Returns name of request
-     *
-     * @return string
-     */
-    public function getName(): string
-    {
-        return str_replace(DIRECTORY_SEPARATOR, '_', $this->name);
-    }
-
-    /**
-     * Sets description from collection item to request object
-     *
-     * @param string|null $description
-     * @return HttpRequest
-     */
-    public function setDescription(?string $description): static
-    {
-        $this->description = $description;
-        return $this;
-    }
-
-    /**
-     * Sets HTTP verb from collection item to request object
-     *
-     * @param string $verb
-     * @return HttpRequest
-     */
-    public function setVerb(string $verb): static
-    {
-        $this->verb = $verb;
-        return $this;
-    }
-
-    /**
-     * Sets URL from collection item to request object
-     *
-     * @param string $url
-     * @return HttpRequest
-     */
-    public function setUrl(string $url): static
-    {
-        $this->url = $url;
-        return $this;
-    }
-
-    /**
-     * Sets headers from collection item to request object
-     *
-     * @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;
-    }
-
-    /**
-     * Sets authorization headers
-     *
-     * @param object|null $auth
-     * @return $this
-     */
-    public function setAuth(?object $auth): static
-    {
-        if (!empty($auth)) {
-            switch ($auth->type) {
-                case 'bearer':
-                    $this->headers['Authorization'] = [
-                        'value' => 'Bearer ' . $auth->{$auth->type}[0]->value,
-                        'disabled' => false,
-                    ];
-                    break;
-                default:
-                    break;
-            }
-        }
-        return $this;
-    }
-
-
-    /**
-     * Sets body mode from collection item to request object
-     *
-     * @param string $bodymode
-     * @return HttpRequest
-     */
-    public function setBodymode(string $bodymode): static
-    {
-        $this->bodymode = $bodymode;
-        return $this;
-    }
-
-    /**
-     * Sets body from collection item to request object
-     *
-     * @param object $body
-     * @return $this
-     */
-    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;
-    }
-
-    /**
-     * Returns array of description lines
-     *
-     * @return array
-     */
-    abstract protected function prepareDescription(): array;
-
-    /**
-     * Returns array of headers
-     *
-     * @return array
-     */
-    abstract protected function prepareHeaders(): array;
-
-    /**
-     * Returns array of request body lines
-     *
-     * @return array
-     */
-    abstract protected function prepareBody(): array;
-
-    /**
-     * Converts request object to string to be written in result file
-     *
-     * @return string
-     */
-    abstract public function __toString(): string;
-}

src/Exporters/ConvertFormat.php

@@ -1,17 +0,0 @@
-<?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

@@ -1,11 +0,0 @@
-<?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

@@ -1,18 +0,0 @@
-<?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_CLASS = CurlRequest::class;
-}

src/Exporters/Http/HttpConverter.php

@@ -1,18 +0,0 @@
-<?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_CLASS = HttpRequest::class;
-}

src/Exporters/RequestContract.php

@@ -1,19 +0,0 @@
-<?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 setAuth(object $auth): 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

@@ -1,18 +0,0 @@
-<?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_CLASS = WgetRequest::class;
-}

src/FileSystem.php

@@ -4,11 +4,12 @@ declare(strict_types=1);
 
 namespace PmConverter;
 
-use PmConverter\Exceptions\{
-    CannotCreateDirectoryException,
-    DirectoryIsNotReadableException,
-    DirectoryIsNotWriteableException,
-    DirectoryNotExistsException};
+use Exception;
+use JsonException;
+use PmConverter\Exceptions\CannotCreateDirectoryException;
+use PmConverter\Exceptions\DirectoryIsNotReadableException;
+use PmConverter\Exceptions\DirectoryIsNotWriteableException;
+use PmConverter\Exceptions\DirectoryNotExistsException;
 
 /**
  * Helper class to work with files and directories
@@ -23,8 +24,8 @@ class FileSystem
      */
     public static function normalizePath(string $path): string
     {
-        $path = str_replace('~', $_SERVER['HOME'], $path);
-        return rtrim($path, DIRECTORY_SEPARATOR);
+        $path = str_replace('~/', "{$_SERVER['HOME']}/", $path);
+        return rtrim($path, DS);
     }
 
     /**
@@ -100,7 +101,7 @@ class FileSystem
         $path = static::normalizePath($path);
         $records = array_diff(@scandir($path) ?: [], ['.', '..']);
         foreach ($records as &$record) {
-            $record = sprintf('%s%s%s', $path, DIRECTORY_SEPARATOR, $record);
+            $record = sprintf('%s%s%s', $path, DS, $record);
         }
         return $records;
     }
@@ -110,16 +111,15 @@ class FileSystem
      *
      * @param string $path
      * @return bool
+     * @throws JsonException
+     * @throws Exception
      */
     public static function isCollectionFile(string $path): bool
     {
-        $path = static::normalizePath($path);
-        return !empty($path = trim($path))
+        return (!empty($path = static::normalizePath($path)))
             && str_ends_with($path, '.postman_collection.json')
             && file_exists($path)
             && is_readable($path)
-            && ($json = json_decode(file_get_contents($path), true))
-            && json_last_error() === JSON_ERROR_NONE
-            && isset($json['collection']['info']['name']);
+            && Collection::detectFileVersion($path) !== CollectionVersion::Unknown;
     }
 }

src/HttpVersion.php

@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PmConverter;
+
+enum HttpVersion: string
+{
+    case Version10 = '1.0';
+    case Version11 = '1.1';
+    case Version2 = '2';
+    case Version3 = '3';
+
+    public static function values(): array
+    {
+        return array_combine(
+            array_column(self::cases(), 'name'),
+            array_column(self::cases(), 'value'),
+        );
+    }
+}

src/Processor.php

@@ -5,111 +5,89 @@ declare(strict_types=1);
 namespace PmConverter;
 
 use Exception;
+use Generator;
 use InvalidArgumentException;
+use JetBrains\PhpStorm\NoReturn;
 use JsonException;
+use PmConverter\Converters\Abstract\AbstractConverter;
+use PmConverter\Converters\ConverterContract;
+use PmConverter\Converters\ConvertFormat;
 use PmConverter\Exceptions\CannotCreateDirectoryException;
 use PmConverter\Exceptions\DirectoryIsNotReadableException;
 use PmConverter\Exceptions\DirectoryIsNotWriteableException;
 use PmConverter\Exceptions\DirectoryNotExistsException;
-use PmConverter\Exporters\ConverterContract;
-use PmConverter\Exporters\ConvertFormat;
+use PmConverter\Exceptions\IncorrectSettingsFileException;
 
 /**
- *
+ * Main class
  */
 class Processor
 {
     /**
      * Converter version
      */
-    public const VERSION = '1.2.1';
-
-    /**
-     * @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 = [];
+    public const VERSION = '1.6.0';
 
     /**
      * @var int Initial timestamp
      */
-    protected int $initTime;
+    protected readonly int $initTime;
 
     /**
      * @var int Initial RAM usage
      */
-    protected int $initRam;
+    protected readonly int $initRam;
 
     /**
-     * @var string
+     * @var Settings Settings                               (lol)
      */
-    protected string $envFile;
+    protected Settings $settings;
+
+    /**
+     * @var ConverterContract[] Converters will be used for conversion according to chosen formats
+     */
+    protected array $converters = [];
+
+    /**
+     * @var bool Do we need to save settings file and exit or not?
+     */
+    protected bool $needDumpSettings = false;
 
     /**
      * @var Environment
      */
-    protected Environment $env;
+    public Environment $env;
 
     /**
      * Constructor
      *
      * @param array $argv Arguments came from cli
      */
-    public function __construct(protected array $argv)
+    public function __construct(protected readonly array $argv)
     {
         $this->initTime = hrtime(true);
         $this->initRam = memory_get_usage(true);
+        $this->settings = Settings::init();
+        $this->env = Environment::instance()
+            ->readFromFile($this->settings->envFilepath())
+            ->setCustomVars($this->settings->vars());
+        $this->parseArgs();
+        $this->needDumpSettings && $this->dumpSettingsFile();
     }
 
     /**
      * Parses an array of arguments came from cli
      *
      * @return void
-     * @throws DirectoryIsNotWriteableException
-     * @throws DirectoryNotExistsException
-     * @throws DirectoryIsNotReadableException
+     * @throws JsonException
      */
     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':
-                    $rawpath = $this->argv[$idx + 1];
-                    $normpath = FileSystem::normalizePath($rawpath);
-                    if (!FileSystem::isCollectionFile($normpath)) {
-                        throw new InvalidArgumentException(
-                            sprintf("this is not a valid collection file:%s\t%s %s", PHP_EOL, $arg, $rawpath)
-                        );
-                    }
-                    $this->collectionPaths[] = $this->argv[$idx + 1];
+                    $this->settings->addFilePath($this->argv[$idx + 1]);
                     break;
 
                 case '-o':
@@ -117,7 +95,7 @@ class Processor
                     if (empty($this->argv[$idx + 1])) {
                         throw new InvalidArgumentException('-o is required');
                     }
-                    $this->outputPath = $this->argv[$idx + 1];
+                    $this->settings->setOutputPath($this->argv[$idx + 1]);
                     break;
 
                 case '-d':
@@ -125,56 +103,123 @@ class Processor
                     if (empty($this->argv[$idx + 1])) {
                         throw new InvalidArgumentException('a directory path is expected for -d (--dir)');
                     }
-                    $rawpath = $this->argv[$idx + 1];
-                    $files = array_filter(
-                        FileSystem::dirContents($rawpath),
-                        static fn($filename) => FileSystem::isCollectionFile($filename)
-                    );
-                    $this->collectionPaths = array_unique(array_merge($this?->collectionPaths ?? [], $files));
+                    $this->settings->addDirPath($this->argv[$idx + 1]);
                     break;
 
                 case '-e':
                 case '--env':
-                    $this->envFile = FileSystem::normalizePath($this->argv[$idx + 1]);
+                    $this->settings->setEnvFilepath($this->argv[$idx + 1]);
                     break;
 
                 case '-p':
                 case '--preserve':
-                    $this->preserveOutput = true;
+                    $this->settings->setPreserveOutput(true);
                     break;
 
                 case '--http':
-                    $this->formats[ConvertFormat::Http->name] = ConvertFormat::Http;
+                    $this->settings->addFormat(ConvertFormat::Http);
                     break;
 
                 case '--curl':
-                    $this->formats[ConvertFormat::Curl->name] = ConvertFormat::Curl;
+                    $this->settings->addFormat(ConvertFormat::Curl);
                     break;
 
                 case '--wget':
-                    $this->formats[ConvertFormat::Wget->name] = ConvertFormat::Wget;
+                    $this->settings->addFormat(ConvertFormat::Wget);
+                    break;
+
+                case '--v2.0':
+                    $this->settings->addFormat(ConvertFormat::Postman20);
+                    break;
+
+                case '--v2.1':
+                    $this->settings->addFormat(ConvertFormat::Postman21);
+                    break;
+
+                case '-a':
+                case '--all':
+                    foreach (ConvertFormat::cases() as $format) {
+                        $this->settings->addFormat($format);
+                    }
+                    break;
+
+                case '--var':
+                    //TODO split by first equal sign
+                    $this->env->setCustomVar(...explode('=', trim($this->argv[$idx + 1])));
+                    break;
+
+                case '--dev':
+                    $this->settings->setDevMode(true);
+                    break;
+
+                case '--dump':
+                    $this->needDumpSettings = true;
                     break;
 
                 case '-v':
                 case '--version':
-                    die(implode(PHP_EOL, $this->version()) . PHP_EOL);
+                    die(implode(EOL, $this->version()) . EOL);
 
                 case '-h':
                 case '--help':
-                    die(implode(PHP_EOL, $this->usage()) . PHP_EOL);
+                    die(implode(EOL, $this->usage()) . EOL);
             }
         }
-        if (empty($this->collectionPaths)) {
+        if (empty($this->settings->collectionPaths())) {
             throw new InvalidArgumentException('there are no collections to convert');
         }
-        if (empty($this->outputPath)) {
+        if (empty($this->settings->outputPath())) {
             throw new InvalidArgumentException('-o is required');
         }
-        if (empty($this->formats)) {
-            $this->formats = [ConvertFormat::Http->name => ConvertFormat::Http];
+        if (empty($this->settings->formats())) {
+            $this->settings->addFormat(ConvertFormat::Http);
         }
     }
 
+    /**
+     * Handles input command
+     *
+     * @return void
+     * @throws CannotCreateDirectoryException
+     * @throws DirectoryIsNotReadableException
+     * @throws DirectoryIsNotWriteableException
+     * @throws DirectoryNotExistsException
+     * @throws JsonException
+     * @throws IncorrectSettingsFileException
+     */
+    public function handle(): void
+    {
+        $this->prepareOutputDirectory();
+        $this->initConverters();
+        $this->convert();
+    }
+
+    /**
+     * Writes all settings into file if --dump provided
+     *
+     * @return never
+     */
+    #[NoReturn]
+    protected function dumpSettingsFile(): never
+    {
+        $answer = 'o';
+        if ($this->settings::fileExists()) {
+            echo 'Settings file already exists: ' . $this->settings::filepath() . EOL;
+            echo 'Do you want to (o)verwrite it, (b)ackup it and create new one or (c)ancel (default)?' . EOL;
+            $answer = strtolower(trim(readline('> ')));
+        }
+        if (!in_array($answer, ['o', 'b'])) {
+            die('Current settings file has not been changed' . EOL);
+        }
+        if ($answer === 'b') {
+            $filepath = $this->settings->backup();
+            printf("Settings file has been backed up to file:%s\t%s%s", EOL, $filepath, EOL);
+        }
+        $this->settings->dump($this->env->customVars());
+        printf("Arguments has been converted into settings file:%s\t%s%s", EOL, $this->settings::filepath(), EOL);
+        die('Review and edit it if needed.' . EOL);
+    }
+
     /**
      * Initializes output directory
      *
@@ -184,90 +229,74 @@ class Processor
      * @throws DirectoryNotExistsException
      * @throws DirectoryIsNotReadableException
      */
-    protected function initOutputDirectory(): void
+    protected function prepareOutputDirectory(): void
     {
-        if (isset($this?->outputPath) && !$this->preserveOutput) {
-            FileSystem::removeDir($this->outputPath);
+        if (!$this->settings->isPreserveOutput()) {
+            FileSystem::removeDir($this->settings->outputPath());
         }
-        FileSystem::makeDir($this->outputPath);
+        FileSystem::makeDir($this->settings->outputPath());
     }
 
     /**
-     * Initializes converters according to choosen formats
+     * Initializes converters according to chosen formats
      *
      * @return void
      */
     protected function initConverters(): void
     {
-        foreach ($this->formats as $type) {
-            $this->converters[$type->name] = new $type->value($this->preserveOutput);
+        foreach ($this->settings->formats() as $type) {
+            $this->converters[$type->name] = new $type->value($this->settings->isPreserveOutput());
         }
+        unset($this->formats);
     }
 
     /**
-     * Initializes collection objects
+     * Generates collections from settings
      *
+     * @return Generator<Collection>
      * @throws JsonException
      */
-    protected function initCollections(): void
+    protected function newCollection(): Generator
     {
-        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;
+        foreach ($this->settings->collectionPaths() as $collectionPath) {
+            yield Collection::fromFile($collectionPath);
         }
     }
 
-    /**
-     * Initializes environment object
-     *
-     * @return void
-     * @throws JsonException
-     */
-    protected function initEnv(): void
-    {
-        $content = file_get_contents(FileSystem::normalizePath($this->envFile));
-        $content = json_decode($content, flags: JSON_THROW_ON_ERROR);
-        if (!property_exists($content, 'environment') || empty($content?->environment)) {
-            throw new JsonException("not a valid environment: $this->envFile");
-        }
-        $this->env = new Environment($content->environment);
-    }
-
     /**
      * Begins a conversion
      *
-     * @throws Exception
+     * @throws JsonException
      */
     public function convert(): void
     {
-        $this->parseArgs();
-        $this->initOutputDirectory();
-        $this->initConverters();
-        $this->initCollections();
-        $this->initEnv();
-        $count = count($this->collections);
-        $current = 0;
-        $success = 0;
-        print(implode(PHP_EOL, array_merge($this->version(), $this->copyright())) . PHP_EOL . PHP_EOL);
-        foreach ($this->collections as $collectionName => $collection) {
+        $count = count($this->settings->collectionPaths());
+        $current = $success = 0;
+        $collection = null;
+        print(implode(EOL, array_merge($this->version(), $this->copyright())) . EOL . EOL);
+        foreach ($this->newCollection() as $collection) {
             ++$current;
-            printf("Converting '%s' (%d/%d):%s", $collectionName, $current, $count, PHP_EOL);
-            foreach ($this->converters as $type => $exporter) {
-                printf('> %s%s', strtolower($type), PHP_EOL);
-                $outputPath = sprintf('%s%s%s', $this->outputPath, DIRECTORY_SEPARATOR, $collectionName);
-                if (!empty($this->env)) {
-                    $exporter->withEnv($this->env);
+            printf("Converting '%s' (%d/%d):%s", $collection->name(), $current, $count, EOL);
+            foreach ($this->converters as $type => $converter) {
+                /** @var AbstractConverter $converter */
+                printf('> %s%s', strtolower($type), EOL);
+                $outputPath = sprintf('%s%s%s', $this->settings->outputPath(), DS, $collection->name());
+                try {
+                    $converter = $converter->to($outputPath);
+                    $converter = $converter->convert($collection);
+                    $converter->flush();
+                    printf('  OK: %s%s', $converter->getOutputPath(), EOL);
+                } catch (Exception $e) {
+                    printf('  ERROR %s: %s%s', $e->getCode(), $e->getMessage(), EOL);
+                    if ($this->settings->isDevMode()) {
+                        array_map(static fn ($line) => printf('  %s%s', $line, EOL), $e->getTrace());
+                    }
                 }
-                $exporter->convert($collection, $outputPath);
-                printf('  OK: %s%s', $exporter->getOutputPath(), PHP_EOL);
             }
-            print(PHP_EOL);
+            print(EOL);
             ++$success;
         }
+        unset($this->converters, $type, $converter, $outputPath, $this->collections, $collectionName, $collection);
         $this->printStats($success, $current);
     }
 
@@ -281,25 +310,31 @@ class Processor
     protected function printStats(int $success, int $count): void
     {
         $time = (hrtime(true) - $this->initTime) / 1_000_000;
+        $timeFmt = 'ms';
+        if ($time > 1000) {
+            $time /= 1000;
+            $timeFmt = 'sec';
+        }
         $ram = (memory_get_peak_usage(true) - $this->initRam) / 1024 / 1024;
-        printf('Converted %d of %d in %.3f ms using %.3f MiB RAM', $success, $count, $time, $ram);
+        printf("Converted %d/%d in %.2f $timeFmt using up to %.2f MiB RAM%s", $success, $count, $time, $ram, EOL);
     }
 
     /**
      * @return string[]
      */
-    public function version(): array
+    public static function version(): array
     {
-        return ["Postman collection converter v" . self::VERSION];
+        return ['Postman collection converter v' . self::VERSION];
     }
 
     /**
      * @return string[]
      */
-    public function copyright(): array
+    public static function copyright(): array
     {
+        $years = ($year = (int)date('Y')) > 2023 ? "2023 - $year" : $year;
         return [
-            'Anthony Axenov (c) ' . date('Y') . ", MIT license",
+            "Anthony Axenov (c) $years, MIT license",
             'https://git.axenov.dev/anthony/pm-convert'
         ];
     }
@@ -307,9 +342,9 @@ class Processor
     /**
      * @return array
      */
-    public function usage(): array
+    public static function usage(): array
     {
-        return array_merge($this->version(), [
+        return array_merge(static::version(), [
             'Usage:',
             "\t./pm-convert -f|-d PATH -o OUTPUT_PATH [ARGUMENTS] [FORMATS]",
             "\tphp pm-convert -f|-d PATH -o OUTPUT_PATH [ARGUMENTS] [FORMATS]",
@@ -317,29 +352,33 @@ class Processor
             "\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-e, --env        - use environment file with variable values to replace in request",
-            "\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",
+            "\t-f, --file          - a PATH to a single collection file to convert from",
+            "\t-d, --dir           - a PATH to a directory with collections to convert from",
+            "\t-o, --output        - a directory OUTPUT_PATH to put results in",
+            "\t-e, --env           - use environment file with variables to replace in requests",
+            "\t--var \"NAME=VALUE\"  - force replace specified env variable called NAME with custom VALUE",
+            "\t-p, --preserve      - do not delete OUTPUT_PATH (if exists)",
+            "\t    --dump          - convert provided arguments into settings file in `pwd",
+            "\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 -f and -d are specified then only unique set of files will be converted.',
+            'If both -f and -d are specified then only unique set of files from both arguments 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.',
-            'If -e is specified several times then only last one will be used.',
-            'If -e is not specified then only collection vars will be replaced (if any).',
+            'If -o or -e was 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",
+            "\t--http     - generate raw *.http files (default)",
+            "\t--curl     - generate shell scripts with curl command",
+            "\t--wget     - generate shell scripts with wget command",
+            "\t--v2.0     - convert from Postman Collection Schema v2.1 into v2.0",
+            "\t--v2.1     - convert from Postman Collection Schema v2.0 into v2.1",
+            "\t-a, --all  - convert to all of formats listed above",
+            '',
             'If no FORMATS specified then --http implied.',
-            'Any of FORMATS can be specified at the same time.',
+            'Any of FORMATS can be specified at the same time or replaced by --all.',
             '',
             'Example:',
             "    ./pm-convert \ ",
@@ -348,8 +387,10 @@ class Processor
             "        --file ~/dir2/second.postman_collection.json \ ",
             "        --env ~/localhost.postman_environment.json \ ",
             "        -d ~/personal \ ",
-            "        -o ~/postman_export ",
+            "        --var \"myvar=some value\" \ ",
+            "        -o ~/postman_export \ ",
+            "       --all",
             "",
-        ], $this->copyright());
+        ], static::copyright());
     }
 }

src/Settings.php

@@ -0,0 +1,313 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PmConverter;
+
+use InvalidArgumentException;
+use JsonException;
+use PmConverter\Converters\ConvertFormat;
+use PmConverter\Exceptions\IncorrectSettingsFileException;
+
+/**
+ * Class responsible for settings storage and dumping
+ */
+class Settings
+{
+    /**
+     * @var string Full path to settings file
+     */
+    protected static string $filepath;
+
+    /**
+     * @var bool Flag to output some debug-specific messages
+     */
+    protected bool $devMode = false;
+
+    /**
+     * @var string[] Paths to collection directories
+     */
+    protected array $directories = [];
+
+    /**
+     * @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 string[] Additional variables
+     */
+    protected array $vars = [];
+
+    /**
+     * @var ConvertFormat[] Formats to convert a collections into
+     */
+    protected array $formats = [];
+
+    /**
+     * @var string Path to environment file
+     */
+    protected string $envFilepath = '';
+
+    /**
+     * @return bool
+     */
+    public static function fileExists(): bool
+    {
+        return file_exists(self::$filepath);
+    }
+
+    /**
+     * @return self
+     * @throws IncorrectSettingsFileException
+     * @throws JsonException
+     */
+    public static function init(): self
+    {
+        $content = '{}';
+        self::$filepath = sprintf('%s%spm-convert-settings.json', $_SERVER['PWD'], DS);
+        if (self::fileExists()) {
+            $content = trim(file_get_contents(self::$filepath));
+        }
+        try {
+            $settings = json_decode($content ?: '{}', flags: JSON_THROW_ON_ERROR);
+        } catch (JsonException $e) {
+            throw new IncorrectSettingsFileException('Incorrect settings file: ' . $e->getMessage(), $e->getCode());
+        }
+        return new self($settings);
+    }
+
+    /**
+     * Returns full path to settings file
+     *
+     * @return string
+     */
+    public static function filepath(): string
+    {
+        return self::$filepath;
+    }
+
+    /**
+     * @param object $settings
+     * @throws JsonException
+     */
+    protected function __construct(object $settings)
+    {
+        foreach ($settings->directories ?? [] as $path) {
+            $this->addDirPath($path);
+        }
+        foreach ($settings->files ?? [] as $path) {
+            $this->addFilePath($path);
+        }
+        $this->setDevMode(!empty($settings->devMode));
+        $this->setPreserveOutput(!empty($settings->preserveOutput));
+        isset($settings->environment) && $this->setEnvFilepath($settings->environment);
+        isset($settings->output) && $this->setOutputPath($settings->output);
+        foreach ($settings->formats ?? [] as $format) {
+            $this->addFormat(ConvertFormat::fromArg($format));
+        }
+        foreach ($settings->vars ?? [] as $name => $value) {
+            $this->vars[$name] = $value;
+        }
+    }
+
+    /**
+     * @param string $path
+     * @return void
+     * @throws JsonException
+     */
+    public function addDirPath(string $path): void
+    {
+        $this->directories = array_unique(array_merge(
+            $this->directories ?? [],
+            [FileSystem::normalizePath($path)]
+        ));
+        $files = array_filter(
+            FileSystem::dirContents($path),
+            static fn ($filename) => FileSystem::isCollectionFile($filename)
+        );
+        $this->collectionPaths = array_unique(array_merge($this->collectionPaths ?? [], $files));
+    }
+
+    /**
+     * @param string $path
+     * @return void
+     * @throws JsonException
+     */
+    public function addFilePath(string $path): void
+    {
+        $normpath = FileSystem::normalizePath($path);
+        if (!FileSystem::isCollectionFile($normpath)) {
+            throw new InvalidArgumentException("not a valid collection: $path");
+        }
+        in_array($path, $this->collectionPaths) || $this->collectionPaths[] = $path;
+    }
+
+    /**
+     * @param string $outputPath
+     * @return void
+     */
+    public function setOutputPath(string $outputPath): void
+    {
+        $this->outputPath = $outputPath;
+    }
+
+    /**
+     * @param bool $devMode
+     * @return void
+     */
+    public function setDevMode(bool $devMode): void
+    {
+        $this->devMode = $devMode;
+    }
+
+    /**
+     * @param ConvertFormat $format
+     * @return void
+     */
+    public function addFormat(ConvertFormat $format): void
+    {
+        $this->formats[$format->name] = $format;
+    }
+
+    /**
+     * Returns array of variables
+     *
+     * @return string[]
+     */
+    public function vars(): array
+    {
+        return $this->vars;
+    }
+
+    /**
+     * @param bool $preserveOutput
+     * @return void
+     */
+    public function setPreserveOutput(bool $preserveOutput): void
+    {
+        $this->preserveOutput = $preserveOutput;
+    }
+
+    /**
+     * @param string $filepath
+     * @return void
+     */
+    public function setEnvFilepath(string $filepath): void
+    {
+        $this->envFilepath = FileSystem::normalizePath($filepath);
+    }
+
+    /**
+     * @return bool
+     */
+    public function isDevMode(): bool
+    {
+        return $this->devMode;
+    }
+
+    /**
+     * @return string[]
+     */
+    public function collectionPaths(): array
+    {
+        return $this->collectionPaths;
+    }
+
+    /**
+     * @return string
+     */
+    public function outputPath(): string
+    {
+        return $this->outputPath;
+    }
+
+    /**
+     * @return bool
+     */
+    public function isPreserveOutput(): bool
+    {
+        return $this->preserveOutput;
+    }
+
+    /**
+     * @return ConvertFormat[]
+     */
+    public function formats(): array
+    {
+        return $this->formats;
+    }
+
+    /**
+     * @return string
+     */
+    public function envFilepath(): string
+    {
+        return $this->envFilepath;
+    }
+
+    /**
+     * Determines fieldset of settings JSON
+     *
+     * @return array
+     */
+    public function __serialize(): array
+    {
+        return [
+            'dev' => $this->isDevMode(),
+            'directories' => $this->directories,
+            'files' => $this->collectionPaths(),
+            'environment' => $this->envFilepath(),
+            'output' => $this->outputPath(),
+            'preserve-output' => $this->isPreserveOutput(),
+            'formats' => array_values(array_map(
+                static fn (ConvertFormat $format) => $format->toArg(),
+                $this->formats(),
+            )),
+            'vars' => $this->vars,
+        ];
+    }
+
+    /**
+     * Converts settings into JSON format
+     *
+     * @return string
+     */
+    public function __toString(): string
+    {
+        return json_encode($this->__serialize(), JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
+    }
+
+    /**
+     * Writes settings in JSON format into settings file
+     *
+     * @param array $vars
+     * @return bool
+     */
+    public function dump(array $vars = []): bool
+    {
+        count($vars) > 0 && $this->vars = $vars;
+        return file_put_contents(self::$filepath, (string)$this) > 0;
+    }
+
+    /**
+     * Makes a backup file of current settings file
+     *
+     * @return string
+     */
+    public function backup(): string
+    {
+        copy(self::$filepath, $newfilepath = self::$filepath . '.bak.' . time());
+        return $newfilepath;
+    }
+}

tests/AbstractRequestTest.php

@@ -0,0 +1,296 @@
+<?php
+
+declare(strict_types=1);
+
+use PHPUnit\Framework\TestCase;
+use PmConverter\Exceptions\EmptyHttpVerbException;
+use PmConverter\Exceptions\InvalidHttpVersionException;
+
+class AbstractRequestTest extends TestCase
+{
+    /**
+     * @covers PmConverter\Converters\Abstract\AbstractRequest
+     * @covers PmConverter\HttpVersion
+     * @return void
+     * @throws InvalidHttpVersionException
+     */
+    public function testHttpVersion(): void
+    {
+        $request = new \PmConverter\Converters\Http\HttpRequest();
+        $request->setHttpVersion(2.0);
+
+        $this->assertSame(2.0, $request->getHttpVersion());
+    }
+
+    /**
+     * @covers PmConverter\Converters\Abstract\AbstractRequest
+     * @covers PmConverter\Converters\Abstract\AbstractRequest::getVerb()
+     * @covers PmConverter\HttpVersion
+     * @return void
+     * @throws InvalidHttpVersionException
+     */
+    public function testInvalidHttpVersionException(): void
+    {
+        $this->expectException(InvalidHttpVersionException::class);
+
+        $request = new \PmConverter\Converters\Http\HttpRequest();
+        $request->setHttpVersion(5);
+    }
+
+    /**
+     * @covers PmConverter\Converters\Abstract\AbstractRequest
+     * @covers PmConverter\Converters\Abstract\AbstractRequest::setVerb()
+     * @covers PmConverter\Converters\Abstract\AbstractRequest::getVerb()
+     * @return void
+     * @throws EmptyHttpVerbException
+     */
+    public function testVerb(): void
+    {
+        $request = new \PmConverter\Converters\Http\HttpRequest();
+        $request->setVerb('GET');
+
+        $this->assertSame('GET', $request->getVerb());
+    }
+
+    /**
+     * @covers PmConverter\Converters\Abstract\AbstractRequest
+     * @covers PmConverter\Converters\Abstract\AbstractRequest::getVerb()
+     * @return void
+     * @throws EmptyHttpVerbException
+     */
+    public function testEmptyHttpVerbException(): void
+    {
+        $this->expectException(EmptyHttpVerbException::class);
+
+        $request = new \PmConverter\Converters\Http\HttpRequest();
+        $request->getVerb();
+    }
+
+
+    /**
+     * @covers PmConverter\Converters\Abstract\AbstractRequest
+     * @covers PmConverter\Converters\Abstract\AbstractRequest::setUrl()
+     * @covers PmConverter\Converters\Abstract\AbstractRequest::getRawUrl()
+     * @return void
+     */
+    public function testUrl(): void
+    {
+        $request = new \PmConverter\Converters\Http\HttpRequest();
+        $request->setUrl('http://localhost');
+
+        $this->assertSame('http://localhost', $request->getRawUrl());
+    }
+
+    /**
+     * @covers PmConverter\Converters\Abstract\AbstractRequest
+     * @covers PmConverter\Converters\Abstract\AbstractRequest::setName()
+     * @covers PmConverter\Converters\Abstract\AbstractRequest::getName()
+     * @return void
+     */
+    public function testName(): void
+    {
+        $request = new \PmConverter\Converters\Http\HttpRequest();
+        $request->setName('lorem ipsum');
+
+        $this->assertSame('lorem ipsum', $request->getName());
+    }
+
+    /**
+     * @covers PmConverter\Converters\Abstract\AbstractRequest
+     * @covers PmConverter\Converters\Abstract\AbstractRequest::setDescription()
+     * @covers PmConverter\Converters\Abstract\AbstractRequest::getDescription()
+     * @return void
+     */
+    public function testDescription(): void
+    {
+        $request = new \PmConverter\Converters\Http\HttpRequest();
+        $request->setDescription("lorem ipsum\ndolor sit\namet");
+
+        $this->assertSame("lorem ipsum\ndolor sit\namet", $request->getDescription());
+    }
+
+    /**
+     * @covers PmConverter\Converters\Abstract\AbstractRequest
+     * @covers PmConverter\Converters\Abstract\AbstractRequest::setBodymode()
+     * @covers PmConverter\Converters\Abstract\AbstractRequest::getBodymode()
+     * @return void
+     */
+    public function testBodyMode(): void
+    {
+        $request = new \PmConverter\Converters\Http\HttpRequest();
+        $request->setBodymode('raw');
+
+        $this->assertSame('raw', $request->getBodymode());
+    }
+
+    /**
+     * @covers PmConverter\Converters\Abstract\AbstractRequest
+     * @covers PmConverter\Converters\Abstract\AbstractRequest::setHeaders()
+     * @covers PmConverter\Converters\Abstract\AbstractRequest::setHeader()
+     * @covers PmConverter\Converters\Abstract\AbstractRequest::getHeaders()
+     * @return void
+     */
+    public function testHeaders(): void
+    {
+        $headers = [
+            (object)[
+                'key' => 'Header 1',
+                'value' => 'Value 1',
+                'disabled' => true,
+            ],
+            (object)[
+                'key' => 'Header 2',
+                'value' => 'Value 2',
+                'disabled' => false,
+            ],
+            (object)[
+                'key' => 'Header 3',
+                'value' => 'Value 3',
+            ],
+        ];
+        $expected = [
+            'Header 1' => [
+                'value' => 'Value 1',
+                'disabled' => true,
+            ],
+            'Header 2' => [
+                'value' => 'Value 2',
+                'disabled' => false,
+            ],
+            'Header 3' => [
+                'value' => 'Value 3',
+                'disabled' => false,
+            ],
+            'Header 4' => [
+                'value' => 'Value 4',
+                'disabled' => false,
+            ],
+            'Header 5' => [
+                'value' => 'Value 5',
+                'disabled' => true,
+            ],
+        ];
+
+        $request = new \PmConverter\Converters\Http\HttpRequest();
+        $request->setHeaders($headers)
+            ->setHeader('Header 4', 'Value 4')
+            ->setHeader('Header 5', 'Value 5', true);
+
+        $this->assertSame($expected, $request->getHeaders());
+    }
+
+    /**
+     * @covers PmConverter\Converters\Abstract\AbstractRequest
+     * @covers PmConverter\Converters\Abstract\AbstractRequest::setAuth()
+     * @return void
+     */
+    public function testAuthBearer(): void
+    {
+        $auth = (object)[
+            'type' => 'bearer',
+            'bearer' => [
+                (object)[
+                    'key' => 'token',
+                    'value' => 'qwerty',
+                    'type' => 'string',
+                ]
+            ]
+        ];
+        $expected = [
+            'Authorization' => [
+                'value' => 'Bearer qwerty',
+                'disabled' => false,
+            ],
+        ];
+
+        $request = new \PmConverter\Converters\Http\HttpRequest();
+        $request->setAuth($auth);
+
+        $this->assertSame($expected, $request->getHeaders());
+    }
+
+    /**
+     * @covers PmConverter\Converters\Abstract\AbstractRequest
+     * @covers PmConverter\Converters\Abstract\AbstractRequest::setBodymode()
+     * @covers PmConverter\Converters\Abstract\AbstractRequest::setHeader()
+     * @covers PmConverter\Converters\Abstract\AbstractRequest::setBody()
+     * @covers PmConverter\Converters\Abstract\AbstractRequest::setBodyAsIs()
+     * @covers PmConverter\Converters\Abstract\AbstractRequest::getBody()
+     * @return void
+     */
+    public function testJson(): void
+    {
+        $body = (object)[
+            'mode' => 'raw',
+            'raw' => $expectedBody = '["lorem ipsum dolor sit amet"]',
+            'options' => (object)[
+                'raw' => (object)[
+                    'language' => 'json',
+                ]
+            ]
+        ];
+
+        $request = new \PmConverter\Converters\Http\HttpRequest();
+        $request->setBody($body);
+
+        $expectedHeaders = [
+            'Content-Type' => [
+                'value' => 'application/json',
+                'disabled' => false,
+            ],
+        ];
+
+        $this->assertSame($expectedHeaders, $request->getHeaders());
+        $this->assertSame($expectedBody, $request->getBody());
+    }
+
+    /**
+     * @covers PmConverter\Converters\Abstract\AbstractRequest
+     * @covers PmConverter\Converters\Abstract\AbstractRequest::setBodymode
+     * @covers PmConverter\Converters\Abstract\AbstractRequest::setHeader
+     * @covers PmConverter\Converters\Abstract\AbstractRequest::setBody
+     * @covers PmConverter\Converters\Abstract\AbstractRequest::setFormdataBody
+     * @covers PmConverter\Converters\Abstract\AbstractRequest::getBody
+     * @return void
+     */
+    public function testFormdata(): void
+    {
+        $body = (object)[
+            'mode' => 'formdata',
+            'formdata' => [
+                (object)[
+                    'key' => 'param1',
+                    'value' => 'value1',
+                    'type' => 'text',
+                ],
+                (object)[
+                    'key' => 'param2',
+                    'src' => '/tmp/somefile.txt',
+                    'type' => 'file',
+                ],
+            ],
+        ];
+        $expectedBody = [
+            'param1' => [
+                'value' => 'value1',
+                'type' => 'text',
+            ],
+            'param2' => [
+                'value' => '/tmp/somefile.txt',
+                'type' => 'file',
+            ],
+        ];
+        $expectedHeaders = [
+            'Content-Type' => [
+                'value' => 'multipart/form-data',
+                'disabled' => false,
+            ],
+        ];
+
+        $request = new \PmConverter\Converters\Http\HttpRequest();
+        $request->setBody($body);
+
+        $this->assertSame($expectedHeaders, $request->getHeaders());
+        $this->assertSame($expectedBody, $request->getBody());
+    }
+}

tests/HttpRequestTest.php

@@ -0,0 +1,140 @@
+<?php
+
+declare(strict_types=1);
+
+use PHPUnit\Framework\TestCase;
+use PmConverter\Converters\Http\HttpRequest;
+
+class HttpRequestTest extends TestCase
+{
+    /**
+     * @covers PmConverter\Converters\Abstract\AbstractRequest
+     * @covers PmConverter\Converters\Http\HttpRequest
+     * @covers PmConverter\Converters\Http\HttpRequest::prepareDescription()
+     * @covers PmConverter\Converters\Http\HttpRequest::__toString()
+     * @return void
+     */
+    public function testPrepareDescription()
+    {
+        $description = [
+            'lorem ipsum',
+            'dolor sit',
+            'amet',
+        ];
+        $needle = implode("\n", [
+            '# lorem ipsum',
+            '# dolor sit',
+            '# amet',
+        ]);
+
+        $request = (new HttpRequest())
+            ->setVerb('GET')
+            ->setUrl('http://localhost')
+            ->setDescription(implode("\n", $description));
+
+        $this->assertStringContainsString($needle, (string)$request);
+    }
+
+    /**
+     * @covers PmConverter\Converters\Abstract\AbstractRequest
+     * @covers PmConverter\Converters\Http\HttpRequest
+     * @covers PmConverter\Converters\Http\HttpRequest::prepareHeaders()
+     * @covers PmConverter\Converters\Http\HttpRequest::__toString()
+     * @return void
+     */
+    public function testPrepareHeaders()
+    {
+        $headers = [
+            (object)[
+                'key' => 'Header1',
+                'value' => 'Value 1',
+                'disabled' => true,
+            ],
+            (object)[
+                'key' => 'Header2',
+                'value' => 'Value 2',
+                'disabled' => false,
+            ],
+            (object)[
+                'key' => 'Header3',
+                'value' => 'Value 3',
+            ],
+        ];
+        $needle = implode("\n", [
+            '# Header1: Value 1',
+            'Header2: Value 2',
+            'Header3: Value 3',
+        ]);
+
+        $request = (new HttpRequest())
+            ->setVerb('GET')
+            ->setUrl('http://localhost')
+            ->setHeaders($headers);
+
+        $this->assertStringContainsString($needle, (string)$request);
+    }
+
+    /**
+     * @covers PmConverter\Converters\Abstract\AbstractRequest
+     * @covers PmConverter\Converters\Http\HttpRequest
+     * @covers PmConverter\Converters\Http\HttpRequest::prepareBody()
+     * @covers PmConverter\Converters\Http\HttpRequest::__toString()
+     * @return void
+     */
+    public function testPrepareFormdataBody()
+    {
+        $body = (object)[
+            'mode' => 'formdata',
+            'formdata' => [
+                (object)[
+                    'key' => 'param1',
+                    'value' => 'value1',
+                    'type' => 'text',
+                ],
+                (object)[
+                    'key' => 'param2',
+                    'src' => '/tmp/somefile.txt',
+                    'type' => 'file',
+                ],
+            ],
+        ];
+        $needle = implode("\n", [
+            'param1=value1',
+            'param2=@/tmp/somefile.txt',
+        ]);
+
+        $request = (new HttpRequest())
+            ->setVerb('GET')
+            ->setUrl('http://localhost')
+            ->setBody($body);
+
+        $this->assertStringContainsString($needle, (string)$request);
+    }
+
+    /**
+     * @covers PmConverter\Converters\Abstract\AbstractRequest
+     * @covers PmConverter\Converters\Http\HttpRequest
+     * @covers PmConverter\Converters\Http\HttpRequest::prepareBody()
+     * @covers PmConverter\Converters\Http\HttpRequest::__toString()
+     * @return void
+     */
+    public function testPrepareJsonBody()
+    {
+        $body = (object)[
+            'mode' => 'raw',
+            'raw' => $needle = '["lorem ipsum dolor sit amet"]',
+            'options' => (object)[
+                'raw' => (object)[
+                    'language' => 'json',
+                ]
+            ]
+        ];
+
+        $request = (new HttpRequest())
+            ->setVerb('GET')
+            ->setUrl('http://localhost')
+            ->setBody($body);
+
+        $this->assertStringContainsString($needle, (string)$request);
+    }
+}

tests/WgetRequestTest.php

@@ -0,0 +1,232 @@
+<?php
+
+declare(strict_types=1);
+
+use PHPUnit\Framework\TestCase;
+use PmConverter\Converters\Wget\WgetRequest;
+
+class WgetRequestTest extends TestCase
+{
+    /**
+     * @covers PmConverter\Converters\Abstract\AbstractRequest
+     * @covers PmConverter\Converters\Wget\WgetRequest
+     * @covers PmConverter\Converters\Wget\WgetRequest::prepareDescription()
+     * @covers PmConverter\Converters\Wget\WgetRequest::__toString()
+     * @return void
+     */
+    public function testPrepareNotEmptyDescription()
+    {
+        $request = (new WgetRequest())
+            ->setVerb('GET')
+            ->setUrl('http://localhost')
+            ->setDescription(null);
+
+        $result = explode("\n", (string)$request);
+
+        $this->assertFalse(str_starts_with($result[0], '# ') && str_starts_with($result[1], '# '));
+    }
+
+    /**
+     * @covers PmConverter\Converters\Abstract\AbstractRequest
+     * @covers PmConverter\Converters\Wget\WgetRequest
+     * @covers PmConverter\Converters\Wget\WgetRequest::prepareDescription()
+     * @covers PmConverter\Converters\Wget\WgetRequest::__toString()
+     * @return void
+     */
+    public function testPrepareEmptyDescription()
+    {
+        $description = [
+            'lorem ipsum',
+            'dolor sit',
+            'amet',
+        ];
+        $needle = implode("\n", [
+            '# lorem ipsum',
+            '# dolor sit',
+            '# amet',
+        ]);
+
+        $request = (new WgetRequest())
+            ->setVerb('GET')
+            ->setUrl('http://localhost')
+            ->setDescription(implode("\n", $description));
+
+        $this->assertStringContainsString($needle, (string)$request);
+    }
+
+    /**
+     * @covers PmConverter\Converters\Abstract\AbstractRequest
+     * @covers PmConverter\Converters\Wget\WgetRequest
+     * @covers PmConverter\Converters\Wget\WgetRequest::prepareHeaders()
+     * @covers PmConverter\Converters\Wget\WgetRequest::__toString()
+     * @return void
+     */
+    public function testPrepareHeaders()
+    {
+        $headers = [
+            (object)[
+                'key' => 'Header1',
+                'value' => 'Value 1',
+                'disabled' => true,
+            ],
+            (object)[
+                'key' => 'Header2',
+                'value' => 'Value 2',
+                'disabled' => false,
+            ],
+            (object)[
+                'key' => 'Header3',
+                'value' => 'Value 3',
+            ],
+        ];
+        $needle = implode("\n", [
+            "\t--header 'Header2: Value 2' \ ",
+            "\t--header 'Header3: Value 3' \ ",
+        ]);
+
+        $request = (new WgetRequest())
+            ->setVerb('GET')
+            ->setUrl('http://localhost')
+            ->setHeaders($headers);
+
+        $this->assertStringContainsString($needle, (string)$request);
+    }
+
+    /**
+     * @covers PmConverter\Converters\Abstract\AbstractRequest
+     * @covers PmConverter\Converters\Wget\WgetRequest
+     * @covers PmConverter\Converters\Wget\WgetRequest::prepareBody()
+     * @covers PmConverter\Converters\Wget\WgetRequest::__toString()
+     * @return void
+     */
+    public function testPrepareFormdataBodyGet()
+    {
+        $body = (object)[
+            'mode' => 'formdata',
+            'formdata' => [
+                (object)[
+                    'key' => 'param1',
+                    'value' => 'value1',
+                    'type' => 'text',
+                ],
+                (object)[
+                    'key' => 'param2',
+                    'src' => '/tmp/somefile.txt',
+                    'type' => 'file',
+                ],
+                (object)[
+                    'key' => 'param3',
+                    'value' => 'value3',
+                    'type' => 'text',
+                ],
+            ],
+        ];
+        $needle = 'http://localhost?' . http_build_query([
+            'param1' => 'value1',
+            'param3' => 'value3',
+        ]);
+
+        $request = (new WgetRequest())
+            ->setVerb('GET')
+            ->setUrl('http://localhost')
+            ->setBody($body);
+
+        $this->assertStringContainsString($needle, (string)$request);
+    }
+
+    /**
+     * @covers PmConverter\Converters\Abstract\AbstractRequest
+     * @covers PmConverter\Converters\Wget\WgetRequest
+     * @covers PmConverter\Converters\Wget\WgetRequest::prepareBody()
+     * @covers PmConverter\Converters\Wget\WgetRequest::__toString()
+     * @return void
+     */
+    public function testPrepareFormdataBodyPost()
+    {
+        $body = (object)[
+            'mode' => 'formdata',
+            'formdata' => [
+                (object)[
+                    'key' => 'param1',
+                    'value' => 'value1',
+                    'type' => 'text',
+                ],
+                (object)[
+                    'key' => 'param2',
+                    'src' => '/tmp/somefile.txt',
+                    'type' => 'file',
+                ],
+                (object)[
+                    'key' => 'param3',
+                    'value' => 'value3',
+                    'type' => 'text',
+                ],
+            ],
+        ];
+        $needle = http_build_query([
+            'param1' => 'value1',
+            'param3' => 'value3',
+        ]);
+
+        $request = (new WgetRequest())
+            ->setVerb('POST')
+            ->setUrl('http://localhost')
+            ->setBody($body);
+
+        $this->assertStringContainsString($needle, (string)$request);
+    }
+
+    /**
+     * @covers PmConverter\Converters\Abstract\AbstractRequest
+     * @covers PmConverter\Converters\Wget\WgetRequest
+     * @covers PmConverter\Converters\Wget\WgetRequest::prepareBody()
+     * @covers PmConverter\Converters\Wget\WgetRequest::__toString()
+     * @return void
+     */
+    public function testPrepareJsonBodyGet()
+    {
+        $body = (object)[
+            'mode' => 'raw',
+            'raw' => $needle = '["lorem ipsum dolor sit amet"]',
+            'options' => (object)[
+                'raw' => (object)[
+                    'language' => 'json',
+                ]
+            ]
+        ];
+
+        $request = (new WgetRequest())
+            ->setVerb('GET')
+            ->setUrl('http://localhost')
+            ->setBody($body);
+
+        $this->assertStringNotContainsString($needle, (string)$request);
+    }
+
+    /**
+     * @covers PmConverter\Converters\Abstract\AbstractRequest
+     * @covers PmConverter\Converters\Wget\WgetRequest
+     * @covers PmConverter\Converters\Wget\WgetRequest::prepareBody()
+     * @covers PmConverter\Converters\Wget\WgetRequest::__toString()
+     * @return void
+     */
+    public function testPrepareJsonBodyPost()
+    {
+        $body = (object)[
+            'mode' => 'raw',
+            'raw' => $needle = '["lorem ipsum dolor sit amet"]',
+            'options' => (object)[
+                'raw' => (object)[
+                    'language' => 'json',
+                ]
+            ]
+        ];
+
+        $request = (new WgetRequest())
+            ->setVerb('POST')
+            ->setUrl('http://localhost')
+            ->setBody($body);
+
+        $this->assertStringContainsString($needle, (string)$request);
+    }
+}