Welcome!
47 | {{ else }} 48 |Nice to see you again!
49 | {{ end }} 50 |-
51 | {{ range .GoodPoints }}
52 |
- {{ . }} 53 | {{ end }} 54 |
61 | //
62 | // is a single token in HTML's grammar but in a template spans several nodes.
63 | type state uint8
64 |
65 | //go:generate stringer -type state
66 |
67 | const (
68 | // stateText is parsed character data. An HTML parser is in
69 | // this state when its parse position is outside an HTML tag,
70 | // directive, comment, and special element body.
71 | stateText state = iota
72 | // stateSpecialElementBody occurs inside a specal HTML element body.
73 | stateSpecialElementBody
74 | // stateTag occurs before an HTML attribute or the end of a tag.
75 | stateTag
76 | // stateAttrName occurs inside an attribute name.
77 | // It occurs between the ^'s in ` ^name^ = value`.
78 | stateAttrName
79 | // stateAfterName occurs after an attr name has ended but before any
80 | // equals sign. It occurs between the ^'s in ` name^ ^= value`.
81 | stateAfterName
82 | // stateBeforeValue occurs after the equals sign but before the value.
83 | // It occurs between the ^'s in ` name =^ ^value`.
84 | stateBeforeValue
85 | // stateHTMLCmt occurs inside an .
86 | stateHTMLCmt
87 | // stateAttr occurs inside an HTML attribute whose content is text.
88 | stateAttr
89 | // stateError is an infectious error state outside any valid
90 | // HTML/CSS/JS construct.
91 | stateError
92 | )
93 |
94 | // isComment reports whether a state contains content meant for template
95 | // authors & maintainers, not for end-users or machines.
96 | func isComment(s state) bool {
97 | switch s {
98 | case stateHTMLCmt:
99 | return true
100 | }
101 | return false
102 | }
103 |
104 | // isInTag reports whether s occurs solely inside an HTML tag.
105 | func isInTag(s state) bool {
106 | switch s {
107 | case stateTag, stateAttrName, stateAfterName, stateBeforeValue, stateAttr:
108 | return true
109 | }
110 | return false
111 | }
112 |
113 | // delim is the delimiter that will end the current HTML attribute.
114 | type delim uint8
115 |
116 | //go:generate stringer -type delim
117 |
118 | const (
119 | // delimNone occurs outside any attribute.
120 | delimNone delim = iota
121 | // delimDoubleQuote occurs when a double quote (") closes the attribute.
122 | delimDoubleQuote
123 | // delimSingleQuote occurs when a single quote (') closes the attribute.
124 | delimSingleQuote
125 | // delimSpaceOrTagEnd occurs when a space or right angle bracket (>)
126 | // closes the attribute.
127 | delimSpaceOrTagEnd
128 | )
129 |
130 | type element struct {
131 | // name is the lowercase name of the element. If context joining has occurred, name
132 | // will be arbitrarily assigned the element name from one of the joined contexts.
133 | name string
134 | // names contains all possible names the element could assume because of context joining.
135 | // For example, after joining the contexts in the "if" and "else" branches of
136 | // {{if .C}}`,
137 | // names will contain "img" and "audio".
138 | // names can also contain empty strings, which represent joined contexts with no element name.
139 | // names will be empty if no context joining occurred.
140 | names []string
141 | }
142 |
143 | // eq reports whether a and b have the same name. All other fields are ignored.
144 | func (e element) eq(d element) bool {
145 | return e.name == d.name
146 | }
147 |
148 | // String returns the string representation of the element.
149 | func (e element) String() string {
150 | return "element" + strings.Title(e.name)
151 | }
152 |
153 | // attr represents the attribute that the parser is in, that is,
154 | // starting from stateAttrName until stateTag/stateText (exclusive).
155 | type attr struct {
156 | // name is the lowercase name of the attribute. If context joining has occurred, name
157 | // will be arbitrarily assigned the attribute name from one of the joined contexts.
158 | name string
159 | // value is the value of the attribute. If context joining has occurred, value
160 | // will be arbitrarily assigned the attribute value from one of the joined contexts.
161 | // If there are multiple actions in the attribute value, value will contain the
162 | // concatenation of all values seen so far. For example, in
163 | //
164 | // value is "foo" at "{{.X}}" and "foobar" at "{{.Y}}".
165 | value string
166 | // ambiguousValue indicates whether value contains an ambiguous value due to context-joining.
167 | ambiguousValue bool
168 | // names contains all possible names the attribute could assume because of context joining.
169 | // For example, after joining the contexts in the "if" and "else" branches of
170 | //
171 | // names will contain "title" and "name".
172 | // names can also contain empty strings, which represent joined contexts with no attribute name.
173 | // names will be empty if no context joining occurred.
174 | names []string
175 | }
176 |
177 | // eq reports whether a and b have the same name. All other fields are ignored.
178 | func (a attr) eq(b attr) bool {
179 | return a.name == b.name
180 | }
181 |
182 | // String returns the string representation of the attr.
183 | func (a attr) String() string {
184 | return "attr" + strings.Title(a.name)
185 | }
186 |
--------------------------------------------------------------------------------
/template/delim_string.go:
--------------------------------------------------------------------------------
1 | // Code generated by "stringer -type Delim"; DO NOT EDIT
2 |
3 | package template
4 |
5 | import "fmt"
6 |
7 | const _Delim_name = "DelimNoneDelimDoubleQuoteDelimSingleQuoteDelimSpaceOrTagEnd"
8 |
9 | var _Delim_index = [...]uint8{0, 9, 25, 41, 59}
10 |
11 | func (i delim) String() string {
12 | if i >= delim(len(_Delim_index)-1) {
13 | return fmt.Sprintf("delim(%d)", i)
14 | }
15 | return _Delim_name[_Delim_index[i]:_Delim_index[i+1]]
16 | }
17 |
--------------------------------------------------------------------------------
/template/error.go:
--------------------------------------------------------------------------------
1 | // Copyright 2017 The Go Authors. All rights reserved.
2 | // Use of this source code is governed by a BSD-style
3 | // license that can be found in the LICENSE file.
4 |
5 | package template
6 |
7 | import (
8 | "fmt"
9 | "text/template/parse"
10 | )
11 |
12 | // Error describes a problem encountered during template Escaping.
13 | type Error struct {
14 | // ErrorCode describes the kind of error.
15 | ErrorCode ErrorCode
16 | // Node is the node that caused the problem, if known.
17 | // If not nil, it overrides Name and Line.
18 | Node parse.Node
19 | // Name is the name of the template in which the error was encountered.
20 | Name string
21 | // Line is the line number of the error in the template source or 0.
22 | Line int
23 | // Description is a human-readable description of the problem.
24 | Description string
25 | }
26 |
27 | // ErrorCode is a code for a kind of error.
28 | type ErrorCode int
29 |
30 | // We define codes for each error that manifests while escaping templates, but
31 | // escaped templates may also fail at runtime.
32 | //
33 | // Output: "ZgotmplZ"
34 | // Example:
35 | //
36 | // 
37 | // where {{.X}} evaluates to `javascript:...`
38 | //
39 | // Discussion:
40 | //
41 | // "ZgotmplZ" is a special value that indicates that unsafe content reached a
42 | // CSS or URL context at runtime. The output of the example will be
43 | // 
44 | // If the data comes from a trusted source, use content types to exempt it
45 | // from filtering: URL(`javascript:...`).
46 | const (
47 | // OK indicates the lack of an error.
48 | OK ErrorCode = iota
49 |
50 | // ErrAmbigContext: "... appears in an ambiguous context within a URL"
51 | // Example:
52 | //
60 | // Discussion:
61 | // {{.X}} is in an ambiguous URL context since, depending on {{.C}},
62 | // it may be either a URL suffix or a query parameter.
63 | // Moving {{.X}} into the condition removes the ambiguity:
64 | //
65 | ErrAmbigContext
66 |
67 | // ErrBadHTML: "expected space, attr name, or end of tag, but got ...",
68 | // "... in unquoted attr", "... in attribute name"
69 | // Example:
70 | //
71 | //
72 | //