govpp is a go binding for the vpp api

This repo provides the go binding for a version of vpp.

import "github.com/edwarnicke/govpp/binapi"

This repo also provides minimal docker containers for running vpp:

• vpp
• vpp-dbg - debug image

How to match the version of vpp you want to the go bindings.

Whenever a combination of VPP_VERSION and cherrypicks/patches is used to build vpp/vpp-dbg docker containers, they will be tagged in the docker repo. The corresponding tag will be laid on the main branch containing the corresponding binapi.

So simply run in the same directory as your go.mod file:

go get github.com/edwarnicke/govpp/binapi@${tag}

Where ${tag} is the tag of the vpp container you are consuming.

For example:

go get github.com/edwarnicke/govpp/[email protected]

To set your go dependency for govpp to match the docker container you are using.

What to do if you need a different version of vpp:

If you want a version of VPP, you can fork this repo and add it yourself. Because things are very heavily patterned and generated, its really quite easy:

1. Change default value for ARG VPP_VERSION in Dockerfile to the vpp tag or commit id you want to build.
2. go generate ./...
3. Add a GHCR_TOKEN secret to your fork containing a PAT allowing you to push to your Github Container Registry
4. Push a PR to your fork and merge it. This will push the vpp and vpp-dbg images to your repo.

What to do if you need to cherrypick into VPP

See [patch/patch.sh]. Simply add your cherrypicks to that file.

What to do if you need to patch vpp:

If you want to add patches to vpp simply add them with the .patch suffix to the patch/ directory.

What to do if you need a different version of govpp

Change the version of govpp in the go.mod file

How the magic works

See How the Magic Works.