Contextvars on Python Dev BR https://python.dev.br/tags/contextvars/ Recent content in Contextvars on Python Dev BR Hugo pt-br Fri, 18 Sep 2026 01:15:15 +0000 contextvars em Python: estado por requisição em async e threads https://python.dev.br/blog/python-contextvars-estado-por-requisicao/ Fri, 18 Sep 2026 01:15:00 +0000 https://python.dev.br/blog/python-contextvars-estado-por-requisicao/ <p>Um problema clássico em APIs Python: você quer que cada log, métrica e consulta ao banco carregue o <strong>request ID</strong>, o <strong>tenant</strong> ou o <strong>usuário logado</strong> da requisição atual — sem empilhar esses argumentos em todas as funções. A resposta curta é: use <strong><code>contextvars.ContextVar</code></strong> da biblioteca padrão. É o mecanismo que o próprio <a href="https://python.dev.br/blog/python-async-await/">asyncio</a> usa para isolar estado por task, funciona junto com <a href="https://python.dev.br/blog/apis-rest-com-fastapi/">FastAPI</a> e também com <a href="https://python.dev.br/blog/python-threading-threadpoolexecutor/">threads</a>, e substitui tanto variáveis globais quanto <code>threading.local</code>.</p>