from pydantic import BaseModel

app = FastAPI()


class Item(BaseModel):
    name: str
    price: float
    is_offer: Union[bool, None] = None


@app.get("/")
def read_root():
    return {"Hello": "World"}


@app.get("/items/{item_id}")
def read_item(item_id: int, q: Union[str, None] = None):
    return {"item_id": item_id, "q": q}


@app.put("/items/{item_id}")

{!../../docs_src/python_types/tutorial009.py!}
```

`str` yerine `Optional[str]` kullanmak editorün bu değerin her zaman `str` tipinde değil bazen `None` tipinde de olabileceğini belirtir ve hataları tespit etmemizde yardımcı olur.

#### Generic tipler

Köşeli parantez içinde tip parametreleri alan bu türler, örneğin:

* `List`
* `Tuple`
* `Set`
* `Dict`
* `Optional`
* ...and others.

    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());

      public void write(char[] cbuf, int off, int len) throws IOException {
        super.write(cbuf, off, len);
        flush();
      }

      @Override
      public void write(String str, int off, int len) throws IOException {
        super.write(str, off, len);
        flush();
      }
    };
  }

        String str = result.toString();
        assertNotNull(str);
        assertTrue(str.contains("SearchResult"));
        assertTrue(str.contains("documentList="));
        assertTrue(str.contains("allRecordCount=100"));
        assertTrue(str.contains("allRecordCountRelation=eq"));
        assertTrue(str.contains("queryTime=50"));
        assertTrue(str.contains("partialResults=true"));

/// check | 확인

**FastAPI**는 `item_id`가 경로 매개변수이고 `q`는 경로 매개변수가 아닌 쿼리 매개변수라는 것을 알 정도로 충분히 똑똑합니다.

///

/// note | 참고

FastAPI는 `q`가 `= None`이므로 선택적이라는 것을 인지합니다.

`Union[str, None]`에 있는 `Union`은 FastAPI(FastAPI는 `str` 부분만 사용합니다)가 사용하는게 아니지만, `Union[str, None]`은 편집기에게 코드에서 오류를 찾아낼 수 있게 도와줍니다.

///

## 쿼리 매개변수 형변환

`bool` 형으로 선언할 수도 있고, 아래처럼 변환됩니다:

{* ../../docs_src/query_params/tutorial003.py hl[9] *}

```Python hl_lines="1  4"
{!../../docs_src/python_types/tutorial009.py!}
```

O uso de `Optional[str]` em vez de apenas `str` permitirá que o editor o ajude a detectar erros, onde você pode estar assumindo que um valor é sempre um `str`, quando na verdade também pode ser `None`.

`Optional[Something]` é na verdade um atalho para `Union[Something, None]`, eles são equivalentes.

Isso também significa que no Python 3.10, você pode utilizar `Something | None`:

    public void test_additionalCoverage() {
        int a = 5;
        int b = 10;
        int sum = a + b;
        assertEquals(15, sum);

        String str = "Hello";
        assertTrue(str.startsWith("H"));
        assertTrue(str.endsWith("o"));
        assertEquals(5, str.length());
    }

    public void test_additionalCoverage() {
        int a = 5;
        int b = 10;
        int sum = a + b;
        assertEquals(15, sum);

        String str = "Hello";
        assertTrue(str.startsWith("H"));
        assertTrue(str.endsWith("o"));
        assertEquals(5, str.length());
    }

    public void test_additionalCoverage() {
        int a = 5;
        int b = 10;
        int sum = a + b;
        assertEquals(15, sum);

        String str = "Hello";
        assertTrue(str.startsWith("H"));
        assertTrue(str.endsWith("o"));
        assertEquals(5, str.length());
    }