Literal: accepts parameters

Author: dg

readme.md

@@ -272,7 +272,7 @@ It is possible to add a comment or [attributes](#attributes) to each case using
 Literals
 --------
 
-You can pass any PHP code to property or parameter default values via `Literal`:
+With `Literal` you can pass arbitrary PHP code to, for example, default property or parameter values etc:
 
 ```php
 use Nette\PhpGenerator\Literal;
@@ -300,6 +300,15 @@ class Demo
 }
 ```
 
+You can also pass parameters to `Literal` and have it formatted into valid PHP code using [special placeholders](#method-and-function-body-generator):
+
+```php
+new Literal('substr(?, ?)', [$a, $b]);
+// generates, for example: substr('hello', 5);
+```
+
+
+
 Using Traits
 ------------
 

src/PhpGenerator/Literal.php

@@ -19,9 +19,11 @@ class Literal
 	private $value;
 
 
-	public function __construct(string $value)
+	public function __construct(string $value, array $args = null)
 	{
-		$this->value = $value;
+		$this->value = $args === null
+			? $value
+			: (new Dumper)->format($value, ...$args);
 	}
 
 

tests/PhpGenerator/ClassType.promotion.phpt

@@ -19,7 +19,7 @@ $method->addPromotedParameter('c')
 	->addComment('promo')
 	->addAttribute('Example');
 
-$method->addPromotedParameter('d', new Literal('new Draft'))
+$method->addPromotedParameter('d', new Literal('new Draft(?)', [10]))
 	->setType('Draft')
 	->setReadOnly();
 

tests/PhpGenerator/Dumper.dump().phpt

@@ -44,6 +44,7 @@ Assert::same('\'He\ll\\\\\o \\\'wor\\\\\\\'ld\\\\\'', $dumper->dump('He\ll\\\o \
 
 // literal
 Assert::same('[$s]', $dumper->dump([new Literal('$s')]));
+Assert::same("[strlen('hello')]", $dumper->dump([new Literal('strlen(?)', ['hello'])]));
 same('[
 	function () {
 		return 1;

tests/PhpGenerator/expected/ClassType.promotion.expect

@@ -5,7 +5,7 @@ class Example
 		public $b,
 		/** promo */
 		#[Example] private string $c,
-		public readonly Draft $d = new Draft,
+		public readonly Draft $d = new Draft(10),
 	) {
 	}
 }