feat: add Docker support with Dockerfile and .dockerignore

Author: Th1ef0

.github/workflows/python-ci.yml

@@ -0,0 +1,80 @@
+name: Python CI
+
+on:
+  [push, pull_request]
+
+permissions:
+  contents: read
+
+jobs:
+
+  test:
+    name: Lint & Tests
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+
+    strategy:
+      fail-fast: true
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Cache pip
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/pip
+          key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements.txt') }}
+          restore-keys: |
+            ${{ runner.os }}-pip-
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+          pip install pytest ruff
+
+      - name: Lint
+        run: ruff check .
+
+      - name: Run tests
+        run: pytest
+
+      - name: Run Snyk
+        uses: snyk/actions/python@master
+        env:
+          SNYK_TOKEN: ${{ secrets.SNYK_TOKEN }}
+        with:
+          command: test
+
+
+  docker:
+    name: Build & Push Docker
+    needs: test
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set version (CalVer)
+        id: version
+        run: |
+          echo "VERSION=$(date +'%Y.%m')" >> $GITHUB_OUTPUT
+
+      - name: Login to Docker Hub
+        uses: docker/login-action@v3
+        with:
+          username: ${{ secrets.DOCKERHUB_USERNAME }}
+          password: ${{ secrets.DOCKERHUB_TOKEN }}
+
+      - name: Build and push
+        uses: docker/build-push-action@v5
+        with:
+          push: true
+          tags: |
+            ${{ secrets.DOCKERHUB_USERNAME }}/app_python:${{ steps.version.outputs.VERSION }}
+            ${{ secrets.DOCKERHUB_USERNAME }}/app_python:latest

app_python/app.py

@@ -2,12 +2,13 @@
 from fastapi import FastAPI
 from fastapi.middleware.cors import CORSMiddleware
 from config import DEBUG, PORT, HOST
-from health_check.router import router
+from routes import health_router, root_router
 from logger_config import setup_logger
 
 setup_logger()
 app = FastAPI(debug=DEBUG)
-app.include_router(router=router)
+for router in [health_router, root_router]:
+    app.include_router(router=router)
 
 app.add_middleware(
     CORSMiddleware,

app_python/docs/LAB01.md

@@ -3,7 +3,7 @@
 I chose FastApi because it's simple, easy to create endpoints, and has automatic documentation.
 
 | Framework   | Pros                                                  | Cons                                        | Reason Not Chosen                 |
-|-------------| ----------------------------------------------------- | ------------------------------------------- | --------------------------------- |
+|-------------|-------------------------------------------------------|---------------------------------------------|-----------------------------------|
 | **FastAPI** | Async support, type safety, OpenAPI, high performance | Slight learning curve                       | **Chosen**                        |
 | Flask       | Simple, minimal                                       | No async by default, no built-in validation | Less suitable for structured APIs |
 | Django      | Full-featured, mature                                 | Heavy, overkill for small service           | Too complex for this task         |
@@ -12,46 +12,45 @@ I chose FastApi because it's simple, easy to create endpoints, and has automatic
 
 1. Environment-based Configuration
 
-    ```python
-    HOST = os.getenv("HOST", "0.0.0.0")
-    PORT = int(os.getenv("PORT", 5000))
-    DEBUG = os.getenv("DEBUG", "False").lower() == "true"
-    ```
-    
-    it important because it enables configuration without code changes.
+ ```text
+ HOST = os.getenv("HOST", "0.0.0.0")
+ PORT = int(os.getenv("PORT", 5000))
+ DEBUG = os.getenv("DEBUG", "False").lower() == "true"
+ ```
+
+it important because it enables configuration without code changes.
 
 2. Separation of Concerns
 
-   ```python
-      class HealthCheckService:
-       async def get_info(self, request: Request) -> InfoResponse:
-           ...
-   
-   ```
-   
-   it important because it easier testing, cleaner routing layer
+```text
+   class HealthCheckService:
+      async def get_info(self, request: Request) -> InfoResponse:
+         pass
+```
+
+it important because it easier testing, cleaner routing layer
 
 3. Typed Responses with Pydantic
 
-   ```python
-   class InfoResponse(BaseModel):
-       service: ServiceInfo
-       system: SystemInfo
-       runtime: RuntimeInfo
-       request: RequestInfo
-       endpoints: list[EndpointInfo]
-   ```
-   
-   it important because guarantees response structure and improves readability
+```text
+class InfoResponse(BaseModel):
+    service: ServiceInfo
+    system: SystemInfo
+    runtime: RuntimeInfo
+    request: RequestInfo
+    endpoints: list[EndpointInfo]
+```
+
+it important because guarantees response structure and improves readability
 
 4. Logging
 
-   ```python
-   logger = logging.getLogger(__name__)
-   logger.info("Handling info request")
-   ```
-   
-   it important because it centralized observability and works seamlessly with Uvicorn
+```text
+logger = logging.getLogger(__name__)
+logger.info("Handling info request")
+```
+
+it important because it centralized observability and works seamlessly with Uvicorn
 
 ## API Documentation
 
@@ -111,21 +110,21 @@ I chose FastApi because it's simple, easy to create endpoints, and has automatic
      "uptime_seconds": 7390
    }
    ```
-   
+
 3. Testing Commands
 
    Using curl:
    ```bash
    curl http://localhost:5000/
    curl http://localhost:5000/health
    ```
-   
+
    or auto generated documentation:
-   
+
    ```bash
    http://localhost:5000/docs
    ```
-   
+
 ## Testing Evidence
 
 - Successful responses from `/` and `/health`

app_python/health_check/router.py

@@ -1,3 +1,4 @@
 uvicorn==0.40.0
 pydantic==2.12.5
-fastapi==0.128.0
+fastapi==0.128.0
+pytest==9.0.2

app_python/health_check/service.py

@@ -0,0 +1,4 @@
+from .health_check.router import router as health_router
+from .root.router import router as root_router
+
+__all__ = ["root_router", "health_router"]

app_python/requirements.txt

@@ -0,0 +1,9 @@
+from fastapi import APIRouter
+from routes.health_check.schemas import HealthResponse
+from routes.health_check.service import HealthCheckServiceDep
+
+router = APIRouter()
+
+@router.get("/health", description="Health check")
+async def health_check(service: HealthCheckServiceDep) -> HealthResponse:
+    return await service.health_check()

app_python/routes/__init__.py

@@ -0,0 +1,7 @@
+from pydantic import BaseModel
+from datetime import datetime
+
+class HealthResponse(BaseModel):
+    status: str
+    timestamp: datetime
+    uptime_seconds: int