SetupGacela::mergeFactories() - Code Metrics - gacela-project/gacela - Measure and Improve Code Quality continuously with Scrutinizer

SetupGacela::mergeFactories() A
last analyzed 2025-11-11 07:05 UTC

↳ Parent: SetupGacela

Complexity

Conditions	1
Paths	1

Size

Total Lines	3
Code Lines	1

Duplication

Lines	0
Ratio	0 %

Importance

Changes

Metric	Value
cc	1
eloc	1
nc	1
nop	1
dl	0
loc	3
rs	10
c	0
b	0
f	0

<?php

declare(strict_types=1);

namespace Gacela\Framework\Bootstrap;

use Closure;
use Gacela\Framework\Bootstrap\Setup\BuilderExecutor;
use Gacela\Framework\Bootstrap\Setup\GacelaConfigExtender;
use Gacela\Framework\Bootstrap\Setup\Properties;
use Gacela\Framework\Bootstrap\Setup\PropertyChangeTracker;
use Gacela\Framework\Bootstrap\Setup\PropertyMerger;
use Gacela\Framework\Bootstrap\Setup\SetupInitializer;
use Gacela\Framework\Bootstrap\Setup\SetupMerger;
use Gacela\Framework\Config\GacelaConfigBuilder\AppConfigBuilder;
use Gacela\Framework\Config\GacelaConfigBuilder\BindingsBuilder;
use Gacela\Framework\Config\GacelaConfigBuilder\SuffixTypesBuilder;
use Gacela\Framework\Event\Dispatcher\EventDispatcherInterface;
use RuntimeException;

use function is_callable;
use function sprintf;

/**
 * @psalm-suppress ArgumentTypeCoercion,MixedArgumentTypeCoercion
 */
final class SetupGacela extends AbstractSetupGacela
{
    private readonly Properties $properties;

    private readonly PropertyChangeTracker $changeTracker;

    private readonly BuilderExecutor $builderExecutor;

    private readonly PropertyMerger $propertyMerger;

    public function __construct()
    {
        $this->properties = new Properties();
        $this->changeTracker = new PropertyChangeTracker();
        $this->builderExecutor = new BuilderExecutor($this->properties);
        $this->propertyMerger = new PropertyMerger($this);
    }

    /**
     * @codeCoverageIgnore
     */
    public static function fromFile(string $gacelaFilePath): self
    {
        if (!is_file($gacelaFilePath)) {
            throw new RuntimeException(sprintf("Invalid file path: '%s'", $gacelaFilePath));
        }

        /** @var callable(GacelaConfig):void|null $setupGacelaFileFn */
        $setupGacelaFileFn = include $gacelaFilePath;
        if (!is_callable($setupGacelaFileFn)) {
            return new self();
        }

        return self::fromCallable($setupGacelaFileFn);
    }

    /**
     * @param callable(GacelaConfig):void $setupGacelaFileFn
     */
    public static function fromCallable(callable $setupGacelaFileFn): self
    {
        $gacelaConfig = new GacelaConfig();
        $setupGacelaFileFn($gacelaConfig);

        return self::fromGacelaConfig($gacelaConfig);
    }

    public static function fromGacelaConfig(GacelaConfig $gacelaConfig): self
    {
        (new GacelaConfigExtender())->extend($gacelaConfig);

        $dto = $gacelaConfig->toTransfer();
        $setup = new self();

        return (new SetupInitializer($setup))->initializeFromTransfer($dto);
    }

    /**
     * @param array<string,class-string|object|callable> $array
     */
    public function setExternalServices(?array $array): self
    {
        $this->markPropertyAsChanged(self::externalServices, $array !== null);
        $this->properties->externalServices = $array; // No default fallback for external services

        return $this;
    }

    public function setAppConfigBuilder(AppConfigBuilder $builder): self
    {
        $this->properties->appConfigBuilder = $builder;

        return $this;
    }

    public function setSuffixTypesBuilder(SuffixTypesBuilder $builder): self
    {
        $this->properties->suffixTypesBuilder = $builder;

        return $this;
    }

    public function setBindingsBuilder(BindingsBuilder $builder): self
    {
        $this->properties->bindingsBuilder = $builder;

        return $this;
    }

    /**
     * @param callable(AppConfigBuilder):void $callable
     */
    public function setAppConfigFn(callable $callable): self
    {
        $this->properties->appConfigFn = $callable;

        return $this;
    }

    public function buildAppConfig(AppConfigBuilder $builder): AppConfigBuilder
    {
        $builder = parent::buildAppConfig($builder);

        return $this->builderExecutor->buildAppConfig($builder);
    }

    /**
     * @param callable(BindingsBuilder,array<string,mixed>):void $callable
     */
    public function setBindingsFn(callable $callable): self
    {
        $this->properties->bindingsFn = $callable;

        return $this;
    }

    /**
     * Define the mapping between interfaces and concretions, so Gacela services will auto-resolve them automatically.
     *
     * @param array<string,class-string|object|callable> $externalServices
     */
    public function buildBindings(
        BindingsBuilder $builder,
        array $externalServices,
    ): BindingsBuilder {
        $builder = parent::buildBindings($builder, $externalServices);

        return $this->builderExecutor->buildBindings($builder, $externalServices);
    }

    /**
     * @param callable(SuffixTypesBuilder):void $callable
     */
    public function setSuffixTypesFn(callable $callable): self
    {
        $this->properties->suffixTypesFn = $callable;

        return $this;
    }

    /**
     * Allow overriding gacela resolvable types.
     */
    public function buildSuffixTypes(SuffixTypesBuilder $builder): SuffixTypesBuilder
    {
        $builder = parent::buildSuffixTypes($builder);

        return $this->builderExecutor->buildSuffixTypes($builder);
    }

    /**
     * @return array<string, class-string|object|callable>
     */
    public function externalServices(): array
    {
        return array_merge(
            parent::externalServices(),
            $this->properties->externalServices ?? [],
        );
    }

    public function setShouldResetInMemoryCache(?bool $flag): self
    {
        $this->properties->shouldResetInMemoryCache = $this->setPropertyWithTracking(
            self::shouldResetInMemoryCache,
            $flag,
            self::DEFAULT_SHOULD_RESET_IN_MEMORY_CACHE,
        );

        return $this;
    }

    public function shouldResetInMemoryCache(): bool
    {
        return $this->properties->shouldResetInMemoryCache ?? self::DEFAULT_SHOULD_RESET_IN_MEMORY_CACHE;
    }

    public function isFileCacheEnabled(): bool
    {
        return $this->properties->fileCacheEnabled ?? self::DEFAULT_FILE_CACHE_ENABLED;
    }

    public function getFileCacheDirectory(): string
    {
        return $this->properties->fileCacheDirectory ?? '';
    }

    public function setFileCacheDirectory(?string $dir): self
    {
        $this->properties->fileCacheDirectory = $this->setPropertyWithTracking(
            self::fileCacheDirectory,
            $dir,
            self::DEFAULT_FILE_CACHE_DIRECTORY,
        );

        return $this;
    }

    /**
     * @param ?list<string> $list
     */
    public function setProjectNamespaces(?array $list): self
    {
        $this->properties->projectNamespaces = $this->setPropertyWithTracking(
            self::projectNamespaces,
            $list,
            self::DEFAULT_PROJECT_NAMESPACES,
        );

        return $this;
    }

    /**
     * @return list<string>
     */
    public function getProjectNamespaces(): array
    {
        return $this->properties->projectNamespaces ?? self::DEFAULT_PROJECT_NAMESPACES;
    }

    /**
     * @return array<string,mixed>
     */
    public function getConfigKeyValues(): array
    {
        return $this->properties->configKeyValues ?? self::DEFAULT_CONFIG_KEY_VALUES;
    }

    public function getEventDispatcher(): EventDispatcherInterface
    {
        return $this->properties->eventDispatcher ??= SetupEventDispatcher::getDispatcher($this);
    }

    /**
     * @return array<string,list<Closure>>
     */
    public function getServicesToExtend(): array
    {
        return $this->properties->servicesToExtend ?? self::DEFAULT_SERVICES_TO_EXTEND;
    }

    /**
     * @return array<string,Closure>
     */
    public function getFactories(): array
    {
        return $this->properties->factories ?? self::DEFAULT_FACTORIES;
    }

    /**
     * @return array<string,Closure>
     */
    public function getProtectedServices(): array
    {
        return $this->properties->protectedServices ?? self::DEFAULT_PROTECTED_SERVICES;
    }

    /**
     * @return array<string,string>
     */
    public function getAliases(): array
    {
        return $this->properties->aliases ?? self::DEFAULT_ALIASES;
    }

    /**
     * @return array<string,array<class-string,class-string|callable|object>>

     */
    public function getContextualBindings(): array
    {
        return $this->properties->contextualBindings ?? self::DEFAULT_CONTEXTUAL_BINDINGS;
    }

    public function setFileCacheEnabled(?bool $flag): self
    {
        $this->properties->fileCacheEnabled = $this->setPropertyWithTracking(
            self::fileCacheEnabled,
            $flag,
            self::DEFAULT_FILE_CACHE_ENABLED,
        );

        return $this;
    }

    public function canCreateEventDispatcher(): bool
    {
        return $this->properties->areEventListenersEnabled === true
            && $this->hasEventListeners();
    }

