Name	Size	Mode	Actions
abc.cpython-34.pyc	7877	0644	editdlrm
abc.cpython-34.pyo	7827	0644	editdlrm
aifc.cpython-34.pyc	27912	0644	editdlrm
aifc.cpython-34.pyo	27912	0644	editdlrm
antigravity.cpython-34.pyc	847	0644	editdlrm
antigravity.cpython-34.pyo	847	0644	editdlrm
argparse.cpython-34.pyc	65874	0644	editdlrm
argparse.cpython-34.pyo	65715	0644	editdlrm
ast.cpython-34.pyc	12360	0644	editdlrm
ast.cpython-34.pyo	12360	0644	editdlrm
asynchat.cpython-34.pyc	8359	0644	editdlrm
asynchat.cpython-34.pyo	8359	0644	editdlrm
asyncore.cpython-34.pyc	17963	0644	editdlrm
asyncore.cpython-34.pyo	17963	0644	editdlrm
base64.cpython-34.pyc	18297	0644	editdlrm
base64.cpython-34.pyo	18099	0644	editdlrm
bdb.cpython-34.pyc	18694	0644	editdlrm
bdb.cpython-34.pyo	18694	0644	editdlrm
binhex.cpython-34.pyc	13541	0644	editdlrm
binhex.cpython-34.pyo	13541	0644	editdlrm
bisect.cpython-34.pyc	2858	0644	editdlrm
bisect.cpython-34.pyo	2858	0644	editdlrm
bz2.cpython-34.pyc	15156	0644	editdlrm
bz2.cpython-34.pyo	15156	0644	editdlrm
calendar.cpython-34.pyc	27567	0644	editdlrm
calendar.cpython-34.pyo	27567	0644	editdlrm
cgi.cpython-34.pyc	29827	0644	editdlrm
cgi.cpython-34.pyo	29827	0644	editdlrm
cgitb.cpython-34.pyc	11064	0644	editdlrm
cgitb.cpython-34.pyo	11064	0644	editdlrm
chunk.cpython-34.pyc	5270	0644	editdlrm
chunk.cpython-34.pyo	5270	0644	editdlrm
cmd.cpython-34.pyc	13456	0644	editdlrm
cmd.cpython-34.pyo	13456	0644	editdlrm
code.cpython-34.pyc	9702	0644	editdlrm
code.cpython-34.pyo	9702	0644	editdlrm
codecs.cpython-34.pyc	35132	0644	editdlrm
codecs.cpython-34.pyo	35132	0644	editdlrm
codeop.cpython-34.pyc	6466	0644	editdlrm
codeop.cpython-34.pyo	6466	0644	editdlrm
colorsys.cpython-34.pyc	3659	0644	editdlrm
colorsys.cpython-34.pyo	3659	0644	editdlrm
compileall.cpython-34.pyc	7378	0644	editdlrm
compileall.cpython-34.pyo	7378	0644	editdlrm
configparser.cpython-34.pyc	44882	0644	editdlrm
configparser.cpython-34.pyo	44882	0644	editdlrm
contextlib.cpython-34.pyc	10370	0644	editdlrm
contextlib.cpython-34.pyo	10370	0644	editdlrm
copy.cpython-34.pyc	8061	0644	editdlrm
copy.cpython-34.pyo	7975	0644	editdlrm
copyreg.cpython-34.pyc	4607	0644	editdlrm
copyreg.cpython-34.pyo	4566	0644	editdlrm
cProfile.cpython-34.pyc	4622	0644	editdlrm
cProfile.cpython-34.pyo	4622	0644	editdlrm
crypt.cpython-34.pyc	2437	0644	editdlrm
crypt.cpython-34.pyo	2437	0644	editdlrm
csv.cpython-34.pyc	12997	0644	editdlrm
csv.cpython-34.pyo	12997	0644	editdlrm
datetime.cpython-34.pyc	56264	0644	editdlrm
datetime.cpython-34.pyo	54296	0644	editdlrm
decimal.cpython-34.pyc	172526	0644	editdlrm
decimal.cpython-34.pyo	172526	0644	editdlrm
difflib.cpython-34.pyc	60515	0644	editdlrm
difflib.cpython-34.pyo	60467	0644	editdlrm
dis.cpython-34.pyc	14587	0644	editdlrm
dis.cpython-34.pyo	14587	0644	editdlrm
doctest.cpython-34.pyc	80110	0644	editdlrm
doctest.cpython-34.pyo	79837	0644	editdlrm
dummy_threading.cpython-34.pyc	1214	0644	editdlrm
dummy_threading.cpython-34.pyo	1214	0644	editdlrm
enum.cpython-34.pyc	16339	0644	editdlrm
enum.cpython-34.pyo	16339	0644	editdlrm
filecmp.cpython-34.pyc	9120	0644	editdlrm
filecmp.cpython-34.pyo	9120	0644	editdlrm
fileinput.cpython-34.pyc	14297	0644	editdlrm
fileinput.cpython-34.pyo	14297	0644	editdlrm
fnmatch.cpython-34.pyc	3146	0644	editdlrm
fnmatch.cpython-34.pyo	3146	0644	editdlrm
formatter.cpython-34.pyc	18916	0644	editdlrm
formatter.cpython-34.pyo	18916	0644	editdlrm
fractions.cpython-34.pyc	19270	0644	editdlrm
fractions.cpython-34.pyo	19270	0644	editdlrm
ftplib.cpython-34.pyc	33322	0644	editdlrm
ftplib.cpython-34.pyo	33322	0644	editdlrm
functools.cpython-34.pyc	23614	0644	editdlrm
functools.cpython-34.pyo	23614	0644	editdlrm
genericpath.cpython-34.pyc	3493	0644	editdlrm
genericpath.cpython-34.pyo	3493	0644	editdlrm
getopt.cpython-34.pyc	6733	0644	editdlrm
getopt.cpython-34.pyo	6691	0644	editdlrm
getpass.cpython-34.pyc	4624	0644	editdlrm
getpass.cpython-34.pyo	4624	0644	editdlrm
gettext.cpython-34.pyc	15174	0644	editdlrm
gettext.cpython-34.pyo	15174	0644	editdlrm
glob.cpython-34.pyc	2880	0644	editdlrm
glob.cpython-34.pyo	2880	0644	editdlrm
gzip.cpython-34.pyc	19446	0644	editdlrm
gzip.cpython-34.pyo	19392	0644	editdlrm
hashlib.cpython-34.pyc	7944	0644	editdlrm
hashlib.cpython-34.pyo	7944	0644	editdlrm
heapq.cpython-34.pyc	13910	0644	editdlrm
heapq.cpython-34.pyo	13910	0644	editdlrm
hmac.cpython-34.pyc	5146	0644	editdlrm
hmac.cpython-34.pyo	5146	0644	editdlrm
imaplib.cpython-34.pyc	43479	0644	editdlrm
imaplib.cpython-34.pyo	40955	0644	editdlrm
imghdr.cpython-34.pyc	4143	0644	editdlrm
imghdr.cpython-34.pyo	4143	0644	editdlrm
imp.cpython-34.pyc	9867	0644	editdlrm
imp.cpython-34.pyo	9867	0644	editdlrm
inspect.cpython-34.pyc	76327	0644	editdlrm
inspect.cpython-34.pyo	76006	0644	editdlrm
io.cpython-34.pyc	3458	0644	editdlrm
io.cpython-34.pyo	3458	0644	editdlrm
ipaddress.cpython-34.pyc	62984	0644	editdlrm
ipaddress.cpython-34.pyo	62984	0644	editdlrm
keyword.cpython-34.pyc	1946	0644	editdlrm
keyword.cpython-34.pyo	1946	0644	editdlrm
linecache.cpython-34.pyc	3112	0644	editdlrm
linecache.cpython-34.pyo	3112	0644	editdlrm
locale.cpython-34.pyc	37276	0644	editdlrm
locale.cpython-34.pyo	37276	0644	editdlrm
lzma.cpython-34.pyc	15917	0644	editdlrm
lzma.cpython-34.pyo	15917	0644	editdlrm
macpath.cpython-34.pyc	6006	0644	editdlrm
macpath.cpython-34.pyo	6006	0644	editdlrm
macurl2path.cpython-34.pyc	2102	0644	editdlrm
macurl2path.cpython-34.pyo	2102	0644	editdlrm
mailbox.cpython-34.pyc	70288	0644	editdlrm
mailbox.cpython-34.pyo	70189	0644	editdlrm
mailcap.cpython-34.pyc	6544	0644	editdlrm
mailcap.cpython-34.pyo	6544	0644	editdlrm
mimetypes.cpython-34.pyc	16807	0644	editdlrm
mimetypes.cpython-34.pyo	16807	0644	editdlrm
modulefinder.cpython-34.pyc	17376	0644	editdlrm
modulefinder.cpython-34.pyo	17297	0644	editdlrm
netrc.cpython-34.pyc	4277	0644	editdlrm
netrc.cpython-34.pyo	4277	0644	editdlrm
nntplib.cpython-34.pyc	36310	0644	editdlrm
nntplib.cpython-34.pyo	36310	0644	editdlrm
ntpath.cpython-34.pyc	13305	0644	editdlrm
ntpath.cpython-34.pyo	13305	0644	editdlrm
nturl2path.cpython-34.pyc	1716	0644	editdlrm
nturl2path.cpython-34.pyo	1716	0644	editdlrm
numbers.cpython-34.pyc	12667	0644	editdlrm
numbers.cpython-34.pyo	12667	0644	editdlrm
opcode.cpython-34.pyc	5174	0644	editdlrm
opcode.cpython-34.pyo	5174	0644	editdlrm
operator.cpython-34.pyc	12778	0644	editdlrm
operator.cpython-34.pyo	12778	0644	editdlrm
optparse.cpython-34.pyc	51537	0644	editdlrm
optparse.cpython-34.pyo	51460	0644	editdlrm
os.cpython-34.pyc	29599	0644	editdlrm
os.cpython-34.pyo	29599	0644	editdlrm
pathlib.cpython-34.pyc	40483	0644	editdlrm
pathlib.cpython-34.pyo	40483	0644	editdlrm
pdb.cpython-34.pyc	49472	0644	editdlrm
pdb.cpython-34.pyo	49406	0644	editdlrm
pickle.cpython-34.pyc	46984	0644	editdlrm
pickle.cpython-34.pyo	46838	0644	editdlrm
pickletools.cpython-34.pyc	70254	0644	editdlrm
pickletools.cpython-34.pyo	69167	0644	editdlrm
pipes.cpython-34.pyc	8431	0644	editdlrm
pipes.cpython-34.pyo	8431	0644	editdlrm
pkgutil.cpython-34.pyc	17600	0644	editdlrm
pkgutil.cpython-34.pyo	17600	0644	editdlrm
platform.cpython-34.pyc	31172	0644	editdlrm
platform.cpython-34.pyo	31172	0644	editdlrm
plistlib.cpython-34.pyc	30151	0644	editdlrm
plistlib.cpython-34.pyo	30068	0644	editdlrm
poplib.cpython-34.pyc	13754	0644	editdlrm
poplib.cpython-34.pyo	13754	0644	editdlrm
posixpath.cpython-34.pyc	9809	0644	editdlrm
posixpath.cpython-34.pyo	9809	0644	editdlrm
pprint.cpython-34.pyc	11460	0644	editdlrm
pprint.cpython-34.pyo	11295	0644	editdlrm
profile.cpython-34.pyc	15151	0644	editdlrm
profile.cpython-34.pyo	14898	0644	editdlrm
pstats.cpython-34.pyc	23675	0644	editdlrm
pstats.cpython-34.pyo	23675	0644	editdlrm
pty.cpython-34.pyc	4225	0644	editdlrm
pty.cpython-34.pyo	4225	0644	editdlrm
pyclbr.cpython-34.pyc	9192	0644	editdlrm
pyclbr.cpython-34.pyo	9192	0644	editdlrm
pydoc.cpython-34.pyc	90915	0644	editdlrm
pydoc.cpython-34.pyo	90854	0644	editdlrm
py_compile.cpython-34.pyc	6857	0644	editdlrm
py_compile.cpython-34.pyo	6857	0644	editdlrm
queue.cpython-34.pyc	9262	0644	editdlrm
queue.cpython-34.pyo	9262	0644	editdlrm
quopri.cpython-34.pyc	6446	0644	editdlrm
quopri.cpython-34.pyo	6236	0644	editdlrm
random.cpython-34.pyc	19059	0644	editdlrm
random.cpython-34.pyo	19059	0644	editdlrm
re.cpython-34.pyc	14550	0644	editdlrm
re.cpython-34.pyo	14550	0644	editdlrm
reprlib.cpython-34.pyc	5872	0644	editdlrm
reprlib.cpython-34.pyo	5872	0644	editdlrm
rlcompleter.cpython-34.pyc	5695	0644	editdlrm
rlcompleter.cpython-34.pyo	5695	0644	editdlrm
runpy.cpython-34.pyc	7753	0644	editdlrm
runpy.cpython-34.pyo	7753	0644	editdlrm
sched.cpython-34.pyc	6573	0644	editdlrm
sched.cpython-34.pyo	6573	0644	editdlrm
selectors.cpython-34.pyc	16744	0644	editdlrm
selectors.cpython-34.pyo	16744	0644	editdlrm
shelve.cpython-34.pyc	9955	0644	editdlrm
shelve.cpython-34.pyo	9955	0644	editdlrm
shlex.cpython-34.pyc	7518	0644	editdlrm
shlex.cpython-34.pyo	7518	0644	editdlrm
shutil.cpython-34.pyc	33015	0644	editdlrm
shutil.cpython-34.pyo	33015	0644	editdlrm
site.cpython-34.pyc	17971	0644	editdlrm
site.cpython-34.pyo	17971	0644	editdlrm
smtpd.cpython-34.pyc	25669	0644	editdlrm
smtpd.cpython-34.pyo	25669	0644	editdlrm
smtplib.cpython-34.pyc	33129	0644	editdlrm
smtplib.cpython-34.pyo	33055	0644	editdlrm
sndhdr.cpython-34.pyc	6769	0644	editdlrm
sndhdr.cpython-34.pyo	6769	0644	editdlrm
socket.cpython-34.pyc	18111	0644	editdlrm
socket.cpython-34.pyo	18061	0644	editdlrm
socketserver.cpython-34.pyc	23255	0644	editdlrm
socketserver.cpython-34.pyo	23255	0644	editdlrm
sre_compile.cpython-34.pyc	11935	0644	editdlrm
sre_compile.cpython-34.pyo	11778	0644	editdlrm
sre_constants.cpython-34.pyc	5581	0644	editdlrm
sre_constants.cpython-34.pyo	5581	0644	editdlrm
sre_parse.cpython-34.pyc	20238	0644	editdlrm
sre_parse.cpython-34.pyo	20238	0644	editdlrm
ssl.cpython-34.pyc	27608	0644	editdlrm
ssl.cpython-34.pyo	27608	0644	editdlrm
stat.cpython-34.pyc	3578	0644	editdlrm
stat.cpython-34.pyo	3578	0644	editdlrm
statistics.cpython-34.pyc	17158	0644	editdlrm
statistics.cpython-34.pyo	16856	0644	editdlrm
string.cpython-34.pyc	8376	0644	editdlrm
string.cpython-34.pyo	8376	0644	editdlrm
stringprep.cpython-34.pyc	13636	0644	editdlrm
stringprep.cpython-34.pyo	13573	0644	editdlrm
struct.cpython-34.pyc	347	0644	editdlrm
struct.cpython-34.pyo	347	0644	editdlrm
subprocess.cpython-34.pyc	43359	0644	editdlrm
subprocess.cpython-34.pyo	43246	0644	editdlrm
sunau.cpython-34.pyc	18309	0644	editdlrm
sunau.cpython-34.pyo	18309	0644	editdlrm
symbol.cpython-34.pyc	2662	0644	editdlrm
symbol.cpython-34.pyo	2662	0644	editdlrm
symtable.cpython-34.pyc	11305	0644	editdlrm
symtable.cpython-34.pyo	11183	0644	editdlrm
sysconfig.cpython-34.pyc	17287	0644	editdlrm
sysconfig.cpython-34.pyo	17287	0644	editdlrm
tabnanny.cpython-34.pyc	7749	0644	editdlrm
tabnanny.cpython-34.pyo	7749	0644	editdlrm
tarfile.cpython-34.pyc	68040	0644	editdlrm
tarfile.cpython-34.pyo	68040	0644	editdlrm
telnetlib.cpython-34.pyc	19394	0644	editdlrm
telnetlib.cpython-34.pyo	19394	0644	editdlrm
tempfile.cpython-34.pyc	21576	0644	editdlrm
tempfile.cpython-34.pyo	21576	0644	editdlrm
textwrap.cpython-34.pyc	13800	0644	editdlrm
textwrap.cpython-34.pyo	13714	0644	editdlrm
this.cpython-34.pyc	1316	0644	editdlrm
this.cpython-34.pyo	1316	0644	editdlrm
threading.cpython-34.pyc	38965	0644	editdlrm
threading.cpython-34.pyo	38252	0644	editdlrm
timeit.cpython-34.pyc	11062	0644	editdlrm
timeit.cpython-34.pyo	11062	0644	editdlrm
token.cpython-34.pyc	3615	0644	editdlrm
token.cpython-34.pyo	3615	0644	editdlrm
tokenize.cpython-34.pyc	19951	0644	editdlrm
tokenize.cpython-34.pyo	19901	0644	editdlrm
trace.cpython-34.pyc	24184	0644	editdlrm
trace.cpython-34.pyo	24127	0644	editdlrm
traceback.cpython-34.pyc	11091	0644	editdlrm
traceback.cpython-34.pyo	11091	0644	editdlrm
tracemalloc.cpython-34.pyc	17130	0644	editdlrm
tracemalloc.cpython-34.pyo	17130	0644	editdlrm
tty.cpython-34.pyc	1146	0644	editdlrm
tty.cpython-34.pyo	1146	0644	editdlrm
types.cpython-34.pyc	5560	0644	editdlrm
types.cpython-34.pyo	5560	0644	editdlrm
uu.cpython-34.pyc	4021	0644	editdlrm
uu.cpython-34.pyo	4021	0644	editdlrm
uuid.cpython-34.pyc	21864	0644	editdlrm
uuid.cpython-34.pyo	21802	0644	editdlrm
warnings.cpython-34.pyc	12268	0644	editdlrm
warnings.cpython-34.pyo	11536	0644	editdlrm
wave.cpython-34.pyc	19135	0644	editdlrm
wave.cpython-34.pyo	19074	0644	editdlrm
weakref.cpython-34.pyc	20345	0644	editdlrm
weakref.cpython-34.pyo	20308	0644	editdlrm
webbrowser.cpython-34.pyc	17132	0644	editdlrm
webbrowser.cpython-34.pyo	17093	0644	editdlrm
xdrlib.cpython-34.pyc	9002	0644	editdlrm
xdrlib.cpython-34.pyo	9002	0644	editdlrm
zipfile.cpython-34.pyc	45820	0644	editdlrm
zipfile.cpython-34.pyo	45771	0644	editdlrm
_bootlocale.cpython-34.pyc	1047	0644	editdlrm
_bootlocale.cpython-34.pyo	1016	0644	editdlrm
_collections_abc.cpython-34.pyc	23949	0644	editdlrm
_collections_abc.cpython-34.pyo	23949	0644	editdlrm
_compat_pickle.cpython-34.pyc	7501	0644	editdlrm
_compat_pickle.cpython-34.pyo	7427	0644	editdlrm
_dummy_thread.cpython-34.pyc	4825	0644	editdlrm
_dummy_thread.cpython-34.pyo	4825	0644	editdlrm
_markupbase.cpython-34.pyc	8932	0644	editdlrm
_markupbase.cpython-34.pyo	8745	0644	editdlrm
_osx_support.cpython-34.pyc	10630	0644	editdlrm
_osx_support.cpython-34.pyo	10630	0644	editdlrm
_pyio.cpython-34.pyc	64933	0644	editdlrm
_pyio.cpython-34.pyo	64907	0644	editdlrm
_sitebuiltins.cpython-34.pyc	3677	0644	editdlrm
_sitebuiltins.cpython-34.pyo	3677	0644	editdlrm
_strptime.cpython-34.pyc	15779	0644	editdlrm
_strptime.cpython-34.pyo	15779	0644	editdlrm
_sysconfigdata.cpython-34.pyc	22700	0644	editdlrm
_sysconfigdata.cpython-34.pyo	22700	0644	editdlrm
_threading_local.cpython-34.pyc	6946	0644	editdlrm
_threading_local.cpython-34.pyo	6946	0644	editdlrm
_weakrefset.cpython-34.pyc	8465	0644	editdlrm
_weakrefset.cpython-34.pyo	8465	0644	editdlrm
__future__.cpython-34.pyc	4168	0644	editdlrm
__future__.cpython-34.pyo	4168	0644	editdlrm
__phello__.foo.cpython-34.pyc	134	0644	editdlrm
__phello__.foo.cpython-34.pyo	134	0644	editdlrm

