<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Izabela Guerreiro on Medium]]></title>
        <description><![CDATA[Stories by Izabela Guerreiro on Medium]]></description>
        <link>https://medium.com/@izaguerreiro?source=rss-af2df0152127------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/2*M5f-VwBkHwD0x3oygA5TrQ.jpeg</url>
            <title>Stories by Izabela Guerreiro on Medium</title>
            <link>https://medium.com/@izaguerreiro?source=rss-af2df0152127------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Thu, 19 Nov 2026 17:16:43 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@izaguerreiro/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[FastAPI: Construindo microsserviços de alta performance]]></title>
            <link>https://medium.com/juntos-somos-mais/fastapi-construindo-microsservi%C3%A7os-de-alta-performance-6f3063e13102?source=rss-af2df0152127------2</link>
            <guid isPermaLink="false">https://medium.com/p/6f3063e13102</guid>
            <category><![CDATA[python]]></category>
            <category><![CDATA[microsserviços]]></category>
            <category><![CDATA[fastapi]]></category>
            <category><![CDATA[assíncrono]]></category>
            <dc:creator><![CDATA[Izabela Guerreiro]]></dc:creator>
            <pubDate>Wed, 23 Sep 2020 01:19:03 GMT</pubDate>
            <atom:updated>2020-09-23T01:19:03.058Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*JFYnncO-bJblPEox-1B0MA.jpeg" /></figure><p>FastAPI é um framework minimalista criado em 2018 por Sebastian Ramirez e mesmo recente tem tido grande adoção pelas empresas, como Netflix, Uber, Microsoft, ViaVarejo, Luiza Labs, Sallve e muitas outras.</p><p>Seus principais recursos são:</p><ul><li><strong>Rápido:</strong> alta performance, equivalente a <strong>NodeJS</strong> e <strong>Go</strong> (graças ao Starlette e Pydantic). [Um dos frameworks mais rápidos disponíveis](<a href="https://fastapi.tiangolo.com/pt/#performance">https://fastapi.tiangolo.com/pt/#performance</a>).</li><li><strong>Rápido para codar:</strong> Aumenta a velocidade para desenvolver recursos entre 200% a 300%.</li><li><strong>Poucos bugs:</strong> Reduz cerca de 40% de erros induzidos por humanos (desenvolvedores).</li><li><strong>Intuitivo:</strong> Grande suporte a _IDEs_. _Auto-Complete_ em todos os lugares. Menos tempo debugando.</li><li><strong>Fácil:</strong> Projetado para ser fácil de aprender e usar. Menos tempo lendo documentação.</li><li><strong>Enxuto:</strong> Minimize duplicação de código. Múltiplos recursos para cada declaração de parâmetro. Menos bugs.</li><li><strong>Robusto:</strong> Tenha código pronto para produção. E com documentação interativa automática.</li><li><strong>Baseado em padrões:</strong> Baseado em (e totalmente compatível com) os padrões abertos para APIs: <a href="https://github.com/OAI/OpenAPI-Specification">OpenAPI</a> (anteriormente conhecido como Swagger) e <a href="http://json-schema.org/">JSON Schema</a>.</li></ul><p>Na 5ª edição do JS+ Tech Talks pude falar um pouco mais sobre o FastAPI e você pode assistir a apresentação no vídeo abaixo:</p><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fwww.youtube.com%2Fembed%2F5IJCNCFoYVw&amp;display_name=YouTube&amp;url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3D5IJCNCFoYVw&amp;image=http%3A%2F%2Fi.ytimg.com%2Fvi%2F5IJCNCFoYVw%2Fhqdefault.jpg&amp;key=a19fcc184b9711e1b4764040d3dc5c07&amp;type=text%2Fhtml&amp;schema=youtube" width="854" height="480" frameborder="0" scrolling="no"><a href="https://medium.com/media/ec8a4e6e1a6fd1caac18b1a1aa315554/href">https://medium.com/media/ec8a4e6e1a6fd1caac18b1a1aa315554/href</a></iframe><h3>Primeiros passos com FastAPI</h3><h4>Instalação</h4><p>Existem duas maneiras de realizar a instalação:<br>A primeira maneira seria instalando os dois separadamente com o comando:</p><pre>$ pip install fastapi <br>$ pip install uvicorn</pre><p>Outra maneira seria usando o parâmetro all, esse parâmetro instala o uvicorn junto.</p><pre>$ pip install fastapi[all]</pre><blockquote><em>Uvicorn é o servidor ASGI utilizado pelo FastAPI, ele é rápido e construído em </em><a href="https://github.com/MagicStack/uvloop"><em>uvloop</em></a><em> e </em><a href="https://github.com/MagicStack/httptools"><em>httptools</em></a><em>. Para mais informações clique </em><a href="https://www.uvicorn.org/"><em>aqui</em></a></blockquote><h4>Hello World</h4><p>Com o FastAPI e Uvicorn instalados podemos fazer nosso <strong><em>Hello World</em></strong>. Para isso vamos criar um arquivo<strong> <em>main.py</em></strong><em>.</em></p><p>Começamos importando a classe <em>FastAPI</em>.</p><pre>from fastapi import FastAPI</pre><blockquote><strong>FastAPI</strong> <em>é uma classe Python que fornece todas as funcionalidades para sua API. Ela herda diretamente de </em><strong>Starlette</strong>.<br><em>Você também pode usar todas as funcionalidades</em> <a href="https://www.starlette.io/">Starlette</a> <em>com FastAPI</em>.</blockquote><p>Com a classe importada, criamos uma instância de FastAPI.</p><pre>app = FastAPI()</pre><p>Por fim, vamos criar nosso endpoint, que vai retornar um Hello World.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/ecc615866ed696a56e8446cae7026553/href">https://medium.com/media/ecc615866ed696a56e8446cae7026553/href</a></iframe><p>O <strong><em>decorator</em></strong> se chama <strong><em>app</em></strong>, porque nossa instância de FastAPI se chama app, caso minha variável de instância tivesse outro nome esse outro nome seria usado aqui no decorator.</p><p>O <strong><em>async def</em></strong> diz que esse será um endpoint assíncrono, caso eu quisesse que ele fosse síncrono bastaria eu remover o termo <strong><em>async</em></strong><em>.</em></p><h4>Rodando a aplicação</h4><p>No terminal vamos rodar o uvicorn (que é o nosso servidor da aplicação).</p><pre>$ uvicorn main:app --reload</pre><p>Vejam que eu usei o nome do meu arquivo e depois o nome da instância do FastAPI, o parâmetro reload é opcional e não deve ser utilizado em produção, ele faz o servidor reiniciar todas as vezes que o arquivo <strong><em>main.py</em></strong><em> </em>for salvo.</p><h4>Documentação automática</h4><p>Um dos recursos do framework é a geração automática da documentação, e eu acho que é uma das coisas mais legais dele.</p><p>Se adicionarmos um <strong><em>/docs</em></strong> ou <strong><em>/redoc</em></strong> como path da nossa url, veremos nossa documentação.</p><p>Acessando<strong> <em>/openapi.json</em></strong> temos o json da documentação.</p><h3>Construindo uma API</h3><blockquote><em>Ao contrário de Django, quando iniciamos um projeto em FastAPI, não temos um estrutura prévia de diretórios, isso é um ponto de atenção na hora de construir sua API, porque sua estrutura pode ficar bem bagunçada se não souber organizar.<br>Na </em><a href="https://fastapi.tiangolo.com/pt/project-generation/"><em>documentação</em></a><em> tem alguns modelos de projeto que você pode utilizar na criação de suas APIs.</em></blockquote><p>O objetivo da nossa API é buscar um endereço de determinado cep na base do ViaCep e salvar essa informação no nosso banco de dados.</p><h3>Bootstrap</h3><h4>Instalação dos pacotes</h4><p>Para essa API vamos precisar dos seguintes pacotes: <strong><em>pymongo</em>, <em>requests</em>, <em>pytest</em>, <em>pytest-asyncio</em> e <em>HTTPX</em></strong>.</p><h4>Estrutura do projeto</h4><pre>+-- app<br>|   +-- __init__.py<br>|   +-- main.py<br>|   +-- schemas.py<br>|   +-- test_main.py<br>+-- bootstrap<br>|   +-- __init__.py<br>|   +-- mongodb.py</pre><p><strong>OBS:</strong> Como o arquivo <strong><em>main.py</em></strong> está dentro da pasta <strong><em>app</em></strong>, para inicializar o servidor uvicorn precisaremos fazer.</p><pre>uvicorn app.main:app --reload</pre><h4>Mongodb</h4><p>Vamos utilizar o mongodb porque é mais simples e nosso foco é o FastAPI, afinal, ele é agnóstico a banco de dados, não depende de nenhum banco para funcionar.</p><p>Para isso criaremos uma pasta chamada <strong><em>bootstrap</em></strong> e dentro dela teremos um arquivo <strong><em>mongodb.py</em></strong>. O conteúdo dele será esse:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/88ee2303f31e19d6a82445012eefa836/href">https://medium.com/media/88ee2303f31e19d6a82445012eefa836/href</a></iframe><h4>API</h4><p>Com o requests instalado e seguindo a estrutura de pastas mencionada acima, em nosso arquivo <strong><em>main.py</em> </strong>vamos criar nosso primeiro endpoint, ele vai receber um cep e buscar no ViaCEP.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/340991dd4d0ea2d5b5ffa9e11b944b9d/href">https://medium.com/media/340991dd4d0ea2d5b5ffa9e11b944b9d/href</a></iframe><p><strong>OBS 1:</strong> Estou usando <strong><em>str</em></strong> para o cep, porque seu eu colocar <strong><em>int</em></strong> ele vai remover o primeiro zero, e isso vai me retornar um erro 400 na API do ViaCep, porque nosso parâmetro terá um caracter a menos.<br><strong>OBS 2:</strong> Você pode acessar <em>localhost:8000/docs</em> para visualizar como sua documentação está ficando.</p><p>Já temos nosso endpoint funcionando e retornando o endereço completo, dado um cep.</p><p>Agora vamos adicionar uma validação no parâmetro, porque sabemos que se recebermos menos de 8 caracteres vamos ter um erro 400 no ViaCep.</p><p>Para isso vamos importar a função <strong><em>Path</em></strong> e também o tipo <strong><em>Any</em></strong>.</p><p><strong><em>Path</em></strong> é um callable, ou seja, é uma função que chama a instância de uma classe de mesmo nome, ele permite adicionar algumas validações ao parâmetro recebido.</p><pre>import requests<br>from typing import Any</pre><pre>from fastapi import FastAPI, Path</pre><p>O <strong><em>Path</em></strong> precisa de um valor default, como não queremos determinar esse valor, vamos utilizar o tipo <strong><em>Any</em></strong>, para evitarmos erros. E vamos usar também o <strong><em>max_length</em></strong> e <strong><em>min_length</em></strong> para determinarmos que nosso parâmetro tenha 8 caracteres.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/126bec818a9031446510b81a2b7cdd14/href">https://medium.com/media/126bec818a9031446510b81a2b7cdd14/href</a></iframe><p>Agora se passarmos um cep com um caracter a menos, vamos receber uma mensagem de erro, dizendo que é preciso 8 caracteres.</p><h4>Salvando o endereço no banco de dados</h4><p>Para salvar o endereço precisaremos criar um <strong><em>schema</em></strong> que vai validar nossos dados, ele terá todos os atribuitos e os tipos dos dados. <br>Em <strong><em>schema.py</em></strong><em> </em>vamos adicionar o seguinte código:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/3abe8f8888ca52d27130d6f8a5762cdd/href">https://medium.com/media/3abe8f8888ca52d27130d6f8a5762cdd/href</a></iframe><p>Feito isso, em <strong><em>main.py</em></strong> vamos importar nosso schema e o nosso client mongo.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/35dd4010dbdb41f1df56985cd4de7095/href">https://medium.com/media/35dd4010dbdb41f1df56985cd4de7095/href</a></iframe><p>Agora criaremos a função que vai salvar um endereço. <em>Utilizaremos essa função em outro endpoint mais a frente.</em></p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/181d221d1acbabf779ed0d011143590f/href">https://medium.com/media/181d221d1acbabf779ed0d011143590f/href</a></iframe><p>Vamos chamar a função no nosso endpoint.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/5974aa901ae6efd2234532ab347418bf/href">https://medium.com/media/5974aa901ae6efd2234532ab347418bf/href</a></iframe><p>Como criamos uma função assíncrona é preciso usar o termo <em>await</em>.</p><blockquote>Em Python uma função assíncrona só pode ser chamada por outra função assíncrona e obrigatóriamente precisa usar o termo <strong>await</strong> antes da função chamada.</blockquote><p>Agora vamos formatar o retorno do nosso endpoint, para isso vamos utilizar o <strong><em>response_model</em></strong>, ele é responsável pela formatação dos dados retornados. Podemos utilizar o mesmo schema dos dados de entrada no banco, mas como quero retornar apenas algumas informações vou criar um novo schema.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/4627c88a75ed065ea412d820e31603c3/href">https://medium.com/media/4627c88a75ed065ea412d820e31603c3/href</a></iframe><p>Com o schema pronto, vamos adicionar o <strong><em>response_model</em></strong> no decorator.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/78e43c25ef609aae7b0deffefe7c5269/href">https://medium.com/media/78e43c25ef609aae7b0deffefe7c5269/href</a></iframe><p>Não queremos ficar batendo na API do ViaCep toda hora, já que estamos salvando o endereço, então vamos adicionar uma validação e caso esse cep não seja encontrado no banco de dados a gente busca no ViaCep.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/7b8bd66e5a850bc5d6454a8620d314c1/href">https://medium.com/media/7b8bd66e5a850bc5d6454a8620d314c1/href</a></iframe><h4>Exceções</h4><p>Caso o usuário insira um cep que não exista, vai estourar uma exceção e podemos dar uma mensagem mais amigável.</p><p>Em <em>main.py</em> vamos criar uma classe <strong><em>CepNotFoundException</em></strong> que será nossa exceção.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/bc4412324a57bf26f33592a95fbbb0c6/href">https://medium.com/media/bc4412324a57bf26f33592a95fbbb0c6/href</a></iframe><p>Uma opção ao uso de <em>try/except</em> é a criação de uma função <strong><em>handler</em></strong>. Você pode saber mais sobre esse tipo de função <a href="https://fastapi.tiangolo.com/tutorial/handling-errors/">aqui</a>.</p><p>Em qualquer parte da API se o erro <strong><em>CepNotFoundException</em></strong> estourar essa função será chamada.</p><p>Ainda em <strong><em>main.py</em></strong> vamos importar o <strong><em>Request</em></strong> e o <strong><em>JSONResponse</em></strong> do FastAPI.</p><pre>import requests<br>from typing import Any</pre><pre>from fastapi import FastAPI, Path, Request<br>from fastapi.responses import JSONResponse</pre><pre>from app import schemas<br>from bootstrap import mongodb</pre><p>Agora vamos criar a nossa função <strong><em>handler.</em></strong></p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/73b8b2f4e0c9918df5975ea0d56321b1/href">https://medium.com/media/73b8b2f4e0c9918df5975ea0d56321b1/href</a></iframe><p>Nossa função vai retornar um 404 e uma mensagem de cep não encontrado.</p><p>O ViaCep retorna uma chave <strong><em>erro</em></strong> no seu response, quando um cep não é encontrado, então vamos validar essa chave.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/758dff24dbdb05b00500f53889bc6dbd/href">https://medium.com/media/758dff24dbdb05b00500f53889bc6dbd/href</a></iframe><p>Vamos criar outro endpoint, para adicionar um endereço sem que seja necessário a utilização de uma API externa.</p><p>Assim como no método <strong><em>get</em></strong>, vamos adicionar o <strong><em>response_model</em></strong> e usar a classe de output, também vamos adicionar o parâmetro <strong><em>status_code</em></strong>, para retornar <strong><em>201</em></strong> quando a requisição tiver sucesso.</p><p>Vamos chamar a função <strong><em>save_address</em></strong> e passar o <strong><em>address.dict()</em></strong>.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/04615a68d6563b4848ef47983deb23ae/href">https://medium.com/media/04615a68d6563b4848ef47983deb23ae/href</a></iframe><p>Foi definido um índice único para o campo cep no arquivo <strong><em>mongodb.py</em></strong>, então é preciso adicionar uma validação para tratar a exceção caso o endpoint receba um valor de cep duplicado.</p><p>Para isso será necessário importar a biblioteca de erros do pymongo e adicionar um <strong><em>try/except</em></strong> que vai validar o <strong><em>DuplicateKeyError</em></strong>.</p><pre>import requests<br>from pymongo import errors<br>from typing import Any, List, Optional</pre><pre>from fastapi import FastAPI, Path, Request<br>from fastapi.responses import JSONResponse</pre><pre>from app import schemas<br>from bootstrap import mongodb</pre><p>Ao contrário do handler que utilizamos no outro endpoint, neste caso utilizaremos somente o JSONResponse, também seria possível criar outra função handler para essa exceção.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/9cb0e562f2e1abab3440df15f1af60df/href">https://medium.com/media/9cb0e562f2e1abab3440df15f1af60df/href</a></iframe><p>Para o endpoint de atualização de endereço vamos fazer basicamente a mesma coisa que já fizemos. Nos outros endpoints passamos o código de status direto no <strong><em>stauts_code</em></strong>, mas também podemos importar a biblioteca status do FastAPI e chamar o status que queremos retornar, isso é bem parecido com o DRF.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/87750477387ec7a42f76020be36e4d81/href">https://medium.com/media/87750477387ec7a42f76020be36e4d81/href</a></iframe><p>Temos um CRUD básico, mas eu quero poder buscar os endereços baseados em um estado e para isso criaremos uma rota <strong><em>/address/</em></strong> que pode receber uma <strong><em>query param</em></strong> que contenha o estado e retorne todos os itens encontrados.</p><p>Primeira coisa, é preciso criar esse endpoint em cima do <strong><em>search_address_by_cep</em></strong>, porque as validações dos <strong><em>paths</em></strong> são feitas de forma sequêncial e como vamos ter dois paths com valores similares, eles precisam estar na ordem correta para não termos problemas.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/8c4f8d714ff4e21db09c7a435d1647b7/href">https://medium.com/media/8c4f8d714ff4e21db09c7a435d1647b7/href</a></iframe><p>Todos os parâmetros passados no endpoint e que não estão no path são considerados <strong><em>query params</em></strong>.</p><p>Assim como utilizamos o <strong><em>Path</em></strong> para validar o parâmetro de <strong><em>search_address_by_cep</em></strong>, também temos a função <strong><em>Query</em></strong> que permite adicionar validações nos parâmetros do <strong><em>query params</em></strong>.</p><p>Ela funciona igual ao <strong><em>Path</em></strong>, recebe um valor padrão e depois as validações a serem adicionadas.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/55b8aeb625672282effa28c1f4b5d25f/href">https://medium.com/media/55b8aeb625672282effa28c1f4b5d25f/href</a></iframe><h3>Vamos testar?</h3><p>Fizemos todos esses endpoints e agora chegou a hora dos testes unitários. Não vou escrever todos os testes possíveis para eles, mas mostrarei como podemos fazer testes unitários em funções assíncronas.</p><blockquote>FastAPI foi construído em cima do Starlatte, e os testes no Starlette são baseados no requests, o que deixa mais familiar e intuitivo.</blockquote><p>Utilizaremos o pytest.</p><p>No arquivo <strong><em>test_main.py</em></strong> importaremos a biblioteca <strong><em>TestClient</em></strong> e instanciaremos ela em uma variável <strong><em>client</em></strong>. Utilizaremos o <strong><em>client</em></strong> da mesma forma que usamos o <strong><em>requests</em></strong>.</p><blockquote><em>Fazer</em> from fastapi.testclient import TestClient <em>é o mesmo que fazer</em> from starlette.testclient import TestClient.</blockquote><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/0ecb15b25577f5e06b3e682bd6889e37/href">https://medium.com/media/0ecb15b25577f5e06b3e682bd6889e37/href</a></iframe><p>O <strong><em>TestClient</em></strong> faz alguma mágica interna para chamar o FastAPI de forma assíncrona em suas funções <strong><em>def</em></strong> de teste normais, usando o pytest padrão. Mas essa mágica não funciona quando a usamos dentro de funções assíncronas. Ao executar nossos testes de forma assíncrona, não podemos mais usar o <strong><em>TestClient</em></strong> dentro de nossas funções de teste.</p><p>Para resolver esse problema vamos precisar de duas bibliotecas outras bibliotecas.</p><p>A primeira será o <strong><em>pytest-syncio</em></strong>, ele permite chamar funções assíncronas em nossos testes, mas nossas funções de teste devem ser assíncronas.</p><p>A outra biblioteca é <strong><em>HTTPX</em></strong>.<br>É um cliente HTTP completo para Python 3, que fornece APIs sync e async e suporte para HTTP 1 e 2.</p><blockquote>Para utilizar HTTPX é preciso ter python 3.8 ou superior instalado. Outro ponto importante é que, segundo a documentação, ela está estável porém ainda está em versão beta, a versão oficial está prevista para sair no final do ano de 2020.</blockquote><p>Vamos importar as bibliotecas no nosso arquivo de testes.</p><pre>import pytest<br>from httpx import AsyncClient</pre><p>Usaremos o decorator <strong><em>@pytest.mark.asyncio</em></strong>, ele informa ao pytest que esta função de teste deve ser chamada de forma assíncrona.</p><p>Vamos criar uma função de teste usando o <strong><em>async def</em></strong>, o <strong><em>AsyncClient</em></strong> cria um cliente <strong><em>HTTP</em></strong> assíncrono, com pool de conexão, HTTP/2, redirecionamentos, persistência de cookies, etc.</p><p>Passaremos os seguintes parâmetros para ele, a instância de FastAPI que é o <strong><em>app</em></strong> e uma url base, que vamos chamar de <strong><em>test</em></strong>, mas poderíamos colocar qualquer coisa. Feito isso vamos chamar ele, como chamamos o <strong><em>TestClient</em></strong> ou <strong><em>requests</em></strong>.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/c1bd52b6445c04645952480aa7d553ea/href">https://medium.com/media/c1bd52b6445c04645952480aa7d553ea/href</a></iframe><p>Também é possível marcar o módulo todo como asssíncrono, usando o <strong><em>pytestmark</em></strong>.</p><pre>pytestmark = pytest.mark.asyncio</pre><p>Esse é o básico sobre testes em FastAPI para saber mais basta acessar a <a href="https://fastapi.tiangolo.com/pt/tutorial/testing/">documentação</a>.</p><h3>Outras coisas interessantes</h3><h4>Parâmetros do decorator</h4><p>Caso o modelo <strong><em>AddressOutput</em></strong> tivesse um atributo com valor default, por exemplo:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/49f4ea835c98bebe183a0ffcd6831425/href">https://medium.com/media/49f4ea835c98bebe183a0ffcd6831425/href</a></iframe><p>Poderíamos definir o parâmetro <strong><em>response_model_exclude_unset</em></strong> como <strong><em>True</em></strong> e os valores default não seriam exibidos no retorno.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/82ff96aa14af283cdf0342e8f7818d1d/href">https://medium.com/media/82ff96aa14af283cdf0342e8f7818d1d/href</a></iframe><p>O FastAPI também tem os parâmetros <strong><em>response_model_exclude</em></strong> e <strong><em>response_model_include</em></strong> eles recebem um <strong><em>set</em></strong> com o valor dos campos que serão incluídos ou excluídos do response, isso é uma medida paleativa para não precisar construir um novo modelo/schema.</p><blockquote>Caso use uma lista ou tupla, o FastAPI vai converter em <strong>set</strong> automaticamente antes de retornar seus dados.</blockquote><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/55682c03859ee63226c4897d889d5cb1/href">https://medium.com/media/55682c03859ee63226c4897d889d5cb1/href</a></iframe><h4>Query param</h4><p>Se um <strong><em>query param</em></strong> receber um valor booleano, ele pode ser True, true, on, 1 ou yes, todos serão convertidos para <strong>True</strong>.</p><h4>Parâmetros do endpoint</h4><p>Os parâmetros não tem ordem para serem declarados, você pode colocar os path params primeiro, por último ou entre os query params, o FastAPI vai entender o que é o que, sem que você precise se preocupar com isso.</p><h4>Mount</h4><p>Caso seja necessário a criação de um outro app, é possível montar ele dentro do app principal, usando o <strong><em>mount</em></strong>, isso vai gerar também uma documentação separada e exclusiva para esse novo app.</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/f35d21d2661724bd6082bceb63eeba3d/href">https://medium.com/media/f35d21d2661724bd6082bceb63eeba3d/href</a></iframe><p>Também é possível colocar em arquivos separados e depois só importar o seu app no arquivo principal.</p><p>FastAPI tem muito mais coisas legais, como Middlewares, Cookies, a injeção de dependências.</p><p>O projeto usado nesse tutorial e na apresentação pode ser encontrado <a href="https://github.com/izaguerreiro/fastapi_techtalk">aqui</a>.</p><p>Os slides da apresentação estão disponíveis no <a href="https://pt.slideshare.net/izabeladossantosguerreiro/fastapi-criando-microsservios-de-alta-performance">SlideShare</a>.</p><p>Espero que tenham gostado! 🙂</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=6f3063e13102" width="1" height="1" alt=""><hr><p><a href="https://medium.com/juntos-somos-mais/fastapi-construindo-microsservi%C3%A7os-de-alta-performance-6f3063e13102">FastAPI: Construindo microsserviços de alta performance</a> was originally published in <a href="https://medium.com/juntos-somos-mais">Juntos Somos Mais</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
    </channel>
</rss>