Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rodkranz/nested
Get value from *map[string]interface{}* easier
https://github.com/rodkranz/nested
Last synced: about 2 months ago
JSON representation
Get value from *map[string]interface{}* easier
- Host: GitHub
- URL: https://github.com/rodkranz/nested
- Owner: rodkranz
- License: mit
- Created: 2018-08-06T21:29:23.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2020-02-13T15:19:37.000Z (almost 5 years ago)
- Last Synced: 2024-06-20T06:24:22.040Z (7 months ago)
- Language: Go
- Size: 2.37 MB
- Stars: 12
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://travis-ci.org/rodkranz/nested)
[](https://godoc.org/github.com/rodkranz/nested)
[](https://raw.githubusercontent.com/rodkranz/nested/master/LICENSE)
[](https://goreportcard.com/report/github.com/rodkranz/nested)
# NESTED
Simple function to get value from `map[string]interface` without cast every nest field.
## Source ##
* Nested Source
* Version: 1.2.0
* License: MIT-style
## Summary ##
* [About](#about)
* [how to install](#how-to-install)
* [How to import](#how-to-import)
* [Run Test](#run-test)
* [Run Benchmark](#run-benchmark)
* [Example](#example)
* [Documentation](https://godoc.org/github.com/rodkranz/nested)
## About ##
Something you need to get value from `map` and this value is an `interface` type, you need to cast this value
for an type that you know or in nested case you must cast this value and cast for the time that you want.
## How to install ##
```shell
go get github.com/rodkranz/nested
```
## How to import ##
```go
import (
"github.com/rodkranz/nested"
)
```
## Run test ##
To run the project test
```shell
go test -v --cover
```
## Run benchmark ##
To run the benchmark
```shell
go test -cpuprofile cpu.prof -memprofile mem.prof -bench .
```
Check benchmark in browser
```$shell
pprof -http=:8080 cpu.prof
```
To check this result in browser you must have [pprof](https://github.com/google/pprof)
## Example ##
Example os input data
```go
data := map[string]interface{}{
"person": map[string]interface{}{
"name": "Rodrigo",
"level": 3,
},
"session": map[string]interface{}{
"token": "62vsy29v8y4v248v5y97v1e21v35ce97",
"expire": "2018-08-08T18:00:00Z",
},
"images": map[string]interface{}{},
}
```
This is the most common usage how to get the name as string type:
```go
personValue, ok := data["person"]
if !ok {
log.Fatal("There is no person")
}
personMap, ok := personValue.(map[string]interface{})
if !ok {
log.Fatal("cannot cast value to map")
}
nameInterface, ok := personMap["name"]
if !ok {
log.Fatal("Person has no name")
}
name, ok := personMap["name"].(string)
if !ok {
log.Fatal("cannot cast value to string")
}
// name is variable with type string
fmt.Println("Name is ", name)
```
If you want to get `string` name of person you can use:
```go
name, found := nested.String("person.name", data);
if !found {
log.Fatal("cannot find name value as string")
}
fmt.Println("Found name", name)
```
If you want to get `int` level of person you can use:
```go
level, found := nested.Int("person.level", data);
if !found {
log.Fatal("cannot find level value as int")
}
fmt.Println("User is level", level)
```
If you want to get `time.Time` expire of person you can use:
```go
{
expire, found := nested.Time("session.expire", data, time2.RFC3339);
if !found {
log.Fatal("cannot find expire value as time.Time")
}
fmt.Println("The token will expire at ", expire)
}
{
// You can use as 3 parameter a layout of time
expire, found := nested.Time("session.expire", data, "2006-01-02");
if !found {
log.Fatal("cannot find expire value as time.Time with custom layout")
}
fmt.Println("The token will expire at ", expire)
}
```
If you want to get `interface` images of person you can use:
```go
images, found := nested.Interface("images", data);
if !found {
log.Fatal("cannot find images value as interface{}")
}
fmt.Println("Empty map", images)
```