Merge pull request 'feat: PHPUnit test infrastructure + 12 tests' (#114) from dev into main
Universal: Cascade Main → Dev / Cascade main → branches (push) Successful in 5s
Generic: Repo Health / Site Health (push) Has been skipped
Generic: Repo Health / Access control (push) Successful in 2s
Generic: Repo Health / Release configuration (push) Successful in 4s
Generic: Repo Health / Scripts governance (push) Successful in 4s
Generic: Repo Health / Repository health (push) Successful in 11s
Platform: moko-platform CI / Gate 1: Code Quality (push) Successful in 46s
Platform: moko-platform CI / Gate 5: Template Integrity (push) Failing after 6s
Platform: moko-platform CI / Gate 2: Unit Tests (8.2) (push) Successful in 54s
Platform: moko-platform CI / Gate 3: Self-Health Check (push) Failing after 52s
Platform: moko-platform CI / Gate 4: Governance (push) Successful in 53s
Platform: moko-platform CI / Gate 2: Unit Tests (8.1) (push) Successful in 58s
Platform: moko-platform CI / Gate 2: Unit Tests (8.3) (push) Successful in 1m0s
Platform: moko-platform CI / CI Summary (push) Has been cancelled

This commit was merged in pull request #114.
This commit is contained in:
2026-05-26 02:39:00 +00:00
3 changed files with 314 additions and 0 deletions
+17
View File
@@ -0,0 +1,17 @@
<?xml version="1.0" encoding="UTF-8"?>
<!--
Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
SPDX-License-Identifier: GPL-3.0-or-later
-->
<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="vendor/phpunit/phpunit/phpunit.xsd"
bootstrap="vendor/autoload.php"
colors="true"
failOnRisky="true"
failOnWarning="true">
<testsuites>
<testsuite name="Unit">
<directory>tests/Unit</directory>
</testsuite>
</testsuites>
</phpunit>
+164
View File
@@ -0,0 +1,164 @@
<?php
/* Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
* SPDX-License-Identifier: GPL-3.0-or-later
*/
declare(strict_types=1);
namespace MokoStandards\Tests\Unit;
use PHPUnit\Framework\TestCase;
/**
* Tests for cli/version_bump.php
*/
class VersionBumpTest extends TestCase
{
private string $tmpDir;
private string $script;
protected function setUp(): void
{
$this->tmpDir = sys_get_temp_dir() . '/moko-test-' . uniqid();
mkdir($this->tmpDir, 0755, true);
$this->script = dirname(__DIR__, 2) . '/cli/version_bump.php';
}
protected function tearDown(): void
{
$this->rmdir($this->tmpDir);
}
public function testPatchBump(): void
{
$this->writeReadme('01.02.03');
$output = $this->execute();
$this->assertStringContainsString('01.02.04', $output);
$this->assertReadmeVersion('01.02.04');
}
public function testPatchBumpRollover(): void
{
$this->writeReadme('01.02.99');
$this->execute();
$this->assertReadmeVersion('01.03.00');
}
public function testMinorBump(): void
{
$this->writeReadme('01.02.03');
$this->execute(['--minor']);
$this->assertReadmeVersion('01.03.00');
}
public function testMajorBump(): void
{
$this->writeReadme('01.02.03');
$this->execute(['--major']);
$this->assertReadmeVersion('02.00.00');
}
public function testBumpsFromHtmlComment(): void
{
file_put_contents(
"{$this->tmpDir}/README.md",
"<!-- VERSION: 03.05.01 -->\nSome content\n"
);
$this->execute();
$content = file_get_contents("{$this->tmpDir}/README.md");
$this->assertStringContainsString('03.05.02', $content);
$this->assertStringContainsString('Some content', $content);
}
public function testBumpsWhenXmlHasSuffix(): void
{
$this->writeReadme('01.00.00');
mkdir("{$this->tmpDir}/src", 0755, true);
file_put_contents(
"{$this->tmpDir}/src/test.xml",
'<extension type="component">'
. '<version>01.00.00-dev</version></extension>'
);
$output = $this->execute();
$this->assertStringContainsString('01.00.01', $output);
}
public function testFailsWithNoVersion(): void
{
file_put_contents(
"{$this->tmpDir}/README.md",
"# No version\n"
);
$code = 0;
$this->execute([], $code);
$this->assertSame(1, $code);
}
private function writeReadme(string $version): void
{
file_put_contents(
"{$this->tmpDir}/README.md",
"<!-- VERSION: {$version} -->\n"
);
}
private function assertReadmeVersion(string $expected): void
{
$content = file_get_contents("{$this->tmpDir}/README.md");
$this->assertMatchesRegularExpression(
'/VERSION:\s*' . preg_quote($expected, '/') . '/',
$content
);
}
/**
* @param string[] $extraArgs
*/
private function execute(
array $extraArgs = [],
int &$exitCode = 0
): string {
$cmd = ['php', $this->script, '--path', $this->tmpDir];
$cmd = array_merge($cmd, $extraArgs);
$descriptors = [
1 => ['pipe', 'w'],
2 => ['pipe', 'w'],
];
$proc = proc_open($cmd, $descriptors, $pipes);
$stdout = stream_get_contents($pipes[1]);
fclose($pipes[1]);
fclose($pipes[2]);
$exitCode = proc_close($proc);
return $stdout ?: '';
}
private function rmdir(string $dir): void
{
if (!is_dir($dir)) {
return;
}
$iter = new \RecursiveIteratorIterator(
new \RecursiveDirectoryIterator(
$dir,
\FilesystemIterator::SKIP_DOTS
),
\RecursiveIteratorIterator::CHILD_FIRST
);
foreach ($iter as $file) {
$file->isDir()
? rmdir($file->getPathname())
: unlink($file->getPathname());
}
rmdir($dir);
}
}
+133
View File
@@ -0,0 +1,133 @@
<?php
/* Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
* SPDX-License-Identifier: GPL-3.0-or-later
*/
declare(strict_types=1);
namespace MokoStandards\Tests\Unit;
use PHPUnit\Framework\TestCase;
/**
* Tests for cli/version_read.php
*/
class VersionReadTest extends TestCase
{
private string $tmpDir;
private string $script;
protected function setUp(): void
{
$this->tmpDir = sys_get_temp_dir() . '/moko-test-' . uniqid();
mkdir($this->tmpDir, 0755, true);
$this->script = dirname(__DIR__, 2) . '/cli/version_read.php';
}
protected function tearDown(): void
{
$this->rmdir($this->tmpDir);
}
public function testReadsVersionFromReadme(): void
{
file_put_contents(
"{$this->tmpDir}/README.md",
"# Test\n<!-- VERSION: 02.03.04 -->\n"
);
$this->assertSame('02.03.04', trim($this->runScript()));
}
public function testReadsVersionFromXmlManifest(): void
{
mkdir("{$this->tmpDir}/src", 0755, true);
file_put_contents(
"{$this->tmpDir}/src/test.xml",
'<extension type="component">'
. '<version>05.01.00</version></extension>'
);
$this->assertSame('05.01.00', trim($this->runScript()));
}
public function testStripsStabilitySuffixFromXml(): void
{
mkdir("{$this->tmpDir}/src", 0755, true);
file_put_contents(
"{$this->tmpDir}/src/test.xml",
'<extension type="component">'
. '<version>01.00.00-dev</version></extension>'
);
$this->assertSame('01.00.00', trim($this->runScript()));
}
public function testReturnsHigherOfReadmeAndManifest(): void
{
file_put_contents(
"{$this->tmpDir}/README.md",
"<!-- VERSION: 01.02.00 -->\n"
);
mkdir("{$this->tmpDir}/src", 0755, true);
file_put_contents(
"{$this->tmpDir}/src/test.xml",
'<extension type="component">'
. '<version>01.03.00</version></extension>'
);
$this->assertSame('01.03.00', trim($this->runScript()));
}
public function testExitsNonZeroWhenNoVersion(): void
{
file_put_contents(
"{$this->tmpDir}/README.md",
"# No version here\n"
);
$code = 0;
$this->runScript($code);
$this->assertSame(1, $code);
}
private function runScript(int &$exitCode = 0): string
{
$proc = proc_open(
['php', $this->script, '--path', $this->tmpDir],
[1 => ['pipe', 'w'], 2 => ['pipe', 'w']],
$pipes
);
$stdout = stream_get_contents($pipes[1]);
fclose($pipes[1]);
fclose($pipes[2]);
$exitCode = proc_close($proc);
return $stdout ?: '';
}
private function rmdir(string $dir): void
{
if (!is_dir($dir)) {
return;
}
$iter = new \RecursiveIteratorIterator(
new \RecursiveDirectoryIterator(
$dir,
\FilesystemIterator::SKIP_DOTS
),
\RecursiveIteratorIterator::CHILD_FIRST
);
foreach ($iter as $file) {
$file->isDir()
? rmdir($file->getPathname())
: unlink($file->getPathname());
}
rmdir($dir);
}
}