array.php ➔ expect() - Code Metrics - Inspection of "Merge pull request #7 from equip/feature/ensure-fu..." - equip/assist - Measure and Improve Code Quality continuously with Scrutinizer

Completed

Push — master ( f8fd07...04355a )

by Woody

created 2016-07-01 14:41 UTC

array.php ➔ expect() A

↳ Parent: Project

Complexity

Conditions	1
Paths	1

Size

Total Lines	14
Code Lines	8

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	8
CRAP Score	1

Importance

Changes	1
Bugs	0	Features	1

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

<?php

namespace Equip\Arr;

use Traversable;

/**
 * Check if a key exists in an array.
 *
 * @param array|Traversable $array
 * @param string|integer $key
 *
 * @return boolean
 */
function exists($array, $key)
{
    return array_key_exists($key, to_array($array));
}

/**
 * Convert a value to an array.
 *
 * If the value is an array it will be returned.
 * If the value is Traversable it will be converted to an array.
 * If the value is anything else it will be cast to an array.
 *
 * @param mixed $value
 *
 * @return array
 */
function to_array($value)

{
    if (is_array($value)) {
        return $value;
    }

    if ($value instanceof Traversable) {
        return iterator_to_array($value);
    }

    return (array) $value;
}

/**
 * Get a single value from an array.
 *
 * If the value does not exist, the default will be returned.
 *
 * @param array|Traversable $source
 * @param string|integer $key
 * @param mixed $default
 *
 * @return mixed
 */
function get($source, $key, $default = null)
{
    if (exists($source, $key)) {
        return $source[$key];
    }

    return $default;
}

/**
 * Grab some values from an array.
 *
 * @param array|Traversable $source
 * @param array|string $keys
 *
 * @return array
 */
function some($source, $keys)
{
    return array_intersect_key(
        to_array($source),
        array_flip(to_array($keys))
    );
}

/**
 * Exclude some values from an array.
 *
 * This is the inverse of some().
 *
 * @param array|Traversable $source
 * @param array|string $keys
 *
 * @return array
 */
function without($source, $keys)
{
    return array_diff_key(
        to_array($source),
        array_flip(to_array($keys))
    );
}

/**
 * Grab some values from an array, ensuring that all keys are defined.
 *
 * If a given key does not exist, the default value will be set.
 *
 * @param array|Traversable $source
 * @param array|string $keys
 * @param mixed $default
 *
 * @return array
 */
function expect($source, $keys, $default = null)
{
    $defaults = array_fill_keys(
        to_array($keys),
        $default
    );

    $source = to_array($source);

    return array_replace(
        array_intersect_key($source, $defaults),
        array_diff_key($defaults, $source)
    );
}

/**
 * Take the first value from an array.
 *
 * @param array $list
 *
 * @return mixed
 */
function head($list)
{
    $list = to_array($list);
    return array_shift($list);
}

/**
 * Take the last value from an array.
 *
 * @param array $list
 *
 * @return mixed
 */
function tail($list)
{
    $list = to_array($list);
    return array_pop($list);
}

/**
 * Index an collection by a key.
 *
 * Rows in the collection can be arrays or objects.
 *
 * @param array|Traversable $source
 *
 * @return array
 */
function index_by($source, $key)

{
    $indexed = [];

    foreach ($source as $row) {
        if (is_object($row)) {
            $indexed[$row->$key] = $row;
        } else {
            $indexed[$row[$key]] = $row;
        }
    }

    return $indexed;
}


