[vscode] docker support and readme added

Author: cu2

.devcontainer/devcontainer.json

@@ -0,0 +1,25 @@
+{
+    "name": "KT dev environment",
+    "dockerComposeFile": [
+        "../docker/dev/docker-compose.yml",
+        "docker-compose.yml"
+    ],
+    "service": "kt",
+    "workspaceFolder": "/app",
+    "settings": {
+        "python.pythonPath": "/usr/bin/python",
+        "python.linting.pylintEnabled": true,
+        "files.associations": {
+            "**/*.html": "html",
+            "**/templates/**/*.html": "django-html",
+            "**/templates/**/*": "django-txt",
+            "**/requirements{/**,*}.{txt,in}": "pip-requirements"
+        },
+        "terminal.integrated.shell.linux": "/bin/bash"
+    },
+    "postCreateCommand": "apt-get update && apt-get install -y git",
+    "extensions": [
+        "ms-python.python",
+        "batisteo.vscode-django"
+    ]
+}

.devcontainer/docker-compose.yml

@@ -0,0 +1,7 @@
+version: '3.7'
+
+
+services:
+
+  kt:
+    command: sleep infinity

.gitignore

@@ -2,8 +2,9 @@ media/
 .idea/
 *.iml
 bootstrap/
-.vscode/
 db.sqlite3
+.vscode/*
+!.vscode/launch.json
 
 
 ### Template from https://github.com/github/gitignore/blob/master/Python.gitignore

.vscode/launch.json

@@ -0,0 +1,17 @@
+{
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "Run KT",
+            "type": "python",
+            "request": "launch",
+            "program": "${workspaceFolder}/manage.py",
+            "args": [
+                "runserver",
+                "--noreload",
+                "0.0.0.0:8000"
+            ],
+            "django": true
+        }
+    ]
+}

README.md

@@ -58,6 +58,28 @@ If you want to reset your database for any reason, just run:
 ```
 
 
+## How to use Visual Studio Code
+
+Install [Visual Studio Code](https://code.visualstudio.com/download).
+
+Install the [Docker](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-docker) and [Remote - Containers](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) extensions.
+
+Open KT in VSCode: File / Open... / choose the KT folder.
+
+In the Command Palette (press `F1`) choose `Remote-Containers: Reopen in Container`
+
+This will create two Docker containers (one for KT, one for MySQL), if they don't exist already. Now you can:
+
+- navigate the code (dependencies are properly included)
+- run/debug KT from VSCode: Debug / Start Debugging (`F5`)
+
+If you want to stop running KT: Debug / Stop Debugging.
+
+If you want to stop developing: `Remote-Containers: Reopen Locally`. This will stop the containers.
+
+Note: you cannot use `./scripts/start-dev.sh` and `Remote-Containers: Reopen in Container` at the same time. If you try, it will fail because port 8000 on your host machine cannot be forwarded to two different containers. And it might also corrupt your database volume (`kt-db`), because two MySQL server instances will try to use it. If the latter happens, you can reset the database with `./scripts/init-dev-db.sh`.
+
+
 ## Developer guide
 
 If you want to participate, here are some rules and guidelines.