Compare commits

..

1 Commits

Author SHA1 Message Date
fc6e1744bd Handle more function call error cases 2024-02-12 10:50:53 -08:00
18 changed files with 481 additions and 1268 deletions

View File

@@ -99,7 +99,7 @@ In this example:
### `for` tag ### `for` tag
Salix's `for` tag is used for iterating over iterable variables, such as slices, maps, iterator functions, etc. It can assign one or two variables depending on your needs. When using a single variable, it sets that variable to the current element in the case of slices or arrays, or the current value for maps. With two variables, it assigns the first to the index (in the case of slices or arrays) or the key (for maps), and the second to the element or value, respectively. Here's an example of the for tag in action: Salix's `for` tag is used for iterating over slices, arrays, and maps. It can assign one or two variables depending on your needs. When using a single variable, it sets that variable to the current element in the case of slices or arrays, or the current value for maps. With two variables, it assigns the first to the index (in the case of slices or arrays) or the key (for maps), and the second to the element or value, respectively. Here's an example of the for tag in action:
``` ```
#for(id, name in users): #for(id, name in users):
@@ -129,8 +129,6 @@ The include tag allows you to import content from other templates in the namespa
#include("header.html") #include("header.html")
``` ```
If the file name starts with a question mark, nonexistent files will be ignored.
#### Using the `include` tag with extra arguments #### Using the `include` tag with extra arguments
The `include` tag can accept extra local variables as arguments. Here's an example with a `title` variable: The `include` tag can accept extra local variables as arguments. Here's an example with a `title` variable:
@@ -155,8 +153,6 @@ The macro tag is a powerful feature that allows you to define reusable template
When a macro tag has a block, it sets the macro's content. When it doesn't, it inserts the contents of the macro. In the above example, a macro is defined and then inserted. When a macro tag has a block, it sets the macro's content. When it doesn't, it inserts the contents of the macro. In the above example, a macro is defined and then inserted.
If the macro name starts with a question mark, nonexistent macros will be ignored.
#### Using the `macro` tag with extra arguments #### Using the `macro` tag with extra arguments
Similar to the `include` tag, the `macro` tag can accept extra local variables as arguments. You can define these variables when including the macro. Here's an example: Similar to the `include` tag, the `macro` tag can accept extra local variables as arguments. You can define these variables when including the macro. Here's an example:
@@ -174,7 +170,6 @@ Functions used in a template can accept any number of arguments but are limited
Salix includes several useful global functions in all templates: Salix includes several useful global functions in all templates:
- `len(v any) int`: Returns the length of the value passed in. If the length can't be found for the value passed in, it returns an error. - `len(v any) int`: Returns the length of the value passed in. If the length can't be found for the value passed in, it returns an error.
- `json(v any) string`: Returns a JSON string for the value passed in.
- `toUpper(s string) string`: Returns `s`, but with all characters mapped to their uppercase equivalents. - `toUpper(s string) string`: Returns `s`, but with all characters mapped to their uppercase equivalents.
- `toLower(s string) string`: Returns `s`, but with all characters mapped to their lowercase equivalents. - `toLower(s string) string`: Returns `s`, but with all characters mapped to their lowercase equivalents.
- `hasPrefix(s, prefix string) bool`: Returns true if `s` starts with `prefix`. - `hasPrefix(s, prefix string) bool`: Returns true if `s` starts with `prefix`.
@@ -186,8 +181,6 @@ Salix includes several useful global functions in all templates:
- `count(s, substr string) int`: Returns the amount of times that `substr` appears in `s`. - `count(s, substr string) int`: Returns the amount of times that `substr` appears in `s`.
- `split(s, sep string) []string`: Returns a slice containing all substrings separated by `sep`. - `split(s, sep string) []string`: Returns a slice containing all substrings separated by `sep`.
- `join(ss []string, sep string) string`: Returns a string with all substrings in `ss` joined by `sep`. - `join(ss []string, sep string) string`: Returns a string with all substrings in `ss` joined by `sep`.
- `replace(s, old, new string, n int)`: Returns a string with `n` occurrences of `old` in `s` replaced with `new`.
- `replaceAll(s, old, new string)`: Returns a string with all occurrences of `old` in `s` replaced with `new`.
### Adding Custom Functions ### Adding Custom Functions

View File

