oe-python-template-example 0.0.7__py3-none-any.whl → 0.0.8__py3-none-any.whl

oe_python_template_example/api.py

@@ -0,0 +1,87 @@
+"""FastAPI application with REST API endpoints.
+
+This module provides a FastAPI application with several endpoints:
+- 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 fastapi import FastAPI
+from pydantic import BaseModel, Field
+
+from oe_python_template_example import Service
+
+HELLO_WORLD_EXAMPLE = "Hello, world!"
+
+
+app = FastAPI(
+    version="1.0.0",
+    title="OE Python Template Example",
+    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-example.readthedocs.io/en/latest/",
+)
+
+
+class HelloWorldResponse(BaseModel):
+    """Response model for hello-world endpoint."""
+
+    message: str = Field(
+        ...,
+        description="The hello world message",
+        examples=[HELLO_WORLD_EXAMPLE],
+    )
+
+
+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.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())
+
+
+@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)

oe_python_template_example/cli.py

@@ -3,9 +3,12 @@
 from typing import Annotated
 
 import typer
+import uvicorn
+import yaml
 from rich.console import Console
 
 from oe_python_template_example import Service, __version__
+from oe_python_template_example.api import app as api
 
 console = Console()
 
@@ -37,6 +40,36 @@ def hello_world() -> None:
     console.print(Service.get_hello_world())
 
 
+@cli.command()
+def serve(
+    host: Annotated[str, typer.Option(help="Host to bind the server to")] = "127.0.0.1",
+    port: Annotated[int, typer.Option(help="Port to bind the server to")] = 8000,
+    reload: Annotated[bool, typer.Option(help="Enable auto-reload")] = True,
+) -> None:
+    """Start the API server."""
+    console.print(f"Starting API server at http://{host}:{port}")
+    uvicorn.run(
+        "oe_python_template_example.api:app",
+        host=host,
+        port=port,
+        reload=reload,
+    )
+
+
+@cli.command()
+def openapi(
+    output_format: Annotated[
+        str, typer.Option(help="Output format (yaml or json), defaults to yaml", case_sensitive=False)
+    ] = "yaml",
+) -> None:
+    """Dump the OpenAPI specification to stdout (YAML by default)."""
+    schema = api.openapi()
+    if output_format.lower() == "json":
+        console.print_json(data=schema)
+    else:
+        console.print(yaml.dump(schema, default_flow_style=False), end="")
+
+
 def _apply_cli_settings(cli: typer.Typer, epilog: str) -> None:
     """Add epilog to all typers in the tree and configure default behavior."""
     cli.info.epilog = epilog

{oe_python_template_example-0.0.7.dist-info → oe_python_template_example-0.0.8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: oe-python-template-example
-Version: 0.0.7
+Version: 0.0.8
 Summary: 🧠 Example project scaffolded and kept up to date with OE Python Template (oe-python-template).
 Project-URL: Homepage, https://oe-python-template-example.readthedocs.io/en/latest/
 Project-URL: Documentation, https://oe-python-template-example.readthedocs.io/en/latest/
@@ -48,6 +48,7 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Typing :: Typed
 Requires-Python: <4.0,>=3.11
+Requires-Dist: fastapi[all,standard]>=0.115.11
 Requires-Dist: pydantic>=2.10.6
 Requires-Dist: python-dotenv>=1.0.1
 Requires-Dist: typer>=0.15.1
@@ -127,7 +128,7 @@ copier copy gh:helmut-hoffer-von-ankershoffen/oe-python-template .
 Step 4: Setup the local environment
 
 ```shell
-uv run nox -s setup_eev
+uv run nox -s setup_dev
 ```
 
 Step 5: Perform inital commit and push
@@ -174,8 +175,8 @@ uvx oe-python-template-example
 The CLI provides extensive help:
 
 ```shell
-uvx oe-python-template-example --help              # all CLI commands
-uvx oe-python-template-example command --help      # all options for command
+uvx oe-python-template-example --help                # all CLI commands
+uvx oe-python-template-example hello-world --help    # help for specific command
 ```
 
 

oe_python_template_example-0.0.8.dist-info/RECORD

@@ -0,0 +1,10 @@
+oe_python_template_example/__init__.py,sha256=-sCwS9lD6CvgWw88f7snBDF947PWIhEupJVebXL_w1M,314
+oe_python_template_example/api.py,sha256=3OmZFB_5bVdHS6wcGttfgiOmq86K5R6lXOzvTPXIQ94,2203
+oe_python_template_example/cli.py,sha256=ptgFKScjYQAj364TCBqs23rVZqIpXUxUXEoc_4f1YJE,2399
+oe_python_template_example/constants.py,sha256=6uQHr2CRgzWQWhUQCRRKiPuFhzKB2iblZk3dIRQ5dDc,358
+oe_python_template_example/service.py,sha256=ZpsZFnnJm_3EqoVqGomfAyIjLVmWJFuJ3G9qatWj5yI,516
+oe_python_template_example-0.0.8.dist-info/METADATA,sha256=E5qbQjBSvgDTEqxceoqIYvOMjekUwGc3LRUXYWEmxI4,20031
+oe_python_template_example-0.0.8.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+oe_python_template_example-0.0.8.dist-info/entry_points.txt,sha256=S2eCPB45b1Wgj_GsDRFAN-e4h7dBA5UPxT8od98erDE,82
+oe_python_template_example-0.0.8.dist-info/licenses/LICENSE,sha256=5H409K6xzz9U5eUaoAHQExNkoWJRlU0LEj6wL2QJ34s,1113
+oe_python_template_example-0.0.8.dist-info/RECORD,,

oe_python_template_example-0.0.7.dist-info/RECORD

@@ -1,9 +0,0 @@
-oe_python_template_example/__init__.py,sha256=-sCwS9lD6CvgWw88f7snBDF947PWIhEupJVebXL_w1M,314
-oe_python_template_example/cli.py,sha256=6giUEesoEuwytZnthiTBH9-ALkiwdkTL4TEb7vsqbGM,1351
-oe_python_template_example/constants.py,sha256=6uQHr2CRgzWQWhUQCRRKiPuFhzKB2iblZk3dIRQ5dDc,358
-oe_python_template_example/service.py,sha256=ZpsZFnnJm_3EqoVqGomfAyIjLVmWJFuJ3G9qatWj5yI,516
-oe_python_template_example-0.0.7.dist-info/METADATA,sha256=2zKINPEf3Z6IjOkP_gYtBt6WwAwXineL8JtCFExWnxQ,19978
-oe_python_template_example-0.0.7.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-oe_python_template_example-0.0.7.dist-info/entry_points.txt,sha256=S2eCPB45b1Wgj_GsDRFAN-e4h7dBA5UPxT8od98erDE,82
-oe_python_template_example-0.0.7.dist-info/licenses/LICENSE,sha256=5H409K6xzz9U5eUaoAHQExNkoWJRlU0LEj6wL2QJ34s,1113
-oe_python_template_example-0.0.7.dist-info/RECORD,,