[#51] Fixed testapp (see README for instructions)

.gitignore

@@ -26,3 +26,5 @@ mail_editor.egg-info
 coverage\.xml
 
 junit\.xml
+
+testapp/mail_editor.db

README.rst

@@ -161,13 +161,13 @@ You can set template variables to all of the mail templates in the following fas
 
 .. code:: python
 
-# static dictionary
-MAIL_EDITOR_BASE_CONTEXT = {
-    'url': 'http://www.maykinmedia.nl',
-}
+    # static dictionary
+    MAIL_EDITOR_BASE_CONTEXT = {
+        'url': 'http://www.maykinmedia.nl',
+    }
 
-# import path to callable that returns a dictionary
-MAIL_EDITOR_DYNAMIC_CONTEXT = "dotted.path.to.callable"
+    # import path to callable that returns a dictionary
+    MAIL_EDITOR_DYNAMIC_CONTEXT = "dotted.path.to.callable"
 
 
 Installation
@@ -180,6 +180,29 @@ Install with pip:
     pip install mail_editor
 
 
+Local development
+-----------------
+
+To install and develop the library locally, use::
+
+.. code-block:: bash
+
+    pip install -e .[tests,coverage,docs,release]
+
+When running management commands via ``django-admin``, make sure to add the root
+directory to the python path (or use ``python -m django <command>``):
+
+.. code-block:: bash
+
+    export PYTHONPATH=. DJANGO_SETTINGS_MODULE=testapp.settings
+    django-admin check
+    # or other commands like:
+    django-admin migrate
+    django-admin createsuperuser
+    django-admin runserver
+    # django-admin makemessages -l nl
+
+
 .. _Django Yubin: https://github.com/APSL/django-yubin
 .. _Sergei Maertens: https://github.com/sergei-maertens
 .. _langerak-gkv: https://github.com/sergei-maertens/langerak-gkv/blob/master/src/langerak_gkv/mailing/mail_template.py

fix.sh

@@ -8,3 +8,7 @@ isort --profile black ./tests
 autoflake --in-place --remove-all-unused-imports -r ./tests
 black ./tests
 
+
+isort --profile black ./testapp
+autoflake --in-place --remove-all-unused-imports -r ./testapp
+black ./testapp

pyproject.toml

@@ -79,7 +79,7 @@ sections=["FUTURE", "STDLIB", "DJANGO", "THIRDPARTY", "FIRSTPARTY", "LOCALFOLDER
 
 [tool.pytest.ini_options]
 testpaths = ["tests"]
-DJANGO_SETTINGS_MODULE = "tests.settings"
+DJANGO_SETTINGS_MODULE = "testapp.settings"
 
 [tool.bumpversion]
 current_version = "0.3.5"

tests/settings.py → testapp/settings.py

@@ -4,11 +4,15 @@
 
 SECRET_KEY = "supersekrit"
 
+USE_TZ = True
+
+DEBUG = True
+
 DATABASES = {
     "default": {
         # Memory resident database, for easy testing.
         "ENGINE": "django.db.backends.sqlite3",
-        "NAME": ":memory:",
+        "NAME": os.path.join(DJANGO_PROJECT_DIR, "mail_editor.db"),
     }
 }
 
@@ -20,11 +24,12 @@
     "django.contrib.admin",
     "mail_editor",
     "ckeditor",
+    "testapp",
 ]
 
 EMAIL_BACKEND = "django.core.mail.backends.dummy.EmailBackend"
 
-ROOT_URLCONF = "tests.urls"
+ROOT_URLCONF = "testapp.urls"
 
 MIDDLEWARE = [
     "django.middleware.security.SecurityMiddleware",
@@ -77,7 +82,6 @@
     "models.W042",  # AutoField warning not relevant for tests
 ]
 
-
 STATICFILES_DIRS = [
     os.path.join(DJANGO_PROJECT_DIR, "static"),
     os.path.join(DJANGO_PROJECT_DIR, "static_alternative"),
@@ -90,6 +94,6 @@
     "django.contrib.staticfiles.finders.AppDirectoriesFinder",
 ]
 STATIC_URL = "/static/"
-STATIC_ROOT = os.path.join(os.path.dirname(__file__), "static")
+STATIC_ROOT = os.path.join(DJANGO_PROJECT_DIR, "static")
 MEDIA_URL = "/media/"
-MEDIA_ROOT = os.path.join(os.path.dirname(__file__), "media")
+MEDIA_ROOT = os.path.join(DJANGO_PROJECT_DIR, "media")

tox.ini

@@ -19,7 +19,7 @@ DJANGO =
 
 [testenv]
 setenv =
-    DJANGO_SETTINGS_MODULE=tests.settings
+    DJANGO_SETTINGS_MODULE=testapp.settings
     PYTHONPATH={toxinidir}
 extras =
     tests