sebastianbergmann/php-file-iterator
63.8
Adequate · 13 November 2026
772
lines of production code
PHP
primary language
7
measurements over time
What this system is
Removals
Removal of File\_Iterator class
The File\_Iterator class, which filtered files based on specified prefixes and suffixes, has been removed from the codebase. This eliminates the ability to use this specific iterator for file selection in tests or other processes relying on it.
File · high confidence
Behavioural changes
1 commit (0 fixes) modifying tools/.php-cs-fixer
A change to existing behaviour in tools/.php-cs-fixer — 1 commit, 20 files: “Manage PHP-CS-Fixer with Composer instead of Phive”.
tools/.php-cs-fixer · medium confidence · unverified
134 commits (0 fixes) modifying tools
A change to existing behaviour in tools — 134 commits, 3 files: “Update tools”; “Update tools (and manage Composer through Phive)”; “Update PHP-CS-Fixer”; and 5 more.
tools · medium confidence · unverified
Automated release note extraction for tagged releases
A new build script (build/scripts/extract-release-notes.php) has been added to support the 'Create release when tag is pushed' workflow. This tool parses the project's ChangeLog.md file to automatically extract the release notes corresponding to a specific version tag, enabling automated release creation processes.
build · high confidence
New file-iterator implementation with hidden-file and wildcard support
The src directory now contains a complete rewrite of the file-iteration logic, introducing new classes: ExcludeIterator, Facade, Factory, and Iterator. ExcludeIterator prunes hidden directories (those starting with a dot) from traversal while still accepting hidden files, and respects user-specified exclude paths. Factory resolves wildcard patterns (including \\ globstar syntax) and builds the iterator chain, handling unreadable directories gracefully. Iterator filters files by configurable prefixes and suffixes. Facade provides a simple entry point to retrieve a sorted, unique list of file paths matching the criteria.
src · high confidence
Repository maintenance and build configuration updates
This release introduces several repository-level improvements: a new .gitattributes file ensures that build artifacts, tests, and configuration files are excluded from archive exports; a .gitignore file is added to ignore local IDE and cache directories; the PHP-CS-Fixer configuration is updated with stricter formatting rules; the PHPUnit configuration is updated to enforce stricter testing standards; and the PEAR package.xml file is removed, indicating the end of PEAR distribution support.
(repo-wide) · high confidence
Test coverage
Added tests for file iterator edge cases and exclusion logic
Added unit tests for the file iterator facade and factory to verify correct behavior when handling directory exclusions (including prefix-based exclusions and trailing slashes), glob patterns, hidden directories, unopenable directories, and directories with names that cannot be matched by glob patterns.
tests · high confidence
Dependencies
PHPStan static analysis tooling upgraded to version 2.2.16 with strict rules
The local PHP development environment now uses PHPStan 2.2.16, upgraded from previous versions, alongside phpstan-strict-rules 2.0.12 and ergebnis/phpstan-rules 2.14.0. This update brings stricter static analysis capabilities to the codebase, ensuring higher code quality and catching more potential issues during development. Also in this area: 1 commit (0 fixes) modifying tools, tools/.phpstan/vendor/phpstan/phpstan-phpunit; 4 commits (0 fixes) modifying tools; Updated PHPStan to version 2.2.15.
tools/.phpstan · medium confidence · unverified
Update development dependencies and tooling configuration
The project's \composer.json\ has been updated to require PHP 8.4 or higher and upgraded \phpunit/phpunit\ to version 13.3.5. Additionally, the PHPStan tooling configuration in \tools/.phpstan/composer.json\ now specifies \phpstan/phpstan\ version 2.2.16, along with \phpstan/extension-installer\ 1.4.3, \phpstan/phpstan-strict-rules\ 2.0.12, and \ergebnis/phpstan-rules\ 2.14.0.
(dependencies) · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 64 → 64 (+0.1)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.
Lenses
- Code Health 100 → 100 (+0.0)
- Architecture 69 → 69 (+0.0)
- Maturity 49 → 49 (+0.0)
- Readiness 79 → 85 (+5.8)
- Security 88 → 81 (-6.3)
Resolved (2)
- Documentation: no installation or build instructions (README.md)
- Documentation: no project overview (README.md)
Changes since last survey
- 27 commits — 26 feature/other, 1 fixes
By area
- tools/.phpstan — 15 commits
- (root) — 5 commits
- (repo) — 4 commits
- src/Factory.php — 1 commit
- tools/.php-cs-fixer — 1 commit
- tools/composer — 1 commit
Notable commits
- fix: Fix CS/WS issues
- change: Manage PHP-CS-Fixer with Composer instead of Phive
- change: Merge branch '6.0'
- change: Merge branch '6.0'
- change: Merge branch '6.0'
- change: Merge branch '6.0'
- change: Remove stale entry
- change: Update PHPStan packages
- change: Update PHPStan packages
- change: Update dependency ergebnis/phpstan-rules to ^2.17.0
- change: Update dependency ergebnis/phpstan-rules to ^2.17.0
- change: Update dependency ergebnis/phpstan-rules to ^2.17.1
- change: Update dependency ergebnis/phpstan-rules to ^2.17.1
- change: Update dependency phpstan/phpstan to ^2.3.3
- change: Update dependency phpstan/phpstan to ^2.3.3
- change: Update dependency phpstan/phpstan to ^2.3.5
- change: Update dependency phpstan/phpstan to ^2.3.5
- change: Update dependency phpstan/phpstan-phpunit to ^2.1.2
- change: Update dependency phpstan/phpstan-strict-rules to ^2.1.1
- change: Update dependency phpstan/phpstan-strict-rules to ^2.1.1
- …and 7 more
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
sebastianbergmann/php-file-iterator was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 13 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit f3b2ffb1888cf5b3a4d9e0252a0a7842aebb2bab — the exact code this score is about.
- Scored under rubric-2026.11.4 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.65+preprod-859b6d22580d.