Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

A general purpose conversion library

Project Description


  • A general purpose conversion library

ConversionKit is a general purpose conversion library designed as an improvement to the functionality in FormEncode but using simple functions rather than complex schema and validators and avoiding the use of exceptions to flag errors. See the introducion in the manual for full details.

Get Started

  • Download and install from source


James Gardner james at pythonweb dot org




  • Releasing some changes from hg, including use of toDict()


No changes.



  • Fixing a bug with Field() where empty_error settings weren’t being applied
  • Fixing a bug with incorrect message arguments
  • Added the start of a types library


  • BuildKit support



  • Added extra message options to toDictionary()
  • Updated the file to include the tests and doc sources



  • Updated the license to GNU AGPLv3
  • Split the FormEncode documentation and tests out from the main docs and tests. FormEncode isn’t officially supported and its use with ConversionKit is deprecated.


  • Renamed new_conversion to child_conversion internally
  • Upgraded tryEach() to be able to assign items to a dictionary, and stop on the first result or first error.
  • Made toDictionary() return unicode keys by default
  • Used pprint() in the docs to help avoid the problem of dictionaries changing their sort order as functionality changes and help make the code easier to read.


  • Allowed missing and empty errors in toDictionary() to be specified as a string and as a tuple as well as a dict and added in documentation and tests.


  • Improved the documentation and checked doctests all pass
  • Refactored the toDictionary() converter to support missing and empty errors and defaults
  • Removed the nested, first_stab and second_stab modules


  • Clarified process around post converters
  • Changed naming convention to use a lower-case first letter for functions which return functions



  • Added Or converter


  • Re-written from the ground up with a better naming convention and more explanation in the docs.
  • Implemented if_missing and if_empty.



  • Completely re-wrote everything again with a vastly simplified API, new detailed documentation, over 180 doctests and Sphinx doc generation.


  • Added new handlers
  • Errors now return a string
  • QUERNS format error encoding supported
  • Added some more examples to the docs


  • Complete re-write to use a convesion-oriented approach, remove groups and focus on nested structs as the preferred data structure. The original code is still available in


  • Added some better error handling
  • First version


ConversionKit - Tools for handling conversions

Copyright (C) 2008 James Gardner

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program. If not, see <>.

Release History

Release History

This version
History Node


History Node


History Node


History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
ConversionKit-0.3.4.tar.gz (42.1 kB) Copy SHA256 Checksum SHA256 Source Jul 6, 2011

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting