SqlPreprocessor: added mode ?list

Author: dg

src/Database/SqlPreprocessor.php

@@ -25,9 +25,10 @@ class SqlPreprocessor
 		MODE_SET = 'set',       // key=value, key=value, ...
 		MODE_VALUES = 'values', // (key, key, ...) VALUES (value, value, ...)
 		MODE_ORDER = 'order',   // key, key DESC, ...
+		MODE_LIST = 'list',     // value, value, ...  |  (tuple), (tuple), ...
 		MODE_AUTO = 'auto';     // arrayMode for arrays
 
-	private const MODES = [self::MODE_AND, self::MODE_OR, self::MODE_SET, self::MODE_VALUES, self::MODE_ORDER];
+	private const MODES = [self::MODE_AND, self::MODE_OR, self::MODE_SET, self::MODE_VALUES, self::MODE_ORDER, self::MODE_LIST];
 
 	private const ARRAY_MODES = [
 		'INSERT' => self::MODE_VALUES,
@@ -67,7 +68,7 @@ class SqlPreprocessor
 	/** @var bool */
 	private $useParams;
 
-	/** @var string|null values|set|and|order */
+	/** @var string|null values|set|and|order|items */
 	private $arrayMode;
 
 
@@ -240,6 +241,14 @@ private function formatValue($value, string $mode = null): string
 				}
 				return implode(', ', $vx);
 
+			} elseif ($mode === self::MODE_LIST) { // value, value, ...  |  (tuple), (tuple), ...
+				foreach ($value as $k => $v) {
+					$vx[] = is_array($v)
+						? '(' . $this->formatValue($v, self::MODE_LIST) . ')'
+						: $this->formatValue($v);
+				}
+				return implode(', ', $vx);
+
 			} elseif ($mode === self::MODE_AND || $mode === self::MODE_OR) { // (key [operator] value) AND ...
 				foreach ($value as $k => $v) {
 					if (is_int($k)) {

tests/Database/SqlPreprocessor.phpt

@@ -350,7 +350,7 @@ test('?values', function () use ($preprocessor) {
 test('automatic detection failed', function () use ($preprocessor) {
 	Assert::exception(function () use ($preprocessor) {
 		$preprocessor->process(['INSERT INTO author (name) SELECT name FROM user WHERE id IN (?)', [11, 12]]);
-	}, Nette\InvalidArgumentException::class, 'Automaticaly detected multi-insert, but values aren\'t array. If you need try to change mode like "?[and|or|set|values|order]". Mode "values" was used.');
+	}, Nette\InvalidArgumentException::class, 'Automaticaly detected multi-insert, but values aren\'t array. If you need try to change mode like "?[and|or|set|values|order|list]". Mode "values" was used.');
 });