Deprecated the profiler hook

README.rst

@@ -20,7 +20,7 @@ Three principal ways to do type checking are provided, each with its pros and co
 
    * automatically type checks yields and sends of returned generators (regular and async)
    * adds an extra frame to the call stack for every call to a decorated function
-#. the stack profiler hook (``with TypeChecker('packagename'):``):
+#. the stack profiler hook (``with TypeChecker('packagename'):``) (deprecated):
 
    * emits warnings instead of raising ``TypeError``
    * requires very few modifications to the code

docs/index.rst

@@ -80,6 +80,9 @@ yields and sends of an async generator (annotated with :class:`~typing.AsyncGene
 Using the profiler hook
 -----------------------
 
+.. deprecated:: 2.6
+   Use the import hook instead. The profiler hook will be removed in v3.0.
+
 This type checking approach requires no code changes, but does come with a number of drawbacks.
 It relies on setting a profiler hook in the interpreter which gets called every time a new Python
 stack frame is entered or exited.

docs/versionhistory.rst

@@ -6,6 +6,7 @@ This library adheres to `Semantic Versioning 2.0 <https://semver.org/#semantic-v
 **UNRELEASED**
 
 - Added a :pep:`302` import hook for annotating functions and classes with ``@typechecked``
+- Deprecated ``TypeChecker`` (will be removed in v3.0)
 
 **2.5.1** (2019-09-26)
 

typeguard/__init__.py

@@ -806,6 +806,9 @@ class TypeChecker:
     :param all_threads: ``True`` to check types in all threads created while the checker is
         running, ``False`` to only check in the current one
     :param forward_refs_policy: how to handle unresolvable forward references in annotations
+
+    .. deprecated:: 2.6
+       Use :func:`~.importhook.install_import_hook` instead. This class will be removed in v3.0.
     """
 
     def __init__(self, packages: Union[str, Sequence[str]], *, all_threads: bool = True,