Initial commit

web/vendor/icanboogie/common/LICENSE

@@ -0,0 +1,30 @@
+The ICanBoogie/Common package is free software.
+It is released under the terms of the following BSD License. 
+
+Copyright (c) 2007-2014 by Olivier Laviale
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+    * Redistributions of source code must retain the above copyright notice,
+      this list of conditions and the following disclaimer.
+
+    * Redistributions in binary form must reproduce the above copyright notice,
+      this list of conditions and the following disclaimer in the documentation
+      and/or other materials provided with the distribution.
+
+    * Neither the name of Olivier Laviale nor the names of its
+      contributors may be used to endorse or promote products derived from this
+      software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

web/vendor/icanboogie/common/Makefile

@@ -0,0 +1,34 @@
+# customization
+
+PACKAGE_NAME = "ICanBoogie/Common"
+
+# do not edit the following lines
+
+usage:
+	@echo "test:  Runs the test suite.\ndoc:   Creates the documentation.\nclean: Removes the documentation, the dependencies and the Composer files."
+
+composer.phar:
+	@echo "Installing composer..."
+	@curl -s https://getcomposer.org/installer | php
+
+vendor: composer.phar
+	@php composer.phar install --dev
+	
+test: vendor
+	@phpunit
+
+doc: vendor
+	@mkdir -p "docs"
+
+	@apigen \
+	--source ./ \
+	--destination docs/ --title $(PACKAGE_NAME) \
+	--exclude "*/composer/*" \
+	--exclude "*/tests/*" \
+	--template-config /usr/share/php/data/ApiGen/templates/bootstrap/config.neon
+	
+clean:
+	@rm -fR docs
+	@rm -fR vendor
+	@rm -f composer.lock
+	@rm -f composer.phar

web/vendor/icanboogie/common/bootstrap.php

@@ -0,0 +1,24 @@
+<?php
+
+/*
+ * This file is part of the ICanBoogie package.
+ *
+ * (c) Olivier Laviale <olivier.laviale@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace ICanBoogie;
+
+/**
+ * The charset used by the application. Defaults to "utf-8".
+ *
+ * @var string
+ */
+defined('ICanBoogie\CHARSET') or define('ICanBoogie\CHARSET', 'utf-8');
+
+if (function_exists('mb_internal_encoding'))
+{
+	mb_internal_encoding(CHARSET);
+}

web/vendor/icanboogie/common/lib/exceptions.php

