create-berna-stencil 1.0.8 → 1.0.10

package/src/api/vendor/phpmailer/phpmailer/test/PHPMailer/SetFromTest.php

@@ -0,0 +1,202 @@
+<?php
+
+/**
+ * PHPMailer - PHP email transport unit tests.
+ * PHP version 5.5.
+ *
+ * @author    Marcus Bointon <phpmailer@synchromedia.co.uk>
+ * @author    Andy Prevost
+ * @copyright 2012 - 2020 Marcus Bointon
+ * @copyright 2004 - 2009 Andy Prevost
+ * @license   https://www.gnu.org/licenses/old-licenses/lgpl-2.1.html GNU Lesser General Public License
+ */
+
+namespace PHPMailer\Test\PHPMailer;
+
+use PHPMailer\PHPMailer\Exception;
+use PHPMailer\PHPMailer\PHPMailer;
+use PHPMailer\Test\TestCase;
+
+/**
+ * Test setting the "from" address.
+ *
+ * @covers \PHPMailer\PHPMailer\PHPMailer::setFrom
+ */
+final class SetFromTest extends TestCase
+{
+    /**
+     * Test successfully setting the From, FromName and Sender properties.
+     *
+     * @dataProvider dataSetFromSuccess
+     *
+     * @param string $expected Expected function output.
+     * @param string $address  Email address input to pass to the function.
+     * @param string $name     Optional. Name input to pass to the function.
+     */
+    public function testSetFromSuccess($expected, $address, $name = '')
+    {
+        $result = $this->Mail->setFrom($address, $name);
+        self::assertTrue($result, 'setFrom failed');
+
+        self::assertSame($expected['From'], $this->Mail->From, 'From has not been set');
+        self::assertSame($expected['FromName'], $this->Mail->FromName, 'From name has not been set');
+        self::assertSame($expected['From'], $this->Mail->Sender, 'Sender has not been set');
+    }
+
+    /**
+     * Data provider.
+     *
+     * @return array
+     */
+    public function dataSetFromSuccess()
+    {
+        return [
+            'Email, no name' => [
+                'expected' => [
+                    'From'     => 'a@example.com',
+                    'FromName' => '',
+                ],
+                'address'  => 'a@example.com',
+            ],
+            'Email, no name; whitespace padding around email' => [
+                'expected' => [
+                    'From'     => 'whitespacepadding@example.com',
+                    'FromName' => '',
+                ],
+                'address'  => " \t  whitespacepadding@example.com   \n",
+            ],
+            'Email + name' => [
+                'expected' => [
+                    'From'     => 'a@example.com',
+                    'FromName' => 'some name',
+                ],
+                'address'  => 'a@example.com',
+                'name'     => 'some name',
+            ],
+            'Email + name; quotes in the name' => [
+                'expected' => [
+                    'From'     => 'bob@example.com',
+                    'FromName' => '"Bob\'s Burgers" (Bob\'s "Burgers")',
+                ],
+                'address'  => 'bob@example.com',
+                'name'     => '"Bob\'s Burgers" (Bob\'s "Burgers")',
+            ],
+            'Email + name; line breaks in name' => [
+                'expected' => [
+                    'From'     => 'removebreaks@example.com',
+                    'FromName' => 'somename',
+                ],
+                'address'  => 'removebreaks@example.com',
+                'name'     => "\r\nsome\r\nname\r\n",
+            ],
+            'Email + name; whitespace padding around name' => [
+                'expected' => [
+                    'From'     => 'a@example.com',
+                    'FromName' => 'some name',
+                ],
+                'address'  => 'a@example.com',
+                'name'     => "\t\tsome name    \r\n",
+            ],
+        ];
+    }
+
+    /**
+     * Test setting the From address, but not overruling the Sender value when the $auto parameter is set to false.
+     */
+    public function testSetFromDoesNotOverruleSenderWithAutoFalse()
+    {
+        $result = $this->Mail->setFrom('overruled@example.com', 'some name', false);
+
+        self::assertTrue($result, 'setFrom failed');
+        self::assertSame('', $this->Mail->Sender, 'Sender has been overruled');
+    }
+
+    /**
+     * Test setting the From address, but not overruling an existing, non-empty Sender value.
+     */
+    public function testSetFromDoesNotOverruleExistingSender()
+    {
+        $sender             = 'donotoverrule@example.com';
+        $this->Mail->Sender = $sender;
+
+        $result = $this->Mail->setFrom('overruled@example.com');
+
+        self::assertTrue($result, 'setFrom failed');
+        self::assertSame($sender, $this->Mail->Sender, 'Sender has been overruled');
+    }
+
+    /**
+     * Test unsuccessfully setting the From, FromName and Sender properties.
+     *
+     * @dataProvider dataSetFromFail
+     *
+     * @param string $address Email address input to pass to the function.
+     * @param string $name    Optional. Name input to pass to the function.
+     */
+    public function testSetFromFail($address, $name = '')
+    {
+        // Get the original, default values from the class.
+        $expectedFrom     = $this->Mail->From;
+        $expectedFromName = $this->Mail->FromName;
+
+        $result = $this->Mail->setFrom($address, $name);
+        self::assertFalse($result, 'setFrom did not fail');
+        self::assertTrue($this->Mail->isError(), 'Error count not incremented');
+
+        self::assertSame($expectedFrom, $this->Mail->From, 'From has been overruled');
+        self::assertSame($expectedFromName, $this->Mail->FromName, 'From name has been overruled');
+        self::assertSame('', $this->Mail->Sender, 'Sender has been overruled');
+    }
+
+    /**
+     * Test that setting an invalid email address results in an exception.
+     *
+     * @dataProvider dataSetFromFail
+     *
+     * @param string $address Email address input to pass to the function.
+     * @param string $name    Optional. Name input to pass to the function.
+     */
+    public function testInvalidAddressException($address, $name = '')
+    {
+        $this->expectException(Exception::class);
+        $this->expectExceptionMessage('Invalid address:  (From):');
+
+        $mail = new PHPMailer(true);
+        $mail->setFrom($address, $name);
+    }
+
+    /**
+     * Data provider.
+     *
+     * @return array
+     */
+    public function dataSetFromFail()
+    {
+        return [
+            'Invalid email address' => [
+                'address' => 'a@example.com.',
+                'name'    => 'some name',
+            ],
+            'Not an email address: missing @ sign' => [
+                'address' => 'example.com',
+            ],
+            'Not an email address: nothing after the @ sign' => [
+                'address' => 'example@',
+            ],
+        ];
+    }
+
+    /**
+     * Test unsuccessfully setting the From, FromName and Sender properties when an email address
+     * containing an 8bit character is passed and either the MbString or the Intl extension are
+     * not available.
+     */
+    public function testSetFromFailsOn8BitCharInDomainWithoutOptionalExtensions()
+    {
+        if (extension_loaded('mbstring') && function_exists('idn_to_ascii')) {
+            self::markTestSkipped('Test requires MbString and/or Intl *not* to be available');
+        }
+
+        $this->testSetFromFail("8bit@ex\x80mple.com");
+    }
+}

