Merge pull request #481 from wallabag/dev1.5.2

1.5.2
author: Nicolas Lœuillet <nicolas@loeuillet.org> 2014-02-21 15:57:10 +0100
committer: Nicolas Lœuillet <nicolas@loeuillet.org> 2014-02-21 15:57:10 +0100
commit: 99679d06884120c57f43b44e55e03595f1f87bed (patch)
tree: a3f2a1aa1afdaeca1386d0c6e8a75344fd2241fb /inc/3rdparty/htmlpurifier/HTMLPurifier/VarParser.php
parent: 655214ab30ee84884dc408488b85586f36263fcb (diff)
parent: d3b47e94705e17b3ba3529cbb1dc6efe69c5d2b7 (diff)
download: wallabag-99679d06884120c57f43b44e55e03595f1f87bed.tar.gz
wallabag-99679d06884120c57f43b44e55e03595f1f87bed.tar.zst
wallabag-99679d06884120c57f43b44e55e03595f1f87bed.zip
1 files changed, 198 insertions, 0 deletions
diff --git a/inc/3rdparty/htmlpurifier/HTMLPurifier/VarParser.php b/inc/3rdparty/htmlpurifier/HTMLPurifier/VarParser.php
new file mode 100644
index 00000000..4bf7771a
--- /dev/null
+++ b/inc/3rdparty/htmlpurifier/HTMLPurifier/VarParser.php
@@ -0,0 +1,198 @@
+<?php
+/**
+ * Parses string representations into their corresponding native PHP
+ * variable type. The base implementation does a simple type-check.
+ */
+class HTMLPurifier_VarParser
+{
+    const STRING = 1;
+    const ISTRING = 2;
+    const TEXT = 3;
+    const ITEXT = 4;
+    const INT = 5;
+    const FLOAT = 6;
+    const BOOL = 7;
+    const LOOKUP = 8;
+    const ALIST = 9;
+    const HASH = 10;
+    const MIXED = 11;
+    /**
+     * Lookup table of allowed types. Mainly for backwards compatibility, but
+     * also convenient for transforming string type names to the integer constants.
+     */
+    public static $types = array(
+        'string' => self::STRING,
+        'istring' => self::ISTRING,
+        'text' => self::TEXT,
+        'itext' => self::ITEXT,
+        'int' => self::INT,
+        'float' => self::FLOAT,
+        'bool' => self::BOOL,
+        'lookup' => self::LOOKUP,
+        'list' => self::ALIST,
+        'hash' => self::HASH,
+        'mixed' => self::MIXED
+    );
+    /**
+     * Lookup table of types that are string, and can have aliases or
+     * allowed value lists.
+     */
+    public static $stringTypes = array(
+        self::STRING => true,
+        self::ISTRING => true,
+        self::TEXT => true,
+        self::ITEXT => true,
+    );
+    /**
+     * Validate a variable according to type.
+     * It may return NULL as a valid type if $allow_null is true.
+     *
+     * @param mixed $var Variable to validate
+     * @param int $type Type of variable, see HTMLPurifier_VarParser->types
+     * @param bool $allow_null Whether or not to permit null as a value
+     * @return string Validated and type-coerced variable
+     * @throws HTMLPurifier_VarParserException
+     */
+    final public function parse($var, $type, $allow_null = false)
+    {
+        if (is_string($type)) {
+            if (!isset(HTMLPurifier_VarParser::$types[$type])) {
+                throw new HTMLPurifier_VarParserException("Invalid type '$type'");
+            } else {
+                $type = HTMLPurifier_VarParser::$types[$type];
+            }
+        }
+        $var = $this->parseImplementation($var, $type, $allow_null);
+        if ($allow_null && $var === null) {
+            return null;
+        }
+        // These are basic checks, to make sure nothing horribly wrong
+        // happened in our implementations.
+        switch ($type) {
+            case (self::STRING):
+            case (self::ISTRING):
+            case (self::TEXT):
+            case (self::ITEXT):
+                if (!is_string($var)) {
+                    break;
+                }
+                if ($type == self::ISTRING || $type == self::ITEXT) {
+                    $var = strtolower($var);
+                }
+                return $var;
+            case (self::INT):
+                if (!is_int($var)) {
+                    break;
+                }
+                return $var;
+            case (self::FLOAT):
+                if (!is_float($var)) {
+                    break;
+                }
+                return $var;
+            case (self::BOOL):
+                if (!is_bool($var)) {
+                    break;
+                }
+                return $var;
+            case (self::LOOKUP):
+            case (self::ALIST):
+            case (self::HASH):
+                if (!is_array($var)) {
+                    break;
+                }
+                if ($type === self::LOOKUP) {
+                    foreach ($var as $k) {
+                        if ($k !== true) {
+                            $this->error('Lookup table contains value other than true');
+                        }
+                    }
+                } elseif ($type === self::ALIST) {
+                    $keys = array_keys($var);
+                    if (array_keys($keys) !== $keys) {
+                        $this->error('Indices for list are not uniform');
+                    }
+                }
+                return $var;
+            case (self::MIXED):
+                return $var;
+            default:
+                $this->errorInconsistent(get_class($this), $type);
+        }
+        $this->errorGeneric($var, $type);
+    }
+    /**
+     * Actually implements the parsing. Base implementation does not
+     * do anything to $var. Subclasses should overload this!
+     * @param mixed $var
+     * @param int $type
+     * @param bool $allow_null
+     * @return string
+     */
+    protected function parseImplementation($var, $type, $allow_null)
+    {
+        return $var;
+    }
+    /**
+     * Throws an exception.
+     * @throws HTMLPurifier_VarParserException
+     */
+    protected function error($msg)
+    {
+        throw new HTMLPurifier_VarParserException($msg);
+    }
+    /**
+     * Throws an inconsistency exception.
+     * @note This should not ever be called. It would be called if we
+     *       extend the allowed values of HTMLPurifier_VarParser without
+     *       updating subclasses.
+     * @param string $class
+     * @param int $type
+     * @throws HTMLPurifier_Exception
+     */
+    protected function errorInconsistent($class, $type)
+    {
+        throw new HTMLPurifier_Exception(
+            "Inconsistency in $class: " . HTMLPurifier_VarParser::getTypeName($type) .
+            " not implemented"
+        );
+    }
+    /**
+     * Generic error for if a type didn't work.
+     * @param mixed $var
+     * @param int $type
+     */
+    protected function errorGeneric($var, $type)
+    {
+        $vtype = gettype($var);
+        $this->error("Expected type " . HTMLPurifier_VarParser::getTypeName($type) . ", got $vtype");
+    }
+    /**
+     * @param int $type
+     * @return string
+     */
+    public static function getTypeName($type)
+    {
+        static $lookup;
+        if (!$lookup) {
+            // Lazy load the alternative lookup table
+            $lookup = array_flip(HTMLPurifier_VarParser::$types);
+        }
+        if (!isset($lookup[$type])) {
+            return 'unknown';
+        }
+        return $lookup[$type];
+    }
+}
+// vim: et sw=4 sts=4
author	Nicolas Lœuillet <nicolas@loeuillet.org>	2014-02-21 15:57:10 +0100
committer	Nicolas Lœuillet <nicolas@loeuillet.org>	2014-02-21 15:57:10 +0100
commit	99679d06884120c57f43b44e55e03595f1f87bed (patch)
tree	a3f2a1aa1afdaeca1386d0c6e8a75344fd2241fb /inc/3rdparty/htmlpurifier/HTMLPurifier/VarParser.php
parent	655214ab30ee84884dc408488b85586f36263fcb (diff)
parent	d3b47e94705e17b3ba3529cbb1dc6efe69c5d2b7 (diff)
download	wallabag-99679d06884120c57f43b44e55e03595f1f87bed.tar.gz wallabag-99679d06884120c57f43b44e55e03595f1f87bed.tar.zst wallabag-99679d06884120c57f43b44e55e03595f1f87bed.zip