@@ -0,0 +1,331 @@
+<?php
+
+/*
+ * This file is part of the ICanBoogie package.
+ *
+ * (c) Olivier Laviale <olivier.laviale@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace ICanBoogie;
+
+/**
+ * Exception thrown when there is something wrong with an array offset.
+ *
+ * This is the base class for offset exceptions, one should rather use the
+ * {@link OffsetNotReadable} or {@link OffsetNotWritable} exceptions.
+ */
+class OffsetError extends \RuntimeException
+{
+
+}
+
+/**
+ * Exception thrown when an array offset is not defined.
+ *
+ * For example, this could be triggered by an offset out of bounds while setting an array value.
+ */
+class OffsetNotDefined extends OffsetError
+{
+	public function __construct($message, $code=500, \Exception $previous=null)
+	{
+		if (is_array($message))
+		{
+			list($offset, $container) = $message + array(1 => null);
+
+			if (is_object($container))
+			{
+				$message = format
+				(
+					'Undefined offset %offset for object of class %class.', array
+					(
+						'%offset' => $offset,
+						'%class' => get_class($container)
+					)
+				);
+			}
+			else if (is_array($container))
+			{
+				$message = format
+				(
+					'Undefined offset %offset for the array: !array', array
+					(
+						'%offset' => $offset,
+						'!array' => $container
+					)
+				);
+			}
+			else
+			{
+				$message = format
+				(
+					'Undefined offset %offset.', array
+					(
+						'%offset' => $offset
+					)
+				);
+			}
+		}
+
+		parent::__construct($message, $code, $previous);
+	}
+}
+
+/**
+ * Exception thrown when an array offset is not readable.
+ */
+class OffsetNotReadable extends OffsetError
+{
+	public function __construct($message, $code=500, \Exception $previous=null)
+	{
+		if (is_array($message))
+		{
+			list($offset, $container) = $message + array(1 => null);
+
+			if (is_object($container))
+			{
+				$message = format
+				(
+					'The offset %offset for object of class %class is not readable.', array
+					(
+						'offset' => $offset,
+						'class' => get_class($container)
+					)
+				);
+			}
+			else if (is_array($container))
+			{
+				$message = format
+				(
+					'The offset %offset is not readable for the array: !array', array
+					(
+						'offset' => $offset,
+						'array' => $container
+					)
+				);
+			}
+			else
+			{
+				$message = format
+				(
+					'The offset %offset is not readable.', array
+					(
+						'offset' => $offset
+					)
+				);
+			}
+		}
+
+		parent::__construct($message, $code, $previous);
+	}
+}
+
+/**
+ * Exception thrown when an array offset is not writable.
+ */
+class OffsetNotWritable extends OffsetError
+{
+	public function __construct($message, $code=500, \Exception $previous=null)
+	{
+		if (is_array($message))
+		{
+			list($offset, $container) = $message + array(1 => null);
+
+			if (is_object($container))
+			{
+				$message = format
+				(
+					'The offset %offset for object of class %class is not writable.', array
+					(
+						'offset' => $offset,
+						'class' => get_class($container)
+					)
+				);
+			}
+			else if (is_array($container))
+			{
+				$message = format
+				(
+					'The offset %offset is not writable for the array: !array', array
+					(
+						'offset' => $offset,
+						'array' => $container
+					)
+				);
+			}
+			else
+			{
+				$message = format
+				(
+					'The offset %offset is not writable.', array
+					(
+						'offset' => $offset
+					)
+				);
+			}
+		}
+
+		parent::__construct($message, $code, $previous);
+	}
+}
+
+/**
+ * Exception thrown when there is something wrong with an object property.
+ *
+ * This is the base class for property exceptions, one should rather use the
+ * {@link PropertyNotDefined}, {@link PropertyNotReadable} or {@link PropertyNotWritable}
+ * exceptions.
+ */
+class PropertyError extends \RuntimeException
+{
+
+}
+
+/**
+ * Exception thrown when a property is not defined.
+ *
+ * For example, this could be triggered by getting the value of an undefined property.
+ */
+class PropertyNotDefined extends PropertyError
+{
+	public function __construct($message, $code=500, \Exception $previous=null)
+	{
+		if (is_array($message))
+		{
+			list($property, $container) = $message + array(1 => null);
+
+			if (is_object($container))
+			{
+				$message = format
+				(
+					'Undefined property %property for object of class %class.', array
+					(
+						'%property' => $property,
+						'%class' => get_class($container)
+					)
+				);
+			}
+			else
+			{
+				$message = format
+				(
+					'Undefined property %property.', array
+					(
+						'%property' => $property
+					)
+				);
+			}
+		}
+
+		parent::__construct($message, $code, $previous);
+	}
+}
+
+/**
+ * Exception thrown when a property is not readable.
+ *
+ * For example, this could be triggered when a private property is read from a public scope.
+ */
+class PropertyNotReadable extends PropertyError
+{
+	public function __construct($message, $code=500, \Exception $previous=null)
+	{
+		if (is_array($message))
+		{
+			list($property, $container) = $message + array(1 => null);
+
+			if (is_object($container))
+			{
+				$message = format
+				(
+					'The property %property for object of class %class is not readable.', array
+					(
+						'%property' => $property,
+						'%class' => get_class($container)
+					)
+				);
+			}
+			else
+			{
+				$message = format
+				(
+					'The property %property is not readable.', array
+					(
+						'%property' => $property
+					)
+				);
+			}
+		}
+
+		parent::__construct($message, $code, $previous);
+	}
+}
+
+/**
+ * Exception thrown when a property is not writable.
+ *
+ * For example, this could be triggered when a private property is written from a public scope.
+ */
+class PropertyNotWritable extends PropertyError
+{
+	public function __construct($message, $code=500, \Exception $previous=null)
+	{
+		if (is_array($message))
+		{
+			list($property, $container) = $message + array(1 => null);
+
+			if (is_object($container))
+			{
+				$message = format
+				(
+					'The property %property for object of class %class is not writable.', array
+					(
+						'%property' => $property,
+						'%class' => get_class($container)
+					)
+				);
+			}
+			else
+			{
+				$message = format
+				(
+					'The property %property is not writable.', array
+					(
+						'%property' => $property
+					)
+				);
+			}
+		}
+
+		parent::__construct($message, $code, $previous);
+	}
+}
+
+/**
+ * Exception thrown when a property has a reserved name.
+ *
+ * @property-read string $property Name of the reserved property.
+ */
+class PropertyIsReserved extends PropertyError
+{
+	private $property;
+
+	public function __construct($property, $code=500, \Exception $previous=null)
+	{
+		$this->property = $property;
+
+		parent::__construct(format('Property %property is reserved.', array('%property' => $property)), $code, $previous);
+	}
+
+	public function __get($property)
+	{
+		if ($property === 'property')
+		{
+			return $this->property;
+		}
+
+		throw new PropertyNotDefined(array($property, $this));
+	}
+}

