blob: a82c80a8024c6a15e7610ac83378f5f67e2489cc [file] [log] [blame]
Thomas Wouters0e3f5912006-08-11 14:57:12 +00001"""BaseHTTPServer that implements the Python WSGI protocol (PEP 333, rev 1.21)
2
3This is both an example of how WSGI can be implemented, and a basis for running
4simple web applications on a local machine, such as might be done when testing
5or debugging an application. It has not been reviewed for security issues,
6however, and we strongly recommend that you use a "real" web server for
7production use.
8
9For example usage, see the 'if __name__=="__main__"' block at the end of the
10module. See also the BaseHTTPServer module docs for other API information.
11"""
12
Georg Brandl24420152008-05-26 16:32:26 +000013from http.server import BaseHTTPRequestHandler, HTTPServer
Jeremy Hylton1afc1692008-06-18 20:49:58 +000014import sys
15import urllib.parse
Thomas Wouters0e3f5912006-08-11 14:57:12 +000016from wsgiref.handlers import SimpleHandler
17
18__version__ = "0.1"
19__all__ = ['WSGIServer', 'WSGIRequestHandler', 'demo_app', 'make_server']
20
21
22server_version = "WSGIServer/" + __version__
23sys_version = "Python/" + sys.version.split()[0]
24software_version = server_version + ' ' + sys_version
25
26
27class ServerHandler(SimpleHandler):
28
29 server_software = software_version
30
31 def close(self):
32 try:
33 self.request_handler.log_request(
34 self.status.split(' ',1)[0], self.bytes_sent
35 )
36 finally:
37 SimpleHandler.close(self)
38
39
40
41
42
43class WSGIServer(HTTPServer):
44
45 """BaseHTTPServer that implements the Python WSGI protocol"""
46
47 application = None
48
49 def server_bind(self):
50 """Override server_bind to store the server name."""
51 HTTPServer.server_bind(self)
52 self.setup_environ()
53
54 def setup_environ(self):
55 # Set up base environment
56 env = self.base_environ = {}
57 env['SERVER_NAME'] = self.server_name
58 env['GATEWAY_INTERFACE'] = 'CGI/1.1'
59 env['SERVER_PORT'] = str(self.server_port)
60 env['REMOTE_HOST']=''
61 env['CONTENT_LENGTH']=''
62 env['SCRIPT_NAME'] = ''
63
64 def get_app(self):
65 return self.application
66
67 def set_app(self,application):
68 self.application = application
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84class WSGIRequestHandler(BaseHTTPRequestHandler):
85
86 server_version = "WSGIServer/" + __version__
87
88 def get_environ(self):
89 env = self.server.base_environ.copy()
90 env['SERVER_PROTOCOL'] = self.request_version
91 env['REQUEST_METHOD'] = self.command
92 if '?' in self.path:
93 path,query = self.path.split('?',1)
94 else:
95 path,query = self.path,''
96
Jeremy Hylton1afc1692008-06-18 20:49:58 +000097 env['PATH_INFO'] = urllib.parse.unquote(path)
Thomas Wouters0e3f5912006-08-11 14:57:12 +000098 env['QUERY_STRING'] = query
99
100 host = self.address_string()
101 if host != self.client_address[0]:
102 env['REMOTE_HOST'] = host
103 env['REMOTE_ADDR'] = self.client_address[0]
104
Barry Warsaw820c1202008-06-12 04:06:45 +0000105 if self.headers.get('content-type') is None:
106 env['CONTENT_TYPE'] = self.headers.get_content_type()
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000107 else:
Barry Warsaw820c1202008-06-12 04:06:45 +0000108 env['CONTENT_TYPE'] = self.headers['content-type']
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000109
Barry Warsaw820c1202008-06-12 04:06:45 +0000110 length = self.headers.get('content-length')
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000111 if length:
112 env['CONTENT_LENGTH'] = length
113
Barry Warsaw820c1202008-06-12 04:06:45 +0000114 for h in self.headers:
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000115 k,v = h.split(':',1)
116 k=k.replace('-','_').upper(); v=v.strip()
117 if k in env:
118 continue # skip content length, type,etc.
119 if 'HTTP_'+k in env:
120 env['HTTP_'+k] += ','+v # comma-separate multiple headers
121 else:
122 env['HTTP_'+k] = v
123 return env
124
125 def get_stderr(self):
126 return sys.stderr
127
128 def handle(self):
129 """Handle a single HTTP request"""
130
131 self.raw_requestline = self.rfile.readline()
132 if not self.parse_request(): # An error code has been sent, just exit
133 return
134
135 handler = ServerHandler(
136 self.rfile, self.wfile, self.get_stderr(), self.get_environ()
137 )
138 handler.request_handler = self # backpointer for logging
139 handler.run(self.server.get_app())
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166def demo_app(environ,start_response):
Guido van Rossum6a10e022007-08-08 17:01:45 +0000167 from io import StringIO
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000168 stdout = StringIO()
Guido van Rossumbe19ed72007-02-09 05:37:30 +0000169 print("Hello world!", file=stdout)
170 print(file=stdout)
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000171 h = environ.items(); h.sort()
172 for k,v in h:
Guido van Rossumbe19ed72007-02-09 05:37:30 +0000173 print(k,'=',repr(v), file=stdout)
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000174 start_response("200 OK", [('Content-Type','text/plain')])
175 return [stdout.getvalue()]
176
177
178def make_server(
179 host, port, app, server_class=WSGIServer, handler_class=WSGIRequestHandler
180):
181 """Create a new WSGI server listening on `host` and `port` for `app`"""
182 server = server_class((host, port), handler_class)
183 server.set_app(app)
184 return server
185
186
187if __name__ == '__main__':
188 httpd = make_server('', 8000, demo_app)
189 sa = httpd.socket.getsockname()
Guido van Rossumbe19ed72007-02-09 05:37:30 +0000190 print("Serving HTTP on", sa[0], "port", sa[1], "...")
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000191 import webbrowser
192 webbrowser.open('http://localhost:8000/xyz?abc')
193 httpd.handle_request() # serve one request, then exit
194
195
196
197
198
199
200
201
202
203
204
205
206#