getMessage(), 'Column string index can not be longer than 3 characters'); return; } self::fail('An expected exception has not been raised.'); } public function testColumnIndexFromStringTooShort(): void { $cellAddress = ''; try { Coordinate::columnIndexFromString($cellAddress); } catch (\Exception $e) { self::assertInstanceOf(Exception::class, $e); self::assertEquals($e->getMessage(), 'Column string index can not be empty'); return; } self::fail('An expected exception has not been raised.'); } /** * @dataProvider providerColumnIndex * * @param mixed $expectedResult * @param int $columnIndex */ public function testStringFromColumnIndex($expectedResult, $columnIndex): void { $string = Coordinate::stringFromColumnIndex($columnIndex); self::assertEquals($expectedResult, $string); $columnIndexBack = Coordinate::columnIndexFromString($string); self::assertEquals($columnIndexBack, $columnIndex, 'should be able to get the original input with opposite method'); } public function providerColumnIndex(): array { return require 'tests/data/ColumnIndex.php'; } /** * @dataProvider providerCoordinates * * @param mixed $expectedResult * @param string $rangeSet */ public function testCoordinateFromString($expectedResult, $rangeSet): void { $result = Coordinate::coordinateFromString($rangeSet); self::assertEquals($expectedResult, $result); } public function providerCoordinates(): array { return require 'tests/data/CellCoordinates.php'; } /** * @dataProvider providerIndexesFromString */ public function testIndexesFromString(array $expectedResult, string $rangeSet): void { $result = Coordinate::indexesFromString($rangeSet); self::assertSame($expectedResult, $result); } public function providerIndexesFromString(): array { return require 'tests/data/Cell/IndexesFromString.php'; } public function testCoordinateFromStringWithRangeAddress(): void { $cellAddress = 'A1:AI2012'; try { Coordinate::coordinateFromString($cellAddress); } catch (\Exception $e) { self::assertInstanceOf(Exception::class, $e); self::assertEquals($e->getMessage(), 'Cell coordinate string can not be a range of cells'); return; } self::fail('An expected exception has not been raised.'); } public function testCoordinateFromStringWithEmptyAddress(): void { $cellAddress = ''; try { Coordinate::coordinateFromString($cellAddress); } catch (\Exception $e) { self::assertInstanceOf(Exception::class, $e); self::assertEquals($e->getMessage(), 'Cell coordinate can not be zero-length string'); return; } self::fail('An expected exception has not been raised.'); } public function testCoordinateFromStringWithInvalidAddress(): void { $cellAddress = 'AI'; try { Coordinate::coordinateFromString($cellAddress); } catch (\Exception $e) { self::assertInstanceOf(Exception::class, $e); self::assertEquals($e->getMessage(), 'Invalid cell coordinate ' . $cellAddress); return; } self::fail('An expected exception has not been raised.'); } /** * @dataProvider providerAbsoluteCoordinates * * @param string $expectedResult * @param string $rangeSet */ public function testAbsoluteCoordinateFromString($expectedResult, $rangeSet): void { $result = Coordinate::absoluteCoordinate($rangeSet); self::assertEquals($expectedResult, $result); } public function providerAbsoluteCoordinates(): array { return require 'tests/data/CellAbsoluteCoordinate.php'; } public function testAbsoluteCoordinateFromStringWithRangeAddress(): void { $cellAddress = 'A1:AI2012'; try { Coordinate::absoluteCoordinate($cellAddress); } catch (\Exception $e) { self::assertInstanceOf(Exception::class, $e); self::assertEquals($e->getMessage(), 'Cell coordinate string can not be a range of cells'); return; } self::fail('An expected exception has not been raised.'); } /** * @dataProvider providerAbsoluteReferences * * @param mixed $expectedResult * @param string $rangeSet */ public function testAbsoluteReferenceFromString($expectedResult, $rangeSet): void { $result = Coordinate::absoluteReference($rangeSet); self::assertEquals($expectedResult, $result); } public function providerAbsoluteReferences(): array { return require 'tests/data/CellAbsoluteReference.php'; } public function testAbsoluteReferenceFromStringWithRangeAddress(): void { $cellAddress = 'A1:AI2012'; try { Coordinate::absoluteReference($cellAddress); } catch (\Exception $e) { self::assertInstanceOf(Exception::class, $e); self::assertEquals($e->getMessage(), 'Cell coordinate string can not be a range of cells'); return; } self::fail('An expected exception has not been raised.'); } /** * @dataProvider providerSplitRange * * @param mixed $expectedResult * @param string $rangeSet */ public function testSplitRange($expectedResult, $rangeSet): void { $result = Coordinate::splitRange($rangeSet); foreach ($result as $key => $split) { if (!is_array($expectedResult[$key])) { self::assertEquals($expectedResult[$key], $split[0]); } else { self::assertEquals($expectedResult[$key], $split); } } } public function providerSplitRange(): array { return require 'tests/data/CellSplitRange.php'; } /** * @dataProvider providerBuildRange * * @param mixed $expectedResult * @param mixed $rangeSets */ public function testBuildRange($expectedResult, $rangeSets): void { $result = Coordinate::buildRange($rangeSets); self::assertEquals($expectedResult, $result); } public function providerBuildRange(): array { return require 'tests/data/CellBuildRange.php'; } public function testBuildRangeInvalid(): void { $this->expectException(TypeError::class); $cellRange = null; // @phpstan-ignore-next-line Coordinate::buildRange(/** @scrutinizer ignore-type */ $cellRange); } public function testBuildRangeInvalid2(): void { $this->expectException(Exception::class); $this->expectExceptionMessage('Range does not contain any information'); $cellRange = []; Coordinate::buildRange($cellRange); } /** * @dataProvider providerRangeBoundaries * * @param mixed $expectedResult * @param string $rangeSet */ public function testRangeBoundaries($expectedResult, $rangeSet): void { $result = Coordinate::rangeBoundaries($rangeSet); self::assertEquals($expectedResult, $result); } public function providerRangeBoundaries(): array { return require 'tests/data/CellRangeBoundaries.php'; } /** * @dataProvider providerRangeDimension * * @param mixed $expectedResult * @param string $rangeSet */ public function testRangeDimension($expectedResult, $rangeSet): void { $result = Coordinate::rangeDimension($rangeSet); self::assertEquals($expectedResult, $result); } public function providerRangeDimension(): array { return require 'tests/data/CellRangeDimension.php'; } /** * @dataProvider providerGetRangeBoundaries * * @param mixed $expectedResult * @param string $rangeSet */ public function testGetRangeBoundaries($expectedResult, $rangeSet): void { $result = Coordinate::getRangeBoundaries($rangeSet); self::assertEquals($expectedResult, $result); } public function providerGetRangeBoundaries(): array { return require 'tests/data/CellGetRangeBoundaries.php'; } /** * @dataProvider providerExtractAllCellReferencesInRange * * @param array $expectedResult * @param string $rangeSet */ public function testExtractAllCellReferencesInRange($expectedResult, $rangeSet): void { $result = Coordinate::extractAllCellReferencesInRange($rangeSet); self::assertEquals($expectedResult, $result); } public function providerExtractAllCellReferencesInRange(): array { return require 'tests/data/CellExtractAllCellReferencesInRange.php'; } /** * @dataProvider providerInvalidRange * * @param string $range */ public function testExtractAllCellReferencesInRangeInvalidRange($range): void { $this->expectException(Exception::class); $this->expectExceptionMessage('Invalid range: "' . $range . '"'); Coordinate::extractAllCellReferencesInRange($range); } public function providerInvalidRange(): array { return [['Z1:A1'], ['A4:A1'], ['B1:A1'], ['AA1:Z1']]; } /** * @dataProvider providerMergeRangesInCollection * * @param mixed $expectedResult * @param mixed $rangeSets */ public function testMergeRangesInCollection($expectedResult, $rangeSets): void { $result = Coordinate::mergeRangesInCollection($rangeSets); self::assertEquals($expectedResult, $result); } public function providerMergeRangesInCollection(): array { return require 'tests/data/CellMergeRangesInCollection.php'; } /** * @dataProvider providerCoordinateIsRange * * @param mixed $expectedResult * @param string $rangeSet */ public function testCoordinateIsRange($expectedResult, $rangeSet): void { $result = Coordinate::coordinateIsRange($rangeSet); self::assertEquals($expectedResult, $result); } public function providerCoordinateIsRange(): array { return require 'tests/data/CoordinateIsRange.php'; } }