� �f4_�@sJdZd
Z
ddlZddlZddlZddlZyddlZWnek rl


ddlZYn
Xdddddd d ddd ddgZ e ed�r�e jddddg�

ndd�ZGdd�d�Z Gdd�de �ZGdd�de�ZGdd�d�ZGdd�d�ZGdd�dee�ZGdd�dee�ZGdd �d ee�ZGdd �d ee�Ze ed�rGd d�de�ZGd!d�de�ZGd"d�dee�ZGd#d�dee�ZnGd$d�d�ZGd%d�de�ZGd&d �d e�ZdS)'a�Generic socket server classes. This module tries to capture the various aspects of defining a server: For socket-based servers: - address family: - AF_INET{,6}: IP (Internet Protocol) sockets (default) - AF_UNIX: Unix domain sockets - others, e.g. AF_DECNET are conceivable (see - socket type: - SOCK_STREAM (reliable stream, e.g. TCP) - SOCK_DGRAM (datagrams, e.g. UDP) For request-based servers (including socket-based): - client address verification before further looking at the request (This is actually a hook for any processing that needs to look at the request before anything else, e.g. logging) - how to handle multiple requests: - synchronous (one request is handled at a time) - forking (each request is handled by a new process) - threading (each request is handled by a new thread) The classes in this module favor the server type that is simplest to write: a synchronous TCP/IP server. This is bad class design, but save some typing. (There's also the issue that a deep class hierarchy slows down method lookups.) There are five classes in an inheritance diagram, four of which represent synchronous servers of four types: +------------+ | BaseServer | +------------+ | v +-----------+ +------------------+ | TCPServer |------->| UnixStreamServer | +-----------+ +------------------+ | v +-----------+ +--------------------+ | UDPServer |------->| UnixDatagramServer | +-----------+ +--------------------+ Note that UnixDatagramServer derives from UDPServer, not from UnixStreamServer -- the only difference between an IP and a Unix stream server is the address family, which is simply repeated in both unix server classes. Forking and threading versions of each type of server can be created using the ForkingMixIn and ThreadingMixIn mix-in classes. For instance, a threading UDP server class is created as follows: class ThreadingUDPServer(ThreadingMixIn, UDPServer): pass The Mix-in class must come first, since it overrides a method defined in UDPServer! Setting the various member variables also changes the behavior of the underlying server mechanism. To implement a service, you must derive a class from BaseRequestHandler and redefine its handle() method. You can then run various versions of the service by combining one of the server classes with your request handler class. The request handler class must be different for datagram or stream services. This can be hidden by using the request handler subclasses StreamRequestHandler or DatagramRequestHandler. Of course, you still have to use your head! For instance, it makes no sense to use a forking server if the service contains state in memory that can be modified by requests (since the modifications in the child process would never reach the initial state kept in the parent process and passed to each child). In this case, you can use a threading server, but you will probably have to use locks to avoid two requests that come in nearly simultaneous to apply conflicting changes to the server state. On the other hand, if you are building e.g. an HTTP server, where all data is stored externally (e.g. in the file system), a synchronous class will essentially render the service "deaf" while one request is being handled -- which may be for a very long time if a client is slow to read all the data it has requested. Here a threading or forking server is appropriate. In some cases, it may be appropriate to process part of a request synchronously, but to finish processing in a forked child depending on the request data. This can be implemented by using a synchronous server and doing an explicit fork in the request handler class handle() method. Another approach to handling multiple simultaneous requests in an environment that supports neither threads nor fork (or where these are too expensive or inappropriate for the service) is to maintain an explicit table of partially finished requests and to use select() to decide which request to work on next (or whether to handle a new incoming request). This is particularly important for stream services where each client can potentially be connected for a long time (if threads or subprocesses cannot be used). Future work: - Standard classes for Sun RPC (which uses either UDP or TCP) - Standard mix-in classes to implement various authentication and encryption schemes - Standard framework for select-based multiplexing XXX Open problems: - What to do with out-of-band data? BaseServer: - split generic "request" functionality out into BaseServer class. Copyright (C) 2000 Luke Kenneth Casson Leighton example: read entries from a SQL database (requires overriding get_request() to return a table entry from the database). entry is processed by a RequestHandlerClass. z0.4�N� BaseServer� TCPServer� UDPServer�ForkingUDPServer�ForkingTCPServer�ThreadingUDPServer�ThreadingTCPServer�BaseRequestHandler�StreamRequestHandler�DatagramRequestHandler�ThreadingMixIn�ForkingMixIn�AF_UNIX�UnixStreamServer�UnixDatagramServer�ThreadingUnixStreamServer�ThreadingUnixDatagramServerc
GsYxRy||
�SWqtk rP
}
z|j
t
jkr>�nWYd
d
}~XqXqWd
S)z*restart a system call interrupted by EINTRN)�OSError�errnoZEINTR)�func�args�
e�r�1/opt/alt/python34/lib64/python3.4/socketserver.py�_eintr_retry�s




