🚀 Module: Django Hello World Translation Service

Technology Stack:

• Python

---

🎯 Scenario

This project recreates the FastAPI translation sample using Django. It exposes a single endpoint that returns a localized greeting with an ISO-8601 timestamp appended.

---

Prerequisites

• Python 3.10 or newer
• pip

---

🐾 Guided Walkthrough

1. Installation - Create a virtual environment and install the development dependencies:

python -m venv .venv
source .venv/bin/activate
pip install -r requirements-dev.txt

2. Running the Tests

python -m pytest

3. Starting the Service

python manage.py runserver

The server listens on port 8080 by default. Override the PORT environment variable if needed.

4. HTTP Endpoint

• GET / – Responds with a greeting string such as hello world @ 2024-06-01T12:34:56+00:00.
• GET /eggs – 🥚 See below.

5. Configuration Environment variables provide the same configurability as the FastAPI version:

• TRANSLATION_DEFAULT_LANGUAGE (default: EN) – Two-letter code used to choose the greeting.
• TRANSLATION_FILE (default: translations.json) – File located in the resources/ directory that contains the greeting map.
• PORT (default: 8080) – Port for the HTTP server.

All translations are stored in resources/translations.json, copied verbatim from the FastAPI project.

---

🥚 Easter Eggs!

• Find the easter egg riddle, steps below:

Start the service first with the 3. Start development server task, then ask it for the riddle at /eggs.

Leave the server task running and open a second terminal (Terminal > New Terminal). That terminal runs in the same container as the server, so localhost works here:

curl http://localhost:8080/eggs

• 🥚 Find the four translation easter eggs

"The translation file holds 85 greetings, but the service knows a few it never wrote down. Pirates can read them."

You will know you found it when the service hands you a trophy. 🏆

House rules: reading app/easter_eggs.py is cheating (and it is encoded anyway). The response headers, however, are fair game. 🐣