jarshwah / django-scratch

A project that can be used for testing django patches

django-scratch

A project that can be used for testing and interacting with django patches, in a user focused way.

If you're looking to run the django test suite, then the django-box project is more useful.

The manage.py file is configured to load django from a sibling path of the project, to facilitate testing against the django core repository.

The directory structure should be:

• ~/projects/django/
• ~/projects/django-scratch/

Initialization

Ensure pipenv and pyenv are both installed locally for best use. Also ensure that the python defined in Pipfile.python_full_version is installed (currently 3.6.4).

$ git clone https://github.com/django/django
$ git clone https://github.com/jarshwah/django-scratch
$ cd django-scratch
$ pipenv install -d  # if you're using pyenv, this is enough
$ pipenv install -d --python /path/to/python/3.6.4/  # or this if you're not using pyenv
$ cd scratch
$ pipenv run python manage.py migrate
$ pipenv run python manage.py shell_plus

The defaults use sqlite as the database backend. There's also support for using postgres via docker-compose (or edit the settings_psql.py to point to an existing postgres server):

$ cd django-scratch
$ docker-compose up
$ cd scratch
$ pipenv run python pgmanage.py migrate
$ pipenv run python pgmanage.py shell_plus

The pgmanage.py script is just a shorthand for:

$ pipenv run python manage.py --settings=scratch.settings_psql migrate