package/src/api/vendor/phpmailer/phpmailer/test/PHPMailer/SetTest.php

@@ -0,0 +1,81 @@
+<?php
+
+/**
+ * PHPMailer - PHP email transport unit tests.
+ * PHP version 5.5.
+ *
+ * @author    Marcus Bointon <phpmailer@synchromedia.co.uk>
+ * @author    Andy Prevost
+ * @copyright 2012 - 2020 Marcus Bointon
+ * @copyright 2004 - 2009 Andy Prevost
+ * @license   https://www.gnu.org/licenses/old-licenses/lgpl-2.1.html GNU Lesser General Public License
+ */
+
+namespace PHPMailer\Test\PHPMailer;
+
+use PHPMailer\Test\TestCase;
+
+/**
+ * Test property setting functionality.
+ *
+ * @covers \PHPMailer\PHPMailer\PHPMailer::set
+ */
+final class SetTest extends TestCase
+{
+    /**
+     * Test setting the value of a class property.
+     *
+     * @dataProvider dataSetValidProperty
+     *
+     * @param string $name  The property name to set
+     * @param mixed  $value The value to set the property to
+     */
+    public function testSetValidProperty($name, $value)
+    {
+        self::assertTrue($this->Mail->set($name, $value), 'Valid property set failed');
+    }
+
+    /**
+     * Data provider.
+     *
+     * @return array
+     */
+    public function dataSetValidProperty()
+    {
+        return [
+            'Valid: property exists, public' => [
+                'name'  => 'Timeout',
+                'value' => '11',
+            ],
+            'Valid: property exists, protected' => [
+                'name'  => 'MIMEBody',
+                'value' => 'Some text',
+            ],
+            // Note: no test for private property as the PHPMailer class doesn't have any.
+        ];
+    }
+
+    /**
+     * Test setting a property to `null` and then resetting it to a non-null value.
+     */
+    public function testTogglingPropertyValueAwayFromNull()
+    {
+        self::assertTrue($this->Mail->set('AllowEmpty', null), 'Null property set failed');
+        self::assertTrue($this->Mail->set('AllowEmpty', false), 'Valid property set of null property failed');
+    }
+
+    /**
+     * Test setting the value of a class property which doesn't exist.
+     */
+    public function testSetInvalidProperty()
+    {
+        self::assertFalse($this->Mail->set('x', 'y'), 'Invalid property set succeeded');
+
+        // Verify that an error has been registered.
+        self::assertSame(
+            'Cannot set or reset variable: x',
+            $this->Mail->ErrorInfo,
+            'Error info not correctly registered'
+        );
+    }
+}

