[Python-checkins] cpython (merge default -> default): Merge heads

[serhiy.storchaka]

http://hg.python.org/cpython/rev/0eec47f9f8a1
changeset:   88770:0eec47f9f8a1
parent:      88769:1aa8ea187560
parent:      88768:b128387df61d
user:        Serhiy Storchaka <storchaka at gmail.com>
date:        Mon Jan 27 11:17:48 2014 +0200
summary:
  Merge heads

files:
  Doc/library/asyncio-eventloop.rst |  47 +++++++++++++++++++
  1 files changed, 47 insertions(+), 0 deletions(-)


diff --git a/Doc/library/asyncio-eventloop.rst b/Doc/library/asyncio-eventloop.rst
--- a/Doc/library/asyncio-eventloop.rst
+++ b/Doc/library/asyncio-eventloop.rst
@@ -325,6 +325,29 @@
    This method returns a :ref:`coroutine object <coroutine>`.
 
 
+UNIX signals
+------------
+
+Availability: UNIX only.
+
+.. method:: BaseEventLoop.add_signal_handler(signum, callback, \*args)
+
+   Add a handler for a signal.
+
+   Raise :exc:`ValueError` if the signal number is invalid or uncatchable.
+   Raise :exc:`RuntimeError` if there is a problem setting up the handler.
+
+.. method:: BaseEventLoop.remove_signal_handler(sig)
+
+   Remove a handler for a signal.
+
+   Return ``True`` if a signal handler was removed, ``False`` if not.
+
+.. seealso::
+
+   The :mod:`signal` module.
+
+
 Executor
 --------
 
@@ -381,3 +404,27 @@
 
    :ref:`Hello World example using a coroutine <asyncio-hello-world-coroutine>`.
 
+
+Example: Set signal handlers for SIGINT and SIGTERM
+---------------------------------------------------
+
+Register handlers for signals :py:data:`SIGINT` and :py:data:`SIGTERM`::
+
+    import asyncio
+    import functools
+    import os
+    import signal
+
+    def ask_exit(signame):
+        print("got signal %s: exit" % signame)
+        loop.stop()
+
+    loop = asyncio.get_event_loop()
+    for signame in ('SIGINT', 'SIGTERM'):
+        loop.add_signal_handler(getattr(signal, signame),
+                                functools.partial(ask_exit, signame))
+
+    print("Event loop running forever, press CTRL+c to interrupt.")
+    print("pid %s: send SIGINT or SIGTERM to exit." % os.getpid())
+    loop.run_forever()
+

-- 
Repository URL: http://hg.python.org/cpython