Bug: Examples not appearing in OpenAPI request about litestar

[provinzkraut]

@robswc If you want to create a PR go for it, and if you need feedback/assistance let us know here or on discord!

[JacobCoffee]

I think your MCVE got cut off :) and is missing some imports

[robswc]

That's fair! Here is a app.py I created, I'll also edit the original post.

"""Minimal Litestar application."""
from __future__ import annotations

from asyncio import sleep
from dataclasses import dataclass
from typing import Annotated

from litestar import Litestar, post

__all__ = ("async_hello_world")

from litestar.openapi.spec import Example

from litestar.params import Body


@dataclass
class User:
    """User dataclass."""
    name: str
    age: int


@post("/async")
async def async_hello_world(
        data: Annotated[User, Body(title="test", examples=[Example(value={
            "test": "test"})])]
) -> User:  # noqa:
    # UP006
    """Route Handler that outputs hello world."""
    await sleep(0.1)
    return data


app = Litestar(route_handlers=[async_hello_world])

[provinzkraut]

@robswc Can you describe what output you're expecting and what you're actually getting?

[robswc]

@robswc Can you describe what output you're expecting and what you're actually getting?

Will do!

The image is what I'm getting.

What I'm trying to get is {"test": "test"} to show as an example in swagger. With pydantic/FastAPI I'm able to set json_schema_extra and examples to get those to pull through.

The Body seems to take an examples argument but I'm not sure if I'm using that correctly.

[robswc]

Also, for a bit more context, it looks like arguments passed to Body show on swagger.

Body(title="test", description="this comes through", ...

[guacs]

The reason for this is twofold.

1. We aren't checking if examples are provided for any of the supported complex types i.e. dataclasses, structs or typeddicts. We are also not creating any examples if they have not been provided, but the user has asked to generate them.
2. The examples need to be stored as part of the content-type for them to show for request bodies and not just in the schema as seen here. If providing examples in the schema is enough, then I'm not sure how the schema should be changed (it would be better to check how other frameworks like FastAPI is generating the schema).

[robswc]

Thanks for the detailed reply!

Are there any examples that you're aware of that show how to include examples in the request? Or is that not possible at the moment? I'm still getting familiar with the framework but enjoying it so far!

[guacs]

Unfortunately, I don't think it's possible at the moment.

[robswc]

Do you think it would be worth attempting a PR to add this in? Or would it be better handled by those with more domain knowledge?