@emartech/data-aggregator-language

    2.6.0 • Public • Published

    Data Aggregator Language

    Execute aggregation expressions on a given data set.

    What it Does

    Given the following input data structure,

    const input = [{
      date: '2017-09-16',
      reservations: {
        silver: 12,
        gold: 5
      },
      customers: ['brad']
    }, {
      date: '2017-09-17',
      reservations: {
        silver: 3,
        gold: 2
      },
      customers: ['angelina']
    }]

    the parser allows mixing aggregation expressions over the input with common arithmetic operators.

    For example,

    • an aggregation expression: SUM reservations.silver would yield 12 + 3 = 15.
    • an aggregation expression mixed with arithmetic: SUM reservations.silver + 3 would yield (12 + 3) + 3 = 18

    Usage

    const aggregator = require('@emartech/data-aggregator-language')(input);
    const result = aggregator('SUM reservations.silver')

    Supported Syntax in Aggregation Expressions

    Examples below are for the input defined above.

    Number Results

    Constants

    • LENGTH
      • LENGTH (yields 2)
      • LENGTH + 3 (yields 5)
    • Any number literal
      • 5 (yields 5)

    Unary Operators

    • SUM
      • SUM reservations.silver (yields 15)
    • LAST
      • LAST reservations.silver (yields 3)
    • AVERAGE
      • AVERAGE reservations.silver (yields 7.5)

    Binary Operators

    +, -, *, / For example, (LAST reservations.silver + 3) * 2 / 2 (yields 6)

    Array Results

    • UNION
      • UNION customers (yields ['brad', 'angelina'])

    Boolean Results

    • EMPTY
      • EMPTY UNION customers (yields false)
    • NOT
      • NOT EMPTY UNION customers (yields true)

    Using with Webpack

    Because of the way the underlying Chevrotain library is implemented, name mangling interferes with the parser's operation. To resolve this issue, webpacked host projects need to disable name mangling for the token names used in this grammar.

    To help with this, the module exports these names in a tokens array.

    To configure webpack, include the following in your webpack.config.js:

    const { tokens } = require('@emartech/data-aggregator-language');
    
    
    module.exports.optimization = {
        minimizer: [
          new UglifyJsPlugin({
            uglifyOptions: {
              mangle: {
                reserved: tokens
              }
            }
          })
        ]
      };

    Commit Convention

    Semantic release depends on the Angular commit message conventions. Please follow these.

    Credit

    Uses SAP/chevrotain for parsing.

    Keywords

    none

    Install

    npm i @emartech/data-aggregator-language

    DownloadsWeekly Downloads

    4

    Version

    2.6.0

    License

    MIT

    Unpacked Size

    27.9 kB

    Total Files

    21

    Last publish

    Collaborators

    • nvkaur2
    • xueboliang
    • jbleclerc
    • roxanams
    • b-laczko
    • jahwjgxvfuxdesha
    • apoon
    • mhermann36
    • sevket-ataseven
    • jamescocker
    • arnaud.buchholz
    • jerryrichardson
    • davidpal
    • retfalvibence
    • varszegik
    • burci
    • cztamas
    • akapa
    • mkls
    • probalazs
    • kaaj
    • knagy
    • pecc
    • kszalontai
    • rehreth
    • mhegedus
    • tszabo-e
    • mmartin
    • nikolett.tar
    • bsoos
    • emarsys-deployer
    • draven
    • npospischek-emartech
    • judge
    • daniel.banky
    • szeist
    • rgargya
    • lillavirag
    • marton.papp.emarsys
    • dgyenes
    • s.viktor
    • m4w4q7
    • david.barkoczi
    • dkocsis-emarsys
    • blacksonic
    • qw3r
    • tamas.toth
    • gergaczd
    • csimon
    • pintera
    • adambrunner
    • dmorvai
    • gerike
    • ins
    • alkra
    • epgrubmair
    • suliatis
    • morban
    • ettancos
    • epmartini
    • ejgyurisan
    • gabor.balla.emarsys
    • hozeee
    • mzsombor
    • ejpersson
    • ejwalker
    • czeildi
    • llosonczy
    • iben12
    • kartonfarkas
    • adamoa
    • mbarna
    • kpatrik
    • peva
    • bforgacs
    • kozma
    • serdelyi
    • ngabor84
    • zerosuxx
    • madorjan
    • edosrecki
    • eadaniel
    • selator
    • kkimak
    • daniel.balazs
    • szb
    • gaborb
    • bencso
    • glendvai
    • lveraszto
    • stoto
    • xipascu
    • rimo86
    • atittel
    • sfariel
    • rdoczi
    • mfawal
    • fentosi
    • boristomic
    • mbazso
    • dmihalek
    • lhammerl
    • sigee
    • lhalasz
    • evspasevski
    • eslesnjakovic
    • dsztanko
    • tbugar
    • dharanikesav
    • tillmannr
    • fqqdk
    • eggarcia
    • bcsizmadia
    • ems-zoltan-kohalmy
    • minktom
    • menyhertfatyol
    • bvitalyos
    • zoltanrideg-emarsys
    • sarakoll
    • mmolnar-emar
    • bozsadam
    • cseby92
    • attila.gal
    • akoshegel
    • danielbodis
    • zbalazs
    • ziyadg
    • benjamingehl
    • tdorkaa
    • lkonya
    • tcsontos
    • gpap_ema
    • vimtaai
    • ahorvath1991
    • emarsys-security
    • lloki-emarsys
    • bdorogi
    • e.david
    • borzi
    • kari0003
    • dmaraki
    • kaposioli
    • rigo_tamas_emarsys
    • aurelissima
    • barna001
    • viktor.szell
    • pmaksa_emarsys
    • znemes
    • dfarago
    • skorsik
    • esookitoth