Add development docker w/ postgres

README.md

@@ -4,3 +4,17 @@ Just A Cool Online Ballot-Box
 ## Requirements
 
 - Python 3.11
+
+## Docker for development
+
+You can use docker and avoid any setup. Just run:
+
+```
+docker-compose -f dev.yaml build
+docker-compose -f dev.yaml up
+```
+
+which will spin up the Flask application (http://localhost:5000), a Postgres instance, and an Adminer instance to poke at the database (http://localhost:5001).   
+Any changes to the `app/` folder will be immediately reflected inside the Flask container.  
+To wipe the database, delete the `jacob_dev_db_data` volume.  
+By default, webservers are only visible to localhost.  

app/Dockerfile

@@ -0,0 +1,8 @@
+FROM python:3.11
+
+WORKDIR /app
+COPY requirements.txt .
+RUN pip install -r requirements.txt
+COPY . .
+
+CMD ["python", "app.py"]

app.py → app/app.py

@@ -15,4 +15,11 @@ def about():
 import admin
 
 if __name__ == '__main__':
-    app.run()
+    import os
+
+    if os.environ.get('PRODUCTION'):
+        raise Exception("Can't run interactively in PRODUCTION")
+
+    app.run(host=os.environ.get('FLASK_HOST', '127.0.0.1'), 
+            port=os.environ.get('FLASK_PORT', 5000), 
+            debug=os.environ.get('FLASK_DEBUG', True))

dev.yaml

@@ -0,0 +1,36 @@
+version: '3.8'
+
+services:
+  # Flask app
+  app:
+    build: ./app/
+    ports:
+      - 127.0.0.1:5000:5000
+    volumes:
+    - type: bind # For development, we pass through the existing files for ez reload
+      source: app/
+      target: /app/
+    depends_on:
+      - db
+    environment:
+      - FLASK_HOST=0.0.0.0
+
+  # Postgres DB
+  db:
+    image: postgres
+    volumes:
+      - dev_db_data:/var/lib/postgresql/data
+    environment:
+      - POSTGRES_PASSWORD=dev
+    expose:
+      - 5432 # visible to other containers only
+
+  # Admin panel for Postgres DB - DEVELOPMENT ONLY
+  # Use login credentials postgres/dev
+  adminer:
+    image: adminer
+    ports:
+      - 127.0.0.1:5001:8080
+
+volumes:
+  dev_db_data: