balena-cli/doc/file/lib/resin/server/server.coffee.html
2014-12-09 12:47:43 -04:00

301 lines
7.4 KiB
HTML

<!DOCTYPE html>
<html>
<head>
<meta charset='UTF-8'>
<title>CoffeeScript API Documentation</title>
<script src='../../../../javascript/application.js'></script>
<script src='../../../../javascript/search.js'></script>
<link rel='stylesheet' href='../../../../stylesheets/application.css' type='text/css'>
</head>
<body>
<div id='base' data-path='../../../../'></div>
<div id='header'>
<div id='menu'>
<a href='../../../../alphabetical_index.html' title='Index'>
Index
</a>
&raquo;
<span class='title'>lib</span>
&raquo;
<span class='title'>resin</span>
&raquo;
<span class='title'>server</span>
&raquo;
<span class='title'>server.coffee</span>
</div>
</div>
<div id='content'>
<h1>
File:
server.coffee
</h1>
<table class='box'>
<tr>
<td>Defined in:</td>
<td>lib&#47;resin&#47;server</td>
</tr>
</table>
<h2>Method Summary</h2>
<ul class='summary'>
<li>
<span class='signature'>
<a href='#request-'>
~
(void)
<b>request</b><span>(options = {}, outerCallback, onProgress)</span>
</a>
</span>
<span class='desc'>
Send an HTTP request to resin.io <pre><code>resin.server.request { method: &#39;GET&#39; url: &#39;/foobar&#39;
}, (error, response, body) -&gt; throw error if error? console.log(body)
resin.server.request { method: &#39;POST&#39; url: &#39;/foobar&#39; json:
name: &#39;My FooBar&#39;
}, (error, response, body) -&gt; throw error if error? assert(response.statusCode is 201)
resin.server.request { method: &#39;GET&#39; url: &#39;/download&#39; pipe: fs.createWriteStream(&#39;/tmp/download&#39;)
}, (error) -&gt; throw error if error?
, (state) -&gt; console.log(&quot;Received: #{state.received}&quot;) console.log(&quot;Total: #{state.total}&quot;) console.log(&quot;Is Complete? #{state.complete}&quot;)
</code></pre>
</span>
</li>
<li>
<span class='signature'>
<a href='#createFacadeFunction-'>
~
(void)
<b>createFacadeFunction</b><span>(method)</span>
</a>
</span>
<span class='note private title'>Private</span>
<span class='desc'>
Generate shorthand functions for every method
</span>
</li>
</ul>
<h2>Method Details</h2>
<div class='methods'>
<div class='method_details'>
<p class='signature' id='request-'>
~
(void)
<b>request</b><span>(options = {}, outerCallback, onProgress)</span>
<br>
</p>
<div class='docstring'>
<div class='note'>
<strong>Note:</strong>
If the user is logged in, the token gets automatically added to Authorization header
</div>
<div class='note'>
<strong>Note:</strong>
If the response is JSON, it will attempt to parse it
</div>
<p>Send an HTTP request to resin.io</p><pre><code>resin.server.request { method: &#39;GET&#39; url: &#39;/foobar&#39;
}, (error, response, body) -&gt; throw error if error? console.log(body)
resin.server.request { method: &#39;POST&#39; url: &#39;/foobar&#39; json:
name: &#39;My FooBar&#39;
}, (error, response, body) -&gt; throw error if error? assert(response.statusCode is 201)
resin.server.request { method: &#39;GET&#39; url: &#39;/download&#39; pipe: fs.createWriteStream(&#39;/tmp/download&#39;)
}, (error) -&gt; throw error if error?
, (state) -&gt; console.log(&quot;Received: #{state.received}&quot;) console.log(&quot;Total: #{state.total}&quot;) console.log(&quot;Is Complete? #{state.complete}&quot;)
</code></pre>
</div>
<div class='tags'>
<h3>Parameters:</h3>
<ul class='param'>
<li>
<span class='name'>options</span>
<span class='type'>
(
<tt>Object</tt>
)
</span>
&mdash;
<span class='desc'>request options </span>
</li>
<li>
<span class='name'>callback</span>
<span class='type'>
(
<tt>Function</tt>
)
</span>
&mdash;
<span class='desc'>callback(error, response, body) </span>
</li>
<li>
<span class='name'>onProgress</span>
<span class='type'>
(
<tt>Function</tt>
)
</span>
&mdash;
<span class='desc'>on progress callback(state) (optional) </span>
</li>
</ul>
<h3>
Options Hash:
(options):
</h3>
<ul class='options'>
<li>
<span class='name'>url</span>
<span class='type'>
(
<tt>String</tt>
)
</span>
&mdash;
<span class='desc'>relative url </span>
</li>
<li>
<span class='name'>json</span>
<span class='type'>
(
<tt>String</tt>
)
</span>
&mdash;
<span class='desc'>request body </span>
</li>
<li>
<span class='name'>method</span>
<span class='type'>
(
<tt>String</tt>
)
</span>
&mdash;
<span class='desc'>HTTP method </span>
</li>
<li>
<span class='name'>headers</span>
<span class='type'>
(
<tt>Object</tt>
)
</span>
&mdash;
<span class='desc'>custom HTTP headers </span>
</li>
<li>
<span class='name'>pipe</span>
<span class='type'>
(
<tt>Function</tt>
)
</span>
&mdash;
<span class='desc'>define this function if you want to stream the response </span>
</li>
</ul>
<h3>Throws:</h3>
<ul class='throw'>
<li>
<span class='type'></span>
(
<tt>Error</tt>
)
&mdash;
<span class='desc'>Will throw if you don&#39;t have internet connection </span>
</li>
</ul>
</div>
</div>
<div class='method_details'>
<p class='signature' id='createFacadeFunction-'>
~
(void)
<b>createFacadeFunction</b><span>(method)</span>
<span class='note private'>Private</span>
<br>
</p>
<div class='docstring'>
<div class='note todo'>
<strong>TODO:</strong>
Find a way to document all of the methods directly
</div>
<p>Generate shorthand functions for every method</p>
</div>
<div class='tags'>
</div>
</div>
</div>
</div>
<div id='footer'>
December 09, 14 12:47:37 by
<a href='https://github.com/coffeedoc/codo' title='CoffeeScript API documentation generator'>
Codo
</a>
2.0.9
&#10034;
Press H to see the keyboard shortcuts
&#10034;
<a href='http://twitter.com/netzpirat' target='_parent'>@netzpirat</a>
&#10034;
<a href='http://twitter.com/_inossidabile' target='_parent'>@_inossidabile</a>
</div>
<iframe id='search_frame'></iframe>
<div id='fuzzySearch'>
<input type='text'>
<ol></ol>
</div>
<div id='help'>
<p>
Quickly fuzzy find classes, mixins, methods, file:
</p>
<ul>
<li>
<span>T</span>
Open fuzzy finder dialog
</li>
</ul>
<p>
Control the navigation frame:
</p>
<ul>
<li>
<span>L</span>
Toggle list view
</li>
<li>
<span>C</span>
Show class list
</li>
<li>
<span>I</span>
Show mixin list
</li>
<li>
<span>F</span>
Show file list
</li>
<li>
<span>M</span>
Show method list
</li>
<li>
<span>E</span>
Show extras list
</li>
</ul>
<p>
You can focus and blur the search input:
</p>
<ul>
<li>
<span>S</span>
Focus search input
</li>
<li>
<span>Esc</span>
Blur search input
</li>
</ul>
</div>
</body>
</html>