selecthor

SelecTHOR ⚡⚒️

Choose your data the way Thor's hammer chose Thor.

Select JSON data with a query language inspired by SQL.

❯ Features

• Easy-to-use. Selecthor's API is dead simple, easy to use and easy to replace (if you ever want to).
• Typed. Selecthor is written 100% in TypeScript, so there is no need to install typings from an external source.
• Tested. Don't be surprised when using Selecthor, it ships with 100% code coverage.
• Documented. Modern documentation lives in code. That's why Selecthor contains TSDoc comments where needed.
• Compatible. Node.js, Browsers? Run Selecthor on the platform of your choice!
• Independent. Don't be afraid of big lock files. Selecthor uses zero dependencies.

❯ Installation

npm install selecthor

yarn add selecthor

❯ Usage

const { selecthor } = require("selecthor");

const data = {
  animals: [
    {
      legs: 2,
      name: "Chimp",
      speed: {
        kph: 45,
        mph: 27.96
      }
    },
    {
      legs: 4,
      name: "Greyhound",
      speed: {
        kph: 72.42,
        mph: 45
      }
    },
    {
      legs: 4,
      name: "Polar Bear",
      speed: {
        kph: 40,
        mph: 24.85
      }
    }
  ]
};

const query = "SELECT name FROM animals WHERE speed.kph < 70";
const selection = selecthor(data, query);

console.log(JSON.stringify(selection)); // [{"name":"Chimp"},{"name":"Polar Bear"}]

Changelog

1.0.0 (2019-09-03)

New Features

• Support uppercased keywords (#7) (35268097)
• Add nested property selection (#5) (62bc6c8f)
• Add partial property selection (#4) (5ef51a31)
• Add filter for literal keys (#3) (155a9bec)
• Add filter for numeric keys (#2) (4b6d890c)
• Add select statement (#1) (b355b0cb)