jmoiron/humanize — pull request #5 by chewxy (2012-12-21 15:56:24+00:00)
Title: Human Digestable Numbers

## Notes ##
I've had this function written outside of humanize for some time now and it's looking for a home. There isn't much sense in creating a package for such a small feature and since I use humanize a lot, I thought it would be a good fit with the theme of the humanize package.

## Human Digestable Numbers ##
There are times in one's projects one might not want to show users ugly decimals, or there are cases where decimals make no sense in context.

Take for example, a common measurement used in recipes is '1/3 cups' and while '1/3 cups' is functionally the same as '0.333333 cups', showing end users '0.333333 cups' presents a cognitive disconnect to the reader.

While commonly used string formatting operations (like %s, %0.1f etc) can be used, again, they present a cognitive disconnect if a user is used to reading fractions.

Therefore, the solution is to humanize those numbers by presenting them fractions.

## This Pull Request ##
This pull request handles all the above mentioned. It will return the fraction, mixed fraction or whole number, represented in a string.

The test case has been written for your perusal. The `README.rst` file has been updated, as has the `__init__.py` file, save for the version number.