Merge 3.4 (asyncio doc)
This commit is contained in:
commit
65dc79b7a5
|
@ -243,6 +243,9 @@ Creating connections
|
||||||
|
|
||||||
On Windows with :class:`ProactorEventLoop`, this method is not supported.
|
On Windows with :class:`ProactorEventLoop`, this method is not supported.
|
||||||
|
|
||||||
|
See :ref:`UDP echo client protocol <asyncio-udp-echo-client-protocol>` and
|
||||||
|
:ref:`UDP echo server protocol <asyncio-udp-echo-server-protocol>` examples.
|
||||||
|
|
||||||
|
|
||||||
.. method:: BaseEventLoop.create_unix_connection(protocol_factory, path, \*, ssl=None, sock=None, server_hostname=None)
|
.. method:: BaseEventLoop.create_unix_connection(protocol_factory, path, \*, ssl=None, sock=None, server_hostname=None)
|
||||||
|
|
||||||
|
|
|
@ -473,6 +473,7 @@ having to write a short coroutine to handle the exception and stop the
|
||||||
running loop. At :meth:`~BaseEventLoop.run_until_complete` exit, the loop is
|
running loop. At :meth:`~BaseEventLoop.run_until_complete` exit, the loop is
|
||||||
no longer running, so there is no need to stop the loop in case of an error.
|
no longer running, so there is no need to stop the loop in case of an error.
|
||||||
|
|
||||||
|
|
||||||
TCP echo server
|
TCP echo server
|
||||||
---------------
|
---------------
|
||||||
|
|
||||||
|
@ -483,34 +484,122 @@ TCP echo server example, send back received data and close the connection::
|
||||||
class EchoServer(asyncio.Protocol):
|
class EchoServer(asyncio.Protocol):
|
||||||
def connection_made(self, transport):
|
def connection_made(self, transport):
|
||||||
peername = transport.get_extra_info('peername')
|
peername = transport.get_extra_info('peername')
|
||||||
print('connection from {}'.format(peername))
|
print('Connection from {}'.format(peername))
|
||||||
self.transport = transport
|
self.transport = transport
|
||||||
|
|
||||||
def data_received(self, data):
|
def data_received(self, data):
|
||||||
print('data received: {}'.format(data.decode()))
|
message = data.decode()
|
||||||
|
print('Data received: {!r}'.format(message))
|
||||||
|
|
||||||
|
print('Send: {!r}'.format(message))
|
||||||
self.transport.write(data)
|
self.transport.write(data)
|
||||||
|
|
||||||
# close the socket
|
print('Close the socket')
|
||||||
self.transport.close()
|
self.transport.close()
|
||||||
|
|
||||||
loop = asyncio.get_event_loop()
|
loop = asyncio.get_event_loop()
|
||||||
coro = loop.create_server(EchoServer, '127.0.0.1', 8888)
|
coro = loop.create_server(EchoServer, '127.0.0.1', 8888)
|
||||||
server = loop.run_until_complete(coro)
|
server = loop.run_until_complete(coro)
|
||||||
print('serving on {}'.format(server.sockets[0].getsockname()))
|
|
||||||
|
|
||||||
|
# Server requests until CTRL+c is pressed
|
||||||
|
print('Serving on {}'.format(server.sockets[0].getsockname()))
|
||||||
try:
|
try:
|
||||||
loop.run_forever()
|
loop.run_forever()
|
||||||
except KeyboardInterrupt:
|
except KeyboardInterrupt:
|
||||||
print("exit")
|
print("exit")
|
||||||
finally:
|
|
||||||
server.close()
|
# Close the server
|
||||||
loop.close()
|
server.close()
|
||||||
|
loop.run_until_complete(server.wait_closed())
|
||||||
|
loop.close()
|
||||||
|
|
||||||
:meth:`Transport.close` can be called immediately after
|
:meth:`Transport.close` can be called immediately after
|
||||||
:meth:`WriteTransport.write` even if data are not sent yet on the socket: both
|
:meth:`WriteTransport.write` even if data are not sent yet on the socket: both
|
||||||
methods are asynchronous. ``yield from`` is not needed because these transport
|
methods are asynchronous. ``yield from`` is not needed because these transport
|
||||||
methods are not coroutines.
|
methods are not coroutines.
|
||||||
|
|
||||||
|
|
||||||
|
.. _asyncio-udp-echo-client-protocol:
|
||||||
|
|
||||||
|
UDP echo client protocol
|
||||||
|
------------------------
|
||||||
|
|
||||||
|
UDP echo client using the :meth:`BaseEventLoop.create_datagram_endpoint`
|
||||||
|
method, send data and close the transport when we received the answer::
|
||||||
|
|
||||||
|
import asyncio
|
||||||
|
|
||||||
|
class EchoClientProtocol:
|
||||||
|
def __init__(self, message, loop):
|
||||||
|
self.message = message
|
||||||
|
self.loop = loop
|
||||||
|
self.transport = None
|
||||||
|
|
||||||
|
def connection_made(self, transport):
|
||||||
|
self.transport = transport
|
||||||
|
print('Send:', self.message)
|
||||||
|
self.transport.sendto(self.message.encode())
|
||||||
|
|
||||||
|
def datagram_received(self, data, addr):
|
||||||
|
print("Received:", data.decode())
|
||||||
|
|
||||||
|
print("Close the socket")
|
||||||
|
self.transport.close()
|
||||||
|
|
||||||
|
def error_received(self, exc):
|
||||||
|
print('Error received:', exc)
|
||||||
|
|
||||||
|
def connection_lost(self, exc):
|
||||||
|
print("Socket closed, stop the event loop")
|
||||||
|
loop = asyncio.get_event_loop()
|
||||||
|
loop.stop()
|
||||||
|
|
||||||
|
loop = asyncio.get_event_loop()
|
||||||
|
message = "Hello World!"
|
||||||
|
connect = loop.create_datagram_endpoint(
|
||||||
|
lambda: EchoClientProtocol(message, loop),
|
||||||
|
remote_addr=('127.0.0.1', 9999))
|
||||||
|
transport, protocol = loop.run_until_complete(connect)
|
||||||
|
loop.run_forever()
|
||||||
|
transport.close()
|
||||||
|
loop.close()
|
||||||
|
|
||||||
|
|
||||||
|
.. _asyncio-udp-echo-server-protocol:
|
||||||
|
|
||||||
|
UDP echo server protocol
|
||||||
|
------------------------
|
||||||
|
|
||||||
|
UDP echo server using the :meth:`BaseEventLoop.create_datagram_endpoint`
|
||||||
|
method, send back received data::
|
||||||
|
|
||||||
|
import asyncio
|
||||||
|
|
||||||
|
class EchoServerClientProtocol:
|
||||||
|
def connection_made(self, transport):
|
||||||
|
self.transport = transport
|
||||||
|
|
||||||
|
def datagram_received(self, data, addr):
|
||||||
|
message = data.decode()
|
||||||
|
print('Received %r from %s' % (message, addr))
|
||||||
|
print('Send %r to %s' % (message, addr))
|
||||||
|
self.transport.sendto(data, addr)
|
||||||
|
|
||||||
|
loop = asyncio.get_event_loop()
|
||||||
|
print("Starting UDP server")
|
||||||
|
listen = loop.create_datagram_endpoint(
|
||||||
|
EchoServerClientProtocol, local_addr=('127.0.0.1', 9999))
|
||||||
|
transport, protocol = loop.run_until_complete(listen)
|
||||||
|
|
||||||
|
try:
|
||||||
|
loop.run_forever()
|
||||||
|
except KeyboardInterrupt:
|
||||||
|
pass
|
||||||
|
|
||||||
|
transport.close()
|
||||||
|
loop.close()
|
||||||
|
|
||||||
|
|
||||||
.. _asyncio-register-socket:
|
.. _asyncio-register-socket:
|
||||||
|
|
||||||
Register an open socket to wait for data using a protocol
|
Register an open socket to wait for data using a protocol
|
||||||
|
|
Loading…
Reference in New Issue