Mistralys / application-localization

src/Localization/Currency.php

Spacing +6 added lines, -6 removed lines

@@ -52,7 +52,7 @@ 
             return self::$instances[$id];
         }
 
-        $className = '\AppLocalize\Localization_Currency_' . $id;
+        $className = '\AppLocalize\Localization_Currency_'.$id;
 
         return new $className($country);
     }
@@ -92,7 +92,7 @@ 
      */
     public static function isCurrencyKnown($currencyName)
     {
-        return file_exists(__DIR__ . '/Currency/' . $currencyName . '.php');
+        return file_exists(__DIR__.'/Currency/'.$currencyName.'.php');
     }
 
     /**
@@ -268,7 +268,7 @@ 
         return $this->country->getNumberDecimalsSeparator();
     }
 
-    public function makeReadable($number, $decimalPositions = 2, $addSymbol=true)
+    public function makeReadable($number, $decimalPositions = 2, $addSymbol = true)
     {
         if ($number == null || $number == '') {
             return null;
@@ -287,14 +287,14 @@ 
         
         $number = $this->formatNumber($parsed->getFloat(), $decimalPositions);
 
-        if(!$addSymbol) {
+        if (!$addSymbol) {
             return $number;
         }
         
         if ($this->isSymbolOnFront()) {
-            return $this->getSymbol() . ' ' . $number;
+            return $this->getSymbol().' '.$number;
         }
 
-        return $number . ' ' . $this->getSymbol();
+        return $number.' '.$this->getSymbol();
     }
 }
\ No newline at end of file

Braces +1 added lines, -2 removed lines

@@ -197,8 +197,7 @@
             if ($decimals == '-') {
                 $decimals = 0;
             }
-        } 
-        else 
+        } else 
         {
             $decimals = null;
             $thousands = floatval(implode('', $parts));

src/Localization/Currency/Number.php

Spacing +1 added lines, -1 removed lines

@@ -40,7 +40,7 @@
     public function getFloat()
     {
         if ($this->decimals) {
-            return floatval($this->number . '.' . $this->decimals);
+            return floatval($this->number.'.'.$this->decimals);
         }
 
         return $this->number;

src/Localization/Translator.php

Spacing +29 added lines, -29 removed lines

@@ -57,7 +57,7 @@ 
     
     public function addSources($sources)
     {
-        foreach($sources as $source) {
+        foreach ($sources as $source) {
             $this->addSource($source);
         }
     }
@@ -108,7 +108,7 @@ 
             $this->strings[$localeName] = array();
         }
 
-        foreach($this->sources as $source)
+        foreach ($this->sources as $source)
         {
             $file = $this->resolveStorageFile($locale, $source);
             if (!file_exists($file)) {
@@ -117,7 +117,7 @@ 
             
             $data = parse_ini_file($file, false);
             
-            if($data === false) 
+            if ($data === false) 
             {
                 throw new Localization_Exception(
                     'Malformatted localization file',
@@ -189,7 +189,7 @@ 
         
         $name = $locale->getName();
         
-        if(isset($this->strings[$name])) {
+        if (isset($this->strings[$name])) {
             return $this->strings[$name];
         }
         
@@ -219,25 +219,25 @@ 
     * @param boolean $editable
     * @throws Localization_Exception
     */
