particlerb 0.0.3 → 0.0.4
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/LICENSE.txt +159 -668
- data/README.md +48 -6
- data/Rakefile +37 -0
- data/lib/particle/client/devices.rb +1 -6
- data/lib/particle/client/firmware.rb +4 -15
- data/lib/particle/connection.rb +16 -13
- data/lib/particle/device.rb +11 -1
- data/lib/particle/version.rb +1 -1
- data/particlerb.gemspec +2 -1
- metadata +17 -3
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA1:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 293150020c9be707c6a09737d8735b5dc5d234f1
|
4
|
+
data.tar.gz: 6af2c264d32e019c7dfa68ad8ad3d3356a9dfb6b
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 0353b5354b550e2d25dd16a5d94bb9f08339f4ae53862ed5bb4468746eec4e1afb52b20a9c1dd1d928278599596f6363b78d6ac24af23ee8360754999e9e5862
|
7
|
+
data.tar.gz: 752736bad1375878aa7a4960057311df6e28fca9074813869956fa24cdfdbc08ecb6efcf4e521ea12e806efa70e5ae62cb3fcaa067f5648a31334beea6a8c181
|
data/LICENSE.txt
CHANGED
@@ -1,674 +1,165 @@
|
|
1
|
-
|
1
|
+
GNU LESSER GENERAL PUBLIC LICENSE
|
2
2
|
Version 3, 29 June 2007
|
3
3
|
|
4
4
|
Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
|
5
5
|
Everyone is permitted to copy and distribute verbatim copies
|
6
6
|
of this license document, but changing it is not allowed.
|
7
7
|
|
8
|
-
|
9
|
-
|
10
|
-
|
11
|
-
|
12
|
-
|
13
|
-
|
14
|
-
|
15
|
-
|
16
|
-
|
17
|
-
|
18
|
-
|
19
|
-
|
20
|
-
|
21
|
-
|
22
|
-
|
23
|
-
|
24
|
-
|
25
|
-
|
26
|
-
|
27
|
-
|
28
|
-
|
29
|
-
|
30
|
-
|
31
|
-
|
32
|
-
|
33
|
-
|
34
|
-
|
35
|
-
|
36
|
-
|
37
|
-
|
38
|
-
|
39
|
-
|
40
|
-
|
41
|
-
|
42
|
-
|
43
|
-
|
44
|
-
|
45
|
-
|
46
|
-
|
47
|
-
|
48
|
-
|
49
|
-
|
50
|
-
|
51
|
-
|
52
|
-
|
53
|
-
|
54
|
-
|
55
|
-
|
56
|
-
|
57
|
-
|
58
|
-
|
59
|
-
|
60
|
-
|
61
|
-
|
62
|
-
|
63
|
-
|
64
|
-
|
65
|
-
|
66
|
-
|
67
|
-
|
68
|
-
|
69
|
-
|
70
|
-
|
71
|
-
|
72
|
-
|
73
|
-
|
74
|
-
|
75
|
-
|
76
|
-
|
77
|
-
|
78
|
-
|
79
|
-
|
80
|
-
|
81
|
-
|
82
|
-
|
83
|
-
|
84
|
-
|
85
|
-
|
86
|
-
|
87
|
-
|
88
|
-
|
89
|
-
|
90
|
-
|
91
|
-
|
92
|
-
|
93
|
-
|
94
|
-
|
95
|
-
|
96
|
-
|
97
|
-
|
98
|
-
|
99
|
-
|
100
|
-
|
101
|
-
|
102
|
-
|
103
|
-
|
104
|
-
|
105
|
-
|
106
|
-
|
107
|
-
|
108
|
-
|
109
|
-
|
110
|
-
|
111
|
-
|
112
|
-
|
113
|
-
|
114
|
-
|
115
|
-
|
116
|
-
|
117
|
-
|
118
|
-
|
119
|
-
|
120
|
-
|
121
|
-
|
122
|
-
|
123
|
-
|
124
|
-
|
125
|
-
|
126
|
-
|
127
|
-
|
128
|
-
|
129
|
-
|
130
|
-
|
131
|
-
|
132
|
-
|
133
|
-
|
134
|
-
|
135
|
-
|
136
|
-
|
137
|
-
|
138
|
-
|
139
|
-
|
140
|
-
|
141
|
-
|
142
|
-
|
143
|
-
|
144
|
-
|
145
|
-
|
146
|
-
|
147
|
-
|
148
|
-
|
149
|
-
|
150
|
-
|
151
|
-
|
152
|
-
|
153
|
-
|
154
|
-
|
155
|
-
|
156
|
-
|
157
|
-
|
158
|
-
|
159
|
-
|
160
|
-
|
161
|
-
|
162
|
-
|
163
|
-
|
164
|
-
|
165
|
-
|
166
|
-
in force. You may convey covered works to others for the sole purpose
|
167
|
-
of having them make modifications exclusively for you, or provide you
|
168
|
-
with facilities for running those works, provided that you comply with
|
169
|
-
the terms of this License in conveying all material for which you do
|
170
|
-
not control copyright. Those thus making or running the covered works
|
171
|
-
for you must do so exclusively on your behalf, under your direction
|
172
|
-
and control, on terms that prohibit them from making any copies of
|
173
|
-
your copyrighted material outside their relationship with you.
|
174
|
-
|
175
|
-
Conveying under any other circumstances is permitted solely under
|
176
|
-
the conditions stated below. Sublicensing is not allowed; section 10
|
177
|
-
makes it unnecessary.
|
178
|
-
|
179
|
-
3. Protecting Users' Legal Rights From Anti-Circumvention Law.
|
180
|
-
|
181
|
-
No covered work shall be deemed part of an effective technological
|
182
|
-
measure under any applicable law fulfilling obligations under article
|
183
|
-
11 of the WIPO copyright treaty adopted on 20 December 1996, or
|
184
|
-
similar laws prohibiting or restricting circumvention of such
|
185
|
-
measures.
|
186
|
-
|
187
|
-
When you convey a covered work, you waive any legal power to forbid
|
188
|
-
circumvention of technological measures to the extent such circumvention
|
189
|
-
is effected by exercising rights under this License with respect to
|
190
|
-
the covered work, and you disclaim any intention to limit operation or
|
191
|
-
modification of the work as a means of enforcing, against the work's
|
192
|
-
users, your or third parties' legal rights to forbid circumvention of
|
193
|
-
technological measures.
|
194
|
-
|
195
|
-
4. Conveying Verbatim Copies.
|
196
|
-
|
197
|
-
You may convey verbatim copies of the Program's source code as you
|
198
|
-
receive it, in any medium, provided that you conspicuously and
|
199
|
-
appropriately publish on each copy an appropriate copyright notice;
|
200
|
-
keep intact all notices stating that this License and any
|
201
|
-
non-permissive terms added in accord with section 7 apply to the code;
|
202
|
-
keep intact all notices of the absence of any warranty; and give all
|
203
|
-
recipients a copy of this License along with the Program.
|
204
|
-
|
205
|
-
You may charge any price or no price for each copy that you convey,
|
206
|
-
and you may offer support or warranty protection for a fee.
|
207
|
-
|
208
|
-
5. Conveying Modified Source Versions.
|
209
|
-
|
210
|
-
You may convey a work based on the Program, or the modifications to
|
211
|
-
produce it from the Program, in the form of source code under the
|
212
|
-
terms of section 4, provided that you also meet all of these conditions:
|
213
|
-
|
214
|
-
a) The work must carry prominent notices stating that you modified
|
215
|
-
it, and giving a relevant date.
|
216
|
-
|
217
|
-
b) The work must carry prominent notices stating that it is
|
218
|
-
released under this License and any conditions added under section
|
219
|
-
7. This requirement modifies the requirement in section 4 to
|
220
|
-
"keep intact all notices".
|
221
|
-
|
222
|
-
c) You must license the entire work, as a whole, under this
|
223
|
-
License to anyone who comes into possession of a copy. This
|
224
|
-
License will therefore apply, along with any applicable section 7
|
225
|
-
additional terms, to the whole of the work, and all its parts,
|
226
|
-
regardless of how they are packaged. This License gives no
|
227
|
-
permission to license the work in any other way, but it does not
|
228
|
-
invalidate such permission if you have separately received it.
|
229
|
-
|
230
|
-
d) If the work has interactive user interfaces, each must display
|
231
|
-
Appropriate Legal Notices; however, if the Program has interactive
|
232
|
-
interfaces that do not display Appropriate Legal Notices, your
|
233
|
-
work need not make them do so.
|
234
|
-
|
235
|
-
A compilation of a covered work with other separate and independent
|
236
|
-
works, which are not by their nature extensions of the covered work,
|
237
|
-
and which are not combined with it such as to form a larger program,
|
238
|
-
in or on a volume of a storage or distribution medium, is called an
|
239
|
-
"aggregate" if the compilation and its resulting copyright are not
|
240
|
-
used to limit the access or legal rights of the compilation's users
|
241
|
-
beyond what the individual works permit. Inclusion of a covered work
|
242
|
-
in an aggregate does not cause this License to apply to the other
|
243
|
-
parts of the aggregate.
|
244
|
-
|
245
|
-
6. Conveying Non-Source Forms.
|
246
|
-
|
247
|
-
You may convey a covered work in object code form under the terms
|
248
|
-
of sections 4 and 5, provided that you also convey the
|
249
|
-
machine-readable Corresponding Source under the terms of this License,
|
250
|
-
in one of these ways:
|
251
|
-
|
252
|
-
a) Convey the object code in, or embodied in, a physical product
|
253
|
-
(including a physical distribution medium), accompanied by the
|
254
|
-
Corresponding Source fixed on a durable physical medium
|
255
|
-
customarily used for software interchange.
|
256
|
-
|
257
|
-
b) Convey the object code in, or embodied in, a physical product
|
258
|
-
(including a physical distribution medium), accompanied by a
|
259
|
-
written offer, valid for at least three years and valid for as
|
260
|
-
long as you offer spare parts or customer support for that product
|
261
|
-
model, to give anyone who possesses the object code either (1) a
|
262
|
-
copy of the Corresponding Source for all the software in the
|
263
|
-
product that is covered by this License, on a durable physical
|
264
|
-
medium customarily used for software interchange, for a price no
|
265
|
-
more than your reasonable cost of physically performing this
|
266
|
-
conveying of source, or (2) access to copy the
|
267
|
-
Corresponding Source from a network server at no charge.
|
268
|
-
|
269
|
-
c) Convey individual copies of the object code with a copy of the
|
270
|
-
written offer to provide the Corresponding Source. This
|
271
|
-
alternative is allowed only occasionally and noncommercially, and
|
272
|
-
only if you received the object code with such an offer, in accord
|
273
|
-
with subsection 6b.
|
274
|
-
|
275
|
-
d) Convey the object code by offering access from a designated
|
276
|
-
place (gratis or for a charge), and offer equivalent access to the
|
277
|
-
Corresponding Source in the same way through the same place at no
|
278
|
-
further charge. You need not require recipients to copy the
|
279
|
-
Corresponding Source along with the object code. If the place to
|
280
|
-
copy the object code is a network server, the Corresponding Source
|
281
|
-
may be on a different server (operated by you or a third party)
|
282
|
-
that supports equivalent copying facilities, provided you maintain
|
283
|
-
clear directions next to the object code saying where to find the
|
284
|
-
Corresponding Source. Regardless of what server hosts the
|
285
|
-
Corresponding Source, you remain obligated to ensure that it is
|
286
|
-
available for as long as needed to satisfy these requirements.
|
287
|
-
|
288
|
-
e) Convey the object code using peer-to-peer transmission, provided
|
289
|
-
you inform other peers where the object code and Corresponding
|
290
|
-
Source of the work are being offered to the general public at no
|
291
|
-
charge under subsection 6d.
|
292
|
-
|
293
|
-
A separable portion of the object code, whose source code is excluded
|
294
|
-
from the Corresponding Source as a System Library, need not be
|
295
|
-
included in conveying the object code work.
|
296
|
-
|
297
|
-
A "User Product" is either (1) a "consumer product", which means any
|
298
|
-
tangible personal property which is normally used for personal, family,
|
299
|
-
or household purposes, or (2) anything designed or sold for incorporation
|
300
|
-
into a dwelling. In determining whether a product is a consumer product,
|
301
|
-
doubtful cases shall be resolved in favor of coverage. For a particular
|
302
|
-
product received by a particular user, "normally used" refers to a
|
303
|
-
typical or common use of that class of product, regardless of the status
|
304
|
-
of the particular user or of the way in which the particular user
|
305
|
-
actually uses, or expects or is expected to use, the product. A product
|
306
|
-
is a consumer product regardless of whether the product has substantial
|
307
|
-
commercial, industrial or non-consumer uses, unless such uses represent
|
308
|
-
the only significant mode of use of the product.
|
309
|
-
|
310
|
-
"Installation Information" for a User Product means any methods,
|
311
|
-
procedures, authorization keys, or other information required to install
|
312
|
-
and execute modified versions of a covered work in that User Product from
|
313
|
-
a modified version of its Corresponding Source. The information must
|
314
|
-
suffice to ensure that the continued functioning of the modified object
|
315
|
-
code is in no case prevented or interfered with solely because
|
316
|
-
modification has been made.
|
317
|
-
|
318
|
-
If you convey an object code work under this section in, or with, or
|
319
|
-
specifically for use in, a User Product, and the conveying occurs as
|
320
|
-
part of a transaction in which the right of possession and use of the
|
321
|
-
User Product is transferred to the recipient in perpetuity or for a
|
322
|
-
fixed term (regardless of how the transaction is characterized), the
|
323
|
-
Corresponding Source conveyed under this section must be accompanied
|
324
|
-
by the Installation Information. But this requirement does not apply
|
325
|
-
if neither you nor any third party retains the ability to install
|
326
|
-
modified object code on the User Product (for example, the work has
|
327
|
-
been installed in ROM).
|
328
|
-
|
329
|
-
The requirement to provide Installation Information does not include a
|
330
|
-
requirement to continue to provide support service, warranty, or updates
|
331
|
-
for a work that has been modified or installed by the recipient, or for
|
332
|
-
the User Product in which it has been modified or installed. Access to a
|
333
|
-
network may be denied when the modification itself materially and
|
334
|
-
adversely affects the operation of the network or violates the rules and
|
335
|
-
protocols for communication across the network.
|
336
|
-
|
337
|
-
Corresponding Source conveyed, and Installation Information provided,
|
338
|
-
in accord with this section must be in a format that is publicly
|
339
|
-
documented (and with an implementation available to the public in
|
340
|
-
source code form), and must require no special password or key for
|
341
|
-
unpacking, reading or copying.
|
342
|
-
|
343
|
-
7. Additional Terms.
|
344
|
-
|
345
|
-
"Additional permissions" are terms that supplement the terms of this
|
346
|
-
License by making exceptions from one or more of its conditions.
|
347
|
-
Additional permissions that are applicable to the entire Program shall
|
348
|
-
be treated as though they were included in this License, to the extent
|
349
|
-
that they are valid under applicable law. If additional permissions
|
350
|
-
apply only to part of the Program, that part may be used separately
|
351
|
-
under those permissions, but the entire Program remains governed by
|
352
|
-
this License without regard to the additional permissions.
|
353
|
-
|
354
|
-
When you convey a copy of a covered work, you may at your option
|
355
|
-
remove any additional permissions from that copy, or from any part of
|
356
|
-
it. (Additional permissions may be written to require their own
|
357
|
-
removal in certain cases when you modify the work.) You may place
|
358
|
-
additional permissions on material, added by you to a covered work,
|
359
|
-
for which you have or can give appropriate copyright permission.
|
360
|
-
|
361
|
-
Notwithstanding any other provision of this License, for material you
|
362
|
-
add to a covered work, you may (if authorized by the copyright holders of
|
363
|
-
that material) supplement the terms of this License with terms:
|
364
|
-
|
365
|
-
a) Disclaiming warranty or limiting liability differently from the
|
366
|
-
terms of sections 15 and 16 of this License; or
|
367
|
-
|
368
|
-
b) Requiring preservation of specified reasonable legal notices or
|
369
|
-
author attributions in that material or in the Appropriate Legal
|
370
|
-
Notices displayed by works containing it; or
|
371
|
-
|
372
|
-
c) Prohibiting misrepresentation of the origin of that material, or
|
373
|
-
requiring that modified versions of such material be marked in
|
374
|
-
reasonable ways as different from the original version; or
|
375
|
-
|
376
|
-
d) Limiting the use for publicity purposes of names of licensors or
|
377
|
-
authors of the material; or
|
378
|
-
|
379
|
-
e) Declining to grant rights under trademark law for use of some
|
380
|
-
trade names, trademarks, or service marks; or
|
381
|
-
|
382
|
-
f) Requiring indemnification of licensors and authors of that
|
383
|
-
material by anyone who conveys the material (or modified versions of
|
384
|
-
it) with contractual assumptions of liability to the recipient, for
|
385
|
-
any liability that these contractual assumptions directly impose on
|
386
|
-
those licensors and authors.
|
387
|
-
|
388
|
-
All other non-permissive additional terms are considered "further
|
389
|
-
restrictions" within the meaning of section 10. If the Program as you
|
390
|
-
received it, or any part of it, contains a notice stating that it is
|
391
|
-
governed by this License along with a term that is a further
|
392
|
-
restriction, you may remove that term. If a license document contains
|
393
|
-
a further restriction but permits relicensing or conveying under this
|
394
|
-
License, you may add to a covered work material governed by the terms
|
395
|
-
of that license document, provided that the further restriction does
|
396
|
-
not survive such relicensing or conveying.
|
397
|
-
|
398
|
-
If you add terms to a covered work in accord with this section, you
|
399
|
-
must place, in the relevant source files, a statement of the
|
400
|
-
additional terms that apply to those files, or a notice indicating
|
401
|
-
where to find the applicable terms.
|
402
|
-
|
403
|
-
Additional terms, permissive or non-permissive, may be stated in the
|
404
|
-
form of a separately written license, or stated as exceptions;
|
405
|
-
the above requirements apply either way.
|
406
|
-
|
407
|
-
8. Termination.
|
408
|
-
|
409
|
-
You may not propagate or modify a covered work except as expressly
|
410
|
-
provided under this License. Any attempt otherwise to propagate or
|
411
|
-
modify it is void, and will automatically terminate your rights under
|
412
|
-
this License (including any patent licenses granted under the third
|
413
|
-
paragraph of section 11).
|
414
|
-
|
415
|
-
However, if you cease all violation of this License, then your
|
416
|
-
license from a particular copyright holder is reinstated (a)
|
417
|
-
provisionally, unless and until the copyright holder explicitly and
|
418
|
-
finally terminates your license, and (b) permanently, if the copyright
|
419
|
-
holder fails to notify you of the violation by some reasonable means
|
420
|
-
prior to 60 days after the cessation.
|
421
|
-
|
422
|
-
Moreover, your license from a particular copyright holder is
|
423
|
-
reinstated permanently if the copyright holder notifies you of the
|
424
|
-
violation by some reasonable means, this is the first time you have
|
425
|
-
received notice of violation of this License (for any work) from that
|
426
|
-
copyright holder, and you cure the violation prior to 30 days after
|
427
|
-
your receipt of the notice.
|
428
|
-
|
429
|
-
Termination of your rights under this section does not terminate the
|
430
|
-
licenses of parties who have received copies or rights from you under
|
431
|
-
this License. If your rights have been terminated and not permanently
|
432
|
-
reinstated, you do not qualify to receive new licenses for the same
|
433
|
-
material under section 10.
|
434
|
-
|
435
|
-
9. Acceptance Not Required for Having Copies.
|
436
|
-
|
437
|
-
You are not required to accept this License in order to receive or
|
438
|
-
run a copy of the Program. Ancillary propagation of a covered work
|
439
|
-
occurring solely as a consequence of using peer-to-peer transmission
|
440
|
-
to receive a copy likewise does not require acceptance. However,
|
441
|
-
nothing other than this License grants you permission to propagate or
|
442
|
-
modify any covered work. These actions infringe copyright if you do
|
443
|
-
not accept this License. Therefore, by modifying or propagating a
|
444
|
-
covered work, you indicate your acceptance of this License to do so.
|
445
|
-
|
446
|
-
10. Automatic Licensing of Downstream Recipients.
|
447
|
-
|
448
|
-
Each time you convey a covered work, the recipient automatically
|
449
|
-
receives a license from the original licensors, to run, modify and
|
450
|
-
propagate that work, subject to this License. You are not responsible
|
451
|
-
for enforcing compliance by third parties with this License.
|
452
|
-
|
453
|
-
An "entity transaction" is a transaction transferring control of an
|
454
|
-
organization, or substantially all assets of one, or subdividing an
|
455
|
-
organization, or merging organizations. If propagation of a covered
|
456
|
-
work results from an entity transaction, each party to that
|
457
|
-
transaction who receives a copy of the work also receives whatever
|
458
|
-
licenses to the work the party's predecessor in interest had or could
|
459
|
-
give under the previous paragraph, plus a right to possession of the
|
460
|
-
Corresponding Source of the work from the predecessor in interest, if
|
461
|
-
the predecessor has it or can get it with reasonable efforts.
|
462
|
-
|
463
|
-
You may not impose any further restrictions on the exercise of the
|
464
|
-
rights granted or affirmed under this License. For example, you may
|
465
|
-
not impose a license fee, royalty, or other charge for exercise of
|
466
|
-
rights granted under this License, and you may not initiate litigation
|
467
|
-
(including a cross-claim or counterclaim in a lawsuit) alleging that
|
468
|
-
any patent claim is infringed by making, using, selling, offering for
|
469
|
-
sale, or importing the Program or any portion of it.
|
470
|
-
|
471
|
-
11. Patents.
|
472
|
-
|
473
|
-
A "contributor" is a copyright holder who authorizes use under this
|
474
|
-
License of the Program or a work on which the Program is based. The
|
475
|
-
work thus licensed is called the contributor's "contributor version".
|
476
|
-
|
477
|
-
A contributor's "essential patent claims" are all patent claims
|
478
|
-
owned or controlled by the contributor, whether already acquired or
|
479
|
-
hereafter acquired, that would be infringed by some manner, permitted
|
480
|
-
by this License, of making, using, or selling its contributor version,
|
481
|
-
but do not include claims that would be infringed only as a
|
482
|
-
consequence of further modification of the contributor version. For
|
483
|
-
purposes of this definition, "control" includes the right to grant
|
484
|
-
patent sublicenses in a manner consistent with the requirements of
|
485
|
-
this License.
|
486
|
-
|
487
|
-
Each contributor grants you a non-exclusive, worldwide, royalty-free
|
488
|
-
patent license under the contributor's essential patent claims, to
|
489
|
-
make, use, sell, offer for sale, import and otherwise run, modify and
|
490
|
-
propagate the contents of its contributor version.
|
491
|
-
|
492
|
-
In the following three paragraphs, a "patent license" is any express
|
493
|
-
agreement or commitment, however denominated, not to enforce a patent
|
494
|
-
(such as an express permission to practice a patent or covenant not to
|
495
|
-
sue for patent infringement). To "grant" such a patent license to a
|
496
|
-
party means to make such an agreement or commitment not to enforce a
|
497
|
-
patent against the party.
|
498
|
-
|
499
|
-
If you convey a covered work, knowingly relying on a patent license,
|
500
|
-
and the Corresponding Source of the work is not available for anyone
|
501
|
-
to copy, free of charge and under the terms of this License, through a
|
502
|
-
publicly available network server or other readily accessible means,
|
503
|
-
then you must either (1) cause the Corresponding Source to be so
|
504
|
-
available, or (2) arrange to deprive yourself of the benefit of the
|
505
|
-
patent license for this particular work, or (3) arrange, in a manner
|
506
|
-
consistent with the requirements of this License, to extend the patent
|
507
|
-
license to downstream recipients. "Knowingly relying" means you have
|
508
|
-
actual knowledge that, but for the patent license, your conveying the
|
509
|
-
covered work in a country, or your recipient's use of the covered work
|
510
|
-
in a country, would infringe one or more identifiable patents in that
|
511
|
-
country that you have reason to believe are valid.
|
512
|
-
|
513
|
-
If, pursuant to or in connection with a single transaction or
|
514
|
-
arrangement, you convey, or propagate by procuring conveyance of, a
|
515
|
-
covered work, and grant a patent license to some of the parties
|
516
|
-
receiving the covered work authorizing them to use, propagate, modify
|
517
|
-
or convey a specific copy of the covered work, then the patent license
|
518
|
-
you grant is automatically extended to all recipients of the covered
|
519
|
-
work and works based on it.
|
520
|
-
|
521
|
-
A patent license is "discriminatory" if it does not include within
|
522
|
-
the scope of its coverage, prohibits the exercise of, or is
|
523
|
-
conditioned on the non-exercise of one or more of the rights that are
|
524
|
-
specifically granted under this License. You may not convey a covered
|
525
|
-
work if you are a party to an arrangement with a third party that is
|
526
|
-
in the business of distributing software, under which you make payment
|
527
|
-
to the third party based on the extent of your activity of conveying
|
528
|
-
the work, and under which the third party grants, to any of the
|
529
|
-
parties who would receive the covered work from you, a discriminatory
|
530
|
-
patent license (a) in connection with copies of the covered work
|
531
|
-
conveyed by you (or copies made from those copies), or (b) primarily
|
532
|
-
for and in connection with specific products or compilations that
|
533
|
-
contain the covered work, unless you entered into that arrangement,
|
534
|
-
or that patent license was granted, prior to 28 March 2007.
|
535
|
-
|
536
|
-
Nothing in this License shall be construed as excluding or limiting
|
537
|
-
any implied license or other defenses to infringement that may
|
538
|
-
otherwise be available to you under applicable patent law.
|
539
|
-
|
540
|
-
12. No Surrender of Others' Freedom.
|
541
|
-
|
542
|
-
If conditions are imposed on you (whether by court order, agreement or
|
543
|
-
otherwise) that contradict the conditions of this License, they do not
|
544
|
-
excuse you from the conditions of this License. If you cannot convey a
|
545
|
-
covered work so as to satisfy simultaneously your obligations under this
|
546
|
-
License and any other pertinent obligations, then as a consequence you may
|
547
|
-
not convey it at all. For example, if you agree to terms that obligate you
|
548
|
-
to collect a royalty for further conveying from those to whom you convey
|
549
|
-
the Program, the only way you could satisfy both those terms and this
|
550
|
-
License would be to refrain entirely from conveying the Program.
|
551
|
-
|
552
|
-
13. Use with the GNU Affero General Public License.
|
553
|
-
|
554
|
-
Notwithstanding any other provision of this License, you have
|
555
|
-
permission to link or combine any covered work with a work licensed
|
556
|
-
under version 3 of the GNU Affero General Public License into a single
|
557
|
-
combined work, and to convey the resulting work. The terms of this
|
558
|
-
License will continue to apply to the part which is the covered work,
|
559
|
-
but the special requirements of the GNU Affero General Public License,
|
560
|
-
section 13, concerning interaction through a network will apply to the
|
561
|
-
combination as such.
|
562
|
-
|
563
|
-
14. Revised Versions of this License.
|
564
|
-
|
565
|
-
The Free Software Foundation may publish revised and/or new versions of
|
566
|
-
the GNU General Public License from time to time. Such new versions will
|
567
|
-
be similar in spirit to the present version, but may differ in detail to
|
568
|
-
address new problems or concerns.
|
569
|
-
|
570
|
-
Each version is given a distinguishing version number. If the
|
571
|
-
Program specifies that a certain numbered version of the GNU General
|
572
|
-
Public License "or any later version" applies to it, you have the
|
573
|
-
option of following the terms and conditions either of that numbered
|
574
|
-
version or of any later version published by the Free Software
|
575
|
-
Foundation. If the Program does not specify a version number of the
|
576
|
-
GNU General Public License, you may choose any version ever published
|
577
|
-
by the Free Software Foundation.
|
578
|
-
|
579
|
-
If the Program specifies that a proxy can decide which future
|
580
|
-
versions of the GNU General Public License can be used, that proxy's
|
581
|
-
public statement of acceptance of a version permanently authorizes you
|
582
|
-
to choose that version for the Program.
|
583
|
-
|
584
|
-
Later license versions may give you additional or different
|
585
|
-
permissions. However, no additional obligations are imposed on any
|
586
|
-
author or copyright holder as a result of your choosing to follow a
|
587
|
-
later version.
|
588
|
-
|
589
|
-
15. Disclaimer of Warranty.
|
590
|
-
|
591
|
-
THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
|
592
|
-
APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
|
593
|
-
HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
|
594
|
-
OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
|
595
|
-
THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
596
|
-
PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
|
597
|
-
IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
|
598
|
-
ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
|
599
|
-
|
600
|
-
16. Limitation of Liability.
|
601
|
-
|
602
|
-
IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
|
603
|
-
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
|
604
|
-
THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
|
605
|
-
GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
|
606
|
-
USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
|
607
|
-
DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
|
608
|
-
PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
|
609
|
-
EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
|
610
|
-
SUCH DAMAGES.
|
611
|
-
|
612
|
-
17. Interpretation of Sections 15 and 16.
|
613
|
-
|
614
|
-
If the disclaimer of warranty and limitation of liability provided
|
615
|
-
above cannot be given local legal effect according to their terms,
|
616
|
-
reviewing courts shall apply local law that most closely approximates
|
617
|
-
an absolute waiver of all civil liability in connection with the
|
618
|
-
Program, unless a warranty or assumption of liability accompanies a
|
619
|
-
copy of the Program in return for a fee.
|
620
|
-
|
621
|
-
END OF TERMS AND CONDITIONS
|
622
|
-
|
623
|
-
How to Apply These Terms to Your New Programs
|
624
|
-
|
625
|
-
If you develop a new program, and you want it to be of the greatest
|
626
|
-
possible use to the public, the best way to achieve this is to make it
|
627
|
-
free software which everyone can redistribute and change under these terms.
|
628
|
-
|
629
|
-
To do so, attach the following notices to the program. It is safest
|
630
|
-
to attach them to the start of each source file to most effectively
|
631
|
-
state the exclusion of warranty; and each file should have at least
|
632
|
-
the "copyright" line and a pointer to where the full notice is found.
|
633
|
-
|
634
|
-
<one line to give the program's name and a brief idea of what it does.>
|
635
|
-
Copyright (C) <year> <name of author>
|
636
|
-
|
637
|
-
This program is free software: you can redistribute it and/or modify
|
638
|
-
it under the terms of the GNU General Public License as published by
|
639
|
-
the Free Software Foundation, either version 3 of the License, or
|
640
|
-
(at your option) any later version.
|
641
|
-
|
642
|
-
This program is distributed in the hope that it will be useful,
|
643
|
-
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
644
|
-
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
645
|
-
GNU General Public License for more details.
|
646
|
-
|
647
|
-
You should have received a copy of the GNU General Public License
|
648
|
-
along with this program. If not, see <http://www.gnu.org/licenses/>.
|
649
|
-
|
650
|
-
Also add information on how to contact you by electronic and paper mail.
|
651
|
-
|
652
|
-
If the program does terminal interaction, make it output a short
|
653
|
-
notice like this when it starts in an interactive mode:
|
654
|
-
|
655
|
-
<program> Copyright (C) <year> <name of author>
|
656
|
-
This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
|
657
|
-
This is free software, and you are welcome to redistribute it
|
658
|
-
under certain conditions; type `show c' for details.
|
659
|
-
|
660
|
-
The hypothetical commands `show w' and `show c' should show the appropriate
|
661
|
-
parts of the General Public License. Of course, your program's commands
|
662
|
-
might be different; for a GUI interface, you would use an "about box".
|
663
|
-
|
664
|
-
You should also get your employer (if you work as a programmer) or school,
|
665
|
-
if any, to sign a "copyright disclaimer" for the program, if necessary.
|
666
|
-
For more information on this, and how to apply and follow the GNU GPL, see
|
667
|
-
<http://www.gnu.org/licenses/>.
|
668
|
-
|
669
|
-
The GNU General Public License does not permit incorporating your program
|
670
|
-
into proprietary programs. If your program is a subroutine library, you
|
671
|
-
may consider it more useful to permit linking proprietary applications with
|
672
|
-
the library. If this is what you want to do, use the GNU Lesser General
|
673
|
-
Public License instead of this License. But first, please read
|
674
|
-
<http://www.gnu.org/philosophy/why-not-lgpl.html>.
|
8
|
+
|
9
|
+
This version of the GNU Lesser General Public License incorporates
|
10
|
+
the terms and conditions of version 3 of the GNU General Public
|
11
|
+
License, supplemented by the additional permissions listed below.
|
12
|
+
|
13
|
+
0. Additional Definitions.
|
14
|
+
|
15
|
+
As used herein, "this License" refers to version 3 of the GNU Lesser
|
16
|
+
General Public License, and the "GNU GPL" refers to version 3 of the GNU
|
17
|
+
General Public License.
|
18
|
+
|
19
|
+
"The Library" refers to a covered work governed by this License,
|
20
|
+
other than an Application or a Combined Work as defined below.
|
21
|
+
|
22
|
+
An "Application" is any work that makes use of an interface provided
|
23
|
+
by the Library, but which is not otherwise based on the Library.
|
24
|
+
Defining a subclass of a class defined by the Library is deemed a mode
|
25
|
+
of using an interface provided by the Library.
|
26
|
+
|
27
|
+
A "Combined Work" is a work produced by combining or linking an
|
28
|
+
Application with the Library. The particular version of the Library
|
29
|
+
with which the Combined Work was made is also called the "Linked
|
30
|
+
Version".
|
31
|
+
|
32
|
+
The "Minimal Corresponding Source" for a Combined Work means the
|
33
|
+
Corresponding Source for the Combined Work, excluding any source code
|
34
|
+
for portions of the Combined Work that, considered in isolation, are
|
35
|
+
based on the Application, and not on the Linked Version.
|
36
|
+
|
37
|
+
The "Corresponding Application Code" for a Combined Work means the
|
38
|
+
object code and/or source code for the Application, including any data
|
39
|
+
and utility programs needed for reproducing the Combined Work from the
|
40
|
+
Application, but excluding the System Libraries of the Combined Work.
|
41
|
+
|
42
|
+
1. Exception to Section 3 of the GNU GPL.
|
43
|
+
|
44
|
+
You may convey a covered work under sections 3 and 4 of this License
|
45
|
+
without being bound by section 3 of the GNU GPL.
|
46
|
+
|
47
|
+
2. Conveying Modified Versions.
|
48
|
+
|
49
|
+
If you modify a copy of the Library, and, in your modifications, a
|
50
|
+
facility refers to a function or data to be supplied by an Application
|
51
|
+
that uses the facility (other than as an argument passed when the
|
52
|
+
facility is invoked), then you may convey a copy of the modified
|
53
|
+
version:
|
54
|
+
|
55
|
+
a) under this License, provided that you make a good faith effort to
|
56
|
+
ensure that, in the event an Application does not supply the
|
57
|
+
function or data, the facility still operates, and performs
|
58
|
+
whatever part of its purpose remains meaningful, or
|
59
|
+
|
60
|
+
b) under the GNU GPL, with none of the additional permissions of
|
61
|
+
this License applicable to that copy.
|
62
|
+
|
63
|
+
3. Object Code Incorporating Material from Library Header Files.
|
64
|
+
|
65
|
+
The object code form of an Application may incorporate material from
|
66
|
+
a header file that is part of the Library. You may convey such object
|
67
|
+
code under terms of your choice, provided that, if the incorporated
|
68
|
+
material is not limited to numerical parameters, data structure
|
69
|
+
layouts and accessors, or small macros, inline functions and templates
|
70
|
+
(ten or fewer lines in length), you do both of the following:
|
71
|
+
|
72
|
+
a) Give prominent notice with each copy of the object code that the
|
73
|
+
Library is used in it and that the Library and its use are
|
74
|
+
covered by this License.
|
75
|
+
|
76
|
+
b) Accompany the object code with a copy of the GNU GPL and this license
|
77
|
+
document.
|
78
|
+
|
79
|
+
4. Combined Works.
|
80
|
+
|
81
|
+
You may convey a Combined Work under terms of your choice that,
|
82
|
+
taken together, effectively do not restrict modification of the
|
83
|
+
portions of the Library contained in the Combined Work and reverse
|
84
|
+
engineering for debugging such modifications, if you also do each of
|
85
|
+
the following:
|
86
|
+
|
87
|
+
a) Give prominent notice with each copy of the Combined Work that
|
88
|
+
the Library is used in it and that the Library and its use are
|
89
|
+
covered by this License.
|
90
|
+
|
91
|
+
b) Accompany the Combined Work with a copy of the GNU GPL and this license
|
92
|
+
document.
|
93
|
+
|
94
|
+
c) For a Combined Work that displays copyright notices during
|
95
|
+
execution, include the copyright notice for the Library among
|
96
|
+
these notices, as well as a reference directing the user to the
|
97
|
+
copies of the GNU GPL and this license document.
|
98
|
+
|
99
|
+
d) Do one of the following:
|
100
|
+
|
101
|
+
0) Convey the Minimal Corresponding Source under the terms of this
|
102
|
+
License, and the Corresponding Application Code in a form
|
103
|
+
suitable for, and under terms that permit, the user to
|
104
|
+
recombine or relink the Application with a modified version of
|
105
|
+
the Linked Version to produce a modified Combined Work, in the
|
106
|
+
manner specified by section 6 of the GNU GPL for conveying
|
107
|
+
Corresponding Source.
|
108
|
+
|
109
|
+
1) Use a suitable shared library mechanism for linking with the
|
110
|
+
Library. A suitable mechanism is one that (a) uses at run time
|
111
|
+
a copy of the Library already present on the user's computer
|
112
|
+
system, and (b) will operate properly with a modified version
|
113
|
+
of the Library that is interface-compatible with the Linked
|
114
|
+
Version.
|
115
|
+
|
116
|
+
e) Provide Installation Information, but only if you would otherwise
|
117
|
+
be required to provide such information under section 6 of the
|
118
|
+
GNU GPL, and only to the extent that such information is
|
119
|
+
necessary to install and execute a modified version of the
|
120
|
+
Combined Work produced by recombining or relinking the
|
121
|
+
Application with a modified version of the Linked Version. (If
|
122
|
+
you use option 4d0, the Installation Information must accompany
|
123
|
+
the Minimal Corresponding Source and Corresponding Application
|
124
|
+
Code. If you use option 4d1, you must provide the Installation
|
125
|
+
Information in the manner specified by section 6 of the GNU GPL
|
126
|
+
for conveying Corresponding Source.)
|
127
|
+
|
128
|
+
5. Combined Libraries.
|
129
|
+
|
130
|
+
You may place library facilities that are a work based on the
|
131
|
+
Library side by side in a single library together with other library
|
132
|
+
facilities that are not Applications and are not covered by this
|
133
|
+
License, and convey such a combined library under terms of your
|
134
|
+
choice, if you do both of the following:
|
135
|
+
|
136
|
+
a) Accompany the combined library with a copy of the same work based
|
137
|
+
on the Library, uncombined with any other library facilities,
|
138
|
+
conveyed under the terms of this License.
|
139
|
+
|
140
|
+
b) Give prominent notice with the combined library that part of it
|
141
|
+
is a work based on the Library, and explaining where to find the
|
142
|
+
accompanying uncombined form of the same work.
|
143
|
+
|
144
|
+
6. Revised Versions of the GNU Lesser General Public License.
|
145
|
+
|
146
|
+
The Free Software Foundation may publish revised and/or new versions
|
147
|
+
of the GNU Lesser General Public License from time to time. Such new
|
148
|
+
versions will be similar in spirit to the present version, but may
|
149
|
+
differ in detail to address new problems or concerns.
|
150
|
+
|
151
|
+
Each version is given a distinguishing version number. If the
|
152
|
+
Library as you received it specifies that a certain numbered version
|
153
|
+
of the GNU Lesser General Public License "or any later version"
|
154
|
+
applies to it, you have the option of following the terms and
|
155
|
+
conditions either of that published version or of any later version
|
156
|
+
published by the Free Software Foundation. If the Library as you
|
157
|
+
received it does not specify a version number of the GNU Lesser
|
158
|
+
General Public License, you may choose any version of the GNU Lesser
|
159
|
+
General Public License ever published by the Free Software Foundation.
|
160
|
+
|
161
|
+
If the Library as you received it specifies that a proxy can decide
|
162
|
+
whether future versions of the GNU Lesser General Public License shall
|
163
|
+
apply, that proxy's public statement of acceptance of any version is
|
164
|
+
permanent authorization for you to choose that version for the
|
165
|
+
Library.
|
data/README.md
CHANGED
@@ -3,6 +3,7 @@
|
|
3
3
|
[![Gem Version](https://badge.fury.io/rb/particlerb.svg)](http://badge.fury.io/rb/particlerb)
|
4
4
|
[![Build Status](https://travis-ci.org/monkbroc/particlerb.svg)](https://travis-ci.org/monkbroc/particlerb)
|
5
5
|
[![Code Climate](https://codeclimate.com/github/monkbroc/particlerb/badges/gpa.svg)](https://codeclimate.com/github/monkbroc/particlerb)
|
6
|
+
[![RubyDoc](https://img.shields.io/badge/RubyDoc-documentation-blue.svg)](http://www.rubydoc.info/github/monkbroc/particlerb)
|
6
7
|
|
7
8
|
Ruby client for the [Particle.io] Cloud API with an object-oriented interface
|
8
9
|
|
@@ -23,7 +24,6 @@ gem "particlerb", "~> 0.0.3"
|
|
23
24
|
require 'particle'
|
24
25
|
```
|
25
26
|
|
26
|
-
|
27
27
|
### Providing credentials
|
28
28
|
|
29
29
|
**A Particle cloud API access token is necessary for most requests.** You can use the one from the [Web IDE][] for testing, but it's recommended to generate a new token with this gem using `Particle.login` or with the [Particle CLI][] using `particle token new`
|
@@ -51,6 +51,8 @@ configuration) or as client instance methods.
|
|
51
51
|
```ruby
|
52
52
|
# Fetch the list of devices using the global client
|
53
53
|
Particle.devices
|
54
|
+
# This is equivalent to
|
55
|
+
Particle.client.devices
|
54
56
|
|
55
57
|
# Or used a newly created client
|
56
58
|
client = Particle::Client.new
|
@@ -58,6 +60,8 @@ client = Particle::Client.new
|
|
58
60
|
client.devices
|
59
61
|
```
|
60
62
|
|
63
|
+
When using this gem in a multi-threaded program like a Rails application running on the puma server, it's safer to use `Particle::Client.new` in each thread rather than using the global `Particle.client`.
|
64
|
+
|
61
65
|
[Web IDE]: http://docs.particle.io/core/build/#flash-apps-with-particle-build-account-information
|
62
66
|
[Particle CLI]: http://docs.particle.io/core/cli
|
63
67
|
|
@@ -84,6 +88,7 @@ device.attributes # Hash of all attributes
|
|
84
88
|
device.id # ==> 'f8bbe1e6e69e05c9c405ba1ca504d438061f1b0d'
|
85
89
|
device.name # ==> 'blue_fire'
|
86
90
|
device.connected? # true
|
91
|
+
device.product # "Core" or "Photon"
|
87
92
|
device.variables # {:myvar => "double" } or nil if not connected
|
88
93
|
device.functions # ["myfunction"] or nil if not connected
|
89
94
|
device.get_attributes # forces refresh of all attributes from the cloud
|
@@ -122,6 +127,7 @@ Call a function on the firmware with an optional `String` argument. Returns the
|
|
122
127
|
```ruby
|
123
128
|
Particle.device('coffeemaker').function('brew')
|
124
129
|
Particle.devices.first.function('digitalWrite', '1')
|
130
|
+
device.call('brew') # aliased as call
|
125
131
|
```
|
126
132
|
|
127
133
|
Get the value of a firmware variable. Returns the result as a `String` or `Number`.
|
@@ -130,6 +136,7 @@ Get the value of a firmware variable. Returns the result as a `String` or `Numbe
|
|
130
136
|
Particle.device('mycar').variable('battery') # ==> 12.33
|
131
137
|
device = Particle.device('f8bbe1e6e69e05c9c405ba1ca504d438061f1b0d')
|
132
138
|
device.variable('version') # ==> "1.0.1"
|
139
|
+
device.get('version') # aliased as get
|
133
140
|
```
|
134
141
|
|
135
142
|
Signal a device to start blinking the RGB LED in rainbow patterns. Returns whether the device is signaling.
|
@@ -213,15 +220,23 @@ Currently the available options are:
|
|
213
220
|
|
214
221
|
* event
|
215
222
|
* url
|
223
|
+
* requestType (HTTP method)
|
216
224
|
* deviceid
|
217
|
-
* requestType
|
218
225
|
* headers
|
226
|
+
* form
|
219
227
|
* json
|
220
228
|
* query
|
221
229
|
* auth
|
222
230
|
* mydevices
|
223
231
|
* rejectUnauthorized
|
224
232
|
|
233
|
+
Remove a webhook. Returns true on success.
|
234
|
+
|
235
|
+
```ruby
|
236
|
+
webhook = Particle.webhooks.first
|
237
|
+
webhook.remove
|
238
|
+
Particle.webhooks.each(&:remove) # remove all
|
239
|
+
```
|
225
240
|
|
226
241
|
See the [Particle Cloud API documentation about webhooks][webhook docs] for more details.
|
227
242
|
|
@@ -299,8 +314,8 @@ result = device.compile('blink_led.ino')
|
|
299
314
|
result.ok # ==> true
|
300
315
|
result.binary_id # ==> "559061e16b4ba27e4602c5c8"
|
301
316
|
|
302
|
-
Particle.
|
303
|
-
Particle.
|
317
|
+
Particle.compile(Dir.glob('firmware/*', platform: :core) # or :photon
|
318
|
+
Particle.compile(Dir.glob('firmware/*', product_id: 1) # meaning depends on your account
|
304
319
|
```
|
305
320
|
|
306
321
|
Download a compiled binary. Returns the result bytes
|
@@ -352,6 +367,33 @@ response = Particle.last_response
|
|
352
367
|
headers = response.headers
|
353
368
|
```
|
354
369
|
|
370
|
+
## Tests
|
371
|
+
|
372
|
+
This gem uses the VCR gem to record and replay HTTP requests.
|
373
|
+
|
374
|
+
To run the tests using pre-recorded HTTP requests:
|
375
|
+
|
376
|
+
```
|
377
|
+
$ bundle install
|
378
|
+
$ bundle exec rake spec
|
379
|
+
```
|
380
|
+
|
381
|
+
To run the test against the real API, you will need an account with Particle and a device added to your account.
|
382
|
+
|
383
|
+
Set the following environment variables:
|
384
|
+
|
385
|
+
- `TEST_PARTICLE_USERNAME`: your Particle user email
|
386
|
+
- `TEST_PARTICLE_PASSWORD`: your Particle password
|
387
|
+
- `TEST_PARTICLE_ACCESS_TOKEN`: a Particle access token. You can get this from the web IDE
|
388
|
+
- `TEST_PARTICLE_DEVICE_IDS`: a comma separated list of your device ids. You can get this from the Particle CLI `particle list`
|
389
|
+
|
390
|
+
Make sure **the first Particle device in `TEST_PARTICLE_DEVICE_IDS` is online** and run
|
391
|
+
|
392
|
+
```
|
393
|
+
$ bundle install
|
394
|
+
$ bundle exec rake spec:rerecord
|
395
|
+
```
|
396
|
+
|
355
397
|
## Support
|
356
398
|
|
357
399
|
Open a [GitHub issue][] if you find a bug.
|
@@ -379,6 +421,6 @@ Octokit is copyright (c) 2009-2014 Wynn Netherland, Adam Stacoviak, Erik Michael
|
|
379
421
|
|
380
422
|
Copyright (c) 2015 Julien Vanier
|
381
423
|
|
382
|
-
This gem is available under the [GNU General Public License version 3][
|
424
|
+
This gem is available under the [GNU Lesser General Public License, version 3.0][license]
|
383
425
|
|
384
|
-
[
|
426
|
+
[license]: https://github.com/monkbroc/particlerb/blob/master/LICENSE.txt
|
data/Rakefile
CHANGED
@@ -4,5 +4,42 @@ Bundler::GemHelper.install_tasks
|
|
4
4
|
require 'rspec/core/rake_task'
|
5
5
|
RSpec::Core::RakeTask.new(:spec)
|
6
6
|
|
7
|
+
require 'highline'
|
8
|
+
|
9
|
+
# Run all tests using recorded HTTP responses
|
7
10
|
task :test => :spec
|
8
11
|
task :default => :spec
|
12
|
+
|
13
|
+
namespace :spec do
|
14
|
+
desc "Run all tests against the real API, re-recording all HTTP responses"
|
15
|
+
task :rerecord => ["clean:vcr", :wait_online, :online, :wait_offline, :offline, :spec]
|
16
|
+
|
17
|
+
desc "Wait for the device to be online"
|
18
|
+
task :wait_online do
|
19
|
+
HighLine.new.ask "<%= color('Is the device online?', LIGHT_GREEN) %> "
|
20
|
+
end
|
21
|
+
|
22
|
+
desc "Run tests where device has to be online"
|
23
|
+
RSpec::Core::RakeTask.new(:online) do |t|
|
24
|
+
t.rspec_opts = "--tag ~offline"
|
25
|
+
end
|
26
|
+
|
27
|
+
desc "Wait for the device to be offline"
|
28
|
+
task :wait_offline do
|
29
|
+
HighLine.new.ask "<%= color('Is the device offline?', LIGHT_YELLOW) %> "
|
30
|
+
end
|
31
|
+
|
32
|
+
desc "Run tests where device has to be offline"
|
33
|
+
RSpec::Core::RakeTask.new(:offline) do |t|
|
34
|
+
t.rspec_opts = "--tag offline"
|
35
|
+
end
|
36
|
+
|
37
|
+
end
|
38
|
+
|
39
|
+
task :clean => %w(clean:vcr)
|
40
|
+
namespace :clean do
|
41
|
+
desc "Clean HTTP responses recorded by VCR"
|
42
|
+
task :vcr do
|
43
|
+
FileUtils.rm_rf 'spec/cassettes'
|
44
|
+
end
|
45
|
+
end
|
@@ -95,12 +95,7 @@ module Particle
|
|
95
95
|
# @return [boolean] true when signaling, false when stopped
|
96
96
|
def signal_device(target, enabled = true)
|
97
97
|
result = put(device(target).path, signal: enabled ? '1' : '0')
|
98
|
-
|
99
|
-
if result[:ok] == false
|
100
|
-
false
|
101
|
-
else
|
102
|
-
result[:signaling]
|
103
|
-
end
|
98
|
+
result[:signaling]
|
104
99
|
end
|
105
100
|
|
106
101
|
# Change the product_id on the device.
|
@@ -11,7 +11,8 @@ module Particle
|
|
11
11
|
COMPILE_PATH = "v1/binaries"
|
12
12
|
PLATFORMS = {
|
13
13
|
core: 0,
|
14
|
-
photon:
|
14
|
+
photon: 6,
|
15
|
+
p1: 8
|
15
16
|
}
|
16
17
|
|
17
18
|
# Flash new firmware to a Particle device from source code or
|
@@ -30,15 +31,7 @@ module Particle
|
|
30
31
|
def flash_device(target, file_paths, options = {})
|
31
32
|
params = file_upload_params(file_paths, options)
|
32
33
|
result = put(device(target).path, params)
|
33
|
-
|
34
|
-
if result[:ok] == false
|
35
|
-
errors = result[:errors][0]
|
36
|
-
result[:errors] = if errors.is_a? Hash
|
37
|
-
errors[:errors][0]
|
38
|
-
else
|
39
|
-
result
|
40
|
-
end
|
41
|
-
elsif result[:status] == "Update started"
|
34
|
+
if result[:status] == "Update started"
|
42
35
|
result[:ok] = true
|
43
36
|
end
|
44
37
|
OpenStruct.new(result)
|
@@ -57,14 +50,10 @@ module Particle
|
|
57
50
|
# :ok => true on success
|
58
51
|
# :errors => String with compile errors
|
59
52
|
#
|
60
|
-
def
|
53
|
+
def compile(file_paths, options = {})
|
61
54
|
normalize_platform_id(options)
|
62
55
|
params = file_upload_params(file_paths, options)
|
63
56
|
result = post(COMPILE_PATH, params)
|
64
|
-
# Normalize the weird output structure
|
65
|
-
if result[:ok] == false
|
66
|
-
result[:errors] = result[:errors][0]
|
67
|
-
end
|
68
57
|
OpenStruct.new(result)
|
69
58
|
end
|
70
59
|
|
data/lib/particle/connection.rb
CHANGED
@@ -94,6 +94,22 @@ module Particle
|
|
94
94
|
end
|
95
95
|
|
96
96
|
def request(method, path, data, options = {})
|
97
|
+
prepare_request_options(data, options)
|
98
|
+
@last_response = response = connection.send(method, URI::Parser.new.escape(path.to_s)) do |req|
|
99
|
+
if data && method != :get
|
100
|
+
req.body = data
|
101
|
+
end
|
102
|
+
if params = options[:query]
|
103
|
+
req.params.update params
|
104
|
+
end
|
105
|
+
if headers = options[:headers]
|
106
|
+
req.headers.update headers
|
107
|
+
end
|
108
|
+
end
|
109
|
+
response.body
|
110
|
+
end
|
111
|
+
|
112
|
+
def prepare_request_options(data, options)
|
97
113
|
if data.is_a?(Hash)
|
98
114
|
options[:query] ||= data.delete(:query) || {}
|
99
115
|
options[:headers] ||= data.delete(:headers) || {}
|
@@ -109,19 +125,6 @@ module Particle
|
|
109
125
|
options[:headers][:authorization] =
|
110
126
|
basic_auth_header(username, password)
|
111
127
|
end
|
112
|
-
|
113
|
-
@last_response = response = connection.send(method, URI::Parser.new.escape(path.to_s)) do |req|
|
114
|
-
if data && method != :get
|
115
|
-
req.body = data
|
116
|
-
end
|
117
|
-
if params = options[:query]
|
118
|
-
req.params.update params
|
119
|
-
end
|
120
|
-
if headers = options[:headers]
|
121
|
-
req.headers.update headers
|
122
|
-
end
|
123
|
-
end
|
124
|
-
response.body
|
125
128
|
end
|
126
129
|
|
127
130
|
def conn_opts
|
data/lib/particle/device.rb
CHANGED
@@ -5,6 +5,10 @@ module Particle
|
|
5
5
|
# Domain model for one Particle device
|
6
6
|
class Device < Model
|
7
7
|
ID_REGEX = /\h{24}/
|
8
|
+
PRODUCT_IDS = {
|
9
|
+
0 => "Core".freeze,
|
10
|
+
6 => "Photon".freeze
|
11
|
+
}
|
8
12
|
|
9
13
|
def initialize(client, attributes)
|
10
14
|
super(client, attributes)
|
@@ -37,6 +41,10 @@ module Particle
|
|
37
41
|
|
38
42
|
alias_method :connected?, :connected
|
39
43
|
|
44
|
+
def product
|
45
|
+
PRODUCT_IDS[product_id]
|
46
|
+
end
|
47
|
+
|
40
48
|
def get_attributes
|
41
49
|
@loaded = true
|
42
50
|
@attributes = @client.device_attributes(self)
|
@@ -77,6 +85,7 @@ module Particle
|
|
77
85
|
def function(name, argument = "")
|
78
86
|
@client.call_function(self, name, argument)
|
79
87
|
end
|
88
|
+
alias_method :call, :function
|
80
89
|
|
81
90
|
# Get the value of a variable in the firmware of a Particle device
|
82
91
|
#
|
@@ -88,6 +97,7 @@ module Particle
|
|
88
97
|
def variable(name)
|
89
98
|
@client.get_variable(self, name)
|
90
99
|
end
|
100
|
+
alias_method :get, :variable
|
91
101
|
|
92
102
|
# Signal the device to start blinking the RGB LED in a rainbow
|
93
103
|
# pattern. Useful to identify a particular device.
|
@@ -122,7 +132,7 @@ module Particle
|
|
122
132
|
# :errors => String with compile errors
|
123
133
|
#
|
124
134
|
def compile(file_paths)
|
125
|
-
@client.
|
135
|
+
@client.compile(file_paths, device_id: id)
|
126
136
|
end
|
127
137
|
|
128
138
|
# Change the product_id on the device.
|
data/lib/particle/version.rb
CHANGED
data/particlerb.gemspec
CHANGED
@@ -11,7 +11,7 @@ Gem::Specification.new do |spec|
|
|
11
11
|
spec.files = %w(LICENSE.txt README.md Rakefile particlerb.gemspec)
|
12
12
|
spec.files += Dir.glob("lib/**/*.rb")
|
13
13
|
spec.homepage = 'https://github.com/monkbroc/particlerb'
|
14
|
-
spec.licenses = ['
|
14
|
+
spec.licenses = ['LGPL-3.0']
|
15
15
|
spec.name = 'particlerb'
|
16
16
|
spec.require_paths = ['lib']
|
17
17
|
spec.required_ruby_version = '>= 1.9.3'
|
@@ -28,4 +28,5 @@ Gem::Specification.new do |spec|
|
|
28
28
|
spec.add_development_dependency 'vcr', '~> 2.9'
|
29
29
|
spec.add_development_dependency 'webmock', '~> 1.21'
|
30
30
|
spec.add_development_dependency 'multi_json', '~> 1.11'
|
31
|
+
spec.add_development_dependency 'highline', '~> 1.7'
|
31
32
|
end
|
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: particlerb
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 0.0.
|
4
|
+
version: 0.0.4
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Julien Vanier
|
8
8
|
autorequire:
|
9
9
|
bindir: bin
|
10
10
|
cert_chain: []
|
11
|
-
date: 2015-06
|
11
|
+
date: 2015-07-06 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
name: faraday
|
@@ -164,6 +164,20 @@ dependencies:
|
|
164
164
|
- - "~>"
|
165
165
|
- !ruby/object:Gem::Version
|
166
166
|
version: '1.11'
|
167
|
+
- !ruby/object:Gem::Dependency
|
168
|
+
name: highline
|
169
|
+
requirement: !ruby/object:Gem::Requirement
|
170
|
+
requirements:
|
171
|
+
- - "~>"
|
172
|
+
- !ruby/object:Gem::Version
|
173
|
+
version: '1.7'
|
174
|
+
type: :development
|
175
|
+
prerelease: false
|
176
|
+
version_requirements: !ruby/object:Gem::Requirement
|
177
|
+
requirements:
|
178
|
+
- - "~>"
|
179
|
+
- !ruby/object:Gem::Version
|
180
|
+
version: '1.7'
|
167
181
|
description: Ruby client for the Particle.io Cloud API
|
168
182
|
email:
|
169
183
|
- jvanier@gmail.com
|
@@ -196,7 +210,7 @@ files:
|
|
196
210
|
- particlerb.gemspec
|
197
211
|
homepage: https://github.com/monkbroc/particlerb
|
198
212
|
licenses:
|
199
|
-
-
|
213
|
+
- LGPL-3.0
|
200
214
|
metadata: {}
|
201
215
|
post_install_message:
|
202
216
|
rdoc_options: []
|