create-berna-stencil 1.0.8 → 1.0.10

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

@@ -0,0 +1,392 @@
+<?php
+
+/**
+ * PHPMailer - Base test class.
+ * 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;
+
+use PHPMailer\PHPMailer\PHPMailer;
+use PHPMailer\PHPMailer\SMTP;
+use ReflectionClass;
+use ReflectionProperty;
+use Yoast\PHPUnitPolyfills\TestCases\TestCase as PolyfillTestCase;
+
+/**
+ * PHPMailer - Base test class.
+ */
+abstract class TestCase extends PolyfillTestCase
+{
+    /**
+     * Whether or not to initialize the PHPMailer object to throw exceptions.
+     *
+     * Overload this constant in a concrete test class and set the value to `true`
+     * to initialize PHPMailer with Exceptions turned on.
+     *
+     * @var bool|null
+     */
+    const USE_EXCEPTIONS = null;
+
+    /**
+     * Property names and their values for the test instance of the PHPMailer class.
+     *
+     * These (public) properties will be set in the `set_up()` method.
+     *
+     * This property can be enhanced/overloaded in concrete test classes to change the presets
+     * or add additional properties.
+     *
+     * It is the responsibility of the individual test classes to ensure that
+     * property values of the correct type are passed.
+     *
+     * @var array Key is the property name, value the desired value for the PHPMailer instance.
+     */
+    protected $propertyChanges = [
+        'SMTPDebug'   => SMTP::DEBUG_CONNECTION, // Full debug output.
+        'Debugoutput' => ['PHPMailer\Test\DebugLogTestListener', 'debugLog'],
+    ];
+
+    /**
+     * Holds the PHPMailer instance.
+     *
+     * @var PHPMailer
+     */
+    protected $Mail;
+
+    /**
+     * Holds the change log.
+     *
+     * @var string[]
+     */
+    private $ChangeLog = [];
+
+    /**
+     * Holds the note log.
+     *
+     * @var string[]
+     */
+    private $NoteLog = [];
+
+    /*
+     * List of *public* properties which we don't want listed in the changelog
+     * as they will already be included in the mail/debug information
+     * created in `buildBody()` anyway.
+     *
+     * Note: no need to include protected or private properties as the tests don't
+     * have access to those anyway.
+     *
+     * @var array Key is the property name, value irrelevant.
+     */
+    private $changelogExclude = [
+        // These are always set in set_up().
+        'SMTPDebug'   => true,
+        'Debugoutput' => true,
+
+        // These are part of the message body anyway.
+        'Subject'     => true,
+        'Body'        => true,
+        'AltBody'     => true,
+        'Ical'        => true,
+
+        // These will always change.
+        'MessageID'   => true,
+        'MessageDate' => true,
+
+        // These are always explicitly added via buildBody() anyway.
+        'ContentType' => true,
+        'CharSet'     => true,
+        'Host'        => true,
+    ];
+
+    /**
+     * List of *static* properties in the PHPMailer class which _may_ be changed from within a test,
+     * with their default values.
+     *
+     * This list is used by the {@see `TestCase::resetStaticProperties()`} method, as well as
+     * in the {@see `TestCase::checkChanges()`} method.
+     *
+     * {@internal The default values have to be (manually) maintained here as the Reflection
+     * extension does not provide accurate information on the default values of static properties.}
+     *
+     * @var array Key is the property name, value the default as per the PHPMailer class.
+     */
+    private $PHPMailerStaticProps = [
+        'LE'        => PHPMailer::CRLF,
+        'validator' => 'php',
+        'language'  => [],
+    ];
+
+    /**
+     * Run before each test class.
+     */
+    public static function set_up_before_class()
+    {
+        if (defined('PHPMAILER_INCLUDE_DIR') === false) {
+            /*
+             * Set up default include path.
+             * Default to the dir above the test dir, i.e. the project home dir.
+             */
+            define('PHPMAILER_INCLUDE_DIR', dirname(__DIR__));
+        }
+    }
+
+    /**
+     * Run before each test is started.
+     */
+    protected function set_up()
+    {
+        // Initialize the PHPMailer class.
+        if (is_bool(static::USE_EXCEPTIONS)) {
+            $this->Mail = new PHPMailer(static::USE_EXCEPTIONS);
+        } else {
+            $this->Mail = new PHPMailer();
+        }
+
+        // Set initial property values.
+        foreach ($this->propertyChanges as $key => $value) {
+            if ($key === 'to' || $key === 'cc' || $key === 'bcc' || $key === 'ReplyTo') {
+                if (is_array($value) && isset($value['address'], $value['name'])) {
+                    $this->setAddress($value['address'], $value['name'], $key);
+                } elseif (is_string($value)) {
+                    $this->setAddress($value, '', $key);
+                }
+
+                continue;
+            }
+
+            $this->Mail->{$key} = $value;
+        }
+
+        if ($this->Mail->Host != '') {
+            $this->Mail->isSMTP();
+        } else {
+            $this->Mail->isMail();
+        }
+    }
+
+    /**
+     * Run after each test is completed.
+     */
+    protected function tear_down()
+    {
+        // Make sure that any changes to static variables are undone after each test.
+        $this->resetStaticProperties();
+
+        // Clean test class native properties between tests.
+        $this->Mail = null;
+        $this->ChangeLog = [];
+        $this->NoteLog = [];
+    }
+
+    /**
+     * Reset the static properties in the PHPMailer class to their default values.
+     */
+    protected function resetStaticProperties()
+    {
+        $reflClass        = new ReflectionClass(PHPMailer::class);
+        $staticPropValues = $reflClass->getStaticProperties();
+
+        foreach ($this->PHPMailerStaticProps as $name => $default) {
+            if (isset($staticPropValues[$name]) && $staticPropValues[$name] === $default) {
+                continue;
+            }
+
+            self::updateStaticProperty(PHPMailer::class, $name, $default);
+        }
+    }
+
+    /**
+     * Update the value of a - potentially inaccessible - static property in a class.
+     *
+     * @param string $className    The target class.
+     * @param string $propertyName The name of the static property.
+     * @param mixed  $value        The new value for the property.
+     */
+    public static function updateStaticProperty($className, $propertyName, $value)
+    {
+        $reflProp = new ReflectionProperty($className, $propertyName);
+        if (PHP_VERSION_ID < 80100) {
+            //setAccessible is only needed in PHP < 8.1
+            $isPublic = $reflProp->isPublic();
+            if ($isPublic !== true) {
+                $reflProp->setAccessible(true);
+            }
+        }
+
+        $reflProp->setValue(null, $value);
+
+        if (PHP_VERSION_ID < 80100) {
+            if ($isPublic !== true) {
+                $reflProp->setAccessible(false);
+            }
+        }
+    }
+
+    /**
+     * Build the body of the message in the appropriate format.
+     */
+    protected function buildBody()
+    {
+        $this->checkChanges();
+
+        // Determine line endings for message.
+        if ('text/html' === $this->Mail->ContentType || $this->Mail->AltBody !== '') {
+            $eol = "<br>\r\n";
+            $bullet_start = '<li>';
+            $bullet_end = "</li>\r\n";
+            $list_start = "<ul>\r\n";
+            $list_end = "</ul>\r\n";
+        } else {
+            $eol = "\r\n";
+            $bullet_start = ' - ';
+            $bullet_end = "\r\n";
+            $list_start = '';
+            $list_end = '';
+        }
+
+        $ReportBody = '';
+
+        $ReportBody .= '---------------------' . $eol;
+        $ReportBody .= 'Unit Test Information' . $eol;
+        $ReportBody .= '---------------------' . $eol;
+        $ReportBody .= 'phpmailer version: ' . PHPMailer::VERSION . $eol;
+        $ReportBody .= 'Content Type: ' . $this->Mail->ContentType . $eol;
+        $ReportBody .= 'CharSet: ' . $this->Mail->CharSet . $eol;
+
+        if ($this->Mail->Host !== '') {
+            $ReportBody .= 'Host: ' . $this->Mail->Host . $eol;
+        }
+
+        // If attachments then create an attachment list.
+        $attachments = $this->Mail->getAttachments();
+        if (count($attachments) > 0) {
+            $ReportBody .= 'Attachments:' . $eol;
+            $ReportBody .= $list_start;
+            foreach ($attachments as $attachment) {
+                $ReportBody .= $bullet_start . 'Name: ' . $attachment[1] . ', ';
+                $ReportBody .= 'Encoding: ' . $attachment[3] . ', ';
+                $ReportBody .= 'Type: ' . $attachment[4] . $bullet_end;
+            }
+            $ReportBody .= $list_end . $eol;
+        }
+
+        // If there are changes then list them.
+        if (count($this->ChangeLog) > 0) {
+            $ReportBody .= 'Changes' . $eol;
+            $ReportBody .= '-------' . $eol;
+
+            $ReportBody .= $list_start;
+            foreach ($this->ChangeLog as $iValue) {
+                $ReportBody .= $bullet_start . $iValue[0] . ' was changed to [' .
+                    $iValue[1] . ']' . $bullet_end;
+            }
+            $ReportBody .= $list_end . $eol . $eol;
+        }
+
+        // If there are notes then list them.
+        if (count($this->NoteLog) > 0) {
+            $ReportBody .= 'Notes' . $eol;
+            $ReportBody .= '-----' . $eol;
+
+            $ReportBody .= $list_start;
+            foreach ($this->NoteLog as $iValue) {
+                $ReportBody .= $bullet_start . $iValue . $bullet_end;
+            }
+            $ReportBody .= $list_end;
+        }
+
+        // Re-attach the original body.
+        $this->Mail->Body .= $eol . $ReportBody;
+    }
+
+    /**
+     * Check which default settings have been changed for the report.
+     */
+    protected function checkChanges()
+    {
+        // Get the default values of all public properties.
+        $defaults = get_class_vars(PHPMailer::class);
+
+        foreach ($defaults as $propertyName => $value) {
+            if (isset($this->changelogExclude[$propertyName])) {
+                continue;
+            }
+
+            if (isset($this->PHPMailerStaticProps[$propertyName])) {
+                // Nested static access is not supported in PHP < 7.0, so we need an interim variable.
+                $mail = $this->Mail;
+                if ($mail::${$propertyName} !== $this->PHPMailerStaticProps[$propertyName]) {
+                    $this->addChange($propertyName, var_export($mail::${$propertyName}, true));
+                }
+
+                continue;
+            }
+
+            // Check against the TestCase specific defaults.
+            if (
+                isset($this->propertyChanges[$propertyName])
+                && $this->Mail->{$propertyName} !== $this->propertyChanges[$propertyName]
+            ) {
+                $this->addChange($propertyName, var_export($this->Mail->{$propertyName}, true));
+                continue;
+            }
+
+            // Check against the PHPMailer class defaults.
+            if ($this->Mail->{$propertyName} !== $value) {
+                $this->addChange($propertyName, var_export($this->Mail->{$propertyName}, true));
+            }
+        }
+    }
+
+    /**
+     * Add a changelog entry.
+     *
+     * @param string $sName
+     * @param string $sNewValue
+     */
+    protected function addChange($sName, $sNewValue)
+    {
+        $this->ChangeLog[] = [$sName, $sNewValue];
+    }
+
+    /**
+     * Adds a simple note to the message.
+     *
+     * @param string $sValue
+     */
+    protected function addNote($sValue)
+    {
+        $this->NoteLog[] = $sValue;
+    }
+
+    /**
+     * Adds all of the addresses.
+     *
+     * @param string $sAddress
+     * @param string $sName
+     * @param string $sType
+     *
+     * @return bool
+     */
+    protected function setAddress($sAddress, $sName = '', $sType = 'to')
+    {
+        switch ($sType) {
+            case 'to':
+                return $this->Mail->addAddress($sAddress, $sName);
+            case 'cc':
+                return $this->Mail->addCC($sAddress, $sName);
+            case 'bcc':
+                return $this->Mail->addBCC($sAddress, $sName);
+            case 'ReplyTo':
+                return $this->Mail->addReplyTo($sAddress, $sName);
+        }
+
+        return false;
+    }
+}