package/src/api/vendor/phpmailer/phpmailer/test/PHPMailer/SetWordWrapTest.php

@@ -0,0 +1,120 @@
+<?php
+
+/**
+ * PHPMailer - PHP email transport unit tests.
+ * PHP version 5.5.
+ *
+ * @author    Marcus Bointon <phpmailer@synchromedia.co.uk>
+ * @author    Andy Prevost
+ * @copyright 2012 - 2020 Marcus Bointon
+ * @copyright 2004 - 2009 Andy Prevost
+ * @license   https://www.gnu.org/licenses/old-licenses/lgpl-2.1.html GNU Lesser General Public License
+ */
+
+namespace PHPMailer\Test\PHPMailer;
+
+use PHPMailer\Test\PreSendTestCase;
+
+/**
+ * Test automatic wordwrap functionality.
+ *
+ * @covers \PHPMailer\PHPMailer\PHPMailer::setWordWrap
+ * @covers \PHPMailer\PHPMailer\PHPMailer::wrapText
+ */
+final class SetWordWrapTest extends PreSendTestCase
+{
+    /**
+     * Test word-wrapping a message.
+     *
+     * @dataProvider dataWordWrap
+     *
+     * @param int    $wrapAt        The number of characters to wrap at.
+     * @param string $message       The message to use.
+     * @param string $subjectSuffix Subject suffix to use.
+     */
+    public function testWordWrap($wrapAt, $message, $subjectSuffix)
+    {
+        $this->Mail->WordWrap = $wrapAt;
+        $my_body = str_repeat($message, 10);
+        $nBodyLen = strlen($my_body);
+        $my_body .= "\n\nThis is the above body length: " . $nBodyLen;
+
+        $this->Mail->Body = $my_body;
+        $this->Mail->Subject .= ': ' . $subjectSuffix;
+
+        $this->buildBody();
+        $originalLines = explode("\n", $this->Mail->Body);
+        $this->Mail->preSend();
+
+        $lines = explode("\n", $this->Mail->Body);
+        self::assertGreaterThanOrEqual(
+            count($originalLines),
+            count($lines),
+            'Line count of message less than expected'
+        );
+
+        foreach ($lines as $i => $line) {
+            self::assertLessThanOrEqual(
+                $wrapAt,
+                strlen(trim($line)),
+                'Character count for line ' . ($i + 1) . ' does not comply with the expected ' . $wrapAt
+                . ' characters.' . PHP_EOL . 'Line contents: "' . $line . '"'
+            );
+        }
+    }
+
+    /**
+     * Data provider.
+     *
+     * @return array
+     */
+    public function dataWordWrap()
+    {
+        return [
+            'ascii message' => [
+                'wrapAt'        => 40,
+                'message'       => 'Here is the main body of this message.  It should ' .
+                    'be quite a few lines.  It should be wrapped at ' .
+                    '40 characters.  Make sure that it is. ',
+                'subjectSuffix' => 'Wordwrap',
+            ],
+            'multibyte message' => [
+                'wrapAt'        => 40,
+                'message'       => '飛兒樂 團光茫 飛兒樂 團光茫 飛兒樂 團光茫 飛兒樂 團光茫 ' .
+                    '飛飛兒樂 團光茫兒樂 團光茫飛兒樂 團光飛兒樂 團光茫飛兒樂 團光茫兒樂 團光茫 ' .
+                    '飛兒樂 團光茫飛兒樂 團飛兒樂 團光茫光茫飛兒樂 團光茫. ',
+                'subjectSuffix' => 'Wordwrap multibyte',
+            ],
+        ];
+    }
+
+    /**
+     * Test explicitly NOT word-wrapping a message.
+     */
+    public function testNoWordWrap()
+    {
+        $this->Mail->WordWrap = 0;
+        $my_body = str_repeat('Irrelevant text, we\'re not wrapping', 10);
+        $nBodyLen = strlen($my_body);
+        $my_body .= "\n\nLong unwrapped message: " . $nBodyLen;
+
+        $this->Mail->Body = $my_body;
+        $this->Mail->Subject .= ': No wordwrap';
+
+        $this->buildBody();
+        $originalLines = explode("\n", $this->Mail->Body);
+        $this->Mail->preSend();
+
+        $lines = explode("\n", $this->Mail->Body);
+        self::assertSameSize($originalLines, $lines, 'Line count of message has changed');
+
+        foreach ($lines as $i => $line) {
+            self::assertSame(
+                $originalLines[$i],
+                $line,
+                'Line ' . ($i + 1) . ' has been changed while it shouldn\'t have been'
+                    . PHP_EOL . 'Line contents: "' . $originalLines[$i] . '"'
+            );
+        }
+    }
+}

