py312: Filter(er) might return a LogRecord (#10540)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>

stdlib/logging/__init__.pyi

@@ -85,7 +85,10 @@ class Filterer:
  filters: list[_FilterType]
  def addFilter(self, filter: _FilterType) -> None: ...
  def removeFilter(self, filter: _FilterType) -> None: ...
- def filter(self, record: LogRecord) -> bool: ...
+ if sys.version_info >= (3, 12):
+ def filter(self, record: LogRecord) -> bool | LogRecord: ...
+ else:
+ def filter(self, record: LogRecord) -> bool: ...
 
 class Manager: # undocumented
  root: RootLogger
@@ -378,7 +381,10 @@ class Filter:
  name: str # undocumented
  nlen: int # undocumented
  def __init__(self, name: str = "") -> None: ...
- def filter(self, record: LogRecord) -> bool: ...
+ if sys.version_info >= (3, 12):
+ def filter(self, record: LogRecord) -> bool | LogRecord: ...
+ else:
+ def filter(self, record: LogRecord) -> bool: ...
 
 class LogRecord:
  # args can be set to None by logging.handlers.QueueHandler