vulcan 0.0.1 → 0.0.2

data/server/node_modules/express/node_modules/qs/test/stringify.test.js

@@ -0,0 +1,95 @@
+
+/**
+ * Module dependencies.
+ */
+
+var qs = require('../')
+  , should = require('should')
+  , query_string_identities = {
+    'basics': [
+      {query_string: 'foo=bar', parsed: {'foo' : 'bar'}},
+      {query_string: 'foo=%22bar%22', parsed: {'foo' : '\"bar\"'}},
+      {query_string: 'foo=', parsed: {'foo': ''}},
+      {query_string: 'foo=1&bar=2', parsed: {'foo' : '1', 'bar' : '2'}},
+      {query_string: 'my%20weird%20field=q1!2%22\'w%245%267%2Fz8)%3F', parsed: {'my weird field': "q1!2\"'w$5&7/z8)?"}},
+      {query_string: 'foo%3Dbaz=bar', parsed: {'foo=baz': 'bar'}},
+      {query_string: 'foo=bar&bar=baz', parsed: {foo: 'bar', bar: 'baz'}}
+    ],
+    'escaping': [
+      {query_string: 'foo=foo%20bar', parsed: {foo: 'foo bar'}},
+      {query_string: 'cht=p3&chd=t%3A60%2C40&chs=250x100&chl=Hello%7CWorld', parsed: {
+          cht: 'p3'
+        , chd: 't:60,40'
+        , chs: '250x100'
+        , chl: 'Hello|World'
+      }}
+    ],
+    'nested': [
+      {query_string: 'foo[]=bar&foo[]=quux', parsed: {'foo' : ['bar', 'quux']}},
+      {query_string: 'foo[]=bar', parsed: {foo: ['bar']}},
+      {query_string: 'foo[]=1&foo[]=2', parsed: {'foo' : ['1', '2']}},
+      {query_string: 'foo=bar&baz[]=1&baz[]=2&baz[]=3', parsed: {'foo' : 'bar', 'baz' : ['1', '2', '3']}},
+      {query_string: 'foo[]=bar&baz[]=1&baz[]=2&baz[]=3', parsed: {'foo' : ['bar'], 'baz' : ['1', '2', '3']}},
+      {query_string: 'x[y][z]=1', parsed: {'x' : {'y' : {'z' : '1'}}}},
+      {query_string: 'x[y][z][]=1', parsed: {'x' : {'y' : {'z' : ['1']}}}},
+      {query_string: 'x[y][z]=2', parsed: {'x' : {'y' : {'z' : '2'}}}},
+      {query_string: 'x[y][z][]=1&x[y][z][]=2', parsed: {'x' : {'y' : {'z' : ['1', '2']}}}},
+      {query_string: 'x[y][][z]=1', parsed: {'x' : {'y' : [{'z' : '1'}]}}},
+      {query_string: 'x[y][][z][]=1', parsed: {'x' : {'y' : [{'z' : ['1']}]}}},
+      {query_string: 'x[y][][z]=1&x[y][][w]=2', parsed: {'x' : {'y' : [{'z' : '1', 'w' : '2'}]}}},
+      {query_string: 'x[y][][v][w]=1', parsed: {'x' : {'y' : [{'v' : {'w' : '1'}}]}}},
+      {query_string: 'x[y][][z]=1&x[y][][v][w]=2', parsed: {'x' : {'y' : [{'z' : '1', 'v' : {'w' : '2'}}]}}},
+      {query_string: 'x[y][][z]=1&x[y][][z]=2', parsed: {'x' : {'y' : [{'z' : '1'}, {'z' : '2'}]}}},
+      {query_string: 'x[y][][z]=1&x[y][][w]=a&x[y][][z]=2&x[y][][w]=3', parsed: {'x' : {'y' : [{'z' : '1', 'w' : 'a'}, {'z' : '2', 'w' : '3'}]}}},
+      {query_string: 'user[name][first]=tj&user[name][last]=holowaychuk', parsed: { user: { name: { first: 'tj', last: 'holowaychuk' }}}}
+    ],
+    'errors': [
+      { parsed: 'foo=bar',     message: 'stringify expects an object' },
+      { parsed: ['foo', 'bar'], message: 'stringify expects an object' }
+    ]
+  };
+  
+
+// Assert error
+function err(fn, msg){
+  var err;
+  try {
+    fn();
+  } catch (e) {
+    should.equal(e.message, msg);
+    return;
+  }
+  throw new Error('no exception thrown, expected "' + msg + '"');
+}
+
+function test(type) {
+  var str, obj;
+  for (var i = 0; i < query_string_identities[type].length; i++) {
+    str = query_string_identities[type][i].query_string;
+    obj = query_string_identities[type][i].parsed;
+    qs.stringify(obj).should.eql(str);
+  }
+}
+
+module.exports = {
+  'test basics': function() {
+    test('basics');
+  },
+
+  'test escaping': function() {
+    test('escaping');
+  },
+
+  'test nested': function() {
+    test('nested');
+  },
+
+  'test errors': function() {
+    var parsed, message;
+    for (var i = 0; i < query_string_identities['errors'].length; i++) {
+      message      = query_string_identities['errors'][i].message;
+      parsed       = query_string_identities['errors'][i].parsed;
+      err(function(){ qs.stringify(parsed) }, message);
+    }
+  }
+};

