Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

structs

package module

Go to main page

Versions in this module

v0

v0.2.0

Jun 12, 2026

Changes in this version

+ var DefaultCLITags = []string

type Option

+ func WithValidationTag(tag string) Option

v0.1.0

Jun 11, 2026

Changes in this version

+ var DefaultEncodingTags = []string

+ var DefaultRules = map[string]RuleFunc

+ var DefaultTags = []string

+ var ErrInputPointer = errors.New("structure should be a pointer")

+ var ErrInputPointerStruct = errors.New("structure should be a pointer to a struct")

+ func MapDefaultValues(fields []Field, values map[string]any, tagPriority ...string) map[string]any

+ func SetField(field Field, settings Settings, inputs map[string]any) error

+ func SetFields(fields []Field, settings Settings, inputs map[string]any) error

+ func SetStructFields(structure any, settings Settings, inputs map[string]any) error

+ func ValidateStructFields(ruleFuncs map[string]RuleFunc, structFields []Field, values map[string]any, ...) (map[string][]string, error)

+ type Field struct

+ Default string

+ FQN *Field

+ Fields []Field

+ Kind reflect.Kind

+ Name string

+ Parent *Field

+ Rules []Rule

+ Tags map[string]string

+ Type string

+ Value reflect.Value

+ func GetStructFields(structure any, parent *Field, encodingTags []string) ([]Field, error)

+ func NewField(name string, dataType reflect.Kind, value reflect.Value, ...) Field

+ type Option func(*Struct)

+ func WithEncodingTags(tags ...string) Option

+ func WithRules(rules map[string]RuleFunc) Option

+ func WithTags(tags ...string) Option

+ func WithValidationMessageTag(tag string) Option

+ type Rule struct

+ Args []string

+ Name string

+ type RuleFunc func(fieldName string, values map[string]any, defaultValue string, ...) (map[string][]string, error)

+ var OneOf RuleFunc = func(fieldName string, values map[string]any, defaultValue string, ...) (map[string][]string, error) { ... }

+ var Required RuleFunc = func(fieldName string, values map[string]any, defaultValue string, ...) (map[string][]string, error) { ... }

+ type Settings struct

+ AllowEnvOverride bool

+ AllowTagOverride bool

+ EncodingTags []string

+ TagOrder []string

+ type Struct struct

+ func New(structure any, opts ...Option) *Struct

+ func (m *Struct) Set(inputs map[string]any) error

+ func (m *Struct) Validate(inputs map[string]any) (map[string][]string, error)