refactor(tests): Improve test class names and assertion messages for clarity.

Author: terabytesoftw

CHANGELOG.md

@@ -1,9 +1,10 @@
 Change Log
 ==========
 
-## 0.1.1 August 18, 2025
+## 0.2.0 August 18, 2025
 
 - Bug #11: Refactor project structure and update dependencies (@terabytesoftw)
+- Enh #12: Add `TestSupport` trait and corresponding test suite for inaccessible properties and methods (@terabytesoftw)
 
 ## 0.1.0 January 21, 2024
 

README.md

@@ -73,115 +73,137 @@ composer update
 
 ## Basic Usage
 
-### Using TestSupport trait
+### Accessing private properties
 
 ```php
 <?php
-
 declare(strict_types=1);
 
 use PHPForge\Support\TestSupport;
 use PHPUnit\Framework\TestCase;
 
-final class MyTest extends TestCase
+final class AccessPrivatePropertyTest extends TestCase
 {
     use TestSupport;
 
-    public function testInaccessibleProperty()
+    public function testInaccesibleProperty():void
     {
         $object = new class () {
             private string $secretValue = 'hidden';
         };
 
         $value = self::inaccessibleProperty($object, 'secretValue');
 
-        self::assertSame('hidden', $value);
+        self::assertSame('hidden', $value, "Should access the private property and return its value.");
     }
 }
 ```
 
-### Accessing private properties
+### Invoking protected methods
 
 ```php
 <?php
-
 declare(strict_types=1);
 
-$object = new class () {
-    private string $secretValue = 'hidden';
-};
-
-// access private properties for testing
-$value = self::inaccessibleProperty($object, 'secretValue');
-
-self::assertSame('hidden', $value);
-```
+use PHPForge\Support\TestSupport;
+use PHPUnit\Framework\TestCase;
 
-### Equals without line ending
+final class InvokeProtectedMethodTest extends TestCase
+{
+    use TestSupport;
 
-```php
-<?php
+    public function testInvokeMethod(): void
+    {
+        $object = new class () {
+            protected function calculate(int $a, int $b): int
+            {
+                return $a + $b;
+            }
+        };
 
-declare(strict_types=1);
+        $result = self::invokeMethod($object, 'calculate', [5, 3]);
 
-// normalize line endings for consistent comparisons
-self::assertSame(
-    self::normalizeLineEndings("Foo\r\nBar"),
-    self::normalizeLineEndings("Foo\nBar"),
-    "Should match regardless of line ending style"
-);
+        self::assertSame(8, $result, "Should invoke the protected method and return the correct sum.");
+    }
+}
 ```
 
-### Invoking protected methods
+### Normalize line endings
 
 ```php
 <?php
-
 declare(strict_types=1);
 
-$object = new class () {
-    protected function calculate(int $a, int $b): int
-    {
-        return $a + $b;
-    }
-};
+use PHPForge\Support\TestSupport;
+use PHPUnit\Framework\TestCase;
 
-// test protected method behavior
-$result = self::invokeMethod($object, 'calculate', [5, 3]);
+final class NormalizeLineEndingsTest extends TestCase
+{
+    use TestSupport;
 
-self::assertSame(8, $result);
+    public function testNormalizedComparison(): void
+    {
+        self::assertSame(
+            self::normalizeLineEndings("Foo\r\nBar"),
+            self::normalizeLineEndings("Foo\nBar"),
+            "Should match regardless of line ending style",
+        );
+    }
+}
 ```
 
 ### Remove files from directory
 
 ```php
 <?php
-
 declare(strict_types=1);
 
-$testDir = dirname(__DIR__) . '/runtime';
+use PHPForge\Support\TestSupport;
+use PHPUnit\Framework\TestCase;
+
+final class RemoveFilesFromDirectoryTest extends TestCase
+{
+    use TestSupport;
 
-// clean up test artifacts (preserves '.gitignore' and '.gitkeep')
-self::removeFilesFromDirectory($testDir);
+    public function testCleanup(): void
+    {
+        $testDir = dirname(__DIR__) . '/runtime';
+        // clean up test artifacts (preserves '.gitignore' and '.gitkeep')
+
+        self::removeFilesFromDirectory($testDir);
+
+        self::assertTrue(true, "Should remove all files in the test directory while preserving Git-tracked files.");
+    }
+}
 ```
 
 ### Set inaccessible property
 
 ```php
 <?php
-
 declare(strict_types=1);
 
-$object = new class () {
-    private string $config = 'default';
-};
+use PHPForge\Support\TestSupport;
+use PHPUnit\Framework\TestCase;
 
-// set private property for testing scenarios
-self::setInaccessibleProperty($object, 'config', 'test-mode');
+final class SetInaccessiblePropertyTest extends TestCase
+{
+    use TestSupport;
 
-$newValue = self::inaccessibleProperty($object, 'config');
+    public function testSetProperty()
+    {
+        $object = new class () {
+            private string $config = 'default';
+        };
+
+        // set private property for testing scenarios
+        self::setInaccessibleProperty($object, 'config', 'test-mode');
 
-self::assertSame('test-mode', $newValue);
+        $newValue = self::inaccessibleProperty($object, 'config');
+
+        self::assertSame('test-mode',  $newValue, "Should set the inaccessible property to 'test-mode'.");
+    }
+}
 ```
 
 ## Documentation