ExtractFirstItemWithContent::fromTraversable() - Code Metrics - Inspection of "New: added support for extracting the first non-em..." - ganbarodigital/php-array-tools - Measure and Improve Code Quality continuously with Scrutinizer

Completed

Push — develop ( ecae74...3fe434 )

by Stuart

created 2016-01-30 16:29 UTC

ExtractFirstItemWithContent::fromTraversable() A

↳ Parent: ExtractFirstItemWithContent

Complexity

Conditions	3
Paths	3

Size

Total Lines	15
Code Lines	5

Duplication

Lines	0
Ratio	0 %

Importance

Changes	1
Bugs	0	Features	1

Metric	Value
c	1
b	0
f	1
dl	0
loc	15
rs	9.4285
cc	3
eloc	5
nc	3
nop	2

<?php

/**
 * Copyright (c) 2016-present Ganbaro Digital Ltd
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 *   * Redistributions of source code must retain the above copyright
 *     notice, this list of conditions and the following disclaimer.
 *
 *   * Redistributions in binary form must reproduce the above copyright
 *     notice, this list of conditions and the following disclaimer in
 *     the documentation and/or other materials provided with the
 *     distribution.
 *
 *   * Neither the names of the copyright holders nor the names of his
 *     contributors may be used to endorse or promote products derived
 *     from this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
 * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
 * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
 * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
 * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 * POSSIBILITY OF SUCH DAMAGE.
 *
 * @category  Libraries
 * @package   ArrayTools/Filters
 * @author    Stuart Herbert <[email protected]>
 * @copyright 2016-present Ganbaro Digital Ltd www.ganbarodigital.com
 * @license   http://www.opensource.org/licenses/bsd-license.php  BSD License
 * @link      http://code.ganbarodigital.com/php-array-tools
 */

namespace GanbaroDigital\ArrayTools\Filters;

use GanbaroDigital\Reflection\Checks\IsEmpty;
use GanbaroDigital\Reflection\Maps\MapTypeToMethod;
use Traversable;

class ExtractFirstItemWithContent
{
    /**
     * extract the first item from a dataset. if the dataset is empty, or all
     * the content is empty, return the default value
     *
     * @param  mixed $data
     *         the data to filter
     * @param  mixed $default
     *         the data to return when we cannot filter $data
     * @return mixed
     */
    public function __invoke($data, $default)
    {
        return self::from($data, $default);
    }

    /**
    * extract the first item from a dataset. if the dataset is empty, or all
    * the content is empty, return the default value
     *
     * @param  mixed $data
     *         the data to filter
     * @param  mixed $default
     *         the data to return when we cannot filter $data
     * @return mixed
     */
    public static function from($data, $default)
    {
        $method = MapTypeToMethod::using($data, self::$dispatchMap);
        return self::$method($data, $default);
    }

    /**
     * extract the first item from a dataset held in a string. if the string
     * is empty, return the default value
     *
     * we assume that the string contains space-separated items
     *
     * @param  string $data
     *         the data to filter
     * @param  mixed $default
     *         the data to return when we cannot filter $data
     * @return mixed
     */
    private static function fromString($data, $default)
    {
        // special case - $data is empty
        if (IsEmpty::check($data)) {
            return $default;
        }

        // treat it as a whitespace-separated string
        $parts = explode(' ', $data);
        return self::fromTraversable($parts, $default);
    }

    /**
     * extract the first item from a dataset
     *
     * @param  array|Traversable $data
     *         the data to filter
     * @param  mixed $default
     *         the data to return when we cannot filter $data
     * @return mixed
     */
    private static function fromTraversable($data, $default)
    {
        // return the first item available in $data
        //
        // we use a foreach() loop here because it is compatible with
        // both arrays and iterators
        foreach ($data as $item) {
            if (!IsEmpty::check($item)) {
                return $item;
            }
        }

        // if we get here, then $data was empty
        return $default;
    }

    /**
     * called when we've been given a data type we do not support
     *
     * @param  mixed $data
     *         the data to filter
     * @param  mixed $default
     *         the data to return when we cannot filter $data
     * @return mixed
     */
    private static function nothingMatchesTheInputType($data, $default)

    {
        return $default;
    }

    /**
     * lookup map of how to convert which data type
     *
     * @var array
     */
    private static $dispatchMap = [
        'String' => 'fromString',
        'Traversable' => 'fromTraversable'
    ];
}


