[socks] Refine exception model for better error handling
authorYen Chi Hsuan <yan12125@gmail.com>
Sun, 4 Dec 2016 16:31:02 +0000 (00:31 +0800)
committerYen Chi Hsuan <yan12125@gmail.com>
Sun, 4 Dec 2016 16:43:37 +0000 (00:43 +0800)
commit4bd7d9d4ae05319ebf6eb2aeffce7bde4fa7b6cf
tree2e1a113e863207d1773d22f6098b0ed2e47de5e7
parent9b5288c92ae43436a5d48775bbe1ee537588625f
[socks] Refine exception model for better error handling

1. ProxyError now inherits from socket.error instead of IOError

The only functions socks.py overrides are connect and connect_ex. In
Python 2.x and Python <= 3.2, socket functions raises socket.error. In
newer Python versions, those functions raises OSError instead. The name
socket.error is preserved as an alias of OSError for backward
compability. To keep socks.py compatible with Python's standard library,
it should raise the same exception as raw sockets.

See PEP 3151 (https://www.python.org/dev/peps/pep-3151/) for more
information about the change in Python 3.3.

2. Raise EOFError instead of IOError when the socket receives less data
than it expects

There's no common convention, but both ftplib and telnetlib raises
EOFError for similar situations. socks.py follows them.

Closes #11355

In #11355, only Python 2 is affected. In Python 3, both socket.error and
IOError are alias of OSError, so AbstractHTTPHandler.do_open correctly
catches the error and thus InfoExtractor._is_valid_url works fine.
youtube_dl/socks.py