package/src/api/vendor/phpmailer/phpmailer/test/PHPMailer/Utf8CharBoundaryTest.php

@@ -0,0 +1,66 @@
+<?php
+
+/**
+ * PHPMailer - PHP email transport unit tests.
+ * PHP version 5.5.
+ *
+ * @author    Marcus Bointon <phpmailer@synchromedia.co.uk>
+ * @author    Andy Prevost
+ * @copyright 2012 - 2020 Marcus Bointon
+ * @copyright 2004 - 2009 Andy Prevost
+ * @license   https://www.gnu.org/licenses/old-licenses/lgpl-2.1.html GNU Lesser General Public License
+ */
+
+namespace PHPMailer\Test\PHPMailer;
+
+use PHPMailer\Test\TestCase;
+
+/**
+ * Test UTF8 character boundary functionality.
+ *
+ * @covers \PHPMailer\PHPMailer\PHPMailer::utf8CharBoundary
+ *
+ * @todo Add more testcases to properly cover all paths in the method!
+ */
+final class Utf8CharBoundaryTest extends TestCase
+{
+    /**
+     * Verify that the utf8CharBoundary() returns the correct last character boundary for encoded text.
+     *
+     * @dataProvider dataUtf8CharBoundary
+     *
+     * @param string $encodedText UTF-8 QP text to use as input string.
+     * @param int    $maxLength   Max length to pass to the function.
+     * @param int    $expected    Expected function output.
+     */
+    public function testUtf8CharBoundary($encodedText, $maxLength, $expected)
+    {
+        $this->assertSame($expected, $this->Mail->utf8CharBoundary($encodedText, $maxLength));
+    }
+
+    /**
+     * Data provider.
+     *
+     * @return array
+     */
+    public function dataUtf8CharBoundary()
+    {
+        return [
+            'Encoded word with multibyte char first byte' => [
+                'encodedText' => 'H=E4tten',
+                'maxLength'   => 3,
+                'expected'    => 1,
+            ],
+            'Encoded single byte char' => [
+                'encodedText' => '=0C',
+                'maxLength'   => 3,
+                'expected'    => 3,
+            ],
+            'Encoded word with multi byte char middle byte' => [
+                'encodedText' => 'L=C3=B6rem',
+                'maxLength'   => 6,
+                'expected'    => 1,
+            ],
+        ];
+    }
+}

