Ikhtisar template
Penulis Recipe dan FeatureRecipe menulis kode Go text/template di titik evaluasi tertentu: entri provides, entri locals, valuesMapping (inline atau dimuat dengan $import:), konten workload: (inline atau dimuat dengan $import:), entri artifacts: (inline atau dimuat dengan $import: per entri), injectMapping milik FeatureRecipe, source:, entri assertions:, serta with: dan when: di setiap langkah pipeline:. Setiap titik berjalan pada fase yang ditentukan dalam pipeline kompilasi dan menerima tampilan konteks pilar yang ditentukan. Kumpulan bab ini mendokumentasikan permukaan template: di mana template berjalan, apa yang diekspos konteks di setiap titik, dan fungsi helper mana yang tersedia.
Bentuk konteks template dan urutan evaluasi adalah kontrak penopang — perubahan pada salah satunya merusak setiap template Recipe yang ada. Konteks template didefinisikan secara formal dalam JSON Schema yang disertakan bersama compiler; matriks evaluasi per titik menjelaskan pilar mana yang dapat dibaca di titik mana, dan mesin template Go disertakan dengan pustaka helper Sprig ditambah ekstensi khusus Aggrega. Tahapan pipeline yang menjadi jangkar titik-titik evaluasi ini dijelaskan pada tingkat arsitektural di ../architecture/10-compilation-pipeline.md — inject mapping untuk injectMapping milik FeatureRecipe, pembuka locals dan resolusi sumber untuk .locals dan .source milik Recipe, render dasar untuk valuesMapping milik Recipe dasar, dan render fitur untuk Resource Generation milik FeatureRecipe.
Referensi per topik
- Matriks ekspansi template — tabel otoritatif per titik yang mencakup setiap titik evaluasi template, pilar mana yang dibaca titik tersebut, dan bagaimana output mengalir ke graf IR atau sub-pass hilir.
- Kontrak konteks template — bentuk formal konteks template yang diberikan compiler kepada template, termasuk pasangan status ganda
.inject/.inject_rawdan proyeksi JOIN.context.usesyang diperkaya. - Menamai sumber daya yang dirender — mana dari dua kunci identitas yang menamai apa, perbedaan antara target
usesdan referensi yang dipublikasikan produsen, provider mana yang melaporkan nama untuk sumber daya yang direndernya dan mengapa yang lain tidak melaporkan apa pun, serta penghentian yang menolak kunci tersebut jika nama semacam itu tidak ada. - Fungsi dan helper Sprig — helper Sprig yang tersedia di dalam template Go ditambah ekstensi dan helper keamanan khusus Aggrega, cara angka yang ditulis dibaca, dicetak, dan dibandingkan dalam template nilai, serta helper mana yang menanyakan apakah suatu nilai ditulis dan mana yang menanyakan apakah nilai itu kosong.
- Konteks template parameter — tempat nilai
parameters:yang dipenuhi Release mencapai template: diinterpolasi ke dalam template nilai sebelum template tersebut berjalan, dan hanya dibaca langsung oleh template path. - Blok
assertions:— aturan lintas bidang bernama yang dideklarasikan sebuah Component, Feature, Recipe, atau FeatureRecipe sebagai template, yang dievaluasi sebelum render.