seql.core — exoscale/seql 0.1.29

A way to interact with stored entities

add-condition clj

(add-condition schema q [condition & args])

If conditions are provided, add them to the query

add-ident clj

(add-ident q entity-name ident arg)

Add a where clause for an ident

add-listener! clj

(add-listener! env mutation handler)

(add-listener! env mutation key handler)

Given an environment, add a mutation handler. The handlers is bound by key, if specified, otherwise the key will default to the mutation key. Yields an updated environment

build-query clj

(build-query env entity fields [entity-name entity-def ident args])

Build a base query preparing joins when needed

entity-schema clj

(entity-schema {:keys [schema]} entity)

Look up entity in schema. Takes a schema and an entity. The entity argument can take be of two different shapes: it can be a keyword that will match the namespace of the entity in question or a coll of namespaced keyword (ident name) and arguments

mutate! clj

(mutate! env mutation params)

(mutate! env mutation params metadata)

Perform a mutation. Since mutations are spec'd, parameters are expected to conform it.

process-field clj

(process-field schema {:keys [relations compounds fields]})

Add necessary stanzas to realize field targeting with SQL

process-join clj multimethod

Process join by relation type. Takes a base query, a map with :entity and :table keys and a map of options to build the relation

qualify-key clj

(qualify-key k)

Given the enforced terminology at query time, yield back a qualified keyword

query clj

(query env entity)

(query env entity fields)

(query env entity fields conditions)

Look up entities.

recompose-relations clj

(recompose-relations schema fields records)

The join query perfomed by query returns a flat list of entries, potentially unsorted (this is database implementation specific) recompose a tree of entities as specified in fields.

remove-listener! clj

(remove-listener! env mutation)

(remove-listener! env mutation key)

Given an environment, remove a mutation handler by key if specified, otherwise it will remove a handler that match the mutation key. Yields an updated environment.

sql-query clj

(sql-query env entity fields conditions)

Build a SQL query for the pull-syntax expressed. This is an incremental data-based creation of a

table-field clj

(table-field table field)

transform-for-join clj

(transform-for-join k)

Takes a namespace keyword and returns an identifier in valid SQL format

transform-out clj

(transform-out k)

Takes a namespaced keyword and prepare name transforms. Returns a tuple of database name to aliased name.