forked from guyroyse/proton-db
-
Notifications
You must be signed in to change notification settings - Fork 0
/
quick-reference.txt
52 lines (46 loc) · 2.18 KB
/
quick-reference.txt
1
2
3
4
5
6
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
Database Operations
-------------------
Save objects: proton.db('things').save(<object>)
proton.db('things').save(<object>,<object>,<object>...)
Remove matching objects: proton.db('things').remove(<query>)
proton.db('things').remove(<query>,<query>,<query>...)
Remove all objects: proton.db('things').clear()
Update matching objects: proton.db('things').update(<update>,<query>)
proton.db('things').update(<update>,<query>,<query>,<query>...)
Query matching objects: <array> proton.db('things').find(<query>)
<array> proton.db('things').find(<query>,<query>,<query>...)
Get all objects: <array> proton.db('things').all()
Get distinct objects: <array> proton.db('things').distinct()
Match objects: <bool> proton.match(<object>, <query>)
A sample <object>: {name:'Alex Trabeck', occupation:'Game Show Host', favorites:{bird:'robin', color:'blue'}}
A sample <query>:
(simple) {occupation: 'Game Show Host'}
(stock function) {salary: proton.greaterThan(100000)}
(custom function) {occupation: function(value) { return value.charAt(3) == 'e' } }
(complex) {occupation: 'Game Show Host', salary: proton.greaterThan(100000)}
(regex) {occupation: /Game/)
(deep) (name: 'Alex Trabeck', favorites: {color: 'blue'} }
A sample <update>:
(add) {salary: 250000}
(remove) {occupation: undefined}
(change) {occupation: 'Spokesman'}
A sample <sort>: {occupation: proton.ascending, salary: proton.descending}
Array Operations
----------------
Constructor:
(empty) new Array()
(copy) new Array('foo','bar','baz')
Filter array: <array> things.sift(<query>)
First set of items: <array> things.top(5)
Last set of items: <array> things.bottom(3)
Paged items: <array> things.page(2,20)
First object <object> things.first()
Last object: <object> things.last()
Distinct items: <array> Array.distinct()
Sort array: <array> Array.order(<sort>)
Complex queries: <array> proton.db('things').all().distinct().sift(<query>).order(<sort>).top()
Meta Operations
---------------
List of sets: <array> proton.sets()
Dump all sets: <list> proton.dump()
Clear all sets: proton.wipe()