blob: da14144ad797fe14d86844073fb3df159069e91d [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
Antoine Pitrou38a66ad2009-01-03 18:41:49 +0000114 for k, v in self.headers.items():
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000115 k=k.replace('-','_').upper(); v=v.strip()
116 if k in env:
117 continue # skip content length, type,etc.
118 if 'HTTP_'+k in env:
119 env['HTTP_'+k] += ','+v # comma-separate multiple headers
120 else:
121 env['HTTP_'+k] = v
122 return env
123
124 def get_stderr(self):
125 return sys.stderr
126
127 def handle(self):
128 """Handle a single HTTP request"""
129
130 self.raw_requestline = self.rfile.readline()
131 if not self.parse_request(): # An error code has been sent, just exit
132 return
133
134 handler = ServerHandler(
135 self.rfile, self.wfile, self.get_stderr(), self.get_environ()
136 )
137 handler.request_handler = self # backpointer for logging
138 handler.run(self.server.get_app())
139
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
165def demo_app(environ,start_response):
Guido van Rossum6a10e022007-08-08 17:01:45 +0000166 from io import StringIO
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000167 stdout = StringIO()
Guido van Rossumbe19ed72007-02-09 05:37:30 +0000168 print("Hello world!", file=stdout)
169 print(file=stdout)
Antoine Pitrou38a66ad2009-01-03 18:41:49 +0000170 h = sorted(environ.items())
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000171 for k,v in h:
Guido van Rossumbe19ed72007-02-09 05:37:30 +0000172 print(k,'=',repr(v), file=stdout)
Antoine Pitrou38a66ad2009-01-03 18:41:49 +0000173 start_response(b"200 OK", [(b'Content-Type',b'text/plain; charset=utf-8')])
174 return [stdout.getvalue().encode("utf-8")]
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000175
176
177def make_server(
178 host, port, app, server_class=WSGIServer, handler_class=WSGIRequestHandler
179):
180 """Create a new WSGI server listening on `host` and `port` for `app`"""
181 server = server_class((host, port), handler_class)
182 server.set_app(app)
183 return server
184
185
186if __name__ == '__main__':
187 httpd = make_server('', 8000, demo_app)
188 sa = httpd.socket.getsockname()
Guido van Rossumbe19ed72007-02-09 05:37:30 +0000189 print("Serving HTTP on", sa[0], "port", sa[1], "...")
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000190 import webbrowser
191 webbrowser.open('http://localhost:8000/xyz?abc')
192 httpd.handle_request() # serve one request, then exit
193
194
195
196
197
198
199
200
201
202
203
204
205#