feat: Add PythonModuleLoader.fnmatch to filter modules by pattern

docs/guides/imports.md

@@ -45,7 +45,7 @@ The predicate function receives the full module name (e.g., `"src.adapters.depen
 
 ### Factory methods
 
-`PythonModuleLoader` provides three convenient factory methods for common filtering patterns:
+`PythonModuleLoader` provides four convenient factory methods for common filtering patterns:
 
 **Filter by prefix:**
 ```python
@@ -59,6 +59,16 @@ PythonModuleLoader.startswith("impl_").load(adapters, services)
 PythonModuleLoader.endswith("_impl").load(adapters, services)
 ```
 
+`startswith` and `endswith` only check the last part of the module name (e.g., `"dependency_impl"` for `"src.adapters.dependency_impl"`).
+
+**Filter by pattern:**
+```python
+# Import only modules inside an "impl" subpackage
+PythonModuleLoader.fnmatch("*.impl.*").load(adapters, services)
+```
+
+Unlike `startswith` and `endswith`, the patterns are matched against the full module name, using the [`fnmatch`](https://docs.python.org/3/library/fnmatch.html) syntax (`*`, `?`, `[seq]`). Matching is case-sensitive, and `*` also matches dots: `"src.*"` matches `"src.adapters.dependency_impl"`.
+
 **Filter by keyword marker:**
 ```python
 # Import only modules containing a specific comment

injection/loaders.py

@@ -5,6 +5,7 @@
 from abc import abstractmethod
 from collections.abc import Callable, Iterator, Mapping, Sequence
 from dataclasses import dataclass, field
+from fnmatch import fnmatchcase
 from importlib import import_module
 from importlib.util import find_spec
 from os.path import isfile
@@ -99,6 +100,13 @@ def __iter_modules_from(
             module = import_module(name) if self.predicate(name) else None
             yield name, module
 
+    @classmethod
+    def fnmatch(cls, *patterns: str) -> Self:
+        def predicate(module_name: str) -> bool:
+            return any(fnmatchcase(module_name, pattern) for pattern in patterns)
+
+        return cls(predicate)
+
     @classmethod
     def from_keywords(cls, *keywords: str) -> Self:
         """

tests/test_loaders.py

@@ -69,6 +69,13 @@ def test_load_with_loaded_module_returns_loader(self) -> None:
 
         assert modules.keys() == {"tests.packages.package1.module1"}
 
+    def test_fnmatch_with_pattern_returns_loader(self) -> None:
+        loader = PythonModuleLoader.fnmatch("*.sub_package.*")
+
+        modules = loader.load(package1).modules
+
+        assert modules.keys() == {"tests.packages.package1.sub_package.module2"}
+
     def test_from_keywords_with_keyword_returns_loader(self) -> None:
         loader = PythonModuleLoader.from_keywords("@injectable")