added Literal::new() [Closes #130]

Author: dg

readme.md

@@ -582,6 +582,13 @@ new Literal('substr(?, ?)', [$a, $b]);
 // generates, for example: substr('hello', 5);
 ```
 
+The literal representing the creation of a new object is easily generated by the `new` method:
+
+```php
+Literal::new(Demo::class, [$a, 'foo' => $b]);
+// generates, for example: new Demo(10, foo: 20)
+```
+
 
 Attributes
 ----------
@@ -590,10 +597,15 @@ You can add PHP 8 attributes to all classes, methods, properties, constants, enu
 
 ```php
 $class = new Nette\PhpGenerator\ClassType('Demo');
-$class->addAttribute('Deprecated');
+$class->addAttribute('Table', [
+	'name' => 'user',
+	'constraints' => [
+		Literal::new('UniqueConstraint', ['name' => 'ean', 'columns' => ['ean']]),
+	],
+]);
 
 $class->addProperty('list')
-	->addAttribute('WithArguments', [1, 2]);
+	->addAttribute('Deprecated');
 
 $method = $class->addMethod('count')
 	->addAttribute('Foo\Cached', ['mode' => true]);
@@ -607,16 +619,18 @@ echo $class;
 Result:
 
 ```php
-#[Deprecated]
+#[Table(name: 'user', constraints: [new UniqueConstraint(name: 'ean', columns: ['ean'])])]
 class Demo
 {
-	#[WithArguments(1, 2)]
+	#[Deprecated]
 	public $list;
 
 
 	#[Foo\Cached(mode: true)]
-	public function count(#[Bar] $items)
-	{
+	public function count(
+		#[Bar]
+		$items,
+	) {
 	}
 }
 ```

src/PhpGenerator/Literal.php

@@ -15,6 +15,15 @@
  */
 class Literal
 {
+	/**
+	 * Creates a literal representing the creation of an object using the new operator.
+	 */
+	public static function new(string $class, array $args = []): self
+	{
+		return new self('new ' . $class . '(...?:)', [$args]);
+	}
+
+
 	public function __construct(
 		private string $value,
 		/** @var ?mixed[] */

tests/PhpGenerator/ClassType.attributes.phpt

@@ -18,7 +18,12 @@ $class
 	->addComment('Description of class.')
 	->addAttribute('ExampleAttribute')
 	->addAttribute('WithArgument', [new Literal('Foo::BAR')])
-	->addAttribute('NamedArguments', ['foo' => 'bar', 'bar' => [1, 2, 3]]);
+	->addAttribute('Table', [
+		'name' => 'user',
+		'constraints' => [
+			Literal::new('UniqueConstraint', ['name' => 'ean', 'columns' => ['ean']]),
+		],
+	]);
 
 $class->addConstant('FOO', 123)
 	->addComment('Commented')

tests/PhpGenerator/ClassType.promotion.phpt

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

tests/PhpGenerator/Dumper.dump().phpt

@@ -51,6 +51,12 @@ Assert::same("[strlen('hello')]", $dumper->dump([new Literal('strlen(?)', ['hell
 Assert::same("a\nb", $dumper->dump(new Literal("a\r\nb")));
 
 
+// Literal::new
+Assert::same('new stdClass()', $dumper->dump(Literal::new('stdClass')));
+Assert::same('new stdClass(10, 20)', $dumper->dump(Literal::new('stdClass', [10, 20])));
+Assert::same('new stdClass(10, c: 20)', $dumper->dump(Literal::new('stdClass', [10, 'c' => 20])));
+
+
 // arrays
 Assert::same('[]', $dumper->dump([]));
 Assert::same('[1, 2, 3]', $dumper->dump([1, 2, 3]));

tests/PhpGenerator/expected/ClassType.attributes.expect

@@ -3,7 +3,7 @@
  */
 #[ExampleAttribute]
 #[WithArgument(Foo::BAR)]
-#[NamedArguments(foo: 'bar', bar: [1, 2, 3])]
+#[Table(name: 'user', constraints: [new UniqueConstraint(name: 'ean', columns: ['ean'])])]
 class Example
 {
 	/** Commented */