@@ -20,14 +20,6 @@ func (p Position) String() string {
return fmt.Sprintf("%s: line %d, col %d", p.Name, p.Line, p.Col) return fmt.Sprintf("%s: line %d, col %d", p.Name, p.Line, p.Col)
} }
type Nil struct {
Position Position
}
func (n Nil) Pos() Position {
return n.Position
}
type Tag struct { type Tag struct {
Name Ident Name Ident
Params []Node Params []Node
@@ -72,24 +64,6 @@ type Value struct {
Not bool Not bool
} }
type Map struct {
Map map[Node]Node
Position Position
}
func (m Map) Pos() Position {
return m.Position
}
type Array struct {
Array []Node
Position Position
}
func (a Array) Pos() Position {
return a.Position
}
type Expr struct { type Expr struct {
First Node First Node
Operator Operator Operator Operator

View File

@@ -1,4 +1,4 @@
<head> <head>
<title>#(title)</title> <title>#(title)</title>
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bulma@1.0.0/css/bulma.min.css"> <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bulma@0.9.4/css/bulma.min.css">
</head> </head>

View File

@@ -1,7 +1,7 @@
<html> <html>
<head> <head>
<title>#(title)</title> <title>#(title)</title>
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bulma@1.0.0/css/bulma.min.css"> <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bulma@0.9.4/css/bulma.min.css">
</head> </head>
<body> <body>
<nav class="navbar is-dark"> <nav class="navbar is-dark">

View File

@@ -1,19 +1,16 @@
<html> <html>
<head>
<head> <title>#(page.Title)</title>
<title>#(page.Title)</title> </head>
</head> <body>
#for(i, user in users):
<body> <div>
#for(i, user in users): <h2>#(toLower(user.Name))</h2>
<div> <p>User ID: #(i)</p>
<h2>#(toLower(user.Name))</h2> #if(user.LoggedIn): <p>This user is logged in</p> #!if
<p>User ID: #(i)</p> #if(user.IsAdmin): <p>This user is an admin!</p> #!if
#if(user.LoggedIn): <p>This user is logged in</p> #!if <p>Registered: #(user.RegisteredTime.Format("01-02-2006"))</p>
#if(user.IsAdmin): <p>This user is an admin!</p> #!if </div>
<p>Registered: #(user.RegisteredTime.Format("01-02-2006"))</p> #!for
</div> </body>
#!for
</body>
</html> </html>

74
expr.go
View File

@@ -32,14 +32,28 @@ func (t *Template) evalExpr(expr ast.Expr, local map[string]any) (any, error) {
return a.Interface(), nil return a.Interface(), nil
} }
func (t *Template) performOp(a, b reflect.Value, op ast.Operator) (result any, err error) { func (t *Template) performOp(a, b reflect.Value, op ast.Operator) (any, error) {
if op.Value == "in" { if op.Value == "in" {
a, b, err = handleIn(op, a, b) switch b.Kind() {
if err != nil { case reflect.Slice, reflect.Array:
return nil, err if a.CanConvert(b.Type().Elem()) {
a = a.Convert(b.Type().Elem())
} else {
return nil, ast.PosError(op, "mismatched types in expression (%s and %s)", a.Type(), b.Type())
}
case reflect.Map:
if a.CanConvert(b.Type().Key()) {
a = a.Convert(b.Type().Key())
} else {
return nil, ast.PosError(op, "mismatched types in expression (%s and %s)", a.Type(), b.Type())
}
case reflect.String:
if a.Kind() != reflect.String {
return nil, ast.PosError(op, "mismatched types in expression (%s and %s)", a.Type(), b.Type())
}
default:
return nil, ast.PosError(op, "the in operator can only be used on strings, arrays, and slices (got %s and %s)", a.Type(), b.Type())
} }
} else if !a.IsValid() || !b.IsValid() {
return handleNil(op, a, b)
} else if b.CanConvert(a.Type()) { } else if b.CanConvert(a.Type()) {
b = b.Convert(a.Type()) b = b.Convert(a.Type())
} else { } else {
@@ -160,51 +174,3 @@ func (t *Template) performOp(a, b reflect.Value, op ast.Operator) (result any, e
} }
return false, ast.PosError(op, "unknown operator: %q", op.Value) return false, ast.PosError(op, "unknown operator: %q", op.Value)
} }
func handleIn(op ast.Operator, a, b reflect.Value) (c, d reflect.Value, err error) {
switch b.Kind() {
case reflect.Slice, reflect.Array:
if a.CanConvert(b.Type().Elem()) {
a = a.Convert(b.Type().Elem())
} else {
return a, b, ast.PosError(op, "mismatched types in expression (%s and %s)", a.Type(), b.Type())
}
case reflect.Map:
if a.CanConvert(b.Type().Key()) {
a = a.Convert(b.Type().Key())
} else {
return a, b, ast.PosError(op, "mismatched types in expression (%s and %s)", a.Type(), b.Type())
}
case reflect.String:
if a.Kind() != reflect.String {
return a, b, ast.PosError(op, "mismatched types in expression (%s and %s)", a.Type(), b.Type())
}
default:
return a, b, ast.PosError(op, "the in operator can only be used on strings, arrays, and slices (got %s and %s)", a.Type(), b.Type())
}
return a, b, nil
}
func handleNil(op ast.Operator, a, b reflect.Value) (any, error) {
if !a.IsValid() && !b.IsValid() {
return true, nil
} else if !a.IsValid() {
return nil, ast.PosError(op, "nil must be on the right side of an expression")
} else if !b.IsValid() {
if op.Value != "==" && op.Value != "!=" {
return nil, ast.PosError(op, "invalid operator for nil value (expected == or !=, got %s)", op.Value)
}
switch a.Kind() {
case reflect.Chan, reflect.Slice, reflect.Map, reflect.Func, reflect.Interface, reflect.Pointer:
if op.Value == "==" {
return a.IsNil(), nil
} else {
return !a.IsNil(), nil
}
default:
return nil, ast.PosError(op, "values of type %s cannot be compared against nil", a.Type())
}
}
return nil, nil
}

View File

@@ -1,7 +1,6 @@
package salix package salix
import ( import (
"errors"
"reflect" "reflect"
"go.elara.ws/salix/ast" "go.elara.ws/salix/ast"
@@ -11,26 +10,34 @@ import (
type forTag struct{} type forTag struct{}
func (ft forTag) Run(tc *TagContext, block, args []ast.Node) error { func (ft forTag) Run(tc *TagContext, block, args []ast.Node) error {
if len(args) == 0 || len(args) > 3 { if len(args) == 0 || len(args) > 2 {
return tc.PosError(tc.Tag, "invalid argument amount") return tc.PosError(tc.Tag, "invalid argument amount")
} }
expr, ok := args[len(args)-1].(ast.Expr) var expr ast.Expr
if !ok { if len(args) == 1 {
return tc.PosError(args[0], "invalid argument type: %T (expected ast.Expr)", args[0]) expr2, ok := args[0].(ast.Expr)
if !ok {
return tc.PosError(args[0], "invalid argument type: %T (expected ast.Expr)", args[0])
}
expr = expr2
} else if len(args) == 2 {
expr2, ok := args[1].(ast.Expr)
if !ok {
return tc.PosError(args[1], "invalid argument type: %T (expected ast.Expr)", args[1])
}
expr = expr2
} }
var vars []string var vars []string
var in reflect.Value var in reflect.Value
if len(args) > 1 { if len(args) == 2 {
for _, arg := range args[:len(args)-1] { varName, ok := unwrap(args[0]).(ast.Ident)
varName, ok := unwrap(arg).(ast.Ident) if !ok {
if !ok { return tc.PosError(args[0], "invalid argument type: %T (expected ast.Ident)", expr.First)
return tc.PosError(arg, "invalid argument type: %T (expected ast.Ident)", expr.First)
}
vars = append(vars, varName.Value)
} }
vars = append(vars, varName.Value)
} }
varName, ok := unwrap(expr.First).(ast.Ident) varName, ok := unwrap(expr.First).(ast.Ident)
@@ -55,15 +62,6 @@ func (ft forTag) Run(tc *TagContext, block, args []ast.Node) error {
in = reflect.ValueOf(val) in = reflect.ValueOf(val)
switch in.Kind() { switch in.Kind() {
case reflect.Int:
local := map[string]any{}
for i := range in.Int() {
local[vars[0]] = i
err = tc.Execute(block, local)
if err != nil {
return err
}
}
case reflect.Slice, reflect.Array: case reflect.Slice, reflect.Array:
local := map[string]any{} local := map[string]any{}
for i := 0; i < in.Len(); i++ { for i := 0; i < in.Len(); i++ {
@@ -72,8 +70,6 @@ func (ft forTag) Run(tc *TagContext, block, args []ast.Node) error {
} else if len(vars) == 2 { } else if len(vars) == 2 {
local[vars[0]] = i local[vars[0]] = i
local[vars[1]] = in.Index(i).Interface() local[vars[1]] = in.Index(i).Interface()
} else {
return errors.New("slices and arrays can only use two for loop variables")
} }
err = tc.Execute(block, local) err = tc.Execute(block, local)
@@ -84,57 +80,18 @@ func (ft forTag) Run(tc *TagContext, block, args []ast.Node) error {
case reflect.Map: case reflect.Map:
local := map[string]any{} local := map[string]any{}
iter := in.MapRange() iter := in.MapRange()
i := 0
for iter.Next() { for iter.Next() {
if len(vars) == 1 { if len(vars) == 1 {
local[vars[0]] = iter.Value().Interface() local[vars[0]] = iter.Value().Interface()
} else if len(vars) == 2 { } else if len(vars) == 2 {
local[vars[0]] = iter.Key().Interface() local[vars[0]] = iter.Key().Interface()
local[vars[1]] = iter.Value().Interface() local[vars[1]] = iter.Value().Interface()
} else if len(vars) == 3 {
local[vars[0]] = i
local[vars[1]] = iter.Key().Interface()
local[vars[2]] = iter.Value().Interface()
} }
err = tc.Execute(block, local) err = tc.Execute(block, local)
if err != nil { if err != nil {
return err return err
} }
i++
}
case reflect.Func:
local := map[string]any{}
i := 0
if len(vars) == 1 {
for val := range in.Seq() {
local[vars[0]] = val.Interface()
err = tc.Execute(block, local)
if err != nil {
return err
}
}
} else if len(vars) == 2 {
for val1, val2 := range in.Seq2() {
local[vars[0]] = val1.Interface()
local[vars[1]] = val2.Interface()
err = tc.Execute(block, local)
if err != nil {
return err
}
}
} else {
for val1, val2 := range in.Seq2() {
local[vars[0]] = i
local[vars[1]] = val1.Interface()
local[vars[2]] = val2.Interface()
err = tc.Execute(block, local)
if err != nil {
return err
}
i++
}
} }
} }

View File

@@ -1,48 +0,0 @@
package salix
import (
"io"
"io/fs"
"path"
"go.elara.ws/salix/ast"
)
// FSTag writes files from an fs.FS to a template
//
// No escaping is done on the files, so make sure to avoid user-generated data.
type FSTag struct {
// FS is the filesystem that files will be loaded from.
FS fs.FS
// PathPrefix is joined to the path string before a file is read.
PathPrefix string
// Extension is appended to the end of the path string before a file is read.
Extension string
}
func (ft FSTag) Run(tc *TagContext, block, args []ast.Node) error {
if len(args) != 1 {
return tc.PosError(tc.Tag, "expected one argument, got %d", len(args))
}
pathVal, err := tc.GetValue(args[0], nil)
if err != nil {
return err
}
pathStr, ok := pathVal.(string)
if !ok {
return tc.PosError(args[0], "expected string argument, got %T", pathVal)
}
fl, err := ft.FS.Open(path.Join(ft.PathPrefix, pathStr) + ft.Extension)
if err != nil {
return err
}
defer fl.Close()
_, err = io.Copy(tc, fl)
return err
}

View File

@@ -2,8 +2,6 @@ package salix
import ( import (
"errors" "errors"
"fmt"
"reflect"
"strings" "strings"
"testing" "testing"
@@ -31,6 +29,8 @@ func TestFuncCall(t *testing.T) {
} }
} }
//TODO: COMMIT THIS!!!
func TestFuncCallInvalidParamCount(t *testing.T) { func TestFuncCallInvalidParamCount(t *testing.T) {
fn := func() int { return 0 } fn := func() int { return 0 }
@@ -95,7 +95,7 @@ func TestFuncCallVariadic(t *testing.T) {
} }
func TestFuncCallError(t *testing.T) { func TestFuncCallError(t *testing.T) {
expectedErr := errors.New("expected error") var expectedErr = errors.New("expected error")
fn := func() error { return expectedErr } fn := func() error { return expectedErr }
// test() // test()
@@ -133,7 +133,7 @@ func TestFuncCallMultiReturn(t *testing.T) {
} }
func TestFuncCallMultiReturnError(t *testing.T) { func TestFuncCallMultiReturnError(t *testing.T) {
expectedErr := errors.New("expected error") var expectedErr = errors.New("expected error")
fn := func() (string, error) { return "", expectedErr } fn := func() (string, error) { return "", expectedErr }
// test() // test()
@@ -199,20 +199,3 @@ func TestFuncCallAssignment(t *testing.T) {
t.Error("Expected error, got nil") t.Error("Expected error, got nil")
} }
} }
func TestValidateFunc(t *testing.T) {
testCases := []reflect.Type{
reflect.TypeFor[func()](), // Template functions must return at least one value
reflect.TypeFor[func() (x, y int)](), // Second return value must be an error
reflect.TypeFor[func() (x, y, z int)](), // Template functions cannot have more than two return values
}
for index, testCase := range testCases {
t.Run(fmt.Sprint(index), func(t *testing.T) {
err := validateFunc(testCase, ast.Bool{Value: true, Position: testPos(t)})
if err == nil {
t.Error("Expected error, got nil")
}
})
}
}

2
go.mod
View File

@@ -1,3 +1,3 @@
module go.elara.ws/salix module go.elara.ws/salix
go 1.23.0 go 1.21.2

View File

@@ -29,17 +29,8 @@ func (it includeTag) Run(tc *TagContext, block, args []ast.Node) error {
return tc.PosError(args[0], "invalid first argument type: %T (expected string)", val) return tc.PosError(args[0], "invalid first argument type: %T (expected string)", val)
} }
ignoreMissing := false
if name[0] == '?' {
name = name[1:]
ignoreMissing = true
}
tmpl, ok := tc.t.ns.GetTemplate(name) tmpl, ok := tc.t.ns.GetTemplate(name)
if !ok { if !ok {
if ignoreMissing {
return nil
}
return tc.PosError(args[0], "no such template: %q", name) return tc.PosError(args[0], "no such template: %q", name)
} }

View File

@@ -20,12 +20,6 @@ func (mt macroTag) Run(tc *TagContext, block, args []ast.Node) error {
return tc.PosError(args[0], "invalid first argument type: %T (expected string)", nameVal) return tc.PosError(args[0], "invalid first argument type: %T (expected string)", nameVal)
} }
ignoreMissing := false
if name[0] == '?' {
name = name[1:]
ignoreMissing = true
}
if len(block) == 0 { if len(block) == 0 {
local := map[string]any{} local := map[string]any{}
@@ -46,9 +40,6 @@ func (mt macroTag) Run(tc *TagContext, block, args []ast.Node) error {
macro, ok := tc.t.macros[name] macro, ok := tc.t.macros[name]
if !ok { if !ok {
if ignoreMissing {
return nil
}
return tc.PosError(tc.Tag, "no such macro: %q", name) return tc.PosError(tc.Tag, "no such macro: %q", name)
} }
return tc.Execute(macro, local) return tc.Execute(macro, local)

View File

@@ -20,10 +20,7 @@ type Namespace struct {
// WriteOnSuccess indicates whether the output should only be written if generation fully succeeds. // WriteOnSuccess indicates whether the output should only be written if generation fully succeeds.
// This option buffers the output of the template, so it will use more memory. (default: false) // This option buffers the output of the template, so it will use more memory. (default: false)
WriteOnSuccess bool WriteOnSuccess bool
// NilToZero indictes whether nil pointer values should be converted to zero values of their underlying escapeHTML *bool
// types.
NilToZero bool
escapeHTML *bool
} }
// New returns a new template namespace // New returns a new template namespace
@@ -89,14 +86,6 @@ func (n *Namespace) WithWhitespaceMutations(b bool) *Namespace {
return n return n
} }
// WithNilToZero enables or disables conversion of nil values to zero values for the namespace
func (n *Namespace) WithNilToZero(b bool) *Namespace {
n.mu.Lock()
defer n.mu.Unlock()
n.NilToZero = true
return n
}
// GetTemplate tries to get a template from the namespace's template map. // GetTemplate tries to get a template from the namespace's template map.
// If it finds the template, it returns the template and true. If it // If it finds the template, it returns the template and true. If it
// doesn't find it, it returns nil and false. // doesn't find it, it returns nil and false.

File diff suppressed because it is too large Load Diff

View File

@@ -83,21 +83,8 @@ ExprTag = '#' ignoreErr:'?'? '(' item:Expr ')' {
}, nil }, nil
} }
Expr = Assignment / TernaryExpr Expr = Ternary / Assignment / LogicalExpr
Assignable = TernaryExpr Assignable = Ternary / LogicalExpr
TernaryExpr = _ cond:LogicalExpr vals:(_ '?' _ Value _ ':' _ Value)? {
if vals == nil {
return cond, nil
} else {
s := toAnySlice(vals)
return ast.Ternary{
Condition: cond.(ast.Node),
IfTrue: s[3].(ast.Node),
Else: s[7].(ast.Node),
}, nil
}
}
LogicalExpr = _ first:ComparisonExpr rest:(_ LogicalOp _ ComparisonExpr)* _ { LogicalExpr = _ first:ComparisonExpr rest:(_ LogicalOp _ ComparisonExpr)* _ {
return toExpr(c, first, rest), nil return toExpr(c, first, rest), nil
@@ -129,49 +116,13 @@ ParamList = '(' params:(Expr ( ',' _ Expr )* )? ')' {
return out, nil return out, nil
} }
Value = not:"!"? node:(Nil / MethodCall / FieldAccess / Index / String / RawString / Float / Integer / Bool / FuncCall / VariableOr / Ident / ParenExpr / Array / Map) { Value = not:"!"? node:(MethodCall / FieldAccess / Index / String / RawString / Float / Integer / Bool / FuncCall / VariableOr / Ident / ParenExpr) {
return ast.Value{ return ast.Value{
Node: node.(ast.Node), Node: node.(ast.Node),
Not: not != nil, Not: not != nil,
}, nil }, nil
} }
Map = '{' _ fpair:(Assignable _ ':' _ Assignable)? _ pairs:(',' _ Assignable _ ':' _ Assignable _)* _ ','? _ '}' {
out := ast.Map{
Map: map[ast.Node]ast.Node{},
Position: getPos(c),
}
fpairSlice := toAnySlice(fpair)
if fpairSlice == nil {
return out, nil
} else {
out.Map[fpairSlice[0].(ast.Node)] = fpairSlice[4].(ast.Node)
for _, pair := range toAnySlice(pairs) {
pairSlice := toAnySlice(pair)
out.Map[pairSlice[2].(ast.Node)] = pairSlice[6].(ast.Node)
}
}
return out, nil
}
Array = '[' _ fval:Assignable? _ vals:(',' _ Assignable _)* ','? _ ']' {
out := ast.Array{Position: getPos(c)}
if fval == nil {
return out, nil
} else {
out.Array = append(out.Array, fval.(ast.Node))
for _, val := range toAnySlice(vals) {
valSlice := toAnySlice(val)
out.Array = append(out.Array, valSlice[2].(ast.Node))
}
}
return out, nil
}
VariableOr = variable:Ident _ '|' _ or:Assignable { VariableOr = variable:Ident _ '|' _ or:Assignable {
return ast.VariableOr{ return ast.VariableOr{
Variable: variable.(ast.Ident), Variable: variable.(ast.Ident),
@@ -187,6 +138,14 @@ Assignment = name:Ident _ '=' _ value:Assignable {
}, nil }, nil
} }
Ternary = cond:Assignable _ '?' _ ifTrue:Value _ ':' _ elseVal:Value {
return ast.Ternary{
Condition: cond.(ast.Node),
IfTrue: ifTrue.(ast.Node),
Else: elseVal.(ast.Node),
}, nil
}
MethodCall = value:Value '.' name:Ident params:ParamList { MethodCall = value:Value '.' name:Ident params:ParamList {
return ast.MethodCall{ return ast.MethodCall{
Value: value.(ast.Node), Value: value.(ast.Node),
@@ -288,10 +247,6 @@ ArithmeticOp = ('+' / '-' / '/' / '*' / '%') {
}, nil }, nil
} }
Nil = "nil" {
return ast.Nil{Position: getPos(c)}, nil
}
Text = . [^#]* { return ast.Text{Data: c.text, Position: getPos(c)}, nil } Text = . [^#]* { return ast.Text{Data: c.text, Position: getPos(c)}, nil }
_ "whitespace" ← [ \t\r\n]* _ "whitespace" ← [ \t\r\n]*

114
salix.go
View File

@@ -26,7 +26,6 @@ type Template struct {
// WriteOnSuccess indicates whether the output should only be written if generation fully succeeds. // WriteOnSuccess indicates whether the output should only be written if generation fully succeeds.
// This option buffers the output of the template, so it will use more memory. (default: false) // This option buffers the output of the template, so it will use more memory. (default: false)
WriteOnSuccess bool WriteOnSuccess bool
NilToZero bool
tags map[string]Tag tags map[string]Tag
vars map[string]any vars map[string]any
@@ -67,12 +66,6 @@ func (t Template) WithWriteOnSuccess(b bool) Template {
return t return t
} }
// WithNilToZero enables or disables conversion of nil values to zero values.
func (t Template) WithNilToZero(b bool) Template {
t.NilToZero = true
return t
}
// Execute executes a parsed template and writes // Execute executes a parsed template and writes
// the result to w. // the result to w.
func (t Template) Execute(w io.Writer) error { func (t Template) Execute(w io.Writer) error {
@@ -154,10 +147,6 @@ func (t *Template) getEscapeHTML() bool {
} }
} }
func (t *Template) getNilToZero() bool {
return t.NilToZero || t.ns.NilToZero
}
func (t *Template) toString(v any) string { func (t *Template) toString(v any) string {
if h, ok := v.(HTML); ok { if h, ok := v.(HTML); ok {
return string(h) return string(h)
@@ -177,7 +166,7 @@ func (t *Template) getBlock(nodes []ast.Node, offset, startLine int, name string
// If we encounter another tag with the same name, // If we encounter another tag with the same name,
// increment tagAmount so that we know that the next // increment tagAmount so that we know that the next
// end tag isn't the end of this tag. // end tag isn't the end of this tag.
if node.Name.Value == name && node.HasBody { if node.Name.Value == name {
tagAmount++ tagAmount++
} }
out = append(out, node) out = append(out, node)
@@ -233,14 +222,8 @@ func (t *Template) getValue(node ast.Node, local map[string]any) (any, error) {
return t.evalTernary(node, local) return t.evalTernary(node, local)
case ast.VariableOr: case ast.VariableOr:
return t.evalVariableOr(node, local) return t.evalVariableOr(node, local)
case ast.Map:
return t.convertMap(node, local)
case ast.Array:
return t.convertArray(node, local)
case ast.Assignment: case ast.Assignment:
return node, t.handleAssignment(node, local) return node, t.handleAssignment(node, local)
case ast.Nil:
return nil, nil
default: default:
return nil, nil return nil, nil
} }
@@ -307,23 +290,6 @@ func valueToString(node ast.Node) string {
} else { } else {
return "#" + node.Name.Value + "()" return "#" + node.Name.Value + "()"
} }
case ast.Map:
k, v := getOneMapPair(node)
if len(node.Map) > 1 {
return "{" + valueToString(k) + ": " + valueToString(v) + ", ...}"
} else if len(node.Map) == 1 {
return "{" + valueToString(k) + ": " + valueToString(v) + "}"
} else {
return "{}"
}
case ast.Array:
if len(node.Array) > 1 {
return "[" + valueToString(node.Array[0]) + ", ...]"
} else if len(node.Array) == 1 {
return "[" + valueToString(node.Array[0]) + "]"
} else {
return "[]"
}
case ast.EndTag: case ast.EndTag:
return "#!" + node.Name.Value return "#!" + node.Name.Value
case ast.ExprTag: case ast.ExprTag:
@@ -333,13 +299,6 @@ func valueToString(node ast.Node) string {
} }
} }
func getOneMapPair(m ast.Map) (k, v ast.Node) {
for key, val := range m.Map {
return key, val
}
return nil, nil
}
// unwrapASTValue unwraps an ast.Value node into its underlying value // unwrapASTValue unwraps an ast.Value node into its underlying value
func (t *Template) unwrapASTValue(node ast.Value, local map[string]any) (any, error) { func (t *Template) unwrapASTValue(node ast.Value, local map[string]any) (any, error) {
v, err := t.getValue(node.Node, local) v, err := t.getValue(node.Node, local)
@@ -347,57 +306,17 @@ func (t *Template) unwrapASTValue(node ast.Value, local map[string]any) (any, er
return nil, err return nil, err
} }
rval := reflect.ValueOf(v)
if node.Not { if node.Not {
rval := reflect.ValueOf(v)
if rval.Kind() != reflect.Bool { if rval.Kind() != reflect.Bool {
return nil, ast.PosError(node, "%s: the ! operator can only be used on boolean values", valueToString(node)) return nil, ast.PosError(node, "%s: the ! operator can only be used on boolean values", valueToString(node))
} }
return !rval.Bool(), nil return !rval.Bool(), nil
} }
if rval.Kind() == reflect.Pointer && rval.IsNil() && t.getNilToZero() {
rtyp := rval.Type().Elem()
return reflect.New(rtyp).Interface(), nil
}
return v, err return v, err
} }
// convertMap converts an ast.Map value into a map[any]any by recursively calling
// getValue on each of its keys and values.
func (t *Template) convertMap(node ast.Map, local map[string]any) (any, error) {
out := make(map[any]any, len(node.Map))
for keyNode, valNode := range node.Map {
key, err := t.getValue(keyNode, local)
if err != nil {
return nil, err
}
val, err := t.getValue(valNode, local)
if err != nil {
return nil, err
}
out[key] = val
}
return out, nil
}
// convertArray converts an ast.Array into an []any by recursively calling getValue
// on each of its elements.
func (t *Template) convertArray(node ast.Array, local map[string]any) (any, error) {
out := make([]any, len(node.Array))
for i, valNode := range node.Array {
val, err := t.getValue(valNode, local)
if err != nil {
return nil, err
}
out[i] = val
}
return out, nil
}
// getVar tries to get a variable from the local map. If it's not found, // getVar tries to get a variable from the local map. If it's not found,
// it'll try the global variable map. If it doesn't exist in either map, // it'll try the global variable map. If it doesn't exist in either map,
// it will return an error. // it will return an error.
@@ -510,16 +429,10 @@ func (t *Template) getIndex(i ast.Index, local map[string]any) (any, error) {
} }
intIndex := rindex.Interface().(int) intIndex := rindex.Interface().(int)
if intIndex < 0 { if intIndex < rval.Len() {
intIndex = rval.Len() + intIndex
if intIndex < 0 {
return nil, ast.PosError(i, "%s: index out of range: %d (length %d)", valueToString(i), rindex.Interface(), rval.Len())
}
out = rval.Index(intIndex)
} else if intIndex < rval.Len() {
out = rval.Index(intIndex) out = rval.Index(intIndex)
} else { } else {
return nil, ast.PosError(i, "%s: index out of range: %d (length %d)", valueToString(i), intIndex, rval.Len()) return nil, ast.PosError(i, "%s: index out of range: %d", valueToString(i), intIndex)
} }
case reflect.Map: case reflect.Map:
if rindex.CanConvert(rval.Type().Key()) { if rindex.CanConvert(rval.Type().Key()) {
@@ -571,23 +484,18 @@ func (t *Template) execMethodCall(mc ast.MethodCall, local map[string]any) (any,
if !rval.IsValid() { if !rval.IsValid() {
return nil, ast.PosError(mc, "%s: cannot call method on nil value", valueToString(mc)) return nil, ast.PosError(mc, "%s: cannot call method on nil value", valueToString(mc))
} }
for rval.Kind() == reflect.Pointer {
rval = rval.Elem()
}
// First, check for a method with the given name // First, check for a method with the given name
mtd := rval.MethodByName(mc.Name.Value) mtd := rval.MethodByName(mc.Name.Value)
if mtd.IsValid() { if mtd.IsValid() {
return t.execFunc(mtd, mc, mc.Params, local) return t.execFunc(mtd, mc, mc.Params, local)
} }
// If the method doesn't exist, we need to check for fields, so dereference any pointers // If the method doesn't exist, also check for a field storing a function.
// because pointers can't have fields field := rval.FieldByName(mc.Name.Value)
for rval.Kind() == reflect.Pointer { if field.IsValid() && field.Kind() == reflect.Func {
rval = rval.Elem() return t.execFunc(field, mc, mc.Params, local)
}
// Make sure we actually have a struct
if rval.Kind() == reflect.Struct {
// If the method doesn't exist, also check for a field storing a function.
field := rval.FieldByName(mc.Name.Value)
if field.IsValid() && field.Kind() == reflect.Func {
return t.execFunc(field, mc, mc.Params, local)
}
} }
// If neither of those exist, return an error // If neither of those exist, return an error
return nil, ast.PosError(mc, "no such method: %s", mc.Name.Value) return nil, ast.PosError(mc, "no such method: %s", mc.Name.Value)

View File

@@ -33,28 +33,6 @@ func TestSliceGetIndex(t *testing.T) {
} }
} }
func TestSliceGetNegativeIndex(t *testing.T) {
testSlice := []any{1, "2", 3.0}
tmpl := testTmpl(t)
// test[-2]
ast := ast.Index{
Value: ast.Ident{Value: "test", Position: testPos(t)},
Index: ast.Integer{Value: -2, Position: testPos(t)},
Position: testPos(t),
}
val, err := tmpl.getIndex(ast, map[string]any{"test": testSlice})
if err != nil {
t.Fatalf("getIndex error: %s", err)
}
if val != testSlice[len(testSlice)-2] {
t.Errorf("Expected %q, got %q", "2", val)
}
}
func TestSliceGetIndexOutOfRange(t *testing.T) { func TestSliceGetIndexOutOfRange(t *testing.T) {
testSlice := []any{} testSlice := []any{}
tmpl := testTmpl(t) tmpl := testTmpl(t)
@@ -72,23 +50,6 @@ func TestSliceGetIndexOutOfRange(t *testing.T) {
} }
} }
func TestSliceGetNegativeIndexOutOfRange(t *testing.T) {
testSlice := []any{0, 1, 2, 3}
tmpl := testTmpl(t)
// test[-5]
ast := ast.Index{
Value: ast.Ident{Value: "test", Position: testPos(t)},
Index: ast.Integer{Value: -5, Position: testPos(t)},
Position: testPos(t),
}
_, err := tmpl.getIndex(ast, map[string]any{"test": testSlice})
if err == nil {
t.Errorf("Expected error, got nil")
}
}
func TestSliceGetIndexInvalidType(t *testing.T) { func TestSliceGetIndexInvalidType(t *testing.T) {
testSlice := []any{} testSlice := []any{}
tmpl := testTmpl(t) tmpl := testTmpl(t)

View File

@@ -1,7 +1,6 @@
package salix package salix
import ( import (
"encoding/json"
"fmt" "fmt"
"reflect" "reflect"
"strings" "strings"
@@ -9,7 +8,6 @@ import (
var globalVars = map[string]any{ var globalVars = map[string]any{
"len": tmplLen, "len": tmplLen,
"json": tmplJSON,
"toUpper": strings.ToUpper, "toUpper": strings.ToUpper,
"toLower": strings.ToLower, "toLower": strings.ToLower,
"hasPrefix": strings.HasPrefix, "hasPrefix": strings.HasPrefix,
@@ -21,8 +19,6 @@ var globalVars = map[string]any{
"count": strings.Count, "count": strings.Count,
"split": strings.Split, "split": strings.Split,
"join": strings.Join, "join": strings.Join,
"replace": strings.Replace,
"replaceAll": strings.ReplaceAll,
"sprintf": fmt.Sprintf, "sprintf": fmt.Sprintf,
} }
@@ -35,8 +31,3 @@ func tmplLen(v any) (int, error) {
return 0, fmt.Errorf("cannot get length of %T", v) return 0, fmt.Errorf("cannot get length of %T", v)
} }
} }
func tmplJSON(v any) (HTML, error) {
data, err := json.Marshal(v)
return HTML(data), err
}