mongoose

<a href="http://github.com/visionmedia/expresso"><img alt="Fork me on GitHub" id="ribbon" src="http://s3.amazonaws.com/github/ribbons/forkme_right_darkblue_121621.png"></a><html> <head> <title>Expresso</title> <script src="http://ajax.googleapis.com/ajax/libs/jquery/1/jquery.min.js"></script> <style>body { margin: 0; padding: 0; font: 14px/1.5 'Palatino Linotype', 'Book Antiqua', Palatino, FreeSerif, serif; color: #252519; } a { color: #252519; } a:hover { text-decoration: underline; color: #19469D; } p { margin: 12px 0; } h1, h2, h3 { margin: 0; padding: 0; } table#source { width: 100%; border-collapse: collapse; } table#source td:first-child { padding: 30px 40px 30px 40px; vertical-align: top; } table#source td:first-child, table#source td:first-child pre { width: 450px; } table#source td:last-child { padding: 30px 0 30px 40px; border-left: 1px solid #E5E5EE; background: #F5F5FF; } table#source tr { border-bottom: 1px solid #E5E5EE; } table#source tr.filename { padding-top: 40px; border-top: 1px solid #E5E5EE; } table#source tr.filename td:first-child { text-transform: capitalize; } table#source tr.filename td:last-child { font-size: 12px; } table#source tr.filename h2 { margin: 0; padding: 0; cursor: pointer; } table#source tr.code h1, table#source tr.code h2, table#source tr.code h3 { margin-top: 30px; font-family: "Lucida Grande", "Helvetica Nueue", Arial, sans-serif; font-size: 18px; } table#source tr.code h2 { font-size: 16px; } table#source tr.code h3 { font-size: 14px; } table#source tr.code ul { margin: 15px 0 15px 35px; padding: 0; } table#source tr.code ul li { margin: 0; padding: 1px 0; } table#source tr.code ul li p { margin: 0; padding: 0; } table#source tr.code td:first-child pre { padding: 20px; } #ribbon { position: fixed; top: 0; right: 0; } code .string { color: #219161; } code .regexp { color: #219161; } code .keyword { color: #954121; } code .number { color: #19469D; } code .comment { color: #bbb; } code .this { color: #19469D; }</style> <script> $(function(){ $('tr.code').hide(); $('tr.filename').toggle(function(){ $(this).nextUntil('.filename').fadeIn(); }, function(){ $(this).nextUntil('.filename').fadeOut(); }); }); </script> </head> <body> <table id="source"><tbody><tr><td><h1>Expresso</h1>Insanely fast TDD framework for <a href="http://nodejs.org">node</a> featuring code coverage reporting.</td><td></td></tr><tr class="filename"><td><h2 id="bin/expresso"><a href="#">expresso</a></h2></td><td>bin/expresso</td></tr><tr class="code"> <td class="docs"> <h1>!/usr/bin/env node</h1> </td> <td class="code"> <pre><code> * Expresso * Copyright(c) TJ Holowaychuk &lt;tj@vision-media.ca&gt; * (MIT Licensed) </code></pre> </td> </tr> <tr class="code"> <td class="docs"> Module dependencies. </td> <td class="code"> <pre><code>var assert = require('assert'), childProcess = require('child_process'), http = require('http'), path = require('path'), sys = require('sys'), cwd = process.cwd(), fs = require('fs'), defer;</code></pre> </td> </tr> <tr class="code"> <td class="docs"> Expresso version. </td> <td class="code"> <pre><code>var version = '0.6.4';</code></pre> </td> </tr> <tr class="code"> <td class="docs"> Failure count. </td> <td class="code"> <pre><code>var failures = 0;</code></pre> </td> </tr> <tr class="code"> <td class="docs"> Number of tests executed. </td> <td class="code"> <pre><code>var testcount = 0;</code></pre> </td> </tr> <tr class="code"> <td class="docs"> Whitelist of tests to run. </td> <td class="code"> <pre><code>var only = [];</code></pre> </td> </tr> <tr class="code"> <td class="docs"> Boring output. </td> <td class="code"> <pre><code>var boring = false;</code></pre> </td> </tr> <tr class="code"> <td class="docs"> Growl notifications. </td> <td class="code"> <pre><code>var growl = false;</code></pre> </td> </tr> <tr class="code"> <td class="docs"> Server port. </td> <td class="code"> <pre><code>var port = 5555;</code></pre> </td> </tr> <tr class="code"> <td class="docs"> Watch mode. </td> <td class="code"> <pre><code>var watch = false;</code></pre> </td> </tr> <tr class="code"> <td class="docs"> Execute serially. </td> <td class="code"> <pre><code>var serial = false;</code></pre> </td> </tr> <tr class="code"> <td class="docs"> Default timeout. </td> <td class="code"> <pre><code>var timeout = 2000;</code></pre> </td> </tr> <tr class="code"> <td class="docs"> Usage documentation. </td> <td class="code"> <pre><code>var usage = '' + '[bold]{Usage}: expresso [options] <file ...>' + '\n' + '\n[bold]{Options}:' + '\n -w, --watch Watch for modifications and re-execute tests' + '\n -g, --growl Enable growl notifications' + '\n -c, --coverage Generate and report test coverage' + '\n -t, --timeout MS Timeout in milliseconds, defaults to 2000' + '\n -r, --require PATH Require the given module path' + '\n -o, --only TESTS Execute only the comma sperated TESTS (can be set several times)' + '\n -I, --include PATH Unshift the given path to require.paths' + '\n -p, --port NUM Port number for test servers, starts at 5555' + '\n -s, --serial Execute tests serially' + '\n -b, --boring Suppress ansi-escape colors' + '\n -v, --version Output version number' + '\n -h, --help Display help information' + '\n'; // Parse arguments var files = [], args = process.argv.slice(2); while (args.length) { var arg = args.shift(); switch (arg) { case '-h': case '--help': print(usage + '\n'); process.exit(1); break; case '-v': case '--version': sys.puts(version); process.exit(1); break; case '-i': case '-I': case '--include': if (arg = args.shift()) { require.paths.unshift(arg); } else { throw new Error('--include requires a path'); } break; case '-o': case '--only': if (arg = args.shift()) { only = only.concat(arg.split(/ *, */)); } else { throw new Error('--only requires comma-separated test names'); } break; case '-p': case '--port': if (arg = args.shift()) { port = parseInt(arg, 10); } else { throw new Error('--port requires a number'); } break; case '-r': case '--require': if (arg = args.shift()) { require(arg); } else { throw new Error('--require requires a path'); } break; case '-t': case '--timeout': if (arg = args.shift()) { timeout = parseInt(arg, 10); } else { throw new Error('--timeout requires an argument'); } break; case '-c': case '--cov': case '--coverage': defer = true; childProcess.exec('rm -fr lib-cov && node-jscoverage lib lib-cov', function(err){ if (err) throw err; require.paths.unshift('lib-cov'); run(files); }) break; case '-b': case '--boring': boring = true; break; case '-w': case '--watch': watch = true; break; case '-g': case '--growl': growl = true; break; case '-s': case '--serial': serial = true; break; default: if (/\.js$/.test(arg)) { files.push(arg); } break; } }</code></pre> </td> </tr> <tr class="code"> <td class="docs"> Colorized sys.error(). <h2></h2> <ul><li>param: String str</li></ul> </td> <td class="code"> <pre><code>function print(str){ sys.error(colorize(str)); }</code></pre> </td> </tr> <tr class="code"> <td class="docs"> Colorize the given string using ansi-escape sequences. Disabled when --boring is set. <h2></h2> <ul><li>param: String str</li><li>return: String </li></ul> </td> <td class="code"> <pre><code>function colorize(str){ var colors = { bold: 1, red: 31, green: 32, yellow: 33 }; return str.replace(/\[(\w+)\]\{([^]*?)\}/g, function(_, color, str){ return boring ? str : '\x1B[' + colors[color] + 'm' + str + '\x1B[0m'; }); } // Alias deepEqual as eql for complex equality assert.eql = assert.deepEqual;</code></pre> </td> </tr> <tr class="code"> <td class="docs"> Assert that <code>val</code> is null. <h2></h2> <ul><li>param: Mixed val</li><li>param: String msg</li></ul> </td> <td class="code"> <pre><code>assert.isNull = function(val, msg) { assert.strictEqual(null, val, msg); };</code></pre> </td> </tr> <tr class="code"> <td class="docs"> Assert that <code>val</code> is not null. <h2></h2> <ul><li>param: Mixed val</li><li>param: String msg</li></ul> </td> <td class="code"> <pre><code>assert.isNotNull = function(val, msg) { assert.notStrictEqual(null, val, msg); };</code></pre> </td> </tr> <tr class="code"> <td class="docs"> Assert that <code>val</code> is undefined. <h2></h2> <ul><li>param: Mixed val</li><li>param: String msg</li></ul> </td> <td class="code"> <pre><code>assert.isUndefined = function(val, msg) { assert.strictEqual(undefined, val, msg); };</code></pre> </td> </tr> <tr class="code"> <td class="docs"> Assert that <code>val</code> is not undefined. <h2></h2> <ul><li>param: Mixed val</li><li>param: String msg</li></ul> </td> <td class="code"> <pre><code>assert.isDefined = function(val, msg) { assert.notStrictEqual(undefined, val, msg); };</code></pre> </td> </tr> <tr class="code"> <td class="docs"> Assert that <code>obj</code> is <code>type</code>. <h2></h2> <ul><li>param: Mixed obj</li><li>param: String type</li><li>api: public</li></ul> </td> <td class="code"> <pre><code>assert.type = function(obj, type, msg){ var real = typeof obj; msg = msg || 'typeof ' + sys.inspect(obj) + ' is ' + real + ', expected ' + type; assert.ok(type === real, msg); };</code></pre> </td> </tr> <tr class="code"> <td class="docs"> Assert that <code>str</code> matches <code>regexp</code>. <h2></h2> <ul><li>param: String str</li><li>param: RegExp regexp</li><li>param: String msg</li></ul> </td> <td class="code"> <pre><code>assert.match = function(str, regexp, msg) { msg = msg || sys.inspect(str) + ' does not match ' + sys.inspect(regexp); assert.ok(regexp.test(str), msg); };</code></pre> </td> </tr> <tr class="code"> <td class="docs"> Assert that <code>val</code> is within <code>obj</code>. <h2>Examples</h2> assert.includes('foobar', 'bar'); assert.includes(['foo', 'bar'], 'foo'); <h2></h2> <ul><li>param: String | Array obj</li><li>param: Mixed val</li><li>param: String msg</li></ul> </td> <td class="code"> <pre><code>assert.includes = function(obj, val, msg) { msg = msg || sys.inspect(obj) + ' does not include ' + sys.inspect(val); assert.ok(obj.indexOf(val) &gt;= 0, msg); };</code></pre> </td> </tr> <tr class="code"> <td class="docs"> Assert length of <code>val</code> is <code>n</code>. <h2></h2> <ul><li>param: Mixed val</li><li>param: Number n</li><li>param: String msg</li></ul> </td> <td class="code"> <pre><code>assert.length = function(val, n, msg) { msg = msg || sys.inspect(val) + ' has length of ' + val.length + ', expected ' + n; assert.equal(n, val.length, msg); };</code></pre> </td> </tr> <tr class="code"> <td class="docs"> Assert response from <code>server</code> with the given <code>req</code> object and <code>res</code> assertions object. <h2></h2> <ul><li>param: Server server</li><li>param: Object req</li><li>param: Object | Function res</li><li>param: String msg</li></ul> </td> <td class="code"> <pre><code>assert.response = function(server, req, res, msg){ // Callback as third or fourth arg var callback = typeof res === 'function' ? res : typeof msg === 'function' ? msg : function(){}; // Default messate to test title if (typeof msg === 'function') msg = null; msg = msg || assert.testTitle; msg += '. '; // Pending responses server.__pending = server.__pending || 0; server.__pending++; // Create client if (!server.fd) { server.listen(server.__port = port++, '127.0.0.1'); server.client = http.createClient(server.__port); } // Issue request var timer, client = server.client, method = req.method || 'GET', status = res.status || res.statusCode, data = req.data || req.body, requestTimeout = req.timeout || 0; var request = client.request(method, req.url, req.headers); // Timeout if (requestTimeout) { timer = setTimeout(function(){ --server.__pending || server.close(); delete req.timeout; assert.fail(msg + 'Request timed out after ' + requestTimeout + 'ms.'); }, requestTimeout); } if (data) request.write(data); request.addListener('response', function(response){ response.body = ''; response.setEncoding('utf8'); response.addListener('data', function(chunk){ response.body += chunk; }); response.addListener('end', function(){ --server.__pending || server.close(); if (timer) clearTimeout(timer); // Assert response body if (res.body !== undefined) { var eql = res.body instanceof RegExp ? res.body.test(response.body) : res.body === response.body; assert.ok( eql, msg + 'Invalid response body.\n' + ' Expected: ' + sys.inspect(res.body) + '\n' + ' Got: ' + sys.inspect(response.body) ); } // Assert response status if (typeof status === 'number') { assert.equal( response.statusCode, status, msg + colorize('Invalid response status code.\n' + ' Expected: [green]{' + status + '}\n' + ' Got: [red]{' + response.statusCode + '}') ); } // Assert response headers if (res.headers) { var keys = Object.keys(res.headers); for (var i = 0, len = keys.length; i &lt; len; ++i) { var name = keys[i], actual = response.headers[name.toLowerCase()], expected = res.headers[name], eql = expected instanceof RegExp ? expected.test(actual) : expected == actual; assert.ok( eql, msg + colorize('Invalid response header [bold]{' + name + '}.\n' + ' Expected: [green]{' + expected + '}\n' + ' Got: [red]{' + actual + '}') ); } } // Callback callback(response); }); }); request.end(); };</code></pre> </td> </tr> <tr class="code"> <td class="docs"> Pad the given string to the maximum width provided. <h2></h2> <ul><li>param: String str</li><li>param: Number width</li><li>return: String </li></ul> </td> <td class="code"> <pre><code>function lpad(str, width) { str = String(str); var n = width - str.length; if (n &lt; 1) return str; while (n--) str = ' ' + str; return str; }</code></pre> </td> </tr> <tr class="code"> <td class="docs"> Pad the given string to the maximum width provided. <h2></h2> <ul><li>param: String str</li><li>param: Number width</li><li>return: String </li></ul> </td> <td class="code"> <pre><code>function rpad(str, width) { str = String(str); var n = width - str.length; if (n &lt; 1) return str; while (n--) str = str + ' '; return str; }</code></pre> </td> </tr> <tr class="code"> <td class="docs"> Report test coverage. <h2></h2> <ul><li>param: Object cov</li></ul> </td> <td class="code"> <pre><code>function reportCoverage(cov) { populateCoverage(cov); // Stats print('\n [bold]{Test Coverage}\n'); var sep = ' +------------------------------------------+----------+------+------+--------+', lastSep = ' +----------+------+------+--------+'; sys.puts(sep); sys.puts(' | filename | coverage | LOC | SLOC | missed |'); sys.puts(sep); for (var name in cov) { var file = cov[name]; if (Array.isArray(file)) { sys.print(' | ' + rpad(name, 40)); sys.print(' | ' + lpad(file.coverage.toFixed(2), 8)); sys.print(' | ' + lpad(file.LOC, 4)); sys.print(' | ' + lpad(file.SLOC, 4)); sys.print(' | ' + lpad(file.totalMisses, 6)); sys.print(' |\n'); } } sys.puts(sep); sys.print(' ' + rpad('', 40)); sys.print(' | ' + lpad(cov.coverage.toFixed(2), 8)); sys.print(' | ' + lpad(cov.LOC, 4)); sys.print(' | ' + lpad(cov.SLOC, 4)); sys.print(' | ' + lpad(cov.totalMisses, 6)); sys.print(' |\n'); sys.puts(lastSep); // Source for (var name in cov) { if (name.match(/\.js$/)) { var file = cov[name]; print('\n [bold]{' + name + '}:'); print(file.source); sys.print('\n'); } } }</code></pre> </td> </tr> <tr class="code"> <td class="docs"> Populate code coverage data. <h2></h2> <ul><li>param: Object cov</li></ul> </td> <td class="code"> <pre><code>function populateCoverage(cov) { cov.LOC = cov.SLOC = cov.totalFiles = cov.totalHits = cov.totalMisses = cov.coverage = 0; for (var name in cov) { var file = cov[name]; if (Array.isArray(file)) { // Stats ++cov.totalFiles; cov.totalHits += file.totalHits = coverage(file, true); cov.totalMisses += file.totalMisses = coverage(file, false); file.totalLines = file.totalHits + file.totalMisses; cov.SLOC += file.SLOC = file.totalLines; if (!file.source) file.source = []; cov.LOC += file.LOC = file.source.length; file.coverage = (file.totalHits / file.totalLines) * 100; // Source var width = file.source.length.toString().length; file.source = fil