Skip to content

arshadkazmi42/genql

Repository files navigation

genql

Build NPM Version NPM Downloads Github Repo Size LICENSE Contributors Commit

Helper for SQL query generating and formatting

Install

npm i genql

Usage

const GenQL = require('genql');
const model = require('./data/model.json');

const $ = new GenQL(model);
const fields = $._select();
const fieldPrefix = $._select('$');
console.log(fields);
console.log(fieldPrefix);

// OUTPUT -> {{fields}}
// [
//  'id',
//  'name',
//  'email',
//  'COALESCE(NULLIF(class, ''), cls)',
//  'status'
// ]

// OUTPUT -> {{fieldPrefix}}
// [
//  '$.id',
//  '$.name',
//  '$.email',
//  'COALESCE(NULLIF($.class, ''), cls)',
//  '$.status'
// ]

API

  • _default(field)

    • Returns default value for the field from model
    • Params
      • field (string)
  • _insert(prefix)

    • Returns all the fields from model, except the auto fields. Uses optional prefix and appends it to column name
    • Params
      • prefix (String) {Optional}
  • _join(prefix)

    • Returns all the fields from model, appended with join_key as prefix which is defined in model. Uses optional prefix and appends it to column name
    • Params
      • prefix (String) {Optional}
  • _findPrivate(prefix)

    • Returns all the column which have private flag defined with it in the model. Uses optinal prefix and appends it to column names
    • Params
      • prefix (String) {Optional}
  • _removePrivate(data)

    • Removes all the values from data object which are marked as private column in model
    • Params
      • data {JSON}
  • _values(data)

    • Returns list of values from data object for all the columns from model which are not marked as private
    • Params
      • data (JSON)
  • _select(prefix)

    • Returns all the fields from model and uses alternate column if defined in model. Uses optional prefix and appends it to column name
    • Params
      • prefix (String) {Optional}
  • _update(fields, data)

    • Returns list of values from data for the input fields
    • Params
      • fields (Array)
      • data (JSON)

Note: Sample model definition is available in data/model.json

Contributing

Interested in contributing to this project? You can log any issues or suggestion related to this library here

Read our contributing guide on getting started with contributing to the codebase