rc@s�eZ
dZd
ZdZdd�Zdd�Zddd �
Zd d�Zdd �Z dd�Z dd�Zdd�Zdd�Z dd�Zdd�Zdd�Zdd�Zdd�Zd d!�ZdS)"ra�Base class for server classes. Methods for the caller: - __init__(server_address, RequestHandlerClass) - serve_forever(poll_interval=0.5) - shutdown() - handle_request() # if you do not use serve_forever() - fileno() -> int # for select() Methods that may be overridden: - server_bind() - server_activate() - get_request() -> request, client_address - handle_timeout() - verify_request(request, client_address) - server_close() - process_request(request, client_address) - shutdown_request(request) - close_request(request) - service_actions() - handle_error() Methods for derived classes: - finish_request(request, client_address) Class variables that may be overridden by derived classes or instances: - timeout - address_family - socket_type - allow_reuse_address Instance variables: - RequestHandlerClass - socket NcCs.|
|_||_
tj�|_d
|_dS)z/Constructor. May be extended, do not override.FN)�server_address�RequestHandlerClass� threadingZEvent�_BaseServer__is_shut_down�_BaseServer__shutdown_request)�selfrrrrr�__init__�s


zBaseServer.__init__c


Csd
S)zSCalled by constructor to activate the server. May be overridden. Nr)
r rrr�server_activate�szBaseServer.server_activateg�?cCs�|jj
�
z^xW|jsittj|g
gg|
�\}}}||kr\|j�
n|j�
qWWd
d|_|jj�
Xd
S)z�Handle one request at a time until shutdown. Polls for shutdown every poll_interval seconds. Ignores self.timeout. If you need to do periodic tasks, do them in another thread. NF)r�clearrr�select�_handle_request_noblock�service_actions�set)r Z poll_interval�
r�
wrrrr� serve_forever�s





