asami.entities.reader — org.clojars.quoll/asami 2.3.4

Reads structured data from a graph.

*nested-structs* clj/s

build-list clj/s

(build-list graph seen pairs)

Inputs: [graph :- GraphType seen :- #{NodeType} pairs :- [KeyValue]] Returns: [s/Any]

Takes property/value pairs and if they represent a list node, returns the list. else, nil.

check-structure clj/s

(check-structure graph prop v)

Inputs: [graph :- GraphType prop :- s/Any v :- s/Any] Returns: (s/maybe [KeyValue])

Determines if a value represents a structure. If so, return the property/values for it. Otherwise, return nil.

get-a-first clj/s

(get-a-first struct)

Finds the a/first property in a map, and gets the value.

graph->entities clj/s

(graph->entities graph)

(graph->entities graph nested?)

(graph->entities graph nested? exclusions)

Inputs: ([graph :- GraphType] [graph :- GraphType nested? :- s/Bool] [graph :- GraphType nested? :- s/Bool exclusions :- (s/maybe #{s/Keyword})]) Returns: [EntityMap]

Pulls all top level entities out of a store

ident->entity clj/s

(ident->entity graph ident)

(ident->entity graph ident nested?)

Inputs: ([graph :- GraphType ident :- s/Any] [graph :- GraphType ident :- s/Any nested? :- s/Bool]) Returns: EntityMap

Converts data in a database to a data structure suitable for JSON encoding Accepts an internal node identifier to identify the entity object

into-multimap clj/s

(into-multimap xform kvs)

Inputs: [xform kvs :- [[(s/one s/Any "Key") (s/one s/Any "Value")]]]

Takes key/value tuples and inserts them into a map. If there are duplicate keys then create a set for the values.

MapOrList clj/s

NodeType clj/s

pairs->struct clj/s

(pairs->struct graph prop-vals)

(pairs->struct graph prop-vals seen)

Inputs: ([graph :- GraphType prop-vals :- [KeyValue]] [graph :- GraphType prop-vals :- [KeyValue] seen :- #{NodeType}]) Returns: EntityMap

Uses a set of property-value pairs to load up a nested data structure from the graph

property-values clj/s

(property-values graph entity)

Inputs: [graph :- GraphType entity :- s/Any] Returns: [KeyValue]

Return all the property/value pairs for a given entity in the store.

recurse-node clj/s

(recurse-node graph seen [prop v :as prop-val])

Inputs: [graph :- GraphType seen :- #{NodeType} [prop v :as prop-val] :- KeyValue] Returns: s/Any

Determines if the val of a map entry is a node to be recursed on, and loads if necessary. If referring directly to a top level node, then short circuit and return the ID

ref->entity clj/s

(ref->entity graph entity-id)

(ref->entity graph entity-id nested?)

(ref->entity graph entity-id nested? exclusions)

Inputs: ([graph :- GraphType entity-id :- s/Any] [graph :- GraphType entity-id :- s/Any nested? :- s/Bool] [graph :- GraphType entity-id :- s/Any nested? :- s/Bool exclusions :- (s/maybe #{(s/cond-pre s/Keyword s/Str)})]) Returns: EntityMap

Uses an id node to load up a nested data structure from the graph. Accepts a value that identifies the internal node.

vbuild-list clj/s

(vbuild-list graph seen pairs)

Inputs: [graph :- GraphType seen :- #{NodeType} pairs :- [KeyValue]] Returns: [s/Any]

Calls build-list, converting to a vector as the final step