feat(tests): Add TestSupport trait and corresponding test suite for inaccessible properties and methods.

Author: terabytesoftw

README.md

@@ -28,7 +28,7 @@
 - Invoke inaccessible methods to expand testing coverage.
 
 ✅ **Cross-Platform String Assertions**
-- Eliminate false positives/negatives caused by Windows vs. Unix line-ending differences.
+- Eliminate false positives/negatives caused by windows vs. unix line ending differences.
 - Normalize line endings for consistent string comparisons across platforms.
 
 ✅ **File System Test Management**
@@ -73,6 +73,33 @@ composer update
 
 ## Basic Usage
 
+### Using TestSupport trait
+
+```php
+<?php
+
+declare(strict_types=1);
+
+use PHPForge\Support\TestSupport;
+use PHPUnit\Framework\TestCase;
+
+final class MyTest extends TestCase
+{
+    use TestSupport;
+
+    public function testInaccessibleProperty()
+    {
+        $object = new class () {
+            private string $secretValue = 'hidden';
+        };
+
+        $value = $this->inaccessibleProperty($object, 'secretValue');
+
+        self::assertSame('hidden', $value);
+    }
+}
+```
+
 ### Accessing private properties
 
 ```php

composer.json

@@ -1,7 +1,7 @@
 {
     "name": "php-forge/support",
     "type": "library",
-    "description": "Support library tests for PHP",
+    "description": "Support utilities for enhanced testing capabilities.",
     "keywords": [
         "php",
         "php-forge",
@@ -11,16 +11,16 @@
     ],
     "license": "BSD-3-Clause",
     "require": {
-        "php": "^8.1",
-        "phpunit/phpunit": "^10.5"
+        "php": "^8.1"
     },
     "require-dev": {
         "infection/infection": "^0.27|^0.31",
         "maglnet/composer-require-checker": "^4.7",
-        "phpstan/phpstan-strict-rules": "^2.0.3",
-        "symplify/easy-coding-standard": "^12.5",
         "phpstan/phpstan": "^2.1",
-        "rector/rector": "^2.1"
+        "phpstan/phpstan-strict-rules": "^2.0.3",
+        "phpunit/phpunit": "^10.5",
+        "rector/rector": "^2.1",
+        "symplify/easy-coding-standard": "^12.5"
     },
     "autoload": {
         "psr-4": {

src/Assert.php src/TestSupport.phpsrc/Assert.php renamed to src/TestSupport.php

@@ -20,46 +20,20 @@
 use function unlink;
 
 /**
- * Assertion utility class for advanced test introspection and manipulation.
+ * Trait providing utilities for testing inaccessible properties, methods, and filesystem cleanup.
  *
- * Provides static helper methods for accessing and modifying inaccessible properties and methods invoking parent class
- * logic, and performing file system cleanup in test environments.
+ * Supplies static helper methods for normalizing line endings, accessing or modifying private/protected properties and
+ * methods (including those inherited from parent classes), invoking inaccessible methods, and recursively removing
+ * files from directories.
  *
- * Extends {@see \PHPUnit\Framework\Assert} to offer additional capabilities for testing private/protected members and
- * for managing test artifacts, supporting robust and isolated unit tests.
+ * These utilities are designed to facilitate comprehensive unit testing by enabling assertions and manipulations that
+ * would otherwise be restricted by visibility constraints or platform differences.
  *
- * Key features.
- * - Access and modify inaccessible (private/protected) properties and methods via reflection.
- * - Invoke parent class methods and properties for testing inheritance scenarios.
- * - Normalize line endings for cross-platform string assertions.
- * - Remove files and directories recursively for test environment cleanup.
- *
- * @copyright Copyright (C) 2025 PHPForge.
+ * @copyright Copyright (C) 2025 Terabytesoftw.
  * @license https://opensource.org/license/bsd-3-clause BSD 3-Clause License.
  */
-final class Assert extends \PHPUnit\Framework\Assert
+trait TestSupport
 {
-    /**
-     * Asserts that two strings are equal after normalizing line endings to unix style ('\n').
-     *
-     * Replaces all windows style ('\r\n') line endings with unix style ('\n') in both the expected and actual strings
-     * before performing the equality assertion.
-     *
-     * This ensures cross-platform consistency in string comparisons where line ending differences may otherwise cause
-     * `false` negatives.
-     *
-     * @param string $expected Expected string value, with any line endings.
-     * @param string $actual Actual string value, with any line endings.
-     * @param string $message Optional failure message to display if the assertion fails. Default is an empty string.
-     */
-    public static function equalsWithoutLE(string $expected, string $actual, string $message = ''): void
-    {
-        $expected = str_replace("\r\n", "\n", $expected);
-        $actual = str_replace("\r\n", "\n", $actual);
-
-        self::assertEquals($expected, $actual, $message);
-    }
-
     /**
      * Retrieves the value of an inaccessible property from a parent class instance.
      *
@@ -185,6 +159,23 @@ public static function invokeParentMethod(
         return $result ?? null;
     }
 
+    /**
+     * Normalizes line endings to unix style ('\n') for cross-platform string assertions.
+     *
+     * Converts windows style ('\r\n') line endings to unix style ('\n') to ensure consistent string comparisons across
+     * different operating systems during testing.
+     *
+     * This method is useful for eliminating false negatives in assertions caused by platform-specific line endings.
+     *
+     * @param string $line Input string potentially containing windows style line endings.
+     *
+     * @return string String with normalized unix style line endings.
+     */
+    public static function normalizeLineEndings(string $line): string
+    {
+        return str_replace("\r\n", "\n", $line);
+    }
+
     /**
      * Removes all files and directories recursively from the specified base path, excluding '.gitignore' and
      * '.gitkeep'.

tests/AssertTest.php tests/TestSupportTest.phptests/AssertTest.php renamed to tests/TestSupportTest.php

@@ -4,41 +4,35 @@
 
 namespace PHPForge\Support\Tests;
 
-use PHPForge\Support\Assert;
 use PHPForge\Support\Tests\Stub\{TestBaseClass, TestClass};
+use PHPForge\Support\TestSupport;
 use PHPUnit\Framework\TestCase;
 use ReflectionException;
 use RuntimeException;
 
 /**
- * Test suite for {@see Assert} utility methods and reflection helpers.
+ * Test suite for {@see TestSupport} trait utility methods.
  *
- * Verifies the behavior of assertion and reflection-based utility methods for testing inaccessible properties, parent
- * properties, and methods, as well as file system operations for test directories.
+ * Verifies the behavior of utility methods provided by the {@see TestSupport} trait for testing inaccessible
+ * properties, parent properties, and methods, as well as file system operations for test directories.
  *
  * These tests ensure correct access and mutation of private/protected members, invocation of inaccessible methods, and
  * robust file removal logic, including error handling for non-existent directories.
  *
- * Test coverage.
+ * Test coverage:
  * - Accessing and asserting values of inaccessible properties and parent properties.
  * - Ensuring correct exception handling for invalid operations.
  * - Invoking inaccessible methods and parent methods.
+ * - Normalizing line endings.
  * - Removing files from directories and handling missing directories.
  * - Setting values for inaccessible properties and parent properties.
  *
  * @copyright Copyright (C) 2025 Terabytesoftw.
  * @license https://opensource.org/license/bsd-3-clause BSD 3-Clause License.
  */
-final class AssertTest extends TestCase
+final class TestSupportTest extends TestCase
 {
-    public function testEqualsWithoutLEReturnsTrueWhenStringsAreIdenticalWithLineEndings(): void
-    {
-        Assert::equalsWithoutLE(
-            "foo\r\nbar",
-            "foo\r\nbar",
-            "Should return 'true' when both strings are identical including line endings.",
-        );
-    }
+    use TestSupport;
 
     /**
      * @throws ReflectionException
@@ -47,7 +41,7 @@ public function testInaccessibleParentPropertyReturnsExpectedValue(): void
     {
         self::assertSame(
             'valueParent',
-            Assert::inaccessibleParentProperty(
+            self::inaccessibleParentProperty(
                 new TestClass(),
                 TestBaseClass::class,
                 'propertyParent',
@@ -56,6 +50,15 @@ public function testInaccessibleParentPropertyReturnsExpectedValue(): void
         );
     }
 
+    public function testNormalizeLineEndingsWhenStringsAreIdenticalWithLineEndings(): void
+    {
+        self::assertSame(
+            self::normalizeLineEndings("foo\r\nbar"),
+            self::normalizeLineEndings("foo\r\nbar"),
+            "Should return 'true' when both strings are identical including line endings.",
+        );
+    }
+
     public function testRemoveFilesFromDirectoryRemovesAllFiles(): void
     {
         $dir = dirname(__DIR__) . '/runtime';
@@ -64,7 +67,7 @@ public function testRemoveFilesFromDirectoryRemovesAllFiles(): void
         touch("{$dir}/test.txt");
         touch("{$dir}/subdir/test.txt");
 
-        Assert::removeFilesFromDirectory($dir);
+        self::removeFilesFromDirectory($dir);
 
         $this->assertFileDoesNotExist(
             "{$dir}/test.txt",
@@ -83,7 +86,7 @@ public function testReturnInaccessiblePropertyValueWhenPropertyIsPrivate(): void
     {
         self::assertSame(
             'value',
-            Assert::inaccessibleProperty(new TestClass(), 'property'),
+            self::inaccessibleProperty(new TestClass(), 'property'),
             "Should return the value of the private property 'property' when accessed via reflection.",
         );
     }
@@ -95,7 +98,7 @@ public function testReturnValueWhenInvokingInaccessibleMethod(): void
     {
         $this->assertSame(
             'value',
-            Assert::invokeMethod(new TestClass(), 'inaccessibleMethod'),
+            self::invokeMethod(new TestClass(), 'inaccessibleMethod'),
             "Should return 'value' when invoking the inaccessible method 'inaccessibleParentMethod' on 'TestClass' " .
             'via reflection.',
         );
@@ -108,7 +111,7 @@ public function testReturnValueWhenInvokingInaccessibleParentMethod(): void
     {
         $this->assertSame(
             'valueParent',
-            Assert::invokeParentMethod(
+            self::invokeParentMethod(
                 new TestClass(),
                 TestBaseClass::class,
                 'inaccessibleParentMethod',
@@ -125,11 +128,11 @@ public function testSetInaccessibleParentProperty(): void
     {
         $object = new TestClass();
 
-        Assert::setInaccessibleParentProperty($object, TestBaseClass::class, 'propertyParent', 'foo');
+        self::setInaccessibleParentProperty($object, TestBaseClass::class, 'propertyParent', 'foo');
 
         $this->assertSame(
             'foo',
-            Assert::inaccessibleParentProperty($object, TestBaseClass::class, 'propertyParent'),
+            self::inaccessibleParentProperty($object, TestBaseClass::class, 'propertyParent'),
             "Should return 'foo' after setting the parent property 'propertyParent' via " .
             "'setInaccessibleParentProperty' method.",
         );
@@ -142,11 +145,11 @@ public function testSetInaccessiblePropertySetsValueCorrectly(): void
     {
         $object = new TestClass();
 
-        Assert::setInaccessibleProperty($object, 'property', 'foo');
+        self::setInaccessibleProperty($object, 'property', 'foo');
 
         $this->assertSame(
             'foo',
-            Assert::inaccessibleProperty($object, 'property'),
+            self::inaccessibleProperty($object, 'property'),
             "Should return 'foo' after setting the private property 'property' via 'setInaccessibleProperty' method.",
         );
     }
@@ -156,6 +159,6 @@ public function testThrowRuntimeExceptionWhenRemoveFilesFromDirectoryNonExisting
         $this->expectException(RuntimeException::class);
         $this->expectExceptionMessage('Unable to open directory: non-existing-directory');
 
-        Assert::removeFilesFromDirectory(__DIR__ . '/non-existing-directory');
+        self::removeFilesFromDirectory(__DIR__ . '/non-existing-directory');
     }
 }