web/vendor/icanboogie/common/lib/helpers.php

@@ -0,0 +1,685 @@
+<?php
+
+/*
+ * This file is part of the ICanBoogie package.
+ *
+ * (c) Olivier Laviale <olivier.laviale@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace ICanBoogie;
+
+/**
+ * Escape HTML special characters.
+ *
+ * HTML special characters are escaped using the {@link htmlspecialchars()} function with the
+ * {@link ENT_COMPAT} flag.
+ *
+ * @param string $str The string to escape.
+ * @param string $charset The charset of the string to escape. Defaults to
+ * {@link ICanBoogie\CHARSET} (utf-8).
+ *
+ * @return string
+ */
+function escape($str, $charset=CHARSET)
+{
+	return htmlspecialchars($str, ENT_COMPAT, $charset);
+}
+
+/**
+ * Escape all applicable characters to HTML entities.
+ *
+ * Applicable characters are escaped using the {@link htmlentities()} function with the {@link ENT_COMPAT} flag.
+ *
+ * @param string $str The string to escape.
+ * @param string $charset The charset of the string to escape. Defaults to
+ * {@link ICanBoogie\CHARSET} (utf-8).
+ *
+ * @return string
+ */
+function escape_all($str, $charset=CHARSET)
+{
+	return htmlentities($str, ENT_COMPAT, $charset);
+}
+
+if (!function_exists(__NAMESPACE__ . '\downcase'))
+{
+	/**
+	 * Returns a lowercase string.
+	 *
+	 * @param string $str
+	 *
+	 * @return string
+	 */
+	function downcase($str)
+	{
+		return mb_strtolower($str);
+	}
+}
+
+if (!function_exists(__NAMESPACE__ . '\upcase'))
+{
+	/**
+	 * Returns an uppercase string.
+	 *
+	 * @param string $str
+	 *
+	 * @return string
+	 */
+	function upcase($str)
+	{
+		return mb_strtoupper($str);
+	}
+}
+
+if (!function_exists(__NAMESPACE__ . '\capitalize'))
+{
+	/**
+	 * Returns a copy of str with the first character converted to uppercase and the
+	 * remainder to lowercase.
+	 *
+	 * @param string $str
+	 */
+	function capitalize($str)
+	{
+		return upcase(mb_substr($str, 0, 1)) . downcase(mb_substr($str, 1));
+	}
+}
+
+/**
+ * Shortens a string at a specified position.
+ *
+ * @param string $str The string to shorten.
+ * @param int $length The desired length of the string.
+ * @param float $position Position at which characters can be removed.
+ * @param bool $shortened `true` if the string was shortened, `false` otherwise.
+ *
+ * @return string
+ */
+function shorten($str, $length=32, $position=.75, &$shortened=null)
+{
+	$l = mb_strlen($str);
+
+	if ($l <= $length)
+	{
+		return $str;
+	}
+
+	$length--;
+	$position = (int) ($position * $length);
+
+	if ($position == 0)
+	{
+		$str = '…' . mb_substr($str, $l - $length);
+	}
+	else if ($position == $length)
+	{
+		$str = mb_substr($str, 0, $length) . '…';
+	}
+	else
+	{
+		$str = mb_substr($str, 0, $position) . '…' . mb_substr($str, $l - ($length - $position));
+	}
+
+	$shortened = true;
+
+	return $str;
+}
+
+/**
+ * Removes the accents of a string.
+ *
+ * @param string $str
+ * @param string $charset Defaults to {@link ICanBoogie\CHARSET}.
+ *
+ * @return string
+ */
+function remove_accents($str, $charset=CHARSET)
+{
+	$str = htmlentities($str, ENT_NOQUOTES, $charset);
+
+	$str = preg_replace('#&([A-za-z])(?:acute|cedil|caron|circ|grave|orn|ring|slash|th|tilde|uml);#', '\1', $str);
+	$str = preg_replace('#&([A-za-z]{2})(?:lig);#', '\1', $str); // pour les ligatures e.g. '&oelig;'
+	$str = preg_replace('#&[^;]+;#', '', $str); // supprime les autres caractères
+
+	return $str;
+}
+
+/**
+ * Binary-safe case-sensitive accents-insensitive string comparison.
+ *
+ * Accents are removed using the {@link remove_accents()} function.
+ *
+ * @param string $a
+ * @param string $b
+ *
+ * @return bool
+ */
+function unaccent_compare($a, $b)
+{
+    return strcmp(remove_accents($a), remove_accents($b));
+}
+
+/**
+ * Binary-safe case-insensitive accents-insensitive string comparison.
+ *
+ * Accents are removed using the {@link remove_accents()} function.
+ *
+ * @param string $a
+ * @param string $b
+ *
+ * @return bool
+ */
+function unaccent_compare_ci($a, $b)
+{
+    return strcasecmp(remove_accents($a), remove_accents($b));
+}
+
+/**
+ * Normalizes a string.
+ *
+ * Accents are removed, the string is downcased and characters that don't match [a-z0-9] are
+ * replaced by the separator character.
+ *
+ * @param string $str The string to normalize.
+ * @param string $separator The separator characters replaces characters the don't match [a-z0-9].
+ * @param string $charset The charset of the string to normalize.
+ *
+ * @return string
+ */
+function normalize($str, $separator='-', $charset=CHARSET)
+{
+	static $cache;
+
+	$cache_key = $charset . '|' . $separator . '|' . $str;
+
+	if (isset($cache[$cache_key]))
+	{
+		return $cache[$cache_key];
+	}
+
+	$str = str_replace('\'', '', $str);
+	$str = remove_accents($str, $charset);
+	$str = strtolower($str);
+	$str = preg_replace('#[^a-z0-9]+#', $separator, $str);
+	$str = trim($str, $separator);
+
+	return $cache[$cache_key] = $str;
+}
+
+/**
+ * Returns information about a variable.
+ *
+ * The function uses xdebug_var_dump() if [Xdebug](http://xdebug.org/) is installed, otherwise it
+ * uses print_r() output wrapped in a PRE element.
+ *
+ * @param mixed $value
+ *
+ * @return string
+ */
+function dump($value)
+{
+	if (function_exists('xdebug_var_dump'))
+	{
+		ob_start();
+
+		xdebug_var_dump($value);
+
+		$value = ob_get_clean();
+	}
+	else
+	{
+		$value = '<pre>' . escape(print_r($value, true)) . '</pre>';
+	}
+
+	return $value;
+}
+
+/**
+ * Formats the given string by replacing placeholders with the values provided.
+ *
+ * @param string $str The string to format.
+ * @param array $args An array of replacements for the placeholders. Occurrences in $str of any
+ * key in $args are replaced with the corresponding sanitized value. The sanitization function
+ * depends on the first character of the key:
+ *
+ * * :key: Replace as is. Use this for text that has already been sanitized.
+ * * !key: Sanitize using the `ICanBoogie\escape()` function.
+ * * %key: Sanitize using the `ICanBoogie\escape()` function and wrap inside a "EM" markup.
+ *
+ * Numeric indexes can also be used e.g '\2' or "{2}" are replaced by the value of the index
+ * "2".
+ *
+ * @return string
+ */
+function format($str, array $args=array())
+{
+	static $quotation_start;
+	static $quotation_end;
+
+	if ($quotation_start === null)
+	{
+		if (PHP_SAPI == 'cli')
+		{
+			$quotation_start = '"';
+			$quotation_end = '"';
+		}
+		else
+		{
+			$quotation_start = '<q>';
+			$quotation_end = '</q>';
+		}
+	}
+
+	if (!$args)
+	{
+		return $str;
+	}
+
+	$holders = array();
+	$i = 0;
+
+	foreach ($args as $key => $value)
+	{
+		if (is_object($value) && method_exists($value, '__toString'))
+		{
+			$value = (string) $value;
+		}
+
+		if (is_array($value) || is_object($value))
+		{
+			$value = dump($value);
+		}
+		else if (is_bool($value))
+		{
+			$value = $value ? '<em>true</em>' : '<em>false</em>';
+		}
+		else if (is_null($value))
+		{
+			$value = '<em>null</em>';
+		}
+
+		if (is_string($key))
+		{
+			switch ($key{0})
+			{
+				case ':': break;
+				case '!': $value = escape($value); break;
+				case '%': $value = $quotation_start . escape($value) . $quotation_end; break;
+
+				default:
+				{
+					$escaped_value = escape($value);
+
+					$holders['!' . $key] = $escaped_value;
+					$holders['%' . $key] = $quotation_start . $escaped_value . $quotation_end;
+
+					$key = ':' . $key;
+				}
+			}
+		}
+
+		$holders[$key] = $value;
+		$holders['\\' . $i] = $value;
+		$holders['{' . $i . '}'] = $value;
+
+		$i++;
+	}
+
+	return strtr($str, $holders);
+}
+
+/**
+ * Sorts an array using a stable sorting algorithm while preserving its keys.
+ *
+ * A stable sorting algorithm maintains the relative order of values with equal keys.
+ *
+ * The array is always sorted in ascending order but one can use the array_reverse() function to
+ * reverse the array. Also keys are preserved, even numeric ones, use the array_values() function
+ * to create an array with an ascending index.
+ *
+ * @param array &$array
+ * @param callable $picker
+ */
+function stable_sort(&$array, $picker=null)
+{
+	static $transform, $restore;
+
+	$i = 0;
+
+	if (!$transform)
+	{
+		$transform = function(&$v, $k) use (&$i)
+		{
+			$v = array($v, ++$i, $k, $v);
+		};
+
+		$restore = function(&$v, $k)
+		{
+			$v = $v[3];
+		};
+	}
+
+	if ($picker)
+	{
+		array_walk
+		(
+			$array, function(&$v, $k) use (&$i, $picker)
+			{
+				$v = array($picker($v, $k), ++$i, $k, $v);
+			}
+		);
+	}
+	else
+	{
+		array_walk($array, $transform);
+	}
+
+	asort($array);
+
+	array_walk($array, $restore);
+}
+
+/**
+ * Sort an array according to the weight of its items.
+ *
+ * The weight of the items is defined as an integer; a position relative to another member of the
+ * array `before:<key>` or `after:<key>`; the special words `top` and `bottom`.
+ *
+ * @param array $array
+ * @param callable $weight_picker The callback function used to pick the weight of the item. The
+ * function is called with the following arguments: `$value`, `$key`.
+ *
+ * @return array A sorted copy of the array.
+ */
+function sort_by_weight(array $array, $weight_picker)
+{
+	if (!$array)
+	{
+		return $array;
+	}
+
+	$order = array();
+
+	foreach ($array as $k => $v)
+	{
+		$order[$k] = $weight_picker($v, $k);
+	}
+
+	$n = count($order);
+	$top = min($order) - $n;
+	$bottom = max($order) + $n;
+
+	foreach ($order as &$weight)
+	{
+		if ($weight === 'top')
+		{
+			$weight = --$top;
+		}
+		else if ($weight === 'bottom')
+		{
+			$weight = ++$bottom;
+		}
+	}
+
+	foreach ($order as $k => &$weight)
+	{
+		if (strpos($weight, 'before:') === 0)
+		{
+			$target = substr($weight, 7);
+
+			if (isset($order[$target]))
+			{
+				$order = array_insert($order, $target, $order[$target], $k);
+			}
+			else
+			{
+				$weight = 0;
+			}
+		}
+		else if (strpos($weight, 'after:') === 0)
+		{
+			$target = substr($weight, 6);
+
+			if (isset($order[$target]))
+			{
+				$order = array_insert($order, $target, $order[$target], $k, true);
+			}
+			else
+			{
+				$weight = 0;
+			}
+		}
+	}
+
+	stable_sort($order);
+
+	array_walk($order, function(&$v, $k) use($array) {
+
+		$v = $array[$k];
+
+	});
+
+	return $order;
+}
+
+/**
+ * Inserts a value in a array before, or after, a given key.
+ *
+ * Numeric keys are not preserved.
+ *
+ * @param $array
+ * @param $relative
+ * @param $value
+ * @param $key
+ * @param $after
+ *
+ * @return array
+ */
+function array_insert($array, $relative, $value, $key=null, $after=false)
+{
+	if ($key)
+	{
+		unset($array[$key]);
+	}
+
+	$keys = array_keys($array);
+	$pos = array_search($relative, $keys, true);
+
+	if ($after)
+	{
+		$pos++;
+	}
+
+	$spliced = array_splice($array, $pos);
+
+	if ($key !== null)
+	{
+		$array = array_merge($array, array($key => $value));
+	}
+	else
+	{
+		array_unshift($spliced, $value);
+	}
+
+	return array_merge($array, $spliced);
+}
+
+/**
+ * Flattens an array.
+ *
+ * @param array $array
+ * @param string|array $separator
+ * @param int $depth
+ *
+ * @return array
+ */
+function array_flatten($array, $separator='.', $depth=0)
+{
+	$rc = array();
+
+	if (is_array($separator))
+	{
+		foreach ($array as $key => $value)
+		{
+			if (!is_array($value))
+			{
+				$rc[$key . ($depth ? $separator[1] : '')] = $value;
+
+				continue;
+			}
+
+			$values = array_flatten($value, $separator, $depth + 1);
+
+			foreach ($values as $vkey => $value)
+			{
+				$rc[$key . ($depth ? $separator[1] : '') . $separator[0] . $vkey] = $value;
+			}
+		}
+	}
+	else
+	{
+		foreach ($array as $key => $value)
+		{
+			if (!is_array($value))
+			{
+				$rc[$key] = $value;
+
+				continue;
+			}
+
+			$values = array_flatten($value, $separator);
+
+			foreach ($values as $vkey => $value)
+			{
+				$rc[$key . $separator . $vkey] = $value;
+			}
+		}
+	}
+
+	return $rc;
+}
+
+/**
+ * Merge arrays recursively with a different algorithm than PHP.
+ *
+ * @param array $array1
+ * @param array $array2 ...
+ *
+ * @return array
+ */
+function array_merge_recursive(array $array1, array $array2=array())
+{
+	$arrays = func_get_args();
+
+	$merge = array_shift($arrays);
+
+	foreach ($arrays as $array)
+	{
+		foreach ($array as $key => $val)
+		{
+			#
+			# if the value is an array and the key already exists
+			# we have to make a recursion
+			#
+
+			if (is_array($val) && array_key_exists($key, $merge))
+			{
+				$val = array_merge_recursive((array) $merge[$key], $val);
+			}
+
+			#
+			# if the key is numeric, the value is pushed. Otherwise, it replaces
+			# the value of the _merge_ array.
+			#
+
+			if (is_numeric($key))
+			{
+				$merge[] = $val;
+			}
+			else
+			{
+				$merge[$key] = $val;
+			}
+		}
+	}
+
+	return $merge;
+}
+
+function exact_array_merge_recursive(array $array1, array $array2=array())
+{
+	$arrays = func_get_args();
+
+	$merge = array_shift($arrays);
+
+	foreach ($arrays as $array)
+	{
+		foreach ($array as $key => $val)
+		{
+			#
+			# if the value is an array and the key already exists
+			# we have to make a recursion
+			#
+
+			if (is_array($val) && array_key_exists($key, $merge))
+			{
+				$val = exact_array_merge_recursive((array) $merge[$key], $val);
+			}
+
+			$merge[$key] = $val;
+		}
+	}
+
+	return $merge;
+}
+
+/**
+ * Normalizes the path of a URL.
+ *
+ * @param string $path
+ *
+ * @return string
+ *
+ * @see http://en.wikipedia.org/wiki/URL_normalization
+ */
+function normalize_url_path($path)
+{
+	static $cache = array();
+
+	$path = (string) $path;
+
+	if (isset($cache[$path]))
+	{
+		return $cache[$path];
+	}
+
+	$normalized = preg_replace('#\/index\.(html|php)$#', '/', $path);
+	$normalized = rtrim($normalized, '/');
+
+	if (!preg_match('#\.[a-z]+$#', $normalized))
+	{
+		$normalized .= '/';
+	}
+
+	$cache[$path] = $normalized;
+
+	return $normalized;
+}
+
+/**
+ * Generates a v4 UUID.
+ *
+ * @return string
+ *
+ * @origin http://stackoverflow.com/questions/2040240/php-function-to-generate-v4-uuid#answer-15875555
+ */
+function generate_v4_uuid()
+{
+	$data = openssl_random_pseudo_bytes(16);
+	$data[6] = chr(ord($data[6]) & 0x0f | 0x40); // set version to 0010
+	$data[8] = chr(ord($data[8]) & 0x3f | 0x80); // set bits 6-7 to 10
+	return vsprintf('%s%s-%s-%s-%s-%s%s%s', str_split(bin2hex($data), 4));
+}

