Configuration::getNamerFactory() - Code Metrics - Inspection of "make services public" - kbond/ZenstruckBackupBundle - Measure and Improve Code Quality continuously with Scrutinizer

Completed

Push — compat-sf4 ( 58eeac...2dc342 )

by Kevin

created 2019-12-27 14:02 UTC

Configuration::getNamerFactory() A

↳ Parent: Configuration

Complexity

Conditions	1
Paths	1

Size

Total Lines

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	2
CRAP Score	1

Importance

Changes

Metric	Value
dl	0
loc	4
ccs	2
cts	2
cp	1
rs	10
c	0
b	0
f	0
cc	1
nc	1
nop	1
crap	1

<?php

namespace Zenstruck\BackupBundle\DependencyInjection;

use Symfony\Component\Config\Definition\Builder\ArrayNodeDefinition;
use Symfony\Component\Config\Definition\Builder\TreeBuilder;
use Symfony\Component\Config\Definition\ConfigurationInterface;
use Zenstruck\BackupBundle\DependencyInjection\Factory\Factory;

/**
 * @author Kevin Bond <[email protected]>
 */
class Configuration implements ConfigurationInterface
{
    private $namerFactories;
    private $processorFactories;
    private $sourceFactories;
    private $destinationFactories;

    /**
     * @param Factory[] $namerFactories
     * @param Factory[] $processorFactories
     * @param Factory[] $sourceFactories
     * @param Factory[] $destinationFactories
     */
    public function __construct(array $namerFactories, array $processorFactories, array $sourceFactories, array $destinationFactories)
    {
        $this->namerFactories = $namerFactories;
        $this->processorFactories = $processorFactories;
        $this->sourceFactories = $sourceFactories;
        $this->destinationFactories = $destinationFactories;
    }

    public function getConfigTreeBuilder()
    {
        $treeBuilder = new TreeBuilder('zenstruck_backup');

        // Keep compatibility with symfony/config < 4.2
        if (\method_exists($treeBuilder, 'getRootNode')) {
            $rootNode = $treeBuilder->getRootNode();
        } else {
            $rootNode = $treeBuilder->root('zenstruck_backup');

        }

        $this->addFactories($rootNode, 'namers', 'namer', $this->namerFactories);

        $this->addFactories($rootNode, 'processors', 'processor', $this->processorFactories);

        $this->addFactories($rootNode, 'sources', 'source', $this->sourceFactories);

        $this->addFactories($rootNode, 'destinations', 'destination', $this->destinationFactories);


        $rootNode
            ->children()
                ->arrayNode('profiles')
                    ->useAttributeAsKey('name')
                    ->prototype('array')
                        ->children()
                            ->scalarNode('scratch_dir')->defaultValue('%kernel.cache_dir%/backup')->end()
                            ->arrayNode('sources')
                                ->isRequired()
                                ->requiresAtLeastOneElement()
                                ->prototype('scalar')->end()
                                ->beforeNormalization()
                                    ->ifString()
                                    ->then(function ($v) {
                                        return array($v);
                                    })
                                ->end()
                            ->end()
                            ->scalarNode('namer')->isRequired()->end()
                            ->scalarNode('processor')->isRequired()->end()
                            ->arrayNode('destinations')
                                ->isRequired()
                                ->requiresAtLeastOneElement()
                                ->prototype('scalar')->end()
                                ->beforeNormalization()
                                    ->ifString()
                                    ->then(function ($v) {
                                        return array($v);
                                    })
                                ->end()
                            ->end()
                        ->end()
                    ->end()
                ->end()
            ->end()
        ;

        return $treeBuilder;
    }

    /**
     * @param string $id
     *
     * @return Factory
     */
    public function getSourceFactory($id)
    {
        return $this->sourceFactories[$id];
    }

    /**
     * @param string $id
     *
     * @return Factory
     */
    public function getNamerFactory($id)
    {
        return $this->namerFactories[$id];
    }

    /**
     * @param string $id
     *
     * @return Factory
     */
    public function getDestinationFactory($id)
    {
        return $this->destinationFactories[$id];
    }

    /**
     * @param string $id
     *
     * @return Factory
     */
    public function getProcessorFactory($id)
    {
        return $this->processorFactories[$id];
    }

    /**
     * @param ArrayNodeDefinition $node
     * @param string              $plural
     * @param string              $singular
     * @param Factory[]           $factories
     */
    private function addFactories(ArrayNodeDefinition $node, $plural, $singular, array $factories)
    {
        $nodeBuilder = $node
abstract class User
{
    /** @return string */
    abstract public function getPassword();
}

class MyUser extends User
{
    public function getPassword()
    {
        // return something
    }

    public function getDisplayName()
    {
        // return some name.
    }
}

class AuthSystem
{
    public function authenticate(User $user)
    {
        $this->logger->info(sprintf('Authenticating %s.', $user->getDisplayName()));
        // do something.
    }
}
            ->children()
                ->arrayNode($plural)
                    ->useAttributeAsKey('name')
                    ->prototype('array')
                        ->canBeUnset()
                        ->validate()
                            ->ifTrue(function ($v) {
                                return count($v) > 1;
                            })
                            ->thenInvalid(sprintf('Can only have 1 %s per configuration.', $singular))
                        ->end()
                        ->children()
        ;

        foreach ($factories as $name => $factory) {
            $factoryNode = $nodeBuilder->arrayNode($name);

            $factory->addConfiguration($factoryNode);
        }
    }
}