zBaseServer.serve_foreverc

Csd
|_|j
j�
dS)z�Stops the serve_forever loop. Blocks until the loop has finished. This must be called while serve_forever() is running in another thread, or it will deadlock. TN)rr�wait)
r rrr�shutdown�s
zBaseServer.shutdownc


Csd
S)z�Called by the serve_forever() loop. May be overridden by a subclass / Mixin to implement any code that needs to be run during the loop. Nr)
r rrrr&�szBaseServer.service_actionsc
Cs�|jj
�}
|
d
kr'|j}
n$|jd
k rKt|
|j�}
nttj|g
gg|
�}|ds�|j�
d
S|j�
d
S)zOHandle one request, possibly blocking. Respects self.timeout. Nr
)�socketZ gettimeout�timeout�minrr$�handle_timeoutr%)r r.Zfd_setsrrr�handle_request
s








zBaseServer.handle_requestc
Cs�y|j�\}
}Wnt
k r.


d
SYn
X|j|
|�r�y|j|
|�
Wq�


|j|
|�
|j|
�

Yq�Xnd
S)z�Handle one request, without blocking. I assume that select.select has returned that the socket is readable before this function was called, so there should be no risk of blocking in get_request(). N)�get_requestr�verify_request�process_request�handle_error�shutdown_request)r �request�client_addressrrrr%$
s








