Skip to content

A minimalistic evaluator of a custom JSON language.

Notifications You must be signed in to change notification settings

techconative/j-gen

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

j-gen

A minimalistic evaluator of a custom JSON language.

Motivation:

While working with LLMs in order to achieve a specific task when need to have a consistent way of expressing what need to be achieved as a result of a given prompt.

The language has to be of below nature,

  • Simple(not just Easy).
  • Consistent.
  • Infinitely recursive.

Grammar:

  • Each JSON will either be an operator or a data.
  • The JSON is an operator, if the first key is one of the configured strings.
  • Each operator will have to be resolved to a function with the value of it will be passed as a parameter for the function.
  • When a JSON is not an operator, it represents a normal JSON.
  • The execution has to happen in a nested manner. For example, if an operator has another operator as a parameter, the inner one needs to be executed first.
  • The DSL has to be converted to the code first and then the execution has to happen on an explicit call.
  • The response of the DSL will be the execution result of the JSON.
  • When the DSL is a list and if JSON is an operator, the result will be a list with the evaluated results.
  • When the JSON is not an operator, it will be returned as is.

Usage:

  • Define the operators.

Ex,

let interpreter = new DSLInterpreter({
    'add': (ctx, params) => {
        return params.reduce((accumulator, current) => accumulator + current, 0);
    }});
  • Compile the expressions,
let dslJson = {
    'add': [
        1,
        2,
        3
    ]
};

let compiled = interpreter.compile(dslJson);
  • Execute it with optional context,
interpreter.run(compiled, null);
// This should return 6

For more details refer to the test file.

Running tests:

 node jgentest.js

About

A minimalistic evaluator of a custom JSON language.

Resources

Stars

Watchers

Forks

Packages

No packages published