RubyGems - vulcan - Versions diffs - 0.0.1 → 0.0.2 - Mend

vulcan 0.0.1 → 0.0.2

Files changed (627) hide show

data/server/node_modules/connect-form/support/connect/docs/errorHandler.html ADDED Viewed

@@ -0,0 +1,181 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <title>Connect</title>
+    <meta http-equiv="content-type" value="text/html; charset=utf-8">
+    <style type="text/css">
+      body {
+        font: 13px "Helvetica Neue", "Lucida Grande", "Arial";
+        text-align: center;
+        color: #555;
+        -webkit-text-stroke: 1px rgba(255, 255, 255, 0.1);
+      }
+      h1, h2, h3 {
+        margin: 0;
+        font-size: 22px;
+        font-weight: normal;
+        color: #343434;
+      }
+      h2#Connect {
+        margin-bottom: 25px;
+        font-size: 60px;
+        font-weight: bold;
+      }
+      h2#Connect + p {
+        display: none;
+      }
+	  h3 {
+		margin: 35px 0;
+		padding-left: 10px;
+	    font-size: 16px;
+		border-left: 15px solid #eee;
+	  }
+      h2 {
+        margin-top: 35px;
+        text-shadow: 1px 2px 2px #ddd;
+      }
+      ul {
+        margin: 10px 35px;
+        padding: 0;
+      }
+      ul li .path {
+        padding-left: 5px;
+        font-weight: bold;
+      }
+      ul li .line {
+        padding-right: 5px;
+        font-style: italic;
+      }
+      ul li:first-child .path {
+        padding-left: 0;
+      }
+      p {
+        line-height: 1.5;
+      }
+      p code {
+        padding: 2px 4px;
+        border: 1px solid #ddd;
+      }
+      p em, li em {
+        font-weight: bold;
+      }
+      pre {
+        margin: 25px 0 25px 15px;
+        padding: 15px;
+        border: 1px solid #ddd;
+        -webkit-border-radius: 5px;
+        -moz-border-radius: 5px;
+        -webkit-box-shadow: 1px 1px 6px #ddd;
+        -moz-box-shadow: 1px 1px 6px #ddd;
+      }
+      table {
+        margin-bottom: 35px;
+        width: 100%;
+        border-collapse: collapse;
+      }
+      table td {
+        padding: 5px 10px;
+        font-size: 14px;
+      }
+      table tr {
+        border-bottom: 1px solid #fff;
+      }
+      table tr:last-child {
+        border-bottom: none;
+      }
+      table td:first-child {
+        width: 150px;
+        color: #343434;
+      }
+      #wrapper {
+        margin: 50px auto;
+        width: 750px;
+        text-align: left;
+      }
+	  #menu {
+		position: fixed;
+		top: 15px;
+		right: 15px;
+		margin: 0;
+		padding: 0;
+		list-style: none;
+		text-align: right;
+	  }
+	  #menu li.title {
+	    padding: 20px 0 5px 0;
+	    font-size: 12px;
+	  }
+	  code.js { color: #111; }
+	  code.js .comment { color: #999; }
+	  code.js .string { color: #cc0000; }
+	  code.js .number { color: #0000ee; }
+	  code.js .keyword { color: #000; font-weight: bold; }
+	  a {
+	    text-decoration: none;
+	    color: #000;
+	  }
+	  a:hover {
+	    text-decoration: underline;
+	  }
+    </style>
+  </head>
+  <body>
+    <div id="wrapper">
+		<ul id="menu">
+			<li class="title">API</li>
+			<li><a href="api.html">extended api docs</a></li>
+			<li class="title">Middleware</li>
+			<li><a href="lint.html">lint</a></li>
+			<li><a href="flash.html">flash</a></li>
+			<li><a href="logger.html">logger</a></li>
+			<li><a href="format.html">format</a></li>
+			<li><a href="router.html">router</a></li>
+			<li><a href="jsonrpc.html">jsonrpc</a></li>
+			<li><a href="session.html">session</a></li>
+			<li><a href="compiler.html">compiler</a></li>
+			<li><a href="redirect.html">redirect</a></li>
+			<li><a href="errorHandler.html">errorHandler</a></li>
+			<li><a href="bodyDecoder.html">bodyDecoder</a></li>
+			<li><a href="responseTime.html">responseTime</a></li>
+			<li><a href="cookieDecoder.html">cookieDecoder</a></li>
+			<li><a href="conditionalGet.html">conditionalGet</a></li>
+			<li><a href="methodOverride.html">methodOverride</a></li>
+			<li><a href="staticProvider.html">staticProvider</a></li>
+		</ul><div class='mp'>
+<h2 id="Error-Handler">Error Handler</h2>
+<p>The <em>errorHandler</em> middleware responds to exceptions passed or caught from within middleware above it, according to the options shown below.</p>
+<pre><code class="js"><span class="variable">connect</span>.<span class="variable">createServer</span>(
+    <span class="keyword">function</span>(<span class="variable">req</span>, <span class="variable">res</span>, <span class="variable">next</span>){
+        <span class="keyword">throw</span> <span class="keyword">new</span> <span class="class">Error</span>(<span class="string">'ahhhh!'</span>);
+    },
+    <span class="variable">connect</span>.<span class="variable">errorHandler</span>({ <span class="variable">dumpExceptions</span>: <span class="variable">true</span> })
+);
+</code></pre>
+<p>By default the response of <em>errorHandler</em> is 500 'Internal Server Error'. If <em>showStack</em> is true, then Connect decides how to respond based on the <em>Accept</em> request header:</p>
+<pre><code>text/html         Outputs an html version of the stack trace
+application/json  Outputs json { 'error': { 'message': ... }}
+otherwise         Outputs plain text stack trace
+</code></pre>
+<h3 id="Options">Options</h3>
+<pre><code>showMessage     Show the exception message only
+showStack       Show the exception message and stack trace
+dumpExceptions  Output exception stack traces to stderr (does not re-throw)
+</code></pre>
+<h3 id="Environment-Variables">Environment Variables</h3>
+<pre><code>--showErrorMessage
+--showErrorStack
+--dumpExceptions
+</code></pre>
+</div>
+    </div>
+  </body>
+</html>

data/server/node_modules/connect-form/support/connect/docs/errorHandler.md ADDED Viewed

@@ -0,0 +1,28 @@
+## Error Handler
+The _errorHandler_ middleware responds to exceptions passed or caught from within middleware above it, according to the options shown below.
+    connect.createServer(
+	    function(req, res, next){
+		    throw new Error('ahhhh!');
+	    },
+		connect.errorHandler({ dumpExceptions: true })
+	);
+By default the response of _errorHandler_ is 500 'Internal Server Error'. If _showStack_ is true, then Connect decides how to respond based on the _Accept_ request header:
+    text/html         Outputs an html version of the stack trace
+    application/json  Outputs json { 'error': { 'message': ... }}
+    otherwise         Outputs plain text stack trace
+### Options
+    showMessage     Show the exception message only
+    showStack       Show the exception message and stack trace
+    dumpExceptions  Output exception stack traces to stderr (does not re-throw)
+### Environment Variables
+    --showErrorMessage
+    --showErrorStack
+    --dumpExceptions

data/server/node_modules/connect-form/support/connect/docs/format.1 ADDED Viewed

@@ -0,0 +1,7 @@
+.\" generated with Ronn/v0.6.6
+.\" http://github.com/rtomayko/ronn/
+.
+.TH "FORMAT" "" "June 2010" "" ""
+.
+.SH "Format"
+The \fIformat\fR middleware populates \fBreq\.format\fR from urls such as \fI/products\.json\fR where the \fBreq\.url\fR becomes \fI/products\fR and \fBreq\.format\fR becomes \fIjson\fR\.

data/server/node_modules/connect-form/support/connect/docs/format.html ADDED Viewed

@@ -0,0 +1,152 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <title>Connect</title>
+    <meta http-equiv="content-type" value="text/html; charset=utf-8">
+    <style type="text/css">
+      body {
+        font: 13px "Helvetica Neue", "Lucida Grande", "Arial";
+        text-align: center;
+        color: #555;
+        -webkit-text-stroke: 1px rgba(255, 255, 255, 0.1);
+      }
+      h1, h2, h3 {
+        margin: 0;
+        font-size: 22px;
+        font-weight: normal;
+        color: #343434;
+      }
+      h2#Connect {
+        margin-bottom: 25px;
+        font-size: 60px;
+        font-weight: bold;
+      }
+      h2#Connect + p {
+        display: none;
+      }
+	  h3 {
+		margin: 35px 0;
+		padding-left: 10px;
+	    font-size: 16px;
+		border-left: 15px solid #eee;
+	  }
+      h2 {
+        margin-top: 35px;
+        text-shadow: 1px 2px 2px #ddd;
+      }
+      ul {
+        margin: 10px 35px;
+        padding: 0;
+      }
+      ul li .path {
+        padding-left: 5px;
+        font-weight: bold;
+      }
+      ul li .line {
+        padding-right: 5px;
+        font-style: italic;
+      }
+      ul li:first-child .path {
+        padding-left: 0;
+      }
+      p {
+        line-height: 1.5;
+      }
+      p code {
+        padding: 2px 4px;
+        border: 1px solid #ddd;
+      }
+      p em, li em {
+        font-weight: bold;
+      }
+      pre {
+        margin: 25px 0 25px 15px;
+        padding: 15px;
+        border: 1px solid #ddd;
+        -webkit-border-radius: 5px;
+        -moz-border-radius: 5px;
+        -webkit-box-shadow: 1px 1px 6px #ddd;
+        -moz-box-shadow: 1px 1px 6px #ddd;
+      }
+      table {
+        margin-bottom: 35px;
+        width: 100%;
+        border-collapse: collapse;
+      }
+      table td {
+        padding: 5px 10px;
+        font-size: 14px;
+      }
+      table tr {
+        border-bottom: 1px solid #fff;
+      }
+      table tr:last-child {
+        border-bottom: none;
+      }
+      table td:first-child {
+        width: 150px;
+        color: #343434;
+      }
+      #wrapper {
+        margin: 50px auto;
+        width: 750px;
+        text-align: left;
+      }
+	  #menu {
+		position: fixed;
+		top: 15px;
+		right: 15px;
+		margin: 0;
+		padding: 0;
+		list-style: none;
+		text-align: right;
+	  }
+	  #menu li.title {
+	    padding: 20px 0 5px 0;
+	    font-size: 12px;
+	  }
+	  code.js { color: #111; }
+	  code.js .comment { color: #999; }
+	  code.js .string { color: #cc0000; }
+	  code.js .number { color: #0000ee; }
+	  code.js .keyword { color: #000; font-weight: bold; }
+	  a {
+	    text-decoration: none;
+	    color: #000;
+	  }
+	  a:hover {
+	    text-decoration: underline;
+	  }
+    </style>
+  </head>
+  <body>
+    <div id="wrapper">
+		<ul id="menu">
+			<li class="title">API</li>
+			<li><a href="api.html">extended api docs</a></li>
+			<li class="title">Middleware</li>
+			<li><a href="lint.html">lint</a></li>
+			<li><a href="flash.html">flash</a></li>
+			<li><a href="logger.html">logger</a></li>
+			<li><a href="format.html">format</a></li>
+			<li><a href="router.html">router</a></li>
+			<li><a href="jsonrpc.html">jsonrpc</a></li>
+			<li><a href="session.html">session</a></li>
+			<li><a href="compiler.html">compiler</a></li>
+			<li><a href="redirect.html">redirect</a></li>
+			<li><a href="errorHandler.html">errorHandler</a></li>
+			<li><a href="bodyDecoder.html">bodyDecoder</a></li>
+			<li><a href="responseTime.html">responseTime</a></li>
+			<li><a href="cookieDecoder.html">cookieDecoder</a></li>
+			<li><a href="conditionalGet.html">conditionalGet</a></li>
+			<li><a href="methodOverride.html">methodOverride</a></li>
+			<li><a href="staticProvider.html">staticProvider</a></li>
+		</ul><div class='mp'>
+<h2 id="Format">Format</h2>
+<p>The <em>format</em> middleware populates <code>req.format</code> from urls such as <em>/products.json</em> where the <code>req.url</code> becomes <em>/products</em> and <code>req.format</code> becomes <em>json</em>.</p>
+</div>
+    </div>
+  </body>
+</html>

data/server/node_modules/connect-form/support/connect/docs/format.md ADDED Viewed

@@ -0,0 +1,3 @@
+## Format
+The _format_ middleware populates `req.format` from urls such as _/products.json_ where the `req.url` becomes _/products_ and `req.format` becomes _json_.

data/server/node_modules/connect-form/support/connect/docs/index.1 ADDED Viewed

@@ -0,0 +1,260 @@
+.\" generated with Ronn/v0.6.6
+.\" http://github.com/rtomayko/ronn/
+.
+.TH "CONNECT" "1" "July 2010" "" ""
+.
+.SH "NAME"
+\fBconnect\fR \- node server runner
+.
+.SH "Synopsis"
+.
+.nf
+connect [\-H|\-\-host ADDR] [\-p|\-\-port NUM]
+        [\-n|\-\-workers NUM] [\-I|\-\-include PATH]
+        [\-E|\-\-env ENV] [\-e|\-\-eval CODE] [\-C|\-\-chdir PATH]
+        [\-c|\-\-config PATH] [\-P|\-\-pidfile PATH]
+        [\-l|\-\-logfile PATH] [\-u|\-\-user ID|USER] [\-g|\-\-group ID|GROUP]
+        [\-v|\-\-verbose] [\-V|\-\-version] [\-K|\-\-no\-color]
+        [\-h|\-\-help] [\-\-ENV VAL]
+        start|stop|restart|status [PATH]
+.
+.fi
+.
+.SH "Description"
+Connect is a dual purpose library, aiding in both rapid development, and deployment of node servers\. Connect \"middleware\" can be stacked to create a robust application within minutes\. The \fIconnect\fR executable supports launching of both regular \fBnet\.Server\fR, and \fBconnect\.Server\fR instances\.
+.
+.P
+The connect executable supplies \fIinit\.d\fR friendly \fIstart\fR, \fIstop\fR, and \fIrestart\fR commands, and accept a direct path to the module meant to be run, otherwise defaults to trying both \fIapp\.js\fR and \fIserver\.js\fR in the current working directory\.
+.
+.P
+Also to check the status of a process you may use the \fIstatus\fR command, which checks if the process is running\.
+.
+.SH "Executable Options"
+.
+.nf
+\-H, \-\-host ADDR       Host address, defaults to INADDR_ANY
+\-p, \-\-port NUM        Port number, defaults to 3000
+\-n, \-\-workers NUM     Number of worker processes to spawn
+\-I, \-\-include PATH    Unshift the given path to require\.paths
+\-E, \-\-env ENV         Set environment, defaults to \"development\"
+\-e, \-\-eval CODE       Evaluate the given string
+\-C, \-\-chdir PATH      Change to the given path
+\-c, \-\-config PATH     Load configuration module
+\-P, \-\-pidfile PATH    PID file, defaults to pids/connect\.pid
+\-l, \-\-logfile PATH    Log file, defaults to logs/connect\.log
+\-u, \-\-user ID|USER    Change user with setuid()
+\-g, \-\-group ID|GROUP  Change group with setgid()
+\-v, \-\-verbose         Display verbose output
+\-V, \-\-version         Output connect version
+\-K, \-\-no\-color        Suppress colored terminal output
+\-h, \-\-help            Display help information
+\-\-ENV VAL             Sets the given connect environment variable
+.
+.fi
+.
+.SH "Supported Environment Variables"
+Currently the following environment variables may be set via the \fB\-\-ENV VAL\fR catchall\. For example we can alter the log format used via the command line with `connect \-\-logFormat \":method :uri\"\.
+.
+.P
+Boolean values may use strings such as \fIyes\fR, \fIno\fR, \fItrue\fR, \fIfalse\fR\.
+.
+.IP "" 4
+.
+.nf
+\-\-logFormat STR           Custom log format
+\-\-dumpExceptions BOOL     Dump exceptions to stderr
+\-\-showErrorMessage BOOL   Show exception message in response (recommended for development only)
+\-\-showErrorStack BOOL     Show exception stack trace (recommended for development only)
+\-\-methodOverrideKey STR   Override the default method key of \"_method\"
+\-\-compilerSrc PATH        Compiler source root directory
+\-\-compilerDest PATH       Compiler destination directory
+.
+.fi
+.
+.IP "" 0
+.
+.SH "Middleware Usage"
+Below is an example which shows usage of the \fIlogger\fR middleware bundled with Connect, as well as \fIstaticProvder\fR\.
+.
+.IP "" 4
+.
+.nf
+var connect = require(\'connect\');
+module\.exports = connect\.createServer(
+    connect\.logger(),
+    connect\.staticProvider(__dirname + \'/public\')
+);
+.
+.fi
+.
+.IP "" 0
+.
+.P
+As shown above the module exports a \fBconnect\.Server\fR and does not call the \fBlisten()\fR method directly\. This allows other modules to \"mount\" this app, as well as allowing the \fIconnect\fR executable to control how the server is run\.
+.
+.P
+If you prefer not to use \fIconnect\fR, you can simply create a script executable by \fInode\fR, \fBrequire()\fR the app, then invoke \fBlisten()\fR\.
+.
+.IP "" 4
+.
+.nf
+#!/usr/bin/env node
+require(\'\./app\')\.listen();
+.
+.fi
+.
+.IP "" 0
+.
+.SH "Middleware Authoring"
+Connect middleware is simply a function which accepts the \fIrequest\fR, \fIresponse\fR objects\. Optionally the third parameter \fInext\fR can be used to continue down the middleware stack\. For example below is a middleware layer that simply responds with \"hello world\"\.
+.
+.IP "" 4
+.
+.nf
+function helloWorld(req, res) {
+    res\.writeHead(200, { \'Content\-Type\': \'text/plain\' });
+    res\.end(\'hello world\');
+}
+connect\.createServer(helloWorld)\.listen(3000);
+.
+.fi
+.
+.IP "" 0
+.
+.P
+Lets say we now have some middleware that will require a setup step, this can be done by returning a closure:
+.
+.IP "" 4
+.
+.nf
+function respond(msg) {
+    msg = msg || \'hello world\';
+    return function(req, res) {
+        res\.writeHead(200, { \'Content\-Type\': \'text/plain\' });
+        res\.end(msg);
+    }
+}
+connect\.createServer(respond(\'wahoo\'))\.listen(3000);
+.
+.fi
+.
+.IP "" 0
+.
+.P
+To pass control to the next middleware layer, we may call the \fBnext()\fR function with an optional instanceof \fBError\fR\. Middleware with four parameters is an error handling middleware, the \fBerr\fR object can then be logged, used to issue a response, ignored, etc\.
+.
+.IP "" 4
+.
+.nf
+function break(req, res, next) {
+    // Exceptions thrown will be automatically passed to next()
+    // however for custom exceptions / async exceptions you may pass them
+    next(new Error(\'something broke!\'));
+}
+function errorHandler(err, req, res, next) {
+    res\.writeHead(500, { \'Content\-Type\': \'text/plain\' });
+    res\.end(err\.stack);
+}
+connect\.createServer(break, errorHandler)\.listen(3000);
+.
+.fi
+.
+.IP "" 0
+.
+.P
+To make your middleware available to others, typically you write a module, and export the function itself:
+.
+.IP "" 4
+.
+.nf
+// delay\.js
+module\.exports = function(ms){
+    ms = ms || 1000;
+    return function(req, res, next){
+        setTimeout(next, ms);
+    }
+};
+.
+.fi
+.
+.IP "" 0
+.
+.P
+// app\.js // delay one second before continuing down the stack connect\.createServer(require(\'\./delay\')(1000))\.listen(3000);
+.
+.SH "Bundled Middleware"
+Connect ships with several helpful middleware modules, the following are currently provided out of the box:
+.
+.IP "" 4
+.
+.nf
+bodyDecoder      Buffers and parses json and urlencoded request bodies (extenable)
+conditionalGet   Provides 304 \"Not Modified\" support
+errorHandler     Handles exceptions thrown, or passed through the stack
+debug            Outputs debugging console to all html responses
+format           Handles url path extensions or \"formats\"
+gzip             Compresses response bodies with gzip executable
+lint             Aids in middleware development
+logger           Provides common logger support, and custom log formats
+methodOverride   Provides faux HTTP method support by using the \"_method\" key by default
+responseTime     Responds with the X\-Response\-Time header in milliseconds
+redirect         Provides req\.redirect() with \"magic\" urls, ex: req\.redirect(\"back\")
+compiler         Supports arbitrary static compilation of files, currently supports less and sass\.
+cacheManifest    Provides cache manifest for offline apps
+jsonrpc          Provides JSON\-RPC 2\.0 support
+staticProvider   Serves static files
+router           Provides a feature rich routing API similar to Sinatra and Express
+cookieDecoder    Provides cookie parsing support
+session          Provides session support
+cache            Provides memory caching
+pubsub           Publish subscribe messaging support
+jsonrpc          JSON\-RPC 2\.0 support
+format           Populates req\.format for urls such as \"/products\.json\"
+repl             Read Evaluate Print Loop attached to \"/tmp/connect\.sock\" for inspecting live servers
+vhost            Virtual host support
+.
+.fi
+.
+.IP "" 0
+.
+.SS "Middleware Documentation"
+To view middleware specific documentation execute:
+.
+.IP "" 4
+.
+.nf
+$ man connect\-MIDDLEWARE
+.
+.fi
+.
+.IP "" 0
+.
+.P
+For example:
+.
+.IP "" 4
+.
+.nf
+$ man connect\-bodyDecoder
+.
+.fi
+.
+.IP "" 0