/usr/share/doc/python-kitchen-doc/html/index.html is in python-kitchen-doc 1.2.5-1.
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 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 | <!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" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Kitchen, everything but the sink — kitchen 1.2.5 documentation</title>
<link rel="stylesheet" href="_static/classic.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.2.5',
COLLAPSE_INDEX: false,
FILE_SUFFIX: '.html',
HAS_SOURCE: true,
SOURCELINK_SUFFIX: '.txt'
};
</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="search" type="application/opensearchdescription+xml"
title="Search within kitchen 1.2.5 documentation"
href="_static/opensearch.xml"/>
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="next" title="Using kitchen to write good code" href="tutorial.html" />
</head>
<body>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
accesskey="I">index</a></li>
<li class="right" >
<a href="py-modindex.html" title="Python Module Index"
>modules</a> |</li>
<li class="right" >
<a href="tutorial.html" title="Using kitchen to write good code"
accesskey="N">next</a> |</li>
<li class="nav-item nav-item-0"><a href="#">kitchen 1.2.5 documentation</a> »</li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body" role="main">
<div class="section" id="kitchen-everything-but-the-sink">
<h1>Kitchen, everything but the sink<a class="headerlink" href="#kitchen-everything-but-the-sink" title="Permalink to this headline">¶</a></h1>
<table class="docutils field-list" frame="void" rules="none">
<col class="field-name" />
<col class="field-body" />
<tbody valign="top">
<tr class="field-odd field"><th class="field-name">Author:</th><td class="field-body">Toshio Kuratomi</td>
</tr>
<tr class="field-even field"><th class="field-name">Date:</th><td class="field-body">19 March 2011</td>
</tr>
<tr class="field-odd field"><th class="field-name">Version:</th><td class="field-body">1.0.x</td>
</tr>
</tbody>
</table>
<p>We’ve all done it. In the process of writing a brand new application we’ve
discovered that we need a little bit of code that we’ve invented before.
Perhaps it’s something to handle unicode text. Perhaps it’s something to make
a bit of python-2.5 code run on python-2.4. Whatever it is, it ends up being
a tiny bit of code that seems too small to worry about pushing into its own
module so it sits there, a part of your current project, waiting to be cut and
pasted into your next project. And the next. And the next. And since that
little bittybit of code proved so useful to you, it’s highly likely that it
proved useful to someone else as well. Useful enough that they’ve written it
and copy and pasted it over and over into each of their new projects.</p>
<p>Well, no longer! Kitchen aims to pull these small snippets of code into a few
python modules which you can import and use within your project. No more copy
and paste! Now you can let someone else maintain and release these small
snippets so that you can get on with your life.</p>
<p>This package forms the core of Kitchen. It contains some useful modules for
using newer <a class="reference external" href="http://docs.python.org/library">python standard library</a> modules on older python versions, text manipulation,
<span class="target" id="index-0"></span><a class="pep reference external" href="https://www.python.org/dev/peps/pep-0386"><strong>PEP 386</strong></a> versioning, and initializing <code class="xref py py-mod docutils literal"><span class="pre">gettext</span></code>. With this package we’re
trying to provide a few useful features that don’t have too many dependencies
outside of the <a class="reference external" href="http://docs.python.org/library">python standard library</a>. We’ll be releasing other modules that drop into the
kitchen namespace to add other features (possibly with larger deps) as time
goes on.</p>
<div class="section" id="requirements">
<h2>Requirements<a class="headerlink" href="#requirements" title="Permalink to this headline">¶</a></h2>
<p>We’ve tried to keep the core kitchen module’s requirements lightweight. At the
moment kitchen only requires</p>
<table class="docutils field-list" frame="void" rules="none">
<col class="field-name" />
<col class="field-body" />
<tbody valign="top">
<tr class="field-odd field"><th class="field-name">python:</th><td class="field-body">2.4 or later</td>
</tr>
</tbody>
</table>
<div class="admonition warning">
<p class="first admonition-title">Warning</p>
<p class="last">Kitchen-1.1.0 was the last release that supported python-2.3.x</p>
</div>
<div class="section" id="soft-requirements">
<h3>Soft Requirements<a class="headerlink" href="#soft-requirements" title="Permalink to this headline">¶</a></h3>
<p>If found, these libraries will be used to make the implementation of some part
of kitchen better in some way. If they are not present, the API that they
enable will still exist but may function in a different manner.</p>
<dl class="docutils">
<dt><a class="reference external" href="http://pypi.python.org/pypi/chardet">chardet</a></dt>
<dd>Used in <a class="reference internal" href="api-text-misc.html#kitchen.text.misc.guess_encoding" title="kitchen.text.misc.guess_encoding"><code class="xref py py-func docutils literal"><span class="pre">guess_encoding()</span></code></a> and
<a class="reference internal" href="api-text-converters.html#kitchen.text.converters.guess_encoding_to_xml" title="kitchen.text.converters.guess_encoding_to_xml"><code class="xref py py-func docutils literal"><span class="pre">guess_encoding_to_xml()</span></code></a> to help guess
encoding of byte strings being converted. If not present, unknown
encodings will be converted as if they were <code class="docutils literal"><span class="pre">latin1</span></code></dd>
</dl>
</div>
</div>
<div class="section" id="other-recommended-libraries">
<h2>Other Recommended Libraries<a class="headerlink" href="#other-recommended-libraries" title="Permalink to this headline">¶</a></h2>
<p>These libraries implement commonly used functionality that everyone seems to
invent. Rather than reinvent their wheel, I simply list the things that they
do well for now. Perhaps if people can’t find them normally, I’ll add them as
requirements in <code class="file docutils literal"><span class="pre">setup.py</span></code> or link them into kitchen’s namespace. For
now, I just mention them here:</p>
<dl class="docutils">
<dt><a class="reference external" href="http://pypi.python.org/pypi/bunch/">bunch</a></dt>
<dd>Bunch is a dictionary that you can use attribute lookup as well as bracket
notation to access. Setting it apart from most homebrewed implementations
is the <code class="xref py py-func docutils literal"><span class="pre">bunchify()</span></code> function which will descend nested structures of
lists and dicts, transforming the dicts to Bunch’s.</dd>
<dt><a class="reference external" href="http://code.krypto.org/python/hashlib/">hashlib</a></dt>
<dd>Python 2.5 and forward have a <code class="xref py py-mod docutils literal"><span class="pre">hashlib</span></code> library that provides secure
hash functions to python. If you’re developing for python2.4 though, you
can install the standalone hashlib library and have access to the same
functions.</dd>
<dt><a class="reference external" href="http://pypi.python.org/pypi/iterutils/">iterutils</a></dt>
<dd>The python documentation for <code class="xref py py-mod docutils literal"><span class="pre">itertools</span></code> has some examples
of other nice iterable functions that can be built from the
<code class="xref py py-mod docutils literal"><span class="pre">itertools</span></code> functions. This third-party module creates those recipes
as a module.</dd>
<dt><a class="reference external" href="http://pypi.python.org/pypi/ordereddict/">ordereddict</a></dt>
<dd>Python 2.7 and forward have a <code class="xref py py-mod docutils literal"><span class="pre">OrderedDict</span></code> that
provides a <code class="xref py py-class docutils literal"><span class="pre">dict</span></code> whose items are ordered (and indexable) as well
as named.</dd>
<dt><a class="reference external" href="http://pypi.python.org/pypi/unittest2">unittest2</a></dt>
<dd>Python 2.7 has an updated <code class="xref py py-mod docutils literal"><span class="pre">unittest</span></code> library with new functions not
present in the <a class="reference external" href="http://docs.python.org/library">python standard library</a> for Python 2.6 or less. If you want to use those
new functions but need your testing framework to be compatible with older
Python the unittest2 library provides the update as an external module.</dd>
<dt><a class="reference external" href="http://somethingaboutorange.com/mrl/projects/nose/">nose</a></dt>
<dd>If you want to use a test discovery tool instead of the unittest
framework, nosetests provides a simple to use way to do that.</dd>
</dl>
</div>
<div class="section" id="license">
<h2>License<a class="headerlink" href="#license" title="Permalink to this headline">¶</a></h2>
<p>This python module is distributed under the terms of the
<a class="reference external" href="http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html">GNU Lesser General Public License Version 2 or later</a>.</p>
<div class="admonition note">
<p class="first admonition-title">Note</p>
<p>Some parts of this module are licensed under terms less restrictive
than the LGPLv2+. If you separate these files from the work as a whole
you are allowed to use them under the less restrictive licenses. The
following is a list of the files that are known:</p>
<dl class="last docutils">
<dt><a class="reference external" href="http://www.python.org/download/releases/2.4/license/">Python 2 license</a></dt>
<dd><code class="file docutils literal"><span class="pre">_subprocess.py</span></code>, <code class="file docutils literal"><span class="pre">test_subprocess.py</span></code>,
<code class="file docutils literal"><span class="pre">defaultdict.py</span></code>, <code class="file docutils literal"><span class="pre">test_defaultdict.py</span></code>,
<code class="file docutils literal"><span class="pre">_base64.py</span></code>, and <code class="file docutils literal"><span class="pre">test_base64.py</span></code></dd>
</dl>
</div>
</div>
<div class="section" id="contents">
<h2>Contents<a class="headerlink" href="#contents" title="Permalink to this headline">¶</a></h2>
<div class="toctree-wrapper compound">
<ul>
<li class="toctree-l1"><a class="reference internal" href="tutorial.html">Using kitchen to write good code</a><ul>
<li class="toctree-l2"><a class="reference internal" href="unicode-frustrations.html">Overcoming frustration: Correctly using unicode in python2</a></li>
<li class="toctree-l2"><a class="reference internal" href="designing-unicode-apis.html">Designing Unicode Aware APIs</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="api-overview.html">Kitchen API</a><ul>
<li class="toctree-l2"><a class="reference internal" href="api-i18n.html">Kitchen.i18n Module</a></li>
<li class="toctree-l2"><a class="reference internal" href="api-text.html">Kitchen.text: unicode and utf8 and xml oh my!</a></li>
<li class="toctree-l2"><a class="reference internal" href="api-collections.html">Kitchen.collections</a></li>
<li class="toctree-l2"><a class="reference internal" href="api-iterutils.html">Kitchen.iterutils Module</a></li>
<li class="toctree-l2"><a class="reference internal" href="api-versioning.html">Helpers for versioning software</a></li>
<li class="toctree-l2"><a class="reference internal" href="api-exceptions.html">Exceptions</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="porting-guide-0.3.html">1.0.0 Porting Guide</a><ul>
<li class="toctree-l2"><a class="reference internal" href="porting-guide-0.3.html#python-fedora">python-fedora</a></li>
<li class="toctree-l2"><a class="reference internal" href="porting-guide-0.3.html#yum">yum</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="hacking.html">Conventions for contributing to kitchen</a><ul>
<li class="toctree-l2"><a class="reference internal" href="hacking.html#style">Style</a></li>
<li class="toctree-l2"><a class="reference internal" href="hacking.html#python-2-4-compatibility">Python 2.4 compatibility</a></li>
<li class="toctree-l2"><a class="reference internal" href="hacking.html#unittests">Unittests</a></li>
<li class="toctree-l2"><a class="reference internal" href="hacking.html#docstrings-and-documentation">Docstrings and documentation</a></li>
<li class="toctree-l2"><a class="reference internal" href="hacking.html#kitchen-versioning">Kitchen versioning</a></li>
<li class="toctree-l2"><a class="reference internal" href="hacking.html#i18n">I18N</a></li>
<li class="toctree-l2"><a class="reference internal" href="hacking.html#api-updates">API updates</a></li>
<li class="toctree-l2"><a class="reference internal" href="hacking.html#news-file">NEWS file</a></li>
<li class="toctree-l2"><a class="reference internal" href="hacking.html#kitchen-subpackages">Kitchen subpackages</a></li>
<li class="toctree-l2"><a class="reference internal" href="hacking.html#kitchen-addon-packages">Kitchen addon packages</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="glossary.html">Glossary</a></li>
</ul>
</div>
</div>
<div class="section" id="indices-and-tables">
<h2>Indices and tables<a class="headerlink" href="#indices-and-tables" title="Permalink to this headline">¶</a></h2>
<ul class="simple">
<li><a class="reference internal" href="genindex.html"><span class="std std-ref">Index</span></a></li>
<li><a class="reference internal" href="py-modindex.html"><span class="std std-ref">Module Index</span></a></li>
<li><a class="reference internal" href="search.html"><span class="std std-ref">Search Page</span></a></li>
</ul>
</div>
<div class="section" id="project-pages">
<h2>Project Pages<a class="headerlink" href="#project-pages" title="Permalink to this headline">¶</a></h2>
<p>More information about the project can be found on the <a class="reference external" href="https://fedorahosted.org/kitchen">project webpage</a></p>
<p>The latest published version of this documentation can be found on the <a class="reference external" href="https://pypi.python.org/pypi/kitchen/docs">documentation page</a></p>
</div>
</div>
</div>
</div>
</div>
<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
<div class="sphinxsidebarwrapper">
<h3><a href="#">Table Of Contents</a></h3>
<ul>
<li><a class="reference internal" href="#">Kitchen, everything but the sink</a><ul>
<li><a class="reference internal" href="#requirements">Requirements</a><ul>
<li><a class="reference internal" href="#soft-requirements">Soft Requirements</a></li>
</ul>
</li>
<li><a class="reference internal" href="#other-recommended-libraries">Other Recommended Libraries</a></li>
<li><a class="reference internal" href="#license">License</a></li>
<li><a class="reference internal" href="#contents">Contents</a></li>
<li><a class="reference internal" href="#indices-and-tables">Indices and tables</a></li>
<li><a class="reference internal" href="#project-pages">Project Pages</a></li>
</ul>
</li>
</ul>
<h4>Next topic</h4>
<p class="topless"><a href="tutorial.html"
title="next chapter">Using kitchen to write good code</a></p>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="_sources/index.rst.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="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
>index</a></li>
<li class="right" >
<a href="py-modindex.html" title="Python Module Index"
>modules</a> |</li>
<li class="right" >
<a href="tutorial.html" title="Using kitchen to write good code"
>next</a> |</li>
<li class="nav-item nav-item-0"><a href="#">kitchen 1.2.5 documentation</a> »</li>
</ul>
</div>
<div class="footer" role="contentinfo">
© Copyright 2017 Red Hat, Inc. and others.
Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.6.5.
</div>
</body>
</html>
|