Fix #1978: Deprecate on_loop_available (#1989)

CHANGES.rst

@@ -38,6 +38,14 @@ Changes
 
 - Fix BadStatusLine caused by extra `CRLF` after `POST` data #1792
 
+-
+
+- Deprecate undocumented app.on_loop_available signal #1978
+
+-
+
+-
+
 
 2.1.0 (2017-05-26)
 ------------------

aiohttp/web.py

@@ -199,6 +199,8 @@ def add_subapp(self, prefix, subapp):
 
     @property
     def on_loop_available(self):
+        warnings.warn("on_loop_available is deprecated and will be removed",
+                      DeprecationWarning, stacklevel=2)
         return self._on_loop_available
 
     @property

tests/test_web_application.py

@@ -50,7 +50,8 @@ def test_on_loop_available(loop):
     app = web.Application()
 
     cb = mock.Mock()
-    app.on_loop_available.append(cb)
+    with pytest.warns(DeprecationWarning):
+        app.on_loop_available.append(cb)
 
     app._set_loop(loop)
     cb.assert_called_with(app)