feat: implement break and continue statement support

Author: CodeWithKyrian

src/AST/BreakStatement.php

@@ -0,0 +1,10 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Codewithkyrian\Jinja\AST;
+
+class BreakStatement extends Statement
+{
+    public string $type = "BreakStatement";
+}

src/AST/ContinueStatement.php

@@ -0,0 +1,10 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Codewithkyrian\Jinja\AST;
+
+class ContinueStatement extends Statement
+{
+    public string $type = "ContinueStatement";
+}

src/Core/Interpreter.php

@@ -26,6 +26,8 @@
 use Codewithkyrian\Jinja\Exceptions\SyntaxError;
 use Codewithkyrian\Jinja\Runtime\ArrayValue;
 use Codewithkyrian\Jinja\Runtime\BooleanValue;
+use Codewithkyrian\Jinja\Runtime\BreakControl;
+use Codewithkyrian\Jinja\Runtime\ContinueControl;
 use Codewithkyrian\Jinja\Runtime\FunctionValue;
 use Codewithkyrian\Jinja\Runtime\KeywordArgumentsValue;
 use Codewithkyrian\Jinja\Runtime\NullValue;
@@ -73,6 +75,12 @@ function evaluate(?Statement $statement, Environment $environment): RuntimeValue
             case "Macro":
                 return $this->evaluateMacro($statement, $environment);
 
+            case "BreakStatement":
+                throw new BreakControl();
+
+            case "ContinueStatement":
+                throw new ContinueControl();
+
             case "NumericLiteral":
                 return new NumericValue($statement->value);
 
@@ -786,8 +794,15 @@ private function evaluateFor(ForStatement $node, Environment $environment): Stri
 
             $scopeUpdateFunction = $scopeUpdateFunctions[$i];
             $scopeUpdateFunction($scope);
-            $evaluated = $this->evaluateBlock($node->body, $scope);
-            $result .= $evaluated->value;
+
+            try {
+                $evaluated = $this->evaluateBlock($node->body, $scope);
+                $result .= $evaluated->value;
+            } catch (BreakControl $e) {
+                break;
+            } catch (ContinueControl $e) {
+                continue;
+            }
 
             $noIteration = false; // At least one iteration took place
         }

src/Core/Parser.php

@@ -7,6 +7,7 @@
 use Codewithkyrian\Jinja\AST\ArrayLiteral;
 use Codewithkyrian\Jinja\AST\BinaryExpression;
 use Codewithkyrian\Jinja\AST\BooleanLiteral;
+use Codewithkyrian\Jinja\AST\BreakStatement;
 use Codewithkyrian\Jinja\AST\CallExpression;
 use Codewithkyrian\Jinja\AST\FilterExpression;
 use Codewithkyrian\Jinja\AST\ForStatement;
@@ -20,6 +21,7 @@
 use Codewithkyrian\Jinja\AST\ObjectLiteral;
 use Codewithkyrian\Jinja\AST\Program;
 use Codewithkyrian\Jinja\AST\SelectExpression;
+use Codewithkyrian\Jinja\AST\ContinueStatement;
 use Codewithkyrian\Jinja\AST\SetStatement;
 use Codewithkyrian\Jinja\AST\SliceExpression;
 use Codewithkyrian\Jinja\AST\Statement;
@@ -166,6 +168,18 @@ private function parseJinjaStatement(): Statement
 
                 break;
 
+            case TokenType::Break:
+                $this->current++;
+                $this->expect(TokenType::CloseStatement, "Expected closing statement token");
+                $result = new BreakStatement();
+                break;
+
+            case TokenType::Continue:
+                $this->current++;
+                $this->expect(TokenType::CloseStatement, "Expected closing statement token");
+                $result = new ContinueStatement();
+                break;
+
             default:
                 throw new SyntaxError("Unknown statement type: $tokenType->value");
         }

src/Core/Token.php

@@ -25,6 +25,10 @@ class Token
         'or' => TokenType::Or,
         'not' => TokenType::Not,
         'not in' => TokenType::NotIn,
+        'macro' => TokenType::Macro,
+        'endmacro' => TokenType::EndMacro,
+        'break' => TokenType::Break,
+        'continue' => TokenType::Continue,
 
         // Literals
         'true' => TokenType::BooleanLiteral,

src/Core/TokenType.php

@@ -56,4 +56,6 @@ enum TokenType: string
     case Not = "UnaryOperator";
     case Macro = "Macro";
     case EndMacro = "EndMacro";
+    case Break = "Break";
+    case Continue = "Continue";
 }

src/Runtime/BreakControl.php

@@ -0,0 +1,10 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Codewithkyrian\Jinja\Runtime;
+
+/**
+ * Control flow exception thrown when a break statement is encountered in a loop.
+ */
+class BreakControl extends \Exception {}

src/Runtime/ContinueControl.php

@@ -0,0 +1,10 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Codewithkyrian\Jinja\Runtime;
+
+/**
+ * Control flow exception thrown when a continue statement is encountered in a loop.
+ */
+class ContinueControl extends \Exception {}