1		<?php
2
3		namespace Zenstruck\BackupBundle\DependencyInjection;
4
5		use Symfony\Component\Config\Definition\Builder\ArrayNodeDefinition;
6		use Symfony\Component\Config\Definition\Builder\TreeBuilder;
7		use Symfony\Component\Config\Definition\ConfigurationInterface;
8		use Zenstruck\BackupBundle\DependencyInjection\Factory\Factory;
9
10		/**
11		* @author Kevin Bond <[email protected]>
12		*/
13		class Configuration implements ConfigurationInterface
14		{
15		private $namerFactories;
16		private $processorFactories;
17		private $sourceFactories;
18		private $destinationFactories;
19
20		/**
21		* @param Factory[] $namerFactories
22		* @param Factory[] $processorFactories
23		* @param Factory[] $sourceFactories
24		* @param Factory[] $destinationFactories
25		*/
26	5	public function __construct(array $namerFactories, array $processorFactories, array $sourceFactories, array $destinationFactories)
27		{
28	5	$this->namerFactories = $namerFactories;
29	5	$this->processorFactories = $processorFactories;
30	5	$this->sourceFactories = $sourceFactories;
31	5	$this->destinationFactories = $destinationFactories;
32	5	}
33
34	5	public function getConfigTreeBuilder()
35		{
36	5	$treeBuilder = new TreeBuilder('zenstruck_backup');
37
38		// Keep compatibility with symfony/config < 4.2
39	5	if (\method_exists($treeBuilder, 'getRootNode')) {
40		$rootNode = $treeBuilder->getRootNode();
41		} else {
42	5	$rootNode = $treeBuilder->root('zenstruck_backup');
		0 ignored issues – show Deprecated Code introduced 2019-07-30 20:24 UTC by Report Bug Copy Issue Report The method `Symfony\Component\Config...der\TreeBuilder::root()` has been deprecated with message: since Symfony 4.3, pass the root name to the constructor instead This method has been deprecated. The supplier of the class has supplied an explanatory message. The explanatory message should give you some clue as to whether and when the method will be removed from the class and what other method or class to use instead. Loading history...
43		}
44
45	5	$this->addFactories($rootNode, 'namers', 'namer', $this->namerFactories);
		0 ignored issues – show Compatibility introduced 2019-11-27 21:20 UTC by Report Bug Copy Issue Report `$rootNode` of type `object<Symfony\Component...Builder\NodeDefinition>` is not a sub-type of `object<Symfony\Component...er\ArrayNodeDefinition>`. It seems like you assume a child class of the class `Symfony\Component\Config...\Builder\NodeDefinition` to be always present. This check looks for parameters that are defined as one type in their type hint or doc comment but seem to be used as a narrower type, i.e an implementation of an interface or a subclass. Consider changing the type of the parameter or doing an instanceof check before assuming your parameter is of the expected type. Loading history...
46	5	$this->addFactories($rootNode, 'processors', 'processor', $this->processorFactories);
		0 ignored issues – show Compatibility introduced 2019-11-27 21:20 UTC by Report Bug Copy Issue Report `$rootNode` of type `object<Symfony\Component...Builder\NodeDefinition>` is not a sub-type of `object<Symfony\Component...er\ArrayNodeDefinition>`. It seems like you assume a child class of the class `Symfony\Component\Config...\Builder\NodeDefinition` to be always present. This check looks for parameters that are defined as one type in their type hint or doc comment but seem to be used as a narrower type, i.e an implementation of an interface or a subclass. Consider changing the type of the parameter or doing an instanceof check before assuming your parameter is of the expected type. Loading history...
47	5	$this->addFactories($rootNode, 'sources', 'source', $this->sourceFactories);
		0 ignored issues – show Compatibility introduced 2019-11-27 21:20 UTC by Report Bug Copy Issue Report `$rootNode` of type `object<Symfony\Component...Builder\NodeDefinition>` is not a sub-type of `object<Symfony\Component...er\ArrayNodeDefinition>`. It seems like you assume a child class of the class `Symfony\Component\Config...\Builder\NodeDefinition` to be always present. This check looks for parameters that are defined as one type in their type hint or doc comment but seem to be used as a narrower type, i.e an implementation of an interface or a subclass. Consider changing the type of the parameter or doing an instanceof check before assuming your parameter is of the expected type. Loading history...
48	5	$this->addFactories($rootNode, 'destinations', 'destination', $this->destinationFactories);
		0 ignored issues – show Compatibility introduced 2019-11-27 21:20 UTC by Report Bug Copy Issue Report `$rootNode` of type `object<Symfony\Component...Builder\NodeDefinition>` is not a sub-type of `object<Symfony\Component...er\ArrayNodeDefinition>`. It seems like you assume a child class of the class `Symfony\Component\Config...\Builder\NodeDefinition` to be always present. This check looks for parameters that are defined as one type in their type hint or doc comment but seem to be used as a narrower type, i.e an implementation of an interface or a subclass. Consider changing the type of the parameter or doing an instanceof check before assuming your parameter is of the expected type. Loading history...
49
50		$rootNode
51	5	->children()
52	5	->arrayNode('profiles')
53	5	->useAttributeAsKey('name')
54	5	->prototype('array')
55	5	->children()
56	5	->scalarNode('scratch_dir')->defaultValue('%kernel.cache_dir%/backup')->end()
57	5	->arrayNode('sources')
58	5	->isRequired()
59	5	->requiresAtLeastOneElement()
60	5	->prototype('scalar')->end()
61	5	->beforeNormalization()
62	5	->ifString()
63	5	->then(function ($v) {
64	1	return array($v);
65	5	})
66	5	->end()
67	5	->end()
68	5	->scalarNode('namer')->isRequired()->end()
69	5	->scalarNode('processor')->isRequired()->end()
70	5	->arrayNode('destinations')
71	5	->isRequired()
72	5	->requiresAtLeastOneElement()
73	5	->prototype('scalar')->end()
74	5	->beforeNormalization()
75	5	->ifString()
76	5	->then(function ($v) {
77	3	return array($v);
78	5	})
79	5	->end()
80	5	->end()
81	5	->end()
82	5	->end()
83	5	->end()
84	5	->end()
85		;
86
87	5	return $treeBuilder;
88		}
89
90		/**
91		* @param string $id
92		*
93		* @return Factory
94		*/
95	1	public function getSourceFactory($id)
96		{
97	1	return $this->sourceFactories[$id];
98		}
99
100		/**
101		* @param string $id
102		*
103		* @return Factory
104		*/
105	1	public function getNamerFactory($id)
106		{
107	1	return $this->namerFactories[$id];
108		}
109
110		/**
111		* @param string $id
112		*
113		* @return Factory
114		*/
115	1	public function getDestinationFactory($id)
116		{
117	1	return $this->destinationFactories[$id];
118		}
119
120		/**
121		* @param string $id
122		*
123		* @return Factory
124		*/
125	1	public function getProcessorFactory($id)
126		{
127	1	return $this->processorFactories[$id];
128		}
129
130		/**
131		* @param ArrayNodeDefinition $node
132		* @param string $plural
133		* @param string $singular
134		* @param Factory[] $factories
135		*/
136	5	private function addFactories(ArrayNodeDefinition $node, $plural, $singular, array $factories)
137		{
138		$nodeBuilder = $node
		0 ignored issues – show Bug introduced 2019-11-27 21:20 UTC by Report Bug Copy Issue Report It seems like you code against a specific sub-type and not the parent class `Symfony\Component\Config...\Builder\NodeDefinition` as the method `canBeUnset()` does only exist in the following sub-classes of `Symfony\Component\Config...\Builder\NodeDefinition`: `Symfony\Component\Config...der\ArrayNodeDefinition`. Maybe you want to `instanceof` check for one of these explicitly? Let’s take a look at an example: abstract class User { /** @return string / abstract public function getPassword(); } class MyUser extends User { public function getPassword() { // return something } public function getDisplayName() { // return some name. } } class AuthSystem { public function authenticate(User $user) { $this->logger->info(sprintf('Authenticating %s.', $user->getDisplayName())); // do something. } } In the above example, the authenticate() method works fine as long as you just pass instances of MyUser. However, if you now also want to pass a different sub-classes of User which does not have a getDisplayName() method, the code will break. Available Fixes Change the type-hint for the parameter: class AuthSystem { public function authenticate(MyUser $user) { / ... / } } Add an additional type-check: class AuthSystem { public function authenticate(User $user) { if ($user instanceof MyUser) { $this->logger->info(/* ... /); } // or alternatively if ( ! $user instanceof MyUser) { throw new \LogicException( '$user must be an instance of MyUser, ' .'other instances are not supported.' ); } } } Note:* PHP Analyzer uses reverse abstract interpretation to narrow down the types inside the if block in such a case. Add the method to the parent class: abstract class User { /** @return string / abstract public function getPassword(); /* @return string */ abstract public function getDisplayName(); } Loading history...
139	5	->children()
140	5	->arrayNode($plural)
141	5	->useAttributeAsKey('name')
142	5	->prototype('array')
143	5	->canBeUnset()
144	5	->validate()
145	5	->ifTrue(function ($v) {
146	1	return count($v) > 1;
147	5	})
148		->thenInvalid(sprintf('Can only have 1 %s per configuration.', $singular))
149		->end()
150		->children()
151		;
152
153		foreach ($factories as $name => $factory) {
154		$factoryNode = $nodeBuilder->arrayNode($name);
155
156		$factory->addConfiguration($factoryNode);
157		}
158		}
159		}
160

kbond / ZenstruckBackupBundle

Push — compat-sf4 ( 58eeac...2dc342 )

Configuration::getNamerFactory() A

Complexity

Size

Duplication

Code Coverage

Importance

Available Fixes

Duplication Side-by-Side

Filter issues like