Kitchen, everything but the sink

Author:Toshio Kuratomi
Date:19 March 2011

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.3. 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.

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.

This package forms the core of Kitchen. It contains some useful modules for using newer python standard library modules on older python versions, text manipulation, PEP 386 versioning, and initializing gettext. With this package we’re trying to provide a few useful features that don’t have too many dependencies outside of the python standard library. We’ll be releasing other modules that drop into the kitchen namespace to add other features (possibly with larger deps) as time goes on.


We’ve tried to keep the core kitchen module’s requirements lightweight. At the moment kitchen only requires

python:2.3.1 or later


Kitchen-1.1.0 is likely to be the last release that supports python-2.3.x. Future releases will target python-2.4 as the minimum required version.

Soft Requirements

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.

Used in guess_encoding() and guess_encoding_to_xml() to help guess encoding of byte strings being converted. If not present, unknown encodings will be converted as if they were latin1


This python module is distributed under the terms of the GNU Lesser General Public License Version 2 or later.


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:

Python 2 license,,,,, and

Indices and tables

Project Pages

More information about the project can be found on the project webpage

The latest published version of this documentation can be found on the documentation page