Document how to run MonkeyType

.gitignore

@@ -6,3 +6,4 @@ dpaste/static/
 dpaste.egg-info
 dpaste.sqlite
 node_modules
+monkeytype.sqlite3

Makefile

@@ -13,7 +13,7 @@ endef
 .PHONY: test
 test: ## Run Django tests
 	rm -f .coverage
-	docker-compose run --rm app monkeytype run /usr/local/bin/pytest dpaste/
+	docker-compose run --rm app /usr/local/bin/pytest dpaste/
 
 .PHONY: code-cleanup
 code-cleanup: ## Black and isort the Python codebase

docker-compose.yml

@@ -25,6 +25,7 @@ services:
         BUILD_EXTRAS: dev
     image: app
     environment:
+      DJANGO_SETTINGS_MODULE: dpaste.settings.local
       STATIC_ROOT: /collectstatic
       DATABASE_URL: sqlite:////db/dpaste.sqlite
       PORT: 8000

docs/testing.rst

@@ -45,5 +45,23 @@ Then simply call it from the project directory.
     py36-django-20: commands succeeded
     congratulations :)
 
+Type Annotation
+===============
+
+Type annotation can be added automatically using MonkeyType_.
+
+.. code-block:: bash
+
+    # Generate the database
+    docker-compose run --rm app monkeytype -c dpaste.monkeytype:config run /usr/local/bin/pytest dpaste/
+
+    # List available modules
+    docker-compose run --rm app monkeytype -c dpaste.monkeytype:config list-modules
+
+    # Apply them one by one.
+    docker-compose run --rm app monkeytype -c dpaste.monkeytype:config stub <module-name> --ignore-existing-annotations
+    docker-compose run --rm app monkeytype -c dpaste.monkeytype:config apply <module-name> --ignore-existing-annotations
+
 .. _Travis: https://travis-ci.org/bartTC/dpaste
 .. _tox: http://tox.readthedocs.org/en/latest/
+.. _MonkeyType: https://monkeytype.readthedocs.io/en/stable/