Filesystem-based targeting

[sebastianbergmann]

PHPUnit wants to introduce #[CoversFile], #[UsesFile], #[CoversDirectory], #[UsesDirectory], #[CoversDirectoryRecursively], and #[UsesDirectoryRecursively] attributes so that test classes can scope coverage to a file or directory instead of a class, trait, method, function, or namespace. This unblocks the use cases tracked in sebastianbergmann/phpunit#3794.

Before PHPUnit can implement those attributes, this library needs new Target types and the matching entries in the TargetMap produced by MapBuilder.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 83.02%. Comparing base (060c3de) to head (72c20d1).
⚠️ Report is 2 commits behind head on main.
✅ All tests successful. No failed tests found.

Additional details and impacted files

@@             Coverage Diff              @@
##               main    #1210      +/-   ##
============================================
+ Coverage     82.80%   83.02%   +0.21%     
- Complexity     1570     1601      +31     
============================================
  Files           113      116       +3     
  Lines          5315     5383      +68     
============================================
+ Hits           4401     4469      +68     
  Misses          914      914              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[github-actions]

API Surface Changes

If any of the additions below are not intended as public API, mark them with @internal in the docblock.

New API Surface

Classes

• SebastianBergmann\CodeCoverage\Test\Target\Directory — class SebastianBergmann\CodeCoverage\Test\Target\Directory extends SebastianBergmann\CodeCoverage\Test\Target\Target
• SebastianBergmann\CodeCoverage\Test\Target\DirectoryRecursively — class SebastianBergmann\CodeCoverage\Test\Target\DirectoryRecursively extends SebastianBergmann\CodeCoverage\Test\Target\Target
• SebastianBergmann\CodeCoverage\Test\Target\File — class SebastianBergmann\CodeCoverage\Test\Target\File extends SebastianBergmann\CodeCoverage\Test\Target\Target

Methods

• SebastianBergmann\CodeCoverage\Test\Target\Directory::__construct — protected function __construct(string $directory)
• SebastianBergmann\CodeCoverage\Test\Target\Directory::directory — public function directory(): string
• SebastianBergmann\CodeCoverage\Test\Target\DirectoryRecursively::__construct — protected function __construct(string $directory)
• SebastianBergmann\CodeCoverage\Test\Target\DirectoryRecursively::directory — public function directory(): string
• SebastianBergmann\CodeCoverage\Test\Target\File::__construct — protected function __construct(string $path)
• SebastianBergmann\CodeCoverage\Test\Target\File::path — public function path(): string
• SebastianBergmann\CodeCoverage\Test\Target\Target::forFile — static public function forFile(string $path): SebastianBergmann\CodeCoverage\Test\Target\File
• SebastianBergmann\CodeCoverage\Test\Target\Target::forDirectory — static public function forDirectory(string $directory): SebastianBergmann\CodeCoverage\Test\Target\Directory
• SebastianBergmann\CodeCoverage\Test\Target\Target::forDirectoryRecursively — static public function forDirectoryRecursively(string $directory): SebastianBergmann\CodeCoverage\Test\Target\DirectoryRecursively
• SebastianBergmann\CodeCoverage\Test\Target\Target::isFile — public function isFile(): bool
• SebastianBergmann\CodeCoverage\Test\Target\Target::isDirectory — public function isDirectory(): bool
• SebastianBergmann\CodeCoverage\Test\Target\Target::isDirectoryRecursively — public function isDirectoryRecursively(): bool