From f25678cacc8cd1fbb8a28c196e8fe2eed291146c Mon Sep 17 00:00:00 2001
From: Ben Finney <ben+python@benfinney.id.au>
Date: Oct 26 2016 09:51:09 +0000
Subject: Begin the deprecation procedure for ‘runner’ module.


* wip/feature/deprecate-runner:
  : Deprecate the ‘runner’ module to an example only.
  Raise a warning that the ‘runner’ module is pending deprecation.

---

diff --git a/ChangeLog b/ChangeLog
index 6d6a633..ffafefa 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -22,6 +22,9 @@ Changes:
 
 * Migrate code project hosting to Pagure.
   Record the change of homepage URL in PyPI metadata.
+* Raise a warning that the ‘runner’ module is pending deprecation.
+  This has been an unofficial example module from the beginning, and
+  it will be removed in a future version.
 
 Bug Fixes:
 
diff --git a/daemon/runner.py b/daemon/runner.py
index ac5b679..2b74263 100644
--- a/daemon/runner.py
+++ b/daemon/runner.py
@@ -19,10 +19,11 @@
 
 from __future__ import (absolute_import, unicode_literals)
 
-import sys
+import errno
 import os
 import signal
-import errno
+import sys
+import warnings
 
 import lockfile
 
@@ -40,6 +41,11 @@ except NameError:
 
 __metaclass__ = type
 
+
+warnings.warn(
+        "The ‘runner’ module is not a supported API for this library.",
+        PendingDeprecationWarning)
+
 
 class DaemonRunnerError(Exception):
     """ Abstract base class for errors from DaemonRunner. """