Skip to content

Go library for 2-way mapping of structs to maps and maps to structs

License

Notifications You must be signed in to change notification settings

jschoedt/go-structmapper

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Go Coverage Status Go Report Card GoDoc GitHub

go-structmapper

Convert any struct into a map and vice versa.

Description

This library can recursively convert a struct to a map of type map[string]interface{} where the keys are the struct field names and the values are the field values. Similarly, the library can set the fields of a struct using a map.

A mapping function can be used to convert keys or values before they are set.

Features

  • Handles composed structs
  • Handles nested structs
  • Handles reference cycles
  • Supports unexported fields
  • Supports field mapping or conversion

Prerequisites

Not all types are tested or supported yet eg. interface, function, channel

go get -u github.com/jschoedt/go-structmapper

Default usage

// convert struct to map
s := &SomeStruct{Name: "John"}
mapper := mapper.New()
m, err := mapper.StructToMap(s) // m["Name"] == "John"

// convert map to struct
s = &SomeStruct{}
err := mapper.MapToStruct(m, s) // s.Name == "John"

Using a conversion mapping

A MapFunc can be used to map a key or value to some other key or value. Returning the MappingType mapper.Ignore will ignore that field. The MapFunc will be called on every field that is encountered in the struct

s := &SomeStruct{Name: "John"}
mapper := mapper.New()
mapper.MapFunc = func(inKey string, inVal interface{}) (mt MappingType, outKey string, outVal interface{}) {
	return mapper.Default, strings.ToLower(inKey), "Deere"
}
m, err := mapper.StructToMap(s) // m["name"] == "Deere"

// convert map to struct
s = &SomeStruct{}
mapper.CaseSensitive = false // now 'name' will match 'Name'
err := mapper.MapToStruct(m, s) // s.Name == "Deere"

More examples

About

Go library for 2-way mapping of structs to maps and maps to structs

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages