create-berna-stencil 1.0.9 → 1.0.10

package/src/api/vendor/phpmailer/phpmailer/test/DebugLogTestListener.php

@@ -0,0 +1,47 @@
+<?php
+
+/**
+ * PHPMailer - language file tests.
+ *
+ * PHP version 5.5.
+ *
+ * @author    Marcus Bointon <phpmailer@synchromedia.co.uk>
+ * @author    Andy Prevost
+ * @author    Juliette Reinders Folmer
+ * @copyright 2010 - 2020 Marcus Bointon
+ * @copyright 2004 - 2009 Andy Prevost
+ * @copyright 2020 Juliette Reinders Folmer
+ * @license   https://www.gnu.org/licenses/old-licenses/lgpl-2.1.html GNU Lesser General Public License
+ */
+
+namespace PHPMailer\Test;
+
+use PHPUnit\Framework\TestListener;
+use Yoast\PHPUnitPolyfills\TestListeners\TestListenerDefaultImplementation;
+
+class DebugLogTestListener implements TestListener
+{
+    use TestListenerDefaultImplementation;
+
+    private static $debugLog = '';
+
+    public function add_error($test, $e, $time)
+    {
+        echo self::$debugLog;
+    }
+
+    public function add_failure($test, $e, $time)
+    {
+        echo self::$debugLog;
+    }
+
+    public function start_test($test)
+    {
+        self::$debugLog = '';
+    }
+
+    public static function debugLog($str)
+    {
+        self::$debugLog .= $str . PHP_EOL;
+    }
+}

package/src/api/vendor/phpmailer/phpmailer/test/Fixtures/FileIsAccessibleTest/accessible.txt

@@ -0,0 +1 @@
+Testing 1-2-3

package/src/api/vendor/phpmailer/phpmailer/test/Fixtures/FileIsAccessibleTest/inaccessible.txt

@@ -0,0 +1 @@
+Testing 1-2-3

package/src/api/vendor/phpmailer/phpmailer/test/Fixtures/LocalizationTest/phpmailer.lang-fr.php

@@ -0,0 +1,10 @@
+<?php
+
+/**
+ * Test fixture.
+ *
+ * Used in the `PHPMailer\LocalizationTest` to test overruling an existing translation
+ * file with a custom one by passing in a `$langPath` parameter.
+ */
+
+$PHPMAILER_LANG['empty_message'] = "Custom path test success (fr)";

package/src/api/vendor/phpmailer/phpmailer/test/Fixtures/LocalizationTest/phpmailer.lang-nl.php

@@ -0,0 +1,10 @@
+<?php
+
+/**
+ * Test fixture.
+ *
+ * Used in the `PHPMailer\LocalizationTest` to test overruling an existing translation
+ * file with a custom one by passing in a `$langPath` parameter.
+ */
+
+$PHPMAILER_LANG['empty_message'] = 'Custom path test success (nl)';

package/src/api/vendor/phpmailer/phpmailer/test/Fixtures/LocalizationTest/phpmailer.lang-xa_scri_cc.php

@@ -0,0 +1,9 @@
+<?php
+
+/**
+ * Test fixture.
+ *
+ * Used in the `PHPMailer\LocalizationTest` to test the fall-back logic.
+ */
+
+$PHPMAILER_LANG['empty_message'] = 'XA Lang-script-country file found';

package/src/api/vendor/phpmailer/phpmailer/test/Fixtures/LocalizationTest/phpmailer.lang-xb_scri.php

@@ -0,0 +1,9 @@
+<?php
+
+/**
+ * Test fixture.
+ *
+ * Used in the `PHPMailer\LocalizationTest` to test the fall-back logic.
+ */
+
+$PHPMAILER_LANG['empty_message'] = 'XB Lang-script file found';

package/src/api/vendor/phpmailer/phpmailer/test/Fixtures/LocalizationTest/phpmailer.lang-xc_cc.php

@@ -0,0 +1,9 @@
+<?php
+
+/**
+ * Test fixture.
+ *
+ * Used in the `PHPMailer\LocalizationTest` to test the fall-back logic.
+ */
+
+$PHPMAILER_LANG['empty_message'] = 'XC Lang-country file found';

