\#6 Apply api versioning and enhance folder structure

.flake8

@@ -40,7 +40,13 @@ ignore =
   WPS473,
   ; Found too many arguments
   WPS211,
-
+  ; Found local folder import
+  WPS300,
+  ; multiple statements on one line (colon)
+  E701,
+  ; Found incorrect node inside `class` body
+  WPS604,
+
 per-file-ignores =
   ; all tests
   test_*.py,tests.py,tests_*.py,*/tests/*,conftest.py:

app/main.py

@@ -1,11 +1,11 @@
 from fastapi import FastAPI
 
-from app.routers import dummy
+from app.v1.routers import router as v1_router
 
 
 app = FastAPI()
 
-app.include_router(dummy.router)
+app.include_router(v1_router)
 
 
 @app.get("/ping")

app/v1/routers/__init__.py

@@ -0,0 +1,4 @@
+from .base import router
+
+
+__all__ = ("router",)

app/v1/routers/base.py

@@ -0,0 +1,7 @@
+from fastapi import APIRouter
+
+from .dummy import router as dummy_router
+
+
+router = APIRouter(prefix="/v1")
+router.include_router(dummy_router, prefix="/dummy", tags=["Dummy"])

app/v1/routers/dummy.py

@@ -0,0 +1,11 @@
+from fastapi import APIRouter
+
+from app.v1.serializers import dummy as dummy_serializer
+
+
+router = APIRouter()
+
+
+@router.post("/capitalize", response_model=dummy_serializer.CapitalizeOut)
+async def capitalize(request: dummy_serializer.CapitalizeIn) -> dict[str, str]:
+    return {"text": request.text.upper()}

app/v1/serializers/dummy.py

@@ -0,0 +1,11 @@
+from pydantic import BaseModel
+
+
+class BaseCapitalize(BaseModel):
+    text: str
+
+
+class CapitalizeIn(BaseCapitalize): ...
+
+
+class CapitalizeOut(BaseCapitalize): ...

tests/test_main.py

@@ -1,5 +1,6 @@
 from fastapi.testclient import TestClient
 
+
 def test_ping_endpoint(client: TestClient) -> None:
     response = client.get("/ping")
     assert response.status_code == 200

tests/routers/test_dummy.py → tests/v1/routers/test_dummy.py

@@ -2,6 +2,6 @@
 
 
 def test_capitalize_endpoint(client: TestClient) -> None:
-    response = client.post("/dummy/capitalize", json={"text": "hello"})
+    response = client.post("/v1/dummy/capitalize", json={"text": "hello"})
     assert response.status_code == 200
     assert response.json() == {"text": "HELLO"}