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

❌ Patch coverage is 98.63014% with 1 line in your changes missing coverage. Please review.
✅ Project coverage is 98.05%. Comparing base (ab8a36c) to head (3d93bfa).
✅ All tests successful. No failed tests found.

Files with missing lines	Patch %	Lines
src/Test/Target/MapBuilder.php	95.00%	1 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff            @@
##               main    #1210   +/-   ##
=========================================
  Coverage     98.04%   98.05%           
- Complexity     1622     1654   +32     
=========================================
  Files           114      117    +3     
  Lines          5429     5500   +71     
=========================================
+ Hits           5323     5393   +70     
- Misses          106      107    +1     

☔ View full report in Codecov by Harness.
📢 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