ptrace

easily trace execution order of your promise-based program

example

function getUser(userId) {
  return minq.from('users').byId(userId).expect().one()
}

var ptrace = require('ptrace')

// pass a label, a promise-returning function, and arguments:
getUser = ptrace('getUser', getUser)

[12,23,25].map(getUser)

Console output:

1 invoking getUser ( 12 )
2 invoking getUser ( 23 )
3 invoking getUser ( 25 )
1 resolved {_id: 12, name: 'ben'}
2 resolved {_id: 23, name: 'jden' }
3 resolved {_id: 25, name: 'turing' }

api

using jsig notation

ptrace(stepName: String, fn: () => Promise, ...args: Value) => () => Promise

trace invocations of a promise-returning function, logging messages on invocation and resolution/rejection. Decorates the Promise-returning function and adds tracing to each invocation. Use this new function like you would have before.

ptrace.log

Logging function to use. Defaults to console.log. If you'd like, override with your own logging function of signature (str: String) => void

ptrace.debug

Boolean, defaults to false. If false, logging will only occur if process.env.DEBUG is truthy. Override this flag to a truthy value to force logging.

installation

$ npm install ptrace

running the tests

From package root:

$ npm install
$ npm test

contributors

jden jason@denizac.org

license

MIT. (c) 2013 jden jason@denizac.org. See LICENSE.md