Chris@4: <?php
Chris@4: 
Chris@4: namespace Drupal\Tests\Component\Utility;
Chris@4: 
Chris@4: use Drupal\Component\Utility\Mail;
Chris@4: use PHPUnit\Framework\TestCase;
Chris@4: 
Chris@4: /**
Chris@4:  * Test mail helpers implemented in Mail component.
Chris@4:  *
Chris@4:  * @group Utility
Chris@4:  *
Chris@4:  * @coversDefaultClass \Drupal\Component\Utility\Mail
Chris@4:  */
Chris@4: class MailTest extends TestCase {
Chris@4: 
Chris@4:   /**
Chris@4:    * Tests RFC-2822 'display-name' formatter.
Chris@4:    *
Chris@4:    * @dataProvider providerTestDisplayName
Chris@4:    * @covers ::formatDisplayName
Chris@4:    */
Chris@4:   public function testFormatDisplayName($string, $safe_display_name) {
Chris@4:     $this->assertEquals($safe_display_name, Mail::formatDisplayName($string));
Chris@4:   }
Chris@4: 
Chris@4:   /**
Chris@4:    * Data provider for testFormatDisplayName().
Chris@4:    *
Chris@4:    * @see testFormatDisplayName()
Chris@4:    *
Chris@4:    * @return array
Chris@4:    *   An array containing a string and its 'display-name' safe value.
Chris@4:    */
Chris@4:   public function providerTestDisplayName() {
Chris@4:     return [
Chris@4:       // Simple ASCII characters.
Chris@4:       ['Test site', 'Test site'],
Chris@4:       // ASCII with html entity.
Chris@4:       ['Test &amp; site', 'Test & site'],
Chris@4:       // Non-ASCII characters.
Chris@4:       ['Tést site', '=?UTF-8?B?VMOpc3Qgc2l0ZQ==?='],
Chris@4:       // Non-ASCII with special characters.
Chris@4:       ['Tést; site', '=?UTF-8?B?VMOpc3Q7IHNpdGU=?='],
Chris@4:       // Non-ASCII with html entity.
Chris@4:       ['T&eacute;st; site', '=?UTF-8?B?VMOpc3Q7IHNpdGU=?='],
Chris@4:       // ASCII with special characters.
Chris@4:       ['Test; site', '"Test; site"'],
Chris@4:       // ASCII with special characters as html entity.
Chris@4:       ['Test &lt; site', '"Test < site"'],
Chris@4:       // ASCII with special characters and '\'.
Chris@4:       ['Test; \ "site"', '"Test; \\\\ \"site\""'],
Chris@4:       // String already RFC-2822 compliant.
Chris@4:       ['"Test; site"', '"Test; site"'],
Chris@4:       // String already RFC-2822 compliant.
Chris@4:       ['"Test; \\\\ \"site\""', '"Test; \\\\ \"site\""'],
Chris@4:     ];
Chris@4:   }
Chris@4: 
Chris@4: }