This Repo is maintained by aimof because the original repo is not maintained resently. I use jason in github.com/aimof/apitest.

Go version: ^1.12.2 Original HEAD is 426ade25b261bcb4a7ad58c65badfc731854e92b

New Jason by aimof

• Perfect Compatibility!!
• Highly nested support!!

How to use new jason.

reader // your json reader.
// if you want to read []byte or string please use bytes.NewReader() or strings.NewReader().

// Create Value from reader
rootValue, err := NewValue(reader)

// If you want to use nested json.
v := rootValue.Get("Foo").Get(2).Get("Bar")
// Get(string): Object
// Get(int): Array

// Now, Value type has err in its own.
if v.err != nil {
  // handle error
}

// If you want to use v as Object.
o, err := v.Object()

---

If you want to read original README, please see below.

---

Jason is an easy-to-use JSON library for Go.

About

Jason is designed to be convenient for reading arbitrary JSON while still honoring the strictness of the language. Inspired by other libraries and improved to work well for common use cases. It currently focuses on reading JSON data rather than creating it. API Documentation can be found on godoc.org.

Install

go get github.com/antonholmquist/jason

Import

import (
  "github.com/aimof/jason"
)

Data types

The following golang values are used to represent JSON data types. It is consistent with how encoding/json uses primitive types.

• bool, for JSON booleans
• json.Number/float64/int64, for JSON numbers
• string, for JSON strings
• []*Value, for JSON arrays
• map[string]*Value, for JSON objects
• nil for JSON null

Examples

Create from bytes

Create object from bytes. Returns an error if the bytes are not valid JSON.

v, err := jason.NewObjectFromBytes(b)

If the root object is unknown or not an object, use NewValueFromBytes instead. It can then be typecasted using one of the conversion methods provided by the library, for instance Array() or String(). You can read object as NewValueFromReader.

v, err := jason.NewValueFromBytes(b)

Create from a reader (like a http response)

Create value from a io.reader. Returns an error if the string couldn't be parsed.

v, err := jason.NewObjectFromReader(res.Body)

Read values

Reading values is easy. If the key path is invalid or type doesn't match, it will return an error and the default value.

name, err := v.GetString("name")
age, err := v.GetInt64("age")
verified, err := v.GetBoolean("verified")
education, err := v.GetObject("education")
friends, err := v.GetObjectArray("friends")
interests, err := v.GetStringArray("interests")

Read nested values

Reading nested values is easy. If the path is invalid or type doesn't match, it will return the default value and an error.

name, err := v.GetString("person", "name")
age, err := v.GetInt64("person", "age")
verified, err := v.GetBoolean("person", "verified")
education, err := v.GetObject("person", "education")
friends, err := v.GetObjectArray("person", "friends")

Loop through array

Looping through an array is done with GetValueArray() or GetObjectArray(). It returns an error if the value at that keypath is null (or something else than an array).

friends, err := person.GetObjectArray("friends")
for _, friend := range friends {
  name, err := friend.GetString("name")
  age, err := friend.GetNumber("age")
}

Loop through object

Looping through an object is easy. GetObject() returns an error if the value at that keypath is null (or something else than an object).

person, err := person.GetObject("person")
for key, value := range person.Map() {
  ...
}

Sample App

Example project:

package main

import (
  "github.com/aimof/jason"
  "log"
)

func main() {

  exampleJSON := `{
    "name": "Walter White",
    "age": 51,
    "children": [
      "junior",
      "holly"
    ],
    "other": {
      "occupation": "chemist",
      "years": 23
    }
  }`

  v, _ := jason.NewObjectFromBytes([]byte(exampleJSON))

  name, _ := v.GetString("name")
  age, _ := v.GetNumber("age")
  occupation, _ := v.GetString("other", "occupation")
  years, _ := v.GetNumber("other", "years")

  log.Println("age:", age)
  log.Println("name:", name)
  log.Println("occupation:", occupation)
  log.Println("years:", years)

  children, _ := v.GetStringArray("children")
  for i, child := range children {
    log.Printf("child %d: %s", i, child)
  }

  others, _ := v.GetObject("other")

  for _, value := range others.Map() {

    s, sErr := value.String()
    n, nErr := value.Number()

    if sErr == nil {
      log.Println("string value: ", s)
    } else if nErr == nil {
      log.Println("number value: ", n)
    }
  }
}

Documentation

Documentation can be found on godoc:

https://godoc.org/github.com/antonholmquist/jason

Test

To run the project tests:

go test

Compatibility

Go 1.1 and up.

Where does the name come from?

I remembered it from an email one of our projects managers sent a couple of years ago.

"Don't worry. We can handle both XML and Jason"

Author

Anton Holmquist, http://twitter.com/antonholmquist