data/server/node_modules/express/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "express",
+  "description": "Sinatra inspired web development framework",
+  "version": "2.4.6",
+  "author": "TJ Holowaychuk <tj@vision-media.ca>",
+  "contributors": [ 
+    { "name": "TJ Holowaychuk", "email": "tj@vision-media.ca" }, 
+    { "name": "Aaron Heckmann", "email": "aaron.heckmann+github@gmail.com" },
+    { "name": "Ciaran Jessup", "email": "ciaranj@gmail.com" },
+    { "name": "Guillermo Rauch", "email": "rauchg@gmail.com" }
+  ],
+  "dependencies": {
+    "connect": ">= 1.5.2 < 2.0.0",
+    "mime": ">= 0.0.1",
+    "qs": ">= 0.3.1"
+  },
+  "devDependencies": {
+    "connect-form": "0.2.1",
+    "ejs": "0.4.2",
+    "expresso": "0.7.2",
+    "hamljs": "0.5.1",
+    "jade": "0.11.0",
+    "stylus": "0.13.0",
+    "should": "0.2.1",
+    "express-messages": "0.0.2",
+    "node-markdown": ">= 0.0.1",
+    "connect-redis": ">= 0.0.1"
+  },
+  "keywords": ["framework", "sinatra", "web", "rest", "restful"],
+  "repository": "git://github.com/visionmedia/express",
+  "main": "index",
+  "bin": { "express": "./bin/express" },
+  "scripts": {
+    "test": "make test",
+    "prepublish" : "npm prune"
+  },
+  "engines": { "node": ">= 0.4.1 < 0.5.0" }
+}

data/server/node_modules/knox/History.md

@@ -0,0 +1,41 @@
+
+0.0.9 / 2011-06-20 
+==================
+
+  * Fixed signedUrl signature, needs encodeURIComponent() not escape() to prevent SignatureDoesNotMatch errors on signatures containing plus signs.
+
+0.0.8 / 2011-06-15 
+==================
+
+  * Fixed bug introduced in refactor
+
+0.0.7 / 2011-06-14 
+==================
+
+  * Fixed resource canonicalization
+
+0.0.6 / 2011-06-07 
+==================
+
+  * Fixed; ignoring certain query params when preparing stringToSign. [Rajiv Navada]
+
+0.0.4 / 2011-05-20 
+==================
+
+  * Added `Client#https?(filename)`
+
+0.0.3 / 2011-04-12 
+==================
+
+  * 0.4.x support
+
+0.0.2 / 2011-01-10 
+==================
+
+  * Removed `util` require
+  * Support for S3 presigned URLs
+
+0.0.1 / 2010-12-12 
+==================
+
+  * Initial release

data/server/node_modules/knox/Makefile

