https://github.com/meriororen/pmtoapib

Fork from https://github.com/PhillippOhlandt/pmtoapib
https://github.com/meriororen/pmtoapib

api-blueprint apib apiblueprint postman

Last synced: 17 days ago
JSON representation

Fork from https://github.com/PhillippOhlandt/pmtoapib

• Host: GitHub
• URL: https://github.com/meriororen/pmtoapib
• Owner: meriororen
• Created: 2020-09-03T14:57:20.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2020-09-03T14:57:58.000Z (over 4 years ago)
• Last Synced: 2024-04-30T10:27:15.914Z (8 months ago)
• Topics: api-blueprint, apib, apiblueprint, postman
• Language: Go
• Size: 53.7 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
Some additional patches added to support v2.1

# Postman to Api Blueprint Converter

A simple tool to convert Postman collection exports (**v2**) to Api Blueprint documentation.

Notice: It uses the [Aglio](https://github.com/danielgtaylor/aglio) include syntax!

## Usage

Assuming that `collection.json` is your Postman collection export.

```

pmtoapib -collection collection.json -destination docs

```

The `docs` folder will be created with the following content

```

├── collection-name.apib

└── responses

    ├── get-200-me.json

    ├── get-200-users.json

    ├── post-200-me.json

    └── users

        ├── get-200_userID_2-2.json

        └── get-404_userID_1-2.json

```

The `responses` folder contains JSON files with the (pretty printed) response bodies.

If a request has no exported responses (e.g. you didn't save any in Postman), 

the response file will contain an empty JSON object.

The folders inside the `responses` folder line up with the request paths and

the files are named with the following pattern: `{method}-{response name}-{last element in url}.json`.

By default, the collection name will be used as the `.apib` filename.

It can be overridden with the `-apibname` parameter.

```

pmtoapib -collection collection.json -destination docs -apibname users

```

This will generate a `users.apib` file.

## Usage with Docker

You can also use the Docker image if you don't use Mac OS and don't want to compile it on your own.

```

docker run --rm -it -v "$PWD:/opt" phillippohlandt/pmtoapib -collection collection.json -destination docs

```

## Command Line Flags

| Command | Short Version | Type | Default Value | Description |

|---------|---------------|------|---------------|-------------|

| -collection | -c | string | | Path to the Postman collection export |

| -destination | -d | string | `./` | Destination folder path for the generated files |

| -apibname | | string | | Set a custom name for the generated .apib file |

| -force-apib | | boolean | `false` | Override existing .apib files |

| -force-responses | | boolean | `false` | Override existing response files |

| -dump-request | | string | | Output the markup for a single request (Takes a request name) |

| -environment-path | | string | | Path to the Postman Environment export |

## Options

### Exclude Requests

To exclude a whole request from the generated `.apib` file, simply put the string `pmtoapib_exclude` 

in the request description. It will also prevent the generation of the response files for that request.