Awesome

JSONSelect

CSS-like selectors for JSON.

Installation

From your terminal:

gem install json_select

In your Gemfile:

gem 'json_select'

Usage

require 'json_select'

json = { # This would normally be loaded with something like yajl-ruby
  "name" => {
    "first" => "Lloyd",
    "last" => "Hilaiel"
  },
  "favoriteColor" => "yellow",
  "languagesSpoken" => [
    {
      "language" => "Bulgarian",
      "level" => "advanced"
    },
    {
      "language" => "English",
      "level" => "native"
    },
    {
      "language" => "Spanish",
      "level" => "beginner"
    }
  ],
  "seatingPreference" => [ "window", "aisle" ],
  "drinkPreference" => [ "beer", "whiskey", "wine" ],
  "weight" => 172
}

JSONSelect('string:first-child').test(json)    # => true
JSONSelect('string:first-child').match(json)   # => "window"
JSONSelect('string:first-child').matches(json) # => ["window", "beer"]

Language support

✓ — Level 1 — * Any node

✓ — Level 1 — T A node of type T, where T is one string, number, object, array, boolean, or null

✓ — Level 1 — T.key A node of type T which is the child of an object and is the value its parents key property

✓ — Level 1 — T."complex key" Same as previous, but with property name specified as a JSON string

✓ — Level 1 — T:root A node of type T which is the root of the JSON document

✓ — Level 1 — T:nth-child(n) A node of type T which is the nth child of an array parent

✓ — Level 2 — T:nth-last-child(n) A node of type T which is the nth child of an array parent counting from the end

✓ — Level 1 — T:first-child A node of type T which is the first child of an array parent (equivalent to T:nth-child(1))

✓ — Level 2 — T:last-child A node of type T which is the last child of an array parent (equivalent to T:nth-last-child(1))

✓ — Level 2 — T:only-child A node of type T which is the only child of an array parent

✓ — Level 2 — T:empty A node of type T which is an array or object with no child

✓ — Level 1 — T U A node of type U with an ancestor of type T

✓ — Level 1 — T > U A node of type U with a parent of type T

✗ — Level 2 — T ~ U A node of type U with a sibling of type T

✓ — Level 1 — S1, S2 Any node which matches either selector S1 or S2

✗ — Level 3 — T:has(S) A node of type T which has a child node satisfying the selector S

Note on Patches/Pull Requests