# Tutorial - Guia de Usuário Esse tutorial mostra como usar o **FastAPI** com a maior parte de seus recursos, passo a passo. Cada seção constrói, gradualmente, sobre as anteriores, mas sua estrutura são tópicos separados, para que você possa ir a qualquer um específico e resolver suas necessidades específicas de API. Ele também foi construído para servir como uma referência futura, então você pode voltar e ver exatamente o que você precisa. ## Rode o código Todos os blocos de código podem ser copiados e utilizados diretamente (eles são, na verdade, arquivos Python testados). Para rodar qualquer um dos exemplos, copie o codigo para um arquivo `main.py`, e inicie o `uvivorn` com:
```console $ fastapi dev main.py FastAPI Starting development server 🚀 Searching for package file structure from directories with __init__.py files Importing from /home/user/code/awesomeapp module 🐍 main.py code Importing the FastAPI app object from the module with the following code: from main import app app Using import string: main:app server Server started at http://127.0.0.1:8000 server Documentation at http://127.0.0.1:8000/docs tip Running in development mode, for production use: fastapi run Logs: INFO Will watch for changes in these directories: ['/home/user/code/awesomeapp'] INFO Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit) INFO Started reloader process [383138] using WatchFiles INFO Started server process [383153] INFO Waiting for application startup. INFO Application startup complete. ```
É **ALTAMENTE recomendado** que você escreva ou copie o código, edite-o e rode-o localmente. Usá-lo em seu editor é o que realmente te mostra os benefícios do FastAPI, ver quão pouco código você tem que escrever, todas as conferências de tipo, auto completações etc. --- ## Instale o FastAPI O primeiro passo é instalar o FastAPI. Para o tutorial, você deve querer instalá-lo com todas as dependências e recursos opicionais.
```console $ pip install "fastapi[standard]" ---> 100% ```
/// note | Nota Quando você instala com pip install "fastapi[standard]", ele vem com algumas dependências opcionais padrão. Se você não quiser ter essas dependências opcionais, pode instalar pip install fastapi em vez disso. /// ## Guia Avançado de Usuário Há também um **Guia Avançado de Usuário** que você pode ler após esse **Tutorial - Guia de Usuário**. O **Guia Avançado de Usuário** constrói sobre esse, usa os mesmos conceitos e te ensina alguns recursos extras. Mas você deveria ler primeiro o **Tutorial - Guia de Usuário** (que você está lendo agora). Ele foi projetado para que você possa construir uma aplicação completa com apenas o **Tutorial - Guia de Usuário**, e então estendê-la de diferentes formas, dependendo das suas necessidades, usando algumas ideias adicionais do **Guia Avançado de Usuário**.