    /**
     * @param ?array<string,mixed> $configKeyValues
     */
    public function setConfigKeyValues(?array $configKeyValues): self
    {
        $this->properties->configKeyValues = $this->setPropertyWithTracking(
            self::configKeyValues,
            $configKeyValues,
            self::DEFAULT_CONFIG_KEY_VALUES,
        );

        return $this;
    }

    /**
     * @return array<class-string,list<callable>>|null
     */
    public function getSpecificListeners(): ?array
    {
        return $this->properties->specificListeners;
    }

    /**
     * @return list<callable>|null
     */
    public function getGenericListeners(): ?array
    {
        return $this->properties->genericListeners;
    }

    public function isPropertyChanged(string $name): bool
    {
        return $this->changeTracker->isChanged($name);
    }

    public function setEventDispatcher(EventDispatcherInterface $eventDispatcher): self
    {
        $this->properties->eventDispatcher = $eventDispatcher;

        return $this;
    }

    public function merge(self $other): self
    {
        return (new SetupMerger($this))->merge($other);
    }

    /**
     * @param list<Closure> $servicesToExtend
     */
    public function addServicesToExtend(string $serviceId, array $servicesToExtend): self
    {
        $this->properties->servicesToExtend[$serviceId] ??= [];
        $this->properties->servicesToExtend[$serviceId] = [...$this->properties->servicesToExtend[$serviceId], ...$servicesToExtend];

        return $this;
    }

    /**
     * @param array<string,class-string|object|callable> $list
     */
    public function mergeExternalServices(array $list): void
    {
        $this->propertyMerger->mergeExternalServices($list);
    }

    /**
     * @param list<string> $list
     */
    public function mergeProjectNamespaces(array $list): void
    {
        $this->propertyMerger->mergeProjectNamespaces($list);
    }

    /**
     * @param array<string,mixed> $list
     */
    public function mergeConfigKeyValues(array $list): void
    {
        $this->propertyMerger->mergeConfigKeyValues($list);
    }

    /**
     * @param list<class-string> $list
     */
    public function mergeGacelaConfigsToExtend(array $list): void
    {
        $this->propertyMerger->mergeGacelaConfigsToExtend($list);
    }

    /**
     * @param list<class-string|callable> $list
     */
    public function mergePlugins(array $list): void
    {
        $this->propertyMerger->mergePlugins($list);
    }

    /**
     * @param array<string,Closure> $list
     */
    public function mergeFactories(array $list): void
    {
        $this->propertyMerger->mergeFactories($list);
    }

    /**
     * @param array<string,Closure> $list
     */
    public function mergeProtectedServices(array $list): void
    {
        $this->propertyMerger->mergeProtectedServices($list);
    }

    /**
     * @param array<string,string> $list
     */
    public function mergeAliases(array $list): void
    {
        $this->propertyMerger->mergeAliases($list);
    }

    /**
     * @param array<string,array<class-string,class-string|callable|object>> $list

     */
    public function mergeContextualBindings(array $list): void
    {
        $this->propertyMerger->mergeContextualBindings($list);
    }

    /**
     * @return list<class-string>
     */
    public function getGacelaConfigsToExtend(): array
    {
        return $this->properties->gacelaConfigsToExtend ?? self::DEFAULT_GACELA_CONFIGS_TO_EXTEND;
    }

    /**
     * @return list<class-string|callable>
     */
    public function getPlugins(): array
    {
        return $this->properties->plugins ?? self::DEFAULT_PLUGINS;
    }

    /**
     * @internal Used by PropertyMerger - do not call directly
     *
     * @param ?list<class-string> $list
     */
    public function setGacelaConfigsToExtend(?array $list): self
    {
        $this->properties->gacelaConfigsToExtend = $this->setPropertyWithTracking(
            self::gacelaConfigsToExtend,
            $list,
            self::DEFAULT_GACELA_CONFIGS_TO_EXTEND,
        );

        return $this;
    }

    /**
     * @internal Used by PropertyMerger - do not call directly
     *
     * @param ?list<class-string|callable> $list
     */
    public function setPlugins(?array $list): self
    {
        $this->properties->plugins = $this->setPropertyWithTracking(
            self::plugins,
            $list,
            self::DEFAULT_PLUGINS,
        );

        return $this;
    }

    /**
     * @internal Used by SetupInitializer - do not call directly
     */
    public function setAreEventListenersEnabled(?bool $flag): self
    {
        $this->properties->areEventListenersEnabled = $flag ?? self::DEFAULT_ARE_EVENT_LISTENERS_ENABLED;

        return $this;
    }

    /**
     * @internal Used by SetupInitializer - do not call directly
     *
     * @param ?list<callable> $listeners
     */
    public function setGenericListeners(?array $listeners): self
    {
        $this->properties->genericListeners = $listeners ?? self::DEFAULT_GENERIC_LISTENERS;


        return $this;
    }

