firestore-clj.core — polvo/firestore-clj 0.3.0

->atom clj

(->atom q)

(->atom q
        {:keys [error-handler plain-fn]
         :or {error-handler identity plain-fn snapshot->data}})

Returns an atom holding the latest value of a DocumentReference or Query.

add! clj

(add! c m)

Adds a document to a collection. Its id will be automatically generated.

add-listener clj

(add-listener q f)

Adds a snapshot listener to a DocumentReference or Query.

Listener is a fn of arity 2. First arg is the QuerySnapshot, second arg is a FirestoreException. Returns an ListenerRegistration object.

array-remove clj

(array-remove & vs)

Used with set! and merge!. Removes values from an array field.

array-union clj

(array-union & vs)

Used with set! and merge!. Adds unique values to an array field.

assoc clj

(assoc context d & kvs)

Associates new keys and values in a batched write/transaction context.

assoc! clj

(assoc! d & kvs)

Associates new keys and values.

batch clj

(batch db)

Get a new write batch

client-with-creds clj

(client-with-creds creds-path)

Creates a client from a credentials JSON file.

coll clj

(coll db coll-name)

Returns a CollectionReference for the collection of given name.

commit! clj

(commit! b)

Commits a write batch.

create! clj

(create! d m)

Creates a new document at the DocumentReference's location. Fails if the document exists.

default-client clj

(default-client project-id)

Gets default client i.e. using a service account.

delete clj

(delete context d)

Deletes a document in a batched write/transaction context.

delete! clj

(delete! d)

Deletes a document.

detach clj

(detach a)

Detaches an atom built with ->atom.

dissoc clj

(dissoc context d & ks)

Deletes keys in a batched write/transaction context.

dissoc! clj

(dissoc! d & ks)

Deletes keys.

doc clj

(doc c)

(doc c id)

Gets a DocumentReference given CollectionReference and an id. If id is not given, it will point to a new document with an auto-generated-id

doc->plain clj

(doc->plain s)

Represents a DocumentSnapshot as plain map.

doc->plain-with-id clj

(doc->plain-with-id s)

Represents a DocumentSnapshot as a [id plain-doc] pair

doc-snapshot clj

(doc-snapshot d)

(doc-snapshot d t)

Gets a QueryDocumentSnapshot given a DocumentReference and possibly a Transaction.

docs clj

(docs c ds)

Gets a vector of DocumentReferences, given a vector of ids

filter-contains clj

(filter-contains q field value)

Filters where field contains value.

filter-contains-any clj

(filter-contains-any q field arr)

Filters where field contains one of the values in arr.

filter-in clj

(filter-in q field arr)

Filters where field is one of the values in arr.

filter< clj

(filter< q field value)

Filters where field < value.

filter<= clj

(filter<= q field value)

Filters where field <= value.

filter= clj

(filter= q m)

(filter= q field value)

Filters where field = value. A map may be used for checking multiple equalities.

filter> clj

(filter> q field value)

Filters where field > value.

filter>= clj

(filter>= q field value)

Filters where field >= value.

id clj

(id d)

Returns the id of a DocumentReference or DocumentSnapshot.

inc clj

(inc v)

Used with set! and merge!. Increments a numeric field.

map! clj

(map! db q f & args)

Updates all docs in a vector or query by applying a function to them

mark-for-deletion clj

(mark-for-deletion)

Used with set! and merge!. A sentinel value that marks a field for deletion.

merge clj

(merge context d m)

Updates field of a document in a batched write/transaction context.

merge! clj

(merge! d m)

Updates fields of a document.

order-by clj

(order-by q & ordering)

Orders by a sequence of fields with optional directions. Notice that ordering by multiple fields requires creation of a composite index.

pull clj

(pull q)

(pull q t)

Pulls data from a DocumentReference or Query, possibly inside a transaction context.

pull-doc clj

Pulls clojure data from a DocumentReference.

pull-docs clj

(pull-docs ds)

(pull-docs ds t)

Pulls clojure data from a sequence of DocumentReferences, possibly inside a transaction context.

pull-query clj

Pulls results from a Query as clojure data.

pullv clj

Pulls query results as a vector of document data.

pullv-with-ids clj

Pulls query results as a vector of pairs. Each pair has an id and document data

query->plain-map clj

(query->plain-map s)

Represents a QuerySnapshot as a plain map whose keys are the document ids.

query->plainv clj

(query->plainv s)

Represents a QuerySnapshot as a plain vector of document data.

query->plainv-with-ids clj

(query->plainv-with-ids s)

Represents a QuerySnapshot as a plain vector of [id doc] pairs.

query-snapshot clj

(query-snapshot q)

(query-snapshot q t)

Gets a QuerySnapshot given a Query and possibly a Transaction.

server-timestamp clj

(server-timestamp)

Used with set! and merge!. Timestamp for when the update operation is performed on server.

set clj

(set context d m)

Creates or overwrites a document in a batched write/transaction context.

set! clj

(set! d m)

Creates or overwrites a document.

snapshot->data clj

(snapshot->data s)

Gets a DocumentSnapshot/CollectionSnapshot/QuerySnapshot's underlying data.

take clj

(take q n)

Limits results to a certain number.

transact! clj

(transact! db f)

(transact! db f {:keys [attempts executor] :as options})

Performs a transaction. Optionally, you can specify an executor and the maximum number of attemps.

update! clj

(update! db d f & args)

Updates a document by applying a function to it.

update-field! clj

(update-field! db d field f & args)

Updates a single field of a document by applying a function to it.