package/src/api/vendor/phpmailer/phpmailer/test/fakepopserver.sh

@@ -0,0 +1,126 @@
+#!/usr/bin/env bash
+
+# Fake POP3 server
+# By Marcus Bointon <phpmailer@synchromedia.co.uk>
+# Copyright 2010 - 2020 Marcus Bointon
+# Based on code by 'Frater' found at https://www.linuxquestions.org/questions/programming-9/fake-pop3-server-to-capture-pop3-passwords-933733/
+# Does not actually serve any mail, but supports commands sufficient to test POP-before SMTP
+# Can be run directly from a shell like this:
+# mkfifo fifo; nc -l 1100 <fifo |./fakepopserver.sh >fifo; rm fifo
+# It will accept any user name and will return a positive response for the password 'test'
+
+# Licensed under the GNU Lesser General Public License: https://www.gnu.org/licenses/old-licenses/lgpl-2.1.html
+
+# Enable debug output
+#set -xv
+export PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin:/root/bin
+
+LOGFOLDER=/tmp
+
+LOGFILE=${LOGFOLDER}/fakepop.log
+
+LOGGING=1
+DEBUG=1
+TIMEOUT=60
+
+POP_USER=
+POP_PASSWRD=test
+
+LINES=1
+BREAK=0
+
+write_log () {
+  if [ ${LINES} -eq 1 ] ; then
+    echo '---'  >>${LOGFILE}
+  fi
+  let LINES+=1
+  [ ${LOGGING} = 0 ] || echo -e "`date '+%b %d %H:%M'` pop3 $*" >>${LOGFILE}
+}
+
+ANSWER="+OK Fake POP3 Service Ready"
+
+while [ ${BREAK} -eq 0 ] ; do
+  echo -en "${ANSWER}\r\n"
+
+  REPLY=""
+
+  #Input appears in $REPLY
+  read -t ${TIMEOUT}
+
+  ANSWER="+OK "
+  COMMAND=""
+  ARGS=""
+  TIMEOUT=30
+
+  if [ "$REPLY" ] ; then
+    write_log "RAW input: '`echo "${REPLY}" | tr -cd '[ -~]'`'"
+
+    COMMAND="`echo "${REPLY}" | awk '{print $1}' | tr -cd '\40-\176' | tr 'a-z' 'A-Z'`"
+    ARGS="`echo "${REPLY}"    | tr -cd '\40-\176' | awk '{for(i=2;i<=NF;i++){printf "%s ", $i};printf "\n"}' | sed 's/ $//'`"
+
+    write_log "Command: \"${COMMAND}\""
+    write_log "Arguments: \"${ARGS}\""
+
+    case "$COMMAND" in
+      QUIT)
+        break
+        ;;
+      USER)
+        if [ -n "${ARGS}" ] ; then
+          POP_USER="${ARGS}"
+          ANSWER="+OK Please send PASS command"
+        fi
+        ;;
+      AUTH)
+        ANSWER="+OK \r\n."
+        ;;
+      CAPA)
+        ANSWER="+OK Capabilities include\r\nUSER\r\nCAPA\r\n."
+        ;;
+      PASS)
+        if [ "${POP_PASSWRD}" == "${ARGS}" ] ; then
+          ANSWER="+OK Logged in."
+          AUTH=1
+        else
+          ANSWER="-ERR Login failed."
+        fi
+        ;;
+      LIST)
+        if [ "${AUTH}" = 0 ] ; then
+          ANSWER="-ERR Not authenticated"
+        else
+          if [ -z "${ARGS}" ] ; then
+            ANSWER="+OK No messages, really\r\n."
+          else
+            ANSWER="-ERR No messages, no list, no status"
+          fi
+        fi
+        ;;
+      RSET)
+        ANSWER="+OK Resetting or whatever\r\n."
+        ;;
+      LAST)
+        if [ "${AUTH}" = 0 ] ; then
+          ANSWER="-ERR Not authenticated"
+        else
+          ANSWER="+OK 0"
+        fi
+        ;;
+      STAT)
+        if [ "${AUTH}" = 0 ] ; then
+          ANSWER="-ERR Not authenticated"
+        else
+          ANSWER="+OK 0 0"
+        fi
+        ;;
+      NOOP)
+        ANSWER="+OK Hang on, doing nothing"
+        ;;
+     esac
+  else
+    echo "+OK Connection timed out"
+    break
+  fi
+done
+
+echo -en "+OK Bye!\r\n"

