star

Documentation

Index

• Constants
• func GetTemplate(fType feature.FeatureType) ([]byte, error)
• func RenderExistingProtoTemplate(inputs ProtoStarInputs) ([]byte, error)
• type Builder
• type Compiler
  • func NewCompiler(registry *protoregistry.Types, ff *feature.FeatureFile, cw fs.ConfigWriter) Compiler
• type Formatter
  • func NewStarFormatter(filePath, featureName string, fType feature.FeatureType, cw fs.ConfigWriter, ...) Formatter
• type ProtoStarInputs

Constants

const (
	FeatureConstructor   starlark.String = "feature"
	FeatureVariableName  string          = "result"
	DefaultValueAttrName string          = "default"
	DescriptionAttrName  string          = "description"
	RulesAttrName        string          = "rules"
)

Functions

func GetTemplate

func GetTemplate(fType feature.FeatureType) ([]byte, error)

func RenderExistingProtoTemplate

func RenderExistingProtoTemplate(inputs ProtoStarInputs) ([]byte, error)

RenderExistingProtoTemplate will render the parsed Proto message descriptor into a Starlark feature model

Types

type Builder

type Builder interface {
	Build() (*feature.CompiledFeature, error)
}

type Compiler

type Compiler interface {
	Compile(context.Context, feature.NamespaceVersion) (*feature.CompiledFeature, error)
	Persist(ctx context.Context, f *feature.Feature, nv feature.NamespaceVersion, ignoreBackwardsCompatibility, dryRun bool) (persisted bool, diffExists bool, err error)
}

func NewCompiler

func NewCompiler(registry *protoregistry.Types, ff *feature.FeatureFile, cw fs.ConfigWriter) Compiler

Compile takes the following parameters: protoDir: path to the proto directory that stores all user-defined proto files starfilePath: path to the .star file that defines this feature flag featureName: human-readable name of this feature flag. Also matches the starfile name.

type Formatter

type Formatter interface {
	Format(ctx context.Context) (persisted, diffExists bool, err error)
}

func NewStarFormatter

func NewStarFormatter(filePath, featureName string, fType feature.FeatureType, cw fs.ConfigWriter, dryRun bool) Formatter

type ProtoStarInputs

type ProtoStarInputs struct {
	Message  string
	Packages map[string]string
	Fields   []string
}