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 68 self.headers = self.parse_headers(buf.getvalue()[:idx]) 69 70 ret = buf.getvalue()[idx+4:] 71 buf.truncate(0) 72 return ret
73
74 - def parse_first_line(self):
75 raise NotImplementedError()
76
77 - def parse_headers(self, data):
78 headers = [] 79 80 # Split lines on \r\n keeping the \r\n on each line 81 lines = [] 82 lines = [line + "\r\n" for line in data.split("\r\n")] 83 84 # Parse headers into key/value pairs paying attention 85 # to continuation lines. 86 while len(lines): 87 # Parse initial header name : value pair. 88 curr = lines.pop(0) 89 if curr.find(":") < 0: 90 raise InvalidHeader(curr.strip()) 91 name, value = curr.split(":", 1) 92 name = name.rstrip(" \t") 93 if self.hdrre.search(name.upper()): 94 raise InvalidHeaderName(name) 95 name, value = name.strip(), [value.lstrip()] 96 97 # Consume value continuation lines 98 while len(lines) and lines[0].startswith((" ", "\t")): 99 value.append(lines.pop(0)) 100 value = ''.join(value).rstrip() 101 102 headers.append((name, value)) 103 return headers
104
105 - def set_body_reader(self):
106 chunked = False 107 clength = None 108 109 for (name, value) in self.headers: 110 if name.upper() == "CONTENT-LENGTH": 111 try: 112 clength = int(value) 113 except ValueError: 114 clength = None 115 elif name.upper() == "TRANSFER-ENCODING": 116 chunked = value.lower() == "chunked" 117 elif name.upper() == "CONTENT-ENCODING": 118 self.encoding = value.lower() 119 120 if clength is not None or chunked: 121 break 122 123 if chunked: 124 self.body = Body(ChunkedReader(self, self.unreader)) 125 elif clength is not None: 126 self.body = Body(LengthReader(self, self.unreader, clength)) 127 else: 128 self.body = Body(EOFReader(self, self.unreader))
129
130 - def should_close(self):
131 for (h, v) in self.headers: 132 if h.lower() == "connection": 133 if v.lower().strip() == "close": 134 return True 135 elif v.lower().strip() == "keep-alive": 136 return False 137 return self.version <= (1, 0)
138 139
140 -class Request(Message):
141 - def __init__(self, unreader):
142 self.methre = re.compile("[A-Z0-9$-_.]{3,20}") 143 self.versre = re.compile("HTTP/(\d+).(\d+)") 144 145 self.method = None 146 self.uri = None 147 self.scheme = None 148 self.host = None 149 self.port = 80 150 self.path = None 151 self.query = None 152 self.fragment = None 153 154 super(Request, self).__init__(unreader)
155
156 - def parse_first_line(self, line):
157 bits = line.split(None, 2) 158 if len(bits) != 3: 159 raise InvalidRequestLine(line) 160 161 # Method 162 if not self.methre.match(bits[0]): 163 raise InvalidRequestMethod(bits[0]) 164 self.method = bits[0].upper() 165 166 # URI 167 self.uri = bits[1] 168 parts = urlparse.urlparse(bits[1]) 169 self.scheme = parts.scheme or None 170 self.host = parts.netloc or None 171 if parts.port is None: 172 self.port = 80 173 else: 174 self.host = self.host.rsplit(":", 1)[0] 175 self.port = parts.port 176 self.path = parts.path or None 177 self.query = parts.query or None 178 self.fragment = parts.fragment or None 179 180 # Version 181 match = self.versre.match(bits[2]) 182 if match is None: 183 raise InvalidHTTPVersion(bits[2]) 184 self.version = (int(match.group(1)), int(match.group(2)))
185
186 - def set_body_reader(self):
187 super(Request, self).set_body_reader() 188 if isinstance(self.body.reader, EOFReader): 189 self.body = Body(LengthReader(self, self.unreader, 0))
190
191 -class Response(Message):
192
193 - def __init__(self, unreader):
194 self.versre = re.compile("HTTP/(\d+).(\d+)") 195 self.stare = re.compile("(\d{3})\s*(\w*)") 196 self.status = None 197 self.reason = None 198 self.status_int = None 199 200 super(Response, self).__init__(unreader)
201
202 - def parse_first_line(self, line):
203 bits = line.split(None, 1) 204 if len(bits) != 2: 205 raise InvalidRequestLine(line) 206 207 # version 208 matchv = self.versre.match(bits[0]) 209 if matchv is None: 210 raise InvalidHTTPVersion(bits[0]) 211 self.version = (int(matchv.group(1)), int(matchv.group(2))) 212 213 # status 214 matchs = self.stare.match(bits[1]) 215 if matchs is None: 216 raise InvalidHTTPStatus(bits[1]) 217 218 self.status = bits[1] 219 self.status_int = int(matchs.group(1)) 220 self.reason = matchs.group(2)
221
222 - def set_body_reader(self):
223 super(Response, self).set_body_reader() 224 if self.encoding == "gzip": 225 self.body = GzipBody(self.body.reader)
226