1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
|
# Contributing to Django Extensions
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.
## Development
To start development on this project, fork this repository and follow the following instructions.
```bash
# 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 runserver
```
## Testing
To run tests against a particular `python` and `django` version installed inside your virtual environment, you may use:
```bash
(venv) $ pytest # `python manage.py test` or `make test` also work
```
To run tests against all supported `python` and `django` versions, you may run:
```bash
# install dependency
(venv) $ pip install tox
# run tests
(venv) $ tox
```
|
