Installation

Download or clone the repository, and from inside the root folder:

$ python setup.py install

Or, use pip:

$ pip install -e hg+https://bitbucket.org/schinckel/django-uuidfield#egg=django-uuidfield

Even better, do this from inside your virtualenv.

You are using virtualenv, right?

Django setup

You don't really need to install into your INSTALLED_APPS, but you may want to. I generally put everything in there that I use, just so any tests on it will be run when you test your project.

Then, in your model file:

from django.db import models
import uuidfield

class MyModel(models.Model):
    uuid = uuidfield.UUIDField()

Advanced use

The following arguments can be passed to the UUIDField:

• auto - a boolean value as to if values should be generated automatically. These values are created using uuid.uuid4().

Changes

0.6.5: Remove the creation of a "default" in a south migration when it has been set.

See http://south.aeracode.org/ticket/295#comment:8

0.6.4: Raise a ValidationError on a badly formed UUID string, rather than ValueError, in UUIDField.clean.

0.6.1: Treat the deprecation warning from django 1.3+