@@ -0,0 +1,21 @@
+
+test:
+	@./support/expresso/bin/expresso test/*.test.js \
+		--timeout 8000 \
+		--serial \
+		-I lib
+
+docs: index.html
+
+index.html:
+	dox \
+		--title "Knox" \
+		--desc "Light-weight Amazon S3 client for [NodeJS](http://nodejs.org)." \
+		--ribbon "http://github.com/LearnBoost/knox" \
+		--private \
+		lib/knox/*.js > $@
+
+docclean:
+	rm -f index.html
+
+.PHONY: test docs docclean

data/server/node_modules/knox/Readme.md

@@ -0,0 +1,144 @@
+
+# knox
+
+ Node Amazon S3 Client.
+
+## Features
+
+  - Not outdated :), developed for node 0.2.x
+  - RESTful api (`client.get()`, `client.put()`, etc)
+  - Uses node's crypto library (fast!, the others used native js)
+  - Very node-like low-level request api via `http.Client`
+  - Highly documented
+
+## Authors
+
+  - TJ Holowaychuk ([visionmedia](http://github.com/visionmedia))
+
+## Examples
+
+The following examples demonstrate some capabilities of knox and the s3 REST API. First things first, create an s3 client:
+
+    var client = knox.createClient({
+        key: '<api-key-here>'
+      , secret: '<secret-here>'
+      , bucket: 'learnboost'
+    });
+
+By default knox will send all requests to the global endpoint (bucket.s3.amazonaws.com).
+This works regardless of the region where the bucket is. But if you want to manually set
+the endpoint (for performance reasons) you can do it with the `endpoint` option.
+
+### PUT
+
+Below we do several things, first we read _Readme.md_ into memory,
+and initialize a client request via `client.put()`, passing the destination
+filename as the first parameter (_/test/Readme.md_), and some headers. Then
+we listen for the _response_ event, just as we would for any `http.Client` request, if we have a 200 response, great! output the destination url to stdout.
+
+    fs.readFile('Readme.md', function(err, buf){
+      var req = client.put('/test/Readme.md', {
+          'Content-Length': buf.length
+        , 'Content-Type': 'text/plain'
+      });
+      req.on('response', function(res){
+        if (200 == res.statusCode) {
+          console.log('saved to %s', req.url);
+        }
+      });
+      req.end(buf);
+    });
+
+By default the _x-amz-acl_ header is _public-read_, meaning anyone can __GET__ the file. To alter this simply pass this header to the client request method. Note that the field name __MUST__ be lowercase, do not use 'X-Amz-Acl' etc, as this will currently result in duplicate headers (although different case).
+
+    client.put('/test/Readme.md', { 'x-amz-acl': 'private' });
+
+Each HTTP verb has an alternate method with the "File" suffix, for example `put()` also has a higher level method named `putFile()`, accepting a src filename and performs the dirty work shown above for you. Here is an example usage:
+
+    client.putFile('my.json', '/user.json', function(err, res){
+      // Logic
+    }); 
+
+Another alternative is to stream via `Client#putStream()`, for example:
+
+    var stream = fs.createReadStream('data.json');
+    client.putStream(stream, '/some-data.json', function(err, res){
+      // Logic
+    });
+
+An example of moving a file:
+
+    client.put('0/0/0.png', {
+        'Content-Type': 'image/jpg',
+        'Content-Length': '0',
+        'x-amz-copy-source': '/test-tiles/0/0/0.png',
+        'x-amz-metadata-directive': 'REPLACE'
+    }).on('response', function(res) {
+      // Logic
+    }).end();
+
+### GET
+
+Below is an example __GET__ request on the file we just shoved at s3, and simply outputs the response status code, headers, and body.
+
+    client.get('/test/Readme.md').on('response', function(res){
+      console.log(res.statusCode);
+      console.log(res.headers);
+      res.setEncoding('utf8');
+      res.on('data', function(chunk){
+        console.log(chunk);
+      });
+    }).end();
+
+## DELETE
+
+Delete our file:
+
+    client.del('/test/Readme.md').on('response', function(res){
+      console.log(res.statusCode);
+      console.log(res.headers);
+    }).end();
+
+Likewise we also have `client.deleteFile()` as a more concise (yet less flexible) solution:
+
+    client.deleteFile('/test/Readme.md', function(err, res){
+      // Logic
+    });
+
+## Running Tests
+
+To run the test suite you must first have an S3 account, and create
+a file named _./auth_, which contains your credentials as json, for example:
+
+    {"key":"<api-key-here>",
+     "secret":"<secret-here>",
+     "bucket":"<your-bucket-name>"}
+
+Then simply execute:
+
+    $ make test
+
+## License 
+
+(The MIT License)
+
+Copyright (c) 2010 LearnBoost &lt;dev@learnboost.com&gt;
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/server/node_modules/knox/index.html

@@ -0,0 +1,483 @@
+<a href="http://github.com/LearnBoost/knox"><img alt="Fork me on GitHub" id="ribbon" src="http://s3.amazonaws.com/github/ribbons/forkme_right_darkblue_121621.png"></a><html>
+	<head>
+		<title>Knox</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>Knox</h1><p>Light-weight Amazon S3 client for <a href="http://nodejs.org">NodeJS</a>.</p></td><td></td></tr><tr class="filename"><td><h2 id="lib/knox/auth.js"><a href="#">auth</a></h2></td><td>lib/knox/auth.js</td></tr><tr class="code">
+<td class="docs">
+<p>Module dependencies.
+ </p>
+</td>
+<td class="code">
+<pre><code><span class="keyword">var</span> <span class="variable">crypto</span> = <span class="variable">require</span>(<span class="string">'crypto'</span>);</code></pre>
+</td>
+</tr>
+<tr class="code">
+<td class="docs">
+<p>Return an "Authorization" header value with the given <code>options</code>
+in the form of "AWS &lt;key&gt;:&lt;signature&gt;"</p>
+
+<h2></h2>
+
+<ul><li><p><strong>param</strong>: <em>Object</em>  options</p></li><li><p><strong>return</strong>: <em>String</em> </p></li><li><p><strong>api</strong>: <em>private</em></p></li></ul>
+</td>
+<td class="code">
+<pre><code><span class="variable">exports</span>.<span class="variable">authorization</span> = <span class="keyword">function</span>(<span class="variable">options</span>){
+  <span class="keyword">return</span> <span class="string">'AWS '</span> + <span class="variable">options</span>.<span class="variable">key</span> + <span class="string">':'</span> + <span class="variable">exports</span>.<span class="variable">sign</span>(<span class="variable">options</span>);
+};</code></pre>
+</td>
+</tr>
+<tr class="code">
+<td class="docs">
+<p>Create a base64 sha1 HMAC for <code>options</code>. </p>
+
+<h2></h2>
+
+<ul><li><p><strong>param</strong>: <em>Object</em>  options</p></li><li><p><strong>return</strong>: <em>String</em> </p></li><li><p><strong>api</strong>: <em>private</em></p></li></ul>
+</td>
+<td class="code">
+<pre><code><span class="variable">exports</span>.<span class="variable">sign</span> = <span class="keyword">function</span>(<span class="variable">options</span>){
+  <span class="keyword">var</span> <span class="variable">str</span> = <span class="variable">exports</span>.<span class="variable">stringToSign</span>(<span class="variable">options</span>);
+  <span class="keyword">return</span> <span class="variable">crypto</span>.<span class="variable">createHmac</span>(<span class="string">'sha1'</span>, <span class="variable">options</span>.<span class="variable">secret</span>).<span class="variable">update</span>(<span class="variable">str</span>).<span class="variable">digest</span>(<span class="string">'base64'</span>);
+};</code></pre>
+</td>
+</tr>
+<tr class="code">
+<td class="docs">
+<p>Return a string for sign() with the given <code>options</code>.</p>
+
+<h2>Spec</h2>
+
+<p>   &lt;verb&gt;\n
+   &lt;md5&gt;\n
+   &lt;content-type&gt;\n
+   &lt;date&gt;\n
+   [headers\n]
+   &lt;resource&gt;</p>
+
+<h2></h2>
+
+<ul><li><p><strong>param</strong>: <em>Object</em>  options</p></li><li><p><strong>return</strong>: <em>String</em> </p></li><li><p><strong>api</strong>: <em>private</em></p></li></ul>
+</td>
+<td class="code">
+<pre><code><span class="variable">exports</span>.<span class="variable">stringToSign</span> = <span class="keyword">function</span>(<span class="variable">options</span>){
+  <span class="keyword">var</span> <span class="variable">headers</span> = <span class="variable">options</span>.<span class="variable">amazonHeaders</span> || <span class="string">''</span>;
+  <span class="keyword">if</span> (<span class="variable">headers</span>) <span class="variable">headers</span> += <span class="string">'\n'</span>;
+  <span class="keyword">return</span> [
+      <span class="variable">options</span>.<span class="variable">verb</span>
+    , <span class="variable">options</span>.<span class="variable">md5</span>
+    , <span class="variable">options</span>.<span class="variable">contentType</span>
+    , <span class="variable">options</span>.<span class="variable">date</span>.<span class="variable">toUTCString</span>()
+    , <span class="variable">headers</span> + <span class="variable">options</span>.<span class="variable">resource</span>
+  ].<span class="variable">join</span>(<span class="string">'\n'</span>);
+};</code></pre>
+</td>
+</tr>
+<tr class="code">
+<td class="docs">
+<p>Perform the following:</p>
+
+<ul><li>ignore non-amazon headers</li><li>lowercase fields</li><li>sort lexicographically</li><li>trim whitespace between ":"</li><li>join with newline</li></ul>
+
+<h2></h2>
+
+<ul><li><p><strong>param</strong>: <em>Object</em>  headers</p></li><li><p><strong>return</strong>: <em>String</em> </p></li><li><p><strong>api</strong>: <em>private</em></p></li></ul>
+</td>
+<td class="code">
+<pre><code><span class="variable">exports</span>.<span class="variable">canonicalizeHeaders</span> = <span class="keyword">function</span>(<span class="variable">headers</span>){
+  <span class="keyword">var</span> <span class="variable">buf</span> = []
+    , <span class="variable">fields</span> = <span class="class">Object</span>.<span class="variable">keys</span>(<span class="variable">headers</span>);
+  <span class="keyword">for</span> (<span class="keyword">var</span> <span class="variable">i</span> = <span class="number integer">0</span>, <span class="variable">len</span> = <span class="variable">fields</span>.<span class="variable">length</span>; <span class="variable">i</span> &<span class="variable">lt</span>; <span class="variable">len</span>; ++<span class="variable">i</span>) {
+    <span class="keyword">var</span> <span class="variable">field</span> = <span class="variable">fields</span>[<span class="variable">i</span>]
+      , <span class="variable">val</span> = <span class="variable">headers</span>[<span class="variable">field</span>]
+      , <span class="variable">field</span> = <span class="variable">field</span>.<span class="variable">toLowerCase</span>();
+    <span class="keyword">if</span> (<span class="number integer">0</span> !== <span class="variable">field</span>.<span class="variable">indexOf</span>(<span class="string">'x-amz'</span>)) <span class="keyword">continue</span>;
+    <span class="variable">buf</span>.<span class="variable">push</span>(<span class="variable">field</span> + <span class="string">':'</span> + <span class="variable">val</span>);
+  }
+  <span class="keyword">return</span> <span class="variable">buf</span>.<span class="variable">sort</span>().<span class="variable">join</span>(<span class="string">'\n'</span>);
+};</code></pre>
+</td>
+</tr><tr class="filename"><td><h2 id="lib/knox/client.js"><a href="#">client</a></h2></td><td>lib/knox/client.js</td></tr><tr class="code">
+<td class="docs">
+<p>Module dependencies.
+ </p>
+</td>
+<td class="code">
+<pre><code><span class="keyword">var</span> <span class="variable">utils</span> = <span class="variable">require</span>(<span class="string">'./utils'</span>)
+  , <span class="variable">auth</span> = <span class="variable">require</span>(<span class="string">'./auth'</span>)
+  , <span class="variable">http</span> = <span class="variable">require</span>(<span class="string">'http'</span>)
+  , <span class="variable">join</span> = <span class="variable">require</span>(<span class="string">'path'</span>).<span class="variable">join</span>;</code></pre>
+</td>
+</tr>
+<tr class="code">
+<td class="docs">
+<p>Initialize a <code>Client</code> with the given <code>options</code>.</p>
+
+<h2>Required</h2>
+
+<ul><li><code>key</code>     amazon api key</li><li><code>secret</code>  amazon secret</li><li><code>bucket</code>  bucket name string, ex: "learnboost"</li></ul>
+
+<h2></h2>
+
+<ul><li><p><strong>param</strong>: <em>Object</em>  options</p></li><li><p><strong>api</strong>: <em>public</em></p></li></ul>
+</td>
+<td class="code">
+<pre><code><span class="keyword">var</span> <span class="class">Client</span> = <span class="variable">module</span>.<span class="variable">exports</span> = <span class="variable">exports</span> = <span class="keyword">function</span> <span class="class">Client</span>(<span class="variable">options</span>) {
+  <span class="this">this</span>.<span class="variable">host</span> = <span class="string">'s3.amazonaws.com'</span>;
+  <span class="variable">utils</span>.<span class="variable">merge</span>(<span class="this">this</span>, <span class="variable">options</span>);
+  <span class="keyword">if</span> (!<span class="this">this</span>.<span class="variable">key</span>) <span class="keyword">throw</span> <span class="keyword">new</span> <span class="class">Error</span>(<span class="string">'aws &quot;key&quot; required'</span>);
+  <span class="keyword">if</span> (!<span class="this">this</span>.<span class="variable">secret</span>) <span class="keyword">throw</span> <span class="keyword">new</span> <span class="class">Error</span>(<span class="string">'aws &quot;secret&quot; required'</span>);
+  <span class="keyword">if</span> (!<span class="this">this</span>.<span class="variable">bucket</span>) <span class="keyword">throw</span> <span class="keyword">new</span> <span class="class">Error</span>(<span class="string">'aws &quot;bucket&quot; required'</span>);
+};</code></pre>
+</td>
+</tr>
+<tr class="code">
+<td class="docs">
+<p>Request with <code>filename</code> the given <code>method</code>, and optional <code>headers</code>.</p>
+
+<h2></h2>
+
+<ul><li><p><strong>param</strong>: <em>String</em>  method</p></li><li><p><strong>param</strong>: <em>String</em>  filename</p></li><li><p><strong>param</strong>: <em>Object</em>  headers</p></li><li><p><strong>return</strong>: <em>ClientRequest</em> </p></li><li><p><strong>api</strong>: <em>private</em></p></li></ul>
+</td>
+<td class="code">
+<pre><code><span class="class">Client</span>.<span class="variable">prototype</span>.<span class="variable">request</span> = <span class="keyword">function</span>(<span class="variable">method</span>, <span class="variable">filename</span>, <span class="variable">headers</span>){
+  <span class="keyword">var</span> <span class="variable">client</span> = <span class="variable">http</span>.<span class="variable">createClient</span>(<span class="number integer">80</span>, <span class="this">this</span>.<span class="variable">host</span>)
+    , <span class="variable">path</span> = <span class="variable">join</span>(<span class="string">'/'</span>, <span class="this">this</span>.<span class="variable">bucket</span>, <span class="variable">filename</span>)
+    , <span class="variable">date</span> = <span class="keyword">new</span> <span class="class">Date</span>
+    , <span class="variable">headers</span> = <span class="variable">headers</span> || {};
+
+  <span class="comment">// Default headers</span>
+  <span class="variable">utils</span>.<span class="variable">merge</span>(<span class="variable">headers</span>, {
+      <span class="class">Date</span>: <span class="variable">date</span>.<span class="variable">toUTCString</span>()
+    , <span class="class">Host</span>: <span class="this">this</span>.<span class="variable">host</span>
+  });
+
+  <span class="comment">// Authorization header</span>
+  <span class="variable">headers</span>.<span class="class">Authorization</span> = <span class="variable">auth</span>.<span class="variable">authorization</span>({
+      <span class="variable">key</span>: <span class="this">this</span>.<span class="variable">key</span>
+    , <span class="variable">secret</span>: <span class="this">this</span>.<span class="variable">secret</span>
+    , <span class="variable">verb</span>: <span class="variable">method</span>
+    , <span class="variable">date</span>: <span class="variable">date</span>
+    , <span class="variable">resource</span>: <span class="variable">path</span>
+    , <span class="variable">contentType</span>: <span class="variable">headers</span>[<span class="string">'Content-Type'</span>]
+    , <span class="variable">amazonHeaders</span>: <span class="variable">auth</span>.<span class="variable">canonicalizeHeaders</span>(<span class="variable">headers</span>)
+  });
+
+  <span class="keyword">var</span> <span class="variable">req</span> = <span class="variable">client</span>.<span class="variable">request</span>(<span class="variable">method</span>, <span class="variable">path</span>, <span class="variable">headers</span>);
+  <span class="variable">req</span>.<span class="variable">url</span> = <span class="this">this</span>.<span class="variable">url</span>(<span class="variable">filename</span>);
+  <span class="keyword">return</span> <span class="variable">req</span>;
+};</code></pre>
+</td>
+</tr>
+<tr class="code">
+<td class="docs">
+<p>PUT data to <code>filename</code> with optional <code>headers</code>.</p>
+
+<h2>Example</h2>
+
+<pre><code>// Fetch the size
+fs.stat('Readme.md', function(err, stat){
+ // Create our request
+ var req = client.put('/test/Readme.md', {
+     'Content-Length': stat.size
+   , 'Content-Type': 'text/plain'
+ });
+ fs.readFile('Readme.md', function(err, buf){
+   // Output response
+   req.on('response', function(res){
+     console.log(res.statusCode);
+     console.log(res.headers);
+     res.on('data', function(chunk){
+       console.log(chunk.toString());
+     });
+   }); 
+   // Send the request with the file's Buffer obj
+   req.end(buf);
+ });
+});</code></pre>
+
+<h2></h2>
+
+<ul><li><p><strong>param</strong>: <em>String</em>  filename</p></li><li><p><strong>param</strong>: <em>Object</em>  headers</p></li><li><p><strong>return</strong>: <em>ClientRequest</em> </p></li><li><p><strong>api</strong>: <em>public</em></p></li></ul>
+</td>
+<td class="code">
+<pre><code><span class="class">Client</span>.<span class="variable">prototype</span>.<span class="variable">put</span> = <span class="keyword">function</span>(<span class="variable">filename</span>, <span class="variable">headers</span>){
+  <span class="variable">headers</span> = <span class="variable">utils</span>.<span class="variable">merge</span>({
+      <span class="class">Expect</span>: <span class="string">'100-continue'</span>
+    , <span class="string">'x-amz-acl'</span>: <span class="string">'public-read'</span>
+  }, <span class="variable">headers</span> || {});
+  <span class="keyword">return</span> <span class="this">this</span>.<span class="variable">request</span>(<span class="string">'PUT'</span>, <span class="variable">filename</span>, <span class="variable">headers</span>);
+};</code></pre>
+</td>
+</tr>
+<tr class="code">
+<td class="docs">
+<p>GET <code>filename</code> with optional <code>headers</code>.</p>
+
+<h2></h2>
+
+<ul><li><p><strong>param</strong>: <em>String</em>  filename</p></li><li><p><strong>param</strong>: <em>Object</em>  headers</p></li><li><p><strong>return</strong>: <em>ClientRequest</em> </p></li><li><p><strong>api</strong>: <em>public</em></p></li></ul>
+</td>
+<td class="code">
+<pre><code><span class="class">Client</span>.<span class="variable">prototype</span>.<span class="variable">get</span> = <span class="keyword">function</span>(<span class="variable">filename</span>, <span class="variable">headers</span>){
+  <span class="keyword">return</span> <span class="this">this</span>.<span class="variable">request</span>(<span class="string">'GET'</span>, <span class="variable">filename</span>, <span class="variable">headers</span>);
+};</code></pre>
+</td>
+</tr>
+<tr class="code">
+<td class="docs">
+<p>Issue a HEAD request on <code>filename</code> with optional `headers.</p>
+
+<h2></h2>
+
+<ul><li><p><strong>param</strong>: <em>String</em>  filename</p></li><li><p><strong>param</strong>: <em>Object</em>  headers</p></li><li><p><strong>return</strong>: <em>ClientRequest</em> </p></li><li><p><strong>api</strong>: <em>public</em></p></li></ul>
+</td>
+<td class="code">
+<pre><code><span class="class">Client</span>.<span class="variable">prototype</span>.<span class="variable">head</span> = <span class="keyword">function</span>(<span class="variable">filename</span>, <span class="variable">headers</span>){
+  <span class="keyword">return</span> <span class="this">this</span>.<span class="variable">request</span>(<span class="string">'HEAD'</span>, <span class="variable">filename</span>, <span class="variable">headers</span>);
+};</code></pre>
+</td>
+</tr>
+<tr class="code">
+<td class="docs">
+<p>DELETE <code>filename</code> with optional `headers.</p>
+
+<h2></h2>
+
+<ul><li><p><strong>param</strong>: <em>String</em>  filename</p></li><li><p><strong>param</strong>: <em>Object</em>  headers</p></li><li><p><strong>return</strong>: <em>ClientRequest</em> </p></li><li><p><strong>api</strong>: <em>public</em></p></li></ul>
+</td>
+<td class="code">
+<pre><code><span class="class">Client</span>.<span class="variable">prototype</span>.<span class="variable">del</span> = <span class="keyword">function</span>(<span class="variable">filename</span>, <span class="variable">headers</span>){
+  <span class="keyword">return</span> <span class="this">this</span>.<span class="variable">request</span>(<span class="string">'DELETE'</span>, <span class="variable">filename</span>, <span class="variable">headers</span>);
+};</code></pre>
+</td>
+</tr>
+<tr class="code">
+<td class="docs">
+<p>Return a url to the given <code>filename</code>.</p>
+
+<h2></h2>
+
+<ul><li><p><strong>param</strong>: <em>String</em>  filename</p></li><li><p><strong>return</strong>: <em>String</em> </p></li><li><p><strong>api</strong>: <em>public</em></p></li></ul>
+</td>
+<td class="code">
+<pre><code><span class="class">Client</span>.<span class="variable">prototype</span>.<span class="variable">url</span> = <span class="keyword">function</span>(<span class="variable">filename</span>){
+  <span class="keyword">return</span> <span class="string">'http://'</span> + <span class="this">this</span>.<span class="variable">bucket</span> + <span class="string">'.'</span> + <span class="this">this</span>.<span class="variable">host</span> + <span class="variable">join</span>(<span class="string">'/'</span>, <span class="variable">filename</span>);
+};</code></pre>
+</td>
+</tr>
+<tr class="code">
+<td class="docs">
+<p>Shortcut for <code>new Client()</code>.</p>
+
+<h2></h2>
+
+<ul><li><p><strong>param</strong>: <em>Object</em>  options</p></li><li><p><strong>see</strong>: <em>Client</em>
+()</p></li><li><p><strong>api</strong>: <em>public</em></p></li></ul>
+</td>
+<td class="code">
+<pre><code><span class="variable">exports</span>.<span class="variable">createClient</span> = <span class="keyword">function</span>(<span class="variable">options</span>){
+  <span class="keyword">return</span> <span class="keyword">new</span> <span class="class">Client</span>(<span class="variable">options</span>);
+};</code></pre>
+</td>
+</tr><tr class="filename"><td><h2 id="lib/knox/index.js"><a href="#">index</a></h2></td><td>lib/knox/index.js</td></tr><tr class="code">
+<td class="docs">
+<p>Client is the main export.
+ </p>
+</td>
+<td class="code">
+<pre><code><span class="variable">exports</span> = <span class="variable">module</span>.<span class="variable">exports</span> = <span class="variable">require</span>(<span class="string">'./client'</span>);</code></pre>
+</td>
+</tr>
+<tr class="code">
+<td class="docs">
+<p>Library version.</p>
+
+<ul><li><p><strong>type</strong>: <em>String</em></p></li></ul>
+</td>
+<td class="code">
+<pre><code><span class="variable">exports</span>.<span class="variable">version</span> = <span class="string">'0.0.1'</span>;</code></pre>
+</td>
+</tr>
+<tr class="code">
+<td class="docs">
+<p>Expose utilities.</p>
+
+<ul><li><p><strong>type</strong>: <em>Object</em></p></li></ul>
+</td>
+<td class="code">
+<pre><code><span class="variable">exports</span>.<span class="variable">utils</span> = <span class="variable">require</span>(<span class="string">'./utils'</span>);</code></pre>
+</td>
+</tr>
+<tr class="code">
+<td class="docs">
+<p>Expose auth utils.</p>
+
+<ul><li><p><strong>type</strong>: <em>Object</em></p></li></ul>
+</td>
+<td class="code">
+<pre><code><span class="variable">exports</span>.<span class="variable">auth</span> = <span class="variable">require</span>(<span class="string">'./auth'</span>);</code></pre>
+</td>
+</tr><tr class="filename"><td><h2 id="lib/knox/utils.js"><a href="#">utils</a></h2></td><td>lib/knox/utils.js</td></tr><tr class="code">
+<td class="docs">
+<p>Merge object <code>b</code> with object <code>a</code>.</p>
+
+<h2></h2>
+
+<ul><li><p><strong>param</strong>: <em>Object</em>  a</p></li><li><p><strong>param</strong>: <em>Object</em>  b</p></li><li><p><strong>return</strong>: <em>Object</em>  a</p></li><li><p><strong>api</strong>: <em>private</em></p></li></ul>
+</td>
+<td class="code">
+<pre><code><span class="variable">exports</span>.<span class="variable">merge</span> = <span class="keyword">function</span>(<span class="variable">a</span>, <span class="variable">b</span>){
+  <span class="keyword">var</span> <span class="variable">keys</span> = <span class="class">Object</span>.<span class="variable">keys</span>(<span class="variable">b</span>);
+  <span class="keyword">for</span> (<span class="keyword">var</span> <span class="variable">i</span> = <span class="number integer">0</span>, <span class="variable">len</span> = <span class="variable">keys</span>.<span class="variable">length</span>; <span class="variable">i</span> &<span class="variable">lt</span>; <span class="variable">len</span>; ++<span class="variable">i</span>) {
+    <span class="keyword">var</span> <span class="variable">key</span> = <span class="variable">keys</span>[<span class="variable">i</span>];
+    <span class="variable">a</span>[<span class="variable">key</span>] = <span class="variable">b</span>[<span class="variable">key</span>]
+  }
+  <span class="keyword">return</span> <span class="variable">a</span>;
+};</code></pre>
+</td>
+</tr>
+<tr class="code">
+<td class="docs">
+<p>Base64.
+ </p>
+</td>
+<td class="code">
+<pre><code><span class="variable">exports</span>.<span class="variable">base64</span> = {</code></pre>
+</td>
+</tr>
+<tr class="code">
+<td class="docs">
+<p>Base64 encode the given <code>str</code>.</p>
+
+<h2></h2>
+
+<ul><li><p><strong>param</strong>: <em>String</em>  str</p></li><li><p><strong>return</strong>: <em>String</em> </p></li><li><p><strong>api</strong>: <em>private</em></p></li></ul>
+</td>
+<td class="code">
+<pre><code><span class="variable">encode</span>: <span class="keyword">function</span>(<span class="variable">str</span>){
+    <span class="keyword">return</span> <span class="keyword">new</span> <span class="class">Buffer</span>(<span class="variable">str</span>).<span class="variable">toString</span>(<span class="string">'base64'</span>);
+  },</code></pre>
+</td>
+</tr>
+<tr class="code">
+<td class="docs">
+<p>Base64 decode the given <code>str</code>.</p>
+
+<h2></h2>
+
+<ul><li><p><strong>param</strong>: <em>String</em>  str</p></li><li><p><strong>return</strong>: <em>String</em> </p></li><li><p><strong>api</strong>: <em>private</em></p></li></ul>
+</td>
+<td class="code">
+<pre><code><span class="variable">decode</span>: <span class="keyword">function</span>(<span class="variable">str</span>){
+    <span class="keyword">return</span> <span class="keyword">new</span> <span class="class">Buffer</span>(<span class="variable">str</span>, <span class="string">'base64'</span>).<span class="variable">toString</span>();
+  }
+};</code></pre>
+</td>
+</tr>	</body>
+</html></tbody></table>