Package restkit :: Package http :: Module message
[hide private]
[frames] | no frames]

Source Code for Module restkit.http.message

  1  # -*- coding: utf-8 - 
  2  # 
  3  # This file is part of restkit released under the MIT license.  
  4  # See the NOTICE for more information. 
  5   
  6  import re 
  7  import urlparse 
  8   
  9  try: 
 10      from cStringIO import StringIO 
 11  except ImportError: 
 12      from StringIO import StringIO 
 13   
 14  from restkit.http.body import ChunkedReader, LengthReader, EOFReader, Body, \ 
 15  GzipBody 
 16  from restkit.errors import InvalidHeader, InvalidHeaderName, NoMoreData, \ 
 17  InvalidRequestLine, InvalidRequestMethod, InvalidHTTPVersion, InvalidHTTPStatus 
 18   
19 -class Message(object):
20 - def __init__(self, unreader):
21 self.unreader = unreader 22 self.version = None 23 self.headers = [] 24 self.trailers = [] 25 self.body = None 26 self.encoding = None 27 28 self.hdrre = re.compile("[\x00-\x1F\x7F()<>@,;:\[\]={} \t\\\\\"]") 29 30 unused = self.parse(self.unreader) 31 self.unreader.unread(unused) 32 self.set_body_reader()
33
34 - def get_data(self, unreader, buf, stop=False):
35 data = unreader.read() 36 if not data: 37 if stop: 38 raise StopIteration() 39 raise NoMoreData(buf.getvalue()) 40 buf.write(data)
41
42 - def parse(self, unreader):
43 buf = StringIO() 44 45 self.get_data(unreader, buf, stop=True) 46 47 # Request line 48 idx = buf.getvalue().find("\r\n") 49 while idx < 0: 50 self.get_data(unreader, buf) 51 idx = buf.getvalue().find("\r\n") 52 self.parse_first_line(buf.getvalue()[:idx]) 53 rest = buf.getvalue()[idx+2:] # Skip \r\n 54 buf.truncate(0) 55 buf.write(rest) 56 57 # Headers 58 idx = buf.getvalue().find("\r\n\r\n") 59 done = buf.getvalue()[:2] == "\r\n" 60 while idx < 0 and not done: 61 self.get_data(unreader, buf) 62 idx = buf.getvalue().find("\r\n\r\n") 63 done = buf.getvalue()[:2] == "\r\n" 64 if done: 65 self.unreader.unread(buf.getvalue()[2:]) 66 return "" 67 self.headers = self.parse_headers(buf.getvalue()[:idx]) 68 69 ret = buf.getvalue()[idx+4:] 70 buf.truncate(0) 71 return ret
72
73 - def parse_first_line(self):
74 raise NotImplementedError()
75
76 - def parse_headers(self, data):
77 headers = [] 78 79 # Split lines on \r\n keeping the \r\n on each line 80 lines = [] 81 while len(data): 82 pos = data.find("\r\n") 83 if pos < 0: 84 lines.append(data) 85 data = "" 86 else: 87 lines.append(data[:pos+2]) 88 data = data[pos+2:] 89 90 # Parse headers into key/value pairs paying attention 91 # to continuation lines. 92 while len(lines): 93 # Parse initial header name : value pair. 94 curr = lines.pop(0) 95 if curr.find(":") < 0: 96 raise InvalidHeader(curr.strip()) 97 name, value = curr.split(":", 1) 98 name = name.rstrip(" \t") 99 if self.hdrre.search(name.upper()): 100 raise InvalidHeaderName(name) 101 name, value = name.strip(), [value.lstrip()] 102 103 # Consume value continuation lines 104 while len(lines) and lines[0].startswith((" ", "\t")): 105 value.append(lines.pop(0)) 106 value = ''.join(value).rstrip() 107 108 headers.append((name, value)) 109 return headers
110
111 - def set_body_reader(self):
112 chunked = False 113 clength = None 114 115 for (name, value) in self.headers: 116 if name.upper() == "CONTENT-LENGTH": 117 try: 118 clength = int(value) 119 except ValueError: 120 clength = None 121 elif name.upper() == "TRANSFER-ENCODING": 122 chunked = value.lower() == "chunked" 123 elif name.upper() == "CONTENT-ENCODING": 124 self.encoding = value.lower() 125 126 if chunked: 127 self.body = Body(ChunkedReader(self, self.unreader)) 128 elif clength is not None: 129 self.body = Body(LengthReader(self, self.unreader, clength)) 130 else: 131 self.body = Body(EOFReader(self, self.unreader))
132
133 - def should_close(self):
134 for (h, v) in self.headers: 135 if h.lower() == "connection": 136 if v.lower().strip() == "close": 137 return True 138 elif v.lower().strip() == "keep-alive": 139 return False 140 return self.version <= (1, 0)
141 142
143 -class Request(Message):
144 - def __init__(self, unreader):
145 self.methre = re.compile("[A-Z0-9$-_.]{3,20}") 146 self.versre = re.compile("HTTP/(\d+).(\d+)") 147 148 self.method = None 149 self.uri = None 150 self.scheme = None 151 self.host = None 152 self.port = 80 153 self.path = None 154 self.query = None 155 self.fragment = None 156 157 super(Request, self).__init__(unreader)
158
159 - def parse_first_line(self, line):
160 bits = line.split(None, 2) 161 if len(bits) != 3: 162 raise InvalidRequestLine(line) 163 164 # Method 165 if not self.methre.match(bits[0]): 166 raise InvalidRequestMethod(bits[0]) 167 self.method = bits[0].upper() 168 169 # URI 170 self.uri = bits[1] 171 parts = urlparse.urlparse(bits[1]) 172 self.scheme = parts.scheme or None 173 self.host = parts.netloc or None 174 if parts.port is None: 175 self.port = 80 176 else: 177 self.host = self.host.rsplit(":", 1)[0] 178 self.port = parts.port 179 self.path = parts.path or None 180 self.query = parts.query or None 181 self.fragment = parts.fragment or None 182 183 # Version 184 match = self.versre.match(bits[2]) 185 if match is None: 186 raise InvalidHTTPVersion(bits[2]) 187 self.version = (int(match.group(1)), int(match.group(2)))
188
189 - def set_body_reader(self):
190 super(Request, self).set_body_reader() 191 if isinstance(self.body.reader, EOFReader): 192 self.body = Body(LengthReader(self, self.unreader, 0))
193
194 -class Response(Message):
195
196 - def __init__(self, unreader):
197 self.versre = re.compile("HTTP/(\d+).(\d+)") 198 self.stare = re.compile("(\d{3})\s*(\w*)") 199 self.status = None 200 self.reason = None 201 self.status_int = None 202 203 super(Response, self).__init__(unreader)
204
205 - def parse_first_line(self, line):
206 bits = line.split(None, 1) 207 if len(bits) != 2: 208 raise InvalidRequestLine(line) 209 210 # version 211 matchv = self.versre.match(bits[0]) 212 if matchv is None: 213 raise InvalidHTTPVersion(bits[0]) 214 self.version = (int(matchv.group(1)), int(matchv.group(2))) 215 216 # status 217 matchs = self.stare.match(bits[1]) 218 if matchs is None: 219 raise InvalidHTTPStatus(bits[1]) 220 221 self.status = bits[1] 222 self.status_int = int(matchs.group(1)) 223 self.reason = matchs.group(2)
224
225 - def set_body_reader(self):
226 super(Response, self).set_body_reader() 227 if self.encoding == "gzip": 228 self.body = GzipBody(self.body.reader)
229