web/vendor/icanboogie/common/lib/interfaces.php

@@ -0,0 +1,32 @@
+<?php
+
+/*
+ * This file is part of the ICanBoogie package.
+ *
+ * (c) Olivier Laviale <olivier.laviale@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace ICanBoogie;
+
+interface ToArray
+{
+	/**
+	 * Converts the object into an array.
+	 *
+	 * @return array
+	 */
+	public function to_array();
+}
+
+interface ToArrayRecursive extends ToArray
+{
+	/**
+	 * Converts the object into an array recursively.
+	 *
+	 * @return array
+	 */
+	public function to_array_recursive();
+}

web/vendor/icanboogie/common/lib/strings.php

@@ -0,0 +1,55 @@
+<?php
+
+namespace ICanBoogie;
+
+/**
+ * A formatted string.
+ *
+ * The string is formatted by replacing placeholders with the values provided.
+ */
+class FormattedString
+{
+	/**
+	 * String format.
+	 *
+	 * @var string
+	 */
+	protected $format;
+
+	/**
+	 * An array of replacements for the placeholders.
+	 *
+	 * @var array
+	 */
+	protected $args;
+
+	/**
+	 * Initializes the {@link $format} and {@link $args} properties.
+	 *
+	 * @param string $format String format.
+	 * @param array $args Format arguments.
+	 *
+	 * @see format()
+	 */
+	public function __construct($format, $args=null)
+	{
+		if (!is_array($args))
+		{
+			$args = func_get_args();
+			array_shift($args);
+		}
+
+		$this->format = $format;
+		$this->args = (array) $args;
+	}
+
+	/**
+	 * Returns the string formatted with the {@link format()} function.
+	 *
+	 * @return string
+	 */
+	public function __toString()
+	{
+		return format($this->format, $this->args);
+	}
+}

web/vendor/icanboogie/common/lib/traits.php

@@ -0,0 +1,34 @@
+<?php
+
+/*
+ * This file is part of the ICanBoogie package.
+ *
+ * (c) Olivier Laviale <olivier.laviale@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace ICanBoogie;
+
+trait ToArrayRecursiveTrait
+{
+	public function to_array_recursive()
+	{
+		$array = $this->to_array();
+
+		foreach ($array as $key => &$value)
+		{
+			if ($value instanceof ToArrayRecursive)
+			{
+				$value = $value->to_array_recursive();
+			}
+			else if ($value instanceof ToArray)
+			{
+				$value = $value->to_array();
+			}
+		}
+
+		return $array;
+	}
+}