TASK: Implement ValueReferenceParser

Author: grebaldi

src/Domain/VariableName/VariableName.php

@@ -0,0 +1,36 @@
+<?php
+
+/**
+ * PackageFactory.ComponentEngine - Universal View Components for PHP
+ *   Copyright (C) 2023 Contributors of PackageFactory.ComponentEngine
+ *
+ *   This program is free software: you can redistribute it and/or modify
+ *   it under the terms of the GNU General Public License as published by
+ *   the Free Software Foundation, either version 3 of the License, or
+ *   (at your option) any later version.
+ *
+ *   This program is distributed in the hope that it will be useful,
+ *   but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *   GNU General Public License for more details.
+ *
+ *   You should have received a copy of the GNU General Public License
+ *   along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+declare(strict_types=1);
+
+namespace PackageFactory\ComponentEngine\Domain\VariableName;
+
+final class VariableName
+{
+    private function __construct(
+        public readonly string $value
+    ) {
+    }
+
+    public static function from(string $string): self
+    {
+        return new self($string);
+    }
+}

src/Language/AST/Node/ValueReference/ValueReferenceNode.php

@@ -0,0 +1,36 @@
+<?php
+
+/**
+ * PackageFactory.ComponentEngine - Universal View Components for PHP
+ *   Copyright (C) 2023 Contributors of PackageFactory.ComponentEngine
+ *
+ *   This program is free software: you can redistribute it and/or modify
+ *   it under the terms of the GNU General Public License as published by
+ *   the Free Software Foundation, either version 3 of the License, or
+ *   (at your option) any later version.
+ *
+ *   This program is distributed in the hope that it will be useful,
+ *   but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *   GNU General Public License for more details.
+ *
+ *   You should have received a copy of the GNU General Public License
+ *   along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+declare(strict_types=1);
+
+namespace PackageFactory\ComponentEngine\Language\AST\Node\ValueReference;
+
+use PackageFactory\ComponentEngine\Domain\VariableName\VariableName;
+use PackageFactory\ComponentEngine\Language\AST\Node\Node;
+use PackageFactory\ComponentEngine\Language\AST\NodeAttributes\NodeAttributes;
+
+final class ValueReferenceNode extends Node
+{
+    public function __construct(
+        public readonly NodeAttributes $attributes,
+        public readonly VariableName $name
+    ) {
+    }
+}

src/Language/Parser/ValueReference/ValueReferenceParser.php

@@ -0,0 +1,53 @@
+<?php
+
+/**
+ * PackageFactory.ComponentEngine - Universal View Components for PHP
+ *   Copyright (C) 2023 Contributors of PackageFactory.ComponentEngine
+ *
+ *   This program is free software: you can redistribute it and/or modify
+ *   it under the terms of the GNU General Public License as published by
+ *   the Free Software Foundation, either version 3 of the License, or
+ *   (at your option) any later version.
+ *
+ *   This program is distributed in the hope that it will be useful,
+ *   but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *   GNU General Public License for more details.
+ *
+ *   You should have received a copy of the GNU General Public License
+ *   along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+declare(strict_types=1);
+
+namespace PackageFactory\ComponentEngine\Language\Parser\ValueReference;
+
+use PackageFactory\ComponentEngine\Domain\VariableName\VariableName;
+use PackageFactory\ComponentEngine\Language\AST\Node\ValueReference\ValueReferenceNode;
+use PackageFactory\ComponentEngine\Language\AST\NodeAttributes\NodeAttributes;
+use PackageFactory\ComponentEngine\Parser\Tokenizer\Scanner;
+use PackageFactory\ComponentEngine\Parser\Tokenizer\Token;
+use PackageFactory\ComponentEngine\Parser\Tokenizer\TokenType;
+
+final class ValueReferenceParser
+{
+    /**
+     * @param \Iterator<mixed,Token> $tokens
+     * @return ValueReferenceNode
+     */
+    public function parse(\Iterator $tokens): ValueReferenceNode
+    {
+        Scanner::assertType($tokens, TokenType::STRING);
+
+        $token = $tokens->current();
+
+        Scanner::skipOne($tokens);
+
+        return new ValueReferenceNode(
+            attributes: new NodeAttributes(
+                rangeInSource: $token->boundaries
+            ),
+            name: VariableName::from($token->value)
+        );
+    }
+}

test/Unit/Language/Parser/ValueReference/ValueReferenceParserTest.php

@@ -0,0 +1,60 @@
+<?php
+
+/**
+ * PackageFactory.ComponentEngine - Universal View Components for PHP
+ *   Copyright (C) 2022 Contributors of PackageFactory.ComponentEngine
+ *
+ *   This program is free software: you can redistribute it and/or modify
+ *   it under the terms of the GNU General Public License as published by
+ *   the Free Software Foundation, either version 3 of the License, or
+ *   (at your option) any later version.
+ *
+ *   This program is distributed in the hope that it will be useful,
+ *   but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *   GNU General Public License for more details.
+ *
+ *   You should have received a copy of the GNU General Public License
+ *   along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+declare(strict_types=1);
+
+namespace PackageFactory\ComponentEngine\Test\Unit\Language\Parser\ValueReference;
+
+use PackageFactory\ComponentEngine\Domain\VariableName\VariableName;
+use PackageFactory\ComponentEngine\Language\AST\Node\ValueReference\ValueReferenceNode;
+use PackageFactory\ComponentEngine\Language\Parser\ValueReference\ValueReferenceParser;
+use PackageFactory\ComponentEngine\Language\AST\NodeAttributes\NodeAttributes;
+use PackageFactory\ComponentEngine\Parser\Source\Range;
+use PackageFactory\ComponentEngine\Parser\Source\Position;
+use PackageFactory\ComponentEngine\Parser\Source\Source;
+use PackageFactory\ComponentEngine\Parser\Tokenizer\Tokenizer;
+use PHPUnit\Framework\TestCase;
+
+final class ValueReferenceParserTest extends TestCase
+{
+    /**
+     * @test
+     */
+    public function parsesValueReference(): void
+    {
+        $valueReferenceParser = new ValueReferenceParser();
+        $tokens = Tokenizer::fromSource(Source::fromString('foo'))->getIterator();
+
+        $expectedValueReferenceNode = new ValueReferenceNode(
+            attributes: new NodeAttributes(
+                rangeInSource: Range::from(
+                    new Position(0, 0),
+                    new Position(0, 2)
+                )
+            ),
+            name: VariableName::from('foo')
+        );
+
+        $this->assertEquals(
+            $expectedValueReferenceNode,
+            $valueReferenceParser->parse($tokens)
+        );
+    }
+}