    /**
     * @internal Used by SetupInitializer - do not call directly
     *
     * @param ?array<string,list<Closure>> $list
     */
    public function setServicesToExtend(?array $list): self
    {
        $this->properties->servicesToExtend = $this->setPropertyWithTracking(
            self::servicesToExtend,
            $list,
            self::DEFAULT_SERVICES_TO_EXTEND,
        );

        return $this;
    }

    /**
     * @internal Used by SetupInitializer - do not call directly
     *
     * @param ?array<string,Closure> $list
     */
    public function setFactories(?array $list): self
    {
        $this->properties->factories = $this->setPropertyWithTracking(
            self::factories,
            $list,
            self::DEFAULT_FACTORIES,
        );

        return $this;
    }

    /**
     * @internal Used by SetupInitializer - do not call directly
     *
     * @param ?array<string,Closure> $list
     */
    public function setProtectedServices(?array $list): self
    {
        $this->properties->protectedServices = $this->setPropertyWithTracking(
            self::protectedServices,
            $list,
            self::DEFAULT_PROTECTED_SERVICES,
        );

        return $this;
    }

    /**
     * @internal Used by SetupInitializer - do not call directly
     *
     * @param ?array<string,string> $list
     */
    public function setAliases(?array $list): self
    {
        $this->properties->aliases = $this->setPropertyWithTracking(
            self::aliases,
            $list,
            self::DEFAULT_ALIASES,
        );

        return $this;
    }

    /**
     * @internal Used by SetupInitializer - do not call directly
     *
     * @param ?array<string,array<class-string,class-string|callable|object>> $list

     */
    public function setContextualBindings(?array $list): self
    {
        $this->properties->contextualBindings = $this->setPropertyWithTracking(
            self::contextualBindings,
            $list,
            self::DEFAULT_CONTEXTUAL_BINDINGS,
        );

        return $this;
    }

    /**
     * @internal Used by SetupInitializer - do not call directly
     *
     * @param ?array<class-string,list<callable>> $listeners
     */
    public function setSpecificListeners(?array $listeners): self
    {
        $this->properties->specificListeners = $listeners ?? self::DEFAULT_SPECIFIC_LISTENERS;

        return $this;
    }

    private function hasEventListeners(): bool
    {
        return ($this->properties->genericListeners !== null && $this->properties->genericListeners !== [])
            || ($this->properties->specificListeners !== null && $this->properties->specificListeners !== []);
    }

    /**
     * Helper method to set a property with change tracking and default value.
     *
     * @template T
     *
     * @param T $value
     * @param T $default
     *
     * @return T
     */
    private function setPropertyWithTracking(string $propertyName, mixed $value, mixed $default): mixed
    {
        $this->markPropertyAsChanged($propertyName, $value !== null);
        return $value ?? $default;
    }

    private function markPropertyAsChanged(string $name, bool $isChanged): void
    {
        if ($isChanged) {
            $this->changeTracker->markAsChanged($name);
        } else {
            $this->changeTracker->markAsUnchanged($name);
        }
    }
}


