book

Padrões de arquitetura com Python

by Harry Percival, Bob Gregory

April 2025

Intermediate to advanced

304 pages

7h 41m

Portuguese (Portugal, Brazil)

O'Reilly Media, Inc.

Book available

Read now

Unlock full access

Gerir a complexidade, resolver problemas empresariaisPorquê Python?TDD, DDD e arquitetura orientada para eventosQuem deve ler este livroUma breve descrição do que vais aprenderParte I, Construir uma arquitetura para apoiar a modelação de domíniosParte II, Arquitetura orientada para eventosConteúdo adicionalExemplo de código e codificaçãoLicençaConvenções utilizadas neste livroAprendizagem em linha da O'ReillyComo contactar a O'ReillyAgradecimentos
Porque é que os nossos projectos dão para o torto?Encapsulamento e abstraçõesCamadasO princípio da inversão de dependênciaUm lugar para toda a nossa lógica empresarial: O modelo de domínio
O que é um modelo de domínio?Explorar a linguagem de domínioTeste unitário de modelos de domínioAs classes de dados são óptimas para objectos de valorObjetos de valor e entidadesNem tudo tem de ser um objeto: Uma função de serviço de domínioOs Métodos Mágicos do Python Permitem-nos Usar os Nossos Modelos com Python IdiomáticoAs excepções também podem exprimir conceitos de domínio
Persistir no nosso modelo de domínioAlgum Pseudocódigo: O que é que vamos precisar?Aplicação da DIP ao acesso aos dadosRelembra-te: O nosso modeloA forma "normal" de ORM: O modelo depende do ORMInvertendo a dependência: ORM depende do modeloApresentando o padrão de repositórioO Repositório na abstraçãoQual é a solução de compromisso?Construir um repositório falso para testes agora é trivial!O que é uma porta e o que é um adaptador, em Python?Resumo
A abstração do estado ajuda a testabilidadeEscolher a(s) abstração(ões) certa(s)Implementar as nossas abstrações escolhidasTeste de borda a borda com falsificações e injeção de dependênciaPorque não remendar?Resumo
Liga a nossa aplicação ao mundo realUm primeiro teste de ponta a pontaA implementação diretaCondições de erro que exigem verificações de banco de dadosApresentando uma camada de serviço e usando FakeRepository para testá-laUma função de serviço típicaPorque é que tudo se chama serviço?Coloca as coisas em pastas para veres onde é que elas pertencemResumoO DIP em ação
Como está a nossa pirâmide de testes?Os testes da camada de domínio devem passar para a camada de serviço?Sobre como decidir que tipo de testes escreverEngrenagem alta e baixaDesacoplar totalmente os testes da camada de serviço do domínioMitigação: Mantém todas as dependências de domínio nas funções de fixaçãoAdicionar um serviço em faltaTransportar a melhoria para os testes E2EResumo
A unidade de trabalho colabora com o repositórioTestando um UoW com testes de integraçãoUnidade de trabalho e o seu gestor de contextoA verdadeira unidade de trabalho utiliza sessões SQLAlchemyUnidade de trabalho falsa para testesUtilizar o UoW na camada de serviçoTestes explícitos para o comportamento de Commit/RollbackCompromissos explícitos versus implícitosExemplos: Usando UoW para agrupar várias operações em uma unidade atômicaExemplo 1: RealocarExemplo 2: Modificar a quantidade do loteTidy os testes de integraçãoResumo
Por que não usar uma folha de cálculo?Invariantes, restrições e consistênciaInvariantes, simultaneidade e bloqueiosO que é um agregado?Escolher um agregadoUm Agregado = Um RepositórioE quanto ao desempenho?Concorrência otimista com números de versãoOpções de implementação para números de versãoTeste das nossas regras de integridade de dadosAplicação de regras de simultaneidade usando níveis de isolamento de transações de banco de dadosExemplo de controlo de simultaneidade pessimista: SELECCIONA PARA ACTUALIZAÇÃOResumoParte I Recapitulação

