Design Patterns em Zig — Padrões de Projeto em Português

Bem-vindo à coleção de design patterns (padrões de projeto) implementados na linguagem Zig, totalmente em português brasileiro. Zig oferece recursos únicos como comptime, alocadores explícitos e error unions que transformam a maneira como padrões clássicos são implementados.

Por que Padrões de Projeto em Zig?

Muitos padrões clássicos da OOP (Gang of Four) ganham formas diferentes em Zig por causa de suas características únicas:

• Comptime substitui muito do que seria feito com herança e polimorfismo dinâmico
• Alocadores explícitos tornam padrões de gerenciamento de memória mais controlados
• Error unions substituem exceções e tornam o fluxo de erro explícito
• Sem herança — composição e interfaces via comptime são os mecanismos preferidos

Padrões Criacionais

• Singleton — Garantir instância única com acesso global controlado
• Factory — Criar objetos sem expor a lógica de criação
• Builder — Construir objetos complexos passo a passo
• Pool de Objetos — Reutilizar objetos pré-alocados para evitar alocações frequentes
• Arena Pattern — Alocação em bloco com liberação coletiva

Padrões Estruturais

• Adapter — Adaptar interfaces incompatíveis para trabalharem juntas
• Decorator — Adicionar comportamento a objetos sem alterar sua estrutura
• Facade — Simplificar uma interface complexa com uma fachada simples
• Flyweight — Compartilhar estado para suportar muitos objetos eficientemente
• Type Erasure — Apagar informação de tipo para interfaces genéricas em runtime

Padrões Comportamentais

• Observer — Notificar múltiplos objetos sobre mudanças de estado
• Strategy — Definir família de algoritmos intercambiáveis
• Iterator — Acessar elementos sequencialmente sem expor representação interna
• State Machine — Gerenciar transições de estado de forma estruturada
• Command — Encapsular requisições como objetos para undo/redo e filas
• Pipeline — Processar dados em estágios sequenciais composíveis

Padrões de Concorrência e Resiliência

• Producer-Consumer — Desacoplar produção e consumo de dados com buffer
• Circuit Breaker — Proteger contra falhas em cascata com disjuntor
• Retry Pattern — Retentar operações falhas com backoff inteligente
• Dependency Injection — Injetar dependências para testabilidade e flexibilidade

Como Usar

Cada página de padrão inclui:

1. Explicação do padrão e quando usar
2. Implementação completa em Zig com código funcional
3. Exemplo de uso prático
4. Quando usar e quando evitar — trade-offs e alternativas
5. Links para recursos relacionados

Recursos Complementares

• Cheatsheets Zig — Referência rápida da linguagem
• Tutoriais — Aprender Zig do zero
• Receitas — Exemplos práticos de código
• FAQ — Perguntas frequentes
• Troubleshooting — Resolver problemas comuns

Contribua

Conhece um padrão que não está aqui? Tem uma implementação melhor? Contribuições da comunidade Zig Brasil são sempre bem-vindas!