ahungry-around v1.1.4

Ahungry Around

Project page:

https://github.com/ahungry/ahungry-around

A nodejs library for easily and recursively wrapping an entire codebase in a custom Proxy handler (https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Proxy)

Goal

To help allow global invocations of Aspect Oriented Programming (AOP), such as profiling or logging etc.

Usage

See a sample in tests/test.js:

const { AhungryAround } = require('../index')
const { HelloWorld } = require('./HelloWorld')
const { Printer } = require('./HWPrinter')

let iter = 0
let uiter = 0

const handler = {
  apply: (target, thisArg, argumentsList) => {
    // A sample useful key value.
    const key = `${target.name} ${JSON.stringify(argumentsList)}`
    console.log(`This is the nth time (${++iter}) calling handler, from ${key}`)
    const result = target.apply(thisArg, argumentsList)

    return result
  }
}

// Maybe you want a handler to just work on one class?
const handler2 = {
  apply: (target, thisArg, argumentsList) => {
    const key = `${target.name} ${JSON.stringify(argumentsList)}`
    console.log(`This is the nth time (${++uiter}) calling upcase handler, from ${key}`)

    argumentsList = argumentsList.map(arg => arg.toUpperCase())
    let result = target.apply(thisArg, argumentsList)

    return result
  }
}

const a2 = new AhungryAround(handler2, 'Uppercase')
a2.handleObjectOrFn(Printer)

const aa = new AhungryAround(handler, 'Iterator')
aa.handleModule(module)

const hw = new HelloWorld()
hw.flub('Greetings')
HelloWorld.blub()

if (iter !== 4) throw new Error('Test failure!' + iter)

Which will produce output as such:

$ node ./tests/test.js
This is the nth time (1) calling handler, from flub ["Greetings"]
Greetings
This is the nth time (2) calling handler, from log ["Greetings"]
This is the nth time (1) calling upcase handler, from log
["Greetings"]
GREETINGS
This is the nth time (3) calling handler, from blub []
blub
This is the nth time (4) calling handler, from log ["blub"]
This is the nth time (2) calling upcase handler, from log ["blub"]
BLUB

License

GPLv3