0.1.0 • Published 5 months ago

@woifes/gjson v0.1.0

Weekly downloads
-
License
MIT
Repository
github
Last release
5 months ago

@woifes/gjson

Why?

This package implements the GSJON json document search. The focus lies on the search aspect of GJSON because even though NodeJS comes with a good build-in JSON support. It misses a commong searching syntax.

Please check the source code before using this package

Installation

npm install @woifes/gjson

Quick start

import { get } from "@woifes/gjson";

const exampleJson = {
    name: { first: "Tom", last: "Anderson" },
    age: 37,
    children: ["Sara", "Alex", "Jack"],
    "fav.movie": "Deer Hunter",
    friends: [
        { first: "Dale", last: "Murphy", age: 44, nets: ["ig", "fb", "tw"] },
        { first: "Roger", last: "Craig", age: 68, nets: ["fb", "tw"] },
        { first: "Jane", last: "Murphy", age: 47, nets: ["ig", "tw"] },
    ],
};

console.log( get(exampleJson, "name.first") ); //"Tom"

Supported GJSON features

GSJON featureSupported?Notes
Path StructureYES
BasicYES
WildcardsYES
Escape CharacterYES
ArraysYES
QueriesYES
Dot vs PipeYES
ModifiersNO
Modifier argumentsNO
Custom modifiersNO
MultipathsNO
LiteralsNO
JSON LinesNO

This table is taken from the docs of gjson-py

Running the build

The project is part of a monorepo. If the project is checked out in this environment use the following scripts:

TypeScript build:

pnpm run compile

Run tests:

pnpm test
0.1.0

5 months ago