helium-ruby 0.21.0 → 0.22.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- 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>
|