z"BaseServer._handle_request_noblockc


Csd
S)zcCalled if no new request arrives within self.timeout. Overridden by ForkingMixIn. Nr)
r rrrr06
szBaseServer.handle_timeoutc
Csd
S)znVerify the request. May be overridden. Return True if we should proceed with this request. Tr)r r7r8rrrr3=
szBaseServer.verify_requestcCs!|j|
|�
|j
|
�

d
S)zVCall finish_request. Overridden by ForkingMixIn and ThreadingMixIn. N)�finish_requestr6)r r7r8rrrr4E
s
zBaseServer.process_requestc


Csd
S)zDCalled to clean-up the server. May be overridden. Nr)
r rrr�server_closeN
szBaseServer.server_closecCs|j|
||�
d
S)z8Finish one request by instantiating RequestHandlerClass.N)
r)r r7r8rrrr9V
szBaseServer.finish_requestcCs|j|
�

d
S)z3Called to shutdown and close an individual request.N)
� close_request)r r7rrrr6Z
szBaseServer.shutdown_requestc
Csd
S)z)Called to clean up an individual request.Nr)r r7rrrr;^
szBaseServer.close_requestcCsPtd
d�

tddd�


t|�

ddl
}|j�
td
d�

dS)ztHandle an error gracefully. May be overridden. The default is to print a traceback and continue. �
-�(z4Exception happened during processing of request from�end�
r
N)�print� traceback� print_exc)r r7r8rArrrr5b
s