diff --git a/inc/3rdparty/htmlpurifier/HTMLPurifier/VarParser.php b/inc/3rdparty/htmlpurifier/HTMLPurifier/VarParser.php new file mode 100644 index 00000000..4bf7771a --- /dev/null +++ b/inc/3rdparty/htmlpurifier/HTMLPurifier/VarParser.php
@@ -0,0 +1,198 @@
	1	<?php
	2
	3	/**
	4	* Parses string representations into their corresponding native PHP
	5	* variable type. The base implementation does a simple type-check.
	6	*/
	7	class HTMLPurifier_VarParser
	8	{
	9
	10	const STRING = 1;
	11	const ISTRING = 2;
	12	const TEXT = 3;
	13	const ITEXT = 4;
	14	const INT = 5;
	15	const FLOAT = 6;
	16	const BOOL = 7;
	17	const LOOKUP = 8;
	18	const ALIST = 9;
	19	const HASH = 10;
	20	const MIXED = 11;
	21
	22	/**
	23	* Lookup table of allowed types. Mainly for backwards compatibility, but
	24	* also convenient for transforming string type names to the integer constants.
	25	*/
	26	public static $types = array(
	27	'string' => self::STRING,
	28	'istring' => self::ISTRING,
	29	'text' => self::TEXT,
	30	'itext' => self::ITEXT,
	31	'int' => self::INT,
	32	'float' => self::FLOAT,
	33	'bool' => self::BOOL,
	34	'lookup' => self::LOOKUP,
	35	'list' => self::ALIST,
	36	'hash' => self::HASH,
	37	'mixed' => self::MIXED
	38	);
	39
	40	/**
	41	* Lookup table of types that are string, and can have aliases or
	42	* allowed value lists.
	43	*/
	44	public static $stringTypes = array(
	45	self::STRING => true,
	46	self::ISTRING => true,
	47	self::TEXT => true,
	48	self::ITEXT => true,
	49	);
	50
	51	/**
	52	* Validate a variable according to type.
	53	* It may return NULL as a valid type if $allow_null is true.
	54	*
	55	* @param mixed $var Variable to validate
	56	* @param int $type Type of variable, see HTMLPurifier_VarParser->types
	57	* @param bool $allow_null Whether or not to permit null as a value
	58	* @return string Validated and type-coerced variable
	59	* @throws HTMLPurifier_VarParserException
	60	*/
	61	final public function parse($var, $type, $allow_null = false)
	62	{
	63	if (is_string($type)) {
	64	if (!isset(HTMLPurifier_VarParser::$types[$type])) {
	65	throw new HTMLPurifier_VarParserException("Invalid type '$type'");
	66	} else {
	67	$type = HTMLPurifier_VarParser::$types[$type];
	68	}
	69	}
	70	$var = $this->parseImplementation($var, $type, $allow_null);
	71	if ($allow_null && $var === null) {
	72	return null;
	73	}
	74	// These are basic checks, to make sure nothing horribly wrong
	75	// happened in our implementations.
	76	switch ($type) {
	77	case (self::STRING):
	78	case (self::ISTRING):
	79	case (self::TEXT):
	80	case (self::ITEXT):
	81	if (!is_string($var)) {
	82	break;
	83	}
	84	if ($type == self::ISTRING \|\| $type == self::ITEXT) {
	85	$var = strtolower($var);
	86	}
	87	return $var;
	88	case (self::INT):
	89	if (!is_int($var)) {
	90	break;
	91	}
	92	return $var;
	93	case (self::FLOAT):
	94	if (!is_float($var)) {
	95	break;
	96	}
	97	return $var;
	98	case (self::BOOL):
	99	if (!is_bool($var)) {
	100	break;
	101	}
	102	return $var;
	103	case (self::LOOKUP):
	104	case (self::ALIST):
	105	case (self::HASH):
	106	if (!is_array($var)) {
	107	break;
	108	}
	109	if ($type === self::LOOKUP) {
	110	foreach ($var as $k) {
	111	if ($k !== true) {
	112	$this->error('Lookup table contains value other than true');
	113	}
	114	}
	115	} elseif ($type === self::ALIST) {
	116	$keys = array_keys($var);
	117	if (array_keys($keys) !== $keys) {
	118	$this->error('Indices for list are not uniform');
	119	}
	120	}
	121	return $var;
	122	case (self::MIXED):
	123	return $var;
	124	default:
	125	$this->errorInconsistent(get_class($this), $type);
	126	}
	127	$this->errorGeneric($var, $type);
	128	}
	129
	130	/**
	131	* Actually implements the parsing. Base implementation does not
	132	* do anything to $var. Subclasses should overload this!
	133	* @param mixed $var
	134	* @param int $type
	135	* @param bool $allow_null
	136	* @return string
	137	*/
	138	protected function parseImplementation($var, $type, $allow_null)
	139	{
	140	return $var;
	141	}
	142
	143	/**
	144	* Throws an exception.
	145	* @throws HTMLPurifier_VarParserException
	146	*/
	147	protected function error($msg)
	148	{
	149	throw new HTMLPurifier_VarParserException($msg);
	150	}
	151
	152	/**
	153	* Throws an inconsistency exception.
	154	* @note This should not ever be called. It would be called if we
	155	* extend the allowed values of HTMLPurifier_VarParser without
	156	* updating subclasses.
	157	* @param string $class
	158	* @param int $type
	159	* @throws HTMLPurifier_Exception
	160	*/
	161	protected function errorInconsistent($class, $type)
	162	{
	163	throw new HTMLPurifier_Exception(
	164	"Inconsistency in $class: " . HTMLPurifier_VarParser::getTypeName($type) .
	165	" not implemented"
	166	);
	167	}
	168
	169	/**
	170	* Generic error for if a type didn't work.
	171	* @param mixed $var
	172	* @param int $type
	173	*/
	174	protected function errorGeneric($var, $type)
	175	{
	176	$vtype = gettype($var);
	177	$this->error("Expected type " . HTMLPurifier_VarParser::getTypeName($type) . ", got $vtype");
	178	}
	179
	180	/**
	181	* @param int $type
	182	* @return string
	183	*/
	184	public static function getTypeName($type)
	185	{
	186	static $lookup;
	187	if (!$lookup) {
	188	// Lazy load the alternative lookup table
	189	$lookup = array_flip(HTMLPurifier_VarParser::$types);
	190	}
	191	if (!isset($lookup[$type])) {
	192	return 'unknown';
	193	}
	194	return $lookup[$type];
	195	}
	196	}
	197
	198	// vim: et sw=4 sts=4