1			<?php
2
3			declare(strict_types=1);
4
5			namespace Gacela\Framework\Bootstrap;
6
7			use Closure;
8			use Gacela\Framework\Bootstrap\Setup\BuilderExecutor;
9			use Gacela\Framework\Bootstrap\Setup\GacelaConfigExtender;
10			use Gacela\Framework\Bootstrap\Setup\Properties;
11			use Gacela\Framework\Bootstrap\Setup\PropertyChangeTracker;
12			use Gacela\Framework\Bootstrap\Setup\PropertyMerger;
13			use Gacela\Framework\Bootstrap\Setup\SetupInitializer;
14			use Gacela\Framework\Bootstrap\Setup\SetupMerger;
15			use Gacela\Framework\Config\GacelaConfigBuilder\AppConfigBuilder;
16			use Gacela\Framework\Config\GacelaConfigBuilder\BindingsBuilder;
17			use Gacela\Framework\Config\GacelaConfigBuilder\SuffixTypesBuilder;
18			use Gacela\Framework\Event\Dispatcher\EventDispatcherInterface;
19			use RuntimeException;
20
21			use function is_callable;
22			use function sprintf;
23
24			/**
25			* @psalm-suppress ArgumentTypeCoercion,MixedArgumentTypeCoercion
26			*/
27			final class SetupGacela extends AbstractSetupGacela
28			{
29			private readonly Properties $properties;
30
31			private readonly PropertyChangeTracker $changeTracker;
32
33			private readonly BuilderExecutor $builderExecutor;
34
35			private readonly PropertyMerger $propertyMerger;
36
37			public function __construct()
38			{
39			$this->properties = new Properties();
40			$this->changeTracker = new PropertyChangeTracker();
41			$this->builderExecutor = new BuilderExecutor($this->properties);
42			$this->propertyMerger = new PropertyMerger($this);
43			}
44
45			/**
46			* @codeCoverageIgnore
47			*/
48			public static function fromFile(string $gacelaFilePath): self
49			{
50			if (!is_file($gacelaFilePath)) {
51			throw new RuntimeException(sprintf("Invalid file path: '%s'", $gacelaFilePath));
52			}
53
54			/** @var callable(GacelaConfig):void\|null $setupGacelaFileFn */
55			$setupGacelaFileFn = include $gacelaFilePath;
56			if (!is_callable($setupGacelaFileFn)) {
57			return new self();
58			}
59
60			return self::fromCallable($setupGacelaFileFn);
61			}
62
63			/**
64			* @param callable(GacelaConfig):void $setupGacelaFileFn
65			*/
66			public static function fromCallable(callable $setupGacelaFileFn): self
67			{
68			$gacelaConfig = new GacelaConfig();
69			$setupGacelaFileFn($gacelaConfig);
70
71			return self::fromGacelaConfig($gacelaConfig);
72			}
73
74			public static function fromGacelaConfig(GacelaConfig $gacelaConfig): self
75			{
76			(new GacelaConfigExtender())->extend($gacelaConfig);
77
78			$dto = $gacelaConfig->toTransfer();
79			$setup = new self();
80
81			return (new SetupInitializer($setup))->initializeFromTransfer($dto);
82			}
83
84			/**
85			* @param array<string,class-string\|object\|callable> $array
86			*/
87			public function setExternalServices(?array $array): self
88			{
89			$this->markPropertyAsChanged(self::externalServices, $array !== null);
90			$this->properties->externalServices = $array; // No default fallback for external services
91
92			return $this;
93			}
94
95			public function setAppConfigBuilder(AppConfigBuilder $builder): self
96			{
97			$this->properties->appConfigBuilder = $builder;
98
99			return $this;
100			}
101
102			public function setSuffixTypesBuilder(SuffixTypesBuilder $builder): self
103			{
104			$this->properties->suffixTypesBuilder = $builder;
105
106			return $this;
107			}
108
109			public function setBindingsBuilder(BindingsBuilder $builder): self
110			{
111			$this->properties->bindingsBuilder = $builder;
112
113			return $this;
114			}
115
116			/**
117			* @param callable(AppConfigBuilder):void $callable
118			*/
119			public function setAppConfigFn(callable $callable): self
120			{
121			$this->properties->appConfigFn = $callable;
122
123			return $this;
124			}
125
126			public function buildAppConfig(AppConfigBuilder $builder): AppConfigBuilder
127			{
128			$builder = parent::buildAppConfig($builder);
129
130			return $this->builderExecutor->buildAppConfig($builder);
131			}
132
133			/**
134			* @param callable(BindingsBuilder,array<string,mixed>):void $callable
135			*/
136			public function setBindingsFn(callable $callable): self
137			{
138			$this->properties->bindingsFn = $callable;
139
140			return $this;
141			}
142
143			/**
144			* Define the mapping between interfaces and concretions, so Gacela services will auto-resolve them automatically.
145			*
146			* @param array<string,class-string\|object\|callable> $externalServices
147			*/
148			public function buildBindings(
149			BindingsBuilder $builder,
150			array $externalServices,
151			): BindingsBuilder {
152			$builder = parent::buildBindings($builder, $externalServices);
153
154			return $this->builderExecutor->buildBindings($builder, $externalServices);
155			}
156
157			/**
158			* @param callable(SuffixTypesBuilder):void $callable
159			*/
160			public function setSuffixTypesFn(callable $callable): self
161			{
162			$this->properties->suffixTypesFn = $callable;
163
164			return $this;
165			}
166
167			/**
168			* Allow overriding gacela resolvable types.
169			*/
170			public function buildSuffixTypes(SuffixTypesBuilder $builder): SuffixTypesBuilder
171			{
172			$builder = parent::buildSuffixTypes($builder);
173
174			return $this->builderExecutor->buildSuffixTypes($builder);
175			}
176
177			/**
178			* @return array<string, class-string\|object\|callable>
179			*/
180			public function externalServices(): array
181			{
182			return array_merge(
183			parent::externalServices(),
184			$this->properties->externalServices ?? [],
185			);
186			}
187
188			public function setShouldResetInMemoryCache(?bool $flag): self
189			{
190			$this->properties->shouldResetInMemoryCache = $this->setPropertyWithTracking(
191			self::shouldResetInMemoryCache,
192			$flag,
193			self::DEFAULT_SHOULD_RESET_IN_MEMORY_CACHE,
194			);
195
196			return $this;
197			}
198
199			public function shouldResetInMemoryCache(): bool
200			{
201			return $this->properties->shouldResetInMemoryCache ?? self::DEFAULT_SHOULD_RESET_IN_MEMORY_CACHE;
202			}
203
204			public function isFileCacheEnabled(): bool
205			{
206			return $this->properties->fileCacheEnabled ?? self::DEFAULT_FILE_CACHE_ENABLED;
207			}
208
209			public function getFileCacheDirectory(): string
210			{
211			return $this->properties->fileCacheDirectory ?? '';
212			}
213
214			public function setFileCacheDirectory(?string $dir): self
215			{
216			$this->properties->fileCacheDirectory = $this->setPropertyWithTracking(
217			self::fileCacheDirectory,
218			$dir,
219			self::DEFAULT_FILE_CACHE_DIRECTORY,
220			);
221
222			return $this;
223			}
224
225			/**
226			* @param ?list<string> $list
227			*/
228			public function setProjectNamespaces(?array $list): self
229			{
230			$this->properties->projectNamespaces = $this->setPropertyWithTracking(
231			self::projectNamespaces,
232			$list,
233			self::DEFAULT_PROJECT_NAMESPACES,
234			);
235
236			return $this;
237			}
238
239			/**
240			* @return list<string>
241			*/
242			public function getProjectNamespaces(): array
243			{
244			return $this->properties->projectNamespaces ?? self::DEFAULT_PROJECT_NAMESPACES;
245			}
246
247			/**
248			* @return array<string,mixed>
249			*/
250			public function getConfigKeyValues(): array
251			{
252			return $this->properties->configKeyValues ?? self::DEFAULT_CONFIG_KEY_VALUES;
253			}
254
255			public function getEventDispatcher(): EventDispatcherInterface
256			{
257			return $this->properties->eventDispatcher ??= SetupEventDispatcher::getDispatcher($this);
258			}
259
260			/**
261			* @return array<string,list<Closure>>
262			*/
263			public function getServicesToExtend(): array
264			{
265			return $this->properties->servicesToExtend ?? self::DEFAULT_SERVICES_TO_EXTEND;
266			}
267
268			/**
269			* @return array<string,Closure>
270			*/
271			public function getFactories(): array
272			{
273			return $this->properties->factories ?? self::DEFAULT_FACTORIES;
274			}
275
276			/**
277			* @return array<string,Closure>
278			*/
279			public function getProtectedServices(): array
280			{
281			return $this->properties->protectedServices ?? self::DEFAULT_PROTECTED_SERVICES;
282			}
283
284			/**
285			* @return array<string,string>
286			*/
287			public function getAliases(): array
288			{
289			return $this->properties->aliases ?? self::DEFAULT_ALIASES;
290			}
291
292			/**
293			* @return array<string,array<class-string,class-string\|callable\|object>>
			0 ignored issues – show Documentation Bug introduced 2025-11-10 22:05 UTC by Report Bug Copy Issue Report The doc comment `array<string,array<class...tring\|callable\|object>>` at position `6` could not be parsed: Unknown type name 'class-string' at position 6 in array<string,array<class-string,class-string\|callable\|object>>. Loading history...
294			*/
295			public function getContextualBindings(): array
296			{
297			return $this->properties->contextualBindings ?? self::DEFAULT_CONTEXTUAL_BINDINGS;
298			}
299
300			public function setFileCacheEnabled(?bool $flag): self
301			{
302			$this->properties->fileCacheEnabled = $this->setPropertyWithTracking(
303			self::fileCacheEnabled,
304			$flag,
305			self::DEFAULT_FILE_CACHE_ENABLED,
306			);
307
308			return $this;
309			}
310
311			public function canCreateEventDispatcher(): bool
312			{
313			return $this->properties->areEventListenersEnabled === true
314			&& $this->hasEventListeners();
315			}
316
317			/**
318			* @param ?array<string,mixed> $configKeyValues
319			*/
320			public function setConfigKeyValues(?array $configKeyValues): self
321			{
322			$this->properties->configKeyValues = $this->setPropertyWithTracking(
323			self::configKeyValues,
324			$configKeyValues,
325			self::DEFAULT_CONFIG_KEY_VALUES,
326			);
327
328			return $this;
329			}
330
331			/**
332			* @return array<class-string,list<callable>>\|null
333			*/
334			public function getSpecificListeners(): ?array
335			{
336			return $this->properties->specificListeners;
337			}
338
339			/**
340			* @return list<callable>\|null
341			*/
342			public function getGenericListeners(): ?array
343			{
344			return $this->properties->genericListeners;
345			}
346
347			public function isPropertyChanged(string $name): bool
348			{
349			return $this->changeTracker->isChanged($name);
350			}
351
352			public function setEventDispatcher(EventDispatcherInterface $eventDispatcher): self
353			{
354			$this->properties->eventDispatcher = $eventDispatcher;
355
356			return $this;
357			}
358
359			public function merge(self $other): self
360			{
361			return (new SetupMerger($this))->merge($other);
362			}
363
364			/**
365			* @param list<Closure> $servicesToExtend
366			*/
367			public function addServicesToExtend(string $serviceId, array $servicesToExtend): self
368			{
369			$this->properties->servicesToExtend[$serviceId] ??= [];
370			$this->properties->servicesToExtend[$serviceId] = [...$this->properties->servicesToExtend[$serviceId], ...$servicesToExtend];
371
372			return $this;
373			}
374
375			/**
376			* @param array<string,class-string\|object\|callable> $list
377			*/
378			public function mergeExternalServices(array $list): void
379			{
380			$this->propertyMerger->mergeExternalServices($list);
381			}
382
383			/**
384			* @param list<string> $list
385			*/
386			public function mergeProjectNamespaces(array $list): void
387			{
388			$this->propertyMerger->mergeProjectNamespaces($list);
389			}
390
391			/**
392			* @param array<string,mixed> $list
393			*/
394			public function mergeConfigKeyValues(array $list): void
395			{
396			$this->propertyMerger->mergeConfigKeyValues($list);
397			}
398
399			/**
400			* @param list<class-string> $list
401			*/
402			public function mergeGacelaConfigsToExtend(array $list): void
403			{
404			$this->propertyMerger->mergeGacelaConfigsToExtend($list);
405			}
406
407			/**
408			* @param list<class-string\|callable> $list
409			*/
410			public function mergePlugins(array $list): void
411			{
412			$this->propertyMerger->mergePlugins($list);
413			}
414
415			/**
416			* @param array<string,Closure> $list
417			*/
418			public function mergeFactories(array $list): void
419			{
420			$this->propertyMerger->mergeFactories($list);
421			}
422
423			/**
424			* @param array<string,Closure> $list
425			*/
426			public function mergeProtectedServices(array $list): void
427			{
428			$this->propertyMerger->mergeProtectedServices($list);
429			}
430
431			/**
432			* @param array<string,string> $list
433			*/
434			public function mergeAliases(array $list): void
435			{
436			$this->propertyMerger->mergeAliases($list);
437			}
438
439			/**
440			* @param array<string,array<class-string,class-string\|callable\|object>> $list
			0 ignored issues – show Documentation Bug introduced 2025-11-10 22:05 UTC by Report Bug Copy Issue Report The doc comment `array<string,array<class...tring\|callable\|object>>` at position `6` could not be parsed: Unknown type name 'class-string' at position 6 in array<string,array<class-string,class-string\|callable\|object>>. Loading history...
441			*/
442			public function mergeContextualBindings(array $list): void
443			{
444			$this->propertyMerger->mergeContextualBindings($list);
445			}
446
447			/**
448			* @return list<class-string>
449			*/
450			public function getGacelaConfigsToExtend(): array
451			{
452			return $this->properties->gacelaConfigsToExtend ?? self::DEFAULT_GACELA_CONFIGS_TO_EXTEND;
453			}
454
455			/**
456			* @return list<class-string\|callable>
457			*/
458			public function getPlugins(): array
459			{
460			return $this->properties->plugins ?? self::DEFAULT_PLUGINS;
461			}
462
463			/**
464			* @internal Used by PropertyMerger - do not call directly
465			*
466			* @param ?list<class-string> $list
467			*/
468			public function setGacelaConfigsToExtend(?array $list): self
469			{
470			$this->properties->gacelaConfigsToExtend = $this->setPropertyWithTracking(
471			self::gacelaConfigsToExtend,
472			$list,
473			self::DEFAULT_GACELA_CONFIGS_TO_EXTEND,
474			);
475
476			return $this;
477			}
478
479			/**
480			* @internal Used by PropertyMerger - do not call directly
481			*
482			* @param ?list<class-string\|callable> $list
483			*/
484			public function setPlugins(?array $list): self
485			{
486			$this->properties->plugins = $this->setPropertyWithTracking(
487			self::plugins,
488			$list,
489			self::DEFAULT_PLUGINS,
490			);
491
492			return $this;
493			}
494
495			/**
496			* @internal Used by SetupInitializer - do not call directly
497			*/
498			public function setAreEventListenersEnabled(?bool $flag): self
499			{
500			$this->properties->areEventListenersEnabled = $flag ?? self::DEFAULT_ARE_EVENT_LISTENERS_ENABLED;
501
502			return $this;
503			}
504
505			/**
506			* @internal Used by SetupInitializer - do not call directly
507			*
508			* @param ?list<callable> $listeners
509			*/
510			public function setGenericListeners(?array $listeners): self
511			{
512			$this->properties->genericListeners = $listeners ?? self::DEFAULT_GENERIC_LISTENERS;
			0 ignored issues – show Documentation Bug introduced 2025-10-11 23:40 UTC by Report Bug Copy Issue Report It seems like `$listeners ?? self::DEFAULT_GENERIC_LISTENERS` of type `array` is incompatible with the declared type `Gacela\Framework\Bootstrap\Setup\list\|null` of property `$genericListeners`. Our type inference engine has found an assignment to a property that is incompatible with the declared type of that property. Either this assignment is in error or the assigned type should be added to the documentation/type hint for that property.. Loading history...
513
514			return $this;
515			}
516
517			/**
518			* @internal Used by SetupInitializer - do not call directly
519			*
520			* @param ?array<string,list<Closure>> $list
521			*/
522			public function setServicesToExtend(?array $list): self
523			{
524			$this->properties->servicesToExtend = $this->setPropertyWithTracking(
525			self::servicesToExtend,
526			$list,
527			self::DEFAULT_SERVICES_TO_EXTEND,
528			);
529
530			return $this;
531			}
532
533			/**
534			* @internal Used by SetupInitializer - do not call directly
535			*
536			* @param ?array<string,Closure> $list
537			*/
538			public function setFactories(?array $list): self
539			{
540			$this->properties->factories = $this->setPropertyWithTracking(
541			self::factories,
542			$list,
543			self::DEFAULT_FACTORIES,
544			);
545
546			return $this;
547			}
548
549			/**
550			* @internal Used by SetupInitializer - do not call directly
551			*
552			* @param ?array<string,Closure> $list
553			*/
554			public function setProtectedServices(?array $list): self
555			{
556			$this->properties->protectedServices = $this->setPropertyWithTracking(
557			self::protectedServices,
558			$list,
559			self::DEFAULT_PROTECTED_SERVICES,
560			);
561
562			return $this;
563			}
564
565			/**
566			* @internal Used by SetupInitializer - do not call directly
567			*
568			* @param ?array<string,string> $list
569			*/
570			public function setAliases(?array $list): self
571			{
572			$this->properties->aliases = $this->setPropertyWithTracking(
573			self::aliases,
574			$list,
575			self::DEFAULT_ALIASES,
576			);
577
578			return $this;
579			}
580
581			/**
582			* @internal Used by SetupInitializer - do not call directly
583			*
584			* @param ?array<string,array<class-string,class-string\|callable\|object>> $list
			0 ignored issues – show Documentation Bug introduced 2025-11-10 22:05 UTC by Report Bug Copy Issue Report The doc comment `?array<string,array<clas...tring\|callable\|object>>` at position `6` could not be parsed: Unknown type name 'class-string' at position 6 in ?array<string,array<class-string,class-string\|callable\|object>>. Loading history...
585			*/
586			public function setContextualBindings(?array $list): self
587			{
588			$this->properties->contextualBindings = $this->setPropertyWithTracking(
589			self::contextualBindings,
590			$list,
591			self::DEFAULT_CONTEXTUAL_BINDINGS,
592			);
593
594			return $this;
595			}
596
597			/**
598			* @internal Used by SetupInitializer - do not call directly
599			*
600			* @param ?array<class-string,list<callable>> $listeners
601			*/
602			public function setSpecificListeners(?array $listeners): self
603			{
604			$this->properties->specificListeners = $listeners ?? self::DEFAULT_SPECIFIC_LISTENERS;
605
606			return $this;
607			}
608
609			private function hasEventListeners(): bool
610			{
611			return ($this->properties->genericListeners !== null && $this->properties->genericListeners !== [])
612			\|\| ($this->properties->specificListeners !== null && $this->properties->specificListeners !== []);
613			}
614
615			/**
616			* Helper method to set a property with change tracking and default value.
617			*
618			* @template T
619			*
620			* @param T $value
621			* @param T $default
622			*
623			* @return T
624			*/
625			private function setPropertyWithTracking(string $propertyName, mixed $value, mixed $default): mixed
626			{
627			$this->markPropertyAsChanged($propertyName, $value !== null);
628			return $value ?? $default;
629			}
630
631			private function markPropertyAsChanged(string $name, bool $isChanged): void
632			{
633			if ($isChanged) {
634			$this->changeTracker->markAsChanged($name);
635			} else {
636			$this->changeTracker->markAsUnchanged($name);
637			}
638			}
639			}
640

gacela-project / gacela

SetupGacela::mergeFactories() A last analyzed 2025-11-11 07:05 UTC

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like

SetupGacela::mergeFactories() A
last analyzed 2025-11-11 07:05 UTC