gluon.http

64 """Raises an HTTP response 65 66 Args: 67 status: usually an integer. If it's a well known status code, the ERROR 68 message will be automatically added. A string can also be passed 69 as `510 Foo Bar` and in that case the status code and the error 70 message will be parsed accordingly 71 body: what to return as body. If left as is, will return the error code 72 and the status message in the body itself 73 cookies: pass cookies along (usually not needed) 74 headers: pass headers as usual dict mapping 75 """ 76

77 - def __init__( 78 self, 79 status, 80 body='', 81 cookies=None, 82 **headers 83 ):

84 self.status = status 85 self.body = body 86 self.headers = headers 87 self.cookies2headers(cookies)

88

89 - def cookies2headers(self, cookies):

90 if cookies and len(cookies) > 0: 91 self.headers['Set-Cookie'] = [ 92 str(cookie)[11:] for cookie in cookies.values()]

93

94 - def to(self, responder, env=None):

95 env = env or {} 96 status = self.status 97 headers = self.headers 98 if status in defined_status: 99 status = '%d %s' % (status, defined_status[status]) 100 elif isinstance(status, int): 101 status = '%d UNKNOWN ERROR' % status 102 else: 103 status = str(status) 104 if not regex_status.match(status): 105 status = '500 %s' % (defined_status[500]) 106 headers.setdefault('Content-Type', 'text/html; charset=UTF-8') 107 body = self.body 108 if status[:1] == '4': 109 if not body: 110 body = status 111 if isinstance(body, str): 112 headers['Content-Length'] = len(body) 113 rheaders = [] 114 for k, v in headers.iteritems(): 115 if isinstance(v, list): 116 rheaders += [(k, str(item)) for item in v] 117 elif not v is None: 118 rheaders.append((k, str(v))) 119 responder(status, rheaders) 120 if env.get('request_method', '') == 'HEAD': 121 return [''] 122 elif isinstance(body, str): 123 return [body] 124 elif hasattr(body, '__iter__'): 125 return body 126 else: 127 return [str(body)]

128 129 @property

130 - def message(self):

131 """ 132 compose a message describing this exception 133 134 "status defined_status [web2py_error]" 135 136 message elements that are not defined are omitted 137 """ 138 msg = '%(status)s' 139 if self.status in defined_status: 140 msg = '%(status)s %(defined_status)s' 141 if 'web2py_error' in self.headers: 142 msg += ' [%(web2py_error)s]' 143 return msg % dict( 144 status=self.status, 145 defined_status=defined_status.get(self.status), 146 web2py_error=self.headers.get('web2py_error'))

147

148 - def __str__(self):

149 "stringify me" 150 return self.message

154 """Raises a redirect (303) 155 156 Args: 157 location: the url where to redirect 158 how: what HTTP status code to use when redirecting 159 client_side: if set to True, it triggers a reload of the entire page 160 when the fragment has been loaded as a component 161 """ 162 if location: 163 from gluon import current 164 loc = location.replace('\r', '%0D').replace('\n', '%0A') 165 if client_side and current.request.ajax: 166 raise HTTP(200, **{'web2py-redirect-location': loc}) 167 else: 168 raise HTTP(how, 169 'You are being redirected <a href="%s">here</a>' % loc, 170 Location=loc) 171 else: 172 from gluon import current 173 if client_side and current.request.ajax: 174 raise HTTP(200, **{'web2py-component-command': 'window.location.reload(true)'})

Source Code for Module gluon.http