package/src/api/vendor/phpmailer/phpmailer/test/Fixtures/LocalizationTest/phpmailer.lang-xd_cc.php

@@ -0,0 +1,9 @@
+<?php
+
+/**
+ * Test fixture.
+ *
+ * Used in the `PHPMailer\LocalizationTest` to test the fall-back logic.
+ */
+
+$PHPMAILER_LANG['empty_message'] = 'XD Lang-country file found';

package/src/api/vendor/phpmailer/phpmailer/test/Fixtures/LocalizationTest/phpmailer.lang-xd_scri.php

@@ -0,0 +1,9 @@
+<?php
+
+/**
+ * Test fixture.
+ *
+ * Used in the `PHPMailer\LocalizationTest` to test the fall-back logic.
+ */
+
+$PHPMAILER_LANG['empty_message'] = 'XD Lang-script file found';

package/src/api/vendor/phpmailer/phpmailer/test/Fixtures/LocalizationTest/phpmailer.lang-xe.php

@@ -0,0 +1,9 @@
+<?php
+
+/**
+ * Test fixture.
+ *
+ * Used in the `PHPMailer\LocalizationTest` to test the fall-back logic.
+ */
+
+$PHPMAILER_LANG['empty_message'] = 'XE Lang file found';

package/src/api/vendor/phpmailer/phpmailer/test/Fixtures/LocalizationTest/phpmailer.lang-xx.php

@@ -0,0 +1,9 @@
+<?php
+
+/**
+ * Test fixture.
+ *
+ * Used in the `PHPMailer\LocalizationTest`.
+ */
+
+$PHPMAILER_LANG['empty_message'] = 'This file should not be loaded as the path is passed incorrectly';

package/src/api/vendor/phpmailer/phpmailer/test/Fixtures/LocalizationTest/phpmailer.lang-yy.php

@@ -0,0 +1,16 @@
+<?php
+
+/**
+ * Test fixture.
+ *
+ * Used in the `PHPMailer\LocalizationTest` to test that arbitrary code in translation files is disregarded.
+ */
+
+$composer = file_get_contents(__DIR__ . '/../../../composer.json');
+
+echo $composer;
+
+$PHPMAILER_LANG['extension_missing'] = 'Confirming that test fixture was loaded correctly (yy).';
+$PHPMAILER_LANG['empty_message']     = $composer;
+$PHPMAILER_LANG['execute']           = exec('some harmful command');
+$PHPMAILER_LANG['signing']           = "Double quoted but not interpolated $composer";

package/src/api/vendor/phpmailer/phpmailer/test/Fixtures/LocalizationTest/phpmailer.lang-yz.php

@@ -0,0 +1,16 @@
+<?php // lint < 8.5.
+
+/**
+ * Test fixture.
+ *
+ * Used in the `PHPMailer\LocalizationTest` to test that arbitrary code in translation files is disregarded.
+ *
+ * Note: this test fixture uses a syntax (backticks) which has been deprecated in PHP 8.5 and
+ * is slated for removal in PHP 9.0.
+ * For that reason, the file is excluded from the linting check on PHP 8.5 and above.
+ *
+ * @phpcs:disable PHPCompatibility.LanguageConstructs.RemovedLanguageConstructs.t_backtickDeprecated
+ */
+
+$PHPMAILER_LANG['extension_missing'] = 'Confirming that test fixture was loaded correctly (yz).';
+$PHPMAILER_LANG['encoding']          = `ls -l`;

package/src/api/vendor/phpmailer/phpmailer/test/Fixtures/LocalizationTest/phpmailer.lang-zz.php

@@ -0,0 +1,20 @@
+<?php
+
+/**
+ * Test fixture.
+ *
+ * Used in the `PHPMailer\LocalizationTest` to test that language strings not
+ * set via a fixed, known group of array index keys are disregarded.
+ */
+
+$PHPMAILER_LANG['extension_missing'] = 'Confirming that test fixture was loaded correctly (zz).';
+
+// Keys not in the original array.
+$PHPMAILER_LANG['unknown']           = 'Unknown text.';
+$PHPMAILER_LANG['invalid']           = 'Invalid text.';
+
+// Keys which exist in the original array, but use the wrong letter case or space instead of underscore.
+$PHPMAILER_LANG['Authenticate']      = 'Overruled text, index not same case';
+$PHPMAILER_LANG['CONNECT_HOST']      = 'Overruled text, index not same case';
+$PHPMAILER_LANG['Data_Not_Accepted'] = 'Overruled text, index not same case';
+$PHPMAILER_LANG['empty message']     = 'Overruled text, index not same case';

