1	<?php
2
3	declare(strict_types=1);
4
5	namespace Celema\Console;
6
7	use Override;
8
9	/**
10	* A terminal in memory, made for tests.
11	*
12	* It captures the output and the error output separately and answers
13	* the prompts from `$input`, one line each. Colors are off, so
14	* assertions need no escape-code stripping; the other settings let a
15	* test pretend to be an interactive terminal of a given width.
16	*
17	*     $buffer = new Buffer("yes\n");
18	*     $command(io: new Io($buffer));
19	*     $this->assertSame('Done' . PHP_EOL, $buffer->output());
20	*
21	* @api
22	*/
23	final class Buffer implements Terminal
24	{
25	private string $output = '';
26	private string $errorOutput = '';
27
28	public function __construct(
29	private string $input = '',
30	private readonly bool $interactive = false,
31	private readonly int $width = 80,
32	private readonly bool $colors = false,
33	) {}
34
35	#[Override]
36	public function write(string $text, bool $error = false): void
37	{
38	if ($error) {
39	$this->errorOutput .= $text;
40	} else {
41	$this->output .= $text;
42	}
43	}
44
45	#[Override]
46	public function read(bool $hidden = false): ?string
47	{
48	if ($this->input === '') {
49	return null;
50	}
51
52	$lines = explode("\n", $this->input, limit: 2);
53	$this->input = $lines[1] ?? '';
54
55	return rtrim($lines[0], characters: "\r");
56	}
57
58	#[Override]
59	public function colors(bool $error = false): bool
60	{
61	return $this->colors;
62	}
63
64	#[Override]
65	public function interactive(): bool
66	{
67	return $this->interactive;
68	}
69
70	#[Override]
71	public function width(): int
72	{
73	return $this->width;
74	}
75
76	public function output(): string
77	{
78	return $this->output;
79	}
80
81	public function errorOutput(): string
82	{
83	return $this->errorOutput;
84	}
85	}

---

Paths

Below are the source code lines that represent each code path as identified by Xdebug. Please note a path is not necessarily coterminous with a line, a line may contain multiple paths and therefore show up more than once. Please also be aware that some paths may include implicit rather than explicit branches, e.g. an if statement always has an else as part of its logical flow even if you didn't write one.

Buffer->__construct

29	private string $input = '',
30	private readonly bool $interactive = false,
31	private readonly int $width = 80,
32	private readonly bool $colors = false,
33	) {}

Buffer->colors

59	public function colors(bool $error = false): bool
60	{
61	return $this->colors;
62	}

Buffer->errorOutput

83	return $this->errorOutput;
84	}

Buffer->interactive

67	return $this->interactive;
68	}

Buffer->output

78	return $this->output;
79	}

Buffer->read

46	public function read(bool $hidden = false): ?string
47	{
48	if ($this->input === '') {
49	return null;

46	public function read(bool $hidden = false): ?string
47	{
48	if ($this->input === '') {
52	$lines = explode("\n", $this->input, limit: 2);
53	$this->input = $lines[1] ?? '';
54
55	return rtrim($lines[0], characters: "\r");
56	}

Buffer->width

73	return $this->width;
74	}

Buffer->write

36	public function write(string $text, bool $error = false): void
37	{
38	if ($error) {
38	if ($error) {
39	$this->errorOutput .= $text;
43	}

36	public function write(string $text, bool $error = false): void
37	{
38	if ($error) {
41	$this->output .= $text;
42	}
43	}
43	}