eventespresso / event-espresso-core

core/domain/values/currency/Currency.php

Indentation +208 added lines, -208 removed lines

@@ -19,223 +19,223 @@
 class Currency
 {
 
-    /**
-     * eg 'US'
-     *
-     * @var string $code
-     */
-    private $code;
-
-    /**
-     * @var Label $label
-     */
-    private $label;
-
-    /**
-     * currency sign
-     *
-     * @var string $sign
-     * eg '$'
-     */
-    private $sign;
-
-    /**
-     * Whether the currency sign should come before the number or not
-     *
-     * @var boolean $sign_b4
-     */
-    private $sign_b4;
-
-    /**
-     * How many digits should come after the decimal place
-     * Although not theoretically true, it can effectively
-     * be considered that all currencies are decimal based.
-     * Therefore the number of decimal places can be used
-     * to calculate number of subunits like so:
-     *  subunits = pow( 10, decimal places  )
-     *
-     * @var int $decimal_places
-     */
-    private $decimal_places;
-
-    /**
-     * Symbol to use for decimal mark
-     *
-     * @var string $decimal_mark
-     * eg '.'
-     */
-    private $decimal_mark;
-
-    /**
-     * Symbol to use for thousands
-     *
-     * @var string $thousands
-     * eg ','
-     */
-    private $thousands;
-
-    /**
-     * The number of fractional divisions of a currency's main unit
-     * Can be used to determine the number of decimal places used.
-     * Because
-     *  subunits = pow( 10, decimal places )
-     * then
-     *  decimal places = log( subunits )
-     * except that a result of 1 means there are zero decimal places
-     *
-     * @var int
-     */
-    private $subunits;
-
-
-
-    /**
-     * Currency constructor.
-     *
-     * @param string $code
-     * @param Label  $label
-     * @param string $sign
-     * @param bool   $sign_b4
-     * @param int    $decimal_places the number of decimal places to use when DISPLAYING the currency
-     * @param string $decimal_mark
-     * @param string $thousands
-     * @param int    $subunits number of fractional divisions of a currency's main unit
-     */
-    public function __construct(
-        $code,
-        Label $label,
-        $sign,
-        $sign_b4,
-        $decimal_places,
-        $decimal_mark,
-        $thousands,
-        $subunits
-    ) {
-        $this->code           = $code;
-        $this->label          = $label;
-        $this->sign           = $sign;
-        $this->sign_b4        = $sign_b4;
-        $this->decimal_places = $decimal_places;
-        $this->decimal_mark   = $decimal_mark;
-        $this->thousands      = $thousands;
-        $this->subunits       = $subunits;
-    }
-
-
-
-    /**
-     * returns true if this currency is the same as the supplied currency
-     *
-     * @param Currency $other
-     * @return bool
-     */
-    public function equals(Currency $other)
-    {
-        return $this->code() === $other->code();
-    }
-
-
-
-    /**
-     * @return string
-     */
-    public function code()
-    {
-        return $this->code;
-    }
-
-
-
-    /**
-     * @return string
-     */
-    public function name()
-    {
-        return $this->label->singular();
-    }
-
-
-
-    /**
-     * @return string
-     */
-    public function plural()
-    {
-        return $this->label->plural();
-    }
-
-
-
-    /**
-     * @return string
-     */
-    public function sign()
-    {
-        return $this->sign;
-    }
-
-
-
-    /**
-     * @return bool
-     */
-    public function signB4()
-    {
-        return $this->sign_b4;
-    }
-
-
-
-    /**
-     * @return int
-     */
-    public function decimalPlaces()
-    {
-        return $this->decimal_places;
-    }
-
-
-
-    /**
-     * @return string
-     */
-    public function decimalMark()
-    {
-        return $this->decimal_mark;
-    }
+	/**
+	 * eg 'US'
+	 *
+	 * @var string $code
+	 */
+	private $code;
+
+	/**
+	 * @var Label $label
+	 */
+	private $label;
+
+	/**
+	 * currency sign
+	 *
+	 * @var string $sign
+	 * eg '$'
+	 */
+	private $sign;
+
+	/**
+	 * Whether the currency sign should come before the number or not
+	 *
+	 * @var boolean $sign_b4
+	 */
+	private $sign_b4;
+
+	/**
+	 * How many digits should come after the decimal place
+	 * Although not theoretically true, it can effectively
+	 * be considered that all currencies are decimal based.
+	 * Therefore the number of decimal places can be used
+	 * to calculate number of subunits like so:
+	 *  subunits = pow( 10, decimal places  )
+	 *
+	 * @var int $decimal_places
+	 */
+	private $decimal_places;
+
+	/**
+	 * Symbol to use for decimal mark
+	 *
+	 * @var string $decimal_mark
+	 * eg '.'
+	 */
+	private $decimal_mark;
+
+	/**
+	 * Symbol to use for thousands
+	 *
+	 * @var string $thousands
+	 * eg ','
+	 */
+	private $thousands;
+
+	/**
+	 * The number of fractional divisions of a currency's main unit
+	 * Can be used to determine the number of decimal places used.
+	 * Because
+	 *  subunits = pow( 10, decimal places )
+	 * then
+	 *  decimal places = log( subunits )
+	 * except that a result of 1 means there are zero decimal places
+	 *
+	 * @var int
+	 */
+	private $subunits;
+
+
+
+	/**
+	 * Currency constructor.
+	 *
+	 * @param string $code
+	 * @param Label  $label
+	 * @param string $sign
+	 * @param bool   $sign_b4
+	 * @param int    $decimal_places the number of decimal places to use when DISPLAYING the currency
+	 * @param string $decimal_mark
+	 * @param string $thousands
+	 * @param int    $subunits number of fractional divisions of a currency's main unit
+	 */
+	public function __construct(
+		$code,
+		Label $label,
+		$sign,
+		$sign_b4,
+		$decimal_places,
+		$decimal_mark,
+		$thousands,
+		$subunits
+	) {
+		$this->code           = $code;
+		$this->label          = $label;
+		$this->sign           = $sign;
+		$this->sign_b4        = $sign_b4;
+		$this->decimal_places = $decimal_places;
+		$this->decimal_mark   = $decimal_mark;
+		$this->thousands      = $thousands;
+		$this->subunits       = $subunits;
+	}
+
+
+
+	/**
+	 * returns true if this currency is the same as the supplied currency
+	 *
+	 * @param Currency $other
+	 * @return bool
+	 */
+	public function equals(Currency $other)
+	{
+		return $this->code() === $other->code();
+	}
+
+
+
+	/**
+	 * @return string
+	 */
+	public function code()
+	{
+		return $this->code;
+	}
+
+
+
+	/**
+	 * @return string
+	 */
+	public function name()
+	{
+		return $this->label->singular();
+	}
+
+
+
+	/**
+	 * @return string
+	 */
+	public function plural()
+	{
+		return $this->label->plural();
+	}
+
+
+
+	/**
+	 * @return string
+	 */
+	public function sign()
+	{
+		return $this->sign;
+	}
+
+
+
+	/**
+	 * @return bool
+	 */
+	public function signB4()
+	{
+		return $this->sign_b4;
+	}
+
+
+
+	/**
+	 * @return int
+	 */
+	public function decimalPlaces()
+	{
+		return $this->decimal_places;
+	}
+
+
+
+	/**
+	 * @return string
+	 */
+	public function decimalMark()
+	{
+		return $this->decimal_mark;
+	}
 
 
 
-    /**
-     * @return string
-     */
-    public function thousands()
-    {
-        return $this->thousands;
-    }
+	/**
+	 * @return string
+	 */
+	public function thousands()
+	{
+		return $this->thousands;
+	}
 
 
 
-    /**
-     * The difference between currency units and subunits
-     * is 10-to-the-power-of-this.
-     * DecimalMark is used for display, this is used for calculations
-     * @return int
-     */
-    public function subunits()
-    {
-        return $this->subunits;
-    }
+	/**
+	 * The difference between currency units and subunits
+	 * is 10-to-the-power-of-this.
+	 * DecimalMark is used for display, this is used for calculations
+	 * @return int
+	 */
+	public function subunits()
+	{
+		return $this->subunits;
+	}
 
 
 
-    /**
-     * @return string
-     */
-    public function __toString()
-    {
-        return $this->code();
-    }
+	/**
+	 * @return string
+	 */
+	public function __toString()
+	{
+		return $this->code();
+	}
 
 
 

core/domain/values/currency/Money.php

Indentation +338 added lines, -338 removed lines

@@ -22,344 +22,344 @@
 class Money
 {
 
-    /**
-     * number of decimal places to be added to currencies for internal computations,
-     * but removed before any output or formatting is applied.
-     * This allows us to avoid rounding errors during calculations.
-     */
-    const EXTRA_PRECISION = 3;
-
-    /**
-     * @var int $amount
-     */
-    private $amount;
-
-    /**
-     * @var Currency $currency
-     */
-    private $currency;
-
-    /**
-     * @var Calculator $calculator
-     */
-    protected $calculator;
-
-    /**
-     * @var MoneyFormatter[] $formatters
-     */
-    protected $formatters;
-
-
-
-    /**
-     * Money constructor.
-     *
-     * @param float|int|string $amount money amount IN THE STANDARD UNIT FOR THE CURRENCY ie: dollars, Euros, etc
-     *                                 example: $12.5 USD would equate to a value amount of 12.50
-     * @param Currency         $currency
-     * @param Calculator       $calculator
-     * @param MoneyFormatter[] $formatters
-     * @throws InvalidDataTypeException
-     */
-    public function __construct($amount, Currency $currency, Calculator $calculator, array $formatters)
-    {
-        $this->currency   = $currency;
-        $this->amount     = $this->parseAmount($amount);
-        $this->calculator = $calculator;
-        $this->formatters = $formatters;
-    }
-
-
-
-    /**
-     * @return Calculator
-     */
-    protected function calculator()
-    {
-        return $this->calculator;
-    }
-
-
-
-    /**
-     * @return MoneyFormatter[]
-     */
-    protected function formatters()
-    {
-        return $this->formatters;
-    }
-
-
-
-    /**
-     * Convert's a standard unit amount into the subunits of the currency
-     *
-     * @param float|int|string $amount money amount IN THE STANDARD UNIT FOR THE CURRENCY ie: dollars, Euros, etc
-     *                                 example: $12.5 USD would equate to a value amount of 12.50
-     * @return integer                 in the currency's subunit
-     * @throws InvalidDataTypeException
-     */
-    private function parseAmount($amount)
-    {
-        if (! in_array(gettype($amount), array('integer', 'double', 'string'), true)) {
-            throw new InvalidDataTypeException(
-                '$amount',
-                $amount,
-                'integer (or float or string)'
-            );
-        }
-        if ($this->currency->decimalMark() !== '.') {
-            // remove thousands separator and replace decimal place with standard decimal.
-            $amount = str_replace(
-                array(
-                    $this->currency->thousands(),
-                    $this->currency->decimalMark(),
-                ),
-                array(
-                    '',
-                    '.',
-                ),
-                $amount
-            );
-        }
-        // remove any non numeric values but leave the decimal
-        $amount = (float) preg_replace('/([^0-9\\.-])/', '', $amount);
-        // convert the incoming  decimal amount to the currencies subunits
-        // ex: 12.5 for a currency with 100 subunits would become 1250
-        $amount *= $this->currency()->subunits();
-        // then shift the decimal position by the number of decimal places used internally
-        // so if our extra internal precision was 3, it would become 1250000
-        $amount *= pow(10, $this->precision());
-        // then round up the remaining value if there is still a fractional amount left
-        $amount = round($amount);
-        return (int)$amount;
-    }
-
-
-
-    /**
-     * adds or subtracts additional decimal places based on the value of the Money::EXTRA_PRECISION constant
-     *
-     * @param bool $adding_precision if true, will move the decimal to the right (increase amount)
-     *                               if false, will move the decimal to the left (decrease amount)
-     * @return integer
-     */
-    private function precision($adding_precision = true)
-    {
-        $sign = $adding_precision ? 1 : -1;
-        return Money::EXTRA_PRECISION * $sign;
-    }
-
-
-
-    /**
-     * Returns the money amount as an unformatted string
-     * IF YOU REQUIRE A FORMATTED STRING, THEN USE Money::format()
-     * In the currency's standard units
-     *
-     * @return string
-     */
-    public function amount()
-    {
-        // shift the decimal position BACK by the number of decimal places used internally
-        // ex: if our extra internal precision was 3, then 1250000 would become 1250
-        $amount = $this->amount * pow(10, $this->precision(false));
-        // then adjust for the currencies subunits
-        // ex: 1250 for a currency with 100 subunits would become 12.50
-        $amount /= $this->currency()->subunits();
-        // then shave off our extra internal precision using the number of decimal places for the currency
-        $amount = round($amount, $this->currency->decimalPlaces());
-        return (string) $amount;
-    }
-
-
-
-    /**
-     * Returns the money SUBUNITS amount as an INTEGER
-     *
-     * @return integer
-     */
-    public function amountInSubunits()
-    {
-        // shift the decimal position BACK by the number of decimal places used internally
-        // for extra internal precision, but NOT for the number of decimals used by the currency
-        // ex: if our extra internal precision was 3, then 1250000 would become 1250
-        // and even if the currency used 100 subunits, we would return 1250 and NOT 12.50
-        $amount = (string) $this->amount * pow(10, $this->precision(false));
-        // then shave off anything after the decimal
-        $amount = round($amount);
-        return (int) $amount;
-    }
-
-
-
-    /**
-     * applies formatting based on the specified formatting level
-     * corresponding to one of the constants on MoneyFormatter
-     *
-     * @param int $formatting_level
-     * @return string
-     */
-    public function format($formatting_level = MoneyFormatter::ADD_THOUSANDS)
-    {
-        $formatted_amount = $this->amount();
-        $formatters       = $this->formatters();
-        // if we are applying thousands formatting...
-        if ($formatting_level >= MoneyFormatter::ADD_THOUSANDS) {
-            // then let's remove decimal formatting since it's included in thousands formatting
-            unset($formatters[ MoneyFormatter::DECIMAL_ONLY ]);
-        }
-        for ($x = 1; $x <= $formatting_level; $x++) {
-            if (isset($formatters[ $x ]) && $formatters[ $x ] instanceof MoneyFormatter) {
-                $formatted_amount = $formatters[ $x ]->format($formatted_amount, $this->currency);
-            }
-        }
-        return (string) apply_filters(
-            'FHEE__EventEspresso_core_domain_values_currency_Money__format__formatted_amount',
-            $formatted_amount,
-            $this
-        );
-    }
-
-
-
-    /**
-     * Returns the Currency object for this money
-     *
-     * @return Currency
-     */
-    public function currency()
-    {
-        return $this->currency;
-    }
-
-
-
-    /**
-     * adds the supplied Money amount to this Money amount
-     * and returns a new Money object
-     *
-     * @param Money $other
-     * @return Money
-     * @throws InvalidArgumentException
-     */
-    public function add(Money $other)
-    {
-        $this->verifySameCurrency($other->currency());
-        return new Money(
-            $this->calculator()->add(
-                $this->amount(),
-                $other->amount()
-            ),
-            $this->currency(),
-            $this->calculator(),
-            $this->formatters()
-        );
-    }
-
-
-
-    /**
-     * subtracts the supplied Money amount from this Money amount
-     * and returns a new Money object
-     *
-     * @param Money $other
-     * @return Money
-     * @throws InvalidArgumentException
-     */
-    public function subtract(Money $other)
-    {
-        $this->verifySameCurrency($other->currency());
-        return new Money(
-            $this->calculator()->subtract(
-                $this->amount(),
-                $other->amount()
-            ),
-            $this->currency(),
-            $this->calculator(),
-            $this->formatters()
-        );
-    }
-
-
-
-    /**
-     * multiplies this Money amount by the supplied $multiplier
-     * and returns a new Money object
-     *
-     * @param float|int|string $multiplier
-     * @param int              $rounding_mode
-     * @return Money
-     * @throws InvalidDataTypeException
-     */
-    public function multiply($multiplier, $rounding_mode = Calculator::ROUND_HALF_UP)
-    {
-        return new Money(
-            $this->calculator()->multiply(
-                $this->amount(),
-                $multiplier,
-                $this->precision(),
-                $rounding_mode
-            ),
-            $this->currency(),
-            $this->calculator(),
-            $this->formatters()
-        );
-    }
-
-
-
-    /**
-     * divides this Money amount by the supplied $divisor
-     * and returns a new Money object
-     *
-     * @param float|int|string $divisor
-     * @param int              $rounding_mode
-     * @return Money
-     * @throws InvalidDataTypeException
-     */
-    public function divide($divisor, $rounding_mode = Calculator::ROUND_HALF_UP)
-    {
-        return new Money(
-            $this->calculator()->divide(
-                $this->amount(),
-                $divisor,
-                $this->precision(),
-                $rounding_mode
-            ),
-            $this->currency(),
-            $this->calculator(),
-            $this->formatters()
-        );
-    }
-
-
-
-    /**
-     * @param Currency $other_currency
-     * @throws InvalidArgumentException
-     */
-    public function verifySameCurrency(Currency $other_currency)
-    {
-        if ($this->currency()->equals($other_currency) !== true) {
-            throw new InvalidArgumentException(
-                esc_html__(
-                    'Currencies must be the same in order to add or subtract their values.',
-                    'event_espresso'
-                )
-            );
-        }
-    }
-
-
-
-    /**
-     * @return string
-     */
-    public function __toString()
-    {
-        return $this->format(MoneyFormatter::DECIMAL_ONLY);
-    }
+	/**
+	 * number of decimal places to be added to currencies for internal computations,
+	 * but removed before any output or formatting is applied.
+	 * This allows us to avoid rounding errors during calculations.
+	 */
+	const EXTRA_PRECISION = 3;
+
+	/**
+	 * @var int $amount
+	 */
+	private $amount;
+
+	/**
+	 * @var Currency $currency
+	 */
+	private $currency;
+
+	/**
+	 * @var Calculator $calculator
+	 */
+	protected $calculator;
+
+	/**
+	 * @var MoneyFormatter[] $formatters
+	 */
+	protected $formatters;
+
+
+
+	/**
+	 * Money constructor.
+	 *
+	 * @param float|int|string $amount money amount IN THE STANDARD UNIT FOR THE CURRENCY ie: dollars, Euros, etc
+	 *                                 example: $12.5 USD would equate to a value amount of 12.50
+	 * @param Currency         $currency
+	 * @param Calculator       $calculator
+	 * @param MoneyFormatter[] $formatters
+	 * @throws InvalidDataTypeException
+	 */
+	public function __construct($amount, Currency $currency, Calculator $calculator, array $formatters)
+	{
+		$this->currency   = $currency;
+		$this->amount     = $this->parseAmount($amount);
+		$this->calculator = $calculator;
+		$this->formatters = $formatters;
+	}
+
+
+
+	/**
+	 * @return Calculator
+	 */
+	protected function calculator()
+	{
+		return $this->calculator;
+	}
+
+
+
+	/**
+	 * @return MoneyFormatter[]
+	 */
+	protected function formatters()
+	{
+		return $this->formatters;
+	}
+
+
+
+	/**
+	 * Convert's a standard unit amount into the subunits of the currency
+	 *
+	 * @param float|int|string $amount money amount IN THE STANDARD UNIT FOR THE CURRENCY ie: dollars, Euros, etc
+	 *                                 example: $12.5 USD would equate to a value amount of 12.50
+	 * @return integer                 in the currency's subunit
+	 * @throws InvalidDataTypeException
+	 */
+	private function parseAmount($amount)
+	{
+		if (! in_array(gettype($amount), array('integer', 'double', 'string'), true)) {
+			throw new InvalidDataTypeException(
+				'$amount',
+				$amount,
+				'integer (or float or string)'
+			);
+		}
+		if ($this->currency->decimalMark() !== '.') {
+			// remove thousands separator and replace decimal place with standard decimal.
+			$amount = str_replace(
+				array(
+					$this->currency->thousands(),
+					$this->currency->decimalMark(),
+				),
+				array(
+					'',
+					'.',
+				),
+				$amount
+			);
+		}
+		// remove any non numeric values but leave the decimal
+		$amount = (float) preg_replace('/([^0-9\\.-])/', '', $amount);
+		// convert the incoming  decimal amount to the currencies subunits
+		// ex: 12.5 for a currency with 100 subunits would become 1250
+		$amount *= $this->currency()->subunits();
+		// then shift the decimal position by the number of decimal places used internally
+		// so if our extra internal precision was 3, it would become 1250000
+		$amount *= pow(10, $this->precision());
+		// then round up the remaining value if there is still a fractional amount left
+		$amount = round($amount);
+		return (int)$amount;
+	}
+
+
+
+	/**
+	 * adds or subtracts additional decimal places based on the value of the Money::EXTRA_PRECISION constant
+	 *
+	 * @param bool $adding_precision if true, will move the decimal to the right (increase amount)
+	 *                               if false, will move the decimal to the left (decrease amount)
+	 * @return integer
+	 */
+	private function precision($adding_precision = true)
+	{
+		$sign = $adding_precision ? 1 : -1;
+		return Money::EXTRA_PRECISION * $sign;
+	}
+
+
+
+	/**
+	 * Returns the money amount as an unformatted string
+	 * IF YOU REQUIRE A FORMATTED STRING, THEN USE Money::format()
+	 * In the currency's standard units
+	 *
+	 * @return string
+	 */
+	public function amount()
+	{
+		// shift the decimal position BACK by the number of decimal places used internally
+		// ex: if our extra internal precision was 3, then 1250000 would become 1250
+		$amount = $this->amount * pow(10, $this->precision(false));
+		// then adjust for the currencies subunits
+		// ex: 1250 for a currency with 100 subunits would become 12.50
+		$amount /= $this->currency()->subunits();
+		// then shave off our extra internal precision using the number of decimal places for the currency
+		$amount = round($amount, $this->currency->decimalPlaces());
+		return (string) $amount;
+	}
+
+
+
+	/**
+	 * Returns the money SUBUNITS amount as an INTEGER
+	 *
+	 * @return integer
+	 */
+	public function amountInSubunits()
+	{
+		// shift the decimal position BACK by the number of decimal places used internally
+		// for extra internal precision, but NOT for the number of decimals used by the currency
+		// ex: if our extra internal precision was 3, then 1250000 would become 1250
+		// and even if the currency used 100 subunits, we would return 1250 and NOT 12.50
+		$amount = (string) $this->amount * pow(10, $this->precision(false));
+		// then shave off anything after the decimal
+		$amount = round($amount);
+		return (int) $amount;
+	}
+
+
+
+	/**
+	 * applies formatting based on the specified formatting level
+	 * corresponding to one of the constants on MoneyFormatter
+	 *
+	 * @param int $formatting_level
+	 * @return string
+	 */
+	public function format($formatting_level = MoneyFormatter::ADD_THOUSANDS)
+	{
+		$formatted_amount = $this->amount();
+		$formatters       = $this->formatters();
+		// if we are applying thousands formatting...
+		if ($formatting_level >= MoneyFormatter::ADD_THOUSANDS) {
+			// then let's remove decimal formatting since it's included in thousands formatting
+			unset($formatters[ MoneyFormatter::DECIMAL_ONLY ]);
+		}
+		for ($x = 1; $x <= $formatting_level; $x++) {
+			if (isset($formatters[ $x ]) && $formatters[ $x ] instanceof MoneyFormatter) {
+				$formatted_amount = $formatters[ $x ]->format($formatted_amount, $this->currency);
+			}
+		}
+		return (string) apply_filters(
+			'FHEE__EventEspresso_core_domain_values_currency_Money__format__formatted_amount',
+			$formatted_amount,
+			$this
+		);
+	}
+
+
+
+	/**
+	 * Returns the Currency object for this money
+	 *
+	 * @return Currency
+	 */
+	public function currency()
+	{
+		return $this->currency;
+	}
+
+
+
+	/**
+	 * adds the supplied Money amount to this Money amount
+	 * and returns a new Money object
+	 *
+	 * @param Money $other
+	 * @return Money
+	 * @throws InvalidArgumentException
+	 */
+	public function add(Money $other)
+	{
+		$this->verifySameCurrency($other->currency());
+		return new Money(
+			$this->calculator()->add(
+				$this->amount(),
+				$other->amount()
+			),
+			$this->currency(),
+			$this->calculator(),
+			$this->formatters()
+		);
+	}
+
+
+
+	/**
+	 * subtracts the supplied Money amount from this Money amount
+	 * and returns a new Money object
+	 *
+	 * @param Money $other
+	 * @return Money
+	 * @throws InvalidArgumentException
+	 */
+	public function subtract(Money $other)
+	{
+		$this->verifySameCurrency($other->currency());
+		return new Money(
+			$this->calculator()->subtract(
+				$this->amount(),
+				$other->amount()
+			),
+			$this->currency(),
+			$this->calculator(),
+			$this->formatters()
+		);
+	}
+
+
+
+	/**
+	 * multiplies this Money amount by the supplied $multiplier
+	 * and returns a new Money object
+	 *
+	 * @param float|int|string $multiplier
+	 * @param int              $rounding_mode
+	 * @return Money
+	 * @throws InvalidDataTypeException
+	 */
+	public function multiply($multiplier, $rounding_mode = Calculator::ROUND_HALF_UP)
+	{
+		return new Money(
+			$this->calculator()->multiply(
+				$this->amount(),
+				$multiplier,
+				$this->precision(),
+				$rounding_mode
+			),
+			$this->currency(),
+			$this->calculator(),
+			$this->formatters()
+		);
+	}
+
+
+
+	/**
+	 * divides this Money amount by the supplied $divisor
+	 * and returns a new Money object
+	 *
+	 * @param float|int|string $divisor
+	 * @param int              $rounding_mode
+	 * @return Money
+	 * @throws InvalidDataTypeException
+	 */
+	public function divide($divisor, $rounding_mode = Calculator::ROUND_HALF_UP)
+	{
+		return new Money(
+			$this->calculator()->divide(
+				$this->amount(),
+				$divisor,
+				$this->precision(),
+				$rounding_mode
+			),
+			$this->currency(),
+			$this->calculator(),
+			$this->formatters()
+		);
+	}
+
+
+
+	/**
+	 * @param Currency $other_currency
+	 * @throws InvalidArgumentException
+	 */
+	public function verifySameCurrency(Currency $other_currency)
+	{
+		if ($this->currency()->equals($other_currency) !== true) {
+			throw new InvalidArgumentException(
+				esc_html__(
+					'Currencies must be the same in order to add or subtract their values.',
+					'event_espresso'
+				)
+			);
+		}
+	}
+
+
+
+	/**
+	 * @return string
+	 */
+	public function __toString()
+	{
+		return $this->format(MoneyFormatter::DECIMAL_ONLY);
+	}
 }
 // End of file Money.php
 // Location: core/entities/money/Money.php

core/services/currency/CurrencyFactory.php

Indentation +150 added lines, -150 removed lines

@@ -27,155 +27,155 @@
 class CurrencyFactory
 {
 
-    /**
-     * @var array[] $country_currency_data
-     */
-    private $country_currency_data;
-
-    /**
-     * @var array[] $country_currencies_by_iso_code
-     */
-    private $country_currencies_by_iso_code;
-
-    /**
-     * @var array[] $country_currencies_by_currency
-     */
-    private $country_currencies_by_currency;
-
-    /**
-     * @var string $site_country_iso
-     */
-    private $site_country_iso;
-
-
-    /**
-     * CurrencyFactory constructor.
-     *
-     * @param EE_Organization_Config $organization_config
-     */
-    public function __construct(EE_Organization_Config  $organization_config) {
-        $this->site_country_iso = $organization_config->CNT_ISO;
-    }
-
-
-    /**
-     * @return array[]
-     * @throws InvalidArgumentException
-     * @throws EE_Error
-     */
-    private function getCountryCurrencyData()
-    {
-        if ($this->country_currency_data === null) {
-            $country_currency_data = json_decode(
-                EEH_File::get_file_contents(__DIR__ . DS . 'country-currencies.json'),
-                true
-            );
-            $this->parseCountryCurrencyData($country_currency_data);
-        }
-        return $this->country_currency_data;
-    }
-
-
-    /**
-     * @param array[] $country_currency_data
-     * @throws InvalidArgumentException
-     */
-    private function parseCountryCurrencyData($country_currency_data)
-    {
-        foreach ($country_currency_data as $country_currency) {
-            $this->country_currencies_by_iso_code[ $country_currency['CountryISO'] ] = $country_currency;
-            $this->country_currencies_by_currency[ $country_currency['CurrencyCode'] ] = $country_currency;
-        }
-        $this->country_currency_data = $country_currency_data;
-    }
-
-
-    /**
-     * @param array $country_currency
-     * @return Currency
-     */
-    private function createCurrencyFromCountryCurrency(array $country_currency)
-    {
-        return new Currency(
-            $country_currency['CurrencyCode'],
-            new Label(
-                $country_currency['CurrencyNameSingle'],
-                $country_currency['CurrencyNamePlural']
-            ),
-            $country_currency['CurrencySign'],
-            $country_currency['CurrencySignB4'],
-            $country_currency['CurrencyDecimalPlaces'],
-            $country_currency['CurrencyDecimalMark'],
-            $country_currency['CurrencyThousands'],
-            $country_currency['CurrencySubunits']
-        );
-    }
-
-
-
-    /**
-     * returns a Currency object for the supplied country code
-     *
-     * @param string $CNT_ISO
-     * @return Currency
-     * @throws InvalidIdentifierException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws EE_Error
-     * @throws InvalidArgumentException
-     */
-    public function createFromCountryCode($CNT_ISO = null)
-    {
-        $this->getCountryCurrencyData();
-        $CNT_ISO = $CNT_ISO !== null ? $CNT_ISO : $this->site_country_iso;
-        if(! isset($this->country_currencies_by_iso_code[ $CNT_ISO ])) {
-            throw new InvalidArgumentException(
-                sprintf(
-                    esc_html__(
-                        'Valid country currency data could not be found for the "%1$s" country code;',
-                        'event_espresso'
-                    ),
-                    $CNT_ISO
-                )
-            );
-        }
-        return $this->createCurrencyFromCountryCurrency(
-            $this->country_currencies_by_iso_code[ $CNT_ISO ]
-        );
-    }
-
-
-
-    /**
-     * returns a Currency object for the supplied currency code
-     * PLZ NOTE: variations may exist between how different countries display the same currency,
-     * so it may be necessary to use CreateCurrency::fromCountryCode() to achieve the desired results
-     *
-     * @param string $code
-     * @return Currency
-     * @throws InvalidIdentifierException
-     * @throws InvalidInterfaceException
-     * @throws InvalidDataTypeException
-     * @throws InvalidArgumentException
-     * @throws EE_Error
-     */
-    public function createFromCode($code)
-    {
-        $this->getCountryCurrencyData();
-        if (! isset($this->country_currencies_by_currency[ $code ])) {
-            throw new InvalidArgumentException(
-                sprintf(
-                    esc_html__(
-                        'A valid currency could not be found for the "%1$s" currency code;',
-                        'event_espresso'
-                    ),
-                    $code
-                )
-            );
-        }
-        return $this->createCurrencyFromCountryCurrency(
-            $this->country_currencies_by_currency[ $code ]
-        );
-    }
+	/**
+	 * @var array[] $country_currency_data
+	 */
+	private $country_currency_data;
+
+	/**
+	 * @var array[] $country_currencies_by_iso_code
+	 */
+	private $country_currencies_by_iso_code;
+
+	/**
+	 * @var array[] $country_currencies_by_currency
+	 */
+	private $country_currencies_by_currency;
+
+	/**
+	 * @var string $site_country_iso
+	 */
+	private $site_country_iso;
+
+
+	/**
+	 * CurrencyFactory constructor.
+	 *
+	 * @param EE_Organization_Config $organization_config
+	 */
+	public function __construct(EE_Organization_Config  $organization_config) {
+		$this->site_country_iso = $organization_config->CNT_ISO;
+	}
+
+
+	/**
+	 * @return array[]
+	 * @throws InvalidArgumentException
+	 * @throws EE_Error
+	 */
+	private function getCountryCurrencyData()
+	{
+		if ($this->country_currency_data === null) {
+			$country_currency_data = json_decode(
+				EEH_File::get_file_contents(__DIR__ . DS . 'country-currencies.json'),
+				true
+			);
+			$this->parseCountryCurrencyData($country_currency_data);
+		}
+		return $this->country_currency_data;
+	}
+
+
+	/**
+	 * @param array[] $country_currency_data
+	 * @throws InvalidArgumentException
+	 */
+	private function parseCountryCurrencyData($country_currency_data)
+	{
+		foreach ($country_currency_data as $country_currency) {
+			$this->country_currencies_by_iso_code[ $country_currency['CountryISO'] ] = $country_currency;
+			$this->country_currencies_by_currency[ $country_currency['CurrencyCode'] ] = $country_currency;
+		}
+		$this->country_currency_data = $country_currency_data;
+	}
+
+
+	/**
+	 * @param array $country_currency
+	 * @return Currency
+	 */
+	private function createCurrencyFromCountryCurrency(array $country_currency)
+	{
+		return new Currency(
+			$country_currency['CurrencyCode'],
+			new Label(
+				$country_currency['CurrencyNameSingle'],
+				$country_currency['CurrencyNamePlural']
+			),
+			$country_currency['CurrencySign'],
+			$country_currency['CurrencySignB4'],
+			$country_currency['CurrencyDecimalPlaces'],
+			$country_currency['CurrencyDecimalMark'],
+			$country_currency['CurrencyThousands'],
+			$country_currency['CurrencySubunits']
+		);
+	}
+
+
+
+	/**
+	 * returns a Currency object for the supplied country code
+	 *
+	 * @param string $CNT_ISO
+	 * @return Currency
+	 * @throws InvalidIdentifierException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws EE_Error
+	 * @throws InvalidArgumentException
+	 */
+	public function createFromCountryCode($CNT_ISO = null)
+	{
+		$this->getCountryCurrencyData();
+		$CNT_ISO = $CNT_ISO !== null ? $CNT_ISO : $this->site_country_iso;
+		if(! isset($this->country_currencies_by_iso_code[ $CNT_ISO ])) {
+			throw new InvalidArgumentException(
+				sprintf(
+					esc_html__(
+						'Valid country currency data could not be found for the "%1$s" country code;',
+						'event_espresso'
+					),
+					$CNT_ISO
+				)
+			);
+		}
+		return $this->createCurrencyFromCountryCurrency(
+			$this->country_currencies_by_iso_code[ $CNT_ISO ]
+		);
+	}
+
+
+
+	/**
+	 * returns a Currency object for the supplied currency code
+	 * PLZ NOTE: variations may exist between how different countries display the same currency,
+	 * so it may be necessary to use CreateCurrency::fromCountryCode() to achieve the desired results
+	 *
+	 * @param string $code
+	 * @return Currency
+	 * @throws InvalidIdentifierException
+	 * @throws InvalidInterfaceException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidArgumentException
+	 * @throws EE_Error
+	 */
+	public function createFromCode($code)
+	{
+		$this->getCountryCurrencyData();
+		if (! isset($this->country_currencies_by_currency[ $code ])) {
+			throw new InvalidArgumentException(
+				sprintf(
+					esc_html__(
+						'A valid currency could not be found for the "%1$s" currency code;',
+						'event_espresso'
+					),
+					$code
+				)
+			);
+		}
+		return $this->createCurrencyFromCountryCurrency(
+			$this->country_currencies_by_currency[ $code ]
+		);
+	}
 }
 // Location: CreateCurrency.php

Spacing +7 added lines, -7 removed lines

@@ -67,7 +67,7 @@ 
     {
         if ($this->country_currency_data === null) {
             $country_currency_data = json_decode(
-                EEH_File::get_file_contents(__DIR__ . DS . 'country-currencies.json'),
+                EEH_File::get_file_contents(__DIR__.DS.'country-currencies.json'),
                 true
             );
             $this->parseCountryCurrencyData($country_currency_data);
@@ -83,8 +83,8 @@ 
     private function parseCountryCurrencyData($country_currency_data)
     {
         foreach ($country_currency_data as $country_currency) {
-            $this->country_currencies_by_iso_code[ $country_currency['CountryISO'] ] = $country_currency;
-            $this->country_currencies_by_currency[ $country_currency['CurrencyCode'] ] = $country_currency;
+            $this->country_currencies_by_iso_code[$country_currency['CountryISO']] = $country_currency;
+            $this->country_currencies_by_currency[$country_currency['CurrencyCode']] = $country_currency;
         }
         $this->country_currency_data = $country_currency_data;
     }
@@ -128,7 +128,7 @@ 
     {
         $this->getCountryCurrencyData();
         $CNT_ISO = $CNT_ISO !== null ? $CNT_ISO : $this->site_country_iso;
-        if(! isset($this->country_currencies_by_iso_code[ $CNT_ISO ])) {
+        if ( ! isset($this->country_currencies_by_iso_code[$CNT_ISO])) {
             throw new InvalidArgumentException(
                 sprintf(
                     esc_html__(
@@ -140,7 +140,7 @@ 
             );
         }
         return $this->createCurrencyFromCountryCurrency(
-            $this->country_currencies_by_iso_code[ $CNT_ISO ]
+            $this->country_currencies_by_iso_code[$CNT_ISO]
         );
     }
 
@@ -162,7 +162,7 @@ 
     public function createFromCode($code)
     {
         $this->getCountryCurrencyData();
-        if (! isset($this->country_currencies_by_currency[ $code ])) {
+        if ( ! isset($this->country_currencies_by_currency[$code])) {
             throw new InvalidArgumentException(
                 sprintf(
                     esc_html__(
@@ -174,7 +174,7 @@ 
             );
         }
         return $this->createCurrencyFromCountryCurrency(
-            $this->country_currencies_by_currency[ $code ]
+            $this->country_currencies_by_currency[$code]
         );
     }
 }

espresso.php

Indentation +192 added lines, -192 removed lines

@@ -38,217 +38,217 @@
  * @since       4.0
  */
 if (function_exists('espresso_version')) {
-    if (! function_exists('espresso_duplicate_plugin_error')) {
-        /**
-         *    espresso_duplicate_plugin_error
-         *    displays if more than one version of EE is activated at the same time
-         */
-        function espresso_duplicate_plugin_error()
-        {
-            ?>
+	if (! function_exists('espresso_duplicate_plugin_error')) {
+		/**
+		 *    espresso_duplicate_plugin_error
+		 *    displays if more than one version of EE is activated at the same time
+		 */
+		function espresso_duplicate_plugin_error()
+		{
+			?>
             <div class="error">
                 <p>
                     <?php
-                    echo esc_html__(
-                        'Can not run multiple versions of Event Espresso! One version has been automatically deactivated. Please verify that you have the correct version you want still active.',
-                        'event_espresso'
-                    ); ?>
+					echo esc_html__(
+						'Can not run multiple versions of Event Espresso! One version has been automatically deactivated. Please verify that you have the correct version you want still active.',
+						'event_espresso'
+					); ?>
                 </p>
             </div>
             <?php
-            espresso_deactivate_plugin(plugin_basename(__FILE__));
-        }
-    }
-    add_action('admin_notices', 'espresso_duplicate_plugin_error', 1);
+			espresso_deactivate_plugin(plugin_basename(__FILE__));
+		}
+	}
+	add_action('admin_notices', 'espresso_duplicate_plugin_error', 1);
 
 } else {
-    define('EE_MIN_PHP_VER_REQUIRED', '5.3.9');
-    if (! version_compare(PHP_VERSION, EE_MIN_PHP_VER_REQUIRED, '>=')) {
-        /**
-         * espresso_minimum_php_version_error
-         *
-         * @return void
-         */
-        function espresso_minimum_php_version_error()
-        {
-            ?>
+	define('EE_MIN_PHP_VER_REQUIRED', '5.3.9');
+	if (! version_compare(PHP_VERSION, EE_MIN_PHP_VER_REQUIRED, '>=')) {
+		/**
+		 * espresso_minimum_php_version_error
+		 *
+		 * @return void
+		 */
+		function espresso_minimum_php_version_error()
+		{
+			?>
             <div class="error">
                 <p>
                     <?php
-                    printf(
-                        esc_html__(
-                            'We\'re sorry, but Event Espresso requires PHP version %1$s or greater in order to operate. You are currently running version %2$s.%3$sIn order to update your version of PHP, you will need to contact your current hosting provider.%3$sFor information on stable PHP versions, please go to %4$s.',
-                            'event_espresso'
-                        ),
-                        EE_MIN_PHP_VER_REQUIRED,
-                        PHP_VERSION,
-                        '<br/>',
-                        '<a href="http://php.net/downloads.php">http://php.net/downloads.php</a>'
-                    );
-                    ?>
+					printf(
+						esc_html__(
+							'We\'re sorry, but Event Espresso requires PHP version %1$s or greater in order to operate. You are currently running version %2$s.%3$sIn order to update your version of PHP, you will need to contact your current hosting provider.%3$sFor information on stable PHP versions, please go to %4$s.',
+							'event_espresso'
+						),
+						EE_MIN_PHP_VER_REQUIRED,
+						PHP_VERSION,
+						'<br/>',
+						'<a href="http://php.net/downloads.php">http://php.net/downloads.php</a>'
+					);
+					?>
                 </p>
             </div>
             <?php
-            espresso_deactivate_plugin(plugin_basename(__FILE__));
-        }
+			espresso_deactivate_plugin(plugin_basename(__FILE__));
+		}
 
-        add_action('admin_notices', 'espresso_minimum_php_version_error', 1);
-    } else {
-        define('EVENT_ESPRESSO_MAIN_FILE', __FILE__);
-        /**
-         * espresso_version
-         * Returns the plugin version
-         *
-         * @return string
-         */
-        function espresso_version()
-        {
-            return apply_filters('FHEE__espresso__espresso_version', '4.9.53.rc.005');
-        }
+		add_action('admin_notices', 'espresso_minimum_php_version_error', 1);
+	} else {
+		define('EVENT_ESPRESSO_MAIN_FILE', __FILE__);
+		/**
+		 * espresso_version
+		 * Returns the plugin version
+		 *
+		 * @return string
+		 */
+		function espresso_version()
+		{
+			return apply_filters('FHEE__espresso__espresso_version', '4.9.53.rc.005');
+		}
 
-        /**
-         * espresso_plugin_activation
-         * adds a wp-option to indicate that EE has been activated via the WP admin plugins page
-         */
-        function espresso_plugin_activation()
-        {
-            update_option('ee_espresso_activation', true);
-        }
+		/**
+		 * espresso_plugin_activation
+		 * adds a wp-option to indicate that EE has been activated via the WP admin plugins page
+		 */
+		function espresso_plugin_activation()
+		{
+			update_option('ee_espresso_activation', true);
+		}
 
-        register_activation_hook(EVENT_ESPRESSO_MAIN_FILE, 'espresso_plugin_activation');
-        /**
-         *    espresso_load_error_handling
-         *    this function loads EE's class for handling exceptions and errors
-         */
-        function espresso_load_error_handling()
-        {
-            static $error_handling_loaded = false;
-            if ($error_handling_loaded) {
-                return;
-            }
-            // load debugging tools
-            if (WP_DEBUG === true && is_readable(EE_HELPERS . 'EEH_Debug_Tools.helper.php')) {
-                require_once   EE_HELPERS . 'EEH_Debug_Tools.helper.php';
-                \EEH_Debug_Tools::instance();
-            }
-            // load error handling
-            if (is_readable(EE_CORE . 'EE_Error.core.php')) {
-                require_once EE_CORE . 'EE_Error.core.php';
-            } else {
-                wp_die(esc_html__('The EE_Error core class could not be loaded.', 'event_espresso'));
-            }
-            $error_handling_loaded = true;
-        }
+		register_activation_hook(EVENT_ESPRESSO_MAIN_FILE, 'espresso_plugin_activation');
+		/**
+		 *    espresso_load_error_handling
+		 *    this function loads EE's class for handling exceptions and errors
+		 */
+		function espresso_load_error_handling()
+		{
+			static $error_handling_loaded = false;
+			if ($error_handling_loaded) {
+				return;
+			}
+			// load debugging tools
+			if (WP_DEBUG === true && is_readable(EE_HELPERS . 'EEH_Debug_Tools.helper.php')) {
+				require_once   EE_HELPERS . 'EEH_Debug_Tools.helper.php';
+				\EEH_Debug_Tools::instance();
+			}
+			// load error handling
+			if (is_readable(EE_CORE . 'EE_Error.core.php')) {
+				require_once EE_CORE . 'EE_Error.core.php';
+			} else {
+				wp_die(esc_html__('The EE_Error core class could not be loaded.', 'event_espresso'));
+			}
+			$error_handling_loaded = true;
+		}
 
-        /**
-         *    espresso_load_required
-         *    given a class name and path, this function will load that file or throw an exception
-         *
-         * @param    string $classname
-         * @param    string $full_path_to_file
-         * @throws    EE_Error
-         */
-        function espresso_load_required($classname, $full_path_to_file)
-        {
-            if (is_readable($full_path_to_file)) {
-                require_once $full_path_to_file;
-            } else {
-                throw new \EE_Error (
-                    sprintf(
-                        esc_html__(
-                            'The %s class file could not be located or is not readable due to file permissions.',
-                            'event_espresso'
-                        ),
-                        $classname
-                    )
-                );
-            }
-        }
+		/**
+		 *    espresso_load_required
+		 *    given a class name and path, this function will load that file or throw an exception
+		 *
+		 * @param    string $classname
+		 * @param    string $full_path_to_file
+		 * @throws    EE_Error
+		 */
+		function espresso_load_required($classname, $full_path_to_file)
+		{
+			if (is_readable($full_path_to_file)) {
+				require_once $full_path_to_file;
+			} else {
+				throw new \EE_Error (
+					sprintf(
+						esc_html__(
+							'The %s class file could not be located or is not readable due to file permissions.',
+							'event_espresso'
+						),
+						$classname
+					)
+				);
+			}
+		}
 
-        /**
-         * @since 4.9.27
-         * @throws \EE_Error
-         * @throws \EventEspresso\core\exceptions\InvalidInterfaceException
-         * @throws \EventEspresso\core\exceptions\InvalidEntityException
-         * @throws \EventEspresso\core\exceptions\InvalidIdentifierException
-         * @throws \EventEspresso\core\exceptions\InvalidClassException
-         * @throws \EventEspresso\core\exceptions\InvalidDataTypeException
-         * @throws \EventEspresso\core\services\container\exceptions\ServiceExistsException
-         * @throws \EventEspresso\core\services\container\exceptions\ServiceNotFoundException
-         * @throws \OutOfBoundsException
-         */
-        function bootstrap_espresso()
-        {
-            require_once __DIR__ . '/core/espresso_definitions.php';
-            try {
-                espresso_load_error_handling();
-                espresso_load_required(
-                    'EEH_Base',
-                    EE_CORE . 'helpers' . DS . 'EEH_Base.helper.php'
-                );
-                espresso_load_required(
-                    'EEH_File',
-                    EE_CORE . 'interfaces' . DS . 'EEHI_File.interface.php'
-                );
-                espresso_load_required(
-                    'EEH_File',
-                    EE_CORE . 'helpers' . DS . 'EEH_File.helper.php'
-                );
-                espresso_load_required(
-                    'EEH_Array',
-                    EE_CORE . 'helpers' . DS . 'EEH_Array.helper.php'
-                );
-                // instantiate and configure PSR4 autoloader
-                espresso_load_required(
-                    'Psr4Autoloader',
-                    EE_CORE . 'Psr4Autoloader.php'
-                );
-                espresso_load_required(
-                    'EE_Psr4AutoloaderInit',
-                    EE_CORE . 'EE_Psr4AutoloaderInit.core.php'
-                );
-                $AutoloaderInit = new EE_Psr4AutoloaderInit();
-                $AutoloaderInit->initializeAutoloader();
-                espresso_load_required(
-                    'EE_Request',
-                    EE_CORE . 'request_stack' . DS . 'EE_Request.core.php'
-                );
-                espresso_load_required(
-                    'EE_Response',
-                    EE_CORE . 'request_stack' . DS . 'EE_Response.core.php'
-                );
-                espresso_load_required(
-                    'EE_Bootstrap',
-                    EE_CORE . 'EE_Bootstrap.core.php'
-                );
-                // bootstrap EE and the request stack
-                new EE_Bootstrap(
-                    new EE_Request($_GET, $_POST, $_COOKIE),
-                    new EE_Response()
-                );
-            } catch (Exception $e) {
-                require_once EE_CORE . 'exceptions' . DS . 'ExceptionStackTraceDisplay.php';
-                new EventEspresso\core\exceptions\ExceptionStackTraceDisplay($e);
-            }
-        }
-        bootstrap_espresso();
-    }
+		/**
+		 * @since 4.9.27
+		 * @throws \EE_Error
+		 * @throws \EventEspresso\core\exceptions\InvalidInterfaceException
+		 * @throws \EventEspresso\core\exceptions\InvalidEntityException
+		 * @throws \EventEspresso\core\exceptions\InvalidIdentifierException
+		 * @throws \EventEspresso\core\exceptions\InvalidClassException
+		 * @throws \EventEspresso\core\exceptions\InvalidDataTypeException
+		 * @throws \EventEspresso\core\services\container\exceptions\ServiceExistsException
+		 * @throws \EventEspresso\core\services\container\exceptions\ServiceNotFoundException
+		 * @throws \OutOfBoundsException
+		 */
+		function bootstrap_espresso()
+		{
+			require_once __DIR__ . '/core/espresso_definitions.php';
+			try {
+				espresso_load_error_handling();
+				espresso_load_required(
+					'EEH_Base',
+					EE_CORE . 'helpers' . DS . 'EEH_Base.helper.php'
+				);
+				espresso_load_required(
+					'EEH_File',
+					EE_CORE . 'interfaces' . DS . 'EEHI_File.interface.php'
+				);
+				espresso_load_required(
+					'EEH_File',
+					EE_CORE . 'helpers' . DS . 'EEH_File.helper.php'
+				);
+				espresso_load_required(
+					'EEH_Array',
+					EE_CORE . 'helpers' . DS . 'EEH_Array.helper.php'
+				);
+				// instantiate and configure PSR4 autoloader
+				espresso_load_required(
+					'Psr4Autoloader',
+					EE_CORE . 'Psr4Autoloader.php'
+				);
+				espresso_load_required(
+					'EE_Psr4AutoloaderInit',
+					EE_CORE . 'EE_Psr4AutoloaderInit.core.php'
+				);
+				$AutoloaderInit = new EE_Psr4AutoloaderInit();
+				$AutoloaderInit->initializeAutoloader();
+				espresso_load_required(
+					'EE_Request',
+					EE_CORE . 'request_stack' . DS . 'EE_Request.core.php'
+				);
+				espresso_load_required(
+					'EE_Response',
+					EE_CORE . 'request_stack' . DS . 'EE_Response.core.php'
+				);
+				espresso_load_required(
+					'EE_Bootstrap',
+					EE_CORE . 'EE_Bootstrap.core.php'
+				);
+				// bootstrap EE and the request stack
+				new EE_Bootstrap(
+					new EE_Request($_GET, $_POST, $_COOKIE),
+					new EE_Response()
+				);
+			} catch (Exception $e) {
+				require_once EE_CORE . 'exceptions' . DS . 'ExceptionStackTraceDisplay.php';
+				new EventEspresso\core\exceptions\ExceptionStackTraceDisplay($e);
+			}
+		}
+		bootstrap_espresso();
+	}
 }
 if (! function_exists('espresso_deactivate_plugin')) {
-    /**
-     *    deactivate_plugin
-     * usage:  espresso_deactivate_plugin( plugin_basename( __FILE__ ));
-     *
-     * @access public
-     * @param string $plugin_basename - the results of plugin_basename( __FILE__ ) for the plugin's main file
-     * @return    void
-     */
-    function espresso_deactivate_plugin($plugin_basename = '')
-    {
-        if (! function_exists('deactivate_plugins')) {
-            require_once ABSPATH . 'wp-admin/includes/plugin.php';
-        }
-        unset($_GET['activate'], $_REQUEST['activate']);
-        deactivate_plugins($plugin_basename);
-    }
+	/**
+	 *    deactivate_plugin
+	 * usage:  espresso_deactivate_plugin( plugin_basename( __FILE__ ));
+	 *
+	 * @access public
+	 * @param string $plugin_basename - the results of plugin_basename( __FILE__ ) for the plugin's main file
+	 * @return    void
+	 */
+	function espresso_deactivate_plugin($plugin_basename = '')
+	{
+		if (! function_exists('deactivate_plugins')) {
+			require_once ABSPATH . 'wp-admin/includes/plugin.php';
+		}
+		unset($_GET['activate'], $_REQUEST['activate']);
+		deactivate_plugins($plugin_basename);
+	}
 }