knit

Knit

knit is a code generation toolkit that simplifies the process of adding and maintaining custom code generators in any project. The tool is written in Go, but its usage is not limited to just Go projects. Generate code into any file using just an input and a template. Inputs can be in a variety of formats including plain json or yaml, or use custom loaders to parse openapi, graphql and protobuf files.

• Usage Docs
• Go Template Engine

Installation

Homebrew

Users with homebrew can simply install via tap:

brew install knitcodegen/tap/knit

Go Install

If you're working in a Go environment

go install github.com/knitcodegen/knit@latest

Examples

The following examples will use knit to generate code from an openapi 3.0 specification.

openapi.yml

openapi: "3.0.0"
info:
  version: 1.0.0
  title: Example Codegen
paths:
  /pets:
    post:
      operationId: CreatePet
  /cars:
    post:
      operationId: CreateCar

template.tmpl

{{ range $k, $v := .Paths }} 
  func {{ .Post.OperationID }}() error {
    return nil
  }
{{end}}  

example.go:

package example

/*
  @knit input ./openapi.yml
  @knit loader openapi3
  @knit template ./template.tmpl 
*/
// @+knit
// @!knit

Now running knit example.go will update the file:

package example

/*
  @knit input ./openapi.yml
  @knit loader openapi3
  @knit template ./template.tmpl 
*/
// @+knit

func CreatePet() error {
  return nil
}

func CreateCar() error {
  return nil
}

// @!knit

The same code can also be generated from the command line. Instead of inserting the result into a file, it's written to stdout:

knit generate \
  --input="./openapi.yml" \
  --loader="openapi3" \
  --template="./template.tmpl" > codegen.go

codegen.go:

func CreatePet() error {
  return nil
}

func CreateCar() error {
  return nil
}