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	private 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	/** @param class-string $class */
33	public static function fromClass(string $class): self
34	{
35	return new self(Command::of($class), $class, static fn(): object => new $class());
36	}
37
38	/** @param class-string $class */
39	public static function fromFactory(string $class, Closure $factory): self
40	{
41	return new self(Command::of($class), $class, $factory);
42	}
43
44	public function command(): object
45	{
46	if ($this->command === null) {
47	$command = ($this->factory)();
48
49	// The metadata was read from the keyed class; an unrelated
50	// object would be described by one class and run as another.
51	if (!$command instanceof $this->class) {
52	throw new ValueError(
53	"Factory for command '{$this->meta->full()}' must return a {$this->class}",
54	);
55	}
56
57	$this->command = $command;
58	}
59
60	return $this->command;
61	}
62
63	/** @return list<Opt> */
64	public function opts(): array
65	{
66	return Opt::of($this->class);
67	}
68
69	/** @return list<Arg> */
70	public function args(): array
71	{
72	return Arg::of($this->class);
73	}
74	}

---

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	private readonly string $class,
24	private readonly Closure $factory,
25	) {}

Entry->args

72	return Arg::of($this->class);
73	}

Entry->command

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

47	$command = ($this->factory)();
48
49	// The metadata was read from the keyed class; an unrelated
50	// object would be described by one class and run as another.
51	if (!$command instanceof $this->class) {

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

57	$this->command = $command;
58	}
59
60	return $this->command;

60	return $this->command;
61	}

Entry->fromClass

33	public static function fromClass(string $class): self
34	{
35	return new self(Command::of($class), $class, static fn(): object => new $class());
36	}

Entry->fromFactory

39	public static function fromFactory(string $class, Closure $factory): self
40	{
41	return new self(Command::of($class), $class, $factory);
42	}

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->opts

66	return Opt::of($this->class);
67	}

{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:35-35}

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