A repository and command line interface (CLI) for storing and fetching interface definitions in various formats. (Protocol Buffers, Avro, OpenAPI, etc.)
Initializing a project creates a new idl.yaml
file with the project name and repository URL.
idl init my-project http://idl-repository.example.com
Read more about idl init
.
Pull IDLs into your project.
idl pull
Read more about idl pull
.
Push IDLs in your project to the configured repository.
idl push
Read more about idl push
.
Read the full documentation for idl
.
Read the full documentation for the repository service, idl-repository
.
If you want to run idl
inside a Docker container, you can do so:
docker run --rm -v $PWD:/data syncromatics/idl:__VERSION__ --help
Where __VERSION__
is a valid tag from the syncromatics/idl Docker repository
You'll need Docker to build the Docker image for the repository.
Download dependencies
go get -t -v ./...
Build the CLI and repository server
make build
We are committed to fostering an open and welcoming environment. Please read our code of conduct before participating in or contributing to this project.
We welcome contributions and collaboration on this project. Please read our contributor's guide to understand how best to work with us.
This software is made available by GMV Syncromatics Engineering under the MIT license.