Skip to content

Add usage page about filters #242

@fflaten

Description

@fflaten

Consider rewriting Tags-page to be about filters in general. Should explain behavior when multiple filters are used like exclude/include/explicit priority. The latter is only indirectly mentioned on other pages, including deprecated v4-parameters in Invoke-Pester command ref.

I have a PesterConfiguration with two filter options set - $configuration.Filter.Tag and $configuration.Filter.FullName.

I expected, that the both filters will apply to the subset of tests and it'll narrow down the search so only specified tests that has the selected tag will be run. Pester works in a different manner. It creates a union of two filters so all the tests specified in $configuration.Filter.FullName will be launched as well as all the tests having $configuration.Filter.Tag tags.

If that's the strategy we expect from Pester, maybe we could mention this behavior it in the New-PesterConfiguration Filter documentation.

Originally posted by @tempora-mutantur in pester/Pester#2278 (comment)

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentation

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions