expose a logger option to start_reloader

CHANGES.rst

@@ -8,6 +8,10 @@ unreleased
   receive a ``SIGKILL``.
   See https://github.com/Pylons/hupper/pull/48
 
+- Support a ``logger`` argument to ``hupper.start_reloader`` to override
+  the default logger that outputs messages to ``sys.stderr``.
+  See https://github.com/Pylons/hupper/pull/49
+
 1.5 (2019-02-16)
 ================
 

docs/api.rst

@@ -33,6 +33,10 @@
     :members:
     :special-members:
 
+  .. autoclass:: ILogger
+    :members:
+    :special-members:
+
 .. automodule:: hupper.polling
 
   .. autoclass:: PollingFileMonitor

src/hupper/reloader.py

@@ -1,5 +1,3 @@
-from __future__ import print_function
-
 import fnmatch
 import os
 import re
@@ -277,6 +275,7 @@ def start_reloader(
     reload_interval=1,
     shutdown_interval=default,
     verbose=1,
+    logger=None,
     monitor_factory=None,
     worker_args=None,
     worker_kwargs=None,
@@ -306,6 +305,9 @@ def start_reloader(
     ``verbose`` controls the output. Set to ``0`` to turn off any logging
     of activity and turn up to ``2`` for extra output. Default is ``1``.
 
+    ``logger``, if supplied, supersedes ``verbose`` and should be an object
+    implementing :class:`hupper.interfaces.ILogger`.
+
     ``monitor_factory`` is an instance of
     :class:`hupper.interfaces.IFileMonitorFactory`. If left unspecified, this
     will try to create a :class:`hupper.watchdog.WatchdogFileMonitor` if
@@ -324,7 +326,8 @@ def start_reloader(
     if is_active():
         return get_reloader()
 
-    logger = DefaultLogger(verbose)
+    if logger is None:
+        logger = DefaultLogger(verbose)
 
     if monitor_factory is None:
         monitor_factory = find_default_monitor_factory(logger)