feat: ✨ add CheckErrorMatcher object

[martonvago]

Description

This PR adds a CheckErrorMatcher object. This is/will be used to filter out unwanted errors easily.
Example usage:

errors = exclude_errors(
        errors,
        [
            CheckErrorMatcher(validator="required", json_path="data"),
            CheckErrorMatcher(validator="type", json_path="path", message="not of type 'array'"),
        ],
    )

I'm going to use this to replace the check_required flag in Sprout's check functions.

This PR needs an in-depth review.

Checklist

• Added or updated tests
• Updated documentation
• Ran just run-all

[lwjohnst86]

I have a hard time seeing what this does or it's usefulness, but I think it would help once we move these functionality over into a standalone package with some guides showing the functions in action. Or seeing the functions in action in other functions within Sprout. But you're very much knowledgeable about what's needed and the challenges in this check area, so 👍

[signekb]

Nice work 👍 Just a suggestion and a question to help me understand 🔍

[signekb]

There might be a very basic answer to this but why do we want the match to be false here, while the message is matched (True) when the matcher is an empty string (L12)?
Same with the validator below (L61)

[martonvago]

Not very solid reasons 😅! I was thinking:

• message_matches should check if the matcher message is a substring of the error message. Doesn't matter that much if "" matches or not?
• json_path_matches should check if the matcher json path is exactly the full path or exactly the very last field. "" is neither, so I made it not match anything.
• validator_matches should check if the matcher validator is exactly the validator of the error. "" is not a validator, so I made it not match.

We can refine the behaviour further for sure!

[signekb]

Ah, I think that makes sense! Thanks for elaborating 👍