<?phpnamespace Tests;use App\Alis\Lang\Assembler;use App\Alis\Lang\CompileError;use App\Alis\Lang\Printer;use App\Alis\Lang\Script;use PHPUnit\Framework\TestCase;/** The ALIS source language (docs/language.md): compiled by Assembler, written back by Printer. */final class LanguageTest extends TestCase{ private const SOURCE = <<<'ALS'// a tiny scriptscript "demo"id 0x0042class 0x00 0x1ememory 0x0020 0x0100 0x0020pack 0xa0resources "demo.res"main startbefore tickstart: vw[0x10] = 0loop: vw[0x10] += 1 if vw[0x10] < 300 goto next vw[0x10] = 0next: tb[0x40](vw[0x10] % 4) = rnd(16) switch vw[0x10] case 1 goto loop case 7 goto start end put 3 stop goto looptick: vb[0x3ca1] = scan() ifnot vb[0x3bbf] == 0 goto done soundondone: retALS; private function compile(string $src): Script { return (new Assembler())->compile($src, fn (string $file) => "RES!"); } public function testASourceCompilesIntoTheBytesTheVmRuns(): void { $s = $this->compile(self::SOURCE); $b = $s->bytes(); self::assertSame(0x42, unpack('v', $b)[1]); self::assertSame("RES!", substr($b, -4)); self::assertSame(0x18, $s->main); // vw[0x10] = 0: cstore, oimmb 0, sdirw 0x10 self::assertSame("\x1e\x00\x00\x14\x10", substr($b, 0x18, 5)); // a backward jump takes the shortest size: "goto loop" is cjmp8 self::assertStringContainsString("\x08", $s->code); self::assertTrue(Script::isScript($b)); } public function testDecompilingGivesASourceThatCompilesToTheSameBytes(): void { $s = $this->compile(self::SOURCE); $text = (new Printer())->script($s, 'demo.res'); $back = $this->compile($text); self::assertSame($s->bytes(), $back->bytes()); self::assertStringContainsString('switch vw[0x10]', $text); self::assertStringContainsString('tb[0x40](vw[0x10] % 4) = rnd(16)', $text); } public function testForwardJumpsAre24BitsLikeTheOriginalCompiler(): void { $s = $this->compile("script \"x\"\nresources \"r\"\nmain a\na:\n goto b\nb:\n stop\n"); self::assertSame("\x0a\x00\x00\x00\x42", $s->code); } public function testAMistakeSaysItsLine(): void { try { $this->compile("script \"x\"\nresources \"r\"\nmain a\na:\n vw[0x10] = \n"); self::fail('no error'); } catch (CompileError $e) { self::assertSame(5, $e->sourceLine); self::assertStringContainsString('line 5', $e->getMessage()); } } public function testTheNinetiesFormIsTheSameScriptInHumanWords(): void { $human = \App\Alis\Lang\Human::toHuman(self::SOURCE); self::assertTrue(\App\Alis\Lang\Human::isHuman($human)); self::assertStringContainsString('module "demo"', $human); self::assertStringContainsString('fin_variables', $human); self::assertMatchesRegularExpression('/mot_10 := 0/', $human); self::assertStringContainsString('si mot_10 < 300 aller', $human); self::assertSame(self::SOURCE, \App\Alis\Lang\Human::toCanonical($human)); // both forms compile to the same bytes $read = static fn (string $f): string => ''; $a = (new Assembler())->compile(self::SOURCE, $read); $b = \App\Alis\Lang\Human::compile($human, $read); self::assertSame($a->bytes(), $b->bytes()); } public function testAMistakeInTheNinetiesFormSaysItsOwnLine(): void { $human = \App\Alis\Lang\Human::toHuman(self::SOURCE); $lines = explode("\n", $human); $at = array_search(' fin_tour', $lines, true); self::assertIsInt($at); $lines[$at] = ' frobnique 1'; try { \App\Alis\Lang\Human::compile(implode("\n", $lines), static fn (string $f): string => ''); self::fail('no error'); } catch (CompileError $e) { self::assertSame($at + 1, $e->sourceLine); } } public function testAlisBasicIsTheSameScriptAsTheDevelopersWroteIt(): void { $basic = \App\Alis\Lang\Basic::toBasic(self::SOURCE); self::assertTrue(\App\Alis\Lang\Basic::isBasic($basic)); self::assertSame(\App\Alis\Lang\Forms::BASIC, \App\Alis\Lang\Forms::of($basic)); self::assertStringContainsString('ACTOR "demo"', $basic); self::assertMatchesRegularExpression('/^LOCAL\s+v_10&\s+AT &H10$/m', $basic); self::assertStringContainsString('ADD v_10&, 1', $basic); self::assertStringContainsString('IF v_10& < 300 THEN GOTO', $basic); self::assertSame(self::SOURCE, \App\Alis\Lang\Basic::toCanonical($basic)); // the three forms compile to the same bytes $read = static fn (string $f): string => ''; $a = (new Assembler())->compile(self::SOURCE, $read); self::assertSame($a->bytes(), \App\Alis\Lang\Human::compile($basic, $read)->bytes()); self::assertSame($basic, \App\Alis\Lang\Forms::to(\App\Alis\Lang\Forms::BASIC, \App\Alis\Lang\Human::toHuman(self::SOURCE))); } public function testAMistakeInAlisBasicSaysItsOwnLine(): void { $lines = explode("\n", \App\Alis\Lang\Basic::toBasic(self::SOURCE)); $at = array_search(' STOP', $lines, true); self::assertIsInt($at); $lines[$at] = ' FROBNICATE 1'; $undeclared = $lines; try { \App\Alis\Lang\Human::compile(implode("\n", $lines), static fn (string $f): string => ''); self::fail('no error'); } catch (CompileError $e) { self::assertSame($at + 1, $e->sourceLine); } // a variable that is not declared $undeclared[$at] = ' nouveau| = 1'; try { \App\Alis\Lang\Human::compile(implode("\n", $undeclared), static fn (string $f): string => ''); self::fail('no error'); } catch (CompileError $e) { self::assertSame($at + 1, $e->sourceLine); self::assertStringContainsString('not declared', $e->getMessage()); } }}