1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
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));
}
}
|