Add fluent builder for Laravel

[GromNaN]

Related to PHPORM-103

Create a fluent pipeline builder that can be used like this:

        $pipeline = (new FluentFactory())
            ->match(x: Query::eq(1))
            ->project(_id: false, x: true)
            ->sort(x: Sort::Asc)
            ->getPipeline();

[GromNaN]

In order to get the customized signature of some factory methods, we read the signature from MongoDB\Builder\Stage static methods.

[GromNaN]

This long list should be read from the source code.

[alcaeus]

Does the generated code include fully qualified names without these use statements, or would the code break? IMO, in generated code it's fine to not rely on use statements, alternatively we could always generate the code with fully qualified names and then let phpcbf fix whatever it can (without actually checking the code against our styleguide so that manual fixes need not to be applied).

[GromNaN]

This breaks phpdoc.

[alcaeus]

I noticed that the factory class was extracted to a private constant, but this trait was not. Should this be extracted?

[GromNaN]

Changed to use reflection to get the trait.

[alcaeus]

Does the generated code include fully qualified names without these use statements, or would the code break? IMO, in generated code it's fine to not rely on use statements, alternatively we could always generate the code with fully qualified names and then let phpcbf fix whatever it can (without actually checking the code against our styleguide so that manual fixes need not to be applied).

[alcaeus]

Moving this check into addMethod would allow you to simplify the entire block:

array_map(
    fn ($method) => $this->addMethod($method, $namespace, $class),
    $staticFactory->getMethods(),
);

[GromNaN]

Good point. I move the isPublic check but keep the foreach.

[alcaeus]

Can you also add an assertion to ensure that the correct stages are added? As is we're only checking that three stages are added, but not what is actually being added.
A possible alternative would be to duplicate the existing stage tests and creating them with the fluent builder instead of the static one, e.g.:

public function testEqualityMatch(): void
{
    $pipeline = (new FluentFactory())
        ->match(author: 'dave'),
        ->getPipeline();

    $this->assertSamePipeline(Pipelines::MatchEqualityMatch, $pipeline);
}

[GromNaN]

I don't think replicating all tests is interesting. This single test can cover all specific cases.

[GromNaN]

I messed with my branches. PR re-opened: #67