Skip to content
A high performance Golang implementation of the incredibly useful jq command line tool.
Go
Branch: master
Clone or download
Latest commit 0e6baec Dec 8, 2016
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
scanner - handles empty arrays and empty objects Dec 5, 2016
.gitignore - removed all external dependencies Dec 4, 2016
LICENSE Initial commit Dec 3, 2016
README.md - updated README Dec 5, 2016
doc.go - improving package docs Dec 5, 2016
op.go - updated oss license header Dec 5, 2016
op_chain_test.go - updated oss license header Dec 5, 2016
op_dot_test.go - updated oss license header Dec 5, 2016
parse.go - added support for Must Dec 9, 2016
parse_regexp_test.go - updated oss license header Dec 5, 2016
parse_test.go

README.md

jq

GoDoc Build Status

A high performance Golang implementation of the incredibly useful jq command line tool.

Rather than marshalling json elements into go instances, jq opts to manipulate the json elements as raw []byte. This is especially useful for apps that need to handle dynamic json data.

Using jq consists of creation an Op and then calling Apply on the Op to transform one []byte into the desired []byte. Ops may be chained together to form a transformation chain similar to how the command line jq works.

Installation

go get github.com/savaki/jq

Example

package main

import (
	"fmt"

	"github.com/savaki/jq"
)

func main() {
	op, _ := jq.Parse(".hello")           // create an Op
	data := []byte(`{"hello":"world"}`)   // sample input
	value, _ := op.Apply(data)            // value == '"world"'
	fmt.Println(string(value))
}

Syntax

The initial goal is to support all the selectors the original jq command line supports.

syntax meaning
. unchanged input
.foo value at key
.foo.bar value at nested key
.[0] value at specified element of array
.[0:1] array of specified elements of array, inclusive
.foo.[0] nested value

Examples

Data

{
  "string": "a",
  "number": 1.23,
  "simple": ["a", "b", "c"],
  "mixed": [
    "a",
    1,
    {"hello":"world"}
  ],
  "object": {
    "first": "joe",
    "array": [1,2,3]
  }
}
syntax value
.string "a"
.number 1.23
.simple ["a", "b", "c"]
.simple.[0] "a"
.simple.[0:1] ["a","b"]
.mixed.[1] 1
.object.first "joe"
.object.array.[2] 3

Performance

BenchmarkAny-8         	20000000	        80.8 ns/op	       0 B/op	       0 allocs/op
BenchmarkArray-8       	20000000	       108 ns/op	       0 B/op	       0 allocs/op
BenchmarkFindIndex-8   	10000000	       125 ns/op	       0 B/op	       0 allocs/op
BenchmarkFindKey-8     	10000000	       125 ns/op	       0 B/op	       0 allocs/op
BenchmarkFindRange-8   	10000000	       186 ns/op	      16 B/op	       1 allocs/op
BenchmarkNumber-8      	50000000	        28.9 ns/op	       0 B/op	       0 allocs/op
BenchmarkObject-8      	20000000	        98.5 ns/op	       0 B/op	       0 allocs/op
BenchmarkString-8      	30000000	        40.4 ns/op	       0 B/op	       0 allocs/op
You can’t perform that action at this time.