Request response parameters

Dockerfile

@@ -1,13 +1,13 @@
-FROM python:3.12.6
+FROM python:3.12.6-slim
 
-WORKDIR /app
+WORKDIR /root
 
-COPY pyproject.toml poetry.lock /app/
+COPY pyproject.toml poetry.lock /root/
 
 RUN pip install --no-cache-dir poetry==1.8.4 && \
     poetry config virtualenvs.create false && \
     poetry install --no-root --no-dev
 
-COPY . /app
+COPY eq_cir_converter_service eq_cir_converter_service
 
-CMD ["uvicorn", "src.main:app", "--host", "0.0.0.0", "--port", "5010"]
+CMD ["uvicorn", "eq_cir_converter_service.app.main:app", "--host", "0.0.0.0", "--port", "5010"]

Makefile

@@ -28,11 +28,11 @@ lint:  ## Run all linters (black/ruff/pylint/mypy).
 
 .PHONY: test
 test:  ## Run the tests and check coverage.
-	poetry run pytest -n auto --cov=src --cov-report term-missing --cov-fail-under=100
+	poetry run pytest -n auto --cov=eq_cir_converter_service --cov-report term-missing --cov-fail-under=100
 
 .PHONY: mypy
 mypy:  ## Run mypy.
-	poetry run mypy src
+	poetry run mypy -p eq_cir_converter_service
 
 .PHONY: install
 install:  ## Install the dependencies excluding dev.
@@ -51,16 +51,16 @@ megalint:  ## Run the mega-linter.
 
 .PHONY: run
 run:  ## Start the local application.
-	poetry run uvicorn src.main:app --reload --port 5010
+	poetry run uvicorn eq_cir_converter_service.app.main:app --reload --port 5010
 
 .PHONY: docker-build
 docker-build:  ## Build the docker image.
 	docker build -t cir-converter-service .
 
-.PHONY: docker-compose-up
-docker-compose-up:  ## Start the docker container using docker-compose.
-	docker-compose up -d
+.PHONY: docker-run
+docker-run:  ## Run the docker container using the built image.
+	docker run -d -p 5010:5010 --name eq-cir-converter-service cir-converter-service
 
-.PHONY: docker-compose-down
-docker-compose-down:  ## Stop the docker container using docker-compose.
-	docker-compose down
+.PHONY: docker-stop-remove
+docker-stop-remove:  ## Stop and remove the docker container.
+	docker stop eq-cir-converter-service && docker rm eq-cir-converter-service

README.md

@@ -72,7 +72,13 @@ Ensure you have the following installed:
    make install
    ```
 
-3. Run the application
+3. Set the LOG_LEVEL to INFO, DEBUG, WARN, ERROR (If the log level is not set, it will be set to INFO by default.)
+
+    ```bash
+    export LOG_LEVEL=INFO
+    ```
+
+4. Run the application
 
    ```bash
    make run

eq_cir_converter_service/app/config/logging_config.py

@@ -0,0 +1,16 @@
+"""Configure the logging level for the application."""
+
+import logging
+import os
+
+
+def get_log_level() -> int:
+    """Get the logging level from the LOG_LEVEL environment variable, or use the default value of INFO."""
+    log_level = os.environ.get("LOG_LEVEL", "INFO")
+    return int(getattr(logging, log_level, logging.INFO))
+
+
+logging.basicConfig(
+    level=get_log_level(),
+    format="%(asctime)s - %(name)s - %(levelname)s - %(message)s",
+)

eq_cir_converter_service/app/main.py

@@ -0,0 +1,9 @@
+"""This module is the entry point of the FastAPI application."""
+
+import fastapi
+
+from eq_cir_converter_service.app.routers import schema_router
+
+app = fastapi.FastAPI()
+
+app.include_router(schema_router.router)

eq_cir_converter_service/app/routers/schema_router.py

@@ -0,0 +1,42 @@
+"""This module contains the FastAPI router for the schema conversion endpoint."""
+
+from fastapi import APIRouter
+
+from eq_cir_converter_service.app.config.logging_config import logging
+
+router = APIRouter()
+
+logger = logging.getLogger(__name__)
+
+"""The POST endpoint to convert the CIR schema from one version to another."""
+
+
+@router.post(
+    "/schema",
+    response_model=dict,
+)
+async def convert_schema(
+    current_version: str,
+    target_version: str,
+    schema: dict,
+) -> dict:
+    """Convert the CIR schema from one version to another.
+
+    Request query parameters:
+    - current_version: The current version of the schema.
+    - target_version: The target version of the schema.
+
+    Request body:
+    - schema: The schema to convert.
+
+    Returns:
+    - dict: The converted schema.
+    """
+    logger.info("Posting the cir schema...")
+
+    logger.debug("Received current version %s and target version %s", current_version, target_version)
+    logger.debug("Input body: %s", schema)
+
+    # TO DO: Implement the logic to convert the schema from one version to another
+
+    return schema

pyproject.toml

@@ -57,15 +57,10 @@ select = [
 ]
 
 ignore = [
-    # Conflicts with google docstring style
-    "D205",
     # Allow missing docstring, remove to enforce docstrings across the board
-    "D100", "D101", "D102", "D103", "D104", "D105", "D106", "D107",
-    # Disable line length check as it is handled by black
-    # :TODO: Remove E501 when ruff supports all black rules
+    "D104",
+    # Remove E501 when ruff supports all black rules
     "E501",
-    # indentation contains tabs
-    "W191",
 ]
 
 [tool.ruff.lint.pydocstyle]

tests/unit/config/test_logging.py

@@ -0,0 +1,20 @@
+"""Unit tests for logging configuration."""
+
+import logging
+import os
+
+from eq_cir_converter_service.app.config import logging_config
+
+
+def test_get_log_level():
+    """Test that the logging level is set to INFO by default."""
+    os.environ["LOG_LEVEL"] = ""
+    log_level = logging_config.get_log_level()
+    assert log_level == logging.INFO
+
+
+def test_get_log_level_custom():
+    """Test that the logging level is set to DEBUG when the LOG_LEVEL environment variable is set to DEBUG."""
+    os.environ["LOG_LEVEL"] = "DEBUG"
+    log_level = logging_config.get_log_level()
+    assert log_level == logging.DEBUG

tests/unit/conftest.py

@@ -1,8 +1,14 @@
-# import pytest
+"""Configuration for unit tests."""
 
+from collections.abc import Generator
 
-# @pytest.fixture()
-# def calculator():
-#     # Create a new instance of the Calculator class for each test session.
-#     yield Calculator()
-#     # Clean up after the test session is complete.
+import pytest
+from fastapi.testclient import TestClient
+
+import eq_cir_converter_service.app.main as app
+
+
+@pytest.fixture
+def test_client() -> Generator[TestClient, None, None]:
+    """General client for hitting endpoints in tests."""
+    yield TestClient(app.app)

tests/unit/routers/test_schema_router.py

@@ -0,0 +1,16 @@
+"""This module contains the unit tests for the schema router."""
+
+from fastapi import status
+from fastapi.testclient import TestClient
+
+"""Test the schema router with valid JSON."""
+
+
+def test_schema_router_with_valid_json(test_client: TestClient) -> None:
+    """Test the post schema method with valid JSON."""
+    response = test_client.post(
+        "/schema?current_version=1&target_version=2",
+        json={"valid_json": "valid_json"},
+    )
+    assert response.status_code == status.HTTP_200_OK
+    assert response.json()["valid_json"] == "valid_json"