create-berna-stencil 1.0.9 → 1.0.10

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

@@ -0,0 +1,221 @@
+<?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\DSNConfigurator;
+use PHPMailer\PHPMailer\Exception;
+use PHPMailer\PHPMailer\PHPMailer;
+use PHPMailer\PHPMailer\SMTP;
+use PHPMailer\Test\TestCase;
+
+/**
+ * Test configuring with DSN.
+ *
+ * @covers \PHPMailer\PHPMailer\DSNConfigurator
+ */
+final class DSNConfiguratorTest extends TestCase
+{
+    /**
+     * Test throwing exception if DSN is invalid.
+     */
+    public function testInvalidDSN()
+    {
+        $configurator = new DSNConfigurator();
+
+        $this->expectException(Exception::class);
+        $this->expectExceptionMessage('Malformed DSN');
+
+        $configurator->configure($this->Mail, 'localhost');
+    }
+
+    /**
+     * Test throwing exception if DSN scheme is invalid.
+     */
+    public function testInvalidScheme()
+    {
+        $configurator = new DSNConfigurator();
+
+        $this->expectException(Exception::class);
+        $this->expectExceptionMessage('Invalid scheme: "ftp".');
+
+        $configurator->configure($this->Mail, 'ftp://localhost');
+    }
+
+    /**
+     * Test cofiguring mail.
+     */
+    public function testConfigureMail()
+    {
+        $configurator = new DSNConfigurator();
+
+        $configurator->configure($this->Mail, 'mail://localhost');
+
+        self::assertEquals($this->Mail->Mailer, 'mail');
+    }
+
+    /**
+     * Test cofiguring sendmail.
+     */
+    public function testConfigureSendmail()
+    {
+        $configurator = new DSNConfigurator();
+
+        $configurator->configure($this->Mail, 'sendmail://localhost');
+
+        self::assertEquals($this->Mail->Mailer, 'sendmail');
+    }
+
+    /**
+     * Test cofiguring qmail.
+     */
+    public function testConfigureQmail()
+    {
+        $configurator = new DSNConfigurator();
+
+        $configurator->configure($this->Mail, 'qmail://localhost');
+
+        self::assertEquals($this->Mail->Mailer, 'qmail');
+    }
+
+    /**
+     * Test cofiguring SMTP without authentication.
+     */
+    public function testConfigureSmtpWithoutAuthentication()
+    {
+        $configurator = new DSNConfigurator();
+
+        $configurator->configure($this->Mail, 'smtp://localhost');
+
+        self::assertEquals($this->Mail->Mailer, 'smtp');
+        self::assertEquals($this->Mail->Host, 'localhost');
+        self::assertFalse($this->Mail->SMTPAuth);
+    }
+
+    /**
+     * Test cofiguring SMTP with authentication.
+     */
+    public function testConfigureSmtpWithAuthentication()
+    {
+        $configurator = new DSNConfigurator();
+
+        $configurator->configure($this->Mail, 'smtp://user:pass@remotehost');
+
+        self::assertEquals($this->Mail->Mailer, 'smtp');
+        self::assertEquals($this->Mail->Host, 'remotehost');
+
+        self::assertTrue($this->Mail->SMTPAuth);
+        self::assertEquals($this->Mail->Username, 'user');
+        self::assertEquals($this->Mail->Password, 'pass');
+    }
+
+    /**
+     * Test cofiguring SMTP without port.
+     */
+    public function testConfigureSmtpWithoutPort()
+    {
+        $configurator = new DSNConfigurator();
+
+        $configurator->configure($this->Mail, 'smtp://localhost');
+
+        self::assertEquals($this->Mail->Mailer, 'smtp');
+        self::assertEquals($this->Mail->Host, 'localhost');
+        self::assertEquals($this->Mail->Port, SMTP::DEFAULT_PORT);
+    }
+
+    /**
+     * Test cofiguring SMTP with port.
+     */
+    public function testConfigureSmtpWitPort()
+    {
+        $configurator = new DSNConfigurator();
+
+        $configurator->configure($this->Mail, 'smtp://localhost:2525');
+
+        self::assertEquals($this->Mail->Mailer, 'smtp');
+        self::assertEquals($this->Mail->Host, 'localhost');
+        self::assertEquals($this->Mail->Port, 2525);
+    }
+
+    /**
+     * Test cofiguring SMTPs without port.
+     */
+    public function testConfigureSmtpsWithoutPort()
+    {
+        $configurator = new DSNConfigurator();
+
+        $configurator->configure($this->Mail, 'smtps://user:pass@remotehost');
+
+        self::assertEquals($this->Mail->Mailer, 'smtp');
+        self::assertEquals($this->Mail->SMTPSecure, PHPMailer::ENCRYPTION_STARTTLS);
+
+        self::assertEquals($this->Mail->Host, 'remotehost');
+        self::assertEquals($this->Mail->Port, SMTP::DEFAULT_SECURE_PORT);
+
+        self::assertTrue($this->Mail->SMTPAuth);
+        self::assertEquals($this->Mail->Username, 'user');
+        self::assertEquals($this->Mail->Password, 'pass');
+    }
+
+    /**
+     * Test cofiguring SMTPs with port.
+     */
+    public function testConfigureWithUnknownOption()
+    {
+        $configurator = new DSNConfigurator();
+
+        $this->expectException(Exception::class);
+        $this->expectExceptionMessage('Unknown option: "UnknownOption".');
+
+        $configurator->configure($this->Mail, 'mail://locahost?UnknownOption=Value');
+    }
+
+    /**
+     * Test cofiguring options with query sting.
+     */
+    public function testConfigureWithOptions()
+    {
+        $configurator = new DSNConfigurator();
+
+        $configurator->configure(
+            $this->Mail,
+            'sendmail://localhost?Sendmail=/usr/local/bin/sendmail&AllowEmpty=1&WordWrap=78'
+        );
+
+        self::assertEquals($this->Mail->Mailer, 'sendmail');
+        self::assertEquals($this->Mail->Sendmail, '/usr/local/bin/sendmail');
+        self::assertEquals($this->Mail->AllowEmpty, true);
+        self::assertEquals($this->Mail->WordWrap, 78);
+    }
+
+    /**
+     * Test shortcut.
+     */
+    public function testShortcut()
+    {
+        $mailer = DSNConfigurator::mailer('smtps://user@gmail.com:secret@smtp.gmail.com?SMTPDebug=3&Timeout=1000');
+
+        self::assertEquals($mailer->Mailer, 'smtp');
+        self::assertEquals($mailer->SMTPSecure, PHPMailer::ENCRYPTION_STARTTLS);
+
+        self::assertEquals($mailer->Host, 'smtp.gmail.com');
+        self::assertEquals($mailer->Port, SMTP::DEFAULT_SECURE_PORT);
+
+        self::assertTrue($mailer->SMTPAuth);
+        self::assertEquals($mailer->Username, 'user@gmail.com');
+        self::assertEquals($mailer->Password, 'secret');
+
+        self::assertEquals($mailer->SMTPDebug, 3);
+        self::assertEquals($mailer->Timeout, 1000);
+    }
+}

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

@@ -0,0 +1,110 @@
+<?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 encoding a string using Q encoding functionality.
+ *
+ * @covers \PHPMailer\PHPMailer\PHPMailer::encodeQ
+ */
+final class EncodeQTest extends TestCase
+{
+    /**
+     * Test encoding a string using Q encoding.
+     *
+     * @dataProvider dataEncodeQ
+     *
+     * @param string $input    The text to encode.
+     * @param string $expected The expected function return value.
+     * @param string $position Optional. Input for the position parameter.
+     * @param string $charset  Optional. The charset to use.
+     */
+    public function testEncodeQ($input, $expected, $position = null, $charset = null)
+    {
+        if (isset($charset)) {
+            $this->Mail->CharSet = $charset;
+        }
+
+        if (isset($position)) {
+            $result = $this->Mail->encodeQ($input, $position);
+        } else {
+            $result = $this->Mail->encodeQ($input);
+        }
+
+        self::assertSame($expected, $result);
+    }
+
+    /**
+     * Data provider.
+     *
+     * @return array
+     */
+    public function dataEncodeQ()
+    {
+        return [
+            'Encode for text; char encoding default (iso88591)' => [
+                'input'    => "\xa1Hola! Se\xf1or!",
+                'expected' => '=A1Hola!_Se=F1or!',
+                'position' => 'text',
+            ],
+            'Encode for TEXT (uppercase); char encoding default (iso88591)' => [
+                'input'    => "\xa1Hola! Se\xf1or!",
+                'expected' => '=A1Hola!_Se=F1or!',
+                'position' => 'TEXT',
+            ],
+            'Encode for comment; char encoding default (iso88591)' => [
+                'input'    => "\xa1Hola! Se\xf1or!",
+                'expected' => '=A1Hola!_Se=F1or!',
+                'position' => 'comment',
+            ],
+            'Encode for Phrase (mixed case); char encoding default (iso88591)' => [
+                'input'    => "\xa1Hola! Se\xf1or!",
+                'expected' => '=A1Hola!_Se=F1or!',
+                'position' => 'Phrase',
+            ],
+            'Encode for text; char encoding explicit: utf-8' => [
+                'input'    => "\xc2\xa1Hola! Se\xc3\xb1or!",
+                'expected' => '=C2=A1Hola!_Se=C3=B1or!',
+                'position' => 'text',
+                'charset'  => PHPMailer::CHARSET_UTF8,
+            ],
+            'Encode for text; char encoding explicit: utf-8; string contains "=" character' => [
+                'input'    => "Nov\xc3\xa1=",
+                'expected' => 'Nov=C3=A1=3D',
+                'position' => 'text',
+                'charset'  => PHPMailer::CHARSET_UTF8,
+            ],
+            'Encode for text; char encoding default (iso88591); string containing new lines' => [
+                'input'    => "\xa1Hola!\r\nSe\xf1or!\r\n",
+                'expected' => '=A1Hola!Se=F1or!',
+                'position' => 'text',
+            ],
+            'Encode for text; char encoding explicit: utf-8; phrase vs text regex (text)' => [
+                'input'    => "Hello?\xbdWorld\x5e\xa9",
+                'expected' => 'Hello=3F=BDWorld^=A9',
+                'position' => 'text',
+                'charset'  => PHPMailer::CHARSET_UTF8,
+            ],
+            'Encode for phrase; char encoding explicit: utf-8;  phrase vs text regex (phrase)' => [
+                'input'    => "Hello?\xbdWorld\x5e\xa9",
+                'expected' => 'Hello=3F=BDWorld=5E=A9',
+                'position' => 'phrase',
+                'charset'  => PHPMailer::CHARSET_UTF8,
+            ],
+        ];
+    }
+}

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

