A collection of utilities of everyday use when writing Python 3.x code or Django 3.2+ projects.

Python 2.x support has been dropped.

This package is used by several living projects. The individual utilities contained are usually not depending on each other. Their layout and API are considered stable honouring the backward compatibility.

The project is divided into two sections:

• General Python stuff
• Django-related utils - located in the django package

The code is documented, please find the description and examples in the docstring of each utility.

Install either using pip:

pip install useful

or from source:

git clone https://github.com/tuttle/python-useful src/useful
cd src/useful
python setup.py develop

If you are about to use the Django features like the templatetags, you can add to INSTALLED_APPS:

INSTALLED_APPS = (
    ...
    'useful.django',
)

Please file an Issue on GitHub if you have bugreport, tip, anything. Thank you!