docs: clarify predicate-quantifier output semantics

This commit is contained in:
Sascha Bratton 2026-07-02 15:49:33 -04:00
parent 6f53153b8c
commit 9e62e9aa23
No known key found for this signature in database

View File

@ -173,10 +173,13 @@ For more information, see [CHANGELOG](https://github.com/dorny/paths-filter/blob
## Outputs
- Each filter sets an output variable named by the filter to the following text value:
- `'true'` - if **any** of the changed files match any filter rules with `predicate-quantifier` set to `'some'` (default)
- `'true'` - if **any** of the changed files match **all** filter rules with `predicate-quantifier` set to `'every'`
- `'false'` - if **none** of the changed files matches any of filter rules
- Each filter sets an output variable, named after the filter, whose text value depends on the `predicate-quantifier` setting:
- With `predicate-quantifier: 'some'` (default):
- `'true'` - if **any** changed file matches **at least one** of the filter's rules
- `'false'` - if **no** changed file matches **at least one** of the filter's rules
- With `predicate-quantifier: 'every'`:
- `'true'` - if **any** changed file matches **all** of the filter's rules
- `'false'` - if **no** changed file matches **all** of the filter's rules
- Each filter sets an output variable with the name `${FILTER_NAME}_count` to the count of matching files.
- If enabled, for each filter it sets an output variable with the name `${FILTER_NAME}_files`. It will contain a list of all files matching the filter.
- `changes` - JSON array with names of all filters matching any of the changed files.