Interface Definition Language Repository (idl-repository)

A repository and command line interface (CLI) for storing and fetching interface definitions in various formats. (Protocol Buffers, Avro, OpenAPI, etc.)

Quickstart

Initialize a project for the first time

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 dependencies into your project

Pull IDLs into your project.

idl pull

Read more about idl pull.

Push project to the repository

Push IDLs in your project to the configured repository.

idl push

Read more about idl push.

Documentation

Read the full documentation for idl.

Read the full documentation for the repository service, idl-repository.

Docker image

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

Building

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

Code of Conduct

We are committed to fostering an open and welcoming environment. Please read our code of conduct before participating in or contributing to this project.

Contributing

We welcome contributions and collaboration on this project. Please read our contributor's guide to understand how best to work with us.

License and Authors

GMV Syncromatics Engineering

This software is made available by GMV Syncromatics Engineering under the MIT license.