Code Coverage for /workspace/celema/quma/src/Migrations/TestRunConfirmation.php

1	<?php
2
3	declare(strict_types=1);
4
5	namespace Celema\Quma\Migrations;
6
7	use Celema\Console\Io;
8
9	final class TestRunConfirmation
10	{
11	public function confirm(Io $io, bool $yes): bool
12	{
13	$this->showWarning($io);
14
15	if ($yes) {
16	return true;
17	}
18
19	if (!$this->inputIsInteractive()) {
20	$io->echoln("\nUse --yes to confirm test-run execution in non-interactive shells.");
21
22	return false;
23	}
24
25	// Interactive prompting needs a real TTY; non-interactive safety behavior is covered above.
26	// @codeCoverageIgnoreStart
27	if (!$io->confirm('Continue?')) {
28	$io->echoln('Aborted.');
29
30	return false;
31	}
32
33	return true;
34
35	// @codeCoverageIgnoreEnd
36	}
37
38	private function showWarning(Io $io): void
39	{
40	$io->echoln(
41	"\n<bright-red>Warning</bright-red>: --test-run executes migrations before rolling the database transaction back.",
42	);
43	$io->echoln('SQL migrations are sent to the database.');
44	$io->echoln('TPQL migrations are rendered, so PHP template code runs.');
45	$io->echoln('PHP migrations are required and executed.');
46	$io->echoln('Rollback only covers database changes in the transaction.');
47	$io->echoln(
48	'File writes, HTTP calls, queues, emails, logs, cache writes, and other external side effects are not undone.',
49	);
50	}
51
52	private function inputIsInteractive(): bool
53	{
54	return defined('STDIN') && stream_isatty(STDIN);
55	}
56	}