zBaseServer.handle_error)�__name__� __module__�__qualname__�__doc__r.r!r"r*r,r&r1r%r0r3r4r:r9r6r;r5rrrrr�s"+  c@s�eZ
dZd
ZejZejZdZ dZ ddd�
Zdd�Zd d �Z dd�Zd d�Zdd�Zdd�Zdd�ZdS)ra3Base class for various socket-based server classes. Defaults to synchronous IP stream (i.e., TCP). Methods for the caller: - __init__(server_address, RequestHandlerClass, bind_and_activate=True) - serve_forever(poll_interval=0.5) - shutdown() - handle_request() # if you don't use serve_forever() - fileno() -> int # for select() Methods that may be overridden: - server_bind() - server_activate() - get_request() -> request, client_address - handle_timeout() - verify_request(request, client_address) - process_request(request, client_address) - shutdown_request(request) - close_request(request) - handle_error() Methods for derived classes: - finish_request(request, client_address) Class variables that may be overridden by derived classes or instances: - timeout - address_family - socket_type - request_queue_size (only for stream sockets) - allow_reuse_address Instance variables: - server_address - RequestHandlerClass - socket �FTc Csktj
||
|�
tj|j|j�|_|rgy|j�
|j�
Wqg


|j�
�YqgXnd
S)z/Constructor. May be extended, do not override.N)rr!r-�address_family�socket_type�server_bindr"r:)r rrZbind_and_activaterrrr!�
s