package/src/api/vendor/phpmailer/phpmailer/test/Language/TranslationCompletenessTest.php

@@ -0,0 +1,97 @@
+<?php
+
+/**
+ * PHPMailer - language file tests.
+ *
+ * PHP version 5.5.
+ *
+ * @author    Marcus Bointon <phpmailer@synchromedia.co.uk>
+ * @author    Andy Prevost
+ * @copyright 2010 - 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\Language;
+
+use PHPMailer\PHPMailer\PHPMailer;
+use Yoast\PHPUnitPolyfills\TestCases\TestCase;
+
+/**
+ * Check language files for missing or excess translations.
+ *
+ * @group languages
+ *
+ * @coversNothing
+ */
+final class TranslationCompletenessTest extends TestCase
+{
+    /**
+     * Holds a PHPMailer instance.
+     *
+     * @var PHPMailer
+     */
+    private $Mail;
+
+    /**
+     * Run before each test is started.
+     */
+    protected function set_up()
+    {
+        $this->Mail = new PHPMailer();
+    }
+
+    /**
+     * Test language files for missing and excess translations.
+     * All languages are compared with English, which is built-in.
+     */
+    public function testTranslations()
+    {
+        $this->Mail->setLanguage('en');
+        $definedStrings = $this->Mail->getTranslations();
+        $err = '';
+        foreach (new \DirectoryIterator(__DIR__ . '/../../language') as $fileInfo) {
+            if ($fileInfo->isDot()) {
+                continue;
+            }
+
+            $matches = [];
+            // Only look at language files, ignore anything else in there.
+            if (preg_match('/^phpmailer\.lang-([a-z_]{2,})\.php$/', $fileInfo->getFilename(), $matches)) {
+                $lang = $matches[1]; // Extract language code.
+                $PHPMAILER_LANG = []; // Language strings get put in here.
+                $lines = file($fileInfo->getPathname());
+                foreach ($lines as $line) {
+                    // Translation file lines look like this:
+                    // `$PHPMAILER_LANG['authenticate'] = 'SMTP-Fehler: Authentifizierung fehlgeschlagen.';`
+                    // These files are parsed as text and not PHP so as to avoid the possibility of code injection.
+                    $matches = [];
+                    if (
+                        preg_match(
+                            '/^\$PHPMAILER_LANG\[\'([a-z\d_]+)\'\]\s*=\s*(["\'])(.+)*?\2;/',
+                            $line,
+                            $matches
+                        )
+                    ) {
+                        // Overwrite language-specific strings so we'll never have missing translation keys.
+                        $PHPMAILER_LANG[$matches[1]] = (string)$matches[3];
+                    }
+                }
+            }
+
+            include $fileInfo->getPathname(); // Get language strings.
+
+            $missing = array_diff(array_keys($definedStrings), array_keys($PHPMAILER_LANG));
+            $extra = array_diff(array_keys($PHPMAILER_LANG), array_keys($definedStrings));
+            if (!empty($missing)) {
+                $err .= "\nMissing translations in $lang: " . implode(', ', $missing);
+            }
+            if (!empty($extra)) {
+                $err .= "\nExtra translations in $lang: " . implode(', ', $extra);
+            }
+        }
+
+        // If we have no extra and no missing translations, $err will be empty.
+        self::assertEmpty($err, $err);
+    }
+}

package/src/api/vendor/phpmailer/phpmailer/test/OAuth/OAuthTest.php

