oe-python-template 0.3.7__tar.gz → 0.3.9__tar.gz

{oe_python_template-0.3.7 → oe_python_template-0.3.9}/.copier-answers.yml

@@ -1,4 +1,4 @@
-_commit: v0.3.6-1-g660f70c
+_commit: v0.3.8-1-gb8f2dab
 _src_path: .
 author_email: helmuthva@gmail.com
 author_github_username: helmut-hoffer-von-ankershoffen

{oe_python_template-0.3.7 → oe_python_template-0.3.9}/.secrets.baseline

@@ -123,5 +123,5 @@
     }
   ],
   "results": {},
-  "generated_at": "2025-03-11T14:35:48Z"
+  "generated_at": "2025-03-12T20:19:08Z"
 }

{oe_python_template-0.3.7 → oe_python_template-0.3.9}/CHANGELOG.md

@@ -1,6 +1,20 @@
 [🧠 OE Python Template](https://oe-python-template.readthedocs.io/en/latest/)
 
-## [0.3.7](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template/compare/v0.3.6..0.3.7) - 2025-03-11
+## [0.3.9](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template/compare/v0.3.8..0.3.9) - 2025-03-12
+
+### ⛰️  Features
+
+- *(api)* Healthz - ([f6826a0](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template/commit/f6826a02ab0070154056231ec4314da71200623c))
+
+
+## [0.3.8](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template/compare/v0.3.7..v0.3.8) - 2025-03-11
+
+### 📚 Documentation
+
+- Broken link - ([960de47](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template/commit/960de47733a155df00d3e7f271dc1bc20a4089b9))
+
+
+## [0.3.7](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template/compare/v0.3.6..v0.3.7) - 2025-03-11
 
 ### 📚 Documentation
 

{oe_python_template-0.3.7 → oe_python_template-0.3.9}/Dockerfile

@@ -35,5 +35,8 @@ RUN --mount=type=cache,target=/root/.cache/uv \
 
 ENV OE_PYTHON_TEMPLATE_RUNNING_IN_CONTAINER=1
 
+# API will run on port 8000 by default
+EXPOSE 8000/tcp
+
 # But feel free to add arguments and options as needed when doing a docker run
 ENTRYPOINT ["uv", "run", "--no-dev", "oe-python-template"]

{oe_python_template-0.3.7 → oe_python_template-0.3.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: oe-python-template
-Version: 0.3.7
+Version: 0.3.9
 Summary: 🧠 Copier template to scaffold Python projects compliant with best practices and modern tooling.
 Project-URL: Homepage, https://oe-python-template.readthedocs.io/en/latest/
 Project-URL: Documentation, https://oe-python-template.readthedocs.io/en/latest/
@@ -184,7 +184,7 @@ uvx oe-python-template hello-world --help    # help for specific command
 
 * Copier template to scaffold Python projects compliant with best practices and modern tooling.
 * Various Examples:
-  - [Simple Python script]({ github_repository_url_https }/blob/main/examples/script.py)
+  - [Simple Python script](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template/blob/main/examples/script.py)
   - [Streamlit web application](https://oe-python-template.streamlit.app/) deployed on [Streamlit Community Cloud](https://streamlit.io/cloud)
   - [Jupyter](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template/blob/main/examples/notebook.ipynb) and [Marimo](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template/blob/main/examples/notebook.py) notebook
 * [Complete reference documenation](https://oe-python-template.readthedocs.io/en/latest/reference.html) on Read the Docs
@@ -284,8 +284,12 @@ Execute commands:
 
 ```shell
 uvx oe-python-template hello-world
-uvx oe-python-template hello-world --json
-uvx oe-python-template echo "Lorem Ipsum"
+uvx oe-python-template echo --help
+uvx oe-python-template echo "Lorem"
+uvx oe-python-template echo "Lorem" --json
+uvx oe-python-template openapi
+uvx oe-python-template openapi --output-format=json
+uvx oe-python-template serve
 ```
 
 ### Environment
@@ -306,8 +310,12 @@ You can as well run the CLI within Docker.
 ```shell
 docker run helmuthva/oe-python-template --help
 docker run helmuthva/oe-python-template hello-world
-docker run helmuthva/oe-python-template hello-world --json
+docker run helmuthva/oe-python-template echo --help
 docker run helmuthva/oe-python-template echo "Lorem"
+docker run helmuthva/oe-python-template echo "Lorem" --json
+docker run helmuthva/oe-python-template openapi
+docker run helmuthva/oe-python-template openapi --output-format=json
+docker run helmuthva/oe-python-template serve
 ```
 
 Execute command:
@@ -321,8 +329,15 @@ Or use docker compose
 The .env is passed through from the host to the Docker container.
 
 ```shell
-docker compose up
 docker compose run oe-python-template --help
+docker compose run oe-python-template hello-world
+docker compose run oe-python-template echo --help
+docker compose run oe-python-template echo "Lorem"
+docker compose run oe-python-template echo "Lorem" --json
+docker compose run oe-python-template openapi
+docker compose run oe-python-template openapi --output-format=json
+docker compose up
+curl http://127.0.0.1 8000
 ```
 
 ## Extra: Lorem Ipsum

{oe_python_template-0.3.7 → oe_python_template-0.3.9}/README.md

@@ -123,7 +123,7 @@ uvx oe-python-template hello-world --help    # help for specific command
 
 * Copier template to scaffold Python projects compliant with best practices and modern tooling.
 * Various Examples:
-  - [Simple Python script]({ github_repository_url_https }/blob/main/examples/script.py)
+  - [Simple Python script](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template/blob/main/examples/script.py)
   - [Streamlit web application](https://oe-python-template.streamlit.app/) deployed on [Streamlit Community Cloud](https://streamlit.io/cloud)
   - [Jupyter](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template/blob/main/examples/notebook.ipynb) and [Marimo](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template/blob/main/examples/notebook.py) notebook
 * [Complete reference documenation](https://oe-python-template.readthedocs.io/en/latest/reference.html) on Read the Docs
@@ -223,8 +223,12 @@ Execute commands:
 
 ```shell
 uvx oe-python-template hello-world
-uvx oe-python-template hello-world --json
-uvx oe-python-template echo "Lorem Ipsum"
+uvx oe-python-template echo --help
+uvx oe-python-template echo "Lorem"
+uvx oe-python-template echo "Lorem" --json
+uvx oe-python-template openapi
+uvx oe-python-template openapi --output-format=json
+uvx oe-python-template serve
 ```
 
 ### Environment
@@ -245,8 +249,12 @@ You can as well run the CLI within Docker.
 ```shell
 docker run helmuthva/oe-python-template --help
 docker run helmuthva/oe-python-template hello-world
-docker run helmuthva/oe-python-template hello-world --json
+docker run helmuthva/oe-python-template echo --help
 docker run helmuthva/oe-python-template echo "Lorem"
+docker run helmuthva/oe-python-template echo "Lorem" --json
+docker run helmuthva/oe-python-template openapi
+docker run helmuthva/oe-python-template openapi --output-format=json
+docker run helmuthva/oe-python-template serve
 ```
 
 Execute command:
@@ -260,8 +268,15 @@ Or use docker compose
 The .env is passed through from the host to the Docker container.
 
 ```shell
-docker compose up
 docker compose run oe-python-template --help
+docker compose run oe-python-template hello-world
+docker compose run oe-python-template echo --help
+docker compose run oe-python-template echo "Lorem"
+docker compose run oe-python-template echo "Lorem" --json
+docker compose run oe-python-template openapi
+docker compose run oe-python-template openapi --output-format=json
+docker compose up
+curl http://127.0.0.1 8000
 ```
 
 ## Extra: Lorem Ipsum

oe_python_template-0.3.9/RELEASE_NOTES.md

@@ -0,0 +1,8 @@
+## [0.3.9](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template/compare/v0.3.8..v0.3.9) - 2025-03-12
+
+### ⛰️  Features
+
+- *(api)* Healthz - ([f6826a0](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template/commit/f6826a02ab0070154056231ec4314da71200623c))
+
+
+

oe_python_template-0.3.9/VERSION

@@ -0,0 +1 @@
+0.3.9

{oe_python_template-0.3.7 → oe_python_template-0.3.9}/_readme_main.md

@@ -88,7 +88,7 @@ uvx oe-python-template hello-world --help    # help for specific command
 
 * Copier template to scaffold Python projects compliant with best practices and modern tooling.
 * Various Examples:
-  - [Simple Python script]({ github_repository_url_https }/blob/main/examples/script.py)
+  - [Simple Python script](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template/blob/main/examples/script.py)
   - [Streamlit web application](https://oe-python-template.streamlit.app/) deployed on [Streamlit Community Cloud](https://streamlit.io/cloud)
   - [Jupyter](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template/blob/main/examples/notebook.ipynb) and [Marimo](https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template/blob/main/examples/notebook.py) notebook
 * [Complete reference documenation](https://oe-python-template.readthedocs.io/en/latest/reference.html) on Read the Docs
@@ -188,8 +188,12 @@ Execute commands:
 
 ```shell
 uvx oe-python-template hello-world
-uvx oe-python-template hello-world --json
-uvx oe-python-template echo "Lorem Ipsum"
+uvx oe-python-template echo --help
+uvx oe-python-template echo "Lorem"
+uvx oe-python-template echo "Lorem" --json
+uvx oe-python-template openapi
+uvx oe-python-template openapi --output-format=json
+uvx oe-python-template serve
 ```
 
 ### Environment
@@ -210,8 +214,12 @@ You can as well run the CLI within Docker.
 ```shell
 docker run helmuthva/oe-python-template --help
 docker run helmuthva/oe-python-template hello-world
-docker run helmuthva/oe-python-template hello-world --json
+docker run helmuthva/oe-python-template echo --help
 docker run helmuthva/oe-python-template echo "Lorem"
+docker run helmuthva/oe-python-template echo "Lorem" --json
+docker run helmuthva/oe-python-template openapi
+docker run helmuthva/oe-python-template openapi --output-format=json
+docker run helmuthva/oe-python-template serve
 ```
 
 Execute command:
@@ -225,8 +233,15 @@ Or use docker compose
 The .env is passed through from the host to the Docker container.
 
 ```shell
-docker compose up
 docker compose run oe-python-template --help
+docker compose run oe-python-template hello-world
+docker compose run oe-python-template echo --help
+docker compose run oe-python-template echo "Lorem"
+docker compose run oe-python-template echo "Lorem" --json
+docker compose run oe-python-template openapi
+docker compose run oe-python-template openapi --output-format=json
+docker compose up
+curl http://127.0.0.1 8000
 ```
 
 ## Extra: Lorem Ipsum

oe_python_template-0.3.9/compose.yaml

@@ -0,0 +1,35 @@
+services:
+  oe-python-template:
+    build: .
+    env_file:
+      - path: .env
+        required: true
+    develop:
+      watch:
+        - path: src
+          action: rebuild
+    restart: no
+    profiles:
+      - manual
+    tty: true
+    stdin_open: true
+  oe-python-template-api:
+    build: .
+    env_file:
+      - path: .env
+        required: true
+    develop:
+      watch:
+        - path: src
+          action: rebuild
+    command: serve --host=0.0.0.0 --port=8000 --no-reload
+    restart: always
+    ports:
+      - "8000:8000"
+    healthcheck:
+      test: [ "CMD", "curl", "-f", "http://127.0.0.1:8000/healthz" ]
+      interval: 5s
+      timeout: 2s
+      retries: 3
+      start_period: 5s
+      start_interval: 1s

{oe_python_template-0.3.7 → oe_python_template-0.3.9}/docs/source/_static/openapi.json

@@ -11,6 +11,50 @@
     "version": "1.0.0"
   },
   "paths": {
+    "/health": {
+      "get": {
+        "tags": [
+          "Observability"
+        ],
+        "summary": "Health",
+        "description": "Check the health of the service.\n\nThis endpoint returns the health status of the service.\nThe health status can be either UP or DOWN.\nIf the service is healthy, the status will be UP.\nIf the service is unhealthy, the status will be DOWN and a reason will be provided.\nThe response will have a 200 OK status code if the service is healthy,\nand a 500 Internal Server Error status code if the service is unhealthy.\n\nArgs:\n    service (Annotated[Service, Depends): _description_\n    response (Response): _description_\n\nReturns:\n    Health: The health status of the service.",
+        "operationId": "health_health_get",
+        "responses": {
+          "200": {
+            "description": "Successful Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Health"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/healthz": {
+      "get": {
+        "tags": [
+          "Observability"
+        ],
+        "summary": "Health",
+        "description": "Check the health of the service.\n\nThis endpoint returns the health status of the service.\nThe health status can be either UP or DOWN.\nIf the service is healthy, the status will be UP.\nIf the service is unhealthy, the status will be DOWN and a reason will be provided.\nThe response will have a 200 OK status code if the service is healthy,\nand a 500 Internal Server Error status code if the service is unhealthy.\n\nArgs:\n    service (Annotated[Service, Depends): _description_\n    response (Response): _description_\n\nReturns:\n    Health: The health status of the service.",
+        "operationId": "health_healthz_get",
+        "responses": {
+          "200": {
+            "description": "Successful Response",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Health"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/hello-world": {
       "get": {
         "tags": [
@@ -129,6 +173,30 @@
         "type": "object",
         "title": "HTTPValidationError"
       },
+      "Health": {
+        "properties": {
+          "status": {
+            "$ref": "#/components/schemas/_HealthStatus"
+          },
+          "reason": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Reason"
+          }
+        },
+        "type": "object",
+        "required": [
+          "status"
+        ],
+        "title": "Health",
+        "description": "Health status model.\n\nArgs:\n    BaseModel (_type_): _description_"
+      },
       "HelloWorldResponse": {
         "properties": {
           "message": {
@@ -179,6 +247,15 @@
           "type"
         ],
         "title": "ValidationError"
+      },
+      "_HealthStatus": {
+        "type": "string",
+        "enum": [
+          "UP",
+          "DOWN"
+        ],
+        "title": "_HealthStatus",
+        "description": "Health status enumeration.\n\nArgs:\n    StrEnum (_type_): _description_"
       }
     }
   }

{oe_python_template-0.3.7 → oe_python_template-0.3.9}/docs/source/_static/openapi.yaml

@@ -37,6 +37,21 @@ components:
           type: array
       title: HTTPValidationError
       type: object
+    Health:
+      description: "Health status model.\n\nArgs:\n    BaseModel (_type_): 
+_description_"
+      properties:
+        reason:
+          anyOf:
+          - type: string
+          - type: 'null'
+          title: Reason
+        status:
+          $ref: '#/components/schemas/_HealthStatus'
+      required:
+      - status
+      title: Health
+      type: object
     HelloWorldResponse:
       description: Response model for hello-world endpoint.
       properties:
@@ -71,6 +86,14 @@ components:
       - type
       title: ValidationError
       type: object
+    _HealthStatus:
+      description: "Health status enumeration.\n\nArgs:\n    StrEnum (_type_): 
+_description_"
+      enum:
+      - UP
+      - DOWN
+      title: _HealthStatus
+      type: string
 info:
   contact:
     email: helmuthva@gmail.com
@@ -113,6 +136,62 @@ Unprocessable\
       summary: Echo
       tags:
       - Basics
+  /health:
+    get:
+      description: "Check the health of the service.\n\nThis endpoint returns 
+the\
+        \ health status of the service.\nThe health status can be either UP or 
+DOWN.\n\
+        If the service is healthy, the status will be UP.\nIf the service is 
+unhealthy,\
+        \ the status will be DOWN and a reason will be provided.\nThe response 
+will\
+        \ have a 200 OK status code if the service is healthy,\nand a 500 
+Internal\
+        \ Server Error status code if the service is unhealthy.\n\nArgs:\n    
+service\
+        \ (Annotated[Service, Depends): _description_\n    response (Response): 
+_description_\n\
+        \nReturns:\n    Health: The health status of the service."
+      operationId: health_health_get
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Health'
+          description: Successful Response
+      summary: Health
+      tags:
+      - Observability
+  /healthz:
+    get:
+      description: "Check the health of the service.\n\nThis endpoint returns 
+the\
+        \ health status of the service.\nThe health status can be either UP or 
+DOWN.\n\
+        If the service is healthy, the status will be UP.\nIf the service is 
+unhealthy,\
+        \ the status will be DOWN and a reason will be provided.\nThe response 
+will\
+        \ have a 200 OK status code if the service is healthy,\nand a 500 
+Internal\
+        \ Server Error status code if the service is unhealthy.\n\nArgs:\n    
+service\
+        \ (Annotated[Service, Depends): _description_\n    response (Response): 
+_description_\n\
+        \nReturns:\n    Health: The health status of the service."
+      operationId: health_healthz_get
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Health'
+          description: Successful Response
+      summary: Health
+      tags:
+      - Observability
   /hello-world:
     get:
       description: "Return a hello world message.\n\nReturns:\n    

{oe_python_template-0.3.7 → oe_python_template-0.3.9}/docs/source/conf.py

@@ -26,7 +26,7 @@ extensions = [
 project = "oe-python-template"
 author = "Helmut Hoffer von Ankershoffen"
 copyright = f" (c) 2025-{datetime.now(UTC).year}, {author}"  # noqa: A001
-version = "0.3.7"
+version = "0.3.9"
 release = version
 github_username = "helmut-hoffer-von-ankershoffen"
 github_repository = "oe-python-template"

{oe_python_template-0.3.7 → oe_python_template-0.3.9}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "oe-python-template"
-version = "0.3.7"
+version = "0.3.9"
 description = "🧠 Copier template to scaffold Python projects compliant with best practices and modern tooling."
 readme = "README.md"
 authors = [
@@ -244,7 +244,7 @@ source = ["src/"]
 
 
 [tool.bumpversion]
-current_version = "0.3.7"
+current_version = "0.3.9"
 parse = "(?P<major>\\d+)\\.(?P<minor>\\d+)\\.(?P<patch>\\d+)"
 serialize = ["{major}.{minor}.{patch}"]
 search = "{current_version}"

{oe_python_template-0.3.7 → oe_python_template-0.3.9}/sonar-project.properties

@@ -1,6 +1,6 @@
 sonar.projectKey=helmut-hoffer-von-ankershoffen_oe-python-template
 sonar.organization=helmut-hoffer-von-ankershoffen
-sonar.projectVersion=0.3.7
+sonar.projectVersion=0.3.9
 sonar.projectDescription=🧠 Copier template to scaffold Python projects compliant with best practices and modern tooling.
 sonar.links.homepage=https://oe-python-template.readthedocs.io/en/latest/
 sonar.links.scm=https://github.com/helmut-hoffer-von-ankershoffen/oe-python-template

oe_python_template-0.3.9/src/oe_python_template/api.py

@@ -0,0 +1,168 @@
+"""Webservice API of OE Python Template.
+
+This module provides a webservice API with several endpoints:
+- A health/healthz endpoint that returns the health status of the service
+- A hello-world endpoint that returns a greeting message
+- An echo endpoint that echoes back the provided text
+
+The endpoints use Pydantic models for request and response validation.
+"""
+
+from collections.abc import Generator
+from enum import StrEnum
+from typing import Annotated
+
+from fastapi import Depends, FastAPI, Response, status
+from pydantic import BaseModel, Field
+
+from oe_python_template import Service
+
+HELLO_WORLD_EXAMPLE = "Hello, world!"
+
+
+def get_service() -> Generator[Service, None, None]:
+    """Get the service instance.
+
+    Yields:
+        Service: The service instance.
+    """
+    service = Service()
+    try:
+        yield service
+    finally:
+        # Cleanup code if needed
+        pass
+
+
+app = FastAPI(
+    version="1.0.0",
+    title="OE Python Template",
+    contact={
+        "name": "Helmut Hoffer von Ankershoffen",
+        "email": "helmuthva@gmail.com",
+        "url": "https://github.com/helmut-hoffer-von-ankershoffen",
+    },
+    terms_of_service="https://oe-python-template.readthedocs.io/en/latest/",
+)
+
+
+class _HealthStatus(StrEnum):
+    """Health status enumeration.
+
+    Args:
+        StrEnum (_type_): _description_
+    """
+
+    UP = "UP"
+    DOWN = "DOWN"
+
+
+class Health(BaseModel):
+    """Health status model.
+
+    Args:
+        BaseModel (_type_): _description_
+    """
+
+    status: _HealthStatus
+    reason: str | None = None
+
+
+class HealthResponse(BaseModel):
+    """Response model for health endpoint."""
+
+    health: str = Field(
+        ...,
+        description="The hello world message",
+        examples=[HELLO_WORLD_EXAMPLE],
+    )
+
+
+@app.get("/healthz", tags=["Observability"])
+@app.get("/health", tags=["Observability"])
+async def health(service: Annotated[Service, Depends(get_service)], response: Response) -> Health:
+    """Check the health of the service.
+
+    This endpoint returns the health status of the service.
+    The health status can be either UP or DOWN.
+    If the service is healthy, the status will be UP.
+    If the service is unhealthy, the status will be DOWN and a reason will be provided.
+    The response will have a 200 OK status code if the service is healthy,
+    and a 500 Internal Server Error status code if the service is unhealthy.
+
+    Args:
+        service (Annotated[Service, Depends): _description_
+        response (Response): _description_
+
+    Returns:
+        Health: The health status of the service.
+    """
+    if service.healthy():
+        health_result = Health(status=_HealthStatus.UP)
+    else:
+        health_result = Health(status=_HealthStatus.DOWN, reason="Service is unhealthy")
+
+    if health_result.status == _HealthStatus.DOWN:
+        response.status_code = status.HTTP_500_INTERNAL_SERVER_ERROR
+
+    return health_result
+
+
+class HelloWorldResponse(BaseModel):
+    """Response model for hello-world endpoint."""
+
+    message: str = Field(
+        ...,
+        description="The hello world message",
+        examples=[HELLO_WORLD_EXAMPLE],
+    )
+
+
+@app.get("/hello-world", tags=["Basics"])
+async def hello_world() -> HelloWorldResponse:
+    """
+    Return a hello world message.
+
+    Returns:
+        HelloWorldResponse: A response containing the hello world message.
+    """
+    return HelloWorldResponse(message=Service.get_hello_world())
+
+
+class EchoResponse(BaseModel):
+    """Response model for echo endpoint."""
+
+    message: str = Field(
+        ...,
+        min_length=1,
+        description="The message content",
+        examples=[HELLO_WORLD_EXAMPLE],
+    )
+
+
+class EchoRequest(BaseModel):
+    """Request model for echo endpoint."""
+
+    text: str = Field(
+        ...,
+        min_length=1,
+        description="The text to echo back",
+        examples=[HELLO_WORLD_EXAMPLE],
+    )
+
+
+@app.post("/echo", tags=["Basics"])
+async def echo(request: EchoRequest) -> EchoResponse:
+    """
+    Echo back the provided text.
+
+    Args:
+        request (EchoRequest): The request containing the text to echo back.
+
+    Returns:
+        EchoResponse: A response containing the echoed text.
+
+    Raises:
+        422 Unprocessable Entity: If text is not provided or empty.
+    """
+    return EchoResponse(message=request.text)