adjust text cases and tests to match problem specs

Author: A-O-Emmanuel

exercises/practice/grains/.meta/tests.toml

@@ -3,34 +3,34 @@
 # so comments can be added in a "comment" key.
 
 [9fbde8de-36b2-49de-baf2-cd42d6f28405]
-description = "1"
+description = "grains on square 1"
 
 [ee1f30c2-01d8-4298-b25d-c677331b5e6d]
-description = "2"
+description = "grains on square 2"
 
 [10f45584-2fc3-4875-8ec6-666065d1163b]
-description = "3"
+description = "grains on square 3"
 
 [a7cbe01b-36f4-4601-b053-c5f6ae055170]
-description = "4"
+description = "grains on square 4"
 
 [c50acc89-8535-44e4-918f-b848ad2817d4]
-description = "16"
+description = "grains on square 16"
 
 [acd81b46-c2ad-4951-b848-80d15ed5a04f]
-description = "32"
+description = "grains on square 32"
 
 [c73b470a-5efb-4d53-9ac6-c5f6487f227b]
-description = "64"
+description = "grains on square 64"
 
 [1d47d832-3e85-4974-9466-5bd35af484e3]
-description = "square 0 raises an exception"
+description = "square 0 is invalid"
 
 [61974483-eeb2-465e-be54-ca5dde366453]
-description = "negative square raises an exception"
+description = "negative square is invalid"
 
 [a95e4374-f32c-45a7-a10d-ffec475c012f]
-description = "square greater than 64 raises an exception"
+description = "square greater than 64 is invalid"
 
 [6eb07385-3659-4b45-a6be-9dc474222750]
 description = "returns the total number of grains on the board"

exercises/practice/grains/GrainsTest.php

@@ -23,99 +23,102 @@ public static function setUpBeforeClass(): void
      * Don't use gmp or any other similar libraries.
      * Try to make the solution for virtually any board size.
      */
-    
+
     /**
      * uuid: 9fbde8de-36b2-49de-baf2-cd42d6f28405
      */
-    #[TestDox('1')]
-    public function testInput1(): void
+    #[TestDox('grains on square 1')]
+    public function testGrainsOnSquare1(): void
     {
-        $this->assertSame('1', square(1));
+        $this->assertSame(1, square(1));
     }
 
     /**
      * uuid: ee1f30c2-01d8-4298-b25d-c677331b5e6d
      */
-    #[TestDox('2')]
-    public function testInput2(): void
+    #[TestDox('grains on square 2')]
+    public function testGrainsOnSquare2(): void
     {
-        $this->assertSame('2', square(2));
+        $this->assertSame(2, square(2));
     }
 
      /**
      * uuid: 10f45584-2fc3-4875-8ec6-666065d1163b
      */
-    #[TestDox('3')]
-    public function testInput3(): void
+    #[TestDox('grains on square 3')]
+    public function testGrainsOnSquare3(): void
     {
-        $this->assertSame('4', square(3));
+        $this->assertSame(4, square(3));
     }
 
     /**
      * uuid: a7cbe01b-36f4-4601-b053-c5f6ae055170
      */
-    #[TestDox('4')]
-    public function testInput4(): void
+    #[TestDox('grains on square 4')]
+    public function testGrainsOnSquare4(): void
     {
-        $this->assertSame('8', square(4));
+        $this->assertSame(8, square(4));
     }
 
     /**
      * uuid: c50acc89-8535-44e4-918f-b848ad2817d4
      */
-    #[TestDox('16')]
-    public function testInput16(): void
+    #[TestDox('grains on square 16')]
+    public function testGrainsOnSquare16(): void
     {
-        $this->assertSame('32768', square(16));
+        $this->assertSame(32768, square(16));
     }
 
     /**
      * uuid: acd81b46-c2ad-4951-b848-80d15ed5a04f
      */
-    #[TestDox('32')]
-    public function testInput32(): void
+    #[TestDox('grains on square 32')]
+    public function testGrainsOnSquare32(): void
     {
-        $this->assertSame('2147483648', square(32));
+        $this->assertSame(2147483648, square(32));
     }
 
     /**
      * uuid: c73b470a-5efb-4d53-9ac6-c5f6487f227b
      */
-    #[TestDox('64')]
-    public function testInput64(): void
+    #[TestDox('grains on square 64')]
+    public function testGrainsOnSquare64(): void
     {
-        $this->assertSame('9223372036854775808', square(64));
+        $this->assertSame(9223372036854775808, square(64));
     }
 
     /**
      * uuid: 1d47d832-3e85-4974-9466-5bd35af484e3
      */
-    #[TestDox('square 0 raises an exception')]
-    public function testRejectsZero(): void
+    #[TestDox('square 0 is invalid')]
+    public function testSquare0IsInvalid(): void
     {
         $this->expectException(InvalidArgumentException::class);
+        $this->expectExceptionMessage('square must be between 1 and 64');
 
         square(0);
     }
 
      /**
      * uuid: 61974483-eeb2-465e-be54-ca5dde366453
      */
-    #[TestDox('negative square raises an exception')]
+    #[TestDox('negative square is invalid')]
     public function testRejectsNegative(): void
     {
         $this->expectException(InvalidArgumentException::class);
+        $this->expectExceptionMessage('square must be between 1 and 64');
 
         square(-1);
     }
 
      /**
      * uuid: a95e4374-f32c-45a7-a10d-ffec475c012f
      */
-    #[TestDox('square greater than 64 raises an exception')]
+    #[TestDox('square greater than 64 is invalid')]
     public function testRejectsGreaterThan64(): void
     {
         $this->expectException(InvalidArgumentException::class);
+        $this->expectExceptionMessage('square must be between 1 and 64');
 
         square(65);
     }
@@ -126,6 +129,6 @@ public function testRejectsGreaterThan64(): void
     #[TestDox('returns the total number of grains on the board')]
     public function testTotal(): void
     {
-        $this->assertSame('18446744073709551615', total());
+        $this->assertSame(18446744073709551615, total());
     }
 }