Übersicht der Templates
Autoren von Recipes und FeatureRecipes schreiben Go-text/template-Code an bestimmten Auswertungsstellen: provides-Einträge, locals-Einträge, valuesMapping (inline oder per $import: geladen), workload:-Inhalt (inline oder per $import: geladen), artifacts:-Einträge (inline oder je Eintrag per $import: geladen), das injectMapping eines FeatureRecipe, source:, assertions:-Einträge sowie with: und when: jedes pipeline:-Schritts. Jede Stelle wird in einer definierten Phase der Kompilierungspipeline ausgeführt und erhält eine definierte Sicht auf den Säulenkontext. Diese Kapitelgruppe dokumentiert die Template-Oberfläche: wo Templates ausgeführt werden, was der Kontext an jeder Stelle bereitstellt und welche Hilfsfunktionen verfügbar sind.
Form des Template-Kontexts und Auswertungsreihenfolge sind tragende Verträge — Änderungen an einem von beiden brechen jedes bestehende Recipe-Template. Der Template-Kontext ist formal in einem JSON Schema definiert, das mit dem Compiler ausgeliefert wird; die Auswertungsmatrix je Stelle beschreibt, welche Säulen an welcher Stelle lesbar sind, und die Go-Template-Engine wird mit der Sprig-Hilfsbibliothek sowie Aggrega-spezifischen Erweiterungen ausgeliefert. Die Pipeline-Stufen, an denen diese Auswertungsstellen verankert sind, werden auf architektonischer Ebene in ../architecture/10-compilation-pipeline.md beschrieben — Inject-Mapping für das injectMapping eines FeatureRecipe, die Locals-Präambel und die Quellenauflösung für .locals und .source einer Recipe, Basis-Rendering für das valuesMapping einer Basis-Recipe und Feature-Rendering für die Resource Generation eines FeatureRecipe.
Referenz nach Thema
- Template-Expansionsmatrix — die maßgebliche Tabelle je Stelle, die jeden Template-Auswertungspunkt abdeckt, welche Säulen die Stelle liest und wie Ausgaben in den IR-Graphen oder nachgelagerte Teildurchläufe fließen.
- Vertrag des Template-Kontexts — die formale Form des Template-Kontexts, den der Compiler an Templates übergibt, einschließlich des Paars mit doppeltem Zustand
.inject/.inject_rawund der angereicherten JOIN-Projektion.context.uses. - Eine gerenderte Ressource benennen — welcher der beiden Identitätsschlüssel was benennt, der Unterschied zwischen einem
uses-Ziel und der Referenz, die ein Producer veröffentlicht, welche Provider einen Namen für die von ihnen gerenderten Ressourcen melden und warum die anderen keinen melden, sowie der Abbruch, der den Schlüssel ablehnt, wo kein solcher Name existiert. - Sprig-Funktionen und Helfer — die in Go-Templates verfügbaren Sprig-Helfer sowie Aggrega-spezifische Erweiterungen und Sicherheitshelfer, wie eine vom Autor geschriebene Zahl in einem Wert-Template gelesen, ausgegeben und verglichen wird und welche Helfer fragen, ob ein Wert geschrieben wurde, und welche, ob er leer ist.
- Parameter-Kontext in Templates — wo die vom Release erfüllten
parameters:-Werte ein Template erreichen: in Wert-Templates interpoliert, bevor diese ausgeführt werden, und direkt gelesen nur von Pfad-Templates. - Der
assertions:-Block — die benannten feldübergreifenden Regeln, die eine Component, ein Feature, eine Recipe oder ein FeatureRecipe als Templates deklariert und die vor dem Rendern ausgewertet werden.