annotate Lib/SimpleHTTPServer.py @ 6719:faebc1940432 legacy-trunk

Understand -Xlinker option.
author Guido van Rossum <guido@python.org>
date Tue, 02 Dec 1997 20:38:11 +0000
parents 6fb6e01e2ba1
children fb4b4d069cc7
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
2887
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
1 """Simple HTTP Server.
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
2
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
3 This module builds on BaseHTTPServer by implementing the standard GET
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
4 and HEAD requests in a fairly straightforward manner.
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
5
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
6 """
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
7
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
8
3105
438f88b55154 recognize a few more file types
Guido van Rossum <guido@python.org>
parents: 2887
diff changeset
9 __version__ = "0.3"
2887
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
10
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
11
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
12 import os
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
13 import sys
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
14 import time
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
15 import socket
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
16 import string
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
17 import posixpath
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
18 import SocketServer
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
19 import BaseHTTPServer
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
20
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
21
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
22 class SimpleHTTPRequestHandler(BaseHTTPServer.BaseHTTPRequestHandler):
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
23
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
24 """Simple HTTP request handler with GET and HEAD commands.
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
25
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
26 This serves files from the current directory and any of its
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
27 subdirectories. It assumes that all files are plain text files
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
28 unless they have the extension ".html" in which case it assumes
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
29 they are HTML files.
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
30
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
31 The GET and HEAD requests are identical except that the HEAD
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
32 request omits the actual contents of the file.
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
33
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
34 """
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
35
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
36 server_version = "SimpleHTTP/" + __version__
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
37
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
38 def do_GET(self):
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
39 """Serve a GET request."""
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
40 f = self.send_head()
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
41 if f:
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
42 self.copyfile(f, self.wfile)
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
43 f.close()
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
44
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
45 def do_HEAD(self):
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
46 """Serve a HEAD request."""
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
47 f = self.send_head()
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
48 if f:
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
49 f.close()
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
50
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
51 def send_head(self):
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
52 """Common code for GET and HEAD commands.
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
53
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
54 This sends the response code and MIME headers.
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
55
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
56 Return value is either a file object (which has to be copied
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
57 to the outputfile by the caller unless the command was HEAD,
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
58 and must be closed by the caller under all circumstances), or
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
59 None, in which case the caller has nothing further to do.
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
60
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
61 """
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
62 path = self.translate_path(self.path)
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
63 if os.path.isdir(path):
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
64 self.send_error(403, "Directory listing not supported")
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
65 return None
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
66 try:
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
67 f = open(path)
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
68 except IOError:
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
69 self.send_error(404, "File not found")
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
70 return None
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
71 self.send_response(200)
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
72 self.send_header("Content-type", self.guess_type(path))
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
73 self.end_headers()
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
74 return f
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
75
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
76 def translate_path(self, path):
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
77 """Translate a /-separated PATH to the local filename syntax.
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
78
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
79 Components that mean special things to the local file system
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
80 (e.g. drive or directory names) are ignored. (XXX They should
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
81 probably be diagnosed.)
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
82
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
83 """
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
84 path = posixpath.normpath(path)
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
85 words = string.splitfields(path, '/')
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
86 words = filter(None, words)
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
87 path = os.getcwd()
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
88 for word in words:
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
89 drive, word = os.path.splitdrive(word)
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
90 head, word = os.path.split(word)
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
91 if word in (os.curdir, os.pardir): continue
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
92 path = os.path.join(path, word)
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
93 return path
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
94
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
95 def copyfile(self, source, outputfile):
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
96 """Copy all data between two file objects.
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
97
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
98 The SOURCE argument is a file object open for reading
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
99 (or anything with a read() method) and the DESTINATION
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
100 argument is a file object open for writing (or
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
101 anything with a write() method).
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
102
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
103 The only reason for overriding this would be to change
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
104 the block size or perhaps to replace newlines by CRLF
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
105 -- note however that this the default server uses this
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
106 to copy binary data as well.
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
107
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
108 """
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
109
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
110 BLOCKSIZE = 8192
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
111 while 1:
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
112 data = source.read(BLOCKSIZE)
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
113 if not data: break
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
114 outputfile.write(data)
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
115
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
116 def guess_type(self, path):
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
117 """Guess the type of a file.
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
118
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
119 Argument is a PATH (a filename).
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
120
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
121 Return value is a string of the form type/subtype,
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
122 usable for a MIME Content-type header.
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
123
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
124 The default implementation looks the file's extension
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
125 up in the table self.extensions_map, using text/plain
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
126 as a default; however it would be permissible (if
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
127 slow) to look inside the data to make a better guess.
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
128
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
129 """
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
130
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
131 base, ext = posixpath.splitext(path)
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
132 if self.extensions_map.has_key(ext):
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
133 return self.extensions_map[ext]
3105
438f88b55154 recognize a few more file types
Guido van Rossum <guido@python.org>
parents: 2887
diff changeset
134 ext = string.lower(ext)
438f88b55154 recognize a few more file types
Guido van Rossum <guido@python.org>
parents: 2887
diff changeset
135 if self.extensions_map.has_key(ext):
438f88b55154 recognize a few more file types
Guido van Rossum <guido@python.org>
parents: 2887
diff changeset
136 return self.extensions_map[ext]
2887
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
137 else:
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
138 return self.extensions_map['']
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
139
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
140 extensions_map = {
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
141 '': 'text/plain', # Default, *must* be present
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
142 '.html': 'text/html',
3105
438f88b55154 recognize a few more file types
Guido van Rossum <guido@python.org>
parents: 2887
diff changeset
143 '.htm': 'text/html',
438f88b55154 recognize a few more file types
Guido van Rossum <guido@python.org>
parents: 2887
diff changeset
144 '.gif': 'image/gif',
438f88b55154 recognize a few more file types
Guido van Rossum <guido@python.org>
parents: 2887
diff changeset
145 '.jpg': 'image/jpeg',
438f88b55154 recognize a few more file types
Guido van Rossum <guido@python.org>
parents: 2887
diff changeset
146 '.jpeg': 'image/jpeg',
2887
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
147 }
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
148
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
149
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
150 def test(HandlerClass = SimpleHTTPRequestHandler,
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
151 ServerClass = SocketServer.TCPServer):
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
152 BaseHTTPServer.test(HandlerClass, ServerClass)
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
153
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
154
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
155 if __name__ == '__main__':
ec0b42889243 Initial revision
Guido van Rossum <guido@python.org>
parents:
diff changeset
156 test()