[LiveComponent] Add a new helper to interact with forms in functional tests

[yoye]

Q	A
Bug fix?	no
New feature?	yes
License	MIT

Add a new method in TestLiveComponent to interact with live components that contains forms. Submitted data must be passed as an array like you'll do with KernelBrowser.

$component = $this->createLiveComponent(name: Component::class);
$component->submitForm(['foo' => ['bar' => 'baz']]); // The method will change this values in ['foo.bar' => 'baz'] as expected by the component.

[kbond]

This is beautiful! I thought adding this would be much more complex!

[smnandre]

Well spotted!

[smnandre]

Maybe we should create an entire block "Test LiveComponent with Forms" (or something like that), wdyt ?

If "no", i think some comment to precise what is "form" and "save" here could avoid some missunderstandings.

[yoye]

As Test helper is only one block, I didn't want to change that. But I understand that my array is a bit confusing.

[smnandre]

Let's keep as it is..

Who knows, mabe if you add other nice helpers... we will be forced to add a dedicated block ? :))

[smnandre]

No difference array_is_list / map ? (geniune question)

Does this work with fields accepting multiple values ?

[yoye]

Don't know how to use array_is_list here. With array_map I can't handle keys.

Yes, I was a little undecided to not add a test for that method. At first I've thinked to add a public static method in Symfony\UX\LiveComponent\Util\LiveFormUtility which could be easily tested. But I don't know if it make sence as it will be created only for test purpose.

But this will work.

    public function testFlatten(): void
    {
        $data = [
            'foo' => ['bar' => 'baz'],
            'collection' => ['one', 'two', 'three'],
            'collection_with_sub' => [
                'sub_one' => ['child_one', 'child_two'],
                'sub_two' => ['child_three', 'key' => 'child_four'],
            ],
        ];

        $this->assertSame([
            'foo.bar' => 'baz',
            'collection.0' => 'one',
            'collection.1' => 'two',
            'collection.2' => 'three',
            'collection_with_sub.sub_one.0' => 'child_one',
            'collection_with_sub.sub_one.1' => 'child_two',
            'collection_with_sub.sub_two.0' => 'child_three',
            'collection_with_sub.sub_two.key' => 'child_four',
        ], TestLiveComponent::flattenFormValues($data));
    }

[smnandre]

Good for me then, thank you for taking time to answer :)

[smnandre]

I let some questions about details, but overall very happy to see this PR: thank you very much @yoye !

And i second @kbond, I thought it would be much more complex so .. 👏

[smnandre]

Thanks!

[kbond]

So great, thanks @yoye!