1			<?php
2
3			/**
4			* Copyright (c) 2016-present Ganbaro Digital Ltd
5			* All rights reserved.
6			*
7			* Redistribution and use in source and binary forms, with or without
8			* modification, are permitted provided that the following conditions
9			* are met:
10			*
11			* * Redistributions of source code must retain the above copyright
12			* notice, this list of conditions and the following disclaimer.
13			*
14			* * Redistributions in binary form must reproduce the above copyright
15			* notice, this list of conditions and the following disclaimer in
16			* the documentation and/or other materials provided with the
17			* distribution.
18			*
19			* * Neither the names of the copyright holders nor the names of his
20			* contributors may be used to endorse or promote products derived
21			* from this software without specific prior written permission.
22			*
23			* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
24			* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
25			* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
26			* FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
27			* COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
28			* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
29			* BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
30			* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
31			* CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
32			* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
33			* ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
34			* POSSIBILITY OF SUCH DAMAGE.
35			*
36			* @category Libraries
37			* @package ArrayTools/Filters
38			* @author Stuart Herbert <[email protected]>
39			* @copyright 2016-present Ganbaro Digital Ltd www.ganbarodigital.com
40			* @license http://www.opensource.org/licenses/bsd-license.php BSD License
41			* @link http://code.ganbarodigital.com/php-array-tools
42			*/
43
44			namespace GanbaroDigital\ArrayTools\Filters;
45
46			use GanbaroDigital\Reflection\Checks\IsEmpty;
47			use GanbaroDigital\Reflection\Maps\MapTypeToMethod;
48			use Traversable;
49
50			class ExtractFirstItemWithContent
51			{
52			/**
53			* extract the first item from a dataset. if the dataset is empty, or all
54			* the content is empty, return the default value
55			*
56			* @param mixed $data
57			* the data to filter
58			* @param mixed $default
59			* the data to return when we cannot filter $data
60			* @return mixed
61			*/
62			public function __invoke($data, $default)
63			{
64			return self::from($data, $default);
65			}
66
67			/**
68			* extract the first item from a dataset. if the dataset is empty, or all
69			* the content is empty, return the default value
70			*
71			* @param mixed $data
72			* the data to filter
73			* @param mixed $default
74			* the data to return when we cannot filter $data
75			* @return mixed
76			*/
77			public static function from($data, $default)
78			{
79			$method = MapTypeToMethod::using($data, self::$dispatchMap);
80			return self::$method($data, $default);
81			}
82
83			/**
84			* extract the first item from a dataset held in a string. if the string
85			* is empty, return the default value
86			*
87			* we assume that the string contains space-separated items
88			*
89			* @param string $data
90			* the data to filter
91			* @param mixed $default
92			* the data to return when we cannot filter $data
93			* @return mixed
94			*/
95			private static function fromString($data, $default)
96			{
97			// special case - $data is empty
98			if (IsEmpty::check($data)) {
99			return $default;
100			}
101
102			// treat it as a whitespace-separated string
103			$parts = explode(' ', $data);
104			return self::fromTraversable($parts, $default);
105			}
106
107			/**
108			* extract the first item from a dataset
109			*
110			* @param array\|Traversable $data
111			* the data to filter
112			* @param mixed $default
113			* the data to return when we cannot filter $data
114			* @return mixed
115			*/
116			private static function fromTraversable($data, $default)
117			{
118			// return the first item available in $data
119			//
120			// we use a foreach() loop here because it is compatible with
121			// both arrays and iterators
122			foreach ($data as $item) {
123			if (!IsEmpty::check($item)) {
124			return $item;
125			}
126			}
127
128			// if we get here, then $data was empty
129			return $default;
130			}
131
132			/**
133			* called when we've been given a data type we do not support
134			*
135			* @param mixed $data
136			* the data to filter
137			* @param mixed $default
138			* the data to return when we cannot filter $data
139			* @return mixed
140			*/
141			private static function nothingMatchesTheInputType($data, $default)
			0 ignored issues – show Unused Code introduced 2016-01-30 16:32 UTC by Report Bug Copy Issue Report The parameter `$data` is not used and could be removed. This check looks from parameters that have been defined for a function or method, but which are not used in the method body. Loading history...
142			{
143			return $default;
144			}
145
146			/**
147			* lookup map of how to convert which data type
148			*
149			* @var array
150			*/
151			private static $dispatchMap = [
152			'String' => 'fromString',
153			'Traversable' => 'fromTraversable'
154			];
155			}
156

ganbarodigital / php-array-tools

Push — develop ( ecae74...3fe434 )

ExtractFirstItemWithContent::fromTraversable() A

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like