Initial commit

Author: kumarstack55

.github/workflows/test.yml

@@ -0,0 +1,32 @@
+name: Run Tests
+
+on: [push, pull_request]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v2
+
+      - name: Set up Python
+        uses: actions/setup-python@v2
+        with:
+          python-version-file: ".python-version"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          version: "0.6.5"
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      - name: Minimize uv cache
+        run: uv cache prune --ci
+
+      - name: Sync dependencies
+        run: uv sync --frozen
+
+      - name: Run tests
+        run: uv run pytest tests

.gitignore

@@ -0,0 +1,2 @@
+__pycache__
+.env

.vscode/settings.json

@@ -0,0 +1,5 @@
+{
+    "flake8.args": [
+        "--ignore=E501"
+    ]
+}

README.md

@@ -0,0 +1,62 @@
+# example-backend
+
+## Requirements
+
+- [uv](https://github.com/astral-sh/uv) 0.6.4+
+
+## Installation
+
+```bash
+git clone https://github.com/kumarstack55/example-backend.git
+cd ./example-backend
+uv sync --frozen
+```
+
+## Running Tests
+
+```bash
+pytest tests/test_message_factory.py
+```
+
+## Running the Application
+
+```bash
+uv run app.py
+```
+
+## Running with Modified Error Rates
+
+```bash
+ERROR_SUCCESS_COUNT=0 ERROR_FAILURE_COUNT=100 uv run app.py
+```
+
+## Building the Container Image
+
+```bash
+docker compose build
+```
+
+## Running in a Container
+
+```bash
+docker run -p 8080:8080 example-backend
+```
+
+## Running Tests for Container
+
+At first, start the service.
+
+```bash
+docker compose up -d
+```
+
+Then, run the tests.
+
+```bash
+uv run pytest test_app.py
+```
+
+## License
+
+MIT License.
+See the [LICENSE](LICENSE) file for details.

app.py

@@ -0,0 +1,63 @@
+from aiohttp import web
+import json
+import random
+import os
+import logging
+
+DEFAULT_ERROR_SUCCESS_COUNT = 90
+DEFAULT_ERROR_FAILURE_COUNT = 10
+DEFAULT_PORT = 8080
+
+logging.basicConfig(level=logging.INFO)
+
+_message_factory = None
+
+
+class Message:
+    def __init__(self, message: str, success: bool = True):
+        self._message = message
+        self._success = success
+
+    @property
+    def success(self) -> bool:
+        return self._success
+
+    def to_json(self) -> str:
+        return json.dumps({"message": self._message})
+
+
+class MessageFactory:
+    def __init__(self, success_count: int, error_count: int):
+        self._success_rate: float = success_count / (success_count + error_count)
+
+    def create_message(self) -> Message:
+        if random.random() < self._success_rate:
+            return Message("ok")
+        else:
+            return Message("bad", success=False)
+
+
+async def index_handler(request: web.Request) -> web.Response:
+    message = _message_factory.create_message()
+    if message.success:
+        return web.Response(text=message.to_json(), content_type="application/json")
+    else:
+        return web.Response(text=message.to_json(), content_type="application/json", status=500)
+
+
+def main():
+    global _message_factory
+
+    ERROR_SUCCESS_COUNT = int(os.getenv("ERROR_SUCCESS_COUNT", DEFAULT_ERROR_SUCCESS_COUNT))
+    ERROR_FAILURE_COUNT = int(os.getenv("ERROR_FAILURE_COUNT", DEFAULT_ERROR_FAILURE_COUNT))
+    _message_factory = MessageFactory(ERROR_SUCCESS_COUNT, ERROR_FAILURE_COUNT)
+
+    port = int(os.getenv("PORT", DEFAULT_PORT))
+
+    app = web.Application()
+    app.router.add_get("/", index_handler)
+    web.run_app(app, host="0.0.0.0", port=port)
+
+
+if __name__ == "__main__":
+    main()

container-images/example-backend/Dockerfile

@@ -0,0 +1,25 @@
+FROM python:3.13-slim-bookworm
+
+# The installer requires curl (and certificates) to download the release archive
+RUN apt-get update && apt-get install -y --no-install-recommends curl ca-certificates
+
+# Download the latest installer
+ADD https://astral.sh/uv/install.sh /uv-installer.sh
+
+# Run the installer then remove it
+RUN sh /uv-installer.sh && rm /uv-installer.sh
+
+# Ensure the installed binary is on the `PATH`
+ENV PATH="/root/.local/bin/:$PATH"
+
+# Copy the project into the image
+ADD . /app
+
+# Sync the project into a new environment, using the frozen lockfile
+WORKDIR /app
+
+# Install the dependencies
+RUN uv sync --frozen
+
+# Run the application
+CMD ["uv", "run", "app.py"] 

docker-compose.yml

@@ -0,0 +1,14 @@
+services:
+  backend-service:
+    build:
+      context: .
+      dockerfile: container-images/example-backend/Dockerfile
+    image: example-backend:latest
+    container_name: backend
+    ports:
+      - "8080:8080"
+    healthcheck:
+      test: ["CMD", "curl", "-f", "http://localhost:8080"]
+      interval: 10s
+      timeout: 5s
+      retries: 5

pyproject.toml

@@ -0,0 +1,15 @@
+[project]
+name = "my-backend"
+version = "0.1.0"
+description = "Add your description here"
+readme = "README.md"
+requires-python = ">=3.12"
+dependencies = [
+    "aiohttp[speedups]>=3.11.13",
+]
+
+[dependency-groups]
+dev = [
+    "pytest>=8.3.5",
+    "requests>=2.32.3",
+]

test_app.py

@@ -0,0 +1,7 @@
+import requests
+
+
+def test_container_response():
+    response = requests.get("http://localhost:8080")
+    assert response.status_code == 200 or response.status_code == 500
+    assert response.json()["message"] == "ok" or response.json()["message"] == "bad"