Have all service definitions and code generated stubs for OpenKCM APIs.

Several tools are required to generate the code:

1. protoc compiler: see the instruction on the official web site or install using homebrew brew install protobuf.
2. protoc-gen-go: install via go install google.golang.org/protobuf/cmd/protoc-gen-go@latest.
3. protoc-gen-go-grpc: install via go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest.
4. protofetch: download from the releases page of the GitHub repository or install via cargo install protofetch or npm install -g @coralogix/protofetch, or using any similar tool compatible with the npm registry.

Optionally, the buf CLI tool can be used to validate, detect breaking changes, and format .proto files:

• buf breaking --against https://github.com/openkcm/api-sdk.git#branch=main: detect breaking changes against the main branch of the remote repository.
• buf format -w: format .proto files.
• buf lint: lint .proto files.

There are several make targets defined in the Makefile:

• fetch-protos: download .proto dependencies using protofetch.
• generate: fetches .proto dependencies, formats .proto files, and generates Go code.
• install-tools: installs the tools (including optional) from the following sources: Homebrew, Go registry (via go install), NPM registry (via npm install -g). See the target definition for the details.
• validate: formats and lints .proto files, detects breaking changes.

For the rest make targets see Makefile.

.proto dependencies are managed with the protofetch tool. This tool downloads .proto files from a specified location of a git repository and places them into the vendor-proto directory. The dependencies are specified in the protofetch.toml file.

For instance, a dependency on the protovalidate proto definitions can be specified as follow:

name = "github.com/openkcm/api-sdk"
description = "API proto definitions and Go generated code used in the openkcm project"

[protovalidate]
url = "github.com/bufbuild/protovalidate"
revision = "v1.1.1"
content_roots = ["/proto/protovalidate"]
allow_policies = ["buf/validate/*"]

In order to fetch dependencies, execute:

$ protofetch -o vendor-proto fetch

The code can be generated with executing the following Make target

$ make generate

Ensure that the GOPRIVATE environment variable is set up:

$ go env -w GOPRIVATE="github.com/openkcm/*"

To use a specific branch of a repository in your Go project, you can use the go get command with the branch name. Here's an example:

go get github.com/openkcm/api-sdk/proto/kms/api/cmk/registry/system/v1@<branch-name>

To switch back to the default branch, follow these steps:

1. Update your dependencies to the latest version on the default branch:

go get github.com/openkcm/api-sdk/proto/kms/api/cmk/registry/system/v1@latest

2. Clean up:

$ go mod tidy

This project is open to feature requests/suggestions, bug reports etc. via GitHub issues. Contribution and feedback are encouraged and always welcome. For more information about how to contribute, the project structure, as well as additional contribution information, see our Contribution Guidelines.

If you find any bug that may be a security problem, please follow our instructions at in our security policy on how to report it. Please do not create GitHub issues for security-related doubts or problems.

We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone. By participating in this project, you agree to abide by its Code of Conduct at all times.

Copyright 2025 SAP SE or an SAP affiliate company and OpenKCM contributors. Please see our LICENSE for copyright and license information. Detailed information including third-party components and their licensing/copyright information is available via the REUSE tool.