doc.go RawHistoryFolder

1// SPDX-License-Identifier: MIT
2
3// Package template reads, validates and evaluates GitHub Actions workflow
4// templates: YAML documents whose strings may contain ${{ }} expressions.
5//
6// It is a port of the template layer of the npm package
7// @actions/workflow-parser 0.3.61 (MIT, GitHub, actions/languageservices):
8// the same tokens, the same reading rules and, where feasible, the same error
9// messages. The workflow schema (schema/workflow-v1.0.min.json) is vendored
10// unmodified and drives both validation and the contexts and functions that
11// each key may use in its expressions.
12//
13// [ReadYAML] turns a document into a tree of [Token] values, checked against
14// a [Schema]; problems are collected in a [Context] as [Error] values. A
15// string holding expressions becomes a [*BasicExpression] (a single ${{ }}) or
16// a format() call that joins the literal text and the expressions; ${{ insert }}
17// becomes an [*InsertExpression]. [Evaluate] later computes a token against
18// named contexts and functions, using package expr.
19//
20// Differences from the reference are listed in PORTING.md.
21package template