@contextmanager em Python: with, contextlib e Exemplos

Tue, 10 Feb 2026 00:00:00 +0000

Um context manager em Python controla a entrada e a saída de um bloco with, garantindo que arquivos, conexões, transações, locks e outros recursos sejam liberados mesmo quando ocorre uma exceção. Para criar um rapidamente, use @contextmanager, do módulo contextlib, em uma função geradora: prepare o recurso antes do yield e faça o cleanup em um bloco finally depois dele.

from contextlib import contextmanager

@contextmanager
def recurso():
    item = abrir_recurso()
    try:
        yield item
    finally:
        item.close()

with recurso() as item:
    item.processar()

Esse padrão é a versão reutilizável de um try/finally. Quando o objeto tem estado e comportamento mais complexos, implemente __enter__ e __exit__ em uma classe. Para operações assíncronas, use @asynccontextmanager com async with.

Contextlib on Python Dev BR

@contextmanager em Python: with, contextlib e Exemplos