@@ -0,0 +1,135 @@
+<?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 string encoding functionality.
+ */
+final class EncodeStringTest extends TestCase
+{
+    /**
+     * Encoding and charset tests.
+     *
+     * @covers \PHPMailer\PHPMailer\PHPMailer::encodeString
+     *
+     * @dataProvider dataEncodeString
+     *
+     * @param string $input    Text to encode.
+     * @param string $expected Expected function return value.
+     * @param string $encoding Optional. Encoding to use.
+     */
+    public function testEncodeString($input, $expected, $encoding = null)
+    {
+        if (isset($encoding)) {
+            $result = $this->Mail->encodeString($input, $encoding);
+        } else {
+            $result = $this->Mail->encodeString($input);
+        }
+
+        self::assertSame($expected, $result);
+    }
+
+    /**
+     * Data provider.
+     *
+     * @return array
+     */
+    public function dataEncodeString()
+    {
+        $input           = 'hello';
+        $LE              = PHPMailer::getLE();
+        $base64_expected = base64_encode($input) . $LE;
+
+        return [
+            'Simple string; no explicit encoding (using base64 default)' => [
+                'input'    => $input,
+                'expected' => $base64_expected,
+            ],
+            'Simple string; base64 encoding (lowercase)' => [
+                'input'    => $input,
+                'expected' => $base64_expected,
+                'encoding' => PHPMailer::ENCODING_BASE64,
+            ],
+            'Simple string; base64 encoding (uppercase)' => [
+                'input'    => $input,
+                'expected' => $base64_expected,
+                'encoding' => strtoupper(PHPMailer::ENCODING_BASE64),
+            ],
+            'Simple string; 7-bit encoding' => [
+                'input'    => $input,
+                'expected' => $input . $LE,
+                'encoding' => PHPMailer::ENCODING_7BIT,
+            ],
+            'Simple string; 8-bit encoding' => [
+                'input'    => $input,
+                'expected' => $input . $LE,
+                'encoding' => PHPMailer::ENCODING_8BIT,
+            ],
+            'Simple string; binary encoding' => [
+                'input'    => $input,
+                'expected' => $input,
+                'encoding' => PHPMailer::ENCODING_BINARY,
+            ],
+            'Simple string; binary encoding (mixed case)' => [
+                'input'    => $input,
+                'expected' => $input,
+                'encoding' => ucfirst(PHPMailer::ENCODING_BINARY),
+            ],
+            'Simple string; quoted printable encoding' => [
+                'input'    => $input,
+                'expected' => $input,
+                'encoding' => PHPMailer::ENCODING_QUOTED_PRINTABLE,
+            ],
+            'String with line breaks; 8-bit encoding' => [
+                'input'    => "hello\rWorld\r",
+                'expected' => "hello{$LE}World{$LE}",
+                'encoding' => PHPMailer::ENCODING_8BIT,
+            ],
+        ];
+    }
+
+    /**
+     * Test passing an incorrect encoding.
+     *
+     * @covers \PHPMailer\PHPMailer\PHPMailer::encodeString
+     */
+    public function testInvalidEncoding()
+    {
+        $result = $this->Mail->encodeString('hello', 'asdfghjkl');
+        self::assertSame('', $result, 'Invalid encoding should result in an empty string');
+
+        self::assertNotEmpty($this->Mail->ErrorInfo, 'Invalid encoding not detected');
+        self::assertTrue($this->Mail->isError(), 'Error count not correctly incremented');
+        self::assertSame('Unknown encoding: asdfghjkl', $this->Mail->ErrorInfo, 'Error info not correctly set');
+    }
+
+    /**
+     * Test passing an incorrect encoding results in an exception being thrown when PHPMailer is
+     * instantiated with `$exceptions = true`.
+     *
+     * @covers \PHPMailer\PHPMailer\PHPMailer::encodeString
+     */
+    public function testInvalidEncodingException()
+    {
+        $this->expectException(Exception::class);
+        $this->expectExceptionMessage('Unknown encoding: asdfghjkl');
+
+        $mail = new PHPMailer(true);
+        $mail->encodeString('hello', 'asdfghjkl');
+    }
+}

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

@@ -0,0 +1,103 @@
+<?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 ReflectionMethod;
+use Yoast\PHPUnitPolyfills\TestCases\TestCase;
+
+/**
+ * Test file accessibility verification functionality.
+ *
+ * {@internal There is one test case known to be missing, which is a test
+ * with a valid UNC path. If someone can figure out a way to add a test for
+ * that case, that would be awesome!}
+ *
+ * @covers \PHPMailer\PHPMailer\PHPMailer::fileIsAccessible
+ */
+final class FileIsAccessibleTest extends TestCase
+{
+    /**
+     * Verify whether the "is a file accessible" check works correctly.
+     *
+     * @dataProvider dataFileIsAccessible
+     *
+     * @param string $input    A relative or absolute path to a file.
+     * @param bool   $expected The expected function return value.
+     */
+    public function testFileIsAccessible($input, $expected)
+    {
+        $reflMethod = new ReflectionMethod(PHPMailer::class, 'fileIsAccessible');
+        (\PHP_VERSION_ID < 80100) && $reflMethod->setAccessible(true);
+        $result = $reflMethod->invoke(null, $input);
+        (\PHP_VERSION_ID < 80100) && $reflMethod->setAccessible(false);
+
+        self::assertSame($expected, $result);
+    }
+
+    /**
+     * Data provider.
+     *
+     * @return array
+     */
+    public function dataFileIsAccessible()
+    {
+        $fixturesPath = dirname(__DIR__) . '/Fixtures/FileIsAccessibleTest/';
+
+        return [
+            'Valid: accessible file' => [
+                'input'    => $fixturesPath . 'accessible.txt',
+                'expected' => true,
+            ],
+            'Invalid: path not permitted' => [
+                'input'    => 'https://github.com/PHPMailer/PHPMailer/',
+                'expected' => false,
+            ],
+            'Invalid: file does not exist' => [
+                'input'    => $fixturesPath . 'thisfiledoesnotexist.txt',
+                'expected' => false,
+            ],
+            'Invalid: file in UNC path does not exist' => [
+                'input'    => '\\\\nowhere\nothing',
+                'expected' => false,
+            ],
+        ];
+    }
+
+    /**
+     * Test that the "is a file accessible" check correctly fails when the file permissions make
+     * the file unreadable.
+     */
+    public function testFileIsAccessibleFailsOnUnreadableFile()
+    {
+        if (\DIRECTORY_SEPARATOR === '\\') {
+            // Windows does not respect chmod permissions.
+            self::markTestSkipped('This test requires a non-Windows OS.');
+        }
+
+        $path = dirname(__DIR__) . '/Fixtures/FileIsAccessibleTest/';
+        $file = $path . 'inaccessible.txt';
+        chmod($file, octdec('0'));
+
+        $reflMethod = new ReflectionMethod(PHPMailer::class, 'fileIsAccessible');
+        (\PHP_VERSION_ID < 80100) && $reflMethod->setAccessible(true);
+        $result = $reflMethod->invoke(null, $file);
+        (\PHP_VERSION_ID < 80100) && $reflMethod->setAccessible(false);
+
+        // Reset to the default for git files before running assertions.
+        chmod($file, octdec('644'));
+
+        self::assertFalse($result);
+    }
+}

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

