[2.x] Add covers attribute

[danilopolani]

Q	A
Bug fix?	no
New feature?	yes
Fixed tickets	#32

This PR tries to implement the @covers annotation. Actually, following the issue sebastianbergmann/phpunit#4502 , I decided to implement it as a PHP Attribute since the annotations will be deprecated in PHPUnit 11.

I haven't tested this yet because I started working on it on Windows and 90% of the commands do not work, will come back on this in the next few days.

Because of the logic of Pest (where final user does not have a class), I think it's not possible to implement the @coversDefaultClass, but that's not a big deal since the other methods works just fine without it.

Usage

test('covers class')
    ->expect(true)->toBeTrue()
    ->coversClass(Foo::class, Bar::class); // Same as `@covers MyClass`

test('covers global function')
    ->expect(true)->toBeTrue()
    ->coversFunction('globalFunction', 'anotherFunction'); // Same as `@covers ::functionName`

test('covers nothing')
    ->expect(true)->toBeTrue()
    ->coversNothing(); // Same as `@coversNothing`

Todo

• Move attributes above class and not method (only allowed on classes; @covers was allowed on methods but it does not make sense to mix different coverage targets in a test case class)
• Check FQN when passing a class name string (when it's passed to the Attribute)
• Lint
• Add tests
• Add smart "covers()" that accepts both classes and functions and checks if they exists (?)

[nunomaduro]

@danilopolani Looking very interesting so far!

[owenvoke]

Quick few things, but looks great to me! Thanks for adding the tests too! 🥳

[lukeraymonddowning]

Brilliant work here 👌

[danilopolani]

@owenvoke thank you for the review! At the end I've moved coversNothing to method annotations and I've left the "methods attribute" code generation as well, although right now not used, because it will be needed in the future.

Let me know if you prefer me to remove it because not needed or if it's fine :)

[nunomaduro]

Thank you for this! We may reach in the future, asking for docs about this. ✅

[danilopolani]

Thank you for this! We may reach in the future, asking for docs about this. ✅

Thank you Nuno! No problem, if you want I can already work on the PR for the docs 👀

[nunomaduro]

@danilopolani Can you check what static types errors we have on master, and pull request a fix? Or they are not related to your PR?

[danilopolani]

@danilopolani Can you check what static types errors we have on master, and pull request a fix? Or they are not related to your PR?

Yep sorry, I forgot to run test:types but only ran lint and tests 🤦 Sent a new PR -> #498