[MonikaDvorackova]

Fixes #160900.

Ensure fnmatch.filter() and fnmatch.filterfalse() normalize every name with os.path.normcase(), including on POSIX. This lets path-like objects such as pathlib.Path work consistently across platforms. Add regression tests for both functions.

• Issue: fnmatch.filter and filterfalse work with pathlikes only on non-Posix platforms #160900

[python-cla-bot]

All commit authors signed the Contributor License Agreement.

[bedevere-app]

Most changes to Python require a NEWS entry. Add one using the blurb_it web app or the blurb command-line tool.

If this change has little impact on Python users, wait for a maintainer to apply the skip news label instead.

[MonikaDvorackova]

@picnixz

Thank you for the review. I've addressed the requested changes:

• Moved the path-like tests immediately after their corresponding filter and filterfalse tests.
• Updated the documentation to describe path-like input support and preservation of the original objects.
• Benchmarked the existing itertools.filterfalse implementation against a list comprehension and an explicit loop using pyperf, with input sizes of 10, 100, 1,000, and 10,000 elements.

The list comprehension was consistently the fastest, reducing execution time by approximately 18–21% compared with the previous implementation.

I've updated filterfalse() accordingly and removed the unused itertools import.

All 26 test_fnmatch tests pass, and git diff --check reports no issues.

The benchmark results are preliminary measurements from a CPython 3.16 debug build using pyperf --fast, rather than release-build performance figures.

[read-the-docs-community]

Documentation build overview

📚 cpython-previews | 🛠️ Build #35672119 | 📁 Comparing b55db66 against main (44579b0)

  🔍 Preview build  

26 files changed · ± 26 modified

± Modified

• builtins/stdtypes.html
• builtins/threadsafety.html
• c-api/frame.html
• c-api/gcsupport.html
• c-api/gen.html
• c-api/object.html
• c-api/tuple.html
• c-api/typeobj.html
• howto/descriptor.html
• howto/enum.html
• and 16 more...

[picnixz]

The benchmark results are preliminary measurements from a CPython 3.16 debug build using pyperf --fast, rather than release-build performance figures.

Please don't. Use a release build or one with a --enable-optimizations. A debug build serves no purpose in benchmarking in general. And please tell me which samples you used.

[MonikaDvorackova]

Thanks for the review. I've pushed the documentation updates and added test_mix_bytes_str_pathlike to both FilterTestCase and FilterFalseTestCase. All 28 test_fnmatch tests pass.

I also reran the performance comparison using a CPython 3.16 release build rather than a debug build.

The benchmark compares three implementations:

• itertools.filterfalse with a lambda predicate
• A list comprehension
• An explicit for loop

The input consists of filename strings matched against *.py. I tested input sizes of 10, 100, 1,000, and 10,000 elements, with matching proportions of 0%, 50%, and 100%.

Selected results:

Matches	Elements	filterfalse + lambda	List comprehension	Explicit loop
50%	10	1.46 µs	1.17 µs	1.19 µs
50%	100	11.8 µs	10.1 µs	10.3 µs
50%	1,000	115 µs	97.9 µs	98.9 µs
50%	10,000	1.14 ms	966 µs	982 µs

The list comprehension was faster than the lambda-based implementation in 11 of the 12 tested scenarios. However, some measurements showed substantial variability, so these results should be treated as preliminary rather than definitive.

I haven't yet reproduced the benchmark scripts from the original filterfalse PR. I'll check those as well to ensure the comparison covers the original payloads.

[picnixz]

Please don't use an LLM to post your comments. I don't want to communicate with an agent only. YOur comments are not edited at since the markdown contains the HTML itself.

[picnixz]

Please avoid updating the branches when there is nothing that has changed. It wastes CI resources. Read https://devguide.python.org/getting-started/pull-request-lifecycle/#update-branch-button

[MonikaDvorackova]

Ok. Thanks for the review. I've addressed the feedback, including the documentation changes and the mixed bytes/str/path-like regression tests.

The latest CI run has completed, with all 51 technical checks passing across the supported platforms.

I also wanted to clarify the earlier branch update: it was intended to retry the macOS CI job after the runner lost communication. I'll avoid unnecessary branch updates going forward.

The PR should now be ready for another review.

[MonikaDvorackova]

I pushed the requested changes in b55db66, including the list comprehension in filter(), and resolved the addressed review threads. Tests, lint, and the documentation preview have all passed.