@@ -0,0 +1,74 @@
+<?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 Yoast\PHPUnitPolyfills\TestCases\TestCase;
+
+/**
+ * Test file name to type functionality.
+ *
+ * @covers \PHPMailer\PHPMailer\PHPMailer::filenameToType
+ */
+final class FilenameToTypeTest extends TestCase
+{
+    /**
+     * Verify mapping a file name to a MIME type.
+     *
+     * @dataProvider dataFilenameToType
+     *
+     * @param string $filename Filename input.
+     * @param string $expected Expected function output.
+     */
+    public function testFilenameToType($filename, $expected)
+    {
+        $result = PHPMailer::filenameToType($filename);
+        self::assertSame($expected, $result, 'Failed to map file name to a MIME type');
+    }
+
+    /**
+     * Data provider.
+     *
+     * @return array
+     */
+    public function dataFilenameToType()
+    {
+        return [
+            'Empty string' => [
+                'filename' => '',
+                'expected' => 'application/octet-stream',
+            ],
+            'File name without query string' => [
+                'filename' => 'abc.png',
+                'expected' => 'image/png',
+            ],
+            'File name with query string' => [
+                'filename' => 'abc.jpg?xyz=1',
+                'expected' => 'image/jpeg',
+            ],
+            'Full path to file, linux style' => [
+                'filename' => '/usr/sbin/subdir/docs.pdf',
+                'expected' => 'application/pdf',
+            ],
+            'Full path to file, windows style' => [
+                'filename' => 'D:\subdir\with spaces\subdir\myapp.zip',
+                'expected' => 'application/zip',
+            ],
+            'Unknown extension, should return default MIME type' => [
+                'filename' => 'abc.xyzpdq',
+                'expected' => 'application/octet-stream',
+            ],
+        ];
+    }
+}