package/src/api/vendor/phpmailer/phpmailer/test/fakesendmail.sh

@@ -0,0 +1,22 @@
+#!/usr/bin/env bash
+#Fake sendmail script, adapted from:
+#https://github.com/mrded/MNPP/blob/ee64fb2a88efc70ba523b78e9ce61f9f1ed3b4a9/init/fake-sendmail.sh
+
+#Create a temp folder to put messages in
+numPath="${TMPDIR-/tmp/}fakemail"
+umask 037
+mkdir -p ${numPath}
+
+if [ ! -f ${numPath}/num ]; then
+  echo "0" > ${numPath}/num
+fi
+num=`cat ${numPath}/num`
+num=$((${num} + 1))
+echo ${num} > ${numPath}/num
+
+name="${numPath}/message_${num}.eml"
+while read line
+do
+  echo ${line} >> ${name}
+done
+exit 0

package/src/api/vendor/phpmailer/phpmailer/test/runfakepopserver.sh

@@ -0,0 +1,12 @@
+#!/usr/bin/env bash
+
+set -xv
+
+# Run the fake pop server from bash
+# Defaults to port 1100 so it can be run by unpriv users and not clash with a real server
+# Optionally, pass in a port number as the first arg
+
+rm -f fifo
+mkfifo fifo
+nc -l ${1:-1100} <fifo |bash ./fakepopserver.sh >fifo
+rm fifo

package/src/api/vendor/phpmailer/phpmailer/test/testbootstrap-dist.php

@@ -0,0 +1,8 @@
+<?php
+
+$_REQUEST['submitted'] = 1;
+$_REQUEST['mail_to'] = 'somebody@example.com';
+$_REQUEST['mail_from'] = 'phpunit@example.com';
+$_REQUEST['mail_cc'] = 'cc@example.com';
+$_REQUEST['mail_host'] = 'localhost';
+$_REQUEST['mail_port'] = 2500;

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

@@ -0,0 +1,12 @@
+<?php
+
+//These are global functions without a namespace used for testing validator injection
+function php()
+{
+    return false;
+}
+
+function phpx()
+{
+    return false;
+}

package/src/api/vendor/phpoption/phpoption/.gitattributes

@@ -0,0 +1,13 @@
+* text=auto
+
+/tests export-ignore
+/.gitattributes export-ignore
+/.github export-ignore
+/.gitignore export-ignore
+/.travis.yml export-ignore
+/Makefile export-ignore
+/phpstan-baseline.neon export-ignore
+/phpstan.neon.dist export-ignore
+/phpunit.xml.dist export-ignore
+/README.md export-ignore
+/vendor-bin export-ignore