bavard

README

bavard

Internal package with some code-generation helper (txt/template and asm).

Used by:

• gnark
• gurvy
• goff

Documentation

Overview

Package bavard contains helper functions to generate consistent code from text/template templates it is used by github.com/consensys/gurvy && github.com/consensys/gnark && github.com/consensys/goff

Index

• func Apache2(copyrightHolder string, year int) func(*Bavard) error
• func Apache2Header(copyrightHolder string, year int) string
• func BuildTag(buildTag string) func(*Bavard) error
• func Format(v bool) func(*Bavard) error
• func Funcs(funcs template.FuncMap) func(*Bavard) error
• func Generate(output string, templates []string, data interface{}, ...) error
• func GenerateF(output string, templateF []string, data interface{}, ...) error
• func GeneratedBy(label string) func(*Bavard) error
• func Import(v bool) func(*Bavard) error
• func Package(name string, doc ...string) func(*Bavard) error
• func Verbose(v bool) func(*Bavard) error
• type BatchGenerator
  • func NewBatchGenerator(copyrightHolder, generatedBy string) *BatchGenerator
  • func (b *BatchGenerator) Generate(entries ...Entry) error
  • func (b *BatchGenerator) GenerateF(data interface{}, packageName string, baseTmplDir string, entries ...EntryF) error
• type Bavard
• type Entry
• type EntryF

Functions

func Apache2

func Apache2(copyrightHolder string, year int) func(*Bavard) error

Apache2 returns a bavard option to be used in Generate writing an apache2 licence header in the generated file

func Apache2Header

func Apache2Header(copyrightHolder string, year int) string

Apache2Header returns a Apache2 header string

func BuildTag

func BuildTag(buildTag string) func(*Bavard) error

BuildTag returns a bavard option to be used in Generate adding build tags string on top of the generated file

func Format

func Format(v bool) func(*Bavard) error

Format returns a bavard option to be used in Generate. If set to true, will run gofmt on generated file. Or simple tab alignment on .s files

func Funcs

func Funcs(funcs template.FuncMap) func(*Bavard) error

Funcs returns a bavard option to be used in Generate. See text/template FuncMap for more info

func Generate

func Generate(output string, templates []string, data interface{}, options ...func(*Bavard) error) error

Generate will concatenate templates and create output file from executing the resulting text/template see other package functions to add options (package name, licensing, build tags, ...)

func GenerateF

func GenerateF(output string, templateF []string, data interface{}, options ...func(*Bavard) error) error

GenerateF will concatenate templates and create output file from executing the resulting text/template see other package functions to add options (package name, licensing, build tags, ...)

func GeneratedBy

func GeneratedBy(label string) func(*Bavard) error

GeneratedBy returns a bavard option to be used in Generate writing a standard "Code generated by 'label' DO NOT EDIT"

func Import

func Import(v bool) func(*Bavard) error

Import returns a bavard option to be used in Generate. If set to true, will run goimports

func Package

func Package(name string, doc ...string) func(*Bavard) error

Package returns a bavard option adding package name and optional package documentation in the generated file

func Verbose

func Verbose(v bool) func(*Bavard) error

Verbose returns a bavard option to be used in Generate. If set to true, will print to stdout during code generation

Types

type BatchGenerator

type BatchGenerator struct {
	// contains filtered or unexported fields
}

BatchGenerator enables more efficient and clean multiple file generation

func NewBatchGenerator

func NewBatchGenerator(copyrightHolder, generatedBy string) *BatchGenerator

NewBatchGenerator returns a new BatchGenerator

func (*BatchGenerator) Generate

func (b *BatchGenerator) Generate(entries ...Entry) error

Generate an entry with generator default config

func (*BatchGenerator) GenerateF

func (b *BatchGenerator) GenerateF(data interface{}, packageName string, baseTmplDir string, entries ...EntryF) error

GenerateF an entry with generator default config

type Bavard

type Bavard struct {
	// contains filtered or unexported fields
}

Bavard root object to configure the code generation from text/template

type Entry

type Entry struct {
	File        string
	Templates   []string
	BuildTag    string
	PackageName string
	PackageDoc  string
	Data        interface{}
}

Entry to be used in batch generation of files

type EntryF

type EntryF struct {
	File       string
	TemplateF  []string
	BuildTag   string
	PackageDoc string
}

EntryF to be used in batch generation of files