There are many ways to contribute to the project. You may improve the documentation, address a bug, add some feature to the code or do something else. All sort of contributions are welcome.
To start development on this project, fork this repository and follow the following instructions.
# clone the forked repository
$ git clone YOUR_FORKED_REPO_URL
# create a virtual environment
$ python3 -m venv venv
# activate the virtual environment
$ source venv/bin/activate
# install django-extensions in development mode
(venv) $ pip install -e .
# install dependencies
(venv) $ pip install Django -r requirements-dev.txt
# for accessing the GUI portion of the test application
(venv) $ export DJANGO_EXTENSIONS_DATABASE_NAME="db.sqlite3" # you may change if you want to use any other database
# run migrations
(venv) $ python manage.py migrate
# start the development server
(venv) $ python manage.py runserverTo run tests against a particular python and django version installed inside your virtual environment, you may use:
(venv) $ pytest # `python manage.py test` or `make test` also work
To run tests against all supported python and django versions, you may run:
# install dependency
(venv) $ pip install tox
# run tests
(venv) $ tox