Valinor/tests
Romain Canon e437d9405c feat: introduce attribute DynamicConstructor
In some situations the type handled by a constructor is only known at
runtime, in which case the constructor needs to know what class must be
used to instantiate the object.

For instance, an interface may declare a static constructor that is then
implemented by several child classes. One solution would be to register
the constructor for each child class, which leads to a lot of
boilerplate code and would require a new registration each time a new
child is created. Another way is to use the attribute
`\CuyZ\Valinor\Mapper\Object\DynamicConstructor`.

When a constructor uses this attribute, its first parameter must be a
string and will be filled with the name of the actual class that the
mapper needs to build when the constructor is called. Other arguments
may be added and will be mapped normally, depending on the source given
to the mapper.

```php
interface InterfaceWithStaticConstructor
{
    public static function from(string $value): self;
}

final class ClassWithInheritedStaticConstructor implements InterfaceWithStaticConstructor
{
    private function __construct(private SomeValueObject $value) {}

    public static function from(string $value): self
    {
        return new self(new SomeValueObject($value));
    }
}

(new \CuyZ\Valinor\MapperBuilder())
    ->registerConstructor(
        #[\CuyZ\Valinor\Attribute\DynamicConstructor]
        function (string $className, string $value): InterfaceWithStaticConstructor {
            return $className::from($value);
        }
    )
    ->mapper()
    ->map(ClassWithInheritedStaticConstructor::class, 'foo');
```
2022-08-30 15:15:41 +02:00
..
Fake misc: fetch attributes for function definition 2022-08-29 23:09:15 +02:00
Fixture fix: handle native attribute on promoted parameter 2022-07-31 15:42:58 +02:00
Functional misc: fetch attributes for function definition 2022-08-29 23:09:15 +02:00
Integration feat: introduce attribute DynamicConstructor 2022-08-30 15:15:41 +02:00
StaticAnalysis test: configure vimeo/psalm to verify type inference 2022-01-13 19:55:20 +01:00
Traits feat: initial release 2021-11-28 18:21:56 +01:00
Unit feat: introduce attribute DynamicConstructor 2022-08-30 15:15:41 +02:00