phootwork\collection\CollectionUtils

Complexity

Total Complexity

15

Size/Duplication

Total Lines	79
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	2

Test Coverage

Coverage

91.67%

Importance

Changes	4
Bugs	1	Features	1

5 Methods

Rating	Name	Duplication	Size	Complexity
A	fromCollection()	0	7	3
A	fromArray()	0	3	1
B	toCollection()	0	19	7
A	toMap()	0	8	2
A	toList()	0	7	2

<?php
namespace phootwork\collection;

use \Iterator;
use \InvalidArgumentException;

/**
 * CollectionUtils help to transform data recursively into collections. 
 * 
 * It must be mentioned the API is experimental and may change. Please 
 * report to the issue tracker.
 */
class CollectionUtils {
	
	/**
	 * Returns a proper collection for the given array (also transforms nested collections) 
	 * (experimental API)
	 * 
	 * @param array|Iterator $collection
	 * @return Map|ArrayList the collection
	 * @throws InvalidArgumentException
	 */
	public static function fromCollection($collection) {
		if (!(is_array($collection) || $collection instanceof Iterator)) {
			throw new InvalidArgumentException('$collection is neither an array nor an iterator');
		}

		return self::toCollection($collection);
	}
	
	/**
	 * @deprecated use fromCollection instead (will be removed in version 1.3)
	 * @param Iterator $array
	 * @return Map|ArrayList the collection
	 */
	public static function fromArray($array) {
		return self::fromCollection($array);
	}
	
	private static function toCollection($data) {
		// prepare normal array
		if (!($data instanceof Iterator)) {
			$data = json_decode(json_encode($data));
		}

		// check if we can transform it into a collection or just return as is
		if (!(is_array($data) || $data instanceof Iterator || $data instanceof \stdClass)) {
			return $data;
		}

		// check we have a list
		if (is_array($data) || $data instanceof AbstractList) {
			return self::toList($data);
		}
		
		// everything else must be a map
		return self::toMap($data);

It seems like $data defined by json_decode(json_encode($data)) on line 43 can also be of type object<stdClass>; however, phootwork\collection\CollectionUtils::toMap() does only seem to accept array|object<Iterator>, maybe add an additional type check?

	}
	
	/**
	 * Recursively transforms data into a map (on the first level, deeper levels 
	 * transformed to an appropriate collection) (experimental API)
	 * 
	 * @param array|Iterator $collection
	 * @return Map
	 */
	public static function toMap($collection) {
		$map = new Map();
		foreach ($collection as $k => $v) {
			$map->set($k, self::toCollection($v));
		}
		
		return $map;
	}
	
	/**
	 * Recursively transforms data into a list (on the first level, deeper levels 
	 * transformed to an appropriate collection) (experimental API)
	 *
	 * @param array|Iterator $collection
	 * @return ArrayList
	 */
	public static function toList($collection) {
		$list = new ArrayList();
		foreach ($collection as $v) {
			$list->add(self::toCollection($v));
		}
		return $list;
	}

}