from fastapi import FastAPI
from pydantic import BaseModel

app = FastAPI()


class Item(BaseModel):
    name: str
    description: str | None = None
    price: float
    tax: float | None = None
    tags: set[str] = set()


@app.post("/items/", summary="Create an item")
async def create_item(item: Item) -> Item:
    """
    Create an item with all the information:

    - **name**: each item must have a name

     */
    @Test
    void toStringIncludesClassName() {
        TransWaitNamedPipeResponse resp = new TransWaitNamedPipeResponse();
        String str = resp.toString();
        assertNotNull(str, "toString should not return null");
        assertTrue(str.startsWith("TransWaitNamedPipeResponse["), "toString should begin with class name");
    }

    /**

        final String str = info.toString();
        assertNotNull(str);
    }

    @Test
    public void test_crawlingInfoParam_toString() {
        final CrawlingInfoParam param = new CrawlingInfoParam();
        param.setId("param-id");
        param.setKey("test-key");
        param.setValue("test-value");

        final String str = param.toString();
        assertNotNull(str);
    }

{* ../../docs_src/security/tutorial002_an_py310.py hl[25] *}

## Отримати користувача { #get-the-user }

`get_current_user` використає (фальшиву) утилітну функцію, яку ми створили, що приймає `token` як `str` і повертає нашу Pydantic-модель `User`:

        // When
        String str = exception.toString();

        // Then
        assertNotNull(str);
        assertTrue(str.contains("SmbOperationException"));
        assertTrue(str.contains("ACCESS_DENIED"));
        assertTrue(str.contains("AUTHENTICATION"));
        assertTrue(str.contains("retryable=false"));
        assertTrue(str.contains("attempt=1"));

## `Union` または `Optional` の利用 { #using-union-or-optional }

何らかの理由で `|` が使えない場合、たとえば型アノテーションではなく `response_model=` のような場所では、縦棒（`|`）の代わりに `typing` の `Union` を使えます。

例えば、`str` または `None` になり得ることを宣言できます:

```python
from typing import Union


def say_hi(name: Union[str, None]):
        print(f"Hi {name}!")
```

`typing` には、`None` を取り得ることを宣言するための短縮形として `Optional` もあります。

ここからは私のとても主観的な提案です:

따라서 `datetime` 객체는 [ISO 형식](https://en.wikipedia.org/wiki/ISO_8601)의 데이터를 포함하는 `str`로 변환되어야 합니다.

같은 방식으로 이 데이터베이스는 Pydantic 모델(속성이 있는 객체)을 받지 않고, `dict`만을 받습니다.

이를 위해 `jsonable_encoder`를 사용할 수 있습니다.

Pydantic 모델 같은 객체를 받고 JSON 호환 가능한 버전을 반환합니다:

{* ../../docs_src/encoder/tutorial001_py310.py hl[4,21] *}

이 예시에서는 Pydantic 모델을 `dict`로, `datetime`을 `str`로 변환합니다.

app = FastAPI()

items = {"foo": {"name": "Fighters", "size": 6}, "bar": {"name": "Tenders", "size": 3}}


@app.put("/items/{item_id}")
async def upsert_item(
    item_id: str,
    name: Annotated[str | None, Body()] = None,
    size: Annotated[int | None, Body()] = None,
):
    if item_id in items:
        item = items[item_id]
        item["name"] = name
        item["size"] = size

    AtomicInteger deliveries = new AtomicInteger();
    EventBus bus = new EventBus();
    bus.register(
        new Object() {
          @Subscribe
          public void accept(String str) {
            holder.set(str);
            deliveries.incrementAndGet();
          }
        });

    String EVENT = "Hello!";
    bus.post(EVENT);

    assertEquals("Only one event should be delivered.", 1, deliveries.get());

    if not user:
        raise HTTPException(status_code=403, detail="Not authorized")


def generate_stream(query: str):
    for ch in query:
        yield ch
        time.sleep(0.1)


@app.get("/generate", dependencies=[Depends(get_user)])
def generate(query: str):