2017-03-20 07:38:44 +01:00
|
|
|
# Shortcuts for django-helpdesk testing and development using make
|
|
|
|
#
|
|
|
|
# For standard installation of django-helpdesk as a library,
|
|
|
|
# see INSTALL and the documentation in docs/.
|
|
|
|
#
|
|
|
|
# For details about how to develop django-helpdesk,
|
|
|
|
# see CONTRIBUTING.rst.
|
|
|
|
PIP = pip3
|
|
|
|
TOX = tox
|
|
|
|
|
|
|
|
|
|
|
|
#: help - Display callable targets.
|
|
|
|
.PHONY: help
|
|
|
|
help:
|
|
|
|
@echo "django-helpdesk make shortcuts"
|
|
|
|
@echo "Here are available targets:"
|
|
|
|
@egrep -o "^#: (.+)" [Mm]akefile | sed 's/#: /* /'
|
|
|
|
|
|
|
|
|
2017-04-06 02:59:17 +02:00
|
|
|
#: develop - Install minimal development utilities for Python3.
|
2017-03-20 07:38:44 +01:00
|
|
|
.PHONY: develop
|
|
|
|
develop:
|
|
|
|
$(PIP) install -e .
|
|
|
|
|
|
|
|
|
|
|
|
#: clean - Basic cleanup, mostly temporary files.
|
|
|
|
.PHONY: clean
|
|
|
|
clean:
|
|
|
|
find . -name "*.pyc" -delete
|
|
|
|
find . -name '*.pyo' -delete
|
|
|
|
find . -name "__pycache__" -delete
|
|
|
|
|
|
|
|
|
|
|
|
#: distclean - Remove local builds, such as *.egg-info.
|
|
|
|
.PHONY: distclean
|
|
|
|
distclean: clean
|
|
|
|
rm -rf *.egg
|
|
|
|
rm -rf *.egg-info
|
|
|
|
rm -rf demo/*.egg-info
|
2017-12-18 06:31:53 +01:00
|
|
|
rm -rf helpdesk/attachments/
|
2017-03-20 07:38:44 +01:00
|
|
|
# remove the django-created database
|
|
|
|
rm -f demo/demodesk/*.sqlite3
|
|
|
|
|
|
|
|
|
|
|
|
#: maintainer-clean - Remove almost everything that can be re-generated.
|
|
|
|
.PHONY: maintainer-clean
|
|
|
|
maintainer-clean: distclean
|
|
|
|
rm -rf build/
|
|
|
|
rm -rf dist/
|
|
|
|
rm -rf .tox/
|
|
|
|
|
|
|
|
|
|
|
|
#: test - Run test suites.
|
|
|
|
.PHONY: test
|
|
|
|
test:
|
|
|
|
mkdir -p var
|
|
|
|
$(PIP) install -e .[test]
|
|
|
|
$(TOX)
|
2022-09-06 20:41:29 +02:00
|
|
|
rm -rf var
|
2022-09-09 00:31:02 +02:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
#: format - Run the PEP8 formatter.
|
|
|
|
.PHONY: format
|
|
|
|
format:
|
|
|
|
autopep8 --exit-code --global-config .flake8 helpdesk
|
2022-09-09 00:42:20 +02:00
|
|
|
isort --line-length=120 --src helpdesk .
|
2022-09-09 00:31:02 +02:00
|
|
|
|
|
|
|
|
|
|
|
#: checkformat - checks formatting against configured format specifications for the project.
|
|
|
|
.PHONY: checkformat
|
|
|
|
checkformat:
|
|
|
|
flake8 helpdesk --count --show-source --statistics --exit-zero --max-complexity=20
|
2022-09-09 00:42:20 +02:00
|
|
|
isort --line-length=120 --src helpdesk . --check
|
2017-03-20 07:38:44 +01:00
|
|
|
|
|
|
|
|
2017-04-06 02:59:17 +02:00
|
|
|
#: documentation - Build documentation (Sphinx, README, ...).
|
2017-03-20 07:38:44 +01:00
|
|
|
.PHONY: documentation
|
|
|
|
documentation: sphinx readme
|
|
|
|
|
|
|
|
|
|
|
|
#: sphinx - Build Sphinx documentation (docs).
|
|
|
|
.PHONY: sphinx
|
|
|
|
sphinx:
|
|
|
|
$(TOX) -e sphinx
|
|
|
|
|
|
|
|
|
|
|
|
#: readme - Build standalone documentation files (README, CONTRIBUTING...).
|
|
|
|
.PHONY: readme
|
|
|
|
readme:
|
|
|
|
$(TOX) -e readme
|
|
|
|
|
|
|
|
|
|
|
|
#: demo - Setup demo project using Python3.
|
|
|
|
.PHONY: demo
|
|
|
|
demo:
|
2020-07-20 16:20:03 +02:00
|
|
|
# running it with and without --user flag because it started to be problematic for some setups
|
|
|
|
$(PIP) install -e . --user || $(PIP) install -e .
|
|
|
|
$(PIP) install -e demo --user || $(PIP) install -e demo
|
2017-03-20 07:38:44 +01:00
|
|
|
demodesk migrate --noinput
|
|
|
|
# Create superuser; user will be prompted to manually set a password
|
|
|
|
# When you get a prompt, enter a password of your choosing.
|
|
|
|
# We suggest a default of 'Test1234' for the demo project.
|
|
|
|
demodesk createsuperuser --username admin --email helpdesk@example.com
|
|
|
|
# Install fixtures
|
|
|
|
demodesk loaddata emailtemplate.json
|
|
|
|
demodesk loaddata demo.json
|
|
|
|
|
|
|
|
|
2017-04-06 02:59:17 +02:00
|
|
|
#: rundemo - Run demo server using Python3.
|
2017-03-20 07:38:44 +01:00
|
|
|
.PHONY: rundemo
|
|
|
|
rundemo: demo
|
|
|
|
demodesk runserver 8080
|
2021-10-05 12:25:42 +02:00
|
|
|
|
|
|
|
#: migrations - Create Django migrations for this project.
|
|
|
|
.PHONY: migrations
|
|
|
|
migrations: demo
|
|
|
|
demodesk makemigrations
|
2017-03-20 07:38:44 +01:00
|
|
|
|
|
|
|
|
|
|
|
#: release - Tag and push to PyPI.
|
|
|
|
.PHONY: release
|
|
|
|
release:
|
|
|
|
$(TOX) -e release
|