Evita fazer uma confusãoPrimeiro, vamos evitar fazer uma bagunça com os nossos Web ControllersE também não vamos estragar o nosso modeloOu a camada de serviço!Princípio da responsabilidade únicaTodos a bordo do autocarro da mensagem!O modelo regista eventosOs eventos são classes de dados simplesO modelo levanta eventosO barramento de mensagens mapeia eventos para manipuladoresOpção 1: A camada de serviço obtém eventos do modelo e os coloca no barramento de mensagensOpção 2: A camada de serviço gera seus próprios eventosOpção 3: O UoW publica eventos no barramento de mensagensResumo
Um novo requisito leva-nos a uma nova arquiteturaImagina uma mudança de arquitetura: Tudo será um manipulador de eventosRefatoração de funções de serviço para manipuladores de mensagensO barramento de mensagens agora coleta eventos do UoWOs nossos testes também são escritos em termos de eventosUm hack temporário e feio: o autocarro de mensagens tem de devolver resultadosModificando nossa API para trabalhar com eventosImplementação do nosso novo requisitoO nosso novo eventoTestar um novo manipuladorImplementaçãoUm novo método sobre o modelo de domínioOpcionalmente: Teste unitário de manipuladores de eventos em isolamento com um barramento de mensagens falsoResumoO que é que conseguimos?Porque é que conseguimos?
Comandos e eventosDiferenças no tratamento de excepçõesDiscute: Eventos, comandos e tratamento de errosRecuperação de erros de forma síncronaResumo
Bola de Lama Distribuída, e Pensando em SubstantivosTratamento de erros em sistemas distribuídosA alternativa: Desacoplamento temporal usando mensagens assíncronasUsando um canal Redis Pub/Sub para integraçãoTestando tudo usando um teste de ponta a pontaRedis é outro adaptador fino para o nosso barramento de mensagensO nosso novo evento de saídaEventos internos e externosResumo
Os modelos de domínio são para escreverA maioria dos utilizadores não vai comprar os teus móveisPublicar/Redirecionar/Obter e CQSSegura o teu almoço, pessoalTeste das visualizações do CQRSAlternativa "óbvia" 1: Utilizar o repositório existenteO teu modelo de domínio não está optimizado para operações de leituraAlternativa "óbvia" 2: Utilizar o ORMSELECT N+1 e outras considerações sobre o desempenhoEstá na altura de saltar completamente o tubarãoAtualização de uma tabela de modelo de leitura usando um manipulador de eventosMudar a implementação do nosso modelo de leitura é fácilResumo
Dependências implícitas e explícitasNão achas que as dependências explícitas são totalmente estranhas e Java?Preparação de manipuladores: DI manual com fechos e parciaisUma alternativa com classesUm script BootstrapO barramento de mensagens recebe manipuladores em tempo de execuçãoUsando Bootstrap em nossos EntrypointsInicializando DI em nossos testesConstruir um adaptador "corretamente": Um exemplo práticoDefine as implementações abstrata e concretaCria uma versão falsa para os teus testesDescobre como testar a integração da coisa realResumo
E agora?Como é que chego lá a partir daqui?Separar as responsabilidades emaranhadasIdentificação de agregados e contextos delimitadosUma abordagem orientada a eventos para Go para microsserviços via padrão StranglerConvencer as tuas partes interessadas a experimentar algo novoPerguntas que os nossos revisores técnicos fizeram e que não conseguimos transformar em prosaArmas de péMais leituras obrigatóriasResumo
Env Vars, 12-Fator, e Config, contentores interiores e exterioresConfig.pyDocker-Compose e configuração de contentoresInstalar o teu código fonte como um pacoteDockerfileTestesResumo
Implementação de um repositório e de uma unidade de trabalho para CSVs
Padrão de repositório com DjangoMétodos personalizados nas classes ORM do Django para traduzir de/para o nosso modelo de domínioPadrão de unidade de trabalho com DjangoAPI: Visualizações do Django são adaptadoresPorque é que isto foi tão difícil?O que fazer se já tens o DjangoPassos ao longo do caminho
O que é a validação, afinal?Validação da sintaxeA Lei de Postel e o Padrão de Leitor ToleranteValidação no limiteValidação da semânticaValidação da pragmática

Content preview from Padrões de arquitetura com Python

Capítulo 5. TDD em alta e baixa velocidade

Este trabalho foi traduzido com recurso a IA. Agradecemos o teu feedback e comentários: translation-feedback@oreilly.com

Introduzimos a camada de serviço para capturar algumas das responsabilidades adicionais de orquestração que precisamos de uma aplicação funcional. A camada de serviço ajuda-nos a definir claramente os nossos casos de utilização e o fluxo de trabalho para cada um: o que precisamos de obter dos nossos repositórios, que pré-verificações e validação do estado atual devemos fazer, e o que guardamos no final.

Mas atualmente, muitos dos nossos testes unitários operam em um nível mais baixo, agindo diretamente no modelo. Neste capítulo, discutiremos as soluções de compromisso envolvidas na mudança desses testes para o nível da camada de serviço e algumas diretrizes de teste mais gerais.