1		<?php
2
3		namespace Equip\Arr;
4
5		use Traversable;
6
7		/**
8		* Check if a key exists in an array.
9		*
10		* @param array\|Traversable $array
11		* @param string\|integer $key
12		*
13		* @return boolean
14		*/
15		function exists($array, $key)
16		{
17	1	return array_key_exists($key, to_array($array));
18		}
19
20		/**
21		* Convert a value to an array.
22		*
23		* If the value is an array it will be returned.
24		* If the value is Traversable it will be converted to an array.
25		* If the value is anything else it will be cast to an array.
26		*
27		* @param mixed $value
28		*
29		* @return array
30		*/
31		function to_array($value)
		0 ignored issues – show Coding Style introduced 2016-03-22 01:10 UTC by Report Bug Copy Issue Report As per coding-style, this function should be in camelCase. CamelCase (...) is the practice of writing compound words or phrases such that each word or abbreviation begins with a capital letter. Learn more about camelCase. Loading history...
32		{
33	7	if (is_array($value)) {
34	7	return $value;
35		}
36
37	4	if ($value instanceof Traversable) {
38	1	return iterator_to_array($value);
39		}
40
41	4	return (array) $value;
42		}
43
44		/**
45		* Get a single value from an array.
46		*
47		* If the value does not exist, the default will be returned.
48		*
49		* @param array\|Traversable $source
50		* @param string\|integer $key
51		* @param mixed $default
52		*
53		* @return mixed
54		*/
55		function get($source, $key, $default = null)
56		{
57	1	if (exists($source, $key)) {
58	1	return $source[$key];
59		}
60
61	1	return $default;
62		}
63
64		/**
65		* Grab some values from an array.
66		*
67		* @param array\|Traversable $source
68		* @param array\|string $keys
69		*
70		* @return array
71		*/
72		function some($source, $keys)
73		{
74	1	return array_intersect_key(
75	1	to_array($source),
76	1	array_flip(to_array($keys))
77	1	);
78		}
79
80		/**
81		* Exclude some values from an array.
82		*
83		* This is the inverse of some().
84		*
85		* @param array\|Traversable $source
86		* @param array\|string $keys
87		*
88		* @return array
89		*/
90		function without($source, $keys)
91		{
92	1	return array_diff_key(
93	1	to_array($source),
94	1	array_flip(to_array($keys))
95	1	);
96		}
97
98		/**
99		* Grab some values from an array, ensuring that all keys are defined.
100		*
101		* If a given key does not exist, the default value will be set.
102		*
103		* @param array\|Traversable $source
104		* @param array\|string $keys
105		* @param mixed $default
106		*
107		* @return array
108		*/
109		function expect($source, $keys, $default = null)
110		{
111	1	$defaults = array_fill_keys(
112	1	to_array($keys),
113		$default
114	1	);
115
116	1	$source = to_array($source);
117
118	1	return array_replace(
119	1	array_intersect_key($source, $defaults),
120	1	array_diff_key($defaults, $source)
121	1	);
122		}
123
124		/**
125		* Take the first value from an array.
126		*
127		* @param array $list
128		*
129		* @return mixed
130		*/
131		function head($list)
132		{
133	1	$list = to_array($list);
134	1	return array_shift($list);
135		}
136
137		/**
138		* Take the last value from an array.
139		*
140		* @param array $list
141		*
142		* @return mixed
143		*/
144		function tail($list)
145		{
146	1	$list = to_array($list);
147	1	return array_pop($list);
148		}
149
150		/**
151		* Index an collection by a key.
152		*
153		* Rows in the collection can be arrays or objects.
154		*
155		* @param array\|Traversable $source
156		*
157		* @return array
158		*/
159		function index_by($source, $key)
		0 ignored issues – show Coding Style introduced 2016-06-23 15:14 UTC by Report Bug Copy Issue Report As per coding-style, this function should be in camelCase. CamelCase (...) is the practice of writing compound words or phrases such that each word or abbreviation begins with a capital letter. Learn more about camelCase. Loading history...
160		{
161	1	$indexed = [];
162
163	1	foreach ($source as $row) {
164	1	if (is_object($row)) {
165	1	$indexed[$row->$key] = $row;
166	1	} else {
167	1	$indexed[$row[$key]] = $row;
168		}
169	1	}
170
171	1	return $indexed;
172		}
173

equip / assist

Push — master ( f8fd07...04355a )

array.php ➔ expect() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like