about summary refs log tree commit diff stats
path: root/tests/DebugTest.php
diff options
context:
space:
mode:
authorAndrew Dolgov <fox@fakecake.org>2026-05-27 20:18:22 +0300
committerAndrew Dolgov <fox@fakecake.org>2026-05-27 20:18:22 +0300
commitc2ce4528c4b671466291f7947c682b4adffa007f (patch)
treeeb4493ea9ee34e44b351a46e9883bbb4405768f3 /tests/DebugTest.php
parent0d83f0350991a0993234278ff822a5a9893802f5 (diff)
downloadthe-epube-c2ce4528c4b671466291f7947c682b4adffa007f.tar.gz
the-epube-c2ce4528c4b671466291f7947c682b4adffa007f.tar.xz
add some simple tests
Diffstat (limited to 'tests/DebugTest.php')
-rw-r--r--tests/DebugTest.php219
1 files changed, 219 insertions, 0 deletions
diff --git a/tests/DebugTest.php b/tests/DebugTest.php
new file mode 100644
index 0000000..8156035
--- /dev/null
+++ b/tests/DebugTest.php
@@ -0,0 +1,219 @@
+<?php
+use PHPUnit\Framework\TestCase;
+
+final class DebugTest extends TestCase
+{
+	private string $tmpLogfile = '';
+
+	protected function setUp(): void
+	{
+		// Reset Debug static state via public setters
+		Debug::set_enabled(false);
+		Debug::set_quiet(false);
+		Debug::set_logfile('');
+		Debug::set_loglevel(0);
+
+		// Create a temp log file for file-based tests
+		$this->tmpLogfile = tempnam(sys_get_temp_dir(), 'epube_debug_');
+	}
+
+	protected function tearDown(): void
+	{
+		// Clean up temp log file
+		if ($this->tmpLogfile && file_exists($this->tmpLogfile)) {
+			unlink($this->tmpLogfile);
+		}
+
+		// Reset Debug static state via public setters
+		Debug::set_enabled(false);
+		Debug::set_quiet(false);
+		Debug::set_logfile('');
+		Debug::set_loglevel(0);
+	}
+
+	// ── Constants ────────────────────────────────────────────────────────────
+
+	public function test_constants_defined(): void
+	{
+		$this->assertEquals(-1, Debug::LOG_DISABLED);
+		$this->assertEquals(0, Debug::LOG_NORMAL);
+		$this->assertEquals(1, Debug::LOG_VERBOSE);
+		$this->assertEquals(2, Debug::LOG_EXTENDED);
+	}
+
+	// ── set_enabled / enabled() ──────────────────────────────────────────────
+
+	public function test_enabled_defaults_to_false(): void
+	{
+		$this->assertFalse(Debug::enabled());
+	}
+
+	public function test_set_enabled_true(): void
+	{
+		Debug::set_enabled(true);
+		$this->assertTrue(Debug::enabled());
+	}
+
+	public function test_set_enabled_false(): void
+	{
+		Debug::set_enabled(true);
+		Debug::set_enabled(false);
+		$this->assertFalse(Debug::enabled());
+	}
+
+	// ── set_loglevel / get_loglevel() ────────────────────────────────────────
+
+	public function test_loglevel_defaults_to_zero(): void
+	{
+		$this->assertEquals(0, Debug::get_loglevel());
+	}
+
+	public function test_set_loglevel(): void
+	{
+		Debug::set_loglevel(Debug::LOG_VERBOSE);
+		$this->assertEquals(Debug::LOG_VERBOSE, Debug::get_loglevel());
+	}
+
+	public function test_set_loglevel_extended(): void
+	{
+		Debug::set_loglevel(Debug::LOG_EXTENDED);
+		$this->assertEquals(Debug::LOG_EXTENDED, Debug::get_loglevel());
+	}
+
+	// ── log() — disabled ─────────────────────────────────────────────────────
+
+	public function test_log_disabled_does_nothing(): void
+	{
+		Debug::set_enabled(false);
+		$this->expectOutputString('');
+		Debug::log('test message', Debug::LOG_NORMAL);
+	}
+
+	// ── log() — level filtering ──────────────────────────────────────────────
+
+	public function test_log_level_filtering(): void
+	{
+		// loglevel < level means the message is skipped
+		// So with loglevel=0 (NORMAL), a message at level=1 (VERBOSE) is filtered
+		Debug::set_enabled(true);
+		Debug::set_loglevel(Debug::LOG_NORMAL);
+		Debug::set_quiet(true);
+
+		ob_start();
+		Debug::log('verbose message', Debug::LOG_VERBOSE);
+		$output = ob_get_clean();
+		$this->assertEmpty($output, 'VERBOSE message should be filtered when loglevel is NORMAL');
+	}
+
+	public function test_log_level_normal_when_loglevel_zero(): void
+	{
+		Debug::set_enabled(true);
+		Debug::set_loglevel(Debug::LOG_NORMAL);
+		Debug::set_quiet(true);
+
+		ob_start();
+		Debug::log('normal message', Debug::LOG_NORMAL);
+		$output = ob_get_clean();
+		$this->assertNotEmpty($output, 'NORMAL message should pass when loglevel is NORMAL');
+	}
+
+	// ── log() — file writing ─────────────────────────────────────────────────
+
+	public function test_log_writes_to_file(): void
+	{
+		Debug::set_enabled(true);
+		Debug::set_logfile($this->tmpLogfile);
+		Debug::set_loglevel(Debug::LOG_NORMAL);
+
+		Debug::log('file test message', Debug::LOG_NORMAL);
+
+		$this->assertFileExists($this->tmpLogfile);
+		$content = file_get_contents($this->tmpLogfile);
+		$this->assertStringContainsString('file test message', $content);
+	}
+
+	public function test_log_timestamp_in_file(): void
+	{
+		Debug::set_enabled(true);
+		Debug::set_logfile($this->tmpLogfile);
+		Debug::set_loglevel(Debug::LOG_NORMAL);
+
+		Debug::log('timestamp test', Debug::LOG_NORMAL);
+
+		$content = file_get_contents($this->tmpLogfile);
+		// Format: [HH:MM:SS/PID] message
+		$this->assertMatchesRegularExpression('/\[\d{2}:\d{2}:\d{2}\/\d+\]/', $content);
+	}
+
+	public function test_log_multiple_messages_to_file(): void
+	{
+		Debug::set_enabled(true);
+		Debug::set_logfile($this->tmpLogfile);
+		Debug::set_loglevel(Debug::LOG_NORMAL);
+
+		Debug::log('first message', Debug::LOG_NORMAL);
+		Debug::log('second message', Debug::LOG_NORMAL);
+
+		$lines = array_filter(explode("\n", file_get_contents($this->tmpLogfile)));
+		$this->assertCount(2, $lines);
+		$this->assertStringContainsString('first message', $lines[0]);
+		$this->assertStringContainsString('second message', $lines[1]);
+	}
+
+	// ── log() — quiet mode ───────────────────────────────────────────────────
+
+	public function test_quiet_mode_suppresses_stdout(): void
+	{
+		// quiet mode only suppresses stdout when a logfile is set
+		Debug::set_enabled(true);
+		Debug::set_loglevel(Debug::LOG_NORMAL);
+		Debug::set_quiet(true);
+		Debug::set_logfile($this->tmpLogfile);
+
+		ob_start();
+		Debug::log('quiet test', Debug::LOG_NORMAL);
+		$output = ob_get_clean();
+		$this->assertEmpty($output, 'Quiet mode should suppress stdout when logfile is set');
+	}
+
+	public function test_non_quiet_mode_prints_to_stdout(): void
+	{
+		Debug::set_enabled(true);
+		Debug::set_loglevel(Debug::LOG_NORMAL);
+		Debug::set_quiet(false);
+
+		ob_start();
+		Debug::log('stdout test', Debug::LOG_NORMAL);
+		$output = ob_get_clean();
+		$this->assertStringContainsString('stdout test', $output);
+	}
+
+	// ── set_logfile ──────────────────────────────────────────────────────────
+
+	public function test_set_logfile(): void
+	{
+		Debug::set_logfile('/tmp/test_debug.log');
+		$ref = new ReflectionClass(Debug::class);
+		$prop = $ref->getProperty('logfile');
+		$this->assertEquals('/tmp/test_debug.log', $prop->getValue(null));
+	}
+
+	// ── set_quiet ────────────────────────────────────────────────────────────
+
+	public function test_set_quiet_true(): void
+	{
+		Debug::set_quiet(true);
+		$ref = new ReflectionClass(Debug::class);
+		$prop = $ref->getProperty('quiet');
+		$this->assertTrue($prop->getValue(null));
+	}
+
+	public function test_set_quiet_false(): void
+	{
+		Debug::set_quiet(true);
+		Debug::set_quiet(false);
+		$ref = new ReflectionClass(Debug::class);
+		$prop = $ref->getProperty('quiet');
+		$this->assertFalse($prop->getValue(null));
+	}
+}