Postman collection converter

Convert your Postman collections into different formats.

Very fast.
Offline.
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.

Supported features

• collection schema v2.1;
• 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);
• json body (forces header Content-Type to application/json);
• formdata body (including disabled fields for http-format; forces header Content-Type to multipart/form-data)

Planned features

• support as many as possible/necessary of authentication kinds (currently no ones);
• support as many as possible/necessary of body formats (currently json and formdata);
• documentation generation support (markdown) with responce examples (if present);
• maybe some another convert formats (like httpie or something...);
• replace {{vars}} from folder;
• replace {{vars}} from environment;
• performance measurement;
• better logging;
• tests, phpcs, psalm, etc.;
• web version.

Installation

composer global r axenov/pm-convert

Make sure your ~/.config/composer/vendor/bin is in $PATH env:

echo $PATH | grep --color=auto 'composer'
# if not then execute this command and add it into ~/.profile:
export PATH="$PATH:~/.config/composer/vendor/bin"

Usage

$ pm-convert --help
Postman collection converter
Usage:
    ./pm-convert -f|-d PATH -o OUTPUT_PATH [ARGUMENTS] [FORMATS]
    php pm-convert -f|-d PATH -o OUTPUT_PATH [ARGUMENTS] [FORMATS]
    composer pm-convert -f|-d PATH -o OUTPUT_PATH [ARGUMENTS] [FORMATS]
    ./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
    -p, --preserve   - do not delete OUTPUT_PATH (if exists)
    -h, --help       - show this help message and exit
    -v, --version    - show version info and exit

If both -c and -d are specified then only unique set of files will be converted.
-f or -d are required to be specified at least once, but each may be specified multiple times.
PATH must be a valid path to readable json-file or directory.
OUTPUT_PATH must be a valid path to writeable directory.
If -o is specified several times then only last one will be applied.

Possible FORMATS:
    --http   - generate raw *.http files (default)
    --curl   - generate shell scripts with curl command
    --wget   - generate shell scripts with wget command
If no FORMATS specified then --http implied.
Any of FORMATS can be specified at the same time.

Example:
    ./pm-convert \
        -f ~/dir1/first.postman_collection.json \
        --directory ~/team \
        --file ~/dir2/second.postman_collection.json \
        -d ~/personal \
        -o ~/postman_export

Notice

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.

License

You can use, share and develop this project according to MIT License.

Postman is protected legal trademark of Postman, Inc.

---

Disclaimer

I'm not affiliated with Postman, Inc. in any way.

I'm just a backend developer who is forced to use this javascripted gigachad-shitmonster.

So the goal of this project is to:

• take the data and its synchronization under own transparent control;
• easily migrate to something more RAM tolerant and productive, easier and free to use;
• get off the needle of the vendor lock, strict restrictions for teams and not to pay incredible $ for heavy useless WYSIWYGs;
• give YOU these opportunities.