yumemi/gen/emit/manual_verb
手書きの SQL の verb の口(B2a、0.16.0、server.verbs)── src/gen/verbs/<service>.gleam。
ManualVerb 1 行につき型付きの口 <name> を 1 本書き、runtime の verb の表(gen/runtime.mjs の verbs)に
行 '<service>/<name>' を足す。SQL は ★ の db/queries/<service>/<query>.sql($n は args の並びの順)。
値は生成の verb と同じ stageVerb が積むので、同じ transaction に Logic の呼びの順で入る。
型の字は「写しの表」(slot_of)で Gleam の型と DB の値型に引く。yumemi.At は要求の at、yumemi.NewKey は
new_<entity>() と同じ通し番号の列(x.nextId)の新しい id で、どちらも口の引数に出さない。
B2b:Key(<Entity>)(生成の key の在る Entity の er.Key、DB へは key の字)と List(<表の型>)(jsonb の穴 ['ja']、
中の値型は要素ごとに hook encode_<名> を通す)を表に足す。lock: True の口は runtime が transaction の先頭(先に
積んだ lock の後、他の文の前)に置く。checks の名は同じ Service の ★ query db/queries/<service>/<名>.sql で、
口の文の直後に確かめの文として積む。確かめが 0 行か、どこかの行の 1 列目が偽・NULL なら、framework.require_rows が
<名> を RAISE(P0001)して transaction ごと取り消し、要求は業務の失敗 <名> になる(status は B13 の
failures の表 → ★ failure_status → 422、0.16.0 B8)。確かめの穴は口と同じ値の先頭からその SQL が使う $n の数だけ。
第 63 条 手書きの verb の口(exit 4、SQL の file が無いのは exit 3):service が宣言に無い、同じ Service に
同じ name が 2 つ、args の型の字が写しの表に無い、名が Gleam の名でない・口の中の名と重なる。B2b で
足したもの:1 つの Service に lock: True が 2 つ、checks の名が符号にならない・SQL が無い(exit 3)・口の穴より
多い $n、query・checks が生成の SQL(-- GENERATED)や root の 1 文(root.sql)を指す、生成の口の module で
unqualified な型の名・module の名が重なる。C10 で足したもの:checks の名が conflict(verb の CAS の負けの符号と同じ字で、
確かめの落ちが consumer で業務の失敗に数えられず retry され続ける)。宣言の無い app は 1 行も出さず、生成物も変えない。
Types
引数 1 つの写し。Arg は口の引数(Gleam の型・import・encode の値型の名・jsonb の穴か)、At・NewKey は
runtime が入れる
pub type Slot {
Arg(
name: String,
gleam: String,
imports: List(#(String, String)),
scalar: option.Option(String),
json: Bool,
)
At
NewKey
}
Constructors
-
Arg( name: String, gleam: String, imports: List(#(String, String)), scalar: option.Option(String), json: Bool, ) -
At -
NewKey
Values
pub fn emit(
app: model.App,
hashes: hash.Hashes,
) -> List(types.File)
pub fn keys_declared(type_: String, keyed: List(String)) -> Bool
型の字に出る Key(<Entity>) の Entity がどれも生成の key の在る Entity か(B1a の Read の args も引く)
pub fn notes(
app: model.App,
app_queries: List(#(String, String)),
keyed: List(String),
) -> List(stop.Note)
第 63 条。app_queries は app の db/queries/**(道は .sql 無し)、keyed は生成の key の在る Entity の型名
(emit/back.keyed_entities、生成の key.gleam と同じ判定)
pub fn placeholders(sql: String) -> Int
SQL の字に出る $n の最大(無ければ 0)。注記(-- の行・/* */)と字('…'・$tag$…$tag$)の中は数えない
── ★ SQL は頭の注記に $n を書く慣例(B2b のゲート 2 の P1-2)。確かめの SQL の穴は先頭から詰めて書く
pub fn runtime_table(
app: model.App,
queries: List(#(String, String)),
) -> List(#(String, String))
runtime の verb の表の行(emit/runtime の verbs に足す)。穴の並びは args の順、
口の引数は ['a', 何番目, 値型](List(…) は ['ja', 何番目]、中が値型なら ['ja', 何番目, 値型])、At は ['at']、NewKey は ['id'](x.nextId)。
lock: True は lock:true、checks は checks:[['<service>/<名>','<名>',穴の数]](宣言の無い口は B2a の行のまま)。
queries は app の db/queries/**(確かめの SQL の $n を数える)
pub fn slot_of(
app: model.App,
name: String,
type_: String,
) -> Result(Slot, Nil)
写しの表。型の字 -> 引数の写し。表に無ければ Error。Key(<Entity>) は Entity の型名なら通す(生成の key の在る
Entity かは第 63 条が keyed で見る)
pub fn type_names(app: model.App, keyed: List(String)) -> String
写しの表の型の字と包み(B1a の Read の args も同じ表を引く)