diff options
| author | Andrew Dolgov <fox@fakecake.org> | 2026-05-27 20:18:22 +0300 |
|---|---|---|
| committer | Andrew Dolgov <fox@fakecake.org> | 2026-05-27 20:18:22 +0300 |
| commit | c2ce4528c4b671466291f7947c682b4adffa007f (patch) | |
| tree | eb4493ea9ee34e44b351a46e9883bbb4405768f3 /tests/DebugTest.php | |
| parent | 0d83f0350991a0993234278ff822a5a9893802f5 (diff) | |
| download | the-epube-c2ce4528c4b671466291f7947c682b4adffa007f.tar.gz the-epube-c2ce4528c4b671466291f7947c682b4adffa007f.tar.xz | |
add some simple tests
Diffstat (limited to 'tests/DebugTest.php')
| -rw-r--r-- | tests/DebugTest.php | 219 |
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)); + } +} |
