helium-ruby 0.21.0 → 0.22.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/README.md +39 -4
- data/docs/Helium.html +2 -2
- data/docs/Helium/Client.html +3 -3
- data/docs/Helium/Client/Configurations.html +1 -1
- data/docs/Helium/Client/DeviceConfigurations.html +1 -1
- data/docs/Helium/Client/Elements.html +1 -1
- data/docs/Helium/Client/Http.html +222 -39
- data/docs/Helium/Client/Labels.html +1 -1
- data/docs/Helium/Client/Organizations.html +1 -1
- data/docs/Helium/Client/Sensors.html +77 -5
- data/docs/Helium/Client/Users.html +1 -1
- data/docs/Helium/ClientError.html +1 -1
- data/docs/Helium/Collection.html +4 -4
- data/docs/Helium/Configuration.html +1 -1
- data/docs/Helium/Cursor.html +1 -1
- data/docs/Helium/DataPoint.html +1 -1
- data/docs/Helium/DeviceConfiguration.html +1 -1
- data/docs/Helium/Element.html +1 -1
- data/docs/Helium/Error.html +1 -1
- data/docs/Helium/InvalidApiKey.html +1 -1
- data/docs/Helium/Label.html +1 -1
- data/docs/Helium/Metadata.html +1 -1
- data/docs/Helium/Organization.html +1 -1
- data/docs/Helium/Resource.html +1 -1
- data/docs/Helium/Sensor.html +91 -15
- data/docs/Helium/Timeseries.html +1 -1
- data/docs/Helium/User.html +1 -1
- data/docs/Helium/Utils.html +1 -1
- data/docs/_index.html +1 -1
- data/docs/file.README.html +36 -4
- data/docs/index.html +36 -4
- data/docs/method_list.html +137 -113
- data/docs/top-level-namespace.html +1 -1
- data/lib/helium/client/http.rb +51 -9
- data/lib/helium/client/sensors.rb +14 -0
- data/lib/helium/collection.rb +2 -2
- data/lib/helium/sensor.rb +16 -0
- data/lib/helium/version.rb +1 -1
- metadata +2 -2
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA1:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 9a1c3528079c29fb5ecbbd5d094a35be35307a74
|
4
|
+
data.tar.gz: 2c668cc1dadc8cc231cf7186b385a2c2f308d586
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: f99d27ae04c82ec7e880b6c93a227f7de11eb7fee9091f16644467beabbf900b6edcc0f44447c5d67d8572c6833e7664a0dfb6c4fce80557ca9a4deacb2c96be
|
7
|
+
data.tar.gz: 2d5883f2ad98e90cbc2764f0efb6af732b4453a04c112265262f1c4abb024089ccb4651fa3685290bebae130bb260a089934a20dadcce68f00e920b77ed3503b
|
data/README.md
CHANGED
@@ -8,14 +8,15 @@
|
|
8
8
|
A Ruby gem for building applications with the Helium API. [Helium](https://www.helium.com/) is an integrated platform of smart sensors, communication, edge and cloud compute that enables numerous sensing applications. For more information about the underlying REST API, check out [the Helium docs](https://docs.helium.com/).
|
9
9
|
|
10
10
|
|
11
|
-
##
|
11
|
+
## Developer and Community Support
|
12
12
|
|
13
|
+
* **Helium Developer** Complete Helium developer resources can be found at [dev.helium.com](https://dev.helium.com).
|
13
14
|
|
14
|
-
* **helium-
|
15
|
+
* **chat.helium.com** - If you have questions or ideas about how to use this code - or any part of Helium - head over the [chat.helium.com](http://chat.helium.com). We're standing by to help.
|
16
|
+
|
17
|
+
* **helium-ruby docs** - Documentation for the gem's source can be found [here](https://helium.github.io/helium-ruby/).
|
15
18
|
|
16
|
-
* **Helium Docs** Complete documenation for all parts of Helium can be found at [docs.helium.com](https://docs/helium.com).
|
17
19
|
|
18
|
-
* **chat.helium.com** - If you have questions or ideas about how to use this code - or any part of Helium - head over the [chat.helium.com](http://chat.helium.com). We're standing by to help.
|
19
20
|
|
20
21
|
|
21
22
|
## Installation
|
@@ -185,6 +186,40 @@ data_points.first.avg
|
|
185
186
|
|
186
187
|
A full list of aggregation types and sizes can be found here: https://docs.helium.com/docs/timeseries#aggregations.
|
187
188
|
|
189
|
+
#### Live Timeseries data
|
190
|
+
|
191
|
+
If you're building a real-time application with Helium's API, you can stream live timeseries data from a sesnor.
|
192
|
+
|
193
|
+
```ruby
|
194
|
+
sensor.live_timeseries do |data_point|
|
195
|
+
puts "timestamp: #{data_point.timestamp}"
|
196
|
+
puts "port: #{data_point.port}"
|
197
|
+
puts "value: #{data_point.value}"}
|
198
|
+
end
|
199
|
+
# => timestamp: 2017-02-09T23:29:42+00:00
|
200
|
+
# port: t
|
201
|
+
# value: 14.17
|
202
|
+
# timestamp: 2017-02-09T23:29:42+00:00
|
203
|
+
# port: h
|
204
|
+
# value: 93.0
|
205
|
+
# timestamp: 2017-02-09T23:29:42+00:00
|
206
|
+
# port: p
|
207
|
+
# value: 101173.0
|
208
|
+
```
|
209
|
+
|
210
|
+
You can also filter live timeseries data by port, same as demonstrated above.
|
211
|
+
|
212
|
+
```ruby
|
213
|
+
sensor.live_timeseries(port: 't') do |data_point|
|
214
|
+
puts "timestamp: #{data_point.timestamp}"
|
215
|
+
puts "port: #{data_point.port}"
|
216
|
+
puts "value: #{data_point.value}"}
|
217
|
+
end
|
218
|
+
# => timestamp: 2017-02-09T23:24:41+00:00
|
219
|
+
# port: t
|
220
|
+
# value: 14.19
|
221
|
+
```
|
222
|
+
|
188
223
|
#### Creating Timeseries data
|
189
224
|
|
190
225
|
Data points can be written to a sensor's timeseries data.
|
data/docs/Helium.html
CHANGED
@@ -106,7 +106,7 @@
|
|
106
106
|
<dt id="VERSION-constant" class="">VERSION =
|
107
107
|
|
108
108
|
</dt>
|
109
|
-
<dd><pre class="code"><span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>0.
|
109
|
+
<dd><pre class="code"><span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>0.21.0</span><span class='tstring_end'>"</span></span></pre></dd>
|
110
110
|
|
111
111
|
</dl>
|
112
112
|
|
@@ -121,7 +121,7 @@
|
|
121
121
|
</div>
|
122
122
|
|
123
123
|
<div id="footer">
|
124
|
-
Generated on
|
124
|
+
Generated on Mon Feb 13 09:17:41 2017 by
|
125
125
|
<a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
|
126
126
|
0.9.5 (ruby-2.3.1).
|
127
127
|
</div>
|
data/docs/Helium/Client.html
CHANGED
@@ -316,7 +316,7 @@
|
|
316
316
|
|
317
317
|
|
318
318
|
<h3 class="inherited">Methods included from <span class='object_link'><a href="Client/Sensors.html" title="Helium::Client::Sensors (module)">Sensors</a></span></h3>
|
319
|
-
<p class="inherited"><span class='object_link'><a href="Client/Sensors.html#create_sensor-instance_method" title="Helium::Client::Sensors#create_sensor (method)">#create_sensor</a></span>, <span class='object_link'><a href="Client/Sensors.html#sensor-instance_method" title="Helium::Client::Sensors#sensor (method)">#sensor</a></span>, <span class='object_link'><a href="Client/Sensors.html#sensor_device_configuration-instance_method" title="Helium::Client::Sensors#sensor_device_configuration (method)">#sensor_device_configuration</a></span>, <span class='object_link'><a href="Client/Sensors.html#sensor_element-instance_method" title="Helium::Client::Sensors#sensor_element (method)">#sensor_element</a></span>, <span class='object_link'><a href="Client/Sensors.html#sensor_timeseries-instance_method" title="Helium::Client::Sensors#sensor_timeseries (method)">#sensor_timeseries</a></span>, <span class='object_link'><a href="Client/Sensors.html#sensors-instance_method" title="Helium::Client::Sensors#sensors (method)">#sensors</a></span></p>
|
319
|
+
<p class="inherited"><span class='object_link'><a href="Client/Sensors.html#create_sensor-instance_method" title="Helium::Client::Sensors#create_sensor (method)">#create_sensor</a></span>, <span class='object_link'><a href="Client/Sensors.html#sensor-instance_method" title="Helium::Client::Sensors#sensor (method)">#sensor</a></span>, <span class='object_link'><a href="Client/Sensors.html#sensor_device_configuration-instance_method" title="Helium::Client::Sensors#sensor_device_configuration (method)">#sensor_device_configuration</a></span>, <span class='object_link'><a href="Client/Sensors.html#sensor_element-instance_method" title="Helium::Client::Sensors#sensor_element (method)">#sensor_element</a></span>, <span class='object_link'><a href="Client/Sensors.html#sensor_live_timeseries-instance_method" title="Helium::Client::Sensors#sensor_live_timeseries (method)">#sensor_live_timeseries</a></span>, <span class='object_link'><a href="Client/Sensors.html#sensor_timeseries-instance_method" title="Helium::Client::Sensors#sensor_timeseries (method)">#sensor_timeseries</a></span>, <span class='object_link'><a href="Client/Sensors.html#sensors-instance_method" title="Helium::Client::Sensors#sensors (method)">#sensors</a></span></p>
|
320
320
|
|
321
321
|
|
322
322
|
|
@@ -349,7 +349,7 @@
|
|
349
349
|
|
350
350
|
|
351
351
|
<h3 class="inherited">Methods included from <span class='object_link'><a href="Client/Http.html" title="Helium::Client::Http (module)">Http</a></span></h3>
|
352
|
-
<p class="inherited"><span class='object_link'><a href="Client/Http.html#base_url-instance_method" title="Helium::Client::Http#base_url (method)">#base_url</a></span>, <span class='object_link'><a href="Client/Http.html#delete-instance_method" title="Helium::Client::Http#delete (method)">#delete</a></span>, <span class='object_link'><a href="Client/Http.html#get-instance_method" title="Helium::Client::Http#get (method)">#get</a></span>, <span class='object_link'><a href="Client/Http.html#paginated_get-instance_method" title="Helium::Client::Http#paginated_get (method)">#paginated_get</a></span>, <span class='object_link'><a href="Client/Http.html#patch-instance_method" title="Helium::Client::Http#patch (method)">#patch</a></span>, <span class='object_link'><a href="Client/Http.html#post-instance_method" title="Helium::Client::Http#post (method)">#post</a></span>, <span class='object_link'><a href="Client/Http.html#put-instance_method" title="Helium::Client::Http#put (method)">#put</a></span>, <span class='object_link'><a href="Client/Http.html#url_for-instance_method" title="Helium::Client::Http#url_for (method)">#url_for</a></span></p>
|
352
|
+
<p class="inherited"><span class='object_link'><a href="Client/Http.html#base_url-instance_method" title="Helium::Client::Http#base_url (method)">#base_url</a></span>, <span class='object_link'><a href="Client/Http.html#delete-instance_method" title="Helium::Client::Http#delete (method)">#delete</a></span>, <span class='object_link'><a href="Client/Http.html#get-instance_method" title="Helium::Client::Http#get (method)">#get</a></span>, <span class='object_link'><a href="Client/Http.html#paginated_get-instance_method" title="Helium::Client::Http#paginated_get (method)">#paginated_get</a></span>, <span class='object_link'><a href="Client/Http.html#patch-instance_method" title="Helium::Client::Http#patch (method)">#patch</a></span>, <span class='object_link'><a href="Client/Http.html#post-instance_method" title="Helium::Client::Http#post (method)">#post</a></span>, <span class='object_link'><a href="Client/Http.html#put-instance_method" title="Helium::Client::Http#put (method)">#put</a></span>, <span class='object_link'><a href="Client/Http.html#stream_from-instance_method" title="Helium::Client::Http#stream_from (method)">#stream_from</a></span>, <span class='object_link'><a href="Client/Http.html#url_for-instance_method" title="Helium::Client::Http#url_for (method)">#url_for</a></span></p>
|
353
353
|
|
354
354
|
|
355
355
|
|
@@ -555,7 +555,7 @@
|
|
555
555
|
</div>
|
556
556
|
|
557
557
|
<div id="footer">
|
558
|
-
Generated on
|
558
|
+
Generated on Mon Feb 13 09:17:41 2017 by
|
559
559
|
<a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
|
560
560
|
0.9.5 (ruby-2.3.1).
|
561
561
|
</div>
|
@@ -286,7 +286,7 @@
|
|
286
286
|
</div>
|
287
287
|
|
288
288
|
<div id="footer">
|
289
|
-
Generated on
|
289
|
+
Generated on Mon Feb 13 09:17:41 2017 by
|
290
290
|
<a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
|
291
291
|
0.9.5 (ruby-2.3.1).
|
292
292
|
</div>
|
@@ -455,7 +455,7 @@
|
|
455
455
|
</div>
|
456
456
|
|
457
457
|
<div id="footer">
|
458
|
-
Generated on
|
458
|
+
Generated on Mon Feb 13 09:17:41 2017 by
|
459
459
|
<a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
|
460
460
|
0.9.5 (ruby-2.3.1).
|
461
461
|
</div>
|
@@ -365,7 +365,7 @@
|
|
365
365
|
</div>
|
366
366
|
|
367
367
|
<div id="footer">
|
368
|
-
Generated on
|
368
|
+
Generated on Mon Feb 13 09:17:41 2017 by
|
369
369
|
<a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
|
370
370
|
0.9.5 (ruby-2.3.1).
|
371
371
|
</div>
|
@@ -98,8 +98,6 @@
|
|
98
98
|
|
99
99
|
</dt>
|
100
100
|
<dd><pre class="code"><span class='lbrace'>{</span>
|
101
|
-
<span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>Accept</span><span class='tstring_end'>'</span></span> <span class='op'>=></span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>application/json</span><span class='tstring_end'>'</span></span><span class='comma'>,</span>
|
102
|
-
<span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>Content-Type</span><span class='tstring_end'>'</span></span> <span class='op'>=></span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>application/json</span><span class='tstring_end'>'</span></span><span class='comma'>,</span>
|
103
101
|
<span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>User-Agent</span><span class='tstring_end'>'</span></span> <span class='op'>=></span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>helium-ruby</span><span class='tstring_end'>'</span></span>
|
104
102
|
<span class='rbrace'>}</span></pre></dd>
|
105
103
|
|
@@ -270,6 +268,29 @@
|
|
270
268
|
|
271
269
|
<span class="summary_desc"><div class='inline'></div></span>
|
272
270
|
|
271
|
+
</li>
|
272
|
+
|
273
|
+
|
274
|
+
<li class="public ">
|
275
|
+
<span class="summary_signature">
|
276
|
+
|
277
|
+
<a href="#stream_from-instance_method" title="#stream_from (instance method)">#<strong>stream_from</strong>(path, opts = {}) {|Helium::Resource| ... } ⇒ Object </a>
|
278
|
+
|
279
|
+
|
280
|
+
|
281
|
+
</span>
|
282
|
+
|
283
|
+
|
284
|
+
|
285
|
+
|
286
|
+
|
287
|
+
|
288
|
+
|
289
|
+
|
290
|
+
|
291
|
+
<span class="summary_desc"><div class='inline'><p>Stream data from the provided path.</p>
|
292
|
+
</div></span>
|
293
|
+
|
273
294
|
</li>
|
274
295
|
|
275
296
|
|
@@ -320,14 +341,14 @@
|
|
320
341
|
<pre class="lines">
|
321
342
|
|
322
343
|
|
323
|
-
|
324
|
-
|
325
|
-
|
326
|
-
|
327
|
-
|
344
|
+
63
|
345
|
+
64
|
346
|
+
65
|
347
|
+
66
|
348
|
+
67</pre>
|
328
349
|
</td>
|
329
350
|
<td>
|
330
|
-
<pre class="code"><span class="info file"># File 'lib/helium/client/http.rb', line
|
351
|
+
<pre class="code"><span class="info file"># File 'lib/helium/client/http.rb', line 63</span>
|
331
352
|
|
332
353
|
<span class='kw'>def</span> <span class='id identifier rubyid_base_url'>base_url</span>
|
333
354
|
<span class='id identifier rubyid_url'>url</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='embexpr_beg'>#{</span><span class='const'>PROTOCOL</span><span class='embexpr_end'>}</span><span class='tstring_content'>://</span><span class='embexpr_beg'>#{</span><span class='ivar'>@api_host</span><span class='embexpr_end'>}</span><span class='tstring_end'>"</span></span>
|
@@ -354,13 +375,13 @@
|
|
354
375
|
<pre class="lines">
|
355
376
|
|
356
377
|
|
378
|
+
32
|
379
|
+
33
|
357
380
|
34
|
358
|
-
35
|
359
|
-
36
|
360
|
-
37</pre>
|
381
|
+
35</pre>
|
361
382
|
</td>
|
362
383
|
<td>
|
363
|
-
<pre class="code"><span class="info file"># File 'lib/helium/client/http.rb', line
|
384
|
+
<pre class="code"><span class="info file"># File 'lib/helium/client/http.rb', line 32</span>
|
364
385
|
|
365
386
|
<span class='kw'>def</span> <span class='id identifier rubyid_delete'>delete</span><span class='lparen'>(</span><span class='id identifier rubyid_path'>path</span><span class='rparen'>)</span>
|
366
387
|
<span class='id identifier rubyid_response'>response</span> <span class='op'>=</span> <span class='id identifier rubyid_run'>run</span><span class='lparen'>(</span><span class='id identifier rubyid_path'>path</span><span class='comma'>,</span> <span class='symbol'>:delete</span><span class='rparen'>)</span>
|
@@ -386,12 +407,12 @@
|
|
386
407
|
<pre class="lines">
|
387
408
|
|
388
409
|
|
389
|
-
|
390
|
-
|
391
|
-
|
410
|
+
8
|
411
|
+
9
|
412
|
+
10</pre>
|
392
413
|
</td>
|
393
414
|
<td>
|
394
|
-
<pre class="code"><span class="info file"># File 'lib/helium/client/http.rb', line
|
415
|
+
<pre class="code"><span class="info file"># File 'lib/helium/client/http.rb', line 8</span>
|
395
416
|
|
396
417
|
<span class='kw'>def</span> <span class='id identifier rubyid_get'>get</span><span class='lparen'>(</span><span class='id identifier rubyid_path'>path</span><span class='comma'>,</span> <span class='id identifier rubyid_opts'>opts</span> <span class='op'>=</span> <span class='lbrace'>{</span><span class='rbrace'>}</span><span class='rparen'>)</span>
|
397
418
|
<span class='id identifier rubyid_run'>run</span><span class='lparen'>(</span><span class='id identifier rubyid_path'>path</span><span class='comma'>,</span> <span class='symbol'>:get</span><span class='comma'>,</span> <span class='id identifier rubyid_opts'>opts</span><span class='rparen'>)</span>
|
@@ -416,16 +437,16 @@
|
|
416
437
|
<pre class="lines">
|
417
438
|
|
418
439
|
|
440
|
+
12
|
441
|
+
13
|
419
442
|
14
|
420
443
|
15
|
421
444
|
16
|
422
445
|
17
|
423
|
-
18
|
424
|
-
19
|
425
|
-
20</pre>
|
446
|
+
18</pre>
|
426
447
|
</td>
|
427
448
|
<td>
|
428
|
-
<pre class="code"><span class="info file"># File 'lib/helium/client/http.rb', line
|
449
|
+
<pre class="code"><span class="info file"># File 'lib/helium/client/http.rb', line 12</span>
|
429
450
|
|
430
451
|
<span class='kw'>def</span> <span class='id identifier rubyid_paginated_get'>paginated_get</span><span class='lparen'>(</span><span class='id identifier rubyid_path'>path</span><span class='comma'>,</span> <span class='id identifier rubyid_opts'>opts</span> <span class='op'>=</span> <span class='lbrace'>{</span><span class='rbrace'>}</span><span class='rparen'>)</span>
|
431
452
|
<span class='id identifier rubyid_klass'>klass</span> <span class='op'>=</span> <span class='id identifier rubyid_opts'>opts</span><span class='period'>.</span><span class='id identifier rubyid_fetch'>fetch</span><span class='lparen'>(</span><span class='symbol'>:klass</span><span class='rparen'>)</span>
|
@@ -454,12 +475,12 @@
|
|
454
475
|
<pre class="lines">
|
455
476
|
|
456
477
|
|
457
|
-
|
458
|
-
|
459
|
-
|
478
|
+
24
|
479
|
+
25
|
480
|
+
26</pre>
|
460
481
|
</td>
|
461
482
|
<td>
|
462
|
-
<pre class="code"><span class="info file"># File 'lib/helium/client/http.rb', line
|
483
|
+
<pre class="code"><span class="info file"># File 'lib/helium/client/http.rb', line 24</span>
|
463
484
|
|
464
485
|
<span class='kw'>def</span> <span class='id identifier rubyid_patch'>patch</span><span class='lparen'>(</span><span class='id identifier rubyid_path'>path</span><span class='comma'>,</span> <span class='id identifier rubyid_opts'>opts</span> <span class='op'>=</span> <span class='lbrace'>{</span><span class='rbrace'>}</span><span class='rparen'>)</span>
|
465
486
|
<span class='id identifier rubyid_run'>run</span><span class='lparen'>(</span><span class='id identifier rubyid_path'>path</span><span class='comma'>,</span> <span class='symbol'>:patch</span><span class='comma'>,</span> <span class='id identifier rubyid_opts'>opts</span><span class='rparen'>)</span>
|
@@ -484,12 +505,12 @@
|
|
484
505
|
<pre class="lines">
|
485
506
|
|
486
507
|
|
487
|
-
|
488
|
-
|
489
|
-
|
508
|
+
20
|
509
|
+
21
|
510
|
+
22</pre>
|
490
511
|
</td>
|
491
512
|
<td>
|
492
|
-
<pre class="code"><span class="info file"># File 'lib/helium/client/http.rb', line
|
513
|
+
<pre class="code"><span class="info file"># File 'lib/helium/client/http.rb', line 20</span>
|
493
514
|
|
494
515
|
<span class='kw'>def</span> <span class='id identifier rubyid_post'>post</span><span class='lparen'>(</span><span class='id identifier rubyid_path'>path</span><span class='comma'>,</span> <span class='id identifier rubyid_opts'>opts</span> <span class='op'>=</span> <span class='lbrace'>{</span><span class='rbrace'>}</span><span class='rparen'>)</span>
|
495
516
|
<span class='id identifier rubyid_run'>run</span><span class='lparen'>(</span><span class='id identifier rubyid_path'>path</span><span class='comma'>,</span> <span class='symbol'>:post</span><span class='comma'>,</span> <span class='id identifier rubyid_opts'>opts</span><span class='rparen'>)</span>
|
@@ -514,12 +535,12 @@
|
|
514
535
|
<pre class="lines">
|
515
536
|
|
516
537
|
|
517
|
-
|
518
|
-
|
519
|
-
|
538
|
+
28
|
539
|
+
29
|
540
|
+
30</pre>
|
520
541
|
</td>
|
521
542
|
<td>
|
522
|
-
<pre class="code"><span class="info file"># File 'lib/helium/client/http.rb', line
|
543
|
+
<pre class="code"><span class="info file"># File 'lib/helium/client/http.rb', line 28</span>
|
523
544
|
|
524
545
|
<span class='kw'>def</span> <span class='id identifier rubyid_put'>put</span><span class='lparen'>(</span><span class='id identifier rubyid_path'>path</span><span class='comma'>,</span> <span class='id identifier rubyid_opts'>opts</span> <span class='op'>=</span> <span class='lbrace'>{</span><span class='rbrace'>}</span><span class='rparen'>)</span>
|
525
546
|
<span class='id identifier rubyid_run'>run</span><span class='lparen'>(</span><span class='id identifier rubyid_path'>path</span><span class='comma'>,</span> <span class='symbol'>:put</span><span class='comma'>,</span> <span class='id identifier rubyid_opts'>opts</span><span class='rparen'>)</span>
|
@@ -530,9 +551,9 @@
|
|
530
551
|
</div>
|
531
552
|
|
532
553
|
<div class="method_details ">
|
533
|
-
<h3 class="signature " id="
|
554
|
+
<h3 class="signature " id="stream_from-instance_method">
|
534
555
|
|
535
|
-
#<strong>
|
556
|
+
#<strong>stream_from</strong>(path, opts = {}) {|Helium::Resource| ... } ⇒ <tt>Object</tt>
|
536
557
|
|
537
558
|
|
538
559
|
|
@@ -540,14 +561,101 @@
|
|
540
561
|
|
541
562
|
</h3><div class="docstring">
|
542
563
|
<div class="discussion">
|
543
|
-
<p>
|
544
|
-
it will simply pass through</p>
|
564
|
+
<p>Stream data from the provided path</p>
|
545
565
|
|
546
566
|
|
547
567
|
</div>
|
548
568
|
</div>
|
549
569
|
<div class="tags">
|
570
|
+
<p class="tag_title">Parameters:</p>
|
571
|
+
<ul class="param">
|
550
572
|
|
573
|
+
<li>
|
574
|
+
|
575
|
+
<span class='name'>path</span>
|
576
|
+
|
577
|
+
|
578
|
+
<span class='type'>(<tt>String</tt>)</span>
|
579
|
+
|
580
|
+
|
581
|
+
|
582
|
+
—
|
583
|
+
<div class='inline'><p>a relative path</p>
|
584
|
+
</div>
|
585
|
+
|
586
|
+
</li>
|
587
|
+
|
588
|
+
<li>
|
589
|
+
|
590
|
+
<span class='name'>opts</span>
|
591
|
+
|
592
|
+
|
593
|
+
<span class='type'>(<tt>Hash</tt>)</span>
|
594
|
+
|
595
|
+
|
596
|
+
<em class="default">(defaults to: <tt>{}</tt>)</em>
|
597
|
+
|
598
|
+
|
599
|
+
—
|
600
|
+
<div class='inline'><p>a customizable set of options</p>
|
601
|
+
</div>
|
602
|
+
|
603
|
+
</li>
|
604
|
+
|
605
|
+
</ul>
|
606
|
+
|
607
|
+
|
608
|
+
|
609
|
+
|
610
|
+
|
611
|
+
|
612
|
+
<p class="tag_title">Options Hash (<tt>opts</tt>):</p>
|
613
|
+
<ul class="option">
|
614
|
+
|
615
|
+
<li>
|
616
|
+
<span class="name">:klass</span>
|
617
|
+
<span class="type">(<tt>Class</tt>)</span>
|
618
|
+
<span class="default">
|
619
|
+
|
620
|
+
</span>
|
621
|
+
|
622
|
+
— <div class='inline'><p>a class to be initialized with received data</p>
|
623
|
+
</div>
|
624
|
+
|
625
|
+
</li>
|
626
|
+
|
627
|
+
<li>
|
628
|
+
<span class="name">:params</span>
|
629
|
+
<span class="type">(<tt>Hash</tt>)</span>
|
630
|
+
<span class="default">
|
631
|
+
|
632
|
+
</span>
|
633
|
+
|
634
|
+
— <div class='inline'><p>a hash of params to be used as query params</p>
|
635
|
+
</div>
|
636
|
+
|
637
|
+
</li>
|
638
|
+
|
639
|
+
</ul>
|
640
|
+
|
641
|
+
|
642
|
+
<p class="tag_title">Yields:</p>
|
643
|
+
<ul class="yield">
|
644
|
+
|
645
|
+
<li>
|
646
|
+
|
647
|
+
|
648
|
+
<span class='type'>(<tt><span class='object_link'><a href="../Resource.html" title="Helium::Resource (class)">Helium::Resource</a></span></tt>)</span>
|
649
|
+
|
650
|
+
|
651
|
+
|
652
|
+
—
|
653
|
+
<div class='inline'><p>accepts logic to perform on the initialized Helium::Resource class</p>
|
654
|
+
</div>
|
655
|
+
|
656
|
+
</li>
|
657
|
+
|
658
|
+
</ul>
|
551
659
|
|
552
660
|
</div><table class="source_code">
|
553
661
|
<tr>
|
@@ -555,15 +663,90 @@ it will simply pass through</p>
|
|
555
663
|
<pre class="lines">
|
556
664
|
|
557
665
|
|
666
|
+
42
|
667
|
+
43
|
668
|
+
44
|
669
|
+
45
|
670
|
+
46
|
558
671
|
47
|
559
672
|
48
|
560
673
|
49
|
561
674
|
50
|
562
675
|
51
|
563
|
-
52
|
676
|
+
52
|
677
|
+
53
|
678
|
+
54
|
679
|
+
55
|
680
|
+
56
|
681
|
+
57
|
682
|
+
58
|
683
|
+
59
|
684
|
+
60
|
685
|
+
61</pre>
|
686
|
+
</td>
|
687
|
+
<td>
|
688
|
+
<pre class="code"><span class="info file"># File 'lib/helium/client/http.rb', line 42</span>
|
689
|
+
|
690
|
+
<span class='kw'>def</span> <span class='id identifier rubyid_stream_from'>stream_from</span><span class='lparen'>(</span><span class='id identifier rubyid_path'>path</span><span class='comma'>,</span> <span class='id identifier rubyid_opts'>opts</span> <span class='op'>=</span> <span class='lbrace'>{</span><span class='rbrace'>}</span><span class='comma'>,</span> <span class='op'>&</span><span class='id identifier rubyid_block'>block</span><span class='rparen'>)</span>
|
691
|
+
<span class='id identifier rubyid_klass'>klass</span> <span class='op'>=</span> <span class='id identifier rubyid_opts'>opts</span><span class='period'>.</span><span class='id identifier rubyid_fetch'>fetch</span><span class='lparen'>(</span><span class='symbol'>:klass</span><span class='rparen'>)</span>
|
692
|
+
<span class='id identifier rubyid_params'>params</span> <span class='op'>=</span> <span class='id identifier rubyid_opts'>opts</span><span class='period'>.</span><span class='id identifier rubyid_fetch'>fetch</span><span class='lparen'>(</span><span class='symbol'>:params</span><span class='comma'>,</span> <span class='lbrace'>{</span><span class='rbrace'>}</span><span class='rparen'>)</span>
|
693
|
+
<span class='id identifier rubyid_request'>request</span> <span class='op'>=</span> <span class='id identifier rubyid_generate_request'>generate_request</span><span class='lparen'>(</span><span class='id identifier rubyid_path'>path</span><span class='comma'>,</span> <span class='lbrace'>{</span>
|
694
|
+
<span class='label'>method:</span> <span class='symbol'>:get</span><span class='comma'>,</span>
|
695
|
+
<span class='label'>content_type:</span> <span class='symbol'>:stream</span><span class='comma'>,</span>
|
696
|
+
<span class='label'>params:</span> <span class='id identifier rubyid_params'>params</span>
|
697
|
+
<span class='rbrace'>}</span><span class='rparen'>)</span>
|
698
|
+
|
699
|
+
<span class='id identifier rubyid_request'>request</span><span class='period'>.</span><span class='id identifier rubyid_on_body'>on_body</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_chunk'>chunk</span><span class='op'>|</span>
|
700
|
+
<span class='kw'>if</span> <span class='id identifier rubyid_chunk'>chunk</span> <span class='op'>=~</span> <span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>data:</span><span class='regexp_end'>/</span></span>
|
701
|
+
<span class='id identifier rubyid_json_string'>json_string</span> <span class='op'>=</span> <span class='id identifier rubyid_chunk'>chunk</span><span class='lbracket'>[</span><span class='id identifier rubyid_chunk'>chunk</span><span class='period'>.</span><span class='id identifier rubyid_index'>index</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>{</span><span class='tstring_end'>'</span></span><span class='rparen'>)</span><span class='op'>..</span><span class='id identifier rubyid_chunk'>chunk</span><span class='period'>.</span><span class='id identifier rubyid_rindex'>rindex</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>}</span><span class='tstring_end'>'</span></span><span class='rparen'>)</span><span class='rbracket'>]</span>
|
702
|
+
<span class='id identifier rubyid_json_data'>json_data</span> <span class='op'>=</span> <span class='const'>JSON</span><span class='period'>.</span><span class='id identifier rubyid_parse'>parse</span><span class='lparen'>(</span><span class='id identifier rubyid_json_string'>json_string</span><span class='rparen'>)</span><span class='lbracket'>[</span><span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>data</span><span class='tstring_end'>"</span></span><span class='rbracket'>]</span>
|
703
|
+
<span class='id identifier rubyid_object'>object</span> <span class='op'>=</span> <span class='id identifier rubyid_klass'>klass</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='label'>client:</span> <span class='kw'>self</span><span class='comma'>,</span> <span class='label'>params:</span> <span class='id identifier rubyid_json_data'>json_data</span><span class='rparen'>)</span>
|
704
|
+
<span class='kw'>yield</span> <span class='id identifier rubyid_object'>object</span>
|
705
|
+
<span class='kw'>end</span>
|
706
|
+
<span class='kw'>end</span>
|
707
|
+
|
708
|
+
<span class='id identifier rubyid_run_request'>run_request</span><span class='lparen'>(</span><span class='id identifier rubyid_request'>request</span><span class='rparen'>)</span>
|
709
|
+
<span class='kw'>end</span></pre>
|
710
|
+
</td>
|
711
|
+
</tr>
|
712
|
+
</table>
|
713
|
+
</div>
|
714
|
+
|
715
|
+
<div class="method_details ">
|
716
|
+
<h3 class="signature " id="url_for-instance_method">
|
717
|
+
|
718
|
+
#<strong>url_for</strong>(path) ⇒ <tt>Object</tt>
|
719
|
+
|
720
|
+
|
721
|
+
|
722
|
+
|
723
|
+
|
724
|
+
</h3><div class="docstring">
|
725
|
+
<div class="discussion">
|
726
|
+
<p>Contructs a proper url given a path. If the path is already a full url
|
727
|
+
it will simply pass through</p>
|
728
|
+
|
729
|
+
|
730
|
+
</div>
|
731
|
+
</div>
|
732
|
+
<div class="tags">
|
733
|
+
|
734
|
+
|
735
|
+
</div><table class="source_code">
|
736
|
+
<tr>
|
737
|
+
<td>
|
738
|
+
<pre class="lines">
|
739
|
+
|
740
|
+
|
741
|
+
71
|
742
|
+
72
|
743
|
+
73
|
744
|
+
74
|
745
|
+
75
|
746
|
+
76</pre>
|
564
747
|
</td>
|
565
748
|
<td>
|
566
|
-
<pre class="code"><span class="info file"># File 'lib/helium/client/http.rb', line
|
749
|
+
<pre class="code"><span class="info file"># File 'lib/helium/client/http.rb', line 71</span>
|
567
750
|
|
568
751
|
<span class='kw'>def</span> <span class='id identifier rubyid_url_for'>url_for</span><span class='lparen'>(</span><span class='id identifier rubyid_path'>path</span><span class='rparen'>)</span>
|
569
752
|
<span class='kw'>return</span> <span class='id identifier rubyid_path'>path</span> <span class='kw'>if</span> <span class='id identifier rubyid_path'>path</span> <span class='op'>=~</span> <span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>^http</span><span class='regexp_end'>/</span></span>
|
@@ -581,7 +764,7 @@ it will simply pass through</p>
|
|
581
764
|
</div>
|
582
765
|
|
583
766
|
<div id="footer">
|
584
|
-
Generated on
|
767
|
+
Generated on Mon Feb 13 09:17:41 2017 by
|
585
768
|
<a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
|
586
769
|
0.9.5 (ruby-2.3.1).
|
587
770
|
</div>
|