cpython-lru_cache-weakref: Lib/socket.py annotate

annotate Lib/socket.py @ 86127:a3d09c19bb93

merge with 3.3

author	Georg Brandl <georg@python.org>
date	Sun, 06 Oct 2013 19:24:00 +0200
parents	038543d34166
children	c5751f01b09b

rev	line source
14007 eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	1 # Wrapper module for _socket, providing some additional facilities
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	2 # implemented in Python.
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	3
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	4 """\
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	5 This module provides socket operations and some related functions.
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	6 On Unix, it supports IP (Internet Protocol) and Unix domain sockets.
15872 3685ef2a55a4 Whitespace normalization. Tim Peters <tim.peters@gmail.com> parents: 14935 diff changeset	7 On other systems, it only supports IP. Functions specific for a
14935 13488539f02b Mention in the module's doc string that other functions of the socket API Martin v. Löwis <martin@v.loewis.de> parents: 14682 diff changeset	8 socket are available as methods of the socket object.
14007 eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	9
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	10 Functions:
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	11
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	12 socket() -- create a new socket object
33063 90da70986407 Patch #1003700: Add socketpair function to socket module. Dave Cole <djc@object-craft.com.au> parents: 32160 diff changeset	13 socketpair() -- create a pair of new socket objects [*]
14007 eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	14 fromfd() -- create a socket object from an open file descriptor [*]
76150 51b4bddd0e92 Issue #14310: inter-process socket duplication for windows Kristján Valur Jónsson <kristjan@ccpgames.com> parents: 76034 diff changeset	15 fromshare() -- create a socket object from data received from socket.share() [*]
14007 eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	16 gethostname() -- return the current hostname
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	17 gethostbyname() -- map a hostname to its IP number
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	18 gethostbyaddr() -- map an IP number or hostname to DNS info
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	19 getservbyname() -- map a service name and a protocol name to a port number
54514 7234a83a8b19 Merged revisions 73138 via svnmerge from Mark Dickinson <dickinsm@gmail.com> parents: 53072 diff changeset	20 getprotobyname() -- map a protocol name (e.g. 'tcp') to a number
14007 eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	21 ntohs(), ntohl() -- convert 16, 32 bit int from network to host byte order
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	22 htons(), htonl() -- convert 16, 32 bit int from host to network byte order
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	23 inet_aton() -- convert IP addr string (123.45.67.89) to 32-bit packed format
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	24 inet_ntoa() -- convert 32-bit packed format IP to string (123.45.67.89)
24293 640370f08e2a Add default timeout functionality. This adds setdefaulttimeout() and Guido van Rossum <guido@python.org> parents: 23844 diff changeset	25 socket.getdefaulttimeout() -- get the default timeout value
640370f08e2a Add default timeout functionality. This adds setdefaulttimeout() and Guido van Rossum <guido@python.org> parents: 23844 diff changeset	26 socket.setdefaulttimeout() -- set the default timeout value
58114 b0386fe650c7 Merged revisions 77263-77264 via svnmerge from Gregory P. Smith <greg@mad-scientist.com> parents: 54514 diff changeset	27 create_connection() -- connects to an address, with an optional timeout and
b0386fe650c7 Merged revisions 77263-77264 via svnmerge from Gregory P. Smith <greg@mad-scientist.com> parents: 54514 diff changeset	28 optional source address.
14007 eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	29
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	30 [*] not available on all platforms!
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	31
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	32 Special objects:
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	33
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	34 SocketType -- type object for socket objects
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	35 error -- exception raised for I/O errors
28818 57e61588571b Patch by Jp Calderone: Guido van Rossum <guido@python.org> parents: 28443 diff changeset	36 has_ipv6 -- boolean value indicating if IPv6 is supported
14007 eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	37
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	38 Integer constants:
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	39
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	40 AF_INET, AF_UNIX -- socket domains (first argument to socket() call)
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	41 SOCK_STREAM, SOCK_DGRAM, SOCK_RAW -- socket types (second argument)
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	42
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	43 Many other constants may be defined; these may be used in calls to
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	44 the setsockopt() and getsockopt() methods.
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	45 """
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	46
21971 fce7278d46b0 Repair so that importing socket doesn't blow up on platforms that lack Tim Peters <tim.peters@gmail.com> parents: 21962 diff changeset	47 import _socket
14007 eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	48 from _socket import *
21971 fce7278d46b0 Repair so that importing socket doesn't blow up on platforms that lack Tim Peters <tim.peters@gmail.com> parents: 21962 diff changeset	49
41809 8e062e572ea4 Sockets facelift. APIs that could return binary data (e.g. aton() and Guido van Rossum <guido@python.org> parents: 41554 diff changeset	50 import os, sys, io
85481 038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	51 from enum import IntEnum
14007 eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	52
28890 39f4b97ce828 Extract the errno value to use from the errno module if possible. Fred Drake <fdrake@acm.org> parents: 28888 diff changeset	53 try:
58146 efbac7d3a368 Merged revisions 74426 via svnmerge from Gregory P. Smith <greg@mad-scientist.com> parents: 58114 diff changeset	54 import errno
84442 7769c4d72806 Issue #18200: Back out usage of ModuleNotFoundError (8d28d44f3a9a) Brett Cannon <brett@python.org> parents: 84114 diff changeset	55 except ImportError:
58146 efbac7d3a368 Merged revisions 74426 via svnmerge from Gregory P. Smith <greg@mad-scientist.com> parents: 58114 diff changeset	56 errno = None
efbac7d3a368 Merged revisions 74426 via svnmerge from Gregory P. Smith <greg@mad-scientist.com> parents: 58114 diff changeset	57 EBADF = getattr(errno, 'EBADF', 9)
64817 f3dcb314c3e3 Issue #9854: SocketIO objects now observe the RawIOBase interface in Antoine Pitrou <solipsis@pitrou.net> parents: 64764 diff changeset	58 EAGAIN = getattr(errno, 'EAGAIN', 11)
f3dcb314c3e3 Issue #9854: SocketIO objects now observe the RawIOBase interface in Antoine Pitrou <solipsis@pitrou.net> parents: 64764 diff changeset	59 EWOULDBLOCK = getattr(errno, 'EWOULDBLOCK', 11)
28890 39f4b97ce828 Extract the errno value to use from the errno module if possible. Fred Drake <fdrake@acm.org> parents: 28888 diff changeset	60
53072 7e978ca42930 Merged revisions 70980,71059,71225,71234,71241,71243,71249,71251,71255,71266,71299,71329,71397-71398,71486 via svnmerge from Benjamin Peterson <benjamin@python.org> parents: 50927 diff changeset	61 __all__ = ["getfqdn", "create_connection"]
16613 f68dbffff927 bunch more __all__ lists Skip Montanaro <skip@pobox.com> parents: 15872 diff changeset	62 __all__.extend(os._get_exports_list(_socket))
43095 4a07a288f5c4 Merged revisions 57620-57771 via svnmerge from Thomas Wouters <thomas@python.org> parents: 42974 diff changeset	63
85481 038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	64 # Set up the socket.AF_* socket.SOCK_* constants as members of IntEnums for
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	65 # nicer string representations.
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	66 # Note that _socket only knows about the integer values. The public interface
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	67 # in this module understands the enums and translates them back from integers
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	68 # where needed (e.g. .family property of a socket object).
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	69 AddressFamily = IntEnum('AddressFamily',
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	70 {name: value for name, value in globals().items()
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	71 if name.isupper() and name.startswith('AF_')})
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	72 globals().update(AddressFamily.__members__)
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	73
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	74 SocketType = IntEnum('SocketType',
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	75 {name: value for name, value in globals().items()
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	76 if name.isupper() and name.startswith('SOCK_')})
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	77 globals().update(SocketType.__members__)
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	78
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	79 def _intenum_converter(value, enum_klass):
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	80 """Convert a numeric family value to an IntEnum member.
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	81
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	82 If it's not a known member, return the numeric value itself.
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	83 """
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	84 try:
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	85 return enum_klass(value)
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	86 except ValueError:
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	87 return value
43095 4a07a288f5c4 Merged revisions 57620-57771 via svnmerge from Thomas Wouters <thomas@python.org> parents: 42974 diff changeset	88
4a07a288f5c4 Merged revisions 57620-57771 via svnmerge from Thomas Wouters <thomas@python.org> parents: 42974 diff changeset	89 _realsocket = socket
16613 f68dbffff927 bunch more __all__ lists Skip Montanaro <skip@pobox.com> parents: 15872 diff changeset	90
14007 eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	91 # WSA error codes
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	92 if sys.platform.lower().startswith("win"):
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	93 errorTab = {}
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	94 errorTab[10004] = "The operation was interrupted."
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	95 errorTab[10009] = "A bad file handle was passed."
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	96 errorTab[10013] = "Permission denied."
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	97 errorTab[10014] = "A fault occurred on the network??" # WSAEFAULT
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	98 errorTab[10022] = "An invalid operation was attempted."
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	99 errorTab[10035] = "The socket operation would block"
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	100 errorTab[10036] = "A blocking operation is already in progress."
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	101 errorTab[10048] = "The network address is in use."
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	102 errorTab[10054] = "The connection has been reset."
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	103 errorTab[10058] = "The network has been shut down."
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	104 errorTab[10060] = "The operation timed out."
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	105 errorTab[10061] = "Connection refused."
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	106 errorTab[10063] = "The name is too long."
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	107 errorTab[10064] = "The host is down."
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	108 errorTab[10065] = "The host is unreachable."
17071 b45ae8c467aa add errorTab to __all__ on win* Skip Montanaro <skip@pobox.com> parents: 16949 diff changeset	109 __all__.append("errorTab")
24663 b265e76bab88 Extend __all__ with the exports list of the _ssl module. Guido van Rossum <guido@python.org> parents: 24662 diff changeset	110
14007 eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	111
41809 8e062e572ea4 Sockets facelift. APIs that could return binary data (e.g. aton() and Guido van Rossum <guido@python.org> parents: 41554 diff changeset	112 class socket(_socket.socket):
8e062e572ea4 Sockets facelift. APIs that could return binary data (e.g. aton() and Guido van Rossum <guido@python.org> parents: 41554 diff changeset	113
8e062e572ea4 Sockets facelift. APIs that could return binary data (e.g. aton() and Guido van Rossum <guido@python.org> parents: 41554 diff changeset	114 """A subclass of _socket.socket adding the makefile() method."""
8e062e572ea4 Sockets facelift. APIs that could return binary data (e.g. aton() and Guido van Rossum <guido@python.org> parents: 41554 diff changeset	115
43851 9a1281391c46 Patch 1439 by Bill Janssen. I think this will work. Guido van Rossum <guido@python.org> parents: 43400 diff changeset	116 __slots__ = ["__weakref__", "_io_refs", "_closed"]
41809 8e062e572ea4 Sockets facelift. APIs that could return binary data (e.g. aton() and Guido van Rossum <guido@python.org> parents: 41554 diff changeset	117
42434 c35140559f87 Make sure socket.close() doesn't interfere with socket.makefile(). Jeremy Hylton <jeremy@alum.mit.edu> parents: 42301 diff changeset	118 def __init__(self, family=AF_INET, type=SOCK_STREAM, proto=0, fileno=None):
85481 038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	119 # For user code address family and type values are IntEnum members, but
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	120 # for the underlying _socket.socket they're just integers. The
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	121 # constructor of _socket.socket converts the given argument to an
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	122 # integer automatically.
43881 70cfc7b504c2 This is roughly socket2.diff from issue 1378, with a few changes applied Guido van Rossum <guido@python.org> parents: 43851 diff changeset	123 _socket.socket.__init__(self, family, type, proto, fileno)
43851 9a1281391c46 Patch 1439 by Bill Janssen. I think this will work. Guido van Rossum <guido@python.org> parents: 43400 diff changeset	124 self._io_refs = 0
9a1281391c46 Patch 1439 by Bill Janssen. I think this will work. Guido van Rossum <guido@python.org> parents: 43400 diff changeset	125 self._closed = False
42434 c35140559f87 Make sure socket.close() doesn't interfere with socket.makefile(). Jeremy Hylton <jeremy@alum.mit.edu> parents: 42301 diff changeset	126
64574 caf0b4b0569e Fix issue 9794: adds context manager protocol to socket.socket so that socket.create_connection() can be used with the 'with' statement. Giampaolo Rodolà <g.rodola@gmail.com> parents: 64534 diff changeset	127 def __enter__(self):
caf0b4b0569e Fix issue 9794: adds context manager protocol to socket.socket so that socket.create_connection() can be used with the 'with' statement. Giampaolo Rodolà <g.rodola@gmail.com> parents: 64534 diff changeset	128 return self
caf0b4b0569e Fix issue 9794: adds context manager protocol to socket.socket so that socket.create_connection() can be used with the 'with' statement. Giampaolo Rodolà <g.rodola@gmail.com> parents: 64534 diff changeset	129
caf0b4b0569e Fix issue 9794: adds context manager protocol to socket.socket so that socket.create_connection() can be used with the 'with' statement. Giampaolo Rodolà <g.rodola@gmail.com> parents: 64534 diff changeset	130 def __exit__(self, *args):
caf0b4b0569e Fix issue 9794: adds context manager protocol to socket.socket so that socket.create_connection() can be used with the 'with' statement. Giampaolo Rodolà <g.rodola@gmail.com> parents: 64534 diff changeset	131 if not self._closed:
caf0b4b0569e Fix issue 9794: adds context manager protocol to socket.socket so that socket.create_connection() can be used with the 'with' statement. Giampaolo Rodolà <g.rodola@gmail.com> parents: 64534 diff changeset	132 self.close()
caf0b4b0569e Fix issue 9794: adds context manager protocol to socket.socket so that socket.create_connection() can be used with the 'with' statement. Giampaolo Rodolà <g.rodola@gmail.com> parents: 64534 diff changeset	133
41809 8e062e572ea4 Sockets facelift. APIs that could return binary data (e.g. aton() and Guido van Rossum <guido@python.org> parents: 41554 diff changeset	134 def __repr__(self):
83230 1410b7790de6 Fix issue #17675: make socket repr() provide local and remote addresses (if any). Giampaolo Rodola' <g.rodola@gmail.com> parents: 81039 diff changeset	135 """Wrap __repr__() to reveal the real class name and socket
1410b7790de6 Fix issue #17675: make socket repr() provide local and remote addresses (if any). Giampaolo Rodola' <g.rodola@gmail.com> parents: 81039 diff changeset	136 address(es).
1410b7790de6 Fix issue #17675: make socket repr() provide local and remote addresses (if any). Giampaolo Rodola' <g.rodola@gmail.com> parents: 81039 diff changeset	137 """
1410b7790de6 Fix issue #17675: make socket repr() provide local and remote addresses (if any). Giampaolo Rodola' <g.rodola@gmail.com> parents: 81039 diff changeset	138 closed = getattr(self, '_closed', False)
1410b7790de6 Fix issue #17675: make socket repr() provide local and remote addresses (if any). Giampaolo Rodola' <g.rodola@gmail.com> parents: 81039 diff changeset	139 s = "<%s.%s%s fd=%i, family=%i, type=%i, proto=%i" \
1410b7790de6 Fix issue #17675: make socket repr() provide local and remote addresses (if any). Giampaolo Rodola' <g.rodola@gmail.com> parents: 81039 diff changeset	140 % (self.__class__.__module__,
1410b7790de6 Fix issue #17675: make socket repr() provide local and remote addresses (if any). Giampaolo Rodola' <g.rodola@gmail.com> parents: 81039 diff changeset	141 self.__class__.__name__,
1410b7790de6 Fix issue #17675: make socket repr() provide local and remote addresses (if any). Giampaolo Rodola' <g.rodola@gmail.com> parents: 81039 diff changeset	142 " [closed]" if closed else "",
1410b7790de6 Fix issue #17675: make socket repr() provide local and remote addresses (if any). Giampaolo Rodola' <g.rodola@gmail.com> parents: 81039 diff changeset	143 self.fileno(),
1410b7790de6 Fix issue #17675: make socket repr() provide local and remote addresses (if any). Giampaolo Rodola' <g.rodola@gmail.com> parents: 81039 diff changeset	144 self.family,
1410b7790de6 Fix issue #17675: make socket repr() provide local and remote addresses (if any). Giampaolo Rodola' <g.rodola@gmail.com> parents: 81039 diff changeset	145 self.type,
1410b7790de6 Fix issue #17675: make socket repr() provide local and remote addresses (if any). Giampaolo Rodola' <g.rodola@gmail.com> parents: 81039 diff changeset	146 self.proto)
1410b7790de6 Fix issue #17675: make socket repr() provide local and remote addresses (if any). Giampaolo Rodola' <g.rodola@gmail.com> parents: 81039 diff changeset	147 if not closed:
1410b7790de6 Fix issue #17675: make socket repr() provide local and remote addresses (if any). Giampaolo Rodola' <g.rodola@gmail.com> parents: 81039 diff changeset	148 try:
1410b7790de6 Fix issue #17675: make socket repr() provide local and remote addresses (if any). Giampaolo Rodola' <g.rodola@gmail.com> parents: 81039 diff changeset	149 laddr = self.getsockname()
1410b7790de6 Fix issue #17675: make socket repr() provide local and remote addresses (if any). Giampaolo Rodola' <g.rodola@gmail.com> parents: 81039 diff changeset	150 if laddr:
1410b7790de6 Fix issue #17675: make socket repr() provide local and remote addresses (if any). Giampaolo Rodola' <g.rodola@gmail.com> parents: 81039 diff changeset	151 s += ", laddr=%s" % str(laddr)
1410b7790de6 Fix issue #17675: make socket repr() provide local and remote addresses (if any). Giampaolo Rodola' <g.rodola@gmail.com> parents: 81039 diff changeset	152 except error:
1410b7790de6 Fix issue #17675: make socket repr() provide local and remote addresses (if any). Giampaolo Rodola' <g.rodola@gmail.com> parents: 81039 diff changeset	153 pass
1410b7790de6 Fix issue #17675: make socket repr() provide local and remote addresses (if any). Giampaolo Rodola' <g.rodola@gmail.com> parents: 81039 diff changeset	154 try:
1410b7790de6 Fix issue #17675: make socket repr() provide local and remote addresses (if any). Giampaolo Rodola' <g.rodola@gmail.com> parents: 81039 diff changeset	155 raddr = self.getpeername()
1410b7790de6 Fix issue #17675: make socket repr() provide local and remote addresses (if any). Giampaolo Rodola' <g.rodola@gmail.com> parents: 81039 diff changeset	156 if raddr:
1410b7790de6 Fix issue #17675: make socket repr() provide local and remote addresses (if any). Giampaolo Rodola' <g.rodola@gmail.com> parents: 81039 diff changeset	157 s += ", raddr=%s" % str(raddr)
1410b7790de6 Fix issue #17675: make socket repr() provide local and remote addresses (if any). Giampaolo Rodola' <g.rodola@gmail.com> parents: 81039 diff changeset	158 except error:
1410b7790de6 Fix issue #17675: make socket repr() provide local and remote addresses (if any). Giampaolo Rodola' <g.rodola@gmail.com> parents: 81039 diff changeset	159 pass
1410b7790de6 Fix issue #17675: make socket repr() provide local and remote addresses (if any). Giampaolo Rodola' <g.rodola@gmail.com> parents: 81039 diff changeset	160 s += '>'
41809 8e062e572ea4 Sockets facelift. APIs that could return binary data (e.g. aton() and Guido van Rossum <guido@python.org> parents: 41554 diff changeset	161 return s
8e062e572ea4 Sockets facelift. APIs that could return binary data (e.g. aton() and Guido van Rossum <guido@python.org> parents: 41554 diff changeset	162
68774 5e13e5e6df30 Issue #11127: Raise a TypeError when trying to pickle a socket object. Antoine Pitrou <solipsis@pitrou.net> parents: 68257 diff changeset	163 def __getstate__(self):
5e13e5e6df30 Issue #11127: Raise a TypeError when trying to pickle a socket object. Antoine Pitrou <solipsis@pitrou.net> parents: 68257 diff changeset	164 raise TypeError("Cannot serialize socket object")
5e13e5e6df30 Issue #11127: Raise a TypeError when trying to pickle a socket object. Antoine Pitrou <solipsis@pitrou.net> parents: 68257 diff changeset	165
43881 70cfc7b504c2 This is roughly socket2.diff from issue 1378, with a few changes applied Guido van Rossum <guido@python.org> parents: 43851 diff changeset	166 def dup(self):
70cfc7b504c2 This is roughly socket2.diff from issue 1378, with a few changes applied Guido van Rossum <guido@python.org> parents: 43851 diff changeset	167 """dup() -> socket object
70cfc7b504c2 This is roughly socket2.diff from issue 1378, with a few changes applied Guido van Rossum <guido@python.org> parents: 43851 diff changeset	168
85420 ef889c3d5dc6 Issue #18571: Implementation of the PEP 446: file descriptors and file handles Victor Stinner <victor.stinner@gmail.com> parents: 84442 diff changeset	169 Duplicate the socket. Return a new socket object connected to the same
ef889c3d5dc6 Issue #18571: Implementation of the PEP 446: file descriptors and file handles Victor Stinner <victor.stinner@gmail.com> parents: 84442 diff changeset	170 system resource. The new socket is non-inheritable.
43881 70cfc7b504c2 This is roughly socket2.diff from issue 1378, with a few changes applied Guido van Rossum <guido@python.org> parents: 43851 diff changeset	171 """
70cfc7b504c2 This is roughly socket2.diff from issue 1378, with a few changes applied Guido van Rossum <guido@python.org> parents: 43851 diff changeset	172 fd = dup(self.fileno())
70cfc7b504c2 This is roughly socket2.diff from issue 1378, with a few changes applied Guido van Rossum <guido@python.org> parents: 43851 diff changeset	173 sock = self.__class__(self.family, self.type, self.proto, fileno=fd)
70cfc7b504c2 This is roughly socket2.diff from issue 1378, with a few changes applied Guido van Rossum <guido@python.org> parents: 43851 diff changeset	174 sock.settimeout(self.gettimeout())
70cfc7b504c2 This is roughly socket2.diff from issue 1378, with a few changes applied Guido van Rossum <guido@python.org> parents: 43851 diff changeset	175 return sock
70cfc7b504c2 This is roughly socket2.diff from issue 1378, with a few changes applied Guido van Rossum <guido@python.org> parents: 43851 diff changeset	176
41809 8e062e572ea4 Sockets facelift. APIs that could return binary data (e.g. aton() and Guido van Rossum <guido@python.org> parents: 41554 diff changeset	177 def accept(self):
43881 70cfc7b504c2 This is roughly socket2.diff from issue 1378, with a few changes applied Guido van Rossum <guido@python.org> parents: 43851 diff changeset	178 """accept() -> (socket object, address info)
70cfc7b504c2 This is roughly socket2.diff from issue 1378, with a few changes applied Guido van Rossum <guido@python.org> parents: 43851 diff changeset	179
70cfc7b504c2 This is roughly socket2.diff from issue 1378, with a few changes applied Guido van Rossum <guido@python.org> parents: 43851 diff changeset	180 Wait for an incoming connection. Return a new socket
70cfc7b504c2 This is roughly socket2.diff from issue 1378, with a few changes applied Guido van Rossum <guido@python.org> parents: 43851 diff changeset	181 representing the connection, and the address of the client.
70cfc7b504c2 This is roughly socket2.diff from issue 1378, with a few changes applied Guido van Rossum <guido@python.org> parents: 43851 diff changeset	182 For IP sockets, the address info is a pair (hostaddr, port).
70cfc7b504c2 This is roughly socket2.diff from issue 1378, with a few changes applied Guido van Rossum <guido@python.org> parents: 43851 diff changeset	183 """
70cfc7b504c2 This is roughly socket2.diff from issue 1378, with a few changes applied Guido van Rossum <guido@python.org> parents: 43851 diff changeset	184 fd, addr = self._accept()
67382 ed0259230611 Issue #7995: When calling accept() on a socket with a timeout, the returned Antoine Pitrou <solipsis@pitrou.net> parents: 67344 diff changeset	185 sock = socket(self.family, self.type, self.proto, fileno=fd)
ed0259230611 Issue #7995: When calling accept() on a socket with a timeout, the returned Antoine Pitrou <solipsis@pitrou.net> parents: 67344 diff changeset	186 # Issue #7995: if no default timeout is set and the listening
ed0259230611 Issue #7995: When calling accept() on a socket with a timeout, the returned Antoine Pitrou <solipsis@pitrou.net> parents: 67344 diff changeset	187 # socket had a (non-zero) timeout, force the new socket in blocking
ed0259230611 Issue #7995: When calling accept() on a socket with a timeout, the returned Antoine Pitrou <solipsis@pitrou.net> parents: 67344 diff changeset	188 # mode to override platform-specific socket flags inheritance.
ed0259230611 Issue #7995: When calling accept() on a socket with a timeout, the returned Antoine Pitrou <solipsis@pitrou.net> parents: 67344 diff changeset	189 if getdefaulttimeout() is None and self.gettimeout():
ed0259230611 Issue #7995: When calling accept() on a socket with a timeout, the returned Antoine Pitrou <solipsis@pitrou.net> parents: 67344 diff changeset	190 sock.setblocking(True)
ed0259230611 Issue #7995: When calling accept() on a socket with a timeout, the returned Antoine Pitrou <solipsis@pitrou.net> parents: 67344 diff changeset	191 return sock, addr
41809 8e062e572ea4 Sockets facelift. APIs that could return binary data (e.g. aton() and Guido van Rossum <guido@python.org> parents: 41554 diff changeset	192
8e062e572ea4 Sockets facelift. APIs that could return binary data (e.g. aton() and Guido van Rossum <guido@python.org> parents: 41554 diff changeset	193 def makefile(self, mode="r", buffering=None, *,
65259 3619c1214007 Merged revisions 85420 via svnmerge from Antoine Pitrou <solipsis@pitrou.net> parents: 64766 diff changeset	194 encoding=None, errors=None, newline=None):
43881 70cfc7b504c2 This is roughly socket2.diff from issue 1378, with a few changes applied Guido van Rossum <guido@python.org> parents: 43851 diff changeset	195 """makefile(...) -> an I/O stream connected to the socket
41809 8e062e572ea4 Sockets facelift. APIs that could return binary data (e.g. aton() and Guido van Rossum <guido@python.org> parents: 41554 diff changeset	196
8e062e572ea4 Sockets facelift. APIs that could return binary data (e.g. aton() and Guido van Rossum <guido@python.org> parents: 41554 diff changeset	197 The arguments are as for io.open() after the filename,
8e062e572ea4 Sockets facelift. APIs that could return binary data (e.g. aton() and Guido van Rossum <guido@python.org> parents: 41554 diff changeset	198 except the only mode characters supported are 'r', 'w' and 'b'.
8e062e572ea4 Sockets facelift. APIs that could return binary data (e.g. aton() and Guido van Rossum <guido@python.org> parents: 41554 diff changeset	199 The semantics are similar too. (XXX refactor to share code?)
8e062e572ea4 Sockets facelift. APIs that could return binary data (e.g. aton() and Guido van Rossum <guido@python.org> parents: 41554 diff changeset	200 """
8e062e572ea4 Sockets facelift. APIs that could return binary data (e.g. aton() and Guido van Rossum <guido@python.org> parents: 41554 diff changeset	201 for c in mode:
8e062e572ea4 Sockets facelift. APIs that could return binary data (e.g. aton() and Guido van Rossum <guido@python.org> parents: 41554 diff changeset	202 if c not in {"r", "w", "b"}:
8e062e572ea4 Sockets facelift. APIs that could return binary data (e.g. aton() and Guido van Rossum <guido@python.org> parents: 41554 diff changeset	203 raise ValueError("invalid mode %r (only r, w, b allowed)")
8e062e572ea4 Sockets facelift. APIs that could return binary data (e.g. aton() and Guido van Rossum <guido@python.org> parents: 41554 diff changeset	204 writing = "w" in mode
8e062e572ea4 Sockets facelift. APIs that could return binary data (e.g. aton() and Guido van Rossum <guido@python.org> parents: 41554 diff changeset	205 reading = "r" in mode or not writing
8e062e572ea4 Sockets facelift. APIs that could return binary data (e.g. aton() and Guido van Rossum <guido@python.org> parents: 41554 diff changeset	206 assert reading or writing
8e062e572ea4 Sockets facelift. APIs that could return binary data (e.g. aton() and Guido van Rossum <guido@python.org> parents: 41554 diff changeset	207 binary = "b" in mode
8e062e572ea4 Sockets facelift. APIs that could return binary data (e.g. aton() and Guido van Rossum <guido@python.org> parents: 41554 diff changeset	208 rawmode = ""
8e062e572ea4 Sockets facelift. APIs that could return binary data (e.g. aton() and Guido van Rossum <guido@python.org> parents: 41554 diff changeset	209 if reading:
8e062e572ea4 Sockets facelift. APIs that could return binary data (e.g. aton() and Guido van Rossum <guido@python.org> parents: 41554 diff changeset	210 rawmode += "r"
8e062e572ea4 Sockets facelift. APIs that could return binary data (e.g. aton() and Guido van Rossum <guido@python.org> parents: 41554 diff changeset	211 if writing:
8e062e572ea4 Sockets facelift. APIs that could return binary data (e.g. aton() and Guido van Rossum <guido@python.org> parents: 41554 diff changeset	212 rawmode += "w"
43851 9a1281391c46 Patch 1439 by Bill Janssen. I think this will work. Guido van Rossum <guido@python.org> parents: 43400 diff changeset	213 raw = SocketIO(self, rawmode)
9a1281391c46 Patch 1439 by Bill Janssen. I think this will work. Guido van Rossum <guido@python.org> parents: 43400 diff changeset	214 self._io_refs += 1
41809 8e062e572ea4 Sockets facelift. APIs that could return binary data (e.g. aton() and Guido van Rossum <guido@python.org> parents: 41554 diff changeset	215 if buffering is None:
8e062e572ea4 Sockets facelift. APIs that could return binary data (e.g. aton() and Guido van Rossum <guido@python.org> parents: 41554 diff changeset	216 buffering = -1
8e062e572ea4 Sockets facelift. APIs that could return binary data (e.g. aton() and Guido van Rossum <guido@python.org> parents: 41554 diff changeset	217 if buffering < 0:
8e062e572ea4 Sockets facelift. APIs that could return binary data (e.g. aton() and Guido van Rossum <guido@python.org> parents: 41554 diff changeset	218 buffering = io.DEFAULT_BUFFER_SIZE
8e062e572ea4 Sockets facelift. APIs that could return binary data (e.g. aton() and Guido van Rossum <guido@python.org> parents: 41554 diff changeset	219 if buffering == 0:
8e062e572ea4 Sockets facelift. APIs that could return binary data (e.g. aton() and Guido van Rossum <guido@python.org> parents: 41554 diff changeset	220 if not binary:
8e062e572ea4 Sockets facelift. APIs that could return binary data (e.g. aton() and Guido van Rossum <guido@python.org> parents: 41554 diff changeset	221 raise ValueError("unbuffered streams must be binary")
8e062e572ea4 Sockets facelift. APIs that could return binary data (e.g. aton() and Guido van Rossum <guido@python.org> parents: 41554 diff changeset	222 return raw
8e062e572ea4 Sockets facelift. APIs that could return binary data (e.g. aton() and Guido van Rossum <guido@python.org> parents: 41554 diff changeset	223 if reading and writing:
8e062e572ea4 Sockets facelift. APIs that could return binary data (e.g. aton() and Guido van Rossum <guido@python.org> parents: 41554 diff changeset	224 buffer = io.BufferedRWPair(raw, raw, buffering)
8e062e572ea4 Sockets facelift. APIs that could return binary data (e.g. aton() and Guido van Rossum <guido@python.org> parents: 41554 diff changeset	225 elif reading:
8e062e572ea4 Sockets facelift. APIs that could return binary data (e.g. aton() and Guido van Rossum <guido@python.org> parents: 41554 diff changeset	226 buffer = io.BufferedReader(raw, buffering)
8e062e572ea4 Sockets facelift. APIs that could return binary data (e.g. aton() and Guido van Rossum <guido@python.org> parents: 41554 diff changeset	227 else:
8e062e572ea4 Sockets facelift. APIs that could return binary data (e.g. aton() and Guido van Rossum <guido@python.org> parents: 41554 diff changeset	228 assert writing
8e062e572ea4 Sockets facelift. APIs that could return binary data (e.g. aton() and Guido van Rossum <guido@python.org> parents: 41554 diff changeset	229 buffer = io.BufferedWriter(raw, buffering)
8e062e572ea4 Sockets facelift. APIs that could return binary data (e.g. aton() and Guido van Rossum <guido@python.org> parents: 41554 diff changeset	230 if binary:
8e062e572ea4 Sockets facelift. APIs that could return binary data (e.g. aton() and Guido van Rossum <guido@python.org> parents: 41554 diff changeset	231 return buffer
65259 3619c1214007 Merged revisions 85420 via svnmerge from Antoine Pitrou <solipsis@pitrou.net> parents: 64766 diff changeset	232 text = io.TextIOWrapper(buffer, encoding, errors, newline)
42301 f940e470e550 (1) SF patch# 1755214 by Amaury Forgeot d'Arc which makes some tests Guido van Rossum <guido@python.org> parents: 41809 diff changeset	233 text.mode = mode
41809 8e062e572ea4 Sockets facelift. APIs that could return binary data (e.g. aton() and Guido van Rossum <guido@python.org> parents: 41554 diff changeset	234 return text
8e062e572ea4 Sockets facelift. APIs that could return binary data (e.g. aton() and Guido van Rossum <guido@python.org> parents: 41554 diff changeset	235
43851 9a1281391c46 Patch 1439 by Bill Janssen. I think this will work. Guido van Rossum <guido@python.org> parents: 43400 diff changeset	236 def _decref_socketios(self):
9a1281391c46 Patch 1439 by Bill Janssen. I think this will work. Guido van Rossum <guido@python.org> parents: 43400 diff changeset	237 if self._io_refs > 0:
9a1281391c46 Patch 1439 by Bill Janssen. I think this will work. Guido van Rossum <guido@python.org> parents: 43400 diff changeset	238 self._io_refs -= 1
9a1281391c46 Patch 1439 by Bill Janssen. I think this will work. Guido van Rossum <guido@python.org> parents: 43400 diff changeset	239 if self._closed:
9a1281391c46 Patch 1439 by Bill Janssen. I think this will work. Guido van Rossum <guido@python.org> parents: 43400 diff changeset	240 self.close()
9a1281391c46 Patch 1439 by Bill Janssen. I think this will work. Guido van Rossum <guido@python.org> parents: 43400 diff changeset	241
64332 62930cb05ed8 Issue #808164: Fixed socket.close to avoid references to globals, to Daniel Stutzbach <daniel@stutzbachenterprises.com> parents: 62903 diff changeset	242 def _real_close(self, _ss=_socket.socket):
64333 03268bf9a256 reformat comment Benjamin Peterson <benjamin@python.org> parents: 64332 diff changeset	243 # This function should not reference any globals. See issue #808164.
64332 62930cb05ed8 Issue #808164: Fixed socket.close to avoid references to globals, to Daniel Stutzbach <daniel@stutzbachenterprises.com> parents: 62903 diff changeset	244 _ss.close(self)
44305 19f894ae864a update to fix leak in SSL code Bill Janssen <janssen@parc.com> parents: 43881 diff changeset	245
42434 c35140559f87 Make sure socket.close() doesn't interfere with socket.makefile(). Jeremy Hylton <jeremy@alum.mit.edu> parents: 42301 diff changeset	246 def close(self):
64333 03268bf9a256 reformat comment Benjamin Peterson <benjamin@python.org> parents: 64332 diff changeset	247 # This function should not reference any globals. See issue #808164.
43851 9a1281391c46 Patch 1439 by Bill Janssen. I think this will work. Guido van Rossum <guido@python.org> parents: 43400 diff changeset	248 self._closed = True
43881 70cfc7b504c2 This is roughly socket2.diff from issue 1378, with a few changes applied Guido van Rossum <guido@python.org> parents: 43851 diff changeset	249 if self._io_refs <= 0:
44305 19f894ae864a update to fix leak in SSL code Bill Janssen <janssen@parc.com> parents: 43881 diff changeset	250 self._real_close()
43881 70cfc7b504c2 This is roughly socket2.diff from issue 1378, with a few changes applied Guido van Rossum <guido@python.org> parents: 43851 diff changeset	251
76033 3a220feafa15 Issue #13872: socket.detach() now marks the socket closed (as mirrored in the socket repr()). Antoine Pitrou <solipsis@pitrou.net> parents: 68257 diff changeset	252 def detach(self):
3a220feafa15 Issue #13872: socket.detach() now marks the socket closed (as mirrored in the socket repr()). Antoine Pitrou <solipsis@pitrou.net> parents: 68257 diff changeset	253 """detach() -> file descriptor
3a220feafa15 Issue #13872: socket.detach() now marks the socket closed (as mirrored in the socket repr()). Antoine Pitrou <solipsis@pitrou.net> parents: 68257 diff changeset	254
3a220feafa15 Issue #13872: socket.detach() now marks the socket closed (as mirrored in the socket repr()). Antoine Pitrou <solipsis@pitrou.net> parents: 68257 diff changeset	255 Close the socket object without closing the underlying file descriptor.
3a220feafa15 Issue #13872: socket.detach() now marks the socket closed (as mirrored in the socket repr()). Antoine Pitrou <solipsis@pitrou.net> parents: 68257 diff changeset	256 The object cannot be used after this call, but the file descriptor
3a220feafa15 Issue #13872: socket.detach() now marks the socket closed (as mirrored in the socket repr()). Antoine Pitrou <solipsis@pitrou.net> parents: 68257 diff changeset	257 can be reused for other purposes. The file descriptor is returned.
3a220feafa15 Issue #13872: socket.detach() now marks the socket closed (as mirrored in the socket repr()). Antoine Pitrou <solipsis@pitrou.net> parents: 68257 diff changeset	258 """
3a220feafa15 Issue #13872: socket.detach() now marks the socket closed (as mirrored in the socket repr()). Antoine Pitrou <solipsis@pitrou.net> parents: 68257 diff changeset	259 self._closed = True
3a220feafa15 Issue #13872: socket.detach() now marks the socket closed (as mirrored in the socket repr()). Antoine Pitrou <solipsis@pitrou.net> parents: 68257 diff changeset	260 return super().detach()
3a220feafa15 Issue #13872: socket.detach() now marks the socket closed (as mirrored in the socket repr()). Antoine Pitrou <solipsis@pitrou.net> parents: 68257 diff changeset	261
85481 038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	262 @property
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	263 def family(self):
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	264 """Read-only access to the address family for this socket.
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	265 """
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	266 return _intenum_converter(super().family, AddressFamily)
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	267
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	268 @property
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	269 def type(self):
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	270 """Read-only access to the socket type.
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	271 """
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	272 return _intenum_converter(super().type, SocketType)
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	273
85420 ef889c3d5dc6 Issue #18571: Implementation of the PEP 446: file descriptors and file handles Victor Stinner <victor.stinner@gmail.com> parents: 84442 diff changeset	274 if os.name == 'nt':
ef889c3d5dc6 Issue #18571: Implementation of the PEP 446: file descriptors and file handles Victor Stinner <victor.stinner@gmail.com> parents: 84442 diff changeset	275 def get_inheritable(self):
ef889c3d5dc6 Issue #18571: Implementation of the PEP 446: file descriptors and file handles Victor Stinner <victor.stinner@gmail.com> parents: 84442 diff changeset	276 return os.get_handle_inheritable(self.fileno())
ef889c3d5dc6 Issue #18571: Implementation of the PEP 446: file descriptors and file handles Victor Stinner <victor.stinner@gmail.com> parents: 84442 diff changeset	277 def set_inheritable(self, inheritable):
ef889c3d5dc6 Issue #18571: Implementation of the PEP 446: file descriptors and file handles Victor Stinner <victor.stinner@gmail.com> parents: 84442 diff changeset	278 os.set_handle_inheritable(self.fileno(), inheritable)
ef889c3d5dc6 Issue #18571: Implementation of the PEP 446: file descriptors and file handles Victor Stinner <victor.stinner@gmail.com> parents: 84442 diff changeset	279 else:
ef889c3d5dc6 Issue #18571: Implementation of the PEP 446: file descriptors and file handles Victor Stinner <victor.stinner@gmail.com> parents: 84442 diff changeset	280 def get_inheritable(self):
ef889c3d5dc6 Issue #18571: Implementation of the PEP 446: file descriptors and file handles Victor Stinner <victor.stinner@gmail.com> parents: 84442 diff changeset	281 return os.get_inheritable(self.fileno())
ef889c3d5dc6 Issue #18571: Implementation of the PEP 446: file descriptors and file handles Victor Stinner <victor.stinner@gmail.com> parents: 84442 diff changeset	282 def set_inheritable(self, inheritable):
ef889c3d5dc6 Issue #18571: Implementation of the PEP 446: file descriptors and file handles Victor Stinner <victor.stinner@gmail.com> parents: 84442 diff changeset	283 os.set_inheritable(self.fileno(), inheritable)
ef889c3d5dc6 Issue #18571: Implementation of the PEP 446: file descriptors and file handles Victor Stinner <victor.stinner@gmail.com> parents: 84442 diff changeset	284 get_inheritable.__doc__ = "Get the inheritable flag of the socket"
ef889c3d5dc6 Issue #18571: Implementation of the PEP 446: file descriptors and file handles Victor Stinner <victor.stinner@gmail.com> parents: 84442 diff changeset	285 set_inheritable.__doc__ = "Set the inheritable flag of the socket"
ef889c3d5dc6 Issue #18571: Implementation of the PEP 446: file descriptors and file handles Victor Stinner <victor.stinner@gmail.com> parents: 84442 diff changeset	286
43881 70cfc7b504c2 This is roughly socket2.diff from issue 1378, with a few changes applied Guido van Rossum <guido@python.org> parents: 43851 diff changeset	287 def fromfd(fd, family, type, proto=0):
70cfc7b504c2 This is roughly socket2.diff from issue 1378, with a few changes applied Guido van Rossum <guido@python.org> parents: 43851 diff changeset	288 """ fromfd(fd, family, type[, proto]) -> socket object
70cfc7b504c2 This is roughly socket2.diff from issue 1378, with a few changes applied Guido van Rossum <guido@python.org> parents: 43851 diff changeset	289
70cfc7b504c2 This is roughly socket2.diff from issue 1378, with a few changes applied Guido van Rossum <guido@python.org> parents: 43851 diff changeset	290 Create a socket object from a duplicate of the given file
70cfc7b504c2 This is roughly socket2.diff from issue 1378, with a few changes applied Guido van Rossum <guido@python.org> parents: 43851 diff changeset	291 descriptor. The remaining arguments are the same as for socket().
70cfc7b504c2 This is roughly socket2.diff from issue 1378, with a few changes applied Guido van Rossum <guido@python.org> parents: 43851 diff changeset	292 """
70cfc7b504c2 This is roughly socket2.diff from issue 1378, with a few changes applied Guido van Rossum <guido@python.org> parents: 43851 diff changeset	293 nfd = dup(fd)
70cfc7b504c2 This is roughly socket2.diff from issue 1378, with a few changes applied Guido van Rossum <guido@python.org> parents: 43851 diff changeset	294 return socket(family, type, proto, nfd)
42434 c35140559f87 Make sure socket.close() doesn't interfere with socket.makefile(). Jeremy Hylton <jeremy@alum.mit.edu> parents: 42301 diff changeset	295
76150 51b4bddd0e92 Issue #14310: inter-process socket duplication for windows Kristján Valur Jónsson <kristjan@ccpgames.com> parents: 76034 diff changeset	296 if hasattr(_socket.socket, "share"):
51b4bddd0e92 Issue #14310: inter-process socket duplication for windows Kristján Valur Jónsson <kristjan@ccpgames.com> parents: 76034 diff changeset	297 def fromshare(info):
51b4bddd0e92 Issue #14310: inter-process socket duplication for windows Kristján Valur Jónsson <kristjan@ccpgames.com> parents: 76034 diff changeset	298 """ fromshare(info) -> socket object
51b4bddd0e92 Issue #14310: inter-process socket duplication for windows Kristján Valur Jónsson <kristjan@ccpgames.com> parents: 76034 diff changeset	299
51b4bddd0e92 Issue #14310: inter-process socket duplication for windows Kristján Valur Jónsson <kristjan@ccpgames.com> parents: 76034 diff changeset	300 Create a socket object from a the bytes object returned by
51b4bddd0e92 Issue #14310: inter-process socket duplication for windows Kristján Valur Jónsson <kristjan@ccpgames.com> parents: 76034 diff changeset	301 socket.share(pid).
51b4bddd0e92 Issue #14310: inter-process socket duplication for windows Kristján Valur Jónsson <kristjan@ccpgames.com> parents: 76034 diff changeset	302 """
51b4bddd0e92 Issue #14310: inter-process socket duplication for windows Kristján Valur Jónsson <kristjan@ccpgames.com> parents: 76034 diff changeset	303 return socket(0, 0, 0, info)
42434 c35140559f87 Make sure socket.close() doesn't interfere with socket.makefile(). Jeremy Hylton <jeremy@alum.mit.edu> parents: 42301 diff changeset	304
64747 534853ba8cd3 Issue #1552: socket.socketpair() now returns regular socket.socket Antoine Pitrou <solipsis@pitrou.net> parents: 64574 diff changeset	305 if hasattr(_socket, "socketpair"):
534853ba8cd3 Issue #1552: socket.socketpair() now returns regular socket.socket Antoine Pitrou <solipsis@pitrou.net> parents: 64574 diff changeset	306
534853ba8cd3 Issue #1552: socket.socketpair() now returns regular socket.socket Antoine Pitrou <solipsis@pitrou.net> parents: 64574 diff changeset	307 def socketpair(family=None, type=SOCK_STREAM, proto=0):
534853ba8cd3 Issue #1552: socket.socketpair() now returns regular socket.socket Antoine Pitrou <solipsis@pitrou.net> parents: 64574 diff changeset	308 """socketpair([family[, type[, proto]]]) -> (socket object, socket object)
534853ba8cd3 Issue #1552: socket.socketpair() now returns regular socket.socket Antoine Pitrou <solipsis@pitrou.net> parents: 64574 diff changeset	309
534853ba8cd3 Issue #1552: socket.socketpair() now returns regular socket.socket Antoine Pitrou <solipsis@pitrou.net> parents: 64574 diff changeset	310 Create a pair of socket objects from the sockets returned by the platform
534853ba8cd3 Issue #1552: socket.socketpair() now returns regular socket.socket Antoine Pitrou <solipsis@pitrou.net> parents: 64574 diff changeset	311 socketpair() function.
534853ba8cd3 Issue #1552: socket.socketpair() now returns regular socket.socket Antoine Pitrou <solipsis@pitrou.net> parents: 64574 diff changeset	312 The arguments are the same as for socket() except the default family is
534853ba8cd3 Issue #1552: socket.socketpair() now returns regular socket.socket Antoine Pitrou <solipsis@pitrou.net> parents: 64574 diff changeset	313 AF_UNIX if defined on the platform; otherwise, the default is AF_INET.
534853ba8cd3 Issue #1552: socket.socketpair() now returns regular socket.socket Antoine Pitrou <solipsis@pitrou.net> parents: 64574 diff changeset	314 """
534853ba8cd3 Issue #1552: socket.socketpair() now returns regular socket.socket Antoine Pitrou <solipsis@pitrou.net> parents: 64574 diff changeset	315 if family is None:
534853ba8cd3 Issue #1552: socket.socketpair() now returns regular socket.socket Antoine Pitrou <solipsis@pitrou.net> parents: 64574 diff changeset	316 try:
534853ba8cd3 Issue #1552: socket.socketpair() now returns regular socket.socket Antoine Pitrou <solipsis@pitrou.net> parents: 64574 diff changeset	317 family = AF_UNIX
534853ba8cd3 Issue #1552: socket.socketpair() now returns regular socket.socket Antoine Pitrou <solipsis@pitrou.net> parents: 64574 diff changeset	318 except NameError:
534853ba8cd3 Issue #1552: socket.socketpair() now returns regular socket.socket Antoine Pitrou <solipsis@pitrou.net> parents: 64574 diff changeset	319 family = AF_INET
534853ba8cd3 Issue #1552: socket.socketpair() now returns regular socket.socket Antoine Pitrou <solipsis@pitrou.net> parents: 64574 diff changeset	320 a, b = _socket.socketpair(family, type, proto)
534853ba8cd3 Issue #1552: socket.socketpair() now returns regular socket.socket Antoine Pitrou <solipsis@pitrou.net> parents: 64574 diff changeset	321 a = socket(family, type, proto, a.detach())
534853ba8cd3 Issue #1552: socket.socketpair() now returns regular socket.socket Antoine Pitrou <solipsis@pitrou.net> parents: 64574 diff changeset	322 b = socket(family, type, proto, b.detach())
534853ba8cd3 Issue #1552: socket.socketpair() now returns regular socket.socket Antoine Pitrou <solipsis@pitrou.net> parents: 64574 diff changeset	323 return a, b
534853ba8cd3 Issue #1552: socket.socketpair() now returns regular socket.socket Antoine Pitrou <solipsis@pitrou.net> parents: 64574 diff changeset	324
534853ba8cd3 Issue #1552: socket.socketpair() now returns regular socket.socket Antoine Pitrou <solipsis@pitrou.net> parents: 64574 diff changeset	325
64817 f3dcb314c3e3 Issue #9854: SocketIO objects now observe the RawIOBase interface in Antoine Pitrou <solipsis@pitrou.net> parents: 64764 diff changeset	326 _blocking_errnos = { EAGAIN, EWOULDBLOCK }
f3dcb314c3e3 Issue #9854: SocketIO objects now observe the RawIOBase interface in Antoine Pitrou <solipsis@pitrou.net> parents: 64764 diff changeset	327
42434 c35140559f87 Make sure socket.close() doesn't interfere with socket.makefile(). Jeremy Hylton <jeremy@alum.mit.edu> parents: 42301 diff changeset	328 class SocketIO(io.RawIOBase):
c35140559f87 Make sure socket.close() doesn't interfere with socket.makefile(). Jeremy Hylton <jeremy@alum.mit.edu> parents: 42301 diff changeset	329
c35140559f87 Make sure socket.close() doesn't interfere with socket.makefile(). Jeremy Hylton <jeremy@alum.mit.edu> parents: 42301 diff changeset	330 """Raw I/O implementation for stream sockets.
c35140559f87 Make sure socket.close() doesn't interfere with socket.makefile(). Jeremy Hylton <jeremy@alum.mit.edu> parents: 42301 diff changeset	331
c35140559f87 Make sure socket.close() doesn't interfere with socket.makefile(). Jeremy Hylton <jeremy@alum.mit.edu> parents: 42301 diff changeset	332 This class supports the makefile() method on sockets. It provides
c35140559f87 Make sure socket.close() doesn't interfere with socket.makefile(). Jeremy Hylton <jeremy@alum.mit.edu> parents: 42301 diff changeset	333 the raw I/O interface on top of a socket object.
c35140559f87 Make sure socket.close() doesn't interfere with socket.makefile(). Jeremy Hylton <jeremy@alum.mit.edu> parents: 42301 diff changeset	334 """
c35140559f87 Make sure socket.close() doesn't interfere with socket.makefile(). Jeremy Hylton <jeremy@alum.mit.edu> parents: 42301 diff changeset	335
64766 a97d12e5465f Merged revisions 84825-84826,84830 via svnmerge from Antoine Pitrou <solipsis@pitrou.net> parents: 64536 diff changeset	336 # One might wonder why not let FileIO do the job instead. There are two
a97d12e5465f Merged revisions 84825-84826,84830 via svnmerge from Antoine Pitrou <solipsis@pitrou.net> parents: 64536 diff changeset	337 # main reasons why FileIO is not adapted:
a97d12e5465f Merged revisions 84825-84826,84830 via svnmerge from Antoine Pitrou <solipsis@pitrou.net> parents: 64536 diff changeset	338 # - it wouldn't work under Windows (where you can't used read() and
a97d12e5465f Merged revisions 84825-84826,84830 via svnmerge from Antoine Pitrou <solipsis@pitrou.net> parents: 64536 diff changeset	339 # write() on a socket handle)
a97d12e5465f Merged revisions 84825-84826,84830 via svnmerge from Antoine Pitrou <solipsis@pitrou.net> parents: 64536 diff changeset	340 # - it wouldn't work with socket timeouts (FileIO would ignore the
a97d12e5465f Merged revisions 84825-84826,84830 via svnmerge from Antoine Pitrou <solipsis@pitrou.net> parents: 64536 diff changeset	341 # timeout and consider the socket non-blocking)
a97d12e5465f Merged revisions 84825-84826,84830 via svnmerge from Antoine Pitrou <solipsis@pitrou.net> parents: 64536 diff changeset	342
42434 c35140559f87 Make sure socket.close() doesn't interfere with socket.makefile(). Jeremy Hylton <jeremy@alum.mit.edu> parents: 42301 diff changeset	343 # XXX More docs
c35140559f87 Make sure socket.close() doesn't interfere with socket.makefile(). Jeremy Hylton <jeremy@alum.mit.edu> parents: 42301 diff changeset	344
43851 9a1281391c46 Patch 1439 by Bill Janssen. I think this will work. Guido van Rossum <guido@python.org> parents: 43400 diff changeset	345 def __init__(self, sock, mode):
49800 6aef28ebbd6c make FileIO.mode always include 'b' Benjamin Peterson <benjamin@python.org> parents: 49782 diff changeset	346 if mode not in ("r", "w", "rw", "rb", "wb", "rwb"):
42904 cd235027e64c Changes to io.py and socket.py by Christian Heimes. Guido van Rossum <guido@python.org> parents: 42434 diff changeset	347 raise ValueError("invalid mode: %r" % mode)
42434 c35140559f87 Make sure socket.close() doesn't interfere with socket.makefile(). Jeremy Hylton <jeremy@alum.mit.edu> parents: 42301 diff changeset	348 io.RawIOBase.__init__(self)
c35140559f87 Make sure socket.close() doesn't interfere with socket.makefile(). Jeremy Hylton <jeremy@alum.mit.edu> parents: 42301 diff changeset	349 self._sock = sock
49800 6aef28ebbd6c make FileIO.mode always include 'b' Benjamin Peterson <benjamin@python.org> parents: 49782 diff changeset	350 if "b" not in mode:
6aef28ebbd6c make FileIO.mode always include 'b' Benjamin Peterson <benjamin@python.org> parents: 49782 diff changeset	351 mode += "b"
42434 c35140559f87 Make sure socket.close() doesn't interfere with socket.makefile(). Jeremy Hylton <jeremy@alum.mit.edu> parents: 42301 diff changeset	352 self._mode = mode
42904 cd235027e64c Changes to io.py and socket.py by Christian Heimes. Guido van Rossum <guido@python.org> parents: 42434 diff changeset	353 self._reading = "r" in mode
cd235027e64c Changes to io.py and socket.py by Christian Heimes. Guido van Rossum <guido@python.org> parents: 42434 diff changeset	354 self._writing = "w" in mode
68159 17d1c6cede7e Issue #7322: Trying to read from a socket's file-like object after a timeout Antoine Pitrou <solipsis@pitrou.net> parents: 67382 diff changeset	355 self._timeout_occurred = False
42434 c35140559f87 Make sure socket.close() doesn't interfere with socket.makefile(). Jeremy Hylton <jeremy@alum.mit.edu> parents: 42301 diff changeset	356
c35140559f87 Make sure socket.close() doesn't interfere with socket.makefile(). Jeremy Hylton <jeremy@alum.mit.edu> parents: 42301 diff changeset	357 def readinto(self, b):
64766 a97d12e5465f Merged revisions 84825-84826,84830 via svnmerge from Antoine Pitrou <solipsis@pitrou.net> parents: 64536 diff changeset	358 """Read up to len(b) bytes into the writable buffer b and return
a97d12e5465f Merged revisions 84825-84826,84830 via svnmerge from Antoine Pitrou <solipsis@pitrou.net> parents: 64536 diff changeset	359 the number of bytes read. If the socket is non-blocking and no bytes
a97d12e5465f Merged revisions 84825-84826,84830 via svnmerge from Antoine Pitrou <solipsis@pitrou.net> parents: 64536 diff changeset	360 are available, None is returned.
a97d12e5465f Merged revisions 84825-84826,84830 via svnmerge from Antoine Pitrou <solipsis@pitrou.net> parents: 64536 diff changeset	361
a97d12e5465f Merged revisions 84825-84826,84830 via svnmerge from Antoine Pitrou <solipsis@pitrou.net> parents: 64536 diff changeset	362 If b is non-empty, a 0 return value indicates that the connection
a97d12e5465f Merged revisions 84825-84826,84830 via svnmerge from Antoine Pitrou <solipsis@pitrou.net> parents: 64536 diff changeset	363 was shutdown at the other end.
a97d12e5465f Merged revisions 84825-84826,84830 via svnmerge from Antoine Pitrou <solipsis@pitrou.net> parents: 64536 diff changeset	364 """
42904 cd235027e64c Changes to io.py and socket.py by Christian Heimes. Guido van Rossum <guido@python.org> parents: 42434 diff changeset	365 self._checkClosed()
cd235027e64c Changes to io.py and socket.py by Christian Heimes. Guido van Rossum <guido@python.org> parents: 42434 diff changeset	366 self._checkReadable()
68159 17d1c6cede7e Issue #7322: Trying to read from a socket's file-like object after a timeout Antoine Pitrou <solipsis@pitrou.net> parents: 67382 diff changeset	367 if self._timeout_occurred:
81039 7d69d04522e3 Replace IOError with OSError (#16715) Andrew Svetlov <andrew.svetlov@gmail.com> parents: 79027 diff changeset	368 raise OSError("cannot read from timed out object")
58146 efbac7d3a368 Merged revisions 74426 via svnmerge from Gregory P. Smith <greg@mad-scientist.com> parents: 58114 diff changeset	369 while True:
efbac7d3a368 Merged revisions 74426 via svnmerge from Gregory P. Smith <greg@mad-scientist.com> parents: 58114 diff changeset	370 try:
efbac7d3a368 Merged revisions 74426 via svnmerge from Gregory P. Smith <greg@mad-scientist.com> parents: 58114 diff changeset	371 return self._sock.recv_into(b)
68159 17d1c6cede7e Issue #7322: Trying to read from a socket's file-like object after a timeout Antoine Pitrou <solipsis@pitrou.net> parents: 67382 diff changeset	372 except timeout:
17d1c6cede7e Issue #7322: Trying to read from a socket's file-like object after a timeout Antoine Pitrou <solipsis@pitrou.net> parents: 67382 diff changeset	373 self._timeout_occurred = True
17d1c6cede7e Issue #7322: Trying to read from a socket's file-like object after a timeout Antoine Pitrou <solipsis@pitrou.net> parents: 67382 diff changeset	374 raise
73085 90f81045613a Use InterruptedError instead of checking for EINTR Antoine Pitrou <solipsis@pitrou.net> parents: 68774 diff changeset	375 except InterruptedError:
90f81045613a Use InterruptedError instead of checking for EINTR Antoine Pitrou <solipsis@pitrou.net> parents: 68774 diff changeset	376 continue
58146 efbac7d3a368 Merged revisions 74426 via svnmerge from Gregory P. Smith <greg@mad-scientist.com> parents: 58114 diff changeset	377 except error as e:
73085 90f81045613a Use InterruptedError instead of checking for EINTR Antoine Pitrou <solipsis@pitrou.net> parents: 68774 diff changeset	378 if e.args[0] in _blocking_errnos:
64817 f3dcb314c3e3 Issue #9854: SocketIO objects now observe the RawIOBase interface in Antoine Pitrou <solipsis@pitrou.net> parents: 64764 diff changeset	379 return None
58146 efbac7d3a368 Merged revisions 74426 via svnmerge from Gregory P. Smith <greg@mad-scientist.com> parents: 58114 diff changeset	380 raise
42434 c35140559f87 Make sure socket.close() doesn't interfere with socket.makefile(). Jeremy Hylton <jeremy@alum.mit.edu> parents: 42301 diff changeset	381
c35140559f87 Make sure socket.close() doesn't interfere with socket.makefile(). Jeremy Hylton <jeremy@alum.mit.edu> parents: 42301 diff changeset	382 def write(self, b):
64766 a97d12e5465f Merged revisions 84825-84826,84830 via svnmerge from Antoine Pitrou <solipsis@pitrou.net> parents: 64536 diff changeset	383 """Write the given bytes or bytearray object b to the socket
a97d12e5465f Merged revisions 84825-84826,84830 via svnmerge from Antoine Pitrou <solipsis@pitrou.net> parents: 64536 diff changeset	384 and return the number of bytes written. This can be less than
a97d12e5465f Merged revisions 84825-84826,84830 via svnmerge from Antoine Pitrou <solipsis@pitrou.net> parents: 64536 diff changeset	385 len(b) if not all data could be written. If the socket is
a97d12e5465f Merged revisions 84825-84826,84830 via svnmerge from Antoine Pitrou <solipsis@pitrou.net> parents: 64536 diff changeset	386 non-blocking and no bytes could be written None is returned.
a97d12e5465f Merged revisions 84825-84826,84830 via svnmerge from Antoine Pitrou <solipsis@pitrou.net> parents: 64536 diff changeset	387 """
42904 cd235027e64c Changes to io.py and socket.py by Christian Heimes. Guido van Rossum <guido@python.org> parents: 42434 diff changeset	388 self._checkClosed()
cd235027e64c Changes to io.py and socket.py by Christian Heimes. Guido van Rossum <guido@python.org> parents: 42434 diff changeset	389 self._checkWritable()
64817 f3dcb314c3e3 Issue #9854: SocketIO objects now observe the RawIOBase interface in Antoine Pitrou <solipsis@pitrou.net> parents: 64764 diff changeset	390 try:
f3dcb314c3e3 Issue #9854: SocketIO objects now observe the RawIOBase interface in Antoine Pitrou <solipsis@pitrou.net> parents: 64764 diff changeset	391 return self._sock.send(b)
f3dcb314c3e3 Issue #9854: SocketIO objects now observe the RawIOBase interface in Antoine Pitrou <solipsis@pitrou.net> parents: 64764 diff changeset	392 except error as e:
f3dcb314c3e3 Issue #9854: SocketIO objects now observe the RawIOBase interface in Antoine Pitrou <solipsis@pitrou.net> parents: 64764 diff changeset	393 # XXX what about EINTR?
f3dcb314c3e3 Issue #9854: SocketIO objects now observe the RawIOBase interface in Antoine Pitrou <solipsis@pitrou.net> parents: 64764 diff changeset	394 if e.args[0] in _blocking_errnos:
f3dcb314c3e3 Issue #9854: SocketIO objects now observe the RawIOBase interface in Antoine Pitrou <solipsis@pitrou.net> parents: 64764 diff changeset	395 return None
f3dcb314c3e3 Issue #9854: SocketIO objects now observe the RawIOBase interface in Antoine Pitrou <solipsis@pitrou.net> parents: 64764 diff changeset	396 raise
42434 c35140559f87 Make sure socket.close() doesn't interfere with socket.makefile(). Jeremy Hylton <jeremy@alum.mit.edu> parents: 42301 diff changeset	397
c35140559f87 Make sure socket.close() doesn't interfere with socket.makefile(). Jeremy Hylton <jeremy@alum.mit.edu> parents: 42301 diff changeset	398 def readable(self):
64766 a97d12e5465f Merged revisions 84825-84826,84830 via svnmerge from Antoine Pitrou <solipsis@pitrou.net> parents: 64536 diff changeset	399 """True if the SocketIO is open for reading.
a97d12e5465f Merged revisions 84825-84826,84830 via svnmerge from Antoine Pitrou <solipsis@pitrou.net> parents: 64536 diff changeset	400 """
79026 fad797916266 Issue #15842: the SocketIO.{readable,writable,seekable} methods now raise ValueError when the file-like object is closed. Antoine Pitrou <solipsis@pitrou.net> parents: 76033 diff changeset	401 if self.closed:
fad797916266 Issue #15842: the SocketIO.{readable,writable,seekable} methods now raise ValueError when the file-like object is closed. Antoine Pitrou <solipsis@pitrou.net> parents: 76033 diff changeset	402 raise ValueError("I/O operation on closed socket.")
fad797916266 Issue #15842: the SocketIO.{readable,writable,seekable} methods now raise ValueError when the file-like object is closed. Antoine Pitrou <solipsis@pitrou.net> parents: 76033 diff changeset	403 return self._reading
42434 c35140559f87 Make sure socket.close() doesn't interfere with socket.makefile(). Jeremy Hylton <jeremy@alum.mit.edu> parents: 42301 diff changeset	404
c35140559f87 Make sure socket.close() doesn't interfere with socket.makefile(). Jeremy Hylton <jeremy@alum.mit.edu> parents: 42301 diff changeset	405 def writable(self):
64766 a97d12e5465f Merged revisions 84825-84826,84830 via svnmerge from Antoine Pitrou <solipsis@pitrou.net> parents: 64536 diff changeset	406 """True if the SocketIO is open for writing.
a97d12e5465f Merged revisions 84825-84826,84830 via svnmerge from Antoine Pitrou <solipsis@pitrou.net> parents: 64536 diff changeset	407 """
79026 fad797916266 Issue #15842: the SocketIO.{readable,writable,seekable} methods now raise ValueError when the file-like object is closed. Antoine Pitrou <solipsis@pitrou.net> parents: 76033 diff changeset	408 if self.closed:
fad797916266 Issue #15842: the SocketIO.{readable,writable,seekable} methods now raise ValueError when the file-like object is closed. Antoine Pitrou <solipsis@pitrou.net> parents: 76033 diff changeset	409 raise ValueError("I/O operation on closed socket.")
fad797916266 Issue #15842: the SocketIO.{readable,writable,seekable} methods now raise ValueError when the file-like object is closed. Antoine Pitrou <solipsis@pitrou.net> parents: 76033 diff changeset	410 return self._writing
fad797916266 Issue #15842: the SocketIO.{readable,writable,seekable} methods now raise ValueError when the file-like object is closed. Antoine Pitrou <solipsis@pitrou.net> parents: 76033 diff changeset	411
fad797916266 Issue #15842: the SocketIO.{readable,writable,seekable} methods now raise ValueError when the file-like object is closed. Antoine Pitrou <solipsis@pitrou.net> parents: 76033 diff changeset	412 def seekable(self):
fad797916266 Issue #15842: the SocketIO.{readable,writable,seekable} methods now raise ValueError when the file-like object is closed. Antoine Pitrou <solipsis@pitrou.net> parents: 76033 diff changeset	413 """True if the SocketIO is open for seeking.
fad797916266 Issue #15842: the SocketIO.{readable,writable,seekable} methods now raise ValueError when the file-like object is closed. Antoine Pitrou <solipsis@pitrou.net> parents: 76033 diff changeset	414 """
fad797916266 Issue #15842: the SocketIO.{readable,writable,seekable} methods now raise ValueError when the file-like object is closed. Antoine Pitrou <solipsis@pitrou.net> parents: 76033 diff changeset	415 if self.closed:
fad797916266 Issue #15842: the SocketIO.{readable,writable,seekable} methods now raise ValueError when the file-like object is closed. Antoine Pitrou <solipsis@pitrou.net> parents: 76033 diff changeset	416 raise ValueError("I/O operation on closed socket.")
fad797916266 Issue #15842: the SocketIO.{readable,writable,seekable} methods now raise ValueError when the file-like object is closed. Antoine Pitrou <solipsis@pitrou.net> parents: 76033 diff changeset	417 return super().seekable()
42434 c35140559f87 Make sure socket.close() doesn't interfere with socket.makefile(). Jeremy Hylton <jeremy@alum.mit.edu> parents: 42301 diff changeset	418
c35140559f87 Make sure socket.close() doesn't interfere with socket.makefile(). Jeremy Hylton <jeremy@alum.mit.edu> parents: 42301 diff changeset	419 def fileno(self):
64766 a97d12e5465f Merged revisions 84825-84826,84830 via svnmerge from Antoine Pitrou <solipsis@pitrou.net> parents: 64536 diff changeset	420 """Return the file descriptor of the underlying socket.
a97d12e5465f Merged revisions 84825-84826,84830 via svnmerge from Antoine Pitrou <solipsis@pitrou.net> parents: 64536 diff changeset	421 """
50927 5c3bf31d04fd Backport r68539, Fixes issue #3826 and #4791: Gregory P. Smith <greg@mad-scientist.com> parents: 49800 diff changeset	422 self._checkClosed()
42434 c35140559f87 Make sure socket.close() doesn't interfere with socket.makefile(). Jeremy Hylton <jeremy@alum.mit.edu> parents: 42301 diff changeset	423 return self._sock.fileno()
c35140559f87 Make sure socket.close() doesn't interfere with socket.makefile(). Jeremy Hylton <jeremy@alum.mit.edu> parents: 42301 diff changeset	424
49782 5ffd67df8c9f Follow-up of r67300: correct a failure in socket.makefile(). Amaury Forgeot d'Arc <amauryfa@gmail.com> parents: 47559 diff changeset	425 @property
5ffd67df8c9f Follow-up of r67300: correct a failure in socket.makefile(). Amaury Forgeot d'Arc <amauryfa@gmail.com> parents: 47559 diff changeset	426 def name(self):
67344 f4a808f5a66d Issue #10819: SocketIO.name property returns -1 when its closed, instead of Victor Stinner <victor.stinner@haypocalc.com> parents: 65707 diff changeset	427 if not self.closed:
f4a808f5a66d Issue #10819: SocketIO.name property returns -1 when its closed, instead of Victor Stinner <victor.stinner@haypocalc.com> parents: 65707 diff changeset	428 return self.fileno()
f4a808f5a66d Issue #10819: SocketIO.name property returns -1 when its closed, instead of Victor Stinner <victor.stinner@haypocalc.com> parents: 65707 diff changeset	429 else:
f4a808f5a66d Issue #10819: SocketIO.name property returns -1 when its closed, instead of Victor Stinner <victor.stinner@haypocalc.com> parents: 65707 diff changeset	430 return -1
49782 5ffd67df8c9f Follow-up of r67300: correct a failure in socket.makefile(). Amaury Forgeot d'Arc <amauryfa@gmail.com> parents: 47559 diff changeset	431
5ffd67df8c9f Follow-up of r67300: correct a failure in socket.makefile(). Amaury Forgeot d'Arc <amauryfa@gmail.com> parents: 47559 diff changeset	432 @property
5ffd67df8c9f Follow-up of r67300: correct a failure in socket.makefile(). Amaury Forgeot d'Arc <amauryfa@gmail.com> parents: 47559 diff changeset	433 def mode(self):
5ffd67df8c9f Follow-up of r67300: correct a failure in socket.makefile(). Amaury Forgeot d'Arc <amauryfa@gmail.com> parents: 47559 diff changeset	434 return self._mode
5ffd67df8c9f Follow-up of r67300: correct a failure in socket.makefile(). Amaury Forgeot d'Arc <amauryfa@gmail.com> parents: 47559 diff changeset	435
42434 c35140559f87 Make sure socket.close() doesn't interfere with socket.makefile(). Jeremy Hylton <jeremy@alum.mit.edu> parents: 42301 diff changeset	436 def close(self):
64766 a97d12e5465f Merged revisions 84825-84826,84830 via svnmerge from Antoine Pitrou <solipsis@pitrou.net> parents: 64536 diff changeset	437 """Close the SocketIO object. This doesn't close the underlying
a97d12e5465f Merged revisions 84825-84826,84830 via svnmerge from Antoine Pitrou <solipsis@pitrou.net> parents: 64536 diff changeset	438 socket, except if all references to it have disappeared.
a97d12e5465f Merged revisions 84825-84826,84830 via svnmerge from Antoine Pitrou <solipsis@pitrou.net> parents: 64536 diff changeset	439 """
42434 c35140559f87 Make sure socket.close() doesn't interfere with socket.makefile(). Jeremy Hylton <jeremy@alum.mit.edu> parents: 42301 diff changeset	440 if self.closed:
c35140559f87 Make sure socket.close() doesn't interfere with socket.makefile(). Jeremy Hylton <jeremy@alum.mit.edu> parents: 42301 diff changeset	441 return
c35140559f87 Make sure socket.close() doesn't interfere with socket.makefile(). Jeremy Hylton <jeremy@alum.mit.edu> parents: 42301 diff changeset	442 io.RawIOBase.close(self)
50927 5c3bf31d04fd Backport r68539, Fixes issue #3826 and #4791: Gregory P. Smith <greg@mad-scientist.com> parents: 49800 diff changeset	443 self._sock._decref_socketios()
5c3bf31d04fd Backport r68539, Fixes issue #3826 and #4791: Gregory P. Smith <greg@mad-scientist.com> parents: 49800 diff changeset	444 self._sock = None
42434 c35140559f87 Make sure socket.close() doesn't interfere with socket.makefile(). Jeremy Hylton <jeremy@alum.mit.edu> parents: 42301 diff changeset	445
14007 eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	446
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	447 def getfqdn(name=''):
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	448 """Get fully qualified domain name from name.
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	449
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	450 An empty argument is interpreted as meaning the local host.
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	451
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	452 First the hostname returned by gethostbyaddr() is checked, then
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	453 possibly existing aliases. In case no FQDN is available, hostname
34733 e83309d43a82 Fix test for socket.getfqdn() to also include the name returned by Brett Cannon <bcannon@gmail.com> parents: 33063 diff changeset	454 from gethostname() is returned.
14007 eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	455 """
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	456 name = name.strip()
14014 3d68d5bccd40 updated occurences of fqdn algorithm (closes patch #101197) Peter Schneider-Kamp <nowonder@nowonder.de> parents: 14007 diff changeset	457 if not name or name == '0.0.0.0':
14007 eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	458 name = gethostname()
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	459 try:
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	460 hostname, aliases, ipaddrs = gethostbyaddr(name)
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	461 except error:
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	462 pass
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	463 else:
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	464 aliases.insert(0, hostname)
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	465 for name in aliases:
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	466 if '.' in name:
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	467 break
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	468 else:
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	469 name = hostname
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	470 return name
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	471
eda09f824a9f Revise the wrapper structure for the socket module: Fred Drake <fdrake@acm.org> parents: diff changeset	472
47559 2925b568aacc Merged revisions 63562,63570,63728,63734,63784,63788,63802,63817,63827,63839,63887,63975,63998 via svnmerge from Georg Brandl <georg@python.org> parents: 44305 diff changeset	473 _GLOBAL_DEFAULT_TIMEOUT = object()
2925b568aacc Merged revisions 63562,63570,63728,63734,63784,63788,63802,63817,63827,63839,63887,63975,63998 via svnmerge from Georg Brandl <georg@python.org> parents: 44305 diff changeset	474
58114 b0386fe650c7 Merged revisions 77263-77264 via svnmerge from Gregory P. Smith <greg@mad-scientist.com> parents: 54514 diff changeset	475 def create_connection(address, timeout=_GLOBAL_DEFAULT_TIMEOUT,
b0386fe650c7 Merged revisions 77263-77264 via svnmerge from Gregory P. Smith <greg@mad-scientist.com> parents: 54514 diff changeset	476 source_address=None):
47559 2925b568aacc Merged revisions 63562,63570,63728,63734,63784,63788,63802,63817,63827,63839,63887,63975,63998 via svnmerge from Georg Brandl <georg@python.org> parents: 44305 diff changeset	477 """Connect to address and return the socket object.
41554 06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from Guido van Rossum <guido@python.org> parents: 41501 diff changeset	478
47559 2925b568aacc Merged revisions 63562,63570,63728,63734,63784,63788,63802,63817,63827,63839,63887,63975,63998 via svnmerge from Georg Brandl <georg@python.org> parents: 44305 diff changeset	479 Convenience function. Connect to address (a 2-tuple ``(host,
2925b568aacc Merged revisions 63562,63570,63728,63734,63784,63788,63802,63817,63827,63839,63887,63975,63998 via svnmerge from Georg Brandl <georg@python.org> parents: 44305 diff changeset	480 port)``) and return the socket object. Passing the optional
2925b568aacc Merged revisions 63562,63570,63728,63734,63784,63788,63802,63817,63827,63839,63887,63975,63998 via svnmerge from Georg Brandl <georg@python.org> parents: 44305 diff changeset	481 timeout parameter will set the timeout on the socket instance
2925b568aacc Merged revisions 63562,63570,63728,63734,63784,63788,63802,63817,63827,63839,63887,63975,63998 via svnmerge from Georg Brandl <georg@python.org> parents: 44305 diff changeset	482 before attempting to connect. If no timeout is supplied, the
2925b568aacc Merged revisions 63562,63570,63728,63734,63784,63788,63802,63817,63827,63839,63887,63975,63998 via svnmerge from Georg Brandl <georg@python.org> parents: 44305 diff changeset	483 global default timeout setting returned by :func:`getdefaulttimeout`
58114 b0386fe650c7 Merged revisions 77263-77264 via svnmerge from Gregory P. Smith <greg@mad-scientist.com> parents: 54514 diff changeset	484 is used. If source_address is set it must be a tuple of (host, port)
b0386fe650c7 Merged revisions 77263-77264 via svnmerge from Gregory P. Smith <greg@mad-scientist.com> parents: 54514 diff changeset	485 for the socket to bind as a source address before making the connection.
b0386fe650c7 Merged revisions 77263-77264 via svnmerge from Gregory P. Smith <greg@mad-scientist.com> parents: 54514 diff changeset	486 An host of '' or port 0 tells the OS to use the default.
41554 06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from Guido van Rossum <guido@python.org> parents: 41501 diff changeset	487 """
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from Guido van Rossum <guido@python.org> parents: 41501 diff changeset	488
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from Guido van Rossum <guido@python.org> parents: 41501 diff changeset	489 host, port = address
64536 2400f55ea312 Merged revisions 84597-84599 via svnmerge from Antoine Pitrou <solipsis@pitrou.net> parents: 54514 diff changeset	490 err = None
41554 06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from Guido van Rossum <guido@python.org> parents: 41501 diff changeset	491 for res in getaddrinfo(host, port, 0, SOCK_STREAM):
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from Guido van Rossum <guido@python.org> parents: 41501 diff changeset	492 af, socktype, proto, canonname, sa = res
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from Guido van Rossum <guido@python.org> parents: 41501 diff changeset	493 sock = None
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from Guido van Rossum <guido@python.org> parents: 41501 diff changeset	494 try:
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from Guido van Rossum <guido@python.org> parents: 41501 diff changeset	495 sock = socket(af, socktype, proto)
47559 2925b568aacc Merged revisions 63562,63570,63728,63734,63784,63788,63802,63817,63827,63839,63887,63975,63998 via svnmerge from Georg Brandl <georg@python.org> parents: 44305 diff changeset	496 if timeout is not _GLOBAL_DEFAULT_TIMEOUT:
41554 06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from Guido van Rossum <guido@python.org> parents: 41501 diff changeset	497 sock.settimeout(timeout)
58114 b0386fe650c7 Merged revisions 77263-77264 via svnmerge from Gregory P. Smith <greg@mad-scientist.com> parents: 54514 diff changeset	498 if source_address:
b0386fe650c7 Merged revisions 77263-77264 via svnmerge from Gregory P. Smith <greg@mad-scientist.com> parents: 54514 diff changeset	499 sock.bind(source_address)
41554 06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from Guido van Rossum <guido@python.org> parents: 41501 diff changeset	500 sock.connect(sa)
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from Guido van Rossum <guido@python.org> parents: 41501 diff changeset	501 return sock
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from Guido van Rossum <guido@python.org> parents: 41501 diff changeset	502
64536 2400f55ea312 Merged revisions 84597-84599 via svnmerge from Antoine Pitrou <solipsis@pitrou.net> parents: 54514 diff changeset	503 except error as _:
2400f55ea312 Merged revisions 84597-84599 via svnmerge from Antoine Pitrou <solipsis@pitrou.net> parents: 54514 diff changeset	504 err = _
41554 06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from Guido van Rossum <guido@python.org> parents: 41501 diff changeset	505 if sock is not None:
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from Guido van Rossum <guido@python.org> parents: 41501 diff changeset	506 sock.close()
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from Guido van Rossum <guido@python.org> parents: 41501 diff changeset	507
64536 2400f55ea312 Merged revisions 84597-84599 via svnmerge from Antoine Pitrou <solipsis@pitrou.net> parents: 54514 diff changeset	508 if err is not None:
2400f55ea312 Merged revisions 84597-84599 via svnmerge from Antoine Pitrou <solipsis@pitrou.net> parents: 54514 diff changeset	509 raise err
2400f55ea312 Merged revisions 84597-84599 via svnmerge from Antoine Pitrou <solipsis@pitrou.net> parents: 54514 diff changeset	510 else:
2400f55ea312 Merged revisions 84597-84599 via svnmerge from Antoine Pitrou <solipsis@pitrou.net> parents: 54514 diff changeset	511 raise error("getaddrinfo returns an empty list")
85481 038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	512
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	513 def getaddrinfo(host, port, family=0, type=0, proto=0, flags=0):
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	514 """Resolve host and port into list of address info entries.
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	515
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	516 Translate the host/port argument into a sequence of 5-tuples that contain
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	517 all the necessary arguments for creating a socket connected to that service.
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	518 host is a domain name, a string representation of an IPv4/v6 address or
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	519 None. port is a string service name such as 'http', a numeric port number or
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	520 None. By passing None as the value of host and port, you can pass NULL to
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	521 the underlying C API.
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	522
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	523 The family, type and proto arguments can be optionally specified in order to
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	524 narrow the list of addresses returned. Passing zero as a value for each of
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	525 these arguments selects the full range of results.
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	526 """
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	527 # We override this function since we want to translate the numeric family
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	528 # and socket type values to enum constants.
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	529 addrlist = []
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	530 for res in _socket.getaddrinfo(host, port, family, type, proto, flags):
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	531 af, socktype, proto, canonname, sa = res
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	532 addrlist.append((_intenum_converter(af, AddressFamily),
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	533 _intenum_converter(socktype, SocketType),
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	534 proto, canonname, sa))
038543d34166 Switch the AF_* and SOCK_* constants in the socket module to IntEnum. Eli Bendersky <eliben@gmail.com> parents: 85420 diff changeset	535 return addrlist

Mercurial > cpython-lru_cache-weakref

annotate Lib/socket.py @ 86127:a3d09c19bb93