omg.jsonparser

The simple JSON parser with validation by condition

Programming language: Go

License: MIT License

Tags: Json    

README

omg.jsonParser

omg.jsonParser is a simple JSON parser with a simple condition validation. It's a wrapper on standard go JSON lib. With it help you can add the validation condition via golang structure fields tags.

Example

package main

import (
    "fmt"

    "github.com/dedalqq/omg.jsonparser"
)

func main() {
    jsonData := `{"name": ""}`

    st := struct {
        Name string `json:"name,notEmpty"` // added notEmpty for enable validation for it field
    }{}

    err := jsonparser.Unmarshal([]byte(jsonData), &st)
    if err != nil {
        fmt.Println(err.Error()) // print: value [name] must be not empty
    }
}

Tag struct

json:"[name][,option]..."

Tag examples

Here are some the tag examples:

package main

type data struct {
    F1 string   `json:"f1,notEmpty"`          // the field must be not empty but can be "null" or may not exist
    F2 string   `json:"f2,notEmpty,required"` // the field is required and must be not empty but may be the "null" value
    F3 string   `json:"f3,notEmpty,notNull"`  // the field must be not empty and not "null" but may not exist
    F4 []string `json:"f4,notNull,min:3"`     // the field must be not "null" and contains 3 or more items but may not exist
}

Available tags options

Name	Types	Description
required	any	The field must be exist with any value or null
notEmpty	any	The field can be not exist but if exist value must be not zero value but can be null
notEmpty	slice	The field must have one element or more but may be null or not exist
notNull	any	The field should not be null, but may not exist
uniq	[]string	The strings slice must contains only unique strings
min:n	slice	The slice must have n items or more
max:n	slice	The slice must have n items or less
min:n	string	The string must have n runes or more
max:n	string	The string must have n runes or less
min:n	int/uint	The value must be equals n or more
max:n	int/uint	The value must be equals n or less