OpenAPI YAML to CSV/Excel Converter

This is a CLI tool for converting OpenAPI YAML file to CSV/Excel file. Please see the following examples below to better understand this tool.

Input file example

input.yaml

Output file example

output.csv output.xlsx

This tool supports OpenAPI 3.0.0 or later and supports fields below.

| Field name | Support | | --------------------------- | :-----: | | [path].summary | ✅ | | [path].descripition | ✅ | | [path].[method].tags | ✅ | | [path].[method].summary | ✅ | | [path].[method].description | ✅ | | [path].[method].operationId | ✅ |

Usage

Convert to CSV/Excel

Command

npx openapi-yaml-to-csv-excel convert -i input-file.yaml -o output-file.csv

npx openapi-yaml-to-csv-excel convert -i input-file.yaml -o output-file.xlsx

Options

| Option | Required | Description | | ------------ | -------- | ---------------- | | -i, --input | yes | Input file name | | -o, --output | no | Output file name |

Update existing file

Command

npx openapi-yaml-to-csv-excel update -i input-file.yaml -u update-file.csv -o output-file.csv

npx openapi-yaml-to-csv-excel update -i input-file.yaml -u update-file.xlsx -o output-file.xlsx

Options

| Option | Required | Description | | ------------ | -------- | ------------------ | | -i, --input | yes | Input file name | | -u, --update | yes | Updating file name | | -o, --output | no | Output file name |

Roadmap

• [x] Add update command
• [x] Add converter to excel
• [ ] Add an option for selecting output columns
• [ ] Add an option for specifying update csv header names
• [ ] Support all OpenAPI fields

Contributing

Contributions are welcome! If you find a bug or want to request a new feature, please open a new issue.

License

OpenAPI YAML to CSV/Excel is available under the MIT License.