package/src/api/vendor/phpmailer/phpmailer/test/PHPMailer/ValidateAddressCustomValidatorTest.php

@@ -0,0 +1,116 @@
+<?php
+
+/**
+ * PHPMailer - PHP email transport unit tests.
+ * PHP version 5.5.
+ *
+ * @author    Marcus Bointon <phpmailer@synchromedia.co.uk>
+ * @author    Andy Prevost
+ * @copyright 2012 - 2020 Marcus Bointon
+ * @copyright 2004 - 2009 Andy Prevost
+ * @license   https://www.gnu.org/licenses/old-licenses/lgpl-2.1.html GNU Lesser General Public License
+ */
+
+namespace PHPMailer\Test\PHPMailer;
+
+use PHPMailer\PHPMailer\PHPMailer;
+use PHPMailer\Test\TestCase;
+
+/**
+ * Test email address validation using a custom validator.
+ *
+ * @covers \PHPMailer\PHPMailer\PHPMailer::validateAddress
+ */
+final class ValidateAddressCustomValidatorTest extends TestCase
+{
+    /**
+     * Test injecting a one-off custom validator.
+     */
+    public function testOneOffCustomValidator()
+    {
+        $callback = static function ($address) {
+            return strpos($address, '@') !== false;
+        };
+
+        self::assertTrue(
+            PHPMailer::validateAddress('user@example.com', $callback),
+            'Custom validator false negative'
+        );
+        self::assertFalse(
+            PHPMailer::validateAddress('userexample.com', $callback),
+            'Custom validator false positive'
+        );
+    }
+
+    /**
+     * Test setting the default validator to an injected function.
+     */
+    public function testSetDefaultValidatorToCustom()
+    {
+        // Set the default validator to an injected function.
+        PHPMailer::$validator = static function ($address) {
+            return 'user@example.com' === $address;
+        };
+
+        self::assertTrue(
+            $this->Mail->addAddress('user@example.com'),
+            'Custom default validator false negative'
+        );
+
+        // Need to pick a failing value which would pass all other validators
+        // to be sure we're using our custom one.
+        self::assertFalse(
+            $this->Mail->addAddress('bananas@example.com'),
+            'Custom default validator false positive'
+        );
+
+        // Set validator back to default
+        PHPMailer::$validator = 'php';
+
+        // This is a valid address that FILTER_VALIDATE_EMAIL thinks is invalid.
+        self::assertFalse(
+            $this->Mail->addAddress('first.last@example.123'),
+            'PHP validator not behaving as expected'
+        );
+    }
+
+    /**
+     * Test denying function name callables as validators.
+     *
+     * See SECURITY.md and CVE-2021-3603.
+     *
+     * @dataProvider dataRejectCallables
+     *
+     * @param string $callback Callback function name.
+     * @param string $message  Message to display if the test would fail.
+     */
+    public function testRejectCallables($callback, $message)
+    {
+        require_once \PHPMAILER_INCLUDE_DIR . '/test/validators.php';
+
+        self::assertTrue(PHPMailer::validateAddress('test@example.com', $callback), $message);
+    }
+
+    /**
+     * Data provider.
+     *
+     * @return array
+     */
+    public function dataRejectCallables()
+    {
+        return [
+            // If a `php` function defined in validators.php successfully overrides this built-in validator name,
+            // this would return false - and we don't want to allow that.
+            'php'  => [
+                'callback' => 'php',
+                'message'  => 'Build-in php validator overridden',
+            ],
+            // Check that a non-existent validator name falls back to a built-in validator
+            // and does not call a global function with that name.
+            'phpx' => [
+                'callback' => 'phpx',
+                'message'  => 'Global function called instead of default validator',
+            ],
+        ];
+    }
+}