This repository contains the service definitions and code generated stubs for Cofide's APIs, used for open source projects (e.g. cofidectl) and the Cofide product.
Services and messages are defined using Protocol Buffers (protobuf).
This repository uses the Buf CLI to help generate and manage Cofide's protobuf definitions and schemas. The following tools must be available in order to generate code stubs.
For convenience, a set of useful commands have been added to the Justfile in the project root. Some of the key commands include:
just fmt- Formats the protobuf definitionsjust lint- Lints the protobuf definitions in accordance with best practicesjust proto-gen- Generates the code stubs from the protobuf definitions using the defined plugins (specified in buf.gen.yaml)
The .proto files are in the proto directory, and the generated stubs for Go are in the gen/proto/go directory.
The service definitions in this repository are not currently guaranteed to be backward compatible over time, and have been versioned as v1alpha1 to indicate this.
As Cofide projects and product mature, we will move to v1 and guarantee backward compatibility from that point.