Renaming Namespaces and Organizing Classes

- Updated OpenId classes to be in API namespace
- Updated PP Naming Convention to PayPal Naming Convention
- FormatConverter Class got its own namespace
- Handlers are grouped in Handler namespace
- Samples and Tests Updated Accordingly

lib/PayPal/Converter/FormatConverter.php

@@ -0,0 +1,74 @@
+<?php
+
+namespace PayPal\Converter;
+
+class FormatConverter {
+
+    /**
+     * Format the data based on the input formatter value
+     *
+     * @param $value
+     * @param $formatter
+     * @return string
+     */
+    public static function format($value, $formatter)
+    {
+        return sprintf($formatter, $value);
+    }
+
+    /**
+     * Format the input data to two decimal places
+     *
+     * @deprecated Use formatToNumber instead
+     * @param $value
+     * @return string
+     */
+    public static function formatToTwoDecimalPlaces($value)
+    {
+        return self::formatToNumber($value);
+    }
+
+    /**
+     * Format the input data with decimal places
+     *
+     * Defaults to 2 decimal places
+     *
+     * @param     $value
+     * @param int $decimals
+     * @return null|string
+     */
+    public static function formatToNumber($value, $decimals = 2)
+    {
+        if (trim($value) != null) {
+            return number_format($value, $decimals, '.', '');
+        }
+        return null;
+    }
+
+    /**
+     * Helper method to format price values with associated currency information.
+     *
+     * It covers the cases where certain currencies does not accept decimal values. We will be adding
+     * any specific currency level rules as required here.
+     *
+     * @param      $value
+     * @param null $currency
+     * @return null|string
+     */
+    public static function formatToPrice($value, $currency = null)
+    {
+        $decimals = 2;
+        $currencyDecimals = array('JPY' => 0, 'TWD' => 0);
+        if ($currency && array_key_exists($currency, $currencyDecimals)) {
+            if (strpos($value, ".") !== false && (floor($value) != $value)) {
+                //throw exception if it has decimal values for JPY and TWD which does not ends with .00
+                throw new \InvalidArgumentException("value cannot have decimals for $currency currency");
+            }
+            $decimals = $currencyDecimals[$currency];
+        } else if (strpos($value, ".") === false) {
+            // Check if value has decimal values. If not no need to assign 2 decimals with .00 at the end
+            $decimals = 0;
+        }
+        return self::formatToNumber($value, $decimals);
+    }
+}