-    protected function renderStringsFile($type, Localization_Source $source, $hashes, $file, Localization_Locale $locale, $editable=true)
+    protected function renderStringsFile($type, Localization_Source $source, $hashes, $file, Localization_Locale $locale, $editable = true)
     {
         $sourceID = $source->getID();
         
-        $title = strtoupper($type).' TRANSLATION FILE FOR ' . strtoupper($locale->getLabel());
+        $title = strtoupper($type).' TRANSLATION FILE FOR '.strtoupper($locale->getLabel());
         
-        $content  = '; -------------------------------------------------------' . PHP_EOL;
-        $content .= '; '. $title . PHP_EOL;
-        $content .= '; -------------------------------------------------------' . PHP_EOL;
-        $content .= '; ' . PHP_EOL;
+        $content  = '; -------------------------------------------------------'.PHP_EOL;
+        $content .= '; '.$title.PHP_EOL;
+        $content .= '; -------------------------------------------------------'.PHP_EOL;
+        $content .= '; '.PHP_EOL;
         
-        if($editable) {
-            $content .= '; You may edit text directly in this file under the following conditions:' . PHP_EOL;
-            $content .= '; ' . PHP_EOL;
-            $content .= '; 1) Do not to modify the keys (left hand side of the = sign)' . PHP_EOL;
-            $content .= '; 2) Save the file as UTF-8 without BOM' . PHP_EOL;
+        if ($editable) {
+            $content .= '; You may edit text directly in this file under the following conditions:'.PHP_EOL;
+            $content .= '; '.PHP_EOL;
+            $content .= '; 1) Do not to modify the keys (left hand side of the = sign)'.PHP_EOL;
+            $content .= '; 2) Save the file as UTF-8 without BOM'.PHP_EOL;
         } else {
-            $content .= '; Do NOT edit this file directly! It depends on the main translation file' . PHP_EOL;
-            $content .= '; and any changes will be lost. Edit the main file instead.' . PHP_EOL;
+            $content .= '; Do NOT edit this file directly! It depends on the main translation file'.PHP_EOL;
+            $content .= '; and any changes will be lost. Edit the main file instead.'.PHP_EOL;
         }
         
         $content .= PHP_EOL;
@@ -245,14 +245,14 @@ 
         $saveList = array();
         foreach ($hashes as $hash) 
         {
-            if(!$hash->hasSourceID($sourceID)) {
+            if (!$hash->hasSourceID($sourceID)) {
                 continue;
             }
             
             $text = $this->getHashTranslation($hash->getHash(), $locale);
 
             // skip any empty strings
-            if($text === null || trim($text) == '') {
+            if ($text === null || trim($text) == '') {
                 continue;
             }
             
@@ -264,11 +264,11 @@ 
         
         usort($saveList, array($this, 'callback_sortStrings'));
 
-        foreach($saveList as $entry) {
-            $content .= $entry['hash'] . '= "' . $entry['text'] . '"' . PHP_EOL;
+        foreach ($saveList as $entry) {
+            $content .= $entry['hash'].'= "'.$entry['text'].'"'.PHP_EOL;
         }
 
-        if(!file_put_contents($file, $content)) {
+        if (!file_put_contents($file, $content)) {
             throw new Localization_Exception(
                 'Cannot save localization file',
                 sprintf(
@@ -294,7 +294,7 @@ 
     public function callback_sortStrings($a, $b)
     {
         $result = strnatcasecmp($a['text'], $b['text']);
-        if($result==0) {
+        if ($result == 0) {
             return strnatcmp($a['hash'], $b['hash']);
         }
         
@@ -369,7 +369,7 @@ 
         
         // to avoid re-creating the hash for the same texts over and over,
         // we keep track of the hashes we created, and re-use them.
-        if(isset($this->reverseStrings[$text])) {
+        if (isset($this->reverseStrings[$text])) {
             $hash = $this->reverseStrings[$text];
         } else {
             $hash = md5($text);
@@ -430,15 +430,15 @@ 
      * @param string $hash
      * @return string|NULL
      */
-    public function getHashTranslation($hash, Localization_Locale $locale=null)
+    public function getHashTranslation($hash, Localization_Locale $locale = null)
     {
-        if(!$locale) {
+        if (!$locale) {
             $locale = $this->targetLocale;
         }
         
         $localeName = $locale->getName();
         
-        if(isset($this->strings[$localeName]) && isset($this->strings[$localeName][$hash])) {
+        if (isset($this->strings[$localeName]) && isset($this->strings[$localeName][$hash])) {
             return $this->strings[$localeName][$hash];
         }
 
@@ -455,10 +455,10 @@ 
     {
         $result = array();
         
-        foreach($this->sources as $source) 
+        foreach ($this->sources as $source) 
         {
             $localeFile = self::getClientStorageFile($locale, $source);
-            if(!file_exists($localeFile)) {
+            if (!file_exists($localeFile)) {
                 continue;
             }
             

src/Localization/Scanner.php

Indentation +21 added lines, -21 removed lines

@@ -4,24 +4,24 @@ 
 
 class Localization_Scanner
 {
-   /**
-    * @var float
-    */
+    /**
+     * @var float
+     */
     protected $timeStart;
     
-   /**
-    * @var float
-    */
+    /**
+     * @var float
+     */
     protected $timeEnd;
     
-   /**
-    * @var array
-    */
+    /**
+     * @var array
+     */
     protected $stringInfos = array();
     
-   /**
-    * @var string
-    */
+    /**
+     * @var string
+     */
     protected $storageFile;
     
     /**
@@ -91,9 +91,9 @@ 
         \AppUtils\FileHelper::saveAsJSON($data, $this->storageFile);
     }
     
-   /**
-    * @var Localization_Parser
-    */
+    /**
+     * @var Localization_Parser
+     */
     protected $parser;
 
     public function getParser()
@@ -149,12 +149,12 @@ 
         return $this->getCollection()->countWarnings();
     }
     
-   /**
-    * Retrieves all warnings that have been registered
-    * during the last search for translateable texts.
-    * 
-    * @return \AppLocalize\Localization_Scanner_StringsCollection_Warning[]
-    */
+    /**
+     * Retrieves all warnings that have been registered
+     * during the last search for translateable texts.
+     * 
+     * @return \AppLocalize\Localization_Scanner_StringsCollection_Warning[]
+     */
     public function getWarnings()
     {
         return $this->getCollection()->getWarnings();

src/Localization/Scanner/StringsCollection/Warning.php

Indentation +3 added lines, -3 removed lines

@@ -6,9 +6,9 @@
 
 class Localization_Scanner_StringsCollection_Warning
 {
-   /**
-    * @var array
-    */
+    /**
+     * @var array
+     */
     protected $data;
     
     public function __construct(array $data)

src/Localization/Scanner/StringHash.php

Indentation +32 added lines, -32 removed lines

@@ -13,19 +13,19 @@ 
  */
 class Localization_Scanner_StringHash
 {
-   /**
-    * @var Localization_Scanner_StringsCollection
-    */
+    /**
+     * @var Localization_Scanner_StringsCollection
+     */
     protected $collection;
     
-   /**
-    * @var string
-    */
+    /**
+     * @var string
+     */
     protected $hash;
     
-   /**
-    * @var Localization_Scanner_StringInfo[]
-    */
+    /**
+     * @var Localization_Scanner_StringInfo[]
+     */
     protected $strings = array();
     
     protected $sourceIDs = array();
@@ -55,10 +55,10 @@ 
         return $entries;
     }
     
-   /**
-    * Retrieves all individual string locations where this text was found.
-    * @return Localization_Scanner_StringInfo[]
-    */
+    /**
+     * Retrieves all individual string locations where this text was found.
+     * @return Localization_Scanner_StringInfo[]
+     */
     public function getStrings()
     {
         return $this->strings;
@@ -118,10 +118,10 @@ 
         return count($this->strings);
     }
     
-   /**
-    * Retrieves the translated text, if any.
-    * @return string
-    */
+    /**
+     * Retrieves the translated text, if any.
+     * @return string
+     */
     public function getTranslatedText() : string
     {
         $translator = Localization::getTranslator();
@@ -134,10 +134,10 @@ 
         return '';
     }
     
-   /**
-    * Retrieves a list of all file names, with relative paths.
-    * @return string[]
-    */
+    /**
+     * Retrieves a list of all file names, with relative paths.
+     * @return string[]
+     */
     public function getFiles() : array
     {
         $files = array();
@@ -159,10 +159,10 @@ 
         return $files;
     }
     
-   /**
-    * Retrieves a list of all file names this string is used in.
-    * @return string[]
-    */
+    /**
+     * Retrieves a list of all file names this string is used in.
+     * @return string[]
+     */
     public function getFileNames() : array
     {
         $files = $this->getFiles();
@@ -179,13 +179,13 @@ 
         return $result;
     }
     
-   /**
-    * Retrieves a text comprised of all strings that are relevant
-    * for a full text search, imploded together. Used in the search
-    * function to find matching strings.
-    * 
-    * @return string
-    */
+    /**
+     * Retrieves a text comprised of all strings that are relevant
+     * for a full text search, imploded together. Used in the search
+     * function to find matching strings.
+     * 
+     * @return string
+     */
     public function getSearchString() : string
     {
         $parts = array($this->getTranslatedText(), $this->getText());

src/Localization/Source.php

Indentation +23 added lines, -23 removed lines

@@ -6,39 +6,39 @@
 
 abstract class Localization_Source
 {
-   /**
-    * Human readable label for the source.
-    * @var string
-    */
+    /**
+     * Human readable label for the source.
+     * @var string
+     */
     protected $label;
     
-   /**
-    * Human readable group name to categorize the source.
-    * @var string
-    */
+    /**
+     * Human readable group name to categorize the source.
+     * @var string
+     */
     protected $group;
     
-   /**
-    * The folder in which the localization files are stored
-    * @var string
-    */
+    /**
+     * The folder in which the localization files are stored
+     * @var string
+     */
     protected $storageFolder;
     
-   /**
-    * @var string
-    */
+    /**
+     * @var string
+     */
     protected $alias;
     
-   /**
-    * Available during scanning.
-    * @var Localization_Scanner_StringsCollection|NULL
-    */
+    /**
+     * Available during scanning.
+     * @var Localization_Scanner_StringsCollection|NULL
+     */
     protected $collection;
     
-   /**
-    * Available during scanning.
-    * @var Localization_Parser|NULL
-    */
+    /**
+     * Available during scanning.
+     * @var Localization_Parser|NULL
+     */
     protected $parser;
     
     public function __construct(string $alias, string $label, string $group, string $storageFolder)

src/jtokenizer.php

Spacing +4 added lines, -4 removed lines

@@ -44,7 +44,7 @@ 
     function __construct($i = null)
     {
         if (!is_null($i)) {
-            $this->i = (int)$i;
+            $this->i = (int) $i;
         }
     }
 
@@ -84,7 +84,7 @@ 
     {
         if (is_int($i)) {
             if (!isset($this->names[$i])) {
-                trigger_error("symbol " . var_export($i, true) . " is unknown in " . get_class($this), E_USER_NOTICE);
+                trigger_error("symbol ".var_export($i, true)." is unknown in ".get_class($this), E_USER_NOTICE);
 
                 return 'UNKNOWN';
             } else {
@@ -92,7 +92,7 @@ 
             }
         } else {
             if (!isset($this->literals[$i])) {
-                trigger_error("literal symbol " . var_export($i, true) . " is unknown in " . get_class($this), E_USER_NOTICE);
+                trigger_error("literal symbol ".var_export($i, true)." is unknown in ".get_class($this), E_USER_NOTICE);
             }
         }
 
@@ -112,7 +112,7 @@ 
     function dump()
     {
         asort($this->names, SORT_STRING);
-        $t = max(2, strlen((string)$this->i));
+        $t = max(2, strlen((string) $this->i));
         foreach ($this->names as $i => $n) {
             $i = str_pad($i, $t, ' ', STR_PAD_LEFT);
             echo "$i => $n \n";

src/Localization.php

Indentation +302 added lines, -302 removed lines

@@ -52,12 +52,12 @@ 
     
     const NAMESPACE_CONTENT = '__content';
     
-   /**
-    * Collection of all locales by namespace (application, content, custom...). 
-    *
-    * @var array
-    * @see Localization::addLocale()
-    */
+    /**
+     * Collection of all locales by namespace (application, content, custom...). 
+     *
+     * @var array
+     * @see Localization::addLocale()
+     */
     protected static $locales = array();
 
     /**
@@ -66,57 +66,57 @@ 
      */
     private static $initDone = false;
 
-   /**
-    * Path to the file in which the scanner results are stored.
-    * @var string
-    * @see Localization::configure()
-    */
+    /**
+     * Path to the file in which the scanner results are stored.
+     * @var string
+     * @see Localization::configure()
+     */
     protected static $storageFile = '';
     
-   /**
-    * Path to the folder into which the client libraries are written.
-    * @var string
-    * @see Localization::setClientLibrariesFolder()
-    */
+    /**
+     * Path to the folder into which the client libraries are written.
+     * @var string
+     * @see Localization::setClientLibrariesFolder()
+     */
     protected static $clientFolder = '';
     
-   /**
-    * If this key changes, client libraries are refreshed.
-    * @var string
-    * @see Localization::setClientLibrariesCacheKey()
-    */
+    /**
+     * If this key changes, client libraries are refreshed.
+     * @var string
+     * @see Localization::setClientLibrariesCacheKey()
+     */
     protected static $clientCacheKey = '';
     
-   /**
-    * Whether the configuration has been made.
-    * @var bool
-    * @see Localization::configure()
-    */
+    /**
+     * Whether the configuration has been made.
+     * @var bool
+     * @see Localization::configure()
+     */
     protected static $configured = false;
     
-   /**
-    * Stores event listener instances.
-    * @var array
-    */
+    /**
+     * Stores event listener instances.
+     * @var array
+     */
     protected static $listeners = array();
     
-   /**
-    * @var integer
-    * @see Localization::addEventListener()
-    */
+    /**
+     * @var integer
+     * @see Localization::addEventListener()
+     */
     protected static $listenersCounter = 0;
     
-   /**
-    * @var Localization_Translator|NULL
-    */
+    /**
+     * @var Localization_Translator|NULL
+     */
     protected static $translator;
     
-   /**
-    * Initializes the localization layer. This is done
-    * automatically, and only once per request.
-    * 
-    * (Called at the end of this file)
-    */
+    /**
+     * Initializes the localization layer. This is done
+     * automatically, and only once per request.
+     * 
+     * (Called at the end of this file)
+     */
     public static function init() : void
     {
         if(self::$initDone) {
@@ -155,12 +155,12 @@ 
         return self::getLocalesByNS(self::NAMESPACE_APPLICATION);
     }
     
-   /**
-    * Retrieves all locales in the specified namespace.
-    * 
-    * @param string $namespace
-    * @return Localization_Locale[]
-    */
+    /**
+     * Retrieves all locales in the specified namespace.
+     * 
+     * @param string $namespace
+     * @return Localization_Locale[]
+     */
     public static function getLocalesByNS(string $namespace)
     {
         if(isset(self::$locales[$namespace])) {
@@ -177,35 +177,35 @@ 
         );
     }
     
-   /**
-    * Adds an application locale to use in the application.
-    * 
-    * @param string $localeName
-    * @return Localization_Locale
-    */
+    /**
+     * Adds an application locale to use in the application.
+     * 
+     * @param string $localeName
+     * @return Localization_Locale
+     */
     public static function addAppLocale(string $localeName) : Localization_Locale
     {
         return self::addLocaleByNS($localeName, self::NAMESPACE_APPLICATION);
     }
     
-   /**
-    * Adds a content locale to use for content in the application.
-    * 
-    * @param string $localeName
-    * @return Localization_Locale
-    */
+    /**
+     * Adds a content locale to use for content in the application.
+     * 
+     * @param string $localeName
+     * @return Localization_Locale
+     */
     public static function addContentLocale(string $localeName) : Localization_Locale
     {
         return self::addLocaleByNS($localeName, self::NAMESPACE_CONTENT);
     }
     
-   /**
-    * Adds a locale to the specified namespace.
-    * 
-    * @param string $localeName
-    * @param string $namespace
-    * @return Localization_Locale
-    */
+    /**
+     * Adds a locale to the specified namespace.
+     * 
+     * @param string $localeName
+     * @param string $namespace
+     * @return Localization_Locale
+     */
     public static function addLocaleByNS(string $localeName, string $namespace) : Localization_Locale
     {
         if(!isset(self::$locales[$namespace])) {
@@ -247,11 +247,11 @@ 
         return new $className();
     }
     
-   /**
-    * Retrieves the currency of the selected app locale.
-    * 
-    * @return Localization_Currency
-    */
+    /**
+     * Retrieves the currency of the selected app locale.
+     * 
+     * @return Localization_Currency
+     */
     public static function getAppCurrency() : Localization_Currency
     {
         return self::getCurrencyNS(self::NAMESPACE_APPLICATION);
@@ -288,44 +288,44 @@ 
         return self::getSelectedLocaleByNS(self::NAMESPACE_APPLICATION);
     }
     
-   /**
-    * Retrieves the name of the selected application locale.
-    * 
-    * @return string
-    */
+    /**
+     * Retrieves the name of the selected application locale.
+     * 
+     * @return string
+     */
     public static function getAppLocaleName() : string
     {
         return self::getLocaleNameByNS(self::NAMESPACE_APPLICATION);
     }
     
-   /**
-    * Retrieves the names of the available application locales.
-    * @return string[]
-    */
+    /**
+     * Retrieves the names of the available application locales.
+     * @return string[]
+     */
     public static function getAppLocaleNames() : array
     {
         return self::getLocaleNamesByNS(self::NAMESPACE_APPLICATION);
     }
     
-   /**
-    * Retrieves the selected locale name in the specified namespace.
-    * 
-    * @param string $namespace
-    * @throws Localization_Exception
-    * @return string
-    */
+    /**
+     * Retrieves the selected locale name in the specified namespace.
+     * 
+     * @param string $namespace
+     * @throws Localization_Exception
+     * @return string
+     */
     public static function getLocaleNameByNS(string $namespace) : string
     {
         return self::getSelectedKeyByNS('name', $namespace);
     }
     
-   /**
-    * Retrieves the selected locale instance for the specified namespace.
-    * 
-    * @param string $namespace
-    * @return Localization_Locale
-    * @throws Localization_Exception
-    */
+    /**
+     * Retrieves the selected locale instance for the specified namespace.
+     * 
+     * @param string $namespace
+     * @return Localization_Locale
+     * @throws Localization_Exception
+     */
     public static function getSelectedLocaleByNS(string $namespace) : Localization_Locale
     {
         return self::getSelectedKeyByNS('locale', $namespace);
@@ -350,20 +350,20 @@ 
         );
     }
     
-   /**
-    * Stores the selected locale names by namespace.
-    * @var array
-    */
+    /**
+     * Stores the selected locale names by namespace.
+     * @var array
+     */
     protected static $selected = array();
 
-   /**
-    * Selects the active locale for the specified namespace.
-    * 
-    * @param string $localeName
-    * @param string $namespace
-    * @return Localization_Locale
-    * @throws Localization_Exception
-    */
+    /**
+     * Selects the active locale for the specified namespace.
+     * 
+     * @param string $localeName
+     * @param string $namespace
+     * @return Localization_Locale
+     * @throws Localization_Exception
+     */
     public static function selectLocaleByNS(string $localeName, string $namespace) : Localization_Locale
     {
         self::requireNamespace($namespace);
@@ -399,13 +399,13 @@ 
         return $locale;
     }
     
-   /**
-    * Triggers the specified event, with the provided arguments.
-    * 
-    * @param string $name The event name.
-    * @param array $argsList
-    * @see Localization_Event
-    */
+    /**
+     * Triggers the specified event, with the provided arguments.
+     * 
+     * @param string $name The event name.
+     * @param array $argsList
+     * @see Localization_Event
+     */
     protected static function triggerEvent(string $name, array $argsList) : Localization_Event
     {
         $class = '\AppLocalize\Localization_Event_'.$name;
@@ -426,14 +426,14 @@ 
         return $event;
     }
     
-   /**
-    * Adds a listener to the specified event name.
-    * 
-    * @param string $eventName
-    * @param callable $callback
-    * @param array $args Additional arguments to add to the event
-    * @return int The listener number.
-    */
+    /**
+     * Adds a listener to the specified event name.
+     * 
+     * @param string $eventName
+     * @param callable $callback
+     * @param array $args Additional arguments to add to the event
+     * @return int The listener number.
+     */
     public static function addEventListener(string $eventName, $callback, array $args=array()) : int
     {
         if(!isset(self::$listeners[$eventName])) {
@@ -463,43 +463,43 @@ 
         return self::$listenersCounter;
     }
     
-   /**
-    * Adds an event listener for the <code>LocaleChanged</code> event,
-    * which is triggered every time a locale is changed in any of the
-    * available namespaces.
-    * 
-    * The first parameter of the callback is always the event instance.
-    * 
-    * @param callable $callback The listener function to call.
-    * @param array $args Optional indexed array with additional arguments to pass on to the callback function.
-    * @return int
-    * @see Localization_Event_LocaleChanged
-    */
+    /**
+     * Adds an event listener for the <code>LocaleChanged</code> event,
+     * which is triggered every time a locale is changed in any of the
+     * available namespaces.
+     * 
+     * The first parameter of the callback is always the event instance.
+     * 
+     * @param callable $callback The listener function to call.
+     * @param array $args Optional indexed array with additional arguments to pass on to the callback function.
+     * @return int
+     * @see Localization_Event_LocaleChanged
+     */
     public static function onLocaleChanged($callback, array $args=array()) : int
     {
         return self::addEventListener('LocaleChanged', $callback, $args);
     }
     
-   /**
-    * Selects the application locale to use.
-    * 
-    * @param string $localeName
-    * @return Localization_Locale
-    */
+    /**
+     * Selects the application locale to use.
+     * 
+     * @param string $localeName
+     * @return Localization_Locale
+     */
     public static function selectAppLocale(string $localeName) : Localization_Locale
     {
         return self::selectLocaleByNS($localeName, self::NAMESPACE_APPLICATION);
     }
 
-   /**
-    * Retrieves an application locale by its name. 
-    * Note that the locale must have been added first.
-    * 
-    * @param string $localeName
-    * @throws Localization_Exception
-    * @return Localization_Locale
-    * @see Localization::appLocaleExists()
-    */
+    /**
+     * Retrieves an application locale by its name. 
+     * Note that the locale must have been added first.
+     * 
+     * @param string $localeName
+     * @throws Localization_Exception
+     * @return Localization_Locale
+     * @see Localization::appLocaleExists()
+     */
     public static function getAppLocaleByName(string $localeName) : Localization_Locale
     {
         return self::getLocaleByNameNS($localeName, self::NAMESPACE_APPLICATION);
@@ -533,22 +533,22 @@ 
         return self::getLocalesByNS(self::NAMESPACE_CONTENT);
     }
     
-   /**
-    * Retrieves the names of all content locales that have been added.
-    * @return string[]
-    */
+    /**
+     * Retrieves the names of all content locales that have been added.
+     * @return string[]
+     */
     public static function getContentLocaleNames()
     {
         return self::getLocaleNamesByNS(self::NAMESPACE_CONTENT);
     }
     
-   /**
-    * Retrieves all locale names available in the specified namespace.
-    * The names are sorted alphabetically.
-    * 
-    * @param string $namespace
-    * @return array|array
-    */
+    /**
+     * Retrieves all locale names available in the specified namespace.
+     * The names are sorted alphabetically.
+     * 
+     * @param string $namespace
+     * @return array|array
+     */
     public static function getLocaleNamesByNS(string $namespace)
     {
         self::requireNamespace($namespace);
@@ -558,7 +558,7 @@ 
         sort($names);
         
         return $names;
-     }
+        }
     
     /**
      * Checks by the locale name if the specified locale is
@@ -587,14 +587,14 @@ 
         return self::getLocaleByNameNS($localeName, self::NAMESPACE_CONTENT);
     }
     
-   /**
-    * Retrieves a locale by its name in the specified namespace.
-    * 
-    * @param string $localeName
-    * @param string $namespace
-    * @throws Localization_Exception
-    * @return Localization_Locale
-    */
+    /**
+     * Retrieves a locale by its name in the specified namespace.
+     * 
+     * @param string $localeName
+     * @param string $namespace
+     * @throws Localization_Exception
+     * @return Localization_Locale
+     */
     public static function getLocaleByNameNS(string $localeName, string $namespace) : Localization_Locale
     {
         self::requireNamespace($namespace);
@@ -654,10 +654,10 @@ 
         return self::selectLocaleByNS($localeName, self::NAMESPACE_CONTENT);
     }
     
-   /**
-    * Checks whether the localization has been configured entirely.
-    * @return bool
-    */
+    /**
+     * Checks whether the localization has been configured entirely.
+     * @return bool
+     */
     public static function isConfigured() : bool
     {
         return self::$configured;
@@ -724,29 +724,29 @@ 
         );
     }
     
-   /**
-    * Injects a content locales selector element into the specified
-    * HTML QuickForm2 container.
-    * 
-    * @param string $elementName
-    * @param \HTML_QuickForm2_Container $container
-    * @param string $label
-    * @return \HTML_QuickForm2_Element_Select
-    */
+    /**
+     * Injects a content locales selector element into the specified
+     * HTML QuickForm2 container.
+     * 
+     * @param string $elementName
+     * @param \HTML_QuickForm2_Container $container
+     * @param string $label
+     * @return \HTML_QuickForm2_Element_Select
+     */
     public static function injectContentLocalesSelector(string $elementName, \HTML_QuickForm2_Container $container, string $label='') : \HTML_QuickForm2_Element_Select
     {
         return self::injectLocalesSelectorNS($elementName, self::NAMESPACE_CONTENT, $container, $label);
     }
     
-   /**
-    * Injects an app locales selector element into the specified
+    /**
+     * Injects an app locales selector element into the specified
      * HTML QuickForm2 container.
      * 
-    * @param string $elementName
-    * @param \HTML_QuickForm2_Container $container
-    * @param string $label
-    * @return \HTML_QuickForm2_Element_Select
-    */
+     * @param string $elementName
+     * @param \HTML_QuickForm2_Container $container
+     * @param string $label
+     * @return \HTML_QuickForm2_Element_Select
+     */
     public static function injectAppLocalesSelector(string $elementName, \HTML_QuickForm2_Container $container, string $label='') : \HTML_QuickForm2_Element_Select
     {
         return self::injectLocalesSelectorNS($elementName, self::NAMESPACE_APPLICATION, $container, $label);
@@ -781,26 +781,26 @@ 
         return $select;
     }
 
-   /**
-    * @var Localization_Source[]
-    */
+    /**
+     * @var Localization_Source[]
+     */
     protected static $sources = array();
     
-   /**
-    * @var string[]
-    */
+    /**
+     * @var string[]
+     */
     protected static $excludeFolders = array();
     
-   /**
-    * @var string[]
-    */
+    /**
+     * @var string[]
+     */
     protected static $excludeFiles = array();
     
-   /**
-    * Retrieves all currently available sources.
-    * 
-    * @return \AppLocalize\Localization_Source[]
-    */
+    /**
+     * Retrieves all currently available sources.
+     * 
+     * @return \AppLocalize\Localization_Source[]
+     */
     public static function getSources()
     {
         return self::$sources;
@@ -832,10 +832,10 @@ 
         return $source;
     }
     
-   /**
-    * Retrieves all sources grouped by their group name.
-    * @return array
-    */
+    /**
+     * Retrieves all sources grouped by their group name.
+     * @return array
+     */
     public static function getSourcesGrouped()
     {
         $sources = self::getSources();
@@ -856,11 +856,11 @@ 
         return $grouped;
     }
     
-   /**
-    * Checks whether a specific source exists by its ID.
-    * @param string $sourceID
-    * @return boolean
-    */
+    /**
+     * Checks whether a specific source exists by its ID.
+     * @param string $sourceID
+     * @return boolean
+     */
     public static function sourceExists(string $sourceID) : bool
     {
         $sources = self::getSources();
@@ -873,11 +873,11 @@ 
         return false;
     }
     
-   /**
-    * Checks whether a specific source exists by its alias.
-    * @param string $sourceAlias
-    * @return boolean
-    */
+    /**
+     * Checks whether a specific source exists by its alias.
+     * @param string $sourceAlias
+     * @return boolean
+     */
     public static function sourceAliasExists(string $sourceAlias) : bool
     {
         $sources = self::getSources();
@@ -890,13 +890,13 @@ 
         return false;
     }
 
-   /**
-    * Retrieves a localization source by its ID.
-    * 
-    * @param string $sourceID
-    * @throws Localization_Exception
-    * @return Localization_Source
-    */
+    /**
+     * Retrieves a localization source by its ID.
+     * 
+     * @param string $sourceID
+     * @throws Localization_Exception
+     * @return Localization_Source
+     */
     public static function getSourceByID(string $sourceID) : Localization_Source
     {
         $sources = self::getSources();
@@ -942,12 +942,12 @@ 
         );
     }
     
-   /**
-    * Creates the scanner instance that is used to find
-    * all translateable strings in the application.
-    * 
-    * @return Localization_Scanner
-    */
+    /**
+     * Creates the scanner instance that is used to find
+     * all translateable strings in the application.
+     * 
+     * @return Localization_Scanner
+     */
     public static function createScanner() : Localization_Scanner
     {
         self::requireConfiguration();
@@ -960,14 +960,14 @@ 
         // FIXME: TODO: Add this
     }
     
-   /**
-    * Configures the localization for the application:
-    * sets the location of the required files and folders.
-    * Also updated the client library files as needed.
-    * 
-    * @param string $storageFile Where to store the file analysis storage file.
-    * @param string $clientLibrariesFolder Where to put the client libraries and translation files. Will be created if it does not exist. Optional: if not set, client libraries will not be created.
-    */
+    /**
+     * Configures the localization for the application:
+     * sets the location of the required files and folders.
+     * Also updated the client library files as needed.
+     * 
+     * @param string $storageFile Where to store the file analysis storage file.
+     * @param string $clientLibrariesFolder Where to put the client libraries and translation files. Will be created if it does not exist. Optional: if not set, client libraries will not be created.
+     */
     public static function configure(string $storageFile, string $clientLibrariesFolder='')
     {
         self::$configured = true;
@@ -983,17 +983,17 @@ 
         }
     }
     
-   /**
-    * Sets a key that is used to verify whether the client
-    * libraries have to be refreshed. A common use is to set
-    * this to the application's version number to guarantee
-    * new texts are automatically used with each release.
-    * 
-    * NOTE: Otherwise files are refreshed only when saving 
-    * them in the editor UI.
-    *  
-    * @param string $key
-    */
+    /**
+     * Sets a key that is used to verify whether the client
+     * libraries have to be refreshed. A common use is to set
+     * this to the application's version number to guarantee
+     * new texts are automatically used with each release.
+     * 
+     * NOTE: Otherwise files are refreshed only when saving 
+     * them in the editor UI.
+     *  
+     * @param string $key
+     */
     public static function setClientLibrariesCacheKey(string $key)
     {
         self::$clientCacheKey = $key;
@@ -1004,48 +1004,48 @@ 
         return self::$clientCacheKey;
     }
     
-   /**
-    * Sets the folder where client libraries are to be stored.
-    * @param string $folder
-    */
+    /**
+     * Sets the folder where client libraries are to be stored.
+     * @param string $folder
+     */
     public static function setClientLibrariesFolder(string $folder)
     {
         self::$clientFolder = $folder;
     }
     
-   /**
-    * Retrieves the path to the folder in which the client
-    * libraries should be stored.
-    * 
-    * NOTE: Can return an empty string, when this is disabled.
-    * 
-    * @return string
-    */
+    /**
+     * Retrieves the path to the folder in which the client
+     * libraries should be stored.
+     * 
+     * NOTE: Can return an empty string, when this is disabled.
+     * 
+     * @return string
+     */
     public static function getClientLibrariesFolder() : string
     {
         return self::$clientFolder;
     }
     
-   /**
-    * Writes / updates the client library files on disk,
-    * at the location specified in the {@link Localization::configure()}
-    * method.
-    * 
-    * @see Localization_ClientGenerator
-    * @param bool $force Whether to refresh the files, even if they exist.
-    */
+    /**
+     * Writes / updates the client library files on disk,
+     * at the location specified in the {@link Localization::configure()}
+     * method.
+     * 
+     * @see Localization_ClientGenerator
+     * @param bool $force Whether to refresh the files, even if they exist.
+     */
     public static function writeClientFiles(bool $force=false) : void
     {
         self::createGenerator()->writeFiles($force);
     }
     
-   /**
-    * Creates a new instance of the client generator class
-    * that is used to write the localization files into the
-    * target folder on disk.
-    * 
-    * @return Localization_ClientGenerator
-    */
+    /**
+     * Creates a new instance of the client generator class
+     * that is used to write the localization files into the
+     * target folder on disk.
+     * 
+     * @return Localization_ClientGenerator
+     */
     public static function createGenerator() : Localization_ClientGenerator
     {
         return new Localization_ClientGenerator();
@@ -1088,13 +1088,13 @@ 
         }
     }
     
-   /**
-    * Creates the editor instance that can be used to 
-    * display the localization UI to edit translateable
-    * strings in the browser.
-    * 
-    * @return \AppLocalize\Localization_Editor
-    */
+    /**
+     * Creates the editor instance that can be used to 
+     * display the localization UI to edit translateable
+     * strings in the browser.
+     * 
+     * @return \AppLocalize\Localization_Editor
+     */
     public static function createEditor() : Localization_Editor
     {
         self::requireConfiguration();
@@ -1102,10 +1102,10 @@ 
         return new Localization_Editor();
     }
     
-   /**
-    * Retrieves a list of all available source IDs.
-    * @return string[]
-    */
+    /**
+     * Retrieves a list of all available source IDs.
+     * @return string[]
+     */
     public static function getSourceIDs()
     {
         $ids = array();
@@ -1132,9 +1132,9 @@ 
         return $aliases;
     }
     
-   /**
-    * Resets all locales to the built-in locale.
-    */
+    /**
+     * Resets all locales to the built-in locale.
+     */
     public static function reset() : void
     {
         self::$locales = array();
@@ -1166,22 +1166,22 @@ 
         'de_CH'
     );
     
-   /**
-    * Retrieves a list of all supported locales.
-    * 
-    * @return array
-    */
+    /**
+     * Retrieves a list of all supported locales.
+     * 
+     * @return array
+     */
     public static function getSupportedLocaleNames() : array
     {
         return self::$supportedLocales;
     }
     
-   /**
-    * Checks whether the specified locale is supported.
-    * 
-    * @param string $localeName
-    * @return bool
-    */
+    /**
+     * Checks whether the specified locale is supported.
+     * 
+     * @param string $localeName
+     * @return bool
+     */
     public static function isLocaleSupported(string $localeName) : bool
     {
         return in_array($localeName, self::$supportedLocales);

Spacing +45 added lines, -45 removed lines

@@ -119,7 +119,7 @@ 
     */
     public static function init() : void
     {
-        if(self::$initDone) {
+        if (self::$initDone) {
             return;
         }
 
@@ -163,7 +163,7 @@ 
     */
     public static function getLocalesByNS(string $namespace)
     {
-        if(isset(self::$locales[$namespace])) {
+        if (isset(self::$locales[$namespace])) {
             return array_values(self::$locales[$namespace]);
         }
         
@@ -208,11 +208,11 @@ 
     */
     public static function addLocaleByNS(string $localeName, string $namespace) : Localization_Locale
     {
-        if(!isset(self::$locales[$namespace])) {
+        if (!isset(self::$locales[$namespace])) {
             self::$locales[$namespace] = array();
         }
         
-        if(!isset(self::$locales[$namespace][$localeName])) 
+        if (!isset(self::$locales[$namespace][$localeName])) 
         {
             self::$locales[$namespace][$localeName] = self::createLocale($localeName);
             
@@ -243,7 +243,7 @@ 
      */
     public static function createCountry(string $id)
     {
-        $className = '\AppLocalize\Localization_Country_' . strtoupper($id);
+        $className = '\AppLocalize\Localization_Country_'.strtoupper($id);
         return new $className();
     }
     
@@ -335,7 +335,7 @@ 
     {
         self::requireNamespace($namespace);
         
-        if(isset(self::$selected[$namespace])) {
+        if (isset(self::$selected[$namespace])) {
             return self::$selected[$namespace][$key];
         }
         
@@ -371,9 +371,9 @@ 
         $locale = self::addLocaleByNS($localeName, $namespace);
         $previous = null;
         
-        if(isset(self::$selected[$namespace])) 
+        if (isset(self::$selected[$namespace])) 
         {
-            if(self::$selected[$namespace]['name'] === $localeName) {
+            if (self::$selected[$namespace]['name'] === $localeName) {
                 return $locale;
             }
             
@@ -411,11 +411,11 @@ 
         $class = '\AppLocalize\Localization_Event_'.$name;
         $event = new $class($argsList);
         
-        if(!isset(self::$listeners[$name])) {
+        if (!isset(self::$listeners[$name])) {
             return $event;
         }
         
-        foreach(self::$listeners[$name] as $listener) 
+        foreach (self::$listeners[$name] as $listener) 
         {
             $callArgs = $listener['args'];
             array_unshift($callArgs, $event);
@@ -434,15 +434,15 @@ 
     * @param array $args Additional arguments to add to the event
     * @return int The listener number.
     */
-    public static function addEventListener(string $eventName, $callback, array $args=array()) : int
+    public static function addEventListener(string $eventName, $callback, array $args = array()) : int
     {
-        if(!isset(self::$listeners[$eventName])) {
+        if (!isset(self::$listeners[$eventName])) {
             self::$listeners[$eventName] = array();
         }
         
         $className = '\AppLocalize\Localization_Event_'.$eventName;
         
-        if(!class_exists($className)) 
+        if (!class_exists($className)) 
         {
             throw new Localization_Exception(
                 sprintf('Unknown localization event [%s].', $eventName),
@@ -475,7 +475,7 @@ 
     * @return int
     * @see Localization_Event_LocaleChanged
     */
-    public static function onLocaleChanged($callback, array $args=array()) : int
+    public static function onLocaleChanged($callback, array $args = array()) : int
     {
         return self::addEventListener('LocaleChanged', $callback, $args);
     }
@@ -599,7 +599,7 @@ 
     {
         self::requireNamespace($namespace);
         
-        if(isset(self::$locales[$namespace]) && isset(self::$locales[$namespace][$localeName])) {
+        if (isset(self::$locales[$namespace]) && isset(self::$locales[$namespace][$localeName])) {
             return self::$locales[$namespace][$localeName];
         }
         
@@ -666,9 +666,9 @@ 
     /**
      * @return Localization_Translator
      */
-    public static function getTranslator(Localization_Locale $locale=null) : Localization_Translator
+    public static function getTranslator(Localization_Locale $locale = null) : Localization_Translator
     {
-        if($locale !== null)
+        if ($locale !== null)
         {
             $obj = new Localization_Translator();
             $obj->addSources(self::getSources());
@@ -676,7 +676,7 @@ 
             return $obj;
         }
             
-        if(!isset(self::$translator)) 
+        if (!isset(self::$translator)) 
         {
             $obj = new Localization_Translator();
             $obj->addSources(self::getSources());
@@ -701,7 +701,7 @@ 
     {
         self::requireNamespace($namespace);
         
-        if(isset(self::$locales[$namespace])) {
+        if (isset(self::$locales[$namespace])) {
             return count(self::$locales[$namespace]);
         }
         
@@ -710,7 +710,7 @@ 
     
     protected static function requireNamespace(string $namespace)
     {
-        if(isset(self::$locales[$namespace])) {
+        if (isset(self::$locales[$namespace])) {
             return;
         }
         
@@ -733,7 +733,7 @@ 
     * @param string $label
     * @return \HTML_QuickForm2_Element_Select
     */
-    public static function injectContentLocalesSelector(string $elementName, \HTML_QuickForm2_Container $container, string $label='') : \HTML_QuickForm2_Element_Select
+    public static function injectContentLocalesSelector(string $elementName, \HTML_QuickForm2_Container $container, string $label = '') : \HTML_QuickForm2_Element_Select
     {
         return self::injectLocalesSelectorNS($elementName, self::NAMESPACE_CONTENT, $container, $label);
     }
@@ -747,7 +747,7 @@ 
     * @param string $label
     * @return \HTML_QuickForm2_Element_Select
     */
-    public static function injectAppLocalesSelector(string $elementName, \HTML_QuickForm2_Container $container, string $label='') : \HTML_QuickForm2_Element_Select
+    public static function injectAppLocalesSelector(string $elementName, \HTML_QuickForm2_Container $container, string $label = '') : \HTML_QuickForm2_Element_Select
     {
         return self::injectLocalesSelectorNS($elementName, self::NAMESPACE_APPLICATION, $container, $label);
     }
@@ -762,9 +762,9 @@ 
      * @param \HTML_QuickForm2_Container $container
      * @return \HTML_QuickForm2_Element_Select
      */
-    public static function injectLocalesSelectorNS(string $elementName, string $namespace, \HTML_QuickForm2_Container $container, string $label='') : \HTML_QuickForm2_Element_Select
+    public static function injectLocalesSelectorNS(string $elementName, string $namespace, \HTML_QuickForm2_Container $container, string $label = '') : \HTML_QuickForm2_Element_Select
     {
-        if(empty($label)) {
+        if (empty($label)) {
             $label = t('Language');
         }
 
@@ -774,7 +774,7 @@ 
 
         $locales = self::getLocalesByNS($namespace);
         
-        foreach($locales as $locale) {
+        foreach ($locales as $locale) {
             $select->addOption($locale->getLabel(), $locale->getName());
         }
 
@@ -808,14 +808,14 @@ 
     
     public static function addExcludeFolder(string $folderName) : void
     { 
-        if(!in_array($folderName, self::$excludeFolders)) {
+        if (!in_array($folderName, self::$excludeFolders)) {
             self::$excludeFolders[] = $folderName;
         }
     }
     
     public static function addExcludeFile(string $fileName) : void
     {
-        if(!in_array($fileName, self::$excludeFiles)) {
+        if (!in_array($fileName, self::$excludeFiles)) {
             self::$excludeFiles[] = $fileName;
         }
     }
@@ -842,11 +842,11 @@ 
         
         $grouped = array();
         
-        foreach($sources as $source) 
+        foreach ($sources as $source) 
         {
             $group = $source->getGroup();
             
-            if(!isset($grouped[$group])) {
+            if (!isset($grouped[$group])) {
                 $grouped[$group] = array();
             }
             
@@ -864,8 +864,8 @@ 
     public static function sourceExists(string $sourceID) : bool
     {
         $sources = self::getSources();
-        foreach($sources as $source) {
-            if($source->getID() == $sourceID) {
+        foreach ($sources as $source) {
+            if ($source->getID() == $sourceID) {
                 return true;
             }
         }
@@ -881,8 +881,8 @@ 
     public static function sourceAliasExists(string $sourceAlias) : bool
     {
         $sources = self::getSources();
-        foreach($sources as $source) {
-            if($source->getAlias() == $sourceAlias) {
+        foreach ($sources as $source) {
+            if ($source->getAlias() == $sourceAlias) {
                 return true;
             }
         }
@@ -900,8 +900,8 @@ 
     public static function getSourceByID(string $sourceID) : Localization_Source
     {
         $sources = self::getSources();
-        foreach($sources as $source) {
-            if($source->getID() == $sourceID) {
+        foreach ($sources as $source) {
+            if ($source->getID() == $sourceID) {
                 return $source;
             }
         }
@@ -926,8 +926,8 @@ 
     public static function getSourceByAlias(string $sourceAlias) : Localization_Source
     {
         $sources = self::getSources();
-        foreach($sources as $source) {
-            if($source->getAlias() == $sourceAlias) {
+        foreach ($sources as $source) {
+            if ($source->getAlias() == $sourceAlias) {
                 return $source;
             }
         }
@@ -968,7 +968,7 @@ 
     * @param string $storageFile Where to store the file analysis storage file.
     * @param string $clientLibrariesFolder Where to put the client libraries and translation files. Will be created if it does not exist. Optional: if not set, client libraries will not be created.
     */
-    public static function configure(string $storageFile, string $clientLibrariesFolder='')
+    public static function configure(string $storageFile, string $clientLibrariesFolder = '')
     {
         self::$configured = true;
         
@@ -977,7 +977,7 @@ 
 
         // only write the client libraries to disk if the folder
         // has been specified.
-        if(!empty($clientLibrariesFolder)) 
+        if (!empty($clientLibrariesFolder)) 
         {
             self::writeClientFiles();
         }
@@ -1034,7 +1034,7 @@ 
     * @see Localization_ClientGenerator
     * @param bool $force Whether to refresh the files, even if they exist.
     */
-    public static function writeClientFiles(bool $force=false) : void
+    public static function writeClientFiles(bool $force = false) : void
     {
         self::createGenerator()->writeFiles($force);
     }
@@ -1060,7 +1060,7 @@ 
     
     protected static function requireConfiguration()
     {
-        if(!self::$configured) 
+        if (!self::$configured) 
         {
             throw new Localization_Exception(
                 'The localization configuration is incomplete.',
@@ -1069,7 +1069,7 @@ 
             );
         }
 
-        if(empty(self::$storageFile))
+        if (empty(self::$storageFile))
         {
             throw new Localization_Exception(
                 'No localization storage file set',
@@ -1078,7 +1078,7 @@ 
             );
         }
         
-        if(empty(self::$sources)) 
+        if (empty(self::$sources)) 
         {
             throw new Localization_Exception(
                 'No source folders have been defined.',
@@ -1110,7 +1110,7 @@ 
     {
         $ids = array();
         
-        foreach(self::$sources as $source) {
+        foreach (self::$sources as $source) {
             $ids[] = $source->getID();
         }
         
@@ -1125,7 +1125,7 @@ 
     {
         $aliases = array();
         
-        foreach(self::$sources as $source) {
+        foreach (self::$sources as $source) {
             $aliases[] = $source->getAlias();
         }