ravagepdf
v0.1.7
Published
PDF generation from OpenAPI / Swagger Spec
Downloads
310
Maintainers
Readme
ravagepdf
Check coverage 2
Introduction
Ravagepdf is a cli, with you can easily convert your openapi.json or openapi.yml specs from URL or from file to PDF with simple command. It takes few seconds to generate file. All methods are async, and can be used async within projects for async PDF generation.
Features
- URL api spec support (YML and JSON)
- OpenAPI file spec support (YML and JSON)
- Table of Contents
- Handler description
- Request description
- Response description
- Examples for Response and Request
- OpenAPI3.0 support with AnyOf, OneOf and others
- Enum examples support
- Description for all params in body
Examples of usage
Installation
npm i -g ravagepdf
Example with URL
ravagepdf -s https://app.swaggerhub.com/apiproxy/registry/Direct_Wines/CartAPISuite/1.7.0\?resolved\=true\&flatten\=true\&pretty\=true -o pdfDocs.pdf
Example with file
JSON
ravagepdf -s openapi.json -o pdfDocs.pdf
YML
ravagepdf -s openapi.yml -o pdfDocs.pdf