ModuleCollection::add() - Code Metrics - Inspection of "Merge pull request #50 from webmozart/rename-packa..." - puli/manager - Measure and Improve Code Quality continuously with Scrutinizer

Failed Conditions

Push — master ( d49c03...6343d0 )

by Bernhard

created 2016-01-28 11:08 UTC

ModuleCollection::add() A

↳ Parent: ModuleCollection

Complexity

Conditions	2
Paths	2

Size

Total Lines	8
Code Lines	4

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	5
CRAP Score	2

Importance

Changes	1
Bugs	0	Features	0

Metric	Value
c	1
b	0
f	0
dl	0
loc	8
ccs	5
cts	5
cp	1
rs	9.4285
cc	2
eloc	4
nc	2
nop	1
crap	2

<?php

/*
 * This file is part of the puli/manager package.
 *
 * (c) Bernhard Schussek <[email protected]>
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

namespace Puli\Manager\Api\Module;

use ArrayAccess;
use ArrayIterator;
use Countable;
use IteratorAggregate;

/**
 * A collection of Puli modules.
 *
 * @since  1.0
 *
 * @author Bernhard Schussek <[email protected]>
 */
class ModuleCollection implements IteratorAggregate, Countable, ArrayAccess
{
    /**
     * @var RootModule
     */
    private $rootModule;

    /**
     * @var Module[]
     */
    private $modules = array();

    public function __construct(array $modules = array())
    {
        $this->merge($modules);
    }

    /**
     * Adds a module to the collection.
     *
     * @param Module $module The added module.
     */
    public function add(Module $module)
    {
        $this->modules[$module->getName()] = $module;

        if ($module instanceof RootModule) {
            $this->rootModule = $module;
        }
    }

    /**
     * Adds multiple modules to the collection.
     *
     * @param Module[] $modules The added modules.
     */
    public function merge(array $modules)
    {
        foreach ($modules as $module) {
            $this->add($module);
        }
    }

    /**
     * Replaces the collection with the given modules.
     *
     * @param Module[] $modules The modules to set.
     */
    public function replace(array $modules)
    {
        $this->clear();
        $this->merge($modules);
    }

    /**
     * Removes a module from the collection.
     *
     * @param string $name The module name.
     */
    public function remove($name)
    {
        if ($this->rootModule && $name === $this->rootModule->getName()) {
            $this->rootModule = null;
        }

        unset($this->modules[$name]);
    }

    /**
     * Removes all modules from the collection.
     */
    public function clear()
    {
        if ($this->rootModule) {
            $this->rootModule = null;
        }

        $this->modules = array();
    }

    /**
     * Returns the module with the given name.
     *
     * @param string $name The module name.
     *
     * @return Module The module with the passed name.
     *
     * @throws NoSuchModuleException If the module was not found.
     */
    public function get($name)
    {
        if (!isset($this->modules[$name])) {
            throw new NoSuchModuleException(sprintf(
                'The module "%s" was not found.',
                $name
            ));
        }

        return $this->modules[$name];
    }

    /**
     * Returns whether a module with the given name exists.
     *
     * @param string $name The module name.
     *
     * @return bool Whether a module with this name exists.
     */
    public function contains($name)
    {
        return isset($this->modules[$name]);
    }

    /**
     * Returns the root module.
     *
     * If the collection contains no root module, `null` is returned.
     *
     * @return RootModule|null The root module or `null` if none exists.

     */
    public function getRootModule()
    {
        return $this->rootModule;
    }

    /**
     * Returns the name of the root module.
     *
     * If the collection contains no root module, `null` is returned.
     *
     * @return string|null The root module name or `null` if none exists.
     */
    public function getRootModuleName()
    {
        return $this->rootModule ? $this->rootModule->getName() : null;
    }

    /**
     * Returns all installed modules.
     *
     * The installed modules are all modules that are not the root module.
     *
     * @return Module[] The installed modules indexed by their names.
     */
    public function getInstalledModules()
    {
        $modules = $this->modules;

        if ($this->rootModule) {
            unset($modules[$this->rootModule->getName()]);
        }

        return $modules;
    }

    /**
     * Returns the names of all installed modules.
     *
     * The installed modules are all modules that are not the root module.
     *
     * @return string[] The names of the installed modules.

     */
    public function getInstalledModuleNames()
    {
        return array_keys($this->getInstalledModules());
    }

