All Projects → asyncapi → converter-go

asyncapi / converter-go

Licence: Apache-2.0 license
Convert AsyncAPI documents from older to newer versions with Golang

Programming Languages

go
31211 projects - #10 most used programming language

Projects that are alternatives of or similar to converter-go

Kepubify
Fast, standalone EPUB to KEPUB converter CLI app / library (and a few other utilities).
Stars: ✭ 225 (+1223.53%)
Mutual labels:  converter
guepard
flash to html5 converter, as3 to javascript translator
Stars: ✭ 58 (+241.18%)
Mutual labels:  converter
fp-units
An FP-oriented library to easily convert CSS units.
Stars: ✭ 18 (+5.88%)
Mutual labels:  converter
Mpv Webm
Simple WebM maker for mpv, with no external dependencies.
Stars: ✭ 234 (+1276.47%)
Mutual labels:  converter
go-watermill-template
Go template for the AsyncAPI Generator using Watermill module
Stars: ✭ 38 (+123.53%)
Mutual labels:  asyncapi
java-xml-to-json
👾 convert XML to a structure-preserving JSON representation
Stars: ✭ 15 (-11.76%)
Mutual labels:  converter
Density Converter
A multi platform image density converting tool converting single or batches of images to Android, iOS, Windows or CSS specific formats and density versions given the source scale factor or width/height in dp. It has a graphical and command line interface and supports many image types (svg, psd, 9-patch, etc.) aswell as some lossless compressors like pngcrush.
Stars: ✭ 222 (+1205.88%)
Mutual labels:  converter
bank2ynab
Easily convert and import your bank's statements into YNAB. This project consolidates other conversion efforts into one universal tool.
Stars: ✭ 197 (+1058.82%)
Mutual labels:  converter
objectify-css
CLI for converting CSS rules to JavaScript style objects
Stars: ✭ 46 (+170.59%)
Mutual labels:  converter
java-spring-template
Java Spring template for the AsyncAPI Generator
Stars: ✭ 41 (+141.18%)
Mutual labels:  asyncapi
BatchEncoder
BatchEncoder is an audio files conversion software.
Stars: ✭ 145 (+752.94%)
Mutual labels:  converter
mdconv
A tool to convert markdown to html.
Stars: ✭ 38 (+123.53%)
Mutual labels:  converter
Audiblex
Audible audio book converter which actually works!
Stars: ✭ 26 (+52.94%)
Mutual labels:  converter
Bigbash
A converter that generates a bash one-liner from an SQL Select query (no DB necessary)
Stars: ✭ 230 (+1252.94%)
Mutual labels:  converter
json2table
Converts JSON to an HTML table
Stars: ✭ 52 (+205.88%)
Mutual labels:  converter
Retrofit Logansquare
A Converter implementation using LoganSquare JSON serialization for Retrofit 2.
Stars: ✭ 224 (+1217.65%)
Mutual labels:  converter
csv2vcf
🔧 Simple script in python to convert CSV files to VCF
Stars: ✭ 66 (+288.24%)
Mutual labels:  converter
caffe weight converter
Caffe-to-Keras weight converter. Can also export weights as Numpy arrays for further processing.
Stars: ✭ 68 (+300%)
Mutual labels:  converter
readable-web-to-node-stream
Converts a Web-API readable-stream into a Node readable-stream.
Stars: ✭ 33 (+94.12%)
Mutual labels:  converter
slackdown
A simple Slack message text formatting to HTML code converter.
Stars: ✭ 27 (+58.82%)
Mutual labels:  converter

AsyncAPI Converter

Go Doc Release Go Report Card

Overview

The AsyncAPI Converter converts AsyncAPI documents from versions 1.0.0, 1.1.0 and 1.2.0 to version 2.0.0. It supports both json and yaml formats on input and output. By default, the AsyncAPI Converter converts a document into the json format.

Prerequisites

Installation

To install the AsyncAPI Converter package, run:

go get github.com/asyncapi/converter-go/...

TIP: You can also get binaries from the latest GitHub release.

Usage

You can use the AsyncAPI Converter in the terminal or as a package.

In CLI

Before you use the AsyncAPI Converter in the terminal, build the application. Run:

git clone https://github.com/asyncapi/converter-go.git
cd ./converter-go
go build -o=asyncapi-converter ./cmd/api-converter/main.go

To convert a document use the following command:

asyncapi-converter <document_path> [--toYAML] [--id=<id>]

where:

  • document_path is a mandatory argument that is either a URL or a file path to an AsyncAPI document
  • --toYAML is an optional argument that allows producing results in the yaml format instead of json
  • --id is an optional argument that allows specifying the application id

Examples

See the following minimal examples of the AsyncAPI Converter usage in the terminal:

  • gitter-streaming conversion from version 1.2.0 to 2.0.0 in the json format

    asyncapi-converter https://git.io/fjMPF
    
  • gitter-streaming conversion from version 1.2.0 to 2.0.0 in the yaml format

    asyncapi-converter https://git.io/fjMPF --toYAML
  • gitter-streaming conversion from version 1.2.0 to 2.0.0 in the json format specifying the application id

    asyncapi-converter https://git.io/fjMXl --id=urn:com.asynapi.streetlights

As a package

To see examples of how to use the AsyncAPI Converter as a package, go to the README.md.

Contribution

If you have a feature request, add it as an issue or propose changes in a pull request (PR). If you create a feature request, use the dedicated Feature request issue template. When you create a PR, follow the contributing rules described in the CONTRIBUTING.md document.

Credits

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].