djangofixture 0.2

-*- rst -*-
===============
djangofixture
===============

Fixtures for Django. See <http://pypi.python.org/pypi/fixtures> for more
details about what we mean by "fixtures".

Licensing
=========

All files are Copyright (C) 2012 Canonical Ltd.

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, version 3 of the License.

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 <http://www.gnu.org/licenses/>.


Running
=======

This is how you do it::

class MyTest(TestCase):

def test_foo(self):
django_url = self.useFixture(DjangoFixture()).base_url
do_stuff_to_django(django_url)


Known problems and future work
==============================

* The port of the Django service is constant, so it is difficult to use the
fixture in parallel.

* Very minimal test coverage. This was originally written to test something
else.

* pkgme-service_ has ``DjangoSettings``, ``DjangoDatabase``, and
``CeleryFixture``. They are all probably useful and appropriate for here.


Getting help
============

If you'd like help with djangofixture, you can find the developers on
Freenode, hanging out in #pkgme. Alternatively, join the mailing list and
send an email to it.