05: progressive construction

At the beginning of this tutorial, I told you that add-ents takes an ent db as an argument:
1
(sm/add-ents {:schema schema} {:post [[1]]})
Copied!
You may have wondered why the empty ent db {:schema schema} is used, rather than just directly passing in schema; why don't we just write this?
1
(sm/add-ents schema {:post [[1]]})
Copied!
The reason the first argument to add-ents is an ent db is so you can take the return value of add-ents and pass it in as the first argument to further calls to add-ents:
1
(ns reifyhealth.specmonstah-tutorial.05
2
  (:require [reifyhealth.specmonstah.core :as sm]))
3
​
4
(def schema
5
  {:user  {:prefix :u}
6
   :topic {:prefix    :t
7
           :relations {:owner-id [:user :id]}}})
8
​
9
(defn ex-01
10
  []
11
  (let [ent-db-1 (sm/add-ents {:schema schema} {:topic [[1]]})
12
        ent-db-2 (sm/add-ents ent-db-1 {:topic [[1]
13
                                                [1 {:refs {:owner-id :hamburglar}}]]})]
14
    (sm/view ent-db-1)
15
    (sm/view ent-db-2)))
16
​
17
(ex-01)
18
​
Copied!
Additional calls to add-ents are additive; they will never alter existing ents, and will only add new ents. The first call, (sm/add-ents {:schema schema} {:topic [[1]]}), produces a :topic named :t0 referencing a :user named :u0:
That ent db is passed to the next call:
1
(sm/add-ents ent-db-1 {:topic [[1]
2
                               [1 {:refs {:owner-id :hamburglar}}]]})
Copied!
This creates two more topics:
The default naming system picks up where it left off, giving the topic the names :t1 and :t2. :t1 references the existing user, :u0, and :t2 references a new user from the :refs, :hamburglar. When progressively generating an ent-db, you can expect Specmonstah to behave as if all queries were passed as a single query to a single call of add-ents.
Everything you've learned up to this point has focused on generating an ent db: you've learned a bit about how to use schemas and queries together to concisely specify what ents to create. You've also learned how to customize the relationships with the :refs query option.
In the next couple sections, you'll learn about how Specmonstah uses visitation to generate and insert business data.

04: refs

06: spec-gen

Last modified 2yr ago

Copy link