Deprecate git.util.NullHandler

The NullHandler class in git.util was added when merging #300, to
allow a noop handler to be used on Python 2.6, since the standard
library logging.NullHandler class was added in Python 2.7.

When introduced in d1a9a23, the git.util.NullHandler class was also
patched into the logging module, but that has no longer been done
since 2fced2e (#979), nor does GitPython make other use of it.

This also changes the parameter type annotation on the emit method
from `object` to `logging.LogRecord`, which is the expeced type.

Author: EliahKagan

Diff for: git/util.py

@@ -1295,5 +1295,20 @@ def list_items(cls, repo: "Repo", *args: Any, **kwargs: Any) -> Any:
 
 
 class NullHandler(logging.Handler):
-    def emit(self, record: object) -> None:
+    """Deprecated, use :class:`logging.NullHandler` instead.
+
+    This noop handler is like :class:`~logging.NullHandler` in the standard library,
+    which should be used instead, because it is now always available, and it overrides
+    more logging methods to make them noop. This class only overrides :meth:`emit`.
+    """
+
+    def __init__(self, level: int = logging.NOTSET) -> None:
+        warnings.warn(
+            "NullHandler in git.util is deprecated. Use logging.NullHandler instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        super().__init__(level)
+
+    def emit(self, record: logging.LogRecord) -> None:
         pass