zTCPServer.__init__c

CsQ|jr(|j
jt
jt
jd
�
n|j
j|j�

|j
j�|_dS)zOCalled by constructor to bind the socket. May be overridden. �
N)�allow_reuse_addressr-� setsockoptZ SOL_SOCKETZSO_REUSEADDRZbindrZgetsockname)
r rrrrJ�
s


zTCPServer.server_bindc

Cs|jj
|j�

d
S)zSCalled by constructor to activate the server. May be overridden. N)r-Zlisten�request_queue_size)
r rrrr"�
szTCPServer.server_activatec


Cs|jj
�
d
S)zDCalled to clean-up the server. May be overridden. N)r-�close)
r rrrr:�
szTCPServer.server_closec


Cs |jj
�S)
zMReturn socket file number. Interface required by select(). )r-�fileno)
r rrrrP�
szTCPServer.filenoc


Cs |jj
�S)
zYGet the request and client address from the socket. May be overridden. )r-Zaccept)
r rrrr2�
szTCPServer.get_requestcCs:y|
jt
j�

Wntk r(


Yn
X|j|
�

d
S)z3Called to shutdown and close an individual request.N)r,r-ZSHUT_WRrr;)r r7rrrr6�
s 


zTCPServer.shutdown_requestc
Cs|
j�
d
S)z)Called to clean up an individual request.N)
rO)r r7rrrr;�
szTCPServer.close_requestN)rCrDrErFr-ZAF_INETrHZSOCK_STREAMrIrNrLr!rJr"r:rPr2r6r;rrrrrp
s-    c@s[eZ
dZd
ZdZejZdZdd�Z dd�Z dd �Zd d�ZdS) rzUDP server class.Fi c
Cs.|jj
|j�
\}
}|
|jf|fS)
N)r-Zrecvfrom�max_packet_size)r �dataZclient_addrrrrr2�
s

zUDPServer.get_requestc


CsdS)
Nr)
r rrrr"�
szUDPServer.server_activatecCs|j|
�

dS)
N)
r;)r r7rrrr6szUDPServer.shutdown_requestc
CsdS)
Nr)r r7rrrr;szUDPServer.close_requestN) rCrDrErFrLr-Z SOCK_DGRAMrIrQr2r"r6r;rrrrr�
s c@sXeZ
dZd
ZdZdZdZdd�Zdd�Zd d �Z dd�Z dS) r z5Mix-in class to handle each request in a new process.i,
Nr=c
Cs&
|jd
krd
Sx�t
|j�
|jkr�y,tjdd�\}
}|jj|
�

Wqtk rn


Yqtk r�


|jj�
Yqt k r�


PYqXqWx||jj �D]k}
y/tj|
tj�\}
}|jj|
�

Wq�tk r



|jj|
�

Yq�t k r



