summaryrefslogtreecommitdiff
path: root/src/ste
diff options
context:
space:
mode:
authorLaria Carolin Chabowski <laria@laria.me>2020-04-30 09:38:05 +0200
committerLaria Carolin Chabowski <laria@laria.me>2020-04-30 09:38:25 +0200
commit2381c52c690342f773a7cfa500387b6bfad76952 (patch)
tree340296ea529e40b81012c936703429a86481788e /src/ste
parent2d26169b367af60cbc03d417c09918f50aa3b882 (diff)
downloadste-2381c52c690342f773a7cfa500387b6bfad76952.tar.gz
ste-2381c52c690342f773a7cfa500387b6bfad76952.tar.bz2
ste-2381c52c690342f773a7cfa500387b6bfad76952.zip
Automatic code formatting
Also add git hooks that checks formatting
Diffstat (limited to 'src/ste')
-rw-r--r--src/ste/ASTNode.php6
-rw-r--r--src/ste/BreakException.php4
-rw-r--r--src/ste/Calc.php65
-rw-r--r--src/ste/CantLoadTemplate.php4
-rw-r--r--src/ste/CantSaveTemplate.php4
-rw-r--r--src/ste/ContinueException.php4
-rw-r--r--src/ste/FatalRuntimeError.php4
-rw-r--r--src/ste/FilesystemStorageAccess.php26
-rw-r--r--src/ste/Misc.php6
-rw-r--r--src/ste/ParseCompileError.php9
-rw-r--r--src/ste/Parser.php178
-rw-r--r--src/ste/RuntimeError.php4
-rw-r--r--src/ste/STECore.php75
-rw-r--r--src/ste/STEStandardLibrary.php104
-rw-r--r--src/ste/Scope.php76
-rw-r--r--src/ste/StorageAccess.php3
-rw-r--r--src/ste/StorageAccessFailure.php4
-rw-r--r--src/ste/TagNode.php6
-rw-r--r--src/ste/TextNode.php8
-rw-r--r--src/ste/Transcompiler.php200
-rw-r--r--src/ste/VarNotInScope.php4
-rw-r--r--src/ste/VariableNode.php16
22 files changed, 473 insertions, 337 deletions
diff --git a/src/ste/ASTNode.php b/src/ste/ASTNode.php
index ea40bac..2163161 100644
--- a/src/ste/ASTNode.php
+++ b/src/ste/ASTNode.php
@@ -2,10 +2,12 @@
namespace kch42\ste;
-abstract class ASTNode {
+abstract class ASTNode
+{
public $tpl;
public $offset;
- public function __construct($tpl, $off) {
+ public function __construct($tpl, $off)
+ {
$this->tpl = $tpl;
$this->offset = $off;
}
diff --git a/src/ste/BreakException.php b/src/ste/BreakException.php
index 563bf53..f91cf6a 100644
--- a/src/ste/BreakException.php
+++ b/src/ste/BreakException.php
@@ -2,4 +2,6 @@
namespace kch42\ste;
-class BreakException extends \Exception { }
+class BreakException extends \Exception
+{
+}
diff --git a/src/ste/Calc.php b/src/ste/Calc.php
index e700c4f..64d2b7a 100644
--- a/src/ste/Calc.php
+++ b/src/ste/Calc.php
@@ -3,11 +3,15 @@
namespace kch42\ste;
/* Class Calc contains static methods needed by <ste:calc /> */
-class Calc {
- private function __construct() {}
+class Calc
+{
+ private function __construct()
+ {
+ }
/* We could also just eval() the $infix_math code, but this is much cooler :-D (Parser inception) */
- public static function shunting_yard($infix_math) {
+ public static function shunting_yard($infix_math)
+ {
$operators = array(
"+" => array("l", 2),
"-" => array("l", 2),
@@ -20,16 +24,18 @@ class Calc {
);
preg_match_all("/\s*(?:(?:[+\\-\\*\\/\\^\\(\\)])|(\\d*[\\.]?\\d*))\\s*/s", $infix_math, $tokens, PREG_PATTERN_ORDER);
- $tokens_raw = array_filter(array_map('trim', $tokens[0]), function($x) { return ($x === "0") || (!empty($x)); });
+ $tokens_raw = array_filter(array_map('trim', $tokens[0]), function ($x) {
+ return ($x === "0") || (!empty($x));
+ });
$output_queue = array();
$op_stack = array();
- $lastpriority = NULL;
+ $lastpriority = null;
/* Make - unary, if neccessary */
$tokens = array();
- foreach($tokens_raw as $token) {
+ foreach ($tokens_raw as $token) {
$priority = isset($operators[$token]) ? $operators[$token][1] : -1;
- if(($token == "-") && (($lastpriority === NULL) || ($lastpriority >= 0))) {
+ if (($token == "-") && (($lastpriority === null) || ($lastpriority >= 0))) {
$priority = $operators["_"][1];
$tokens[] = "_";
} else {
@@ -38,35 +44,35 @@ class Calc {
$lastpriority = $priority;
}
- while(!empty($tokens)) {
+ while (!empty($tokens)) {
$token = array_shift($tokens);
- if(is_numeric($token)) {
+ if (is_numeric($token)) {
$output_queue[] = $token;
- } else if($token == "(") {
+ } elseif ($token == "(") {
$op_stack[] = $token;
- } else if($token == ")") {
+ } elseif ($token == ")") {
$lbr_found = false;
- while(!empty($op_stack)) {
+ while (!empty($op_stack)) {
$op = array_pop($op_stack);
- if($op == "(") {
+ if ($op == "(") {
$lbr_found = true;
break;
}
$output_queue[] = $op;
}
- if(!$lbr_found) {
+ if (!$lbr_found) {
throw new RuntimeError("Bracket mismatch.");
}
- } else if(!isset($operators[$token])) {
+ } elseif (!isset($operators[$token])) {
throw new RuntimeError("Invalid token ($token): Not a number, bracket or operator. Stop.");
} else {
$priority = $operators[$token][1];
- if($operators[$token][0] == "l") {
- while((!empty($op_stack)) and ($priority <= $operators[$op_stack[count($op_stack)-1]][1])) {
+ if ($operators[$token][0] == "l") {
+ while ((!empty($op_stack)) and ($priority <= $operators[$op_stack[count($op_stack)-1]][1])) {
$output_queue[] = array_pop($op_stack);
}
} else {
- while((!empty($op_stack)) and ($priority < $operators[$op_stack[count($op_stack)-1]][1])) {
+ while ((!empty($op_stack)) and ($priority < $operators[$op_stack[count($op_stack)-1]][1])) {
$output_queue[] = array_pop($op_stack);
}
}
@@ -74,9 +80,9 @@ class Calc {
}
}
- while(!empty($op_stack)) {
+ while (!empty($op_stack)) {
$op = array_pop($op_stack);
- if($op == "(") {
+ if ($op == "(") {
throw new RuntimeError("Bracket mismatch...");
}
$output_queue[] = $op;
@@ -85,18 +91,20 @@ class Calc {
return $output_queue;
}
- public static function pop2(&$array) {
+ public static function pop2(&$array)
+ {
$rv = array(array_pop($array), array_pop($array));
- if(array_search(NULL, $rv, true) !== false) {
+ if (array_search(null, $rv, true) !== false) {
throw new RuntimeError("Not enough numbers on stack. Invalid formula.");
}
return $rv;
}
- public static function calc_rpn($rpn) {
+ public static function calc_rpn($rpn)
+ {
$stack = array();
- foreach($rpn as $token) {
- switch($token) {
+ foreach ($rpn as $token) {
+ switch ($token) {
case "+":
list($b, $a) = self::pop2($stack);
$stack[] = $a + $b;
@@ -119,7 +127,7 @@ class Calc {
break;
case "_":
$a = array_pop($stack);
- if($a === NULL) {
+ if ($a === null) {
throw new RuntimeError("Not enough numbers on stack. Invalid formula.");
}
$stack[] = -$a;
@@ -132,7 +140,8 @@ class Calc {
return array_pop($stack);
}
- public static function calc($expr) {
+ public static function calc($expr)
+ {
return self::calc_rpn(self::shunting_yard($expr));
}
-} \ No newline at end of file
+}
diff --git a/src/ste/CantLoadTemplate.php b/src/ste/CantLoadTemplate.php
index 82c7a9f..20200d6 100644
--- a/src/ste/CantLoadTemplate.php
+++ b/src/ste/CantLoadTemplate.php
@@ -9,4 +9,6 @@ namespace kch42\ste;
* Class: CantLoadTemplate
* An exception that a <StorageAccess> implementation can throw, if it is unable to load a template.
*/
-class CantLoadTemplate extends StorageAccessFailure { }
+class CantLoadTemplate extends StorageAccessFailure
+{
+}
diff --git a/src/ste/CantSaveTemplate.php b/src/ste/CantSaveTemplate.php
index 1072ad1..edbb93e 100644
--- a/src/ste/CantSaveTemplate.php
+++ b/src/ste/CantSaveTemplate.php
@@ -9,4 +9,6 @@ namespace kch42\ste;
* Class: CantSaveTemplate
* An exception that a <StorageAccess> implementation can throw, if it is unable to save a template.
*/
-class CantSaveTemplate extends StorageAccessFailure { }
+class CantSaveTemplate extends StorageAccessFailure
+{
+}
diff --git a/src/ste/ContinueException.php b/src/ste/ContinueException.php
index af79b1b..784166e 100644
--- a/src/ste/ContinueException.php
+++ b/src/ste/ContinueException.php
@@ -2,4 +2,6 @@
namespace kch42\ste;
-class ContinueException extends \Exception { }
+class ContinueException extends \Exception
+{
+}
diff --git a/src/ste/FatalRuntimeError.php b/src/ste/FatalRuntimeError.php
index d5ca735..ab40af5 100644
--- a/src/ste/FatalRuntimeError.php
+++ b/src/ste/FatalRuntimeError.php
@@ -10,4 +10,6 @@ namespace kch42\ste;
* An Exception a tag can throw, if a fatal (irreparable) runtime error occurred.
* This Exception will always "bubble up" so you probably want to catch them. Remember that this exception is also in the namespace ste!
*/
-class FatalRuntimeError extends \Exception {}
+class FatalRuntimeError extends \Exception
+{
+}
diff --git a/src/ste/FilesystemStorageAccess.php b/src/ste/FilesystemStorageAccess.php
index d2e5e7f..0bae3b2 100644
--- a/src/ste/FilesystemStorageAccess.php
+++ b/src/ste/FilesystemStorageAccess.php
@@ -9,7 +9,8 @@ namespace kch42\ste;
* Class: FilesystemStorageAccess
* The default <StorageAccess> implementation for loading / saving templates into a directory structure.
*/
-class FilesystemStorageAccess implements StorageAccess {
+class FilesystemStorageAccess implements StorageAccess
+{
protected $sourcedir;
protected $transcompileddir;
@@ -20,18 +21,20 @@ class FilesystemStorageAccess implements StorageAccess {
* $src - The directory with the sources (Writing permissions are not mandatory, because STE does not save template sources).
* $transc - The directory with the transcompiled templates (the PHP instance / the HTTP Server needs writing permissions to this directory).
*/
- public function __construct($src, $transc) {
+ public function __construct($src, $transc)
+ {
$this->sourcedir = $src;
$this->transcompileddir = $transc;
}
- public function load($tpl, &$mode) {
+ public function load($tpl, &$mode)
+ {
$src_fn = $this->sourcedir . "/" . $tpl;
$transc_fn = $this->transcompileddir . "/" . $tpl . ".php";
- if($mode == StorageAccess::MODE_SOURCE) {
+ if ($mode == StorageAccess::MODE_SOURCE) {
$content = @file_get_contents($src_fn);
- if($content === false) {
+ if ($content === false) {
throw new CantLoadTemplate("Template not found.");
}
return $content;
@@ -40,16 +43,16 @@ class FilesystemStorageAccess implements StorageAccess {
$src_stat = @stat($src_fn);
$transc_stat = @stat($transc_fn);
- if(($src_stat === false) and ($transc_stat === false)) {
+ if (($src_stat === false) and ($transc_stat === false)) {
throw new CantLoadTemplate("Template not found.");
- } else if($transc_stat === false) {
+ } elseif ($transc_stat === false) {
$mode = StorageAccess::MODE_SOURCE;
return file_get_contents($src_fn);
- } else if($src_stat === false) {
+ } elseif ($src_stat === false) {
include($transc_fn);
return $transcompile_fx;
} else {
- if($src_stat["mtime"] > $transc_stat["mtime"]) {
+ if ($src_stat["mtime"] > $transc_stat["mtime"]) {
$mode = StorageAccess::MODE_SOURCE;
return file_get_contents($src_fn);
} else {
@@ -59,10 +62,11 @@ class FilesystemStorageAccess implements StorageAccess {
}
}
- public function save($tpl, $data, $mode) {
+ public function save($tpl, $data, $mode)
+ {
$fn = (($mode == StorageAccess::MODE_SOURCE) ? $this->sourcedir : $this->transcompileddir) . "/" . $tpl . (($mode == StorageAccess::MODE_TRANSCOMPILED) ? ".php" : "");
@mkdir(dirname($fn), 0777, true);
- if(file_put_contents($fn, "<?php\n\$transcompile_fx = $data; ?>") === false) {
+ if (file_put_contents($fn, "<?php\n\$transcompile_fx = $data; ?>") === false) {
throw new CantSaveTemplate("Unable to save template.");
}
}
diff --git a/src/ste/Misc.php b/src/ste/Misc.php
index 39ad30c..d017ee3 100644
--- a/src/ste/Misc.php
+++ b/src/ste/Misc.php
@@ -2,8 +2,10 @@
namespace kch42\ste;
-class Misc {
- public static function escape_text($text) {
+class Misc
+{
+ public static function escape_text($text)
+ {
return addcslashes($text, "\r\n\t\$\0..\x1f\\\"\x7f..\xff");
}
}
diff --git a/src/ste/ParseCompileError.php b/src/ste/ParseCompileError.php
index 33fd612..f5f0272 100644
--- a/src/ste/ParseCompileError.php
+++ b/src/ste/ParseCompileError.php
@@ -2,19 +2,22 @@
namespace kch42\ste;
-class ParseCompileError extends \Exception {
+class ParseCompileError extends \Exception
+{
public $msg;
public $tpl;
public $off;
- public function __construct($msg, $tpl, $offset, $code = 0, $previous = NULL) {
+ public function __construct($msg, $tpl, $offset, $code = 0, $previous = null)
+ {
$this->msg = $msg;
$this->tpl = $tpl;
$this->off = $offset;
$this->message = "$msg (Template $tpl, Offset $offset)";
}
- public function rewrite($code) {
+ public function rewrite($code)
+ {
$line = substr_count(str_replace("\r\n", "\n", substr($code, 0, $this->off)), "\n") + 1;
$this->message = "{$this->msg} (Template {$this->tpl}, Line $line)";
$this->is_rewritten = true;
diff --git a/src/ste/Parser.php b/src/ste/Parser.php
index 7226c60..40f5f20 100644
--- a/src/ste/Parser.php
+++ b/src/ste/Parser.php
@@ -10,7 +10,8 @@ namespace kch42\ste;
* The class, where the parser lives in. Can not be constructed manually.
* Use the static method parse.
*/
-class Parser {
+class Parser
+{
private $text;
private $name;
private $off;
@@ -21,15 +22,17 @@ class Parser {
const ESCAPES_DEFAULT = '$?~{}|\\';
- private function __construct($text, $name) {
+ private function __construct($text, $name)
+ {
$this->text = $text;
$this->name = $name;
$this->off = 0;
$this->len = mb_strlen($text);
}
- private function next($n = 1) {
- if($n <= 0) {
+ private function next($n = 1)
+ {
+ if ($n <= 0) {
throw new \InvalidArgumentException("\$n must be > 0");
}
$c = mb_substr($this->text, $this->off, $n);
@@ -37,48 +40,53 @@ class Parser {
return $c;
}
- private function eof() {
+ private function eof()
+ {
return ($this->off == $this->len);
}
- private function back($n = 1) {
- if($n <= 0) {
+ private function back($n = 1)
+ {
+ if ($n <= 0) {
throw new \InvalidArgumentException("\$n must be > 0");
}
$this->off = max($this->off - $n, 0);
}
- private function search_off($needle) {
+ private function search_off($needle)
+ {
return mb_strpos($this->text, $needle, $this->off);
}
- private function search_multi($needles) {
+ private function search_multi($needles)
+ {
$oldoff = $this->off;
$minoff = $this->len;
- $which = NULL;
+ $which = null;
- foreach($needles as $key => $needle) {
- if(($off = $this->search_off($needle)) === false) {
+ foreach ($needles as $key => $needle) {
+ if (($off = $this->search_off($needle)) === false) {
continue;
}
- if($off < $minoff) {
+ if ($off < $minoff) {
$minoff = $off;
$which = $key;
}
}
- $this->off = $minoff + (($which === NULL) ? 0 : mb_strlen((string) $needles[$which]));
+ $this->off = $minoff + (($which === null) ? 0 : mb_strlen((string) $needles[$which]));
return array($which, $minoff, mb_substr($this->text, $oldoff, $minoff - $oldoff), $oldoff);
}
- private function search($needle) {
+ private function search($needle)
+ {
$oldoff = $this->off;
$off = $this->search_off($needle);
- if($off === false) {
+ if ($off === false) {
$this->off = $this->len;
return array(false, mb_substr($this->text, $oldoff), $oldoff);
}
@@ -87,10 +95,11 @@ class Parser {
return array($off, mb_substr($this->text, $oldoff, $off - $oldoff), $oldoff);
}
- private function take_while($cb) {
+ private function take_while($cb)
+ {
$s = "";
- while(($c = $this->next()) !== "") {
- if(!call_user_func($cb, $c)) {
+ while (($c = $this->next()) !== "") {
+ if (!call_user_func($cb, $c)) {
$this->back();
return $s;
}
@@ -99,14 +108,18 @@ class Parser {
return $s;
}
- private function skip_ws() {
+ private function skip_ws()
+ {
$this->take_while("ctype_space");
}
- private function get_name() {
+ private function get_name()
+ {
$off = $this->off;
- $name = $this->take_while(function($c) { return ctype_alnum($c) || ($c == "_"); });
- if(mb_strlen($name) == 0) {
+ $name = $this->take_while(function ($c) {
+ return ctype_alnum($c) || ($c == "_");
+ });
+ if (mb_strlen($name) == 0) {
throw new ParseCompileError("Expected a name (alphanumeric chars + '_', at least one char)", $this->name, $off);
}
return $name;
@@ -128,7 +141,8 @@ class Parser {
* Throws:
* <ParseCompileError>
*/
- public static function parse($text, $name) {
+ public static function parse($text, $name)
+ {
$obj = new self($text, $name);
$res = $obj->parse_text(
self::ESCAPES_DEFAULT, /* Escapes */
@@ -137,39 +151,40 @@ class Parser {
return self::tidyup_ast($res[0]);
}
- private static function tidyup_ast($ast) {
+ private static function tidyup_ast($ast)
+ {
$out = array();
- $prevtext = NULL;
+ $prevtext = null;
$first = true;
- foreach($ast as $node) {
- if($node instanceof TextNode) {
- if($prevtext === NULL) {
+ foreach ($ast as $node) {
+ if ($node instanceof TextNode) {
+ if ($prevtext === null) {
$prevtext = $node;
} else {
$prevtext->text .= $node->text;
}
} else {
- if($prevtext !== NULL) {
- if($first) {
+ if ($prevtext !== null) {
+ if ($first) {
$prevtext->text = ltrim($prevtext->text);
}
- if($prevtext->text != "") {
+ if ($prevtext->text != "") {
$out[] = $prevtext;
}
}
- $prevtext = NULL;
+ $prevtext = null;
$first = false;
- if($node instanceof TagNode) {
+ if ($node instanceof TagNode) {
$node->sub = self::tidyup_ast($node->sub);
- foreach($node->params as $k => &$v) {
+ foreach ($node->params as $k => &$v) {
$v = self::tidyup_ast($v);
}
unset($v);
} else { /* VariableNode */
- foreach($node->arrayfields as &$v) {
+ foreach ($node->arrayfields as &$v) {
$v = self::tidyup_ast($v);
}
unset($v);
@@ -179,11 +194,11 @@ class Parser {
}
}
- if($prevtext !== NULL) {
- if($first) {
+ if ($prevtext !== null) {
+ if ($first) {
$prevtext->text = ltrim($prevtext->text);
}
- if($prevtext->text != "") {
+ if ($prevtext->text != "") {
$out[] = $prevtext;
}
}
@@ -191,7 +206,8 @@ class Parser {
return $out;
}
- private function parse_text($escapes, $flags, $breakon = NULL, $separator = NULL, $nullaction = NULL, $opentag = NULL, $openedat = -1) {
+ private function parse_text($escapes, $flags, $breakon = null, $separator = null, $nullaction = null, $opentag = null, $openedat = -1)
+ {
$elems = array();
$astlist = array();
@@ -203,30 +219,30 @@ class Parser {
"var" => '$',
);
- if($flags & self::PARSE_TAG) {
+ if ($flags & self::PARSE_TAG) {
$needles["tagopen"] = '<ste:';
$needles["closetagopen"] = '</ste:';
}
- if($flags & self::PARSE_SHORT) {
+ if ($flags & self::PARSE_SHORT) {
$needles["shortifopen"] = '?{';
$needles["shortcompopen"] = '~{';
}
- if($separator !== NULL) {
+ if ($separator !== null) {
$needles["sep"] = $separator;
}
- if($breakon !== NULL) {
+ if ($breakon !== null) {
$needles["break"] = $breakon;
}
- for(;;) {
+ for (;;) {
list($which, $off, $before, $offbefore) = $this->search_multi($needles);
$astlist[] = new TextNode($this->name, $offbefore, $before);
- switch($which) {
- case NULL:
- if($nullaction === NULL) {
+ switch ($which) {
+ case null:
+ if ($nullaction === null) {
$elems[] = $astlist;
return $elems;
} else {
@@ -235,14 +251,14 @@ class Parser {
break;
case "commentopen":
list($off, $before, $offbefore) = $this->search("</ste:comment>");
- if($off === false) {
+ if ($off === false) {
throw new ParseCompileError("ste:comment was not closed", $this->name, $offbefore);
}
break;
case "rawopen":
$off_start = $off;
list($off, $before, $offbefore) = $this->search("</ste:rawtext>");
- if($off === false) {
+ if ($off === false) {
throw new ParseCompileError("ste:rawtext was not closed", $this->name, $off_start);
}
$astlist[] = new TextNode($this->name, $off_start, $before);
@@ -255,14 +271,14 @@ class Parser {
$name = $this->get_name();
$this->skip_ws();
$off = $this->off;
- if($this->next() != ">") {
+ if ($this->next() != ">") {
throw new ParseCompileError("Expected '>' in closing ste-Tag", $this->name, $off);
}
- if($opentag === NULL) {
+ if ($opentag === null) {
throw new ParseCompileError("Found closing ste:$name tag, but no tag was opened", $this->name, $off_start);
}
- if($opentag != $name) {
+ if ($opentag != $name) {
throw new ParseCompileError("Open ste:$opentag was not closed", $this->name, $openedat);
}
@@ -270,7 +286,7 @@ class Parser {
return $elems;
case "escape":
$c = $this->next();
- if(mb_strpos($escapes, $c) !== false) {
+ if (mb_strpos($escapes, $c) !== false) {
$astlist[] = new TextNode($this->name, $off, $c);
} else {
$astlist[] = new TextNode($this->name, $off, '\\');
@@ -279,7 +295,7 @@ class Parser {
break;
case "shortifopen":
$shortelems = $this->parse_short("?{", $off);
- if(count($shortelems) != 3) {
+ if (count($shortelems) != 3) {
throw new ParseCompileError("A short if tag must have the form ?{..|..|..}", $this->name, $off);
}
@@ -302,7 +318,7 @@ class Parser {
break;
case "shortcompopen":
$shortelems = $this->parse_short("~{", $off);
- if(count($shortelems) != 3) {
+ if (count($shortelems) != 3) {
throw new ParseCompileError("A short comparasion tag must have the form ~{..|..|..}", $this->name, $off);
}
@@ -336,7 +352,8 @@ class Parser {
return $elems;
}
- private function parse_short($shortname, $openedat) {
+ private function parse_short($shortname, $openedat)
+ {
$tplname = $this->name;
return $this->parse_text(
@@ -344,43 +361,45 @@ class Parser {
self::PARSE_SHORT | self::PARSE_TAG, /* Flags */
'}', /* Break on */
'|', /* Separator */
- function() use ($shortname, $tplname, $openedat) { /* NULL action */
+ function () use ($shortname, $tplname, $openedat) { /* NULL action */
throw new ParseCompileError("Unclosed $shortname", $tplname, $openedat);
},
- NULL, /* Open tag */
+ null, /* Open tag */
$openedat /* Opened at */
);
}
- private function parse_var($openedat, $curly) {
+ private function parse_var($openedat, $curly)
+ {
$varnode = new VariableNode($this->name, $openedat);
$varnode->name = $this->get_name();
- if(!$this->eof()) {
+ if (!$this->eof()) {
$varnode->arrayfields = $this->parse_array();
}
- if(($curly) && ($this->next() != "}")) {
+ if (($curly) && ($this->next() != "}")) {
throw new ParseCompileError("Unclosed '\${'", $this->name, $openedat);
}
return $varnode;
}
- private function parse_array() {
+ private function parse_array()
+ {
$tplname = $this->name;
$arrayfields = array();
- while($this->next() == "[") {
+ while ($this->next() == "[") {
$openedat = $this->off - 1;
$res = $this->parse_text(
self::ESCAPES_DEFAULT, /* Escapes */
0, /* Flags */
']', /* Break on */
- NULL, /* Separator */
- function() use ($tplname, $openedat) { /* NULL action */
+ null, /* Separator */
+ function () use ($tplname, $openedat) { /* NULL action */
throw new ParseCompileError("Unclosed array access '[...]'", $tplname, $openedat);
},
- NULL, /* Open tag */
+ null, /* Open tag */
$openedat /* Opened at */
);
$arrayfields[] = $res[0];
@@ -390,7 +409,8 @@ class Parser {
return $arrayfields;
}
- private function parse_tag($openedat) {
+ private function parse_tag($openedat)
+ {
$tplname = $this->name;
$this->skip_ws();
@@ -399,13 +419,13 @@ class Parser {
$tag->params = array();
$tag->sub = array();
- for(;;) {
+ for (;;) {
$this->skip_ws();
- switch($this->next()) {
+ switch ($this->next()) {
case '/': /* Self-closing tag */
$this->skip_ws();
- if($this->next() != '>') {
+ if ($this->next() != '>') {
throw new ParseCompileError("Unclosed opening <ste: tag (expected >)", $this->name, $openedat);
}
@@ -414,9 +434,9 @@ class Parser {
$sub = $this->parse_text(
self::ESCAPES_DEFAULT, /* Escapes */
self::PARSE_SHORT | self::PARSE_TAG, /* Flags */
- NULL, /* Break on */
- NULL, /* Separator */
- function() use ($name, $tplname, $openedat) { /* NULL action */
+ null, /* Break on */
+ null, /* Separator */
+ function () use ($name, $tplname, $openedat) { /* NULL action */
throw new ParseCompileError("Open ste:$name tag was not closed", $tplname, $openedat);
},
$tag->name, /* Open tag */
@@ -430,13 +450,13 @@ class Parser {
$param = $this->get_name();
$this->skip_ws();
- if($this->next() != '=') {
+ if ($this->next() != '=') {
throw new ParseCompileError("Expected '=' after tag parameter name", $this->name, $this->off - 1);
}
$this->skip_ws();
$quot = $this->next();
- if(($quot != '"') && ($quot != "'")) {
+ if (($quot != '"') && ($quot != "'")) {
throw new ParseCompileError("Expected ' or \" after '=' of tag parameter", $this->name, $this->off - 1);
}
@@ -445,11 +465,11 @@ class Parser {
self::ESCAPES_DEFAULT . $quot, /* Escapes */
0, /* Flags */
$quot, /* Break on */
- NULL, /* Separator */
- function() use ($quot, $tplname, $off) { /* NULL action */
+ null, /* Separator */
+ function () use ($quot, $tplname, $off) { /* NULL action */
throw new ParseCompileError("Open tag parameter value ($quot) was not closed", $tplname, $off);
},
- NULL, /* Open tag */
+ null, /* Open tag */
$off /* Opened at */
);
$tag->params[$param] = $paramval[0];
diff --git a/src/ste/RuntimeError.php b/src/ste/RuntimeError.php
index ff3b26d..dace1d4 100644
--- a/src/ste/RuntimeError.php
+++ b/src/ste/RuntimeError.php
@@ -10,4 +10,6 @@ namespace kch42\ste;
* An Exception that a tag can throw, if a non-fatal runtime error occurred.
* By default this will return in no output at all. But if <STECore::$mute_runtime_errors> is false, this will generate a error message instead of the tag's output.
*/
-class RuntimeError extends \Exception {}
+class RuntimeError extends \Exception
+{
+}
diff --git a/src/ste/STECore.php b/src/ste/STECore.php
index 297263a..ccb2a22 100644
--- a/src/ste/STECore.php
+++ b/src/ste/STECore.php
@@ -9,7 +9,8 @@ namespace kch42\ste;
* Class: STECore
* The Core of STE
*/
-class STECore {
+class STECore
+{
private $tags;
private $storage_access;
private $cur_tpl_dir;
@@ -36,7 +37,8 @@ class STECore {
* Parameters:
* $storage_access - An Instance of a <StorageAccess> implementation.
*/
- public function __construct($storage_access) {
+ public function __construct($storage_access)
+ {
$this->storage_access = $storage_access;
$this->cur_tpl_dir = "/";
STEStandardLibrary::_register_lib($this);
@@ -59,11 +61,12 @@ class STECore {
* Throws:
* An Exception if the tag could not be registered (if $callback is not callable or if $name is empty)
*/
- public function register_tag($name, $callback) {
- if(!is_callable($callback)) {
+ public function register_tag($name, $callback)
+ {
+ if (!is_callable($callback)) {
throw new \Exception("Can not register tag \"$name\", not callable.");
}
- if(empty($name)) {
+ if (empty($name)) {
throw new \Exception("Can not register tag, empty name.");
}
$this->tags[$name] = $callback;
@@ -84,24 +87,26 @@ class STECore {
* Returns:
* The output of the tag or, if a <RuntimeError> was thrown, the appropiate result (see <$mute_runtime_errors>).
*/
- public function call_tag($name, $params, $sub) {
+ public function call_tag($name, $params, $sub)
+ {
try {
- if(!isset($this->tags[$name])) {
- if($this->fatal_error_on_missing_tag) {
+ if (!isset($this->tags[$name])) {
+ if ($this->fatal_error_on_missing_tag) {
throw new FatalRuntimeError("Can not call tag \"$name\": Does not exist.");
} else {
throw new RuntimeError("Can not call tag \"$name\": Does not exist.");
}
}
return call_user_func($this->tags[$name], $this, $params, $sub);
- } catch(RuntimeError $e) {
- if(!$this->mute_runtime_errors) {
+ } catch (RuntimeError $e) {
+ if (!$this->mute_runtime_errors) {
return "RuntimeError occurred on tag '$name': " . $e->getMessage();
}
}
}
- public function calc($expression) {
+ public function calc($expression)
+ {
return Calc::calc($expression);
}
@@ -121,11 +126,12 @@ class STECore {
* Returns:
* The output of the template.
*/
- public function exectemplate($tpl) {
+ public function exectemplate($tpl)
+ {
$output = "";
$lastblock = $this->load($tpl);
- foreach($this->blockorder as $blockname) {
+ foreach ($this->blockorder as $blockname) {
$output .= $this->blocks[$blockname];
}
@@ -147,7 +153,8 @@ class STECore {
* Returns:
* A Reference to the variable.
*/
- public function &get_var_reference($name, $create_if_not_exist) {
+ public function &get_var_reference($name, $create_if_not_exist)
+ {
$ref = &$this->scope->get_var_reference($name, $create_if_not_exist);
return $ref;
}
@@ -164,7 +171,8 @@ class STECore {
* Throws:
* <RuntimeError> if the variable name can not be parsed (e.g. unbalanced brackets).
*/
- public function set_var_by_name($name, $val) {
+ public function set_var_by_name($name, $val)
+ {
$this->scope->set_var_by_name($name, $val);
}
@@ -179,7 +187,8 @@ class STECore {
* Throws:
* <RuntimeError> if the variable name can not be parsed (e.g. unbalanced brackets).
*/
- public function set_local_var($name, $val) {
+ public function set_local_var($name, $val)
+ {
$this->scope->set_local_var($name, $val);
}
@@ -197,7 +206,8 @@ class STECore {
* Returns:
* The variables value.
*/
- public function get_var_by_name($name) {
+ public function get_var_by_name($name)
+ {
return $this->scope->get_var_by_name($name);
}
@@ -218,18 +228,21 @@ class STECore {
* Returns:
* The result of the template (if $quiet == false).
*/
- public function load($tpl, $quiet = false) {
+ public function load($tpl, $quiet = false)
+ {
$tpldir_b4 = $this->cur_tpl_dir;
/* Resolve ".", ".." and protect from possible LFI */
$tpl = str_replace("\\", "/", $tpl);
- if($tpl[0] != "/") {
+ if ($tpl[0] != "/") {
$tpl = $this->cur_tpl_dir . "/" . $tpl;
}
- $pathex = array_filter(explode("/", $tpl), function($s) { return ($s != ".") and (!empty($s)); });
+ $pathex = array_filter(explode("/", $tpl), function ($s) {
+ return ($s != ".") and (!empty($s));
+ });
$pathex = array_merge($pathex);
- while(($i = array_search("..", $pathex)) !== false) {
- if($i == 0) {
+ while (($i = array_search("..", $pathex)) !== false) {
+ if ($i == 0) {
$pathex = array_slice($pathex, 1);
} else {
$pathex = array_merge(array_slice($pathex, 0, $i), array_slice($pathex, $i + 2));
@@ -238,18 +251,18 @@ class STECore {
$tpl = implode("/", $pathex);
$this->cur_tpl_dir = dirname($tpl);
- if($quiet) {
+ if ($quiet) {
$blocks_back = clone $this->blocks;
$blockorder_back = clone $this->blockorder;
}
$mode = StorageAccess::MODE_TRANSCOMPILED;
$content = $this->storage_access->load($tpl, $mode);
- if($mode == StorageAccess::MODE_SOURCE) {
+ if ($mode == StorageAccess::MODE_SOURCE) {
try {
$ast = Parser::parse($content, $tpl);
$transc = Transcompiler::transcompile($ast);
- } catch(ParseCompileError $e) {
+ } catch (ParseCompileError $e) {
$e->rewrite($content);
throw $e;
}
@@ -261,7 +274,7 @@ class STECore {
$this->cur_tpl_dir = $tpldir_b4;
- if($quiet) {
+ if ($quiet) {
$this->blocks = $blocks_back;
$this->blockorder = $blockorder_back;
} else {
@@ -279,13 +292,15 @@ class STECore {
* Returns:
* true/false.
*/
- public function evalbool($txt) {
+ public function evalbool($txt)
+ {
return trim(@(string)$txt) != "";
}
- public function make_closure($fx) {
+ public function make_closure($fx)
+ {
$bound_scope = $this->scope;
- return function() use($bound_scope, $fx) {
+ return function () use ($bound_scope, $fx) {
$args = func_get_args();
$ste = $args[0];
@@ -297,7 +312,7 @@ class STECore {
$result = call_user_func_array($fx, $args);
$ste->scope = $prev;
return $result;
- } catch(\Exception $e) {
+ } catch (\Exception $e) {
$ste->scope = $prev;
throw $e;
}
diff --git a/src/ste/STEStandardLibrary.php b/src/ste/STEStandardLibrary.php
index 17532a3..9850afe 100644
--- a/src/ste/STEStandardLibrary.php
+++ b/src/ste/STEStandardLibrary.php
@@ -2,145 +2,165 @@
namespace kch42\ste;
-class STEStandardLibrary {
- static public function _register_lib($ste) {
- foreach(get_class_methods(__CLASS__) as $method) {
- if($method[0] != "_") {
+class STEStandardLibrary
+{
+ public static function _register_lib($ste)
+ {
+ foreach (get_class_methods(__CLASS__) as $method) {
+ if ($method[0] != "_") {
$ste->register_tag($method, array(__CLASS__, $method));
}
}
}
- static public function escape($ste, $params, $sub) {
- if($ste->evalbool(@$params["lines"])) {
+ public static function escape($ste, $params, $sub)
+ {
+ if ($ste->evalbool(@$params["lines"])) {
return nl2br(htmlspecialchars(str_replace("\r\n", "\n", $sub($ste))));
} else {
return htmlspecialchars($sub($ste));
}
}
- static public function strlen($ste, $params, $sub) {
+ public static function strlen($ste, $params, $sub)
+ {
return strlen($sub($ste));
}
- static public function arraylen($ste, $params, $sub) {
- if(empty($params["array"])) {
+ public static function arraylen($ste, $params, $sub)
+ {
+ if (empty($params["array"])) {
throw new RuntimeError("Missing array parameter in <ste:arraylen>.");
}
$a = $ste->get_var_by_name($params["array"], false);
return (is_array($a)) ? count($a) : "";
}
- static public function inc($ste, $params, $sub) {
- if(empty($params["var"])) {
+ public static function inc($ste, $params, $sub)
+ {
+ if (empty($params["var"])) {
throw new RuntimeError("Missing var parameter in <ste:inc>.");
}
$ref = &$ste->get_var_reference($params["var"], true);
$ref++;
}
- static public function dec($ste, $params, $sub) {
- if(empty($params["var"])) {
+ public static function dec($ste, $params, $sub)
+ {
+ if (empty($params["var"])) {
throw new RuntimeError("Missing var parameter in <ste:dec>.");
}
$ref = &$ste->get_var_reference($params["var"], true);
$ref--;
}
- static public function date($ste, $params, $sub) {
+ public static function date($ste, $params, $sub)
+ {
return @strftime($sub($ste), empty($params["timestamp"]) ? @time() : (int) $params["timestamp"]);
}
- static public function in_array($ste, $params, $sub) {
- if(empty($params["array"])) {
+ public static function in_array($ste, $params, $sub)
+ {
+ if (empty($params["array"])) {
throw new RuntimeError("Missing array parameter in <ste:in_array>.");
}
$ar = &$ste->get_var_reference($params["array"], false);
- if(!is_array($ar)) {
+ if (!is_array($ar)) {
return "";
}
return in_array($sub($ste), $ar) ? "y" : "";
}
- static public function join($ste, $params, $sub) {
- if(empty($params["array"])) {
+ public static function join($ste, $params, $sub)
+ {
+ if (empty($params["array"])) {
throw new RuntimeError("Missing array parameter in <ste:join>.");
}
return implode($sub($ste), $ste->get_var_by_name($params["array"]));
}
- static public function split($ste, $params, $sub) {
- if(empty($params["array"])) {
+ public static function split($ste, $params, $sub)
+ {
+ if (empty($params["array"])) {
throw new RuntimeError("Missing array parameter in <ste:split>.");
}
- if(empty($params["delim"])) {
+ if (empty($params["delim"])) {
throw new RuntimeError("Missing delim parameter in <ste:split>.");
}
$ste->set_var_by_name($params["array"], explode($params["delim"], $sub($ste)));
}
- static public function array_add($ste, $params, $sub) {
- if(empty($params["array"])) {
+ public static function array_add($ste, $params, $sub)
+ {
+ if (empty($params["array"])) {
throw new RuntimeError("Missing array parameter in <ste:array_add>.");
}
$ar = &$ste->get_var_reference($params["array"], true);
- if(empty($params["key"])) {
+ if (empty($params["key"])) {
$ar[] = $sub($ste);
} else {
$ar[$params["key"]] = $sub($ste);
}
}
- static public function array_filter($ste, $params, $sub)
+ public static function array_filter($ste, $params, $sub)
{
- if(empty($params["array"])) {
+ if (empty($params["array"])) {
throw new RuntimeError("Missing array parameter in <ste:array_filter>.");
}
$ar = $ste->get_var_by_name($params["array"]);
- if(!is_array($ar)) {
+ if (!is_array($ar)) {
throw new RuntimeError("Variable at 'array' is not an array.");
}
$keys = array_keys($ar);
- if(!empty($params["keep_by_keys"])) {
+ if (!empty($params["keep_by_keys"])) {
$keep_by_keys = &$ste->get_var_reference($params["keep_by_keys"], false);
- if(!is_array($keep_by_keys)) {
+ if (!is_array($keep_by_keys)) {
throw new RuntimeError("Variable at 'keep_by_keys' is not an array.");
}
- $delkeys = array_filter($keys, function($k) use ($keep_by_keys) { return !in_array($k, $keep_by_keys); });
- foreach($delkeys as $dk) {
+ $delkeys = array_filter($keys, function ($k) use ($keep_by_keys) {
+ return !in_array($k, $keep_by_keys);
+ });
+ foreach ($delkeys as $dk) {
unset($ar[$dk]);
}
$keys = array_keys($ar);
}
- if(!empty($params["keep_by_values"])) {
+ if (!empty($params["keep_by_values"])) {
$keep_by_values = &$ste->get_var_reference($params["keep_by_values"], false);
- if(!is_array($keep_by_values)) {
+ if (!is_array($keep_by_values)) {
throw new RuntimeError("Variable at 'keep_by_values' is not an array.");
}
- $ar = array_filter($ar, function($v) use ($keep_by_values) { return in_array($v, $keep_by_values); });
+ $ar = array_filter($ar, function ($v) use ($keep_by_values) {
+ return in_array($v, $keep_by_values);
+ });
$keys = array_keys($ar);
}
- if(!empty($params["delete_by_keys"])) {
+ if (!empty($params["delete_by_keys"])) {
$delete_by_keys = &$ste->get_var_reference($params["delete_by_keys"], false);
- if(!is_array($delete_by_keys)) {
+ if (!is_array($delete_by_keys)) {
throw new RuntimeError("Variable at 'delete_by_keys' is not an array.");
}
- $delkeys = array_filter($keys, function($k) use ($delete_by_keys) { return in_array($k, $delete_by_keys); });
- foreach($delkeys as $dk) {
+ $delkeys = array_filter($keys, function ($k) use ($delete_by_keys) {
+ return in_array($k, $delete_by_keys);
+ });
+ foreach ($delkeys as $dk) {
unset($ar[$dk]);
}
$keys = array_keys($ar);
}
- if(!empty($params["delete_by_values"])) {
+ if (!empty($params["delete_by_values"])) {
$delete_by_values = &$ste->get_var_reference($params["delete_by_values"], false);
- if(!is_array($delete_by_values)) {
+ if (!is_array($delete_by_values)) {
throw new RuntimeError("Variable at 'delete_by_values' is not an array.");
}
- $ar = array_filter($ar, function($v) use ($delete_by_values) { return !in_array($v, $delete_by_values); });
+ $ar = array_filter($ar, function ($v) use ($delete_by_values) {
+ return !in_array($v, $delete_by_values);
+ });
$keys = array_keys($ar);
}
diff --git a/src/ste/Scope.php b/src/ste/Scope.php
index 9326921..e312876 100644
--- a/src/ste/Scope.php
+++ b/src/ste/Scope.php
@@ -2,23 +2,25 @@
namespace kch42\ste;
-class Scope implements \ArrayAccess {
- private $parent = NULL;
+class Scope implements \ArrayAccess
+{
+ private $parent = null;
public $vars = array();
- private static function parse_name($name) {
+ private static function parse_name($name)
+ {
$remain = $name;
$fields = array();
- while($remain !== "") {
+ while ($remain !== "") {
$br_open = strpos($remain, '[');
- if($br_open === false) {
+ if ($br_open === false) {
$fields[] = $remain;
break;
}
$br_close = strpos($remain, ']', $br_open);
- if($br_close === false) {
+ if ($br_close === false) {
throw new RuntimeError("Invalid varname \"$name\". Missing closing \"]\".");
}
@@ -27,11 +29,11 @@ class Scope implements \ArrayAccess {
$field = substr($remain, $br_open+1, $br_close-$br_open-1);
$more = substr($remain, $br_close+1);
- if(strpos($field, '[') !== false) {
+ if (strpos($field, '[') !== false) {
throw new RuntimeError("A variable field must not contain a '[' character.");
}
- if((strlen($more) > 0) && ($more[0] !== '[')) {
+ if ((strlen($more) > 0) && ($more[0] !== '[')) {
// TODO: better error message, not very non-programmer friendly...
throw new RuntimeError("A variable name must be of format name('[' name ']')*.");
}
@@ -42,13 +44,14 @@ class Scope implements \ArrayAccess {
return $fields;
}
- private function &get_topvar_reference($name, $localonly) {
- if(array_key_exists($name, $this->vars)) {
+ private function &get_topvar_reference($name, $localonly)
+ {
+ if (array_key_exists($name, $this->vars)) {
$ref = &$this->vars[$name];
return $ref;
}
- if((!$localonly) && ($this->parent !== NULL)) {
+ if ((!$localonly) && ($this->parent !== null)) {
$ref = &$this->parent->get_topvar_reference($name, $localonly);
return $ref;
}
@@ -56,21 +59,22 @@ class Scope implements \ArrayAccess {
throw new VarNotInScope();
}
- public function &get_var_reference($name, $create_if_not_exist, $localonly=false) {
- $nullref = NULL;
+ public function &get_var_reference($name, $create_if_not_exist, $localonly=false)
+ {
+ $nullref = null;
$fields = self::parse_name($name);
- if(count($fields) == 0) {
+ if (count($fields) == 0) {
return $nullref; // TODO: or should we throw an exception here?
}
$first = $fields[0];
- $ref = NULL;
+ $ref = null;
try {
$ref = &$this->get_topvar_reference($first, $localonly);
- } catch(VarNotInScope $e) {
- if($create_if_not_exist) {
+ } catch (VarNotInScope $e) {
+ if ($create_if_not_exist) {
$this->vars[$first] = (count($fields) > 0) ? array() : "";
$ref = &$this->vars[$first];
} else {
@@ -78,19 +82,19 @@ class Scope implements \ArrayAccess {
}
}
- for($i = 1; $i < count($fields); $i++) {
+ for ($i = 1; $i < count($fields); $i++) {
$field = $fields[$i];
- if(!is_array($ref)) {
+ if (!is_array($ref)) {
return $nullref;
}
- if(!array_key_exists($field, $ref)) {
- if(!$create_if_not_exist) {
+ if (!array_key_exists($field, $ref)) {
+ if (!$create_if_not_exist) {
return $nullref;
}
- if($i < count($fields) - 1) {
+ if ($i < count($fields) - 1) {
$ref[$field] = array();
} else {
$ref[$field] = "";
@@ -103,22 +107,26 @@ class Scope implements \ArrayAccess {
return $ref;
}
- public function set_var_by_name($name, $val) {
+ public function set_var_by_name($name, $val)
+ {
$ref = &$this->get_var_reference($name, true);
$ref = $val;
}
- public function set_local_var($name, $val) {
+ public function set_local_var($name, $val)
+ {
$ref = &$this->get_var_reference($name, true, true);
$ref = $val;
}
- public function get_var_by_name($name) {
+ public function get_var_by_name($name)
+ {
$ref = $this->get_var_reference($name, false);
- return $ref === NULL ? "" : $ref;
+ return $ref === null ? "" : $ref;
}
- public function new_subscope() {
+ public function new_subscope()
+ {
$o = new self();
$o->parent = $this;
return $o;
@@ -126,21 +134,25 @@ class Scope implements \ArrayAccess {
/* implementing ArrayAccess */
- public function offsetSet($offset, $value) {
+ public function offsetSet($offset, $value)
+ {
$this->set_var_by_name($offset, $value);
}
- public function offsetGet($offset) {
+ public function offsetGet($offset)
+ {
return $this->get_var_by_name($offset);
}
- public function offsetExists($offset) {
+ public function offsetExists($offset)
+ {
try {
$this->get_topvar_reference($offset);
return true;
- } catch(VarNotInScope $e) {
+ } catch (VarNotInScope $e) {
return false;
}
}
- public function offsetUnset($offset) {
+ public function offsetUnset($offset)
+ {
unset($this->vars[$offset]);
}
}
diff --git a/src/ste/StorageAccess.php b/src/ste/StorageAccess.php
index 0798b41..e2e8727 100644
--- a/src/ste/StorageAccess.php
+++ b/src/ste/StorageAccess.php
@@ -11,7 +11,8 @@ namespace kch42\ste;
* A StorageAccess implementation is used to access the templates from any storage.
* This means, that you are not limited to store the Templates inside directories, you can also use a database or something else.
*/
-interface StorageAccess {
+interface StorageAccess
+{
/*
* Constants: Template modes
*
diff --git a/src/ste/StorageAccessFailure.php b/src/ste/StorageAccessFailure.php
index 4b319da..50dfc8a 100644
--- a/src/ste/StorageAccessFailure.php
+++ b/src/ste/StorageAccessFailure.php
@@ -2,4 +2,6 @@
namespace kch42\ste;
-abstract class StorageAccessFailure extends \Exception { }
+abstract class StorageAccessFailure extends \Exception
+{
+}
diff --git a/src/ste/TagNode.php b/src/ste/TagNode.php
index 8915c59..c1a14e5 100644
--- a/src/ste/TagNode.php
+++ b/src/ste/TagNode.php
@@ -2,11 +2,13 @@
namespace kch42\ste;
-class TagNode extends ASTNode {
+class TagNode extends ASTNode
+{
public $name;
public $params = array();
public $sub = array();
- public function __construct($tpl, $off, $name = "") {
+ public function __construct($tpl, $off, $name = "")
+ {
parent::__construct($tpl, $off);
$this->name = $name;
}
diff --git a/src/ste/TextNode.php b/src/ste/TextNode.php
index e6c7876..c68dd2f 100644
--- a/src/ste/TextNode.php
+++ b/src/ste/TextNode.php
@@ -2,10 +2,12 @@
namespace kch42\ste;
-class TextNode extends ASTNode {
+class TextNode extends ASTNode
+{
public $text;
- public function __construct($tpl, $off, $text = "") {
+ public function __construct($tpl, $off, $text = "")
+ {
parent::__construct($tpl, $off);
$this->text = $text;
}
-} \ No newline at end of file
+}
diff --git a/src/ste/Transcompiler.php b/src/ste/Transcompiler.php
index 4aadcdf..d223b53 100644
--- a/src/ste/Transcompiler.php
+++ b/src/ste/Transcompiler.php
@@ -9,15 +9,18 @@ namespace kch42\ste;
* Class: Transcompiler
* Contains the STE transcompiler. You'll only need this, if you want to manually transcompile a STE template.
*/
-class Transcompiler {
- private static $builtins = NULL;
+class Transcompiler
+{
+ private static $builtins = null;
- public static function tempvar($typ) {
+ public static function tempvar($typ)
+ {
return $typ . '_' . str_replace('.', '_', uniqid('', true));
}
- public static function init_builtins() {
- if(self::$builtins !== NULL) {
+ public static function init_builtins()
+ {
+ if (self::$builtins !== null) {
return;
}
@@ -42,23 +45,24 @@ class Transcompiler {
);
}
- private static function builtin_if($ast) {
+ private static function builtin_if($ast)
+ {
$output = "";
$condition = array();
- $then = NULL;
- $else = NULL;
+ $then = null;
+ $else = null;
- foreach($ast->sub as $node) {
- if(($node instanceof TagNode) and ($node->name == "then")) {
+ foreach ($ast->sub as $node) {
+ if (($node instanceof TagNode) and ($node->name == "then")) {
$then = $node->sub;
- } else if(($node instanceof TagNode) and ($node->name == "else")) {
+ } elseif (($node instanceof TagNode) and ($node->name == "else")) {
$else = $node->sub;
} else {
$condition[] = $node;
}
}
- if($then === NULL) {
+ if ($then === null) {
throw new ParseCompileError("self::Transcompile error: Missing <ste:then> in <ste:if>.", $ast->tpl, $ast->offset);
}
@@ -67,14 +71,15 @@ class Transcompiler {
$output .= "\$outputstack_i--;\nif(\$ste->evalbool(array_pop(\$outputstack)))\n{\n";
$output .= self::indent_code(self::_transcompile($then));
$output .= "\n}\n";
- if($else !== NULL) {
+ if ($else !== null) {
$output .= "else\n{\n";
$output .= self::indent_code(self::_transcompile($else));
$output .= "\n}\n";
}
return $output;
}
- private static function builtin_cmp($ast) {
+ private static function builtin_cmp($ast)
+ {
$operators = array(
array('eq', '=='),
array('neq', '!='),
@@ -86,42 +91,42 @@ class Transcompiler {
$code = "";
- if(isset($ast->params["var_b"])) {
+ if (isset($ast->params["var_b"])) {
list($val, $pre) = self::_transcompile($ast->params["var_b"], true);
$code .= $pre;
$b = '$ste->get_var_by_name(' . $val . ')';
- } else if(isset($ast->params["text_b"])) {
+ } elseif (isset($ast->params["text_b"])) {
list($b, $pre) = self::_transcompile($ast->params["text_b"], true);
$code .= $pre;
} else {
throw new ParseCompileError("self::Transcompile error: neiter var_b nor text_b set in <ste:cmp>.", $ast->tpl, $ast->offset);
}
- if(isset($ast->params["var_a"])) {
+ if (isset($ast->params["var_a"])) {
list($val, $pre) = self::_transcompile($ast->params["var_a"], true);
$code .= $pre;
$a = '$ste->get_var_by_name(' . $val . ')';
- } else if(isset($ast->params["text_a"])) {
+ } elseif (isset($ast->params["text_a"])) {
list($a, $pre) = self::_transcompile($ast->params["text_a"], true);
$code .= $pre;
} else {
throw new ParseCompileError("self::Transcompile error: neiter var_a nor text_a set in <ste:cmp>.", $ast->tpl, $ast->offset);
}
- if(!isset($ast->params["op"])) {
+ if (!isset($ast->params["op"])) {
throw new ParseCompileError("self::Transcompile error: op not given in <ste:cmp>.", $ast->tpl, $ast->offset);
}
- if((count($ast->params["op"]) == 1) and ($ast->params["op"][0] instanceof TextNode)) {
+ if ((count($ast->params["op"]) == 1) and ($ast->params["op"][0] instanceof TextNode)) {
/* Operator is known at compile time, this saves *a lot* of output code! */
$op = trim($ast->params["op"][0]->text);
- $op_php = NULL;
- foreach($operators as $v) {
- if($v[0] == $op) {
+ $op_php = null;
+ foreach ($operators as $v) {
+ if ($v[0] == $op) {
$op_php = $v[1];
break;
}
}
- if($op_php === NULL) {
+ if ($op_php === null) {
throw new ParseCompileError("self::Transcompile Error: Unknown operator in <ste:cmp>", $ast->tpl, $ast->offset);
}
$code .= "\$outputstack[\$outputstack_i] .= (($a) $op_php ($b)) ? 'yes' : '';\n";
@@ -129,49 +134,52 @@ class Transcompiler {
list($val, $pre) = self::_transcompile($ast->params["op"], true);
$code .= $pre . "switch(trim(" . $val . "))\n{\n\t";
$code .= implode("", array_map(
- function($op) use ($a,$b)
- {
+ function ($op) use ($a,$b) {
list($op_stetpl, $op_php) = $op;
return "case '$op_stetpl':\n\t\$outputstack[\$outputstack_i] .= (($a) $op_php ($b)) ? 'yes' : '';\n\tbreak;\n\t";
- }, $operators
- ));
+ },
+ $operators
+ ));
$code .= "default: throw new \\kch42\\ste\\RuntimeError('Unknown operator in <ste:cmp>.');\n}\n";
}
return $code;
}
- private static function builtin_not($ast) {
+ private static function builtin_not($ast)
+ {
$code = "\$outputstack[] = '';\n\$outputstack_i++;\n";
$code .= self::_transcompile($ast->sub);
$code .= "\$outputstack_i--;\n\$outputstack[\$outputstack_i] .= (!\$ste->evalbool(array_pop(\$outputstack))) ? 'yes' : '';\n";
return $code;
}
- private static function builtin_even($ast) {
+ private static function builtin_even($ast)
+ {
$code = "\$outputstack[] = '';\n\$outputstack_i++;\n";
$code .= self::_transcompile($ast->sub);
$code .= "\$outputstack_i--;\n\$tmp_even = array_pop(\$outputstack);\n\$outputstack[\$outputstack_i] .= (is_numeric(\$tmp_even) and (\$tmp_even % 2 == 0)) ? 'yes' : '';\n";
return $code;
}
- private static function builtin_for($ast) {
+ private static function builtin_for($ast)
+ {
$code = "";
$loopname = self::tempvar("forloop");
- if(empty($ast->params["start"])) {
+ if (empty($ast->params["start"])) {
throw new ParseCompileError("self::Transcompile error: Missing 'start' parameter in <ste:for>.", $ast->tpl, $ast->offset);
}
list($val, $pre) = self::_transcompile($ast->params["start"], true);
$code .= $pre;
$code .= "\$${loopname}_start = " . $val . ";\n";
- if(empty($ast->params["stop"])) {
+ if (empty($ast->params["stop"])) {
throw new ParseCompileError("self::Transcompile error: Missing 'end' parameter in <ste:for>.", $ast->tpl, $ast->offset);
}
list($val, $pre) = self::_transcompile($ast->params["stop"], true);
$code .= $pre;
$code .= "\$${loopname}_stop = " . $val . ";\n";
- $step = NULL; /* i.e. not known at compilation time */
- if(empty($ast->params["step"])) {
+ $step = null; /* i.e. not known at compilation time */
+ if (empty($ast->params["step"])) {
$step = 1;
- } else if((count($ast->params["step"]) == 1) and ($ast->params["step"][0] instanceof TextNode)) {
+ } elseif ((count($ast->params["step"]) == 1) and ($ast->params["step"][0] instanceof TextNode)) {
$step = $ast->params["step"][0]->text + 0;
} else {
list($val, $pre) = self::_transcompile($ast->params["step"], true);
@@ -179,7 +187,7 @@ class Transcompiler {
$code .= "\$${loopname}_step = " . $val . ";\n";
}
- if(!empty($ast->params["counter"])) {
+ if (!empty($ast->params["counter"])) {
list($val, $pre) = self::_transcompile($ast->params["counter"], true);
$code .= $pre;
$code .= "\$${loopname}_countername = " . $val . ";\n";
@@ -189,7 +197,7 @@ class Transcompiler {
$loopbody .= self::_transcompile($ast->sub);
$loopbody = self::indent_code("{\n" . self::loopbody(self::indent_code($loopbody)) . "\n}\n");
- if($step === NULL) {
+ if ($step === null) {
$code .= "if(\$${loopname}_step == 0)\n\tthrow new \\kch42\\ste\\RuntimeError('step can not be 0 in <ste:for>.');\n";
$code .= "if(\$${loopname}_step > 0)\n{\n";
$code .= "\tfor(\$${loopname}_counter = \$${loopname}_start; \$${loopname}_counter <= \$${loopname}_stop; \$${loopname}_counter += \$${loopname}_step)\n";
@@ -198,9 +206,9 @@ class Transcompiler {
$code .= "\tfor(\$${loopname}_counter = \$${loopname}_start; \$${loopname}_counter >= \$${loopname}_stop; \$${loopname}_counter += \$${loopname}_step)\n";
$code .= $loopbody;
$code .= "\n}\n";
- } else if($step == 0) {
+ } elseif ($step == 0) {
throw new ParseCompileError("self::Transcompile Error: step can not be 0 in <ste:for>.", $ast->tpl, $ast->offset);
- } else if($step > 0) {
+ } elseif ($step > 0) {
$code .= "for(\$${loopname}_counter = \$${loopname}_start; \$${loopname}_counter <= \$${loopname}_stop; \$${loopname}_counter += $step)\n$loopbody\n";
} else {
$code .= "for(\$${loopname}_counter = \$${loopname}_start; \$${loopname}_counter >= \$${loopname}_stop; \$${loopname}_counter += $step)\n$loopbody\n";
@@ -208,31 +216,32 @@ class Transcompiler {
return $code;
}
- private static function builtin_foreach($ast) {
+ private static function builtin_foreach($ast)
+ {
$loopname = self::tempvar("foreachloop");
$code = "";
- if(empty($ast->params["array"])) {
+ if (empty($ast->params["array"])) {
throw new ParseCompileError("self::Transcompile Error: array not given in <ste:foreach>.", $ast->tpl, $ast->offset);
}
list($val, $pre) = self::_transcompile($ast->params["array"], true);
$code .= $pre;
$code .= "\$${loopname}_arrayvar = " . $val . ";\n";
- if(empty($ast->params["value"])) {
+ if (empty($ast->params["value"])) {
throw new ParseCompileError("self::Transcompile Error: value not given in <ste:foreach>.", $ast->tpl, $ast->offset);
}
list($val, $pre) = self::_transcompile($ast->params["value"], true);
$code .= $pre;
$code .= "\$${loopname}_valuevar = " . $val . ";\n";
- if(!empty($ast->params["key"])) {
+ if (!empty($ast->params["key"])) {
list($val, $pre) = self::_transcompile($ast->params["key"], true);
$code .= $pre;
$code .= "\$${loopname}_keyvar = " . $val . ";\n";
}
- if(!empty($ast->params["counter"])) {
+ if (!empty($ast->params["counter"])) {
list($val, $pre) = self::_transcompile($ast->params["counter"], true);
$code .= $pre;
$code .= "\$${loopname}_countervar = " . $val . ";\n";
@@ -241,15 +250,15 @@ class Transcompiler {
$loopbody = "";
$code .= "\$${loopname}_array = \$ste->get_var_by_name(\$${loopname}_arrayvar);\n";
$code .= "if(!is_array(\$${loopname}_array))\n\t\$${loopname}_array = array();\n";
- if(!empty($ast->params["counter"])) {
+ if (!empty($ast->params["counter"])) {
$code .= "\$${loopname}_counter = -1;\n";
$loopbody .= "\$${loopname}_counter++;\n\$ste->set_var_by_name(\$${loopname}_countervar, \$${loopname}_counter);\n";
}
$loop = array();
$else = array();
- foreach($ast->sub as $node) {
- if(($node instanceof TagNode) && ($node->name == "else")) {
+ foreach ($ast->sub as $node) {
+ if (($node instanceof TagNode) && ($node->name == "else")) {
$else = array_merge($else, $node->sub);
} else {
$loop[] = $node;
@@ -257,14 +266,14 @@ class Transcompiler {
}
$loopbody .= "\$ste->set_var_by_name(\$${loopname}_valuevar, \$${loopname}_value);\n";
- if(!empty($ast->params["key"])) {
+ if (!empty($ast->params["key"])) {
$loopbody .= "\$ste->set_var_by_name(\$${loopname}_keyvar, \$${loopname}_key);\n";
}
$loopbody .= "\n";
$loopbody .= self::_transcompile($loop);
$loopbody = "{\n" . self::loopbody(self::indent_code($loopbody)) . "\n}\n";
- if(!empty($else)) {
+ if (!empty($else)) {
$code .= "if(empty(\$${loopname}_array))\n{\n";
$code .= self::indent_code(self::_transcompile($else));
$code .= "\n}\nelse ";
@@ -273,17 +282,21 @@ class Transcompiler {
return $code;
}
- private static function builtin_infloop($ast) {
+ private static function builtin_infloop($ast)
+ {
return "while(true)\n{\n" . self::indent_code(self::loopbody(self::indent_code(self::_transcompile($ast->sub)))) . "\n}\n";
}
- private static function builtin_break($ast) {
+ private static function builtin_break($ast)
+ {
return "throw new \\kch42\\ste\\BreakException();\n";
}
- private static function builtin_continue($ast) {
+ private static function builtin_continue($ast)
+ {
return "throw new \\kch42\\ste\\ContinueException();\n";
}
- private static function builtin_block($ast) {
- if(empty($ast->params["name"])) {
+ private static function builtin_block($ast)
+ {
+ if (empty($ast->params["name"])) {
throw new ParseCompileError("self::Transcompile Error: name missing in <ste:block>.", $ast->tpl, $ast->offset);
}
@@ -302,8 +315,9 @@ class Transcompiler {
return $code;
}
- private static function builtin_load($ast) {
- if(empty($ast->params["name"])) {
+ private static function builtin_load($ast)
+ {
+ if (empty($ast->params["name"])) {
throw new ParseCompileError("self::Transcompile Error: name missing in <ste:load>.", $ast->tpl, $ast->offset);
}
@@ -311,10 +325,11 @@ class Transcompiler {
$code .= "\$outputstack[\$outputstack_i] .= \$ste->load(" . $val . ");\n";
return $code;
}
- private static function builtin_mktag($ast) {
+ private static function builtin_mktag($ast)
+ {
$code = "";
- if(empty($ast->params["name"])) {
+ if (empty($ast->params["name"])) {
throw new ParseCompileError("self::Transcompile Error: name missing in <ste:mktag>.", $ast->tpl, $ast->offset);
}
@@ -323,7 +338,7 @@ class Transcompiler {
list($tagname, $tagname_pre) = self::_transcompile($ast->params["name"], true);
$usemandatory = "";
- if(!empty($ast->params["mandatory"])) {
+ if (!empty($ast->params["mandatory"])) {
$usemandatory = " use (\$mandatory_params)";
$code .= "\$outputstack[] = '';\n\$outputstack_i++;\n";
$code .= self::_transcompile($ast->params["mandatory"]);
@@ -341,11 +356,13 @@ class Transcompiler {
return $code;
}
- private static function builtin_tagcontent($ast) {
+ private static function builtin_tagcontent($ast)
+ {
return "\$outputstack[\$outputstack_i] .= \$sub(\$ste);";
}
- private static function builtin_set($ast) {
- if(empty($ast->params["var"])) {
+ private static function builtin_set($ast)
+ {
+ if (empty($ast->params["var"])) {
throw new ParseCompileError("self::Transcompile Error: var missing in <ste:set>.", $ast->tpl, $ast->offset);
}
@@ -359,8 +376,9 @@ class Transcompiler {
return $code;
}
- private static function builtin_setlocal($ast) {
- if(empty($ast->params["var"])) {
+ private static function builtin_setlocal($ast)
+ {
+ if (empty($ast->params["var"])) {
throw new ParseCompileError("self::Transcompile Error: var missing in <ste:set>.", $ast->tpl, $ast->offset);
}
@@ -374,15 +392,17 @@ class Transcompiler {
return $code;
}
- private static function builtin_get($ast) {
- if(empty($ast->params["var"])) {
+ private static function builtin_get($ast)
+ {
+ if (empty($ast->params["var"])) {
throw new ParseCompileError("self::Transcompile Error: var missing in <ste:get>.", $ast->tpl, $ast->offset);
}
- list($val, $pre) = self::_transcompile($ast->params["var"], true);
+ list($val, $pre) = self::_transcompile($ast->params["var"], true);
return "$pre\$outputstack[\$outputstack_i] .= \$ste->get_var_by_name(" . $val . ");";
}
- private static function builtin_calc($ast) {
+ private static function builtin_calc($ast)
+ {
$code = "\$outputstack[] = '';\n\$outputstack_i++;\n";
$code .= self::_transcompile($ast->sub);
$code .= "\$outputstack_i--;\n\$outputstack[\$outputstack_i] .= \$ste->calc(array_pop(\$outputstack));\n";
@@ -390,39 +410,44 @@ class Transcompiler {
return $code;
}
- private static function indent_code($code) {
+ private static function indent_code($code)
+ {
return implode(
"\n",
- array_map(function($line) { return "\t$line"; }, explode("\n", $code))
+ array_map(function ($line) {
+ return "\t$line";
+ }, explode("\n", $code))
);
}
- private static function loopbody($code) {
+ private static function loopbody($code)
+ {
return "try\n{\n" . self::indent_code($code) . "\n}\ncatch(\\kch42\\ste\\BreakException \$e) { break; }\ncatch(\\kch42\\ste\\ContinueException \$e) { continue; }\n";
}
- private static function _transcompile($ast, $avoid_outputstack = false) { /* The real self::transcompile function, does not add boilerplate code. */
+ private static function _transcompile($ast, $avoid_outputstack = false)
+ { /* The real self::transcompile function, does not add boilerplate code. */
$code = "";
$text_and_var_buffer = array();
- foreach($ast as $node) {
- if($node instanceof TextNode) {
+ foreach ($ast as $node) {
+ if ($node instanceof TextNode) {
$text_and_var_buffer[] = '"' . Misc::escape_text($node->text) . '"';
- } else if($node instanceof VariableNode) {
+ } elseif ($node instanceof VariableNode) {
$text_and_var_buffer[] = $node->transcompile();
- } else if($node instanceof TagNode) {
- if(!empty($text_and_var_buffer)) {
- $code .= "\$outputstack[\$outputstack_i] .= " . implode (" . ", $text_and_var_buffer) . ";\n";
+ } elseif ($node instanceof TagNode) {
+ if (!empty($text_and_var_buffer)) {
+ $code .= "\$outputstack[\$outputstack_i] .= " . implode(" . ", $text_and_var_buffer) . ";\n";
$text_and_var_buffer = array();
}
- if(isset(self::$builtins[$node->name])) {
+ if (isset(self::$builtins[$node->name])) {
$code .= call_user_func(self::$builtins[$node->name], $node);
} else {
$paramarray = self::tempvar("parameters");
$code .= "\$$paramarray = array();\n";
- foreach($node->params as $pname => $pcontent) {
+ foreach ($node->params as $pname => $pcontent) {
list($pval, $pre) = self::_transcompile($pcontent, true);
$code .= $pre . "\$${paramarray}['" . Misc::escape_text($pname) . "'] = " . $pval . ";\n";
}
@@ -434,15 +459,15 @@ class Transcompiler {
}
}
- if($avoid_outputstack && ($code == "")) {
- return array(implode (" . ", $text_and_var_buffer), "");
+ if ($avoid_outputstack && ($code == "")) {
+ return array(implode(" . ", $text_and_var_buffer), "");
}
- if(!empty($text_and_var_buffer)) {
- $code .= "\$outputstack[\$outputstack_i] .= ". implode (" . ", $text_and_var_buffer) . ";\n";
+ if (!empty($text_and_var_buffer)) {
+ $code .= "\$outputstack[\$outputstack_i] .= ". implode(" . ", $text_and_var_buffer) . ";\n";
}
- if($avoid_outputstack) {
+ if ($avoid_outputstack) {
$tmpvar = self::tempvar("tmp");
$code = "\$outputstack[] = '';\n\$outputstack_i++;" . $code;
$code .= "\$$tmpvar = array_pop(\$outputstack);\n\$outputstack_i--;\n";
@@ -463,7 +488,8 @@ class Transcompiler {
* Returns:
* PHP code. The PHP code is an anonymous function expecting a <STECore> instance as its parameter and returns a string (everything that was not pached into a section).
*/
- public static function transcompile($ast) { /* self::Transcompile and add some boilerplate code. */
+ public static function transcompile($ast)
+ { /* self::Transcompile and add some boilerplate code. */
$boilerplate = "\$outputstack = array('');\n\$outputstack_i = 0;\n";
return "function(\$ste)\n{\n" . self::indent_code($boilerplate . self::_transcompile($ast) . "return array_pop(\$outputstack);") . "\n}";
}
diff --git a/src/ste/VarNotInScope.php b/src/ste/VarNotInScope.php
index 179d07a..6dc5eda 100644
--- a/src/ste/VarNotInScope.php
+++ b/src/ste/VarNotInScope.php
@@ -2,4 +2,6 @@
namespace kch42\ste;
-class VarNotInScope extends \Exception {}
+class VarNotInScope extends \Exception
+{
+}
diff --git a/src/ste/VariableNode.php b/src/ste/VariableNode.php
index 18bb6a4..d03fdce 100644
--- a/src/ste/VariableNode.php
+++ b/src/ste/VariableNode.php
@@ -2,19 +2,21 @@
namespace kch42\ste;
-class VariableNode extends ASTNode {
+class VariableNode extends ASTNode
+{
public $name;
public $arrayfields = array();
- public function transcompile() {
+ public function transcompile()
+ {
$varaccess = '@$ste->scope[' . (is_numeric($this->name) ? $this->name : '"' . Misc::escape_text($this->name) . '"'). ']';
- foreach($this->arrayfields as $af) {
- if((count($af) == 1) and ($af[0] instanceof TextNode) and is_numeric($af[0]->text)) {
+ foreach ($this->arrayfields as $af) {
+ if ((count($af) == 1) and ($af[0] instanceof TextNode) and is_numeric($af[0]->text)) {
$varaccess .= '[' . $af->text . ']';
} else {
- $varaccess .= '[' . implode(".", array_map(function($node) {
- if($node instanceof TextNode) {
+ $varaccess .= '[' . implode(".", array_map(function ($node) {
+ if ($node instanceof TextNode) {
return "\"" . Misc::escape_text($node->text) . "\"";
- } else if($node instanceof VariableNode) {
+ } elseif ($node instanceof VariableNode) {
return $node->transcompile();
}
}, $af)). ']';