/usr/share/doc/python-webob-doc/whatsnew-1.5.html is in python-webob-doc 1:1.6.2-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 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 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>What’s New in WebOb 1.5 — WebOb 1.6.2 documentation</title>
<link rel="stylesheet" href="_static/alabaster.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT: './',
VERSION: '1.6.2',
COLLAPSE_INDEX: false,
FILE_SUFFIX: '.html',
HAS_SOURCE: true
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="top" title="WebOb 1.6.2 documentation" href="index.html" />
<link rel="next" title="What’s New in WebOb 1.6" href="whatsnew-1.6.html" />
<link rel="prev" title="Another Do-It-Yourself Framework" href="do-it-yourself.html" />
<link rel="stylesheet" href="_static/custom.css" type="text/css" />
<meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
</head>
<body role="document">
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<div class="section" id="what-s-new-in-webob-1-5">
<h1>What’s New in WebOb 1.5<a class="headerlink" href="#what-s-new-in-webob-1-5" title="Permalink to this headline">¶</a></h1>
<div class="section" id="backwards-incompatibilities">
<h2>Backwards Incompatibilities<a class="headerlink" href="#backwards-incompatibilities" title="Permalink to this headline">¶</a></h2>
<ul>
<li><p class="first"><code class="docutils literal"><span class="pre">Response.set_cookie</span></code> renamed the only required parameter from “key” to
“name”. The code will now still accept “key” as a keyword argument, and will
issue a DeprecationWarning until WebOb 1.7.</p>
</li>
<li><p class="first">The <code class="docutils literal"><span class="pre">status</span></code> attribute of a <code class="docutils literal"><span class="pre">Response</span></code> object no longer takes a string
like <code class="docutils literal"><span class="pre">None</span> <span class="pre">None</span></code> and allows that to be set as the status. It now has to at
least match the pattern of <code class="docutils literal"><span class="pre"><integer</span> <span class="pre">status</span> <span class="pre">code></span> <span class="pre"><explenation</span> <span class="pre">of</span> <span class="pre">status</span>
<span class="pre">code></span></code>. Invalid status strings will now raise a <code class="docutils literal"><span class="pre">ValueError</span></code>.</p>
</li>
<li><p class="first"><code class="docutils literal"><span class="pre">Morsel</span></code> will no longer accept a cookie value that does not meet RFC6265’s
cookie-octet specification. Upon calling <code class="docutils literal"><span class="pre">Morsel.serialize</span></code> a warning will
be issued, in the future this will raise a <code class="docutils literal"><span class="pre">ValueError</span></code>, please update your
cookie handling code. See <a class="reference external" href="https://github.com/Pylons/webob/pull/172">https://github.com/Pylons/webob/pull/172</a></p>
<p>The cookie-octet specification in RFC6265 states the following characters are
valid in a cookie value:</p>
<table border="1" class="docutils">
<colgroup>
<col width="28%" />
<col width="72%" />
</colgroup>
<thead valign="bottom">
<tr class="row-odd"><th class="head">Hex Range</th>
<th class="head">Actual Characters</th>
</tr>
</thead>
<tbody valign="top">
<tr class="row-even"><td><code class="docutils literal"><span class="pre">[0x21</span>     <span class="pre">]</span></code></td>
<td><code class="docutils literal"><span class="pre">!</span></code></td>
</tr>
<tr class="row-odd"><td><code class="docutils literal"><span class="pre">[0x25-0x2B]</span></code></td>
<td><code class="docutils literal"><span class="pre">#$%&'()*+</span></code></td>
</tr>
<tr class="row-even"><td><code class="docutils literal"><span class="pre">[0x2D-0x3A]</span></code></td>
<td><code class="docutils literal"><span class="pre">-./0123456789:</span></code></td>
</tr>
<tr class="row-odd"><td><code class="docutils literal"><span class="pre">[0x3C-0x5B]</span></code></td>
<td><code class="docutils literal"><span class="pre"><=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[</span></code></td>
</tr>
<tr class="row-even"><td><code class="docutils literal"><span class="pre">[0x5D-0x7E]</span></code></td>
<td><code class="docutils literal"><span class="pre">]^_`abcdefghijklmnopqrstuvwxyz{|}~</span></code></td>
</tr>
</tbody>
</table>
<p>RFC6265 suggests using base 64 to serialize data before storing data in a
cookie.</p>
<p>Cookies that meet the RFC6265 standard will no longer be quoted, as this is
unnecessary. This is a no-op as far as browsers and cookie storage is
concerned.</p>
</li>
<li><p class="first"><code class="docutils literal"><span class="pre">Response.set_cookie</span></code> now uses the internal <code class="docutils literal"><span class="pre">make_cookie</span></code> API, which will
issue warnings if cookies are set with invalid bytes. See
<a class="reference external" href="https://github.com/Pylons/webob/pull/172">https://github.com/Pylons/webob/pull/172</a></p>
</li>
</ul>
</div>
<div class="section" id="features">
<h2>Features<a class="headerlink" href="#features" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Add support for some new caching headers, stale-while-revalidate and
stale-if-error that can be used by reverse proxies to cache stale responses
temporarily if the backend disappears. From RFC5861. See
<a class="reference external" href="https://github.com/Pylons/webob/pull/189">https://github.com/Pylons/webob/pull/189</a></li>
</ul>
</div>
<div class="section" id="bug-fixes">
<h2>Bug Fixes<a class="headerlink" href="#bug-fixes" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li>Response.status now uses duck-typing for integers, and has also learned to
raise a ValueError if the status isn’t an integer followed by a space, and
then the reason. See <a class="reference external" href="https://github.com/Pylons/webob/pull/191">https://github.com/Pylons/webob/pull/191</a></li>
<li>Fixed a bug in <code class="docutils literal"><span class="pre">webob.multidict.GetDict</span></code> which resulted in the
QUERY_STRING not being updated when changes were made to query
params using <code class="docutils literal"><span class="pre">Request.GET.extend()</span></code>.</li>
<li>Read the body of a request if we think it might have a body. This fixes PATCH
to support bodies. See <a class="reference external" href="https://github.com/Pylons/webob/pull/184">https://github.com/Pylons/webob/pull/184</a></li>
<li>Response.from_file returns HTTP headers as latin1 rather than UTF-8, this
fixes the usage on Google AppEngine. See
<a class="reference external" href="https://github.com/Pylons/webob/issues/99">https://github.com/Pylons/webob/issues/99</a> and
<a class="reference external" href="https://github.com/Pylons/webob/pull/150">https://github.com/Pylons/webob/pull/150</a></li>
<li>Fix a bug in parsing the auth parameters that contained bad white space. This
makes the parsing fall in line with what’s required in RFC7235. See
<a class="reference external" href="https://github.com/Pylons/webob/issues/158">https://github.com/Pylons/webob/issues/158</a></li>
<li>Use ‘rn’ line endings in <code class="docutils literal"><span class="pre">Response.__str__</span></code>. See:
<a class="reference external" href="https://github.com/Pylons/webob/pull/146">https://github.com/Pylons/webob/pull/146</a></li>
</ul>
</div>
<div class="section" id="documentation-changes">
<h2>Documentation Changes<a class="headerlink" href="#documentation-changes" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li><code class="docutils literal"><span class="pre">response.set_cookie</span></code> now has proper documentation for <code class="docutils literal"><span class="pre">max_age</span></code> and
<code class="docutils literal"><span class="pre">expires</span></code>. The code has also been refactored to use <code class="docutils literal"><span class="pre">cookies.make_cookie</span></code>
instead of duplicating the code. This fixes
<a class="reference external" href="https://github.com/Pylons/webob/issues/166">https://github.com/Pylons/webob/issues/166</a> and
<a class="reference external" href="https://github.com/Pylons/webob/issues/171">https://github.com/Pylons/webob/issues/171</a></li>
<li>Documentation didn’t match the actual code for the wsgify function signature.
See <a class="reference external" href="https://github.com/Pylons/webob/pull/167">https://github.com/Pylons/webob/pull/167</a></li>
<li>Remove the WebDAV only from certain HTTP Exceptions, these exceptions may
also be used by REST services for example.</li>
</ul>
</div>
</div>
</div>
</div>
</div>
<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
<div class="sphinxsidebarwrapper">
<h3><a href="index.html">Table Of Contents</a></h3>
<ul>
<li><a class="reference internal" href="#">What’s New in WebOb 1.5</a><ul>
<li><a class="reference internal" href="#backwards-incompatibilities">Backwards Incompatibilities</a></li>
<li><a class="reference internal" href="#features">Features</a></li>
<li><a class="reference internal" href="#bug-fixes">Bug Fixes</a></li>
<li><a class="reference internal" href="#documentation-changes">Documentation Changes</a></li>
</ul>
</li>
</ul>
<div class="relations">
<h3>Related Topics</h3>
<ul>
<li><a href="index.html">Documentation overview</a><ul>
<li>Previous: <a href="do-it-yourself.html" title="previous chapter">Another Do-It-Yourself Framework</a></li>
<li>Next: <a href="whatsnew-1.6.html" title="next chapter">What’s New in WebOb 1.6</a></li>
</ul></li>
</ul>
</div>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="_sources/whatsnew-1.5.txt"
rel="nofollow">Show Source</a></li>
</ul>
</div>
<div id="searchbox" style="display: none" role="search">
<h3>Quick search</h3>
<form class="search" action="search.html" method="get">
<div><input type="text" name="q" /></div>
<div><input type="submit" value="Go" /></div>
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="footer">
©2017, Ian Bicking and contributors.
|
Powered by <a href="http://sphinx-doc.org/">Sphinx 1.4.9</a>
& <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.8</a>
|
<a href="_sources/whatsnew-1.5.txt"
rel="nofollow">Page source</a>
</div>
</body>
</html>
|