@@ -0,0 +1,76 @@
+<?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\OAuth;
+
+use PHPMailer\PHPMailer\OAuth;
+use PHPMailer\PHPMailer\OAuthTokenProvider;
+use PHPMailer\PHPMailer\PHPMailer;
+use Yoast\PHPUnitPolyfills\TestCases\TestCase;
+
+/**
+ * Test OAuth functionality.
+ */
+final class OAuthTest extends TestCase
+{
+    /**
+     * Test OAuth class.
+     *
+     * @covers PHPMailer\PHPMailer\PHPMailer::getOAuth
+     * @covers PHPMailer\PHPMailer\PHPMailer::setOAuth
+     * @covers PHPMailer\PHPMailer\OAuth::__construct
+     * @covers PHPMailer\PHPMailer\OAuthTokenProvider
+     */
+    public function testOAuth()
+    {
+        $PHPMailer = new PHPMailer(true);
+        $reflection = new \ReflectionClass($PHPMailer);
+        $property = $reflection->getProperty('oauth');
+        (\PHP_VERSION_ID < 80100) && $property->setAccessible(true);
+        $property->setValue($PHPMailer, true);
+        self::assertTrue($PHPMailer->getOAuth(), 'Initial value of oauth property is not true');
+
+        $options = [
+            'provider' => 'dummyprovider',
+            'userName' => 'dummyusername',
+            'clientSecret' => 'dummyclientsecret',
+            'clientId' => 'dummyclientid',
+            'refreshToken' => 'dummyrefreshtoken',
+        ];
+
+        $oauth = new OAuth($options);
+        self::assertInstanceOf(OAuth::class, $oauth, 'Instantiation of OAuth class failed');
+        self::assertInstanceOf(OAuthTokenProvider::class, $oauth, 'Instantiation of OAuth class failed');
+        $subject = $PHPMailer->setOAuth($oauth);
+        self::assertNull($subject, 'setOAuth() is not a void function');
+        self::assertInstanceOf(
+            OAuth::class,
+            $PHPMailer->getOAuth(),
+            'Setting Oauth property to an instance of the OAuth class failed'
+        );
+        $PHPMailer->setOAuth(new DummyOAuthProvider());
+        self::assertInstanceOf(
+            OAuthTokenProvider::class,
+            $PHPMailer->getOAuth(),
+            'Setting Oauth property to an instance of the OAuth class failed (2)'
+        );
+    }
+}
+
+class DummyOauthProvider implements OAuthTokenProvider
+{
+    public function getOauth64()
+    {
+        return 'oauth';
+    }
+}

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