Yq�Xq�Wd
S)z7Internal routine to wait for children that have exited.NrKr
�����)�active_children�len�max_children�os�waitpid�discard�InterruptedError�ChildProcessErrorr#r�copy�WNOHANG)r �pid�
_rrr�collect_childrens(













zForkingMixIn.collect_childrenc


Cs|j�
d
S)znWait for zombies after self.timeout seconds of inactivity. May be extended, do not override. N)
r`)
r rrrr04szForkingMixIn.handle_timeoutc


Cs|j�
d
S)z�Collect the zombie child processes regularly in the ForkingMixIn. service_actions is called in the BaseServer's serve_forver loop. N)
r`)
r rrrr&;szForkingMixIn.service_actionscCs�tj
�}|rQ|jd
kr0t�|_n|jj|�

|j|
�

d
Sy.|j|
|�
|j|
�

tjd�

Wn:


z!|j |
|�
|j|
�

Wd
tjd�

XYn
Xd
S)z-Fork a new subprocess to process the request.Nr
rK) rW�forkrTr'�addr;r9r6�_exitr5)r r7r8r^rrrr4Bs 











zForkingMixIn.process_request)rCrDrErFr.rTrVr`r0r&r4rrrrr s

$c@s4eZ
dZd
ZdZdd�Zdd�ZdS)rz4Mix-in class to handle each request in a new thread.Fc CsMy!|j|
|�
|j
|
�

Wn%


|j|
|�
|j
|
�

Yn
Xd
S)zgSame as in BaseServer but as a thread. In addition, exception handling is done here. N)r9r6r5)r r7r8rrr�process_request_threadbs




z%ThreadingMixIn.process_request_threadcCs;tj
d
|jd|
|f�}|j|_|j�
dS)z*Start a new thread to process the request.�targetrN)rZThreadrd�daemon_threadsZdaemon�start)r r7r8�
trrrr4os


zThreadingMixIn.process_requestN)rCrDrErFrfrdr4rrrrr[s
 c
@seZ
dZd
S)rN)rCrDrErrrrrwsc
@seZ
dZd
S)rN)rCrDrErrrrrxsc
@seZ
dZd
S)rN)rCrDrErrrrrzsc
@seZ
dZd
S)rN)rCrDrErrrrr{sc
@seZ
dZejZd
S)rN)rCrDrEr-rrHrrrrrs
c
@seZ
dZejZd
S)rN)rCrDrEr-rrHrrrrr�s
c
@seZ
dZd
S)rN)rCrDrErrrrr�sc
@seZ
dZd
S)rN)rCrDrErrrrr�sc@sFeZ
dZd
Zdd�Zdd�Zdd�Zdd �Zd S)r a�Base class for request handler classes. This class is instantiated for each request to be handled. The constructor sets the instance variables request, client_address and server, and then calls the handle() method. To implement a specific service, all you need to do is to derive a class which defines a handle() method. The handle() method can find the request as self.request, the client address as self.client_address, and the server (in case it needs access to per-server information) as self.server. Since a separate instance is created for each request, the handle() method can define arbitrary other instance variariables. c CsE|
|_||_
||_|j�
z|j�
Wd|j�
XdS)
N)r7r8�server�setup�handle�finish)r r7r8rirrrr!�s





zBaseRequestHandler.__init__c


CsdS)
Nr)
r rrrrj�s
zBaseRequestHandler.setupc


CsdS)
Nr)
r rrrrk�s
zBaseRequestHandler.handlec


CsdS)
Nr)
r rrrrl�s
zBaseRequestHandler.finishN)rCrDrErFr!rjrkrlrrrrr �s  c@sFeZ
dZd
Zd ZdZdZdZdd�Zdd �Z dS)r z4Define self.rfile and self.wfile for stream sockets.rKr
NFc

Cs�|j|_
|jdk r1|j
j|j�

n|jrY|j
jtjtjd
�
n|j
j d|j �|_|j
j d|j�|_ dS)NT�rb�wb)r7Z connectionr.Z settimeout�disable_nagle_algorithmrMr-ZIPPROTO_TCPZTCP_NODELAY�makefile�rbufsize�rfile�wbufsize�wfile)
r rrrrj�s







zStreamRequestHandler.setupc

CsV|jj
s8y|jj�
Wq8tjk r4


Yq8Xn|jj�
|jj�
dS)
N)rt�closed�flushr-�errorrOrr)
r rrrrl�s





zStreamRequestHandler.finishrS) rCrDrErFrqrsr.rorjrlrrrrr �s 
 c@s.eZ
dZd
Zdd�Zdd�ZdS)rz6Define self.rfile and self.wfile for datagram sockets.c
CsGd
dlm
}

|j\|_|_|
|j�
|_|
�|_dS)Nr
)
�BytesIO)�iorxr7Zpacketr-rrrt)r rxrrrrj�s



zDatagramRequestHandler.setupc

Cs#|jj
|jj�|j�
dS)
N)r-Zsendtort�getvaluer8)
r rrrrl�s
zDatagramRequestHandler.finishN)rCrDrErFrjrlrrrrr�s)rF�__version__r-r$rWrr�ImportErrorZdummy_threading�__all__�hasattr�extendrrrrr rrrrrrrrrr r rrrrr�xsF 













 �~S

.+