django-server-controller

Django server controllers, e.g. UwsgiController.

Install

pip install django-server-controller

Django Command Help

C:\Workspace\my_django_project>python manage.py wsgi-server --help
Usage: manage.py wsgi-server [OPTIONS] COMMAND [ARGS]...

Options:
  --version                      Show the version and exit.
  -h, --help                     Show this message and exit.
  -v, --verbosity INTEGER RANGE  Verbosity level; 0=minimal output, 1=normal
                                 output, 2=verbose output, 3=very verbose
                                 output.

  --settings SETTINGS            The Python path to a settings module, e.g.
                                 "myproject.settings.main". If this is not
                                 provided, the DJANGO_SETTINGS_MODULE
                                 environment variable will be used.

  --pythonpath PYTHONPATH        A directory to add to the Python path, e.g.
                                 "/home/djangoprojects/myproject".

  --traceback / --no-traceback   Raise on CommandError exceptions.
  --color / --no-color           Enable or disable output colorization.
                                 Default is to autodetect the best behavior.


Commands:
  reload   Reload uwsgi server.
  restart  Restart uwsgi server.
  start    Start uwsgi server.
  status   Get uwsgi server's status.
  stop     Stop uwsgi server.

Usage

pro/settings.py

INSTALLED_APPS = [
    ...
    'django_server_controller',
    ...
]

UWSGI_PROJECT_BASE = xxx
UWSGI_WEB_ROOT = xxx
UWSGI_LOGS_ROOT = xxx
UWSGI_PIDFILE = xxx
UWSGI_INI_FILE = xxx
UWSGI_BIN = xxx

• Add django_server_controller into INSTALLED_APPS, so that we can use it's django-management-commands.
• You can add server settings in django's settings.py. If not provide, the default values are used.
• UWSGI_PROJECT_BASE defaults to current directory. Suggest you set this variable.
• UWSGI_INI_FILE search orders:
  1. settings.UWSGI_INI_FILE pointed file.
  2. settings.UWSGI_PROJECT_BASE + "./etc/wsgi.ini"
  3. ./etc/wsgi.ini
  4. ~/etc/wsgi.ini
  5. python-lib-root/lib/python3.6/site-packages/the_project_package/wsgi.ini

Chrooted to PROJECT_BASE before find wsgi.ini

Suggest project folders

./bin/
./etc/
./lib/
./lib64/
./web/
./web/static/
./web/upload/
./logs/

• suggest you use virtualenv.
• bin/lib/lib64 folders are created by virutalenv.
• etc/web/logs folders are ours.

Releases

v0.2.1 2020/09/03

• Add django-click in requriements.txt.
• Change uwsgi_ini_file search order, and uwsgi_bin search order.
• Update document.

v0.2.0 2020/09/02

• Use as django's command.

v0.1.3 2020/07/25

• Fix time import problem.

v0.1.2 2020/07/25

• Fix reload parameter problem.

v0.1.1 2020/07/25

• Fix psutil import problem.

v0.1.0 2020/07/25

• First release.