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 code(sql: String) -> String

注記と字を空白 1 つに替えた SQL(B1a の Read が SELECT の列の名を読む)

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 も同じ表を引く)

✨ Search Document