@@ -0,0 +1,178 @@
+<?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\PreSendTestCase;
+
+/**
+ * Test adding embedded image(s) functionality.
+ *
+ * @covers \PHPMailer\PHPMailer\PHPMailer::addEmbeddedImage
+ * @covers \PHPMailer\PHPMailer\PHPMailer::createBody
+ * @covers \PHPMailer\PHPMailer\PHPMailer::getAttachments
+ * @covers \PHPMailer\PHPMailer\PHPMailer::inlineImageExists
+ */
+final class AddEmbeddedImageTest extends PreSendTestCase
+{
+    /**
+     * Test successfully adding an embedded image.
+     */
+    public function testAddEmbeddedImage()
+    {
+        $pathToFile = realpath(\PHPMAILER_INCLUDE_DIR . '/examples/images/phpmailer.png');
+        $expected   = [
+            0 => $pathToFile,
+            1 => 'phpmailer.png',
+            2 => 'phpmailer.png',
+            3 => 'base64',
+            4 => 'image/png',
+            5 => false,
+            6 => 'inline',
+            7 => 'my-attach',
+        ];
+
+        $this->Mail->Body = 'Embedded Image: <img alt="phpmailer" src="' .
+            'cid:my-attach">' .
+            'Here is an image!';
+        $this->Mail->Subject .= ': Embedded Image';
+        $this->Mail->isHTML(true);
+
+        // Test attaching the image.
+        $result = $this->Mail->addEmbeddedImage(
+            $pathToFile,
+            'my-attach',
+            'phpmailer.png',
+            'base64',
+            'image/png'
+        );
+
+        self::assertTrue($result, $this->Mail->ErrorInfo);
+        self::assertTrue($this->Mail->inlineImageExists(), 'Embedded image not present in attachments array');
+
+        $attachments = $this->Mail->getAttachments();
+        self::assertIsArray($attachments, 'Attachments is not an array');
+        self::assertArrayHasKey(0, $attachments, 'Attachments does not have the expected array entry');
+        self::assertSame($expected, $attachments[0], 'Attachment info does not match the expected array');
+
+        // Test that the image was correctly added to the message body.
+        $this->buildBody();
+        self::assertTrue($this->Mail->preSend(), $this->Mail->ErrorInfo);
+
+        $sendMessage = $this->Mail->getSentMIMEMessage();
+        $LE          = PHPMailer::getLE();
+
+        self::assertStringContainsString(
+            'Content-Type: image/png; name=phpmailer.png' . $LE,
+            $sendMessage,
+            'Embedded image header content type incorrect.'
+        );
+
+        self::assertStringContainsString(
+            'Content-ID: <my-attach>' . $LE,
+            $sendMessage,
+            'Embedded image header content ID incorrect.'
+        );
+
+        self::assertStringContainsString(
+            'Content-Disposition: inline; filename=phpmailer.png' . $LE,
+            $sendMessage,
+            'Embedded image header content disposition incorrect.'
+        );
+    }
+
+    /**
+     * Test adding an image without explicitly adding a name for the image will set the name as the existing file name.
+     */
+    public function testAddingImageWithoutExplicitName()
+    {
+        $result = $this->Mail->addEmbeddedImage(__FILE__, '123');
+        self::assertTrue($result, 'File failed to attach');
+
+        self::assertTrue($this->Mail->inlineImageExists(), 'Inline image not present in attachments array');
+
+        $attachments = $this->Mail->getAttachments();
+        self::assertIsArray($attachments, 'Attachments is not an array');
+        self::assertArrayHasKey(0, $attachments, 'Attachments does not have the expected array entry');
+        self::assertSame($attachments[0][1], $attachments[0][2], 'Name is not the same as filename');
+    }
+
+    /**
+     * Test that embedding an image fails in select use cases.
+     *
+     * @dataProvider dataFailToAttach
+     *
+     * @param string $path             Path to the attachment.
+     * @param string $cid              Content ID for the attachment.
+     * @param string $exceptionMessage Unused in this test.
+     * @param string $name             Optional. Attachment name to use.
+     * @param string $encoding         Optional. File encoding to pass.
+     */
+    public function testFailToAttach($path, $cid, $exceptionMessage, $name = '', $encoding = PHPMailer::ENCODING_BASE64)
+    {
+        $result = $this->Mail->addEmbeddedImage($path, $cid, $name, $encoding);
+        self::assertFalse($result, 'Image did not fail to attach');
+
+        self::assertFalse($this->Mail->inlineImageExists(), 'Inline image present in attachments array');
+    }
+
+    /**
+     * Test that embedding an image throws an exception in select use cases.
+     *
+     * @dataProvider dataFailToAttach
+     *
+     * @param string $path             Path to the attachment.
+     * @param string $cid              Content ID for the attachment.
+     * @param string $exceptionMessage The exception message to expect.
+     * @param string $name             Optional. Attachment name to use.
+     * @param string $encoding         Optional. File encoding to pass.
+     */
+    public function testFailToAttachException(
+        $path,
+        $cid,
+        $exceptionMessage,
+        $name = '',
+        $encoding = PHPMailer::ENCODING_BASE64
+    ) {
+        $this->expectException(Exception::class);
+        $this->expectExceptionMessage($exceptionMessage);
+
+        $mail = new PHPMailer(true);
+        $mail->addEmbeddedImage($path, $cid, $name, $encoding);
+    }
+
+    /**
+     * Data provider.
+     *
+     * @return array
+     */
+    public function dataFailToAttach()
+    {
+        return [
+            'Invalid: non-existent file' => [
+                'path'             => 'thisfiledoesntexist',
+                'cid'              => 'xyz',
+                'exceptionMessage' => 'Could not access file: thisfiledoesntexist',
+            ],
+            'Invalid: invalid encoding' => [
+                'path'             => __FILE__,
+                'cid'              => 'cid',
+                'exceptionMessage' => 'Unknown encoding: invalidencoding',
+                'name'             => 'test.png',
+                'encoding'         => 'invalidencoding',
+            ],
+        ];
+    }
+}