An open API service indexing awesome lists of open source software.

https://github.com/mcuadros/go-lookup

Small library on top of reflect for make lookups to any Structs or Maps
https://github.com/mcuadros/go-lookup

Last synced: 2 months ago
JSON representation

Small library on top of reflect for make lookups to any Structs or Maps

Awesome Lists containing this project

README

        

go-lookup [![Build Status](https://img.shields.io/github/workflow/status/mcuadros/go-lookup/Test.svg)](https://github.com/mcuadros/go-lookup/actions) [![GoDoc](http://godoc.org/github.com/mcuadros/go-lookup?status.png)](https://pkg.go.dev/github.com/mcuadros/go-lookup)
==============================

Small library on top of reflect for make lookups to Structs or Maps. Using a very simple DSL you can access to any property, key or value of any value of Go.

Installation
------------

The recommended way to install go-lookup

```
go get github.com/mcuadros/go-lookup
```

Example
-------

```go
type Cast struct {
Actor, Role string
}

type Serie struct {
Cast []Cast
}

series := map[string]Serie{
"A-Team": {Cast: []Cast{
{Actor: "George Peppard", Role: "Hannibal"},
{Actor: "Dwight Schultz", Role: "Murdock"},
{Actor: "Mr. T", Role: "Baracus"},
{Actor: "Dirk Benedict", Role: "Faceman"},
}},
}

q := "A-Team.Cast.Role"
value, _ := LookupString(series, q)
fmt.Println(q, "->", value.Interface())
// A-Team.Cast.Role -> [Hannibal Murdock Baracus Faceman]

q = "A-Team.Cast[0].Actor"
value, _ = LookupString(series, q)
fmt.Println(q, "->", value.Interface())
// A-Team.Cast[0].Actor -> George Peppard
```

### Case-insensitive matching

Use the `LookupI` and `LookupStringI` functions to do a case-insensitive match on struct field names and map keys. It will first look for an exact match; if that fails, it will fall back to a more expensive linear search over fields/keys.

```go
type ExampleStruct struct {
SoftwareUpdated bool
}

i := ExampleStruct{
SoftwareUpdated: true,
}

value, _ := LookupStringI(i, "softwareupdated")
fmt.Println(value.Interface())
// Output: true
```

License
-------

MIT, see [LICENSE](LICENSE)