    /**
     * Returns the names of all modules.
     *
     * @return string[] The module names.

     */
    public function getModuleNames()
    {
        return array_keys($this->modules);
    }

    /**
     * Returns the modules in the collection.
     *
     * @return Module[] The modules in the collection.
     */
    public function toArray()
    {
        return $this->modules;
    }

    /**
     * Returns whether the collection is empty.
     *
     * @return bool Returns `true` if the collection is empty and `false`
     *              otherwise.
     */
    public function isEmpty()
    {
        return 0 === count($this->modules);
    }

    /**
     * {@inheritdoc}
     */
    public function getIterator()
    {
        return new ArrayIterator($this->modules);
    }

    /**
     * {@inheritdoc}
     */
    public function count()
    {
        return count($this->modules);
    }

    /**
     * {@inheritdoc}
     */
    public function offsetExists($name)
    {
        return $this->contains($name);
    }

    /**
     * {@inheritdoc}
     */
    public function offsetGet($name)
    {
        return $this->get($name);
    }

    /**
     * {@inheritdoc}
     */
    public function offsetSet($name, $module)
    {
        $this->add($module);
    }

    /**
     * {@inheritdoc}
     */
    public function offsetUnset($name)
    {
        $this->remove($name);
    }
}


1		<?php
2
3		/*
4		* This file is part of the puli/manager package.
5		*
6		* (c) Bernhard Schussek <[email protected]>
7		*
8		* For the full copyright and license information, please view the LICENSE
9		* file that was distributed with this source code.
10		*/
11
12		namespace Puli\Manager\Api\Module;
13
14		use ArrayAccess;
15		use ArrayIterator;
16		use Countable;
17		use IteratorAggregate;
18
19		/**
20		* A collection of Puli modules.
21		*
22		* @since 1.0
23		*
24		* @author Bernhard Schussek <[email protected]>
25		*/
26		class ModuleCollection implements IteratorAggregate, Countable, ArrayAccess
27		{
28		/**
29		* @var RootModule
30		*/
31		private $rootModule;
32
33		/**
34		* @var Module[]
35		*/
36		private $modules = array();
37
38	372	public function __construct(array $modules = array())
39		{
40	372	$this->merge($modules);
41	372	}
42
43		/**
44		* Adds a module to the collection.
45		*
46		* @param Module $module The added module.
47		*/
48	369	public function add(Module $module)
49		{
50	369	$this->modules[$module->getName()] = $module;
51
52	369	if ($module instanceof RootModule) {
53	291	$this->rootModule = $module;
54		}
55	369	}
56
57		/**
58		* Adds multiple modules to the collection.
59		*
60		* @param Module[] $modules The added modules.
61		*/
62	372	public function merge(array $modules)
63		{
64	372	foreach ($modules as $module) {
65	112	$this->add($module);
66		}
67	372	}
68
69		/**
70		* Replaces the collection with the given modules.
71		*
72		* @param Module[] $modules The modules to set.
73		*/
74	2	public function replace(array $modules)
75		{
76	2	$this->clear();
77	2	$this->merge($modules);
78	2	}
79
80		/**
81		* Removes a module from the collection.
82		*
83		* @param string $name The module name.
84		*/
85	12	public function remove($name)
86		{
87	12	if ($this->rootModule && $name === $this->rootModule->getName()) {
88	2	$this->rootModule = null;
89		}
90
91	12	unset($this->modules[$name]);
92	12	}
93
94		/**
95		* Removes all modules from the collection.
96		*/
97	3	public function clear()
98		{
99	3	if ($this->rootModule) {
100	2	$this->rootModule = null;
101		}
102
103	3	$this->modules = array();
104	3	}
105
106		/**
107		* Returns the module with the given name.
108		*
109		* @param string $name The module name.
110		*
111		* @return Module The module with the passed name.
112		*
113		* @throws NoSuchModuleException If the module was not found.
114		*/
115	51	public function get($name)
116		{
117	51	if (!isset($this->modules[$name])) {
118	2	throw new NoSuchModuleException(sprintf(
119	2	'The module "%s" was not found.',
120		$name
121		));
122		}
123
124	49	return $this->modules[$name];
125		}
126
127		/**
128		* Returns whether a module with the given name exists.
129		*
130		* @param string $name The module name.
131		*
132		* @return bool Whether a module with this name exists.
133		*/
134	34	public function contains($name)
135		{
136	34	return isset($this->modules[$name]);
137		}
138
139		/**
140		* Returns the root module.
141		*
142		* If the collection contains no root module, `null` is returned.
143		*
144		* @return RootModule\|null The root module or `null` if none exists.
		0 ignored issues – show Documentation introduced 2016-01-28 11:06 UTC by Report Bug Copy Issue Report Consider making the return type a bit more specific; maybe use `RootModule`. This check looks for the generic type `array` as a return type and suggests a more specific type. This type is inferred from the actual code. Loading history...
145		*/
146	270	public function getRootModule()
147		{
148	270	return $this->rootModule;
149		}
150
151		/**
152		* Returns the name of the root module.
153		*
154		* If the collection contains no root module, `null` is returned.
155		*
156		* @return string\|null The root module name or `null` if none exists.
157		*/
158	2	public function getRootModuleName()
159		{
160	2	return $this->rootModule ? $this->rootModule->getName() : null;
161		}
162
163		/**
164		* Returns all installed modules.
165		*
166		* The installed modules are all modules that are not the root module.
167		*
168		* @return Module[] The installed modules indexed by their names.
169		*/
170	6	public function getInstalledModules()
171		{
172	6	$modules = $this->modules;
173
174	6	if ($this->rootModule) {
175	4	unset($modules[$this->rootModule->getName()]);
176		}
177
178	6	return $modules;
179		}
180
181		/**
182		* Returns the names of all installed modules.
183		*
184		* The installed modules are all modules that are not the root module.
185		*
186		* @return string[] The names of the installed modules.
		0 ignored issues – show Documentation introduced 2016-01-28 11:06 UTC by Report Bug Copy Issue Report Should the return type not be `integer[]`? This check compares the return type specified in the `@return` annotation of a function or method doc comment with the types returned by the function and raises an issue if they mismatch. Loading history...
187		*/
188	1	public function getInstalledModuleNames()
189		{
190	1	return array_keys($this->getInstalledModules());
191		}
192
193		/**
194		* Returns the names of all modules.
195		*
196		* @return string[] The module names.
		0 ignored issues – show Documentation introduced 2016-01-28 11:06 UTC by Report Bug Copy Issue Report Should the return type not be `integer[]`? This check compares the return type specified in the `@return` annotation of a function or method doc comment with the types returned by the function and raises an issue if they mismatch. Loading history...
197		*/
198	93	public function getModuleNames()
199		{
200	93	return array_keys($this->modules);
201		}
202
203		/**
204		* Returns the modules in the collection.
205		*
206		* @return Module[] The modules in the collection.
207		*/
208	6	public function toArray()
209		{
210	6	return $this->modules;
211		}
212
213		/**
214		* Returns whether the collection is empty.
215		*
216		* @return bool Returns `true` if the collection is empty and `false`
217		* otherwise.
218		*/
219	2	public function isEmpty()
220		{
221	2	return 0 === count($this->modules);
222		}
223
224		/**
225		* {@inheritdoc}
226		*/
227	268	public function getIterator()
228		{
229	268	return new ArrayIterator($this->modules);
230		}
231
232		/**
233		* {@inheritdoc}
234		*/
235	33	public function count()
236		{
237	33	return count($this->modules);
238		}
239
240		/**
241		* {@inheritdoc}
242		*/
243	1	public function offsetExists($name)
244		{
245	1	return $this->contains($name);
246		}
247
248		/**
249		* {@inheritdoc}
250		*/
251	6	public function offsetGet($name)
252		{
253	6	return $this->get($name);
254		}
255
256		/**
257		* {@inheritdoc}
258		*/
259	1	public function offsetSet($name, $module)
260		{
261	1	$this->add($module);
262	1	}
263
264		/**
265		* {@inheritdoc}
266		*/
267	1	public function offsetUnset($name)
268		{
269	1	$this->remove($name);
270	1	}
271		}
272

puli / manager

Push — master ( d49c03...6343d0 )

ModuleCollection::add() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like