var vows = require('vows'), assert = require('assert'); vows.describe('log4js').addBatch({ 'getLogger': { topic: function() { var log4js = require('../lib/log4js')(); log4js.clearAppenders(); var logger = log4js.getLogger('tests'); logger.setLevel("DEBUG"); return logger; }, 'should take a category and return a logger': function(logger) { assert.equal(logger.category, 'tests'); assert.equal(logger.level.toString(), "DEBUG"); assert.isFunction(logger.debug); assert.isFunction(logger.info); assert.isFunction(logger.warn); assert.isFunction(logger.error); assert.isFunction(logger.fatal); }, 'log events' : { topic: function(logger) { var events = []; logger.addListener("log", function (logEvent) { events.push(logEvent); }); logger.debug("Debug event"); logger.trace("Trace event 1"); logger.trace("Trace event 2"); logger.warn("Warning event"); logger.error("Aargh!", new Error("Pants are on fire!")); logger.error("Simulated CouchDB problem", { err: 127, cause: "incendiary underwear" }); return events; }, 'should emit log events': function(events) { assert.equal(events[0].level.toString(), 'DEBUG'); assert.equal(events[0].message, 'Debug event'); assert.instanceOf(events[0].startTime, Date); }, 'should not emit events of a lower level': function(events) { assert.length(events, 4); assert.equal(events[1].level.toString(), 'WARN'); }, 'should include the error if passed in': function (events) { assert.instanceOf(events[2].exception, Error); assert.equal(events[2].exception.message, 'Pants are on fire!'); }, 'should convert things that claim to be errors into Error objects': function (events) { assert.instanceOf(events[3].exception, Error); assert.equal(events[3].exception.message, "{ err: 127, cause: 'incendiary underwear' }"); }, }, }, 'fileAppender': { topic: function() { var appender, logmessages = [], thing = "thing", fakeFS = { openSync: function() { assert.equal(arguments[0], './tmp-tests.log'); assert.equal(arguments[1], 'a'); assert.equal(arguments[2], 0644); return thing; }, write: function() { assert.equal(arguments[0], thing); assert.isString(arguments[1]); assert.isNull(arguments[2]); assert.equal(arguments[3], "utf8"); logmessages.push(arguments[1]); }, watchFile: function() { throw new Error("watchFile should not be called if logSize is not defined"); } }, log4js = require('../lib/log4js')(fakeFS); log4js.clearAppenders(); appender = log4js.fileAppender('./tmp-tests.log', log4js.messagePassThroughLayout); log4js.addAppender(appender, 'file-test'); var logger = log4js.getLogger('file-test'); logger.debug("this is a test"); return logmessages; }, 'should write log messages to file': function(logmessages) { assert.length(logmessages, 1); assert.equal(logmessages, "this is a test\n"); } }, 'fileAppender - with rolling based on size and number of files to keep': { topic: function() { var watchCb, filesOpened = [], filesClosed = [], filesRenamed = [], newFilenames = [], existingFiles = ['tests.log'], log4js = require('../lib/log4js')({ watchFile: function(file, options, callback) { assert.equal(file, 'tests.log'); assert.equal(options.persistent, false); assert.equal(options.interval, 30000); assert.isFunction(callback); watchCb = callback; }, openSync: function(file) { assert.equal(file, 'tests.log'); filesOpened.push(file); return file; }, statSync: function(file) { if (existingFiles.indexOf(file) < 0) { throw new Error("this file doesn't exist"); } else { return true; } }, renameSync: function(oldFile, newFile) { filesRenamed.push(oldFile); existingFiles.push(newFile); }, closeSync: function(file) { //it should always be closing tests.log assert.equal(file, 'tests.log'); filesClosed.push(file); } }); var appender = log4js.fileAppender('tests.log', log4js.messagePassThroughLayout, 1024, 2, 30); return [watchCb, filesOpened, filesClosed, filesRenamed, existingFiles]; }, 'should close current log file, rename all old ones, open new one on rollover': function(args) { var watchCb = args[0], filesOpened = args[1], filesClosed = args[2], filesRenamed = args[3], existingFiles = args[4]; assert.isFunction(watchCb); //tell the watchCb that the file is below the threshold watchCb({ size: 891 }, { size: 0 }); //filesOpened should still be the first one. assert.length(filesOpened, 1); //tell the watchCb that the file is now over the threshold watchCb({ size: 1053 }, { size: 891 }); //it should have closed the first log file. assert.length(filesClosed, 1); //it should have renamed the previous log file assert.length(filesRenamed, 1); //and we should have two files now assert.length(existingFiles, 2); assert.deepEqual(existingFiles, ['tests.log', 'tests.log.1']); //and opened a new log file. assert.length(filesOpened, 2); //now tell the watchCb that we've flipped over the threshold again watchCb({ size: 1025 }, { size: 123 }); //it should have closed the old file assert.length(filesClosed, 2); //it should have renamed both the old log file, and the previous '.1' file assert.length(filesRenamed, 3); assert.deepEqual(filesRenamed, ['tests.log', 'tests.log.1', 'tests.log' ]); //it should have renamed 2 more file assert.length(existingFiles, 4); assert.deepEqual(existingFiles, ['tests.log', 'tests.log.1', 'tests.log.2', 'tests.log.1']); //and opened a new log file assert.length(filesOpened, 3); //tell the watchCb we've flipped again. watchCb({ size: 1024 }, { size: 234 }); //close the old one again. assert.length(filesClosed, 3); //it should have renamed the old log file and the 2 backups, with the last one being overwritten. assert.length(filesRenamed, 5); assert.deepEqual(filesRenamed, ['tests.log', 'tests.log.1', 'tests.log', 'tests.log.1', 'tests.log' ]); //it should have renamed 2 more files assert.length(existingFiles, 6); assert.deepEqual(existingFiles, ['tests.log', 'tests.log.1', 'tests.log.2', 'tests.log.1', 'tests.log.2', 'tests.log.1']); //and opened a new log file assert.length(filesOpened, 4); } }, 'configure' : { topic: function() { var messages = {}, fakeFS = { openSync: function(file) { return file; }, write: function(file, message) { if (!messages.hasOwnProperty(file)) { messages[file] = []; } messages[file].push(message); }, readFileSync: function(file, encoding) { return require('fs').readFileSync(file, encoding); }, watchFile: function(file) { messages.watchedFile = file; } }, log4js = require('../lib/log4js')(fakeFS); return [ log4js, messages ]; }, 'should load appender configuration from a json file': function(args) { var log4js = args[0], messages = args[1]; delete messages['tmp-tests.log']; log4js.clearAppenders(); //this config file defines one file appender (to ./tmp-tests.log) //and sets the log level for "tests" to WARN log4js.configure('test/log4js.json'); var logger = log4js.getLogger("tests"); logger.info('this should not be written to the file'); logger.warn('this should be written to the file'); assert.length(messages['tmp-tests.log'], 1); assert.equal(messages['tmp-tests.log'][0], 'this should be written to the file\n'); }, 'should handle logLevelFilter configuration': function(args) { var log4js = args[0], messages = args[1]; delete messages['tmp-tests.log']; delete messages['tmp-tests-warnings.log']; log4js.clearAppenders(); log4js.configure('test/with-logLevelFilter.json'); var logger = log4js.getLogger("tests"); logger.info('main'); logger.error('both'); logger.warn('both'); logger.debug('main'); assert.length(messages['tmp-tests.log'], 4); assert.length(messages['tmp-tests-warnings.log'], 2); assert.deepEqual(messages['tmp-tests.log'], ['main\n','both\n','both\n','main\n']); assert.deepEqual(messages['tmp-tests-warnings.log'], ['both\n','both\n']); }, 'should handle fileAppender with log rolling' : function(args) { var log4js = args[0], messages = args[1]; delete messages['tmp-test.log']; log4js.configure('test/with-log-rolling.json'); assert.equal(messages.watchedFile, 'tmp-test.log'); }, 'should handle an object or a file name': function(args) { var log4js = args[0], messages = args[1], config = { "appenders": [ { "type" : "file", "filename" : "cheesy-wotsits.log", "maxLogSize" : 1024, "backups" : 3, "pollInterval" : 15 } ] }; delete messages['cheesy-wotsits.log']; log4js.configure(config); assert.equal(messages.watchedFile, 'cheesy-wotsits.log'); } }, 'with no appenders defined' : { topic: function() { var logger, message, log4jsFn = require('../lib/log4js'), log4js; log4jsFn().clearAppenders(); log4js = log4jsFn(null, function (msg) { message = msg; } ); logger = log4js.getLogger("some-logger"); logger.debug("This is a test"); return message; }, 'should default to the console appender': function(message) { assert.isTrue(/This is a test$/.test(message)); } }, 'addAppender' : { topic: function() { var log4js = require('../lib/log4js')(); log4js.clearAppenders(); return log4js; }, 'without a category': { 'should register the function as a listener for all loggers': function (log4js) { var appenderEvent, appender = function(evt) { appenderEvent = evt; }, logger = log4js.getLogger("tests"); log4js.addAppender(appender); logger.debug("This is a test"); assert.equal(appenderEvent.message, "This is a test"); assert.equal(appenderEvent.categoryName, "tests"); assert.equal(appenderEvent.level.toString(), "DEBUG"); }, 'should also register as an appender for loggers if an appender for that category is defined': function (log4js) { var otherEvent, appenderEvent, cheeseLogger; log4js.addAppender(function (evt) { appenderEvent = evt; }); log4js.addAppender(function (evt) { otherEvent = evt; }, 'cheese'); cheeseLogger = log4js.getLogger('cheese'); cheeseLogger.debug('This is a test'); assert.deepEqual(appenderEvent, otherEvent); assert.equal(otherEvent.message, 'This is a test'); assert.equal(otherEvent.categoryName, 'cheese'); otherEvent = undefined; appenderEvent = undefined; log4js.getLogger('pants').debug("this should not be propagated to otherEvent"); assert.isUndefined(otherEvent); assert.equal(appenderEvent.message, "this should not be propagated to otherEvent"); } }, 'with a category': { 'should only register the function as a listener for that category': function(log4js) { var appenderEvent, appender = function(evt) { appenderEvent = evt; }, logger = log4js.getLogger("tests"); log4js.addAppender(appender, 'tests'); logger.debug('this is a category test'); assert.equal(appenderEvent.message, 'this is a category test'); appenderEvent = undefined; log4js.getLogger('some other category').debug('Cheese'); assert.isUndefined(appenderEvent); } }, 'with multiple categories': { 'should register the function as a listener for all the categories': function(log4js) { var appenderEvent, appender = function(evt) { appenderEvent = evt; }, logger = log4js.getLogger('tests'); log4js.addAppender(appender, 'tests', 'biscuits'); logger.debug('this is a test'); assert.equal(appenderEvent.message, 'this is a test'); appenderEvent = undefined; var otherLogger = log4js.getLogger('biscuits'); otherLogger.debug("mmm... garibaldis"); assert.equal(appenderEvent.message, "mmm... garibaldis"); appenderEvent = undefined; log4js.getLogger("something else").debug("pants"); assert.isUndefined(appenderEvent); }, 'should register the function when the list of categories is an array': function(log4js) { var appenderEvent, appender = function(evt) { appenderEvent = evt; }; log4js.addAppender(appender, ['tests', 'pants']); log4js.getLogger('tests').debug('this is a test'); assert.equal(appenderEvent.message, 'this is a test'); appenderEvent = undefined; log4js.getLogger('pants').debug("big pants"); assert.equal(appenderEvent.message, "big pants"); appenderEvent = undefined; log4js.getLogger("something else").debug("pants"); assert.isUndefined(appenderEvent); } } }, 'default setup': { topic: function() { var pathsChecked = [], message, logger, fakeFS = { readFileSync: function (file, encoding) { assert.equal(file, '/path/to/config/log4js.json'); assert.equal(encoding, 'utf8'); return '{ "appenders" : [ { "type": "console", "layout": { "type": "messagePassThrough" }} ] }'; }, statSync: function (path) { pathsChecked.push(path); if (path === '/path/to/config/log4js.json') { return true; } else { throw new Error("no such file"); } } }, fakeConsoleLog = function (msg) { message = msg; }, fakeRequirePath = [ '/a/b/c', '/some/other/path', '/path/to/config', '/some/later/directory' ], log4jsFn = require('../lib/log4js'), log4js, logger; log4jsFn().clearAppenders(); log4js = log4jsFn(fakeFS, fakeConsoleLog, fakeRequirePath); logger = log4js.getLogger('a-test'); logger.debug("this is a test"); return [ pathsChecked, message ]; }, 'should check current directory, require paths, and finally the module dir for log4js.json': function(args) { var pathsChecked = args[0]; assert.deepEqual(pathsChecked, [ 'log4js.json', '/a/b/c/log4js.json', '/some/other/path/log4js.json', '/path/to/config/log4js.json', '/some/later/directory/log4js.json', require('path').normalize(__dirname + '/../lib/log4js.json') ]); }, 'should configure log4js from first log4js.json found': function(args) { var message = args[1]; assert.equal(message, 'this is a test'); } }, 'colouredLayout': { topic: function() { return require('../lib/log4js')().colouredLayout; }, 'should apply level colour codes to output': function(layout) { var output = layout({ message: "nonsense", startTime: new Date(2010, 11, 5, 14, 18, 30, 45), categoryName: "cheese", level: { colour: "green", toString: function() { return "ERROR"; } } }); assert.equal(output, '\033[90m[2010-12-05 14:18:30.045] \033[39m\033[32m[ERROR] \033[39m\033[90mcheese - \033[39mnonsense'); } }, 'messagePassThroughLayout': { topic: function() { return require('../lib/log4js')().messagePassThroughLayout; }, 'should take a logevent and output only the message' : function(layout) { assert.equal(layout({ message: "nonsense", startTime: new Date(2010, 11, 5, 14, 18, 30, 45), categoryName: "cheese", level: { colour: "green", toString: function() { return "ERROR"; } } }), "nonsense"); } }, 'basicLayout': { topic: function() { var layout = require('../lib/log4js')().basicLayout, event = { message: 'this is a test', startTime: new Date(2010, 11, 5, 14, 18, 30, 45), categoryName: "tests", level: { colour: "green", toString: function() { return "DEBUG"; } } }; return [layout, event]; }, 'should take a logevent and output a formatted string': function(args) { var layout = args[0], event = args[1]; assert.equal(layout(event), "[2010-12-05 14:18:30.045] [DEBUG] tests - this is a test"); }, 'should output a stacktrace, message if the event has an error attached': function(args) { var layout = args[0], event = args[1], output, lines, error = new Error("Some made-up error"), stack = error.stack.split(/\n/); event.exception = error; output = layout(event); lines = output.split(/\n/); assert.length(lines, stack.length+1); assert.equal(lines[0], "[2010-12-05 14:18:30.045] [DEBUG] tests - this is a test"); assert.equal(lines[1], "[2010-12-05 14:18:30.045] [DEBUG] tests - Error: Some made-up error"); for (var i = 1; i < stack.length; i++) { assert.equal(lines[i+1], stack[i]); } }, 'should output a name and message if the event has something that pretends to be an error': function(args) { var layout = args[0], event = args[1], output, lines; event.exception = { name: 'Cheese', message: 'Gorgonzola smells.' }; output = layout(event); lines = output.split(/\n/); assert.length(lines, 2); assert.equal(lines[0], "[2010-12-05 14:18:30.045] [DEBUG] tests - this is a test"); assert.equal(lines[1], "[2010-12-05 14:18:30.045] [DEBUG] tests - Cheese: Gorgonzola smells."); } }, 'logLevelFilter': { topic: function() { var log4js = require('../lib/log4js')(), logEvents = [], logger; log4js.clearAppenders(); log4js.addAppender(log4js.logLevelFilter('ERROR', function(evt) { logEvents.push(evt); }), "logLevelTest"); logger = log4js.getLogger("logLevelTest"); logger.debug('this should not trigger an event'); logger.warn('neither should this'); logger.error('this should, though'); logger.fatal('so should this'); return logEvents; }, 'should only pass log events greater than or equal to its own level' : function(logEvents) { assert.length(logEvents, 2); assert.equal(logEvents[0].message, 'this should, though'); assert.equal(logEvents[1].message, 'so should this'); } }, 'Date extensions': { topic: function() { require('../lib/log4js')(); return new Date(2010, 0, 11, 14, 31, 30, 5); }, 'should add a toFormattedString method to Date': function(date) { assert.isFunction(date.toFormattedString); }, 'should default to a format': function(date) { assert.equal(date.toFormattedString(), '2010-01-11 14:31:30.005'); } }, /** Disabling the console.log replacement **** 'console' : { topic: function() { return require('../lib/log4js')(); }, 'should replace console.log methods with log4js ones': function(log4js) { var logEvent; log4js.clearAppenders(); log4js.addAppender(function(evt) { logEvent = evt; }); console.log("Some debug message someone put in a module"); assert.equal(logEvent.message, "Some debug message someone put in a module"); assert.equal(logEvent.level.toString(), "INFO"); logEvent = undefined; console.debug("Some debug"); assert.equal(logEvent.message, "Some debug"); assert.equal(logEvent.level.toString(), "DEBUG"); logEvent = undefined; console.error("An error"); assert.equal(logEvent.message, "An error"); assert.equal(logEvent.level.toString(), "ERROR"); logEvent = undefined; console.info("some info"); assert.equal(logEvent.message, "some info"); assert.equal(logEvent.level.toString(), "INFO"); logEvent = undefined; console.trace("tracing"); assert.equal(logEvent.message, "tracing"); assert.equal(logEvent.level.toString(), "TRACE"); } }, */ 'configuration persistence' : { 'should maintain appenders between requires': function () { var logEvent, firstLog4js = require('../lib/log4js')(), secondLog4js; firstLog4js.clearAppenders(); firstLog4js.addAppender(function(evt) { logEvent = evt; }); secondLog4js = require('../lib/log4js')(); secondLog4js.getLogger().info("This should go to the appender defined in firstLog4js"); assert.equal(logEvent.message, "This should go to the appender defined in firstLog4js"); } } }).export(module);