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 */ public function testStringFromColumnIndex(mixed $expectedResult, int $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 static function providerColumnIndex(): array { return require 'tests/data/ColumnIndex.php'; } /** * @dataProvider providerCoordinates */ public function testCoordinateFromString(mixed $expectedResult, string $rangeSet): void { $result = Coordinate::coordinateFromString($rangeSet); self::assertEquals($expectedResult, $result); } public static 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 static 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 */ public function testAbsoluteCoordinateFromString(string $expectedResult, string $rangeSet): void { $result = Coordinate::absoluteCoordinate($rangeSet); self::assertEquals($expectedResult, $result); } public static 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 */ public function testAbsoluteReferenceFromString(mixed $expectedResult, int|string $rangeSet): void { $result = Coordinate::absoluteReference((string) $rangeSet); self::assertEquals($expectedResult, $result); } public static 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 */ public function testSplitRange(array $expectedResult, string $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 static function providerSplitRange(): array { return require 'tests/data/CellSplitRange.php'; } /** * @dataProvider providerBuildRange */ public function testBuildRange(mixed $expectedResult, array $rangeSets): void { $result = Coordinate::buildRange($rangeSets); self::assertEquals($expectedResult, $result); } public static 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($cellRange); } public function testBuildRangeInvalid2(): void { $this->expectException(Exception::class); $this->expectExceptionMessage('Range does not contain any information'); $cellRange = []; Coordinate::buildRange($cellRange); } /** * @dataProvider providerRangeBoundaries */ public function testRangeBoundaries(mixed $expectedResult, string $rangeSet): void { $result = Coordinate::rangeBoundaries($rangeSet); self::assertEquals($expectedResult, $result); } public static function providerRangeBoundaries(): array { return require 'tests/data/CellRangeBoundaries.php'; } /** * @dataProvider providerRangeDimension */ public function testRangeDimension(mixed $expectedResult, string $rangeSet): void { $result = Coordinate::rangeDimension($rangeSet); self::assertEquals($expectedResult, $result); } public static function providerRangeDimension(): array { return require 'tests/data/CellRangeDimension.php'; } /** * @dataProvider providerGetRangeBoundaries */ public function testGetRangeBoundaries(mixed $expectedResult, string $rangeSet): void { $result = Coordinate::getRangeBoundaries($rangeSet); self::assertEquals($expectedResult, $result); } public static function providerGetRangeBoundaries(): array { return require 'tests/data/CellGetRangeBoundaries.php'; } /** * @dataProvider providerCoordinateIsInsideRange */ public static function testCoordinateIsInsideRange(bool $expectedResult, string $range, string $coordinate): void { $result = Coordinate::coordinateIsInsideRange($range, $coordinate); self::assertEquals($result, $expectedResult); } public static function providerCoordinateIsInsideRange(): array { return require 'tests/data/Cell/CoordinateIsInsideRange.php'; } /** * @dataProvider providerCoordinateIsInsideRangeException */ public static function testCoordinateIsInsideRangeException(string $expectedResult, string $range, string $coordinate): void { try { Coordinate::coordinateIsInsideRange($range, $coordinate); } catch (\Exception $e) { self::assertInstanceOf(Exception::class, $e); self::assertEquals($e->getMessage(), $expectedResult); return; } self::fail('An expected exception has not been raised.'); } public static function providerCoordinateIsInsideRangeException(): array { return require 'tests/data/Cell/CoordinateIsInsideRangeException.php'; } /** * @dataProvider providerExtractAllCellReferencesInRange */ public function testExtractAllCellReferencesInRange(array $expectedResult, string $rangeSet): void { $result = Coordinate::extractAllCellReferencesInRange($rangeSet); self::assertEquals($expectedResult, $result); } public static function providerExtractAllCellReferencesInRange(): array { return require 'tests/data/CellExtractAllCellReferencesInRange.php'; } /** * @dataProvider providerInvalidRange */ public function testExtractAllCellReferencesInRangeInvalidRange(string $range): void { $this->expectException(Exception::class); $this->expectExceptionMessage('Invalid range: "' . $range . '"'); Coordinate::extractAllCellReferencesInRange($range); } public static function providerInvalidRange(): array { return [['Z1:A1'], ['A4:A1'], ['B1:A1'], ['AA1:Z1']]; } /** * @dataProvider providerMergeRangesInCollection */ public function testMergeRangesInCollection(mixed $expectedResult, array $rangeSets): void { $result = Coordinate::mergeRangesInCollection($rangeSets); self::assertEquals($expectedResult, $result); } public static function providerMergeRangesInCollection(): array { return require 'tests/data/CellMergeRangesInCollection.php'; } /** * @dataProvider providerCoordinateIsRange */ public function testCoordinateIsRange(mixed $expectedResult, string $rangeSet): void { $result = Coordinate::coordinateIsRange($rangeSet); self::assertEquals($expectedResult, $result); } public static function providerCoordinateIsRange(): array { return require 'tests/data/CoordinateIsRange.php'; } }