generator

Documentation

Overview

Package generator provides tools to generate ObjectBox entity bindings between GO structs & ObjectBox schema

Index

• Constants
• func Clean(codeGenerator CodeGenerator, path string) error
• func ModelInfoFile(dir string) string
• func Process(sourceFile string, options Options) error
• func WriteFile(file string, data []byte, permSource string) error
• type CodeGenerator
• type Options

Constants

const Version = "0.9.0"

Version specifies the current generator version.

const VersionId = 6

VersionId specifies the current generator version identifier. It is used to validate generated code compatibility and is increased when there are changes in the generated code. Internal generator changes that don't change the output do not cause an increase.

Functions

func Clean

func Clean(codeGenerator CodeGenerator, path string) error

Clean removes generated files in the given path. Removes *.obx.go and objectbox-model.go but keeps objectbox-model.json

func ModelInfoFile

func ModelInfoFile(dir string) string

ModelInfoFile returns the model info JSON file name in the given directory

func Process

func Process(sourceFile string, options Options) error

Process is the main API method of the package it takes source file & model-information file paths and generates bindings (as a sibling file to the source file)

func WriteFile

func WriteFile(file string, data []byte, permSource string) error

WriteFile writes data to targetFile, while using permissions either from the targetFile or permSource

Types

type CodeGenerator

type CodeGenerator interface {
	// IsGeneratedFile returns true if the given path is recognized as a file generated by this generator
	IsGeneratedFile(file string) bool

	// ParseSource reads the source file and creates a model representation
	ParseSource(sourceFile string) (*model.ModelInfo, error)

	// WriteBindingFiles generates and writes binding source code files
	WriteBindingFiles(sourceFile string, options Options, mergedModel *model.ModelInfo) error

	// WriteBindingFiles generates and writes binding source code file for model setup
	WriteModelBindingFile(options Options, mergedModel *model.ModelInfo) error
}

CodeGenerator interface is used to abstract per-language generators, e.g. for Go, C, C++, etc

type Options

type Options struct {
	ModelInfoFile string
	ByValue       bool // TODO move to gogenerator
	Rand          *rand.Rand

	// NOTE - currently only supports one
	CodeGenerator CodeGenerator
}

Options provide configuration for the generator