Salta ai contenuti
AggregaAggrega
Seleziona lingua: Italiano
Questa pagina è stata tradotta automaticamente. Leggi l’originale in inglese.

Panoramica dei template

Gli autori di Recipe e FeatureRecipe scrivono codice Go text/template in specifici punti di valutazione: le voci provides, le voci locals, valuesMapping (inline o caricato con $import:), il contenuto workload: (inline o caricato con $import:), le voci artifacts: (inline o caricate con $import: per singola voce), l’injectMapping delle FeatureRecipe, source:, le voci assertions:, e with: e when: di ciascuno step pipeline:. Ogni punto viene eseguito in una fase definita della pipeline di compilazione e riceve una vista definita del contesto dei pilastri. Questo insieme di capitoli documenta la superficie dei template: dove vengono eseguiti i template, che cosa espone il contesto in ogni punto e quali funzioni helper sono disponibili.

La forma del contesto dei template e l’ordine di valutazione sono contratti portanti: modificare l’uno o l’altro rompe ogni template di Recipe esistente. Il contesto dei template è definito formalmente in uno JSON Schema fornito con il compilatore; la matrice di valutazione per punto descrive quali pilastri sono leggibili in quale punto, e il motore di template Go viene fornito con la libreria di helper Sprig più estensioni specifiche di Aggrega. Le fasi della pipeline a cui sono ancorati questi punti di valutazione sono descritte a livello architetturale in ../architecture/10-compilation-pipeline.md: l’inject mapping per l’injectMapping delle FeatureRecipe, il preambolo dei locals e la risoluzione della sorgente per .locals e .source delle Recipe, il rendering di base per il valuesMapping delle Recipe di base, e il rendering delle feature per la Resource Generation delle FeatureRecipe.

Riferimento per argomento

  • Matrice di espansione dei template — la tabella autorevole per punto che copre ogni punto di valutazione dei template, quali pilastri legge ciascun punto e come gli output confluiscono nel grafo IR o nei sotto-passaggi a valle.
  • Contratto del contesto dei template — la forma formale del contesto dei template che il compilatore consegna ai template, inclusa la coppia a doppio stato .inject / .inject_raw e la proiezione JOIN arricchita .context.uses.
  • Dare un nome a una risorsa prodotta — quale delle due chiavi di identità nomina che cosa, la differenza tra un target uses e il riferimento che un producer pubblica, quali provider riportano un nome per le risorse che producono e perché gli altri non ne riportano nessuno, e l’arresto che rifiuta la chiave dove tale nome non esiste.
  • Funzioni e helper Sprig — gli helper Sprig disponibili nei template Go più le estensioni e gli helper di sicurezza specifici di Aggrega, come un numero scritto dall’autore viene letto, stampato e confrontato in un template di valore, e quali helper chiedono se un valore è stato scritto e quali se è vuoto.
  • Contesto dei parametri nei template — dove i valori parameters: forniti dalla Release raggiungono un template: interpolati nei template di valore prima che vengano eseguiti, e letti direttamente solo dai template di percorso.
  • Il blocco assertions: — le regole tra campi, con un nome, che un Component, una Feature, una Recipe o una FeatureRecipe dichiara come template, valutate prima del rendering.