mirror of
https://github.com/fastapi/fastapi.git
synced 2025-12-25 07:08:11 -05:00
ca437cdfab
* 📝 Add docs recommending Union over Optional * 📝 Update docs recommending Union over Optional * 📝 Update source examples for docs, recommend Union over Optional * 📝 Update highlighted lines with updated source examples * 📝 Update highlighted lines in Markdown with recent code changes * 📝 Update docs, use Union instead of Optional * ♻️ Update source examples to recommend Union over Optional * 🎨 Update highlighted code in Markdown after moving from Optional to Union
29 lines
681 B
Python
29 lines
681 B
Python
from typing import Set, Union
|
|
|
|
from fastapi import FastAPI
|
|
from pydantic import BaseModel
|
|
|
|
app = FastAPI()
|
|
|
|
|
|
class Item(BaseModel):
|
|
name: str
|
|
description: Union[str, None] = None
|
|
price: float
|
|
tax: Union[float, None] = None
|
|
tags: Set[str] = set()
|
|
|
|
|
|
@app.post("/items/", response_model=Item, summary="Create an item")
|
|
async def create_item(item: Item):
|
|
"""
|
|
Create an item with all the information:
|
|
|
|
- **name**: each item must have a name
|
|
- **description**: a long description
|
|
- **price**: required
|
|
- **tax**: if the item doesn't have tax, you can omit this
|
|
- **tags**: a set of unique tag strings for this item
|
|
"""
|
|
return item
|