1	<?php
2
3	declare(strict_types=1);
4
5	namespace Celema\Console;
6
7	use Closure;
8	use ValueError;
9
10	/**
11	* A registered command: its metadata plus the factory producing the
12	* runnable instance on first use.
13	*
14	* @internal
15	*/
16	final class Entry
17	{
18	private ?object $command = null;
19
20	/** @param class-string $class */
21	private function __construct(
22	public readonly Command $meta,
23	public readonly string $class,
24	private readonly Closure $factory,
25	) {}
26
27	public static function fromInstance(object $command): self
28	{
29	return new self(Command::of($command), $command::class, static fn(): object => $command);
30	}
31
32	/**
33	* @param class-string $class
34	*
35	* @psalm-suppress MixedMethodCall The command class is known only at runtime
36	*/
37	public static function fromClass(string $class): self
38	{
39	return new self(Command::of($class), $class, static fn(): object => new $class());
40	}
41
42	/** @param class-string $class */
43	public static function fromFactory(string $class, Closure $factory): self
44	{
45	return new self(Command::of($class), $class, $factory);
46	}
47
48	/**
49	* @psalm-suppress MixedAssignment, MixedReturnStatement Psalm does not narrow the
50	*     factory's result by instanceof against a class-string; PHPStan and Mago do
51	*/
52	public function command(): object
53	{
54	if ($this->command === null) {
55	$command = ($this->factory)();
56
57	// The metadata was read from the keyed class; an unrelated
58	// object would be described by one class and run as another.
59	if (!$command instanceof $this->class) {
60	throw new ValueError(
61	"Factory for command '{$this->meta->full()}' must return a {$this->class}",
62	);
63	}
64
65	$this->command = $command;
66	}
67
68	return $this->command;
69	}
70
71	/**
72	* Reads the command's signature off the keyed class.
73	*/
74	public function signature(): Signature
75	{
76	return Signature::of($this->class, $this->meta->full());
77	}
78	}

---

Branches

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

Entry->__construct

22	public readonly Command $meta,
23	public readonly string $class,
24	private readonly Closure $factory,
25	) {}

Entry->command

54	if ($this->command === null) {

55	$command = ($this->factory)();
56
57	// The metadata was read from the keyed class; an unrelated
58	// object would be described by one class and run as another.
59	if (!$command instanceof $this->class) {

60	throw new ValueError(
61	"Factory for command '{$this->meta->full()}' must return a {$this->class}",

65	$this->command = $command;
66	}
67
68	return $this->command;

68	return $this->command;
69	}

Entry->fromClass

37	public static function fromClass(string $class): self
38	{
39	return new self(Command::of($class), $class, static fn(): object => new $class());
40	}

Entry->fromFactory

43	public static function fromFactory(string $class, Closure $factory): self
44	{
45	return new self(Command::of($class), $class, $factory);
46	}

Entry->fromInstance

27	public static function fromInstance(object $command): self
28	{
29	return new self(Command::of($command), $command::class, static fn(): object => $command);
30	}

Entry->signature

76	return Signature::of($this->class, $this->meta->full());
77	}

{closure:/workspace/celema/console/src/Entry.php:29-29}

29	return new self(Command::of($command), $command::class, static fn(): object => $command);

{closure:/workspace/celema/console/src/Entry.php:39-39}

39	return new self(Command::of($class), $class, static fn(): object => new $class());