Chris@0: <?php
Chris@0: 
Chris@0: namespace Drupal\KernelTests;
Chris@0: 
Chris@0: /**
Chris@0:  * Translates Simpletest assertion methods to PHPUnit.
Chris@0:  *
Chris@0:  * Protected methods are custom. Public static methods override methods of
Chris@0:  * \PHPUnit\Framework\Assert.
Chris@0:  *
Chris@18:  * Deprecated Scheduled for removal in Drupal 10.0.0. Use PHPUnit's native
Chris@0:  *   assert methods instead.
Chris@18:  *
Chris@18:  * @todo https://www.drupal.org/project/drupal/issues/3031580 Note that
Chris@18:  *   deprecations in this file do not use the @ symbol in Drupal 8 because this
Chris@18:  *   will be removed in Drupal 10.0.0.
Chris@0:  */
Chris@0: trait AssertLegacyTrait {
Chris@0: 
Chris@0:   /**
Chris@0:    * @see \Drupal\simpletest\TestBase::assert()
Chris@0:    *
Chris@18:    * Deprecated Scheduled for removal in Drupal 10.0.0. Use self::assertTrue()
Chris@0:    *   instead.
Chris@0:    */
Chris@0:   protected function assert($actual, $message = '') {
Chris@0:     parent::assertTrue((bool) $actual, $message);
Chris@0:   }
Chris@0: 
Chris@0:   /**
Chris@0:    * @see \Drupal\simpletest\TestBase::assertTrue()
Chris@0:    */
Chris@0:   public static function assertTrue($actual, $message = '') {
Chris@0:     if (is_bool($actual)) {
Chris@0:       parent::assertTrue($actual, $message);
Chris@0:     }
Chris@0:     else {
Chris@0:       parent::assertNotEmpty($actual, $message);
Chris@0:     }
Chris@0:   }
Chris@0: 
Chris@0:   /**
Chris@0:    * @see \Drupal\simpletest\TestBase::assertFalse()
Chris@0:    */
Chris@0:   public static function assertFalse($actual, $message = '') {
Chris@0:     if (is_bool($actual)) {
Chris@0:       parent::assertFalse($actual, $message);
Chris@0:     }
Chris@0:     else {
Chris@0:       parent::assertEmpty($actual, $message);
Chris@0:     }
Chris@0:   }
Chris@0: 
Chris@0:   /**
Chris@0:    * @see \Drupal\simpletest\TestBase::assertEqual()
Chris@0:    *
Chris@18:    * Deprecated Scheduled for removal in Drupal 10.0.0. Use self::assertEquals()
Chris@0:    *   instead.
Chris@0:    */
Chris@0:   protected function assertEqual($actual, $expected, $message = '') {
Chris@0:     $this->assertEquals($expected, $actual, $message);
Chris@0:   }
Chris@0: 
Chris@0:   /**
Chris@0:    * @see \Drupal\simpletest\TestBase::assertNotEqual()
Chris@0:    *
Chris@18:    * Deprecated Scheduled for removal in Drupal 10.0.0. Use
Chris@0:    *   self::assertNotEquals() instead.
Chris@0:    */
Chris@0:   protected function assertNotEqual($actual, $expected, $message = '') {
Chris@0:     $this->assertNotEquals($expected, $actual, $message);
Chris@0:   }
Chris@0: 
Chris@0:   /**
Chris@0:    * @see \Drupal\simpletest\TestBase::assertIdentical()
Chris@0:    *
Chris@18:    * Deprecated Scheduled for removal in Drupal 10.0.0. Use self::assertSame()
Chris@0:    *   instead.
Chris@0:    */
Chris@0:   protected function assertIdentical($actual, $expected, $message = '') {
Chris@0:     $this->assertSame($expected, $actual, $message);
Chris@0:   }
Chris@0: 
Chris@0:   /**
Chris@0:    * @see \Drupal\simpletest\TestBase::assertNotIdentical()
Chris@0:    *
Chris@18:    * Deprecated Scheduled for removal in Drupal 10.0.0. Use
Chris@0:    *   self::assertNotSame() instead.
Chris@0:    */
Chris@0:   protected function assertNotIdentical($actual, $expected, $message = '') {
Chris@0:     $this->assertNotSame($expected, $actual, $message);
Chris@0:   }
Chris@0: 
Chris@0:   /**
Chris@0:    * @see \Drupal\simpletest\TestBase::assertIdenticalObject()
Chris@0:    *
Chris@18:    * Deprecated Scheduled for removal in Drupal 10.0.0. Use self::assertEquals()
Chris@0:    *   instead.
Chris@0:    */
Chris@0:   protected function assertIdenticalObject($actual, $expected, $message = '') {
Chris@0:     // Note: ::assertSame checks whether its the same object. ::assertEquals
Chris@0:     // though compares
Chris@0: 
Chris@0:     $this->assertEquals($expected, $actual, $message);
Chris@0:   }
Chris@0: 
Chris@0:   /**
Chris@0:    * @see \Drupal\simpletest\TestBase::pass()
Chris@0:    *
Chris@18:    * Deprecated Scheduled for removal in Drupal 10.0.0. Use self::assertTrue()
Chris@0:    *   instead.
Chris@0:    */
Chris@0:   protected function pass($message) {
Chris@0:     $this->assertTrue(TRUE, $message);
Chris@0:   }
Chris@0: 
Chris@0:   /**
Chris@0:    * @see \Drupal\simpletest\TestBase::verbose()
Chris@0:    */
Chris@0:   protected function verbose($message) {
Chris@0:     if (in_array('--debug', $_SERVER['argv'], TRUE)) {
Chris@0:       // Write directly to STDOUT to not produce unexpected test output.
Chris@0:       // The STDOUT stream does not obey output buffering.
Chris@0:       fwrite(STDOUT, $message . "\n");
Chris@0:     }
Chris@0:   }
Chris@0: 
Chris@0: }