Pensar em legibilidade vai além de ter simplesmente um código "bonitinho", é otimizar uma análise e entendimento e principalmente a evolução dele. Trabalhando em um piloto de automação de testes de software percebemos na pele a importância de seguir boas práticas de escrita de código e como construções ruins oneravam nosso entendimento na análise\refactoring desses testes. A ideia é trazer dicas de boas práticas que deixarão seu código mais claro e efetivo, baseado no aprendizado que tivemos com pontos que "dificultavam nossa vida". Ps: Palestra apresentada na Trilha Design de Código no TDC Florianópolis

2. Legibilidade
de código não é perfumaria

3. Alessandra Kajihara
e Ariane Izac

4. CONTEXTO
● Piloto de Automação de Testes
● Objetivo: Evoluir a qualidade e cobertura de testes
● Maiores Dificuldades
○ Legibilidade do código
○ Construções complexas
○ Propósito do teste
○ Asserts que não validam o propósito ou
ausência de asserts

5. E o que é legibilidade?

6. LEGIBILIDADE
● Facilidade de leitura e entendimento
● Bem estruturado/formatado
● Minimizar margem para falsos positivos
● Fácil manutenção

7. “Decifrar menos. Criar mais”

8. CALMA! Juramos que têm código!

9. 1. Nome do teste
● Precisa ser
○ Claro e auto-explicativo
○ Coerente com o assert do teste
● Padrões normalmente utilizado no Java
○ Camelcase

10. ● Métodos muito grandes
○ Tornam-se complexos
○ Dificultam entendimento
● Reuso de código
○ Encapsulamento
2. Atenção com
Métodos

14. ???

18. ● Definição de domínios
● Facilita a escrita e leitura dos testes
● Enum próprio para o teste
3. Uso de Enums

19. 4. Data Driven Testing
○ O que é Data Driven?
■ Testes orientados a dados
■ Uso de matrizes (tabela-verdade)
○ Quando utilizar
■ Vários testes com o mesmo fluxo e
dados diferentes de entrada e/ou saída
○ Como?

24. 5. Uso de DSL
● O que é DSL?
○ Domain Specific Language: Linguagem de
domínio específico
○ Pequenas Linguagens - Resolve um problema
específico
○ Camada de abstração
● Tipos de DSL
○ DSL Interna: Utiliza linguagem host
○ DSL Externa: Utiliza uma outranova
linguagem para atender o domínio

25. ● Quando utilizar?
○ Casos complexos
○ Casos com muito reuso de código
● Como utilizar?
○ Linguagem de negócio
○ Encapsulamento do método
● Vantagens
○ Facilita o entendimento do código - Intuitivo
○ Aumenta a produtividade - manutenção
5. Uso de DSL

28. Estrutura DSL

29. E pra fechar...
● Legibilidade não é perfumaria
● Facilita entendimento
● Facilita a manutenção
● Deixa seu código limpo
● Adotar padrões ou diretrizes
○ Linguagem
○ Time (Empresa)

30. “Test code is just as
important as production
code…”
Robert C. Martin - Clean Code

31. Analista de Testes
Há 7 anos
Alessandra Kajihara
Matera Systems
Há 5 anos
CONTATOS
Linkedin: Alessandra Kajihara Email: sahkaji@gmail.com

32. Analista de Testes
Há 12 anos
Ariane Izac
Matera Systems
Há 7 anos
Blogueira
Grupo no LinkedIN
Diário de uma Paixão:
Teste de Software
CONTATOS
Linkedin: Ariane Izac Email: afizac@gmail.com Twitter: @arianizac

33. [1] https://www.guj.com.br/t/legibilidade-de-codigo/61896/6
[2]
https://medium.com/equals-lab/tem-um-tempinho-para-conversarmos-sobre-boas-pr%C3%A1ticas
-de-programa%C3%A7%C3%A3o-com-java-51c5bcc220ea
[3] https://pt.slideshare.net/FelipeVolpone/legibilidade-do-cdigo
[4] https://www.alura.com.br/curso-online-refatorando-na-pratica-com-java
[5] https://google.github.io/styleguide/javaguide.html
REFERÊNCIAS

34. REFERÊNCIAS
[6] https://www.infoq.com/br/presentations/arquiteturas-profissionais-javaee
[7] https://www.martinfowler.com/bliki/DslQandA.html
[8] https://www.devmedia.com.br/convencoes-de-codigo-java/23871
[9] http://www.eliasnogueira.com/parametrizacao-de-dados-para-automacao-de-teste/