Enum em Python: Enum, StrEnum, IntEnum, Flag e auto

Wed, 22 Jul 2026 00:00:00 +0000

O módulo enum da biblioteca padrão do Python resolve um problema que aparece em todo sistema real: valores finitos com significado de negócio — status de pedido, tipo de documento, permissão, canal de notificação. Em vez de espalhar "pendente", "pago" e "cancelado" como strings mágicas (ou 1, 2, 3 como inteiros opacos), você declara um tipo fechado, legível em stack traces e seguro para o type checker.

Este guia cobre Enum, StrEnum (Python 3.11+), IntEnum, Flag/IntFlag, auto(), iteração, comparação, serialização e o encaixe com dataclasses, Pydantic, FastAPI e pattern matching. Complementa tipagem estática com mypy, boas práticas Python 2026 e o trio funcional da stdlib (collections, itertools, functools). A meta não é listar cada método da API: é saber qual variante usar e onde o enum paga o custo cognitivo.

Enum on Python Brasil — Aprenda Python em Português

Enum em Python: Enum, StrEnum, IntEnum, Flag e auto