Changeset 51840 for branches/5.6/tests/phpunit/includes/testcase.php

Timestamp:

09/21/2021 07:29:38 PM (3 years ago)

Author:

desrosj

Message:

Build/Test Tools: Introduce the PHPUnit Polyfills package for easier cross branch testing.

This backports the PHPUnit Polyfills package and related test infrastructure changes to make it easier for developers to continue testing on multiple versions WordPress while adding tests for newer versions of PHP, which require more modern PHPUnit practices.

One of the changes included is the addition of wrappers for the new snake_case fixture methods in PHPUnit. This allows the native camelCase standard in PHPUnit to be used, but allows for developers to transition to the new naming conventions.

Props hellofromTonya, jrf, SergeyBiryukov, johnbillion, netweb, schlessera, jeherve, lucatume, desrosj.
Merges [51559,51560,51810-51813,51828] to the 5.6 branch.
See #53911.

Location:

branches/5.6

Files:

• . (modified) (1 prop)
• tests/phpunit/includes/testcase.php (modified) (2 diffs)

branches/5.6/tests/phpunit/includes/testcase.php

@@ -1 +1 @@
 <?php
+
+use Yoast\PHPUnitPolyfills\Helpers\AssertAttributeHelper;
+use Yoast\PHPUnitPolyfills\Polyfills\AssertClosedResource;
+use Yoast\PHPUnitPolyfills\Polyfills\AssertEqualsSpecializations;
+use Yoast\PHPUnitPolyfills\Polyfills\AssertFileDirectory;
+use Yoast\PHPUnitPolyfills\Polyfills\AssertFileEqualsSpecializations;
+use Yoast\PHPUnitPolyfills\Polyfills\AssertionRenames;
+use Yoast\PHPUnitPolyfills\Polyfills\AssertIsType;
+use Yoast\PHPUnitPolyfills\Polyfills\AssertNumericType;
+use Yoast\PHPUnitPolyfills\Polyfills\AssertObjectEquals;
+use Yoast\PHPUnitPolyfills\Polyfills\AssertStringContains;
+use Yoast\PHPUnitPolyfills\Polyfills\EqualToSpecializations;
+use Yoast\PHPUnitPolyfills\Polyfills\ExpectException;
+use Yoast\PHPUnitPolyfills\Polyfills\ExpectExceptionMessageMatches;
+use Yoast\PHPUnitPolyfills\Polyfills\ExpectExceptionObject;
+use Yoast\PHPUnitPolyfills\Polyfills\ExpectPHPException;
 
 require_once __DIR__ . '/abstract-testcase.php';
@@ -14 +30 @@
 class WP_UnitTestCase extends WP_UnitTestCase_Base {
 
+    use AssertAttributeHelper;
+    use AssertClosedResource;
+    use AssertEqualsSpecializations;
+    use AssertFileDirectory;
+    use AssertFileEqualsSpecializations;
+    use AssertionRenames;
+    use AssertIsType;
+    use AssertNumericType;
+    use AssertObjectEquals;
+    use AssertStringContains;
+    use EqualToSpecializations;
+    use ExpectException;
+    use ExpectExceptionMessageMatches;
+    use ExpectExceptionObject;
+    use ExpectPHPException;
+
     /**
-     * Asserts that two variables are equal (with delta).
-     *
-     * This method has been backported from a more recent PHPUnit version,
-     * as tests running on PHP 5.6 use PHPUnit 5.7.x.
-     *
-     * @since 5.6.0
-     *
-     * @param mixed  $expected First value to compare.
-     * @param mixed  $actual   Second value to compare.
-     * @param float  $delta    Allowed numerical distance between two values to consider them equal.
-     * @param string $message  Optional. Message to display when the assertion fails.
-     *
-     * @throws ExpectationFailedException
-     * @throws \SebastianBergmann\RecursionContext\InvalidArgumentException
+     * Wrapper method for the `setUpBeforeClass()` method for forward-compatibility with WP 5.9.
      */
-    public static function assertEqualsWithDelta( $expected, $actual, $delta, $message = '' ) {
-        $constraint = new PHPUnit_Framework_Constraint_IsEqual(
-            $expected,
-            $delta
-        );
+    public static function set_up_before_class() {
+        static::setUpBeforeClass();
+    }
 
-        static::assertThat( $actual, $constraint, $message );
+    /**
+     * Wrapper method for the `tearDownAfterClass()` method for forward-compatibility with WP 5.9.
+     */
+    public static function tear_down_after_class() {
+        static::tearDownAfterClass();
+    }
+
+    /**
+     * Wrapper method for the `setUp()` method for forward-compatibility with WP 5.9.
+     */
+    public function set_up() {
+        static::setUp();
+    }
+
+    /**
+     * Wrapper method for the `tearDown()` method for forward-compatibility with WP 5.9.
+     */
+    public function tear_down() {
+        static::tearDown();
     }
 }