4 * Tests for the GenericArrayObject and deriving classes.
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 2 of the License, or
9 * (at your option) any later version.
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
16 * You should have received a copy of the GNU General Public License along
17 * with this program; if not, write to the Free Software Foundation, Inc.,
18 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
19 * http://www.gnu.org/copyleft/gpl.html
25 * @group GenericArrayObject
27 * @author Jeroen De Dauw < jeroendedauw@gmail.com >
29 abstract class GenericArrayObjectTest
extends PHPUnit\Framework\TestCase
{
31 use MediaWikiCoversValidator
;
34 * Returns objects that can serve as elements in the concrete
35 * GenericArrayObject deriving class being tested.
41 abstract public function elementInstancesProvider();
44 * Returns the name of the concrete class being tested.
50 abstract public function getInstanceClass();
53 * Provides instances of the concrete class being tested.
59 public function instanceProvider() {
62 foreach ( $this->elementInstancesProvider() as $elementInstances ) {
63 $instances[] = $this->getNew( $elementInstances[0] );
66 return $this->arrayWrap( $instances );
72 * @param array $elements
74 * @return GenericArrayObject
76 protected function getNew( array $elements = [] ) {
77 $class = $this->getInstanceClass();
79 return new $class( $elements );
83 * @dataProvider elementInstancesProvider
87 * @param array $elements
89 * @covers GenericArrayObject::__construct
91 public function testConstructor( array $elements ) {
92 $arrayObject = $this->getNew( $elements );
94 $this->assertEquals( count( $elements ), $arrayObject->count() );
98 * @dataProvider elementInstancesProvider
102 * @param array $elements
104 * @covers GenericArrayObject::isEmpty
106 public function testIsEmpty( array $elements ) {
107 $arrayObject = $this->getNew( $elements );
109 $this->assertEquals( $elements === [], $arrayObject->isEmpty() );
113 * @dataProvider instanceProvider
117 * @param GenericArrayObject $list
119 * @covers GenericArrayObject::offsetUnset
121 public function testUnset( GenericArrayObject
$list ) {
122 if ( $list->isEmpty() ) {
123 $this->assertTrue( true ); // We cannot test unset if there are no elements
125 $offset = $list->getIterator()->key();
126 $count = $list->count();
127 $list->offsetUnset( $offset );
128 $this->assertEquals( $count - 1, $list->count() );
131 if ( !$list->isEmpty() ) {
132 $offset = $list->getIterator()->key();
133 $count = $list->count();
134 unset( $list[$offset] );
135 $this->assertEquals( $count - 1, $list->count() );
140 * @dataProvider elementInstancesProvider
144 * @param array $elements
146 * @covers GenericArrayObject::append
148 public function testAppend( array $elements ) {
149 $list = $this->getNew();
151 $listSize = count( $elements );
153 foreach ( $elements as $element ) {
154 $list->append( $element );
157 $this->assertEquals( $listSize, $list->count() );
159 $list = $this->getNew();
161 foreach ( $elements as $element ) {
165 $this->assertEquals( $listSize, $list->count() );
167 $this->checkTypeChecks( function ( GenericArrayObject
$list, $element ) {
168 $list->append( $element );
175 * @param callable $function
177 * @covers GenericArrayObject::getObjectType
179 protected function checkTypeChecks( $function ) {
181 $list = $this->getNew();
183 $elementClass = $list->getObjectType();
185 foreach ( [ 42, 'foo', [], new stdClass(), 4.2 ] as $element ) {
186 $validValid = $element instanceof $elementClass;
189 call_user_func( $function, $list, $element );
191 } catch ( InvalidArgumentException
$exception ) {
198 'Object of invalid type got successfully added to a GenericArrayObject'
204 * @dataProvider elementInstancesProvider
208 * @param array $elements
210 * @covers GenericArrayObject::offsetSet
212 public function testOffsetSet( array $elements ) {
213 if ( $elements === [] ) {
214 $this->assertTrue( true );
219 $list = $this->getNew();
221 $element = reset( $elements );
222 $list->offsetSet( 42, $element );
223 $this->assertEquals( $element, $list->offsetGet( 42 ) );
225 $list = $this->getNew();
227 $element = reset( $elements );
228 $list['oHai'] = $element;
229 $this->assertEquals( $element, $list['oHai'] );
231 $list = $this->getNew();
233 $element = reset( $elements );
234 $list->offsetSet( 9001, $element );
235 $this->assertEquals( $element, $list[9001] );
237 $list = $this->getNew();
239 $element = reset( $elements );
240 $list->offsetSet( null, $element );
241 $this->assertEquals( $element, $list[0] );
243 $list = $this->getNew();
246 foreach ( $elements as $element ) {
247 $list->offsetSet( null, $element );
248 $this->assertEquals( $element, $list[$offset++
] );
251 $this->assertEquals( count( $elements ), $list->count() );
253 $this->checkTypeChecks( function ( GenericArrayObject
$list, $element ) {
254 $list->offsetSet( mt_rand(), $element );
259 * @dataProvider instanceProvider
263 * @param GenericArrayObject $list
265 * @covers GenericArrayObject::getSerializationData
266 * @covers GenericArrayObject::serialize
267 * @covers GenericArrayObject::unserialize
269 public function testSerialization( GenericArrayObject
$list ) {
270 $serialization = serialize( $list );
271 $copy = unserialize( $serialization );
273 $this->assertEquals( $serialization, serialize( $copy ) );
274 $this->assertEquals( count( $list ), count( $copy ) );
276 $list = $list->getArrayCopy();
277 $copy = $copy->getArrayCopy();
279 $this->assertArrayEquals( $list, $copy, true, true );