Merge type annotations from typeshed

Author: Avasam

boltons/cacheutils.py

@@ -34,6 +34,9 @@
 built-in Python debugger.
 """
 
+from __future__ import annotations
+
+from collections.abc import Callable
 import sys
 import time
 from reprlib import Repr
@@ -47,7 +50,7 @@
 __all__ = ['pdb_on_signal', 'pdb_on_exception', 'wrap_trace']
 
 
-def pdb_on_signal(signalnum=None):
+def pdb_on_signal(signalnum: int | None = None) -> None:
     """Installs a signal handler for *signalnum*, which defaults to
     ``SIGINT``, or keyboard interrupt/ctrl-c. This signal handler
     launches a :mod:`pdb` breakpoint. Results vary in concurrent
@@ -75,7 +78,7 @@ def pdb_int_handler(sig, frame):
     return
 
 
-def pdb_on_exception(limit=100):
+def pdb_on_exception(limit: int = 100) -> None:
     """Installs a handler which, instead of exiting, attaches a
     post-mortem pdb console whenever an unhandled exception is
     encountered.
@@ -138,8 +141,8 @@ def trace_print_hook(event, label, obj, attr_name,
     return
 
 
-def wrap_trace(obj, hook=trace_print_hook,
-               which=None, events=None, label=None):
+def wrap_trace(obj, hook: Callable = trace_print_hook,
+               which: str | None = None, events: str | None = None, label: str | None = None):
     """Monitor an object for interactions. Whenever code calls a method,
     gets an attribute, or sets an attribute, an event is called. By
     default the trace output is printed, but a custom tracing *hook*

boltons/debugutils.py

@@ -31,18 +31,19 @@
 
 import sys
 from types import ModuleType
+from typing import Any
 from warnings import warn
 
 # todo: only warn once
 
 
 class DeprecatableModule(ModuleType):
-    def __init__(self, module):
+    def __init__(self, module: ModuleType):
         name = module.__name__
         super().__init__(name=name)
         self.__dict__.update(module.__dict__)
 
-    def __getattribute__(self, name):
+    def __getattribute__(self, name: str) -> Any:
         get_attribute = super().__getattribute__
         try:
             depros = get_attribute('_deprecated_members')
@@ -55,7 +56,7 @@ def __getattribute__(self, name):
         return ret
 
 
-def deprecate_module_member(mod_name, name, message):
+def deprecate_module_member(mod_name: str, name: str, message: str) -> None:
     module = sys.modules[mod_name]
     if not isinstance(module, DeprecatableModule):
         sys.modules[mod_name] = module = DeprecatableModule(module)