O documento discute a importância de Clean Code, refatoração e TDD para melhorar a qualidade do código e a satisfação profissional dos desenvolvedores. Ele aborda como a falta de organização e compreensão do código pode impactar negativamente uma empresa, enfatizando que escrever código limpo é uma prática necessária e a refatoração é um investimento valioso. Além disso, apresenta as dificuldades que os desenvolvedores enfrentam em manter a qualidade e as leis do TDD para um desenvolvimento eficaz.

1. Vamos falar de Clean
Code, Refatoração e
TDD mais uma vez
Domingos Teruel
Zend Certified Engineer

3. Domingos Teruel
Zend Certified Engineer PHP 5.3
Tecnólogo em Processamento de dados e
Gestão da Tecnologia da Informação,
especialista em interfaces de sistemas,
atuando no desenvolvimento e
implementação de sistemas web com
software livre e Governo Eletrônico.

5. Sobre o que vamos falar?

6. Profissionalismo e felicidade

8. Insatisfação com o fracasso

10. Existe diferença?

11. Insatisfação no trabalho

12. Você se sente profissional?

13. Você se sente profissional?

14. Você se sente profissional?

15. Poderia ser mais produtivo?

16. Sensação de impotência

17. Se sente um peão de obra, trabalho braçal
Se sente um peão de obra, trabalho braçal
e desgastante!
e desgastante!

18. Qual a diferença entre cansaço e

19. Já teve aquele
sentimento de largar
tudo?

20. O que mais motiva um
desenvolvedor?

21. “Quem trabalha apenas pelo
salário, ganhe o que for, será
sempre mal pago.”
(Autor desconhecido)

24. “Qual é a sua obra?
obra
Quando você se for, o
vai restar?”
(Mario Cortella)

25. Afinal, quanto custa a
Afinal, quanto custa a
bagunça para a empresa?
bagunça para a empresa?

26. Alta rotatividade

27. Demora no lançamento de novas
Demora no lançamento de novas
funcionalidades
funcionalidades

28. Dificuldade na hora de realizar
qualquer modificação...

29. Alta incidência de bugs?

30. Quanto custa a falta deconfiança do
seu cliente?

31. Quanto tempo você perde tentando
Quanto tempo você perde tentando
entender o código para corrigir um
entender o código para corrigir um
bug?
bug?

32. Conclusão: Passamos a maior parte
Conclusão: Passamos a maior parte
do tempo lendo o código!
do tempo lendo o código!

33. Evolução da Produtividade

34. Clean code, o que é?

36. Você teria medo de tomar o
remédio?

37. Código feito com
cuidado

38. Que revela
intenção

39. simples

40. Fácil de entender

41. “Qualquer tolo consegue
escrever código que um
computador entenda.
Bons programadores escrevem
código que humanos possam
entender.”
(Martin Fowler)

42. Funcionar é o
mínimo que se
espera.

43. Qualidade Externa x Interna

44. Qualidade externa é aquela
que você percebe logo de
cara. Se ausabilidade da
interface
for
ruim,
aperformance for sofrível e
defeitos acontecem com
frequência, a pessoa logo
percebe e sequer compra o
software.

45. Qualidade interna é aquela que você
só
percebe
com
o
tempo.
Infelizmente o comercial não vende
esse tipo de qualidade. Noentanto, é
ela que atrasa o negócio e mata a
empresa aos poucos, sufoca e
aumenta os custos. É ela que gera
custos
boa parte da rotatividade.

46. Como medir a qualidade do
código?

47. • Linhas de código?
• Número de métodos?
•
Número de classes?
•
Linhas de código por método?
•
Complexidade ciclomática?
•
Número de estruturas de decisão?
?

49. WTF

50. WTF
WTF

51. WTF
WTF
WTF

52. dificuldade de entender

53. nivel máximo de sujeira

54. Debate: Até que ponto vale apena
continuar mantendo um projeto
vivo?

55. Falar é fácil

56. O desafio é criar código de
qualidade!

57. No entanto, falar é o primeiro passo rumo a
No entanto, falar é o primeiro passo rumo a
melhoria!
melhoria!

58. Quatro estágios
necessários para
adquirir novos
hábitos

59. Estágio 1
“Inconsciente e sem
habilidade”
Ignoramos o
comportamento e o
hábito

60. Estágio 2
“Consciente e sem
habilidade”
Conhecemos o
comportamento mas
ainda não temos o
hábito de aplicá-lo”

61. Estágio 3
“Consciente e
habilidoso”
Nos sentimos confortáveis
com pela prática que vamos
adquirindo com o tempo

62. Estágio 4
“Inconsciente e
habilidoso”
O hábito se torna uma coisa
natural

63. Escrever código limpo requer muita
Escrever código limpo requer muita
prática e habilidade!
prática e habilidade!

64. Començando a treinar

65. Nomes estranhos

66. Limitação histórica

67. 1.
2.
3.
4.
5.
6.
7.
8.
9.
READ INPUT TAPE A1, B1, C1;
501 FORMAT A1;
IF (A1) 777, 777, 777
IF (B1) 888, 888, 888
IF (C1) 999, 999, 999
STOP 1
799 S = FLOATF(A1 + B1 + C1) / 2.0
WRITE TO TAPE S
END PROCESS
As linguagens não
ajudavam muito

68. Os ambientes não
ajudavam

69. Nem os computadores

70. Deixaram essa herança
maldita!

71. Aprendendo com os
mestres

72. 1.
2.
3.
4.
5.
6.
7.
8.
// Descrição da maquina
$m_desc;
// Resultado parcial da soma
$s1;
// Cor dos olhos
$cOlhos;
// Valor do índice temporário
$aux;

73. revela a intenção

74. 1.
2.
3.
4.
5.
6.
7.
8.
// Descrição da maquina
$m_desc;
// Resultado parcial da soma
$s1;
// Cor dos olhos
$cOlhos;
// Valor do índice temporário
$aux;

75. 1.
2.
3.
4.
5.
6.
7.
8.
// Descrição da maquina
$descricaoDaMaquina;
// Resultado parcial da soma
$resultadoParcialSoma;
// Cor dos olhos
$corDosOlhos;
// Valor do índice temporário
$valorDoIndiceTemporario;

76. 1.
2.
3.
4.
5.
6.
7.
8.
$descricaoDaMaquina;
$resultadoParcialSoma;
$corDosOlhos;
$valorDoIndiceTemporario;

77. 1.$descricaoDaMaquina;
2.$resultadoParcialSoma;
3.$corDosOlhos;
4.$valorDoIndiceTemporario;

78. Não seja genérico

79. 1.
2.
3.
4.
5.
6.
7.
8.
// Processa folha de pagamento
processa();
processa()
// Calcula o imposto de renda ret.
calcula();
// Renderiza o relatório de alunos
renderiza();
// Totaliza as estatísticas da ligação
totaliza();
totaliza()

80. 1.
2.
3.
4.
5.
6.
7.
8.
// Processa folha de pagamento
processaFolhaPagamento();
processaFolhaPagamento()
// Calcula o imposto de renda ret.
calculaImpostoRetido();
calculaImpostoRetido()
// Renderiza o relatório de alunos
renderizaRelatorioAlunos();
renderizaRelatorioAlunos()
// Totaliza as estatísticas da ligação
totalizaEstatisticasLigacao();
totalizaEstatisticasLigacao()

81. 1.
2.
3.
4.
5.
6.
7.
8.
processaFolhaPagamento();
processaFolhaPagamento()
calculaImpostoRetido();
calculaImpostoRetido()
renderizaRelatorioAlunos();
renderizaRelatorioAlunos()
totalizaEstatisticasLigacao();
totalizaEstatisticasLigacao()

82. 1.
2.
3.
4.
processaFolhaPagamento();
processaFolhaPagamento()
calculaImpostoRetido();
calculaImpostoRetido()
renderizaRelatorioAlunos();
renderizaRelatorioAlunos()
totalizaEstatisticasLigacao();
totalizaEstatisticasLigacao()

83. Simplifique estruturas de
decisão

84. <?php
class Taximetro {
public function calculaValorDaCorrida($hora) {
if ($hora > 22:00 || $hora < 06:00) {
return $this->distancia * 3.90;
} else {
return $this->distancia * 2.10;
}
}
}

85. <?php
class Taximetro {
public function calculaValorDaCorrida($hora) {
if () {
return $this->distancia * 3.90;
} else {
return $this->distancia * 2.10;
}
}
}

86. <?php
class Taximetro {
public function calculaValorDaCorrida($hora) {
if ($this->ehBandeiraDois($hora)) {
return $this->distancia * 3.90;
} else {
return $this->distancia * 2.10;
}
}
}

87. <?php
class Taximetro {
public function calculaValorDaCorrida($hora) {
if ($this->ehBandeiraDois($hora)) {
return $this->distancia * 3.90;
} else {
return $this->distancia * 2.10;
}
}
public function ehBandeiraDois($hora) {
return $hora > 22:00 || $hora < 06:00;
}
}

88. Números mágicos

89. <?php
class Taximetro {
public function calculaValorDaCorrida($hora) {
if ($this->ehBandeiraDois($hora)) {
return $this->distancia * 3.90;
} else {
return $this->distancia * 2.10;
}
}
public function ehBandeiraDois($hora) {
return $hora > 22:00 || $hora < 06:00;
}
}

90. <?php
class Taximetro {
public function calculaValorDaCorrida($hora) {
if ($this->ehBandeiraDois($hora)) {
return $this->distancia *;
} else {
return $this->distancia *;
}
}
public function ehBandeiraDois($hora) {
return $hora > 22:00 || $hora < 06:00;
}
}

91. <?php
class Taximetro {
public function calculaValorDaCorrida($hora) {
if ($this->ehBandeiraDois($hora)) {
return $this->distancia * PRECO_B2;
} else {
return $this->distancia * PRECO_B1;
}
}
public function ehBandeiraDois($hora) {
return $hora > 22:00 || $hora < 06:00;
}
}

92. <?php
class Taximetro {
public function calculaValorDaCorrida($hora) {
if ($this->ehBandeiraDois($hora)) {
return $this->distancia * PRECO_BANDEIRA2;
} else {
return $this->distancia * PRECO_BANDEIRA1;
}
}
public function ehBandeiraDois($hora) {
return $hora > 22:00 || $hora < 06:00;
}
}

93. Saindo do labirinto

94. <?php
...
function calculaValorDaCorrida($hora) {
if ($hora > 22:00 || $hora < 06:00) {
return $this->distancia * 3.90;
} else {
if ($this->diaDaSemana == 'Domingo') {
return $this->distancia * 2.9;
}else {
return $this->distancia * 2.10;
}
}
}
...

95. distância da margem

96. <?php
...
function calculaValorDaCorrida($hora) {
if ($hora > 22:00 || $hora < 06:00) {
return $this->distancia * 3.90;
} else {
if ($this->diaDaSemana == 'Domingo') {
return $this->distancia * 2.9;
}else {
return $this->distancia * 2.10;
}
}
}
...

97. <?php
...
function calculaValorDaCorrida($hora) {
if () {
return $this->distancia * 3.90;
} else {
if () {
return $this->distancia * 2.9;
}else {
return $this->distancia * 2.10;
}
}
}
...

98. <?php
...
function calculaValorDaCorrida() {
if ($this->ehBandeiraDois()) {
return $this->distancia * 3.90;
} else {
if ($this->ehHorarioDeDomingo()) {
return $this->distancia * 2.9;
}else {
return $this->distancia * 2.10;
}
}
}
...

99. <?php
..
function calculaValorDaCorrida() {
if ($this->ehBandeiraDois()) {
return $this->distancia * 3.90;
}
if ($this->ehHorarioDeDomingo()) {
return $this->distancia * 2.9;
}else {
return $this->distancia * 2.10;
}
}
...

100. <?php
...
function calculaValorDaCorrida() {
if ($this->ehBandeiraDois()) {
return $this->distancia * 3.90;
}
if ($this->ehHorarioDeDomingo()) {
return $this->distancia * 2.9;
}else {
return $this->distancia * 2.10;
}
}
...

101. <?php
...
function calculaValorDaCorrida() {
if ($this->ehBandeiraDois()) {
return $this->distancia * 3.90;
}
if ($this->ehHorarioDeDomingo()) {
return $this->distancia * 2.9;
}
return $this->distancia * 2.10;
}
...

102. <?php
...
function calculaValorDaCorrida() {
if ($this->ehBandeiraDois()) {
return $this->distancia * PRECO_BANDEIRA2;
}
if ($this->ehHorarioDeDomingo()) {
return $this->distancia * PRECO_DE_DOMINGO;
}
return $this->distancia * PRECO_BANDEIRA1;
}
...

103. medo de estragar algo?

105. economize, teste mais
cedo!

106. Mas o que é refatorar?

107. “Alteração feita na estrutura
interna do software para tornálo mais fácil de ser
entendido e menos custoso
de ser modificado sem alterar
seu comportamento
observável.”
(Martin Fowler)

108. “Refactoring é a arte de
evoluir o design do
código existente.”
(William C. Wake)

109. “Refatorar é uma forma
de manter seu software
sustentável e
competitivo com o
passar do tempo.”

110. Refatorar é uma forma de
investimento

111. Tempo investido refatorando é
proporcional ao tempo
economizado com o entendimento
do código multiplicado pelo número
de pessoas na equipe.
(Rodrigo Branas - Developer)

112. A fórmula matemática do refactoring:
Tr = Te * tamanho da equipe
1 hora investida refatorando é
proporcional a
8 horas economizadas com o
entendimento em uma equipe de 8
pessoas.
Isso sem falar em flexibilidade,
redução na quantidade de
defeitos e reuso.

113. infelizmente, o inverso também
é verdadeiro

114. Como vender atividades de
vender
refatoração para o seu gerente?

115. Diálogo entre o Desenvolvedor e o Gerente
Desenvolvedor: João, preciso fazer um refactoring no
código!
Gerente: Refactoring?! O que é isso, você vai melhorar a
performance?
Desenvolvedor: Não, não...
Gerente: Vai deixar a interface mais bonita e mais fácil
de ser utilizada?
Desenvolvedor: Não...
Gerente: Então? O que é isso?
Desenvolvedor: “Vou fazer uma alteração na estrutura
interna do software,para torná-lo mais fácil de ser
entendido e menos custoso de sermodificado, sem
alterar seu comportamento observável.” (Martin Fowler)
Gerente: Não.

116. Refatore com um propósito,
evite refatorar apenas por
refatorar

117. Atente-se as
oportunidades!
oportunidades

118. Aproveite a correção de um defeito
Aproveite a correção de um defeito
para refatorar!
para refatorar!

119. Vai adicionar algo novo, aproveite
Vai adicionar algo novo, aproveite
para refatorar!
para refatorar!

120. Refatore quando precisar entender
Refatore quando precisar entender
uma parte do código
uma parte do código

121. Os 7 principais inimigos da
Os 7 principais inimigos da
refatoração
refatoração

122. Desconhecimento
Desconhecimento

123. Não se dar conta do problema é
uma das principais causas. É
comum ver desenvolvedores
experientes que não dão
atenção a qualidade do código.

124. Imediatismo
Imediatismo

125. Pensar apenas em resolver o
problema, sem considerar que
problema
a natureza do desenvolvimento
de software é a mudança.

126. Janelas quebradas
Janelas quebradas

127. Temos dificuldade em lidar com
janelas quebradas. Seja numa
dieta, relacionamento ou
desenvolvimento de software, o
desânimo das janelas
quebradas leva ao fracasso.
fracasso

128. Nível técnico baixo
Nível técnico baixo

129. É fácil culpar o estagiário. É
preciso ter pessoas com nível
técnico alto e senso crítico
apurado para zelar pelas
boaspráticas e manter a
ordem do código.
código

130. Falta de trabalho em
Falta de trabalho em
equipe
equipe

131. O código pertence a
equipe, não ao seu autor.
Todos devem se
responsabilizar e zelar
pelo bem comum.
comum

132. Gerenciamento
Gerenciamento

133. Pressão comercial
Pressão comercial

134. Quando não
Quando não
refatorar?
refatorar?

135. • Quando o código simplesmente
não funciona, é instável
instáve
• Se funciona, ninguém sabe ao
certo como...
• Próximo ao final do prazo de
entrega

136. A maioria das empresas precisa
A maioria das empresas precisa
contrair algumas dívidas para
contrair algumas dívidas para
funcionar efetivamente
funcionar efetivamente

137. Mas cuidado com o aumento do débito
Mas cuidado com o aumento do débito
técnico, os juros são altos
técnico os juros são altos
técnico,
técnico

138. Testes unitários

139. As 3 leis do TDD

140. • Você não pode escrever o código
até que tenha criado um teste
falhando;
falhando
• Você não pode escrever mais
testes do que seja suficiente para
falhar;
falhar
• Você não pode escrever mais
código do que o suficiente para
passar o teste que esta falhando;
falhando

141. 1 Conceito por teste

142. • Separe do teste que esteja
testando com mais de um
conceito em outros testes
• Facilite o entendimento de cada
teste

143. Os testes devem ser
rápidos para executar,
pois quando são lentos a
frequência de execução
diminui.

144. Testes não podem
depender uns dos
outros, pois se um falha
os outros também
falharam

145. Ao executa-los mais de
uma vez, devem sempre
retornar o mesmo
resultado

146. Os testes devem ser
escritos antes do
código.
código
Após o código será mais
difícil fazer o teste

147. O código do teste é tão
importante quanto o
código da produção.
O teste precisa sofrer
alterações da mesma forma
que o código

148. Quanto mais sujo o teste
mais difícil dar
manutenção, e menor a
flexibilidade para alterálo.

149. “Se você deixar seus
testes apodrecerem,
seu código também
apodrecerá”

150. Fique atento aos maus
cheiros!

151. • Comentários pobres, obsoletos e
redundantes
• Código comentado
• Testes que requerem mais de um passo
• Muitos parâmetros ou parâmetros
booleanos
• Métodos mortos ou que fazem muita
coisa
• Responsabilidades fora do contexto
• Nomes pequenos e inexpressivos

152. • Duplicação
• Inconsistência
• Intenção obscura
• Variáveis e funções inexpressivas
• Despadronização
• Números mágicos
• Desencapsulamento
• Efeitos colaterais
• Testes insuficientes

153. Conclusão

154. • Tudo o que falamos até aqui não é
para ser uma lista de regras
• Você não se torna um bom
programador aprendendo uma lista
de regras.
• As técnicas e práticas têm que
começar a fazer parte do nosso dia
a dia.
• Devemos nos preocupar com a
qualidade do código e não
somente fazê-lo funcionar.

155. Você é responsável pelo código
Você é responsável pelo código
que escreve e só você!
que escreve e só você!

156. Referência

157. •
•
•
•
•
•
Clean Code - Robert Martin
•
•
•
•
•
Design Patterns - Head First - Eric Freeman e Elisabeth Freeman
Refactoring - Martin Fowler
Patters of Enterprise Application Architecture - Martin Fowler
Test-Driven Development by Example - Kent Beck
Effective Java - Joshua Block
Design Patterns - Eric Gamma, Richard Helm, Ralph Johnson e
John Vlissides
Refactoring to Patterns - Joshua Kerievisky
Domain-Driven Design - Eric Evans
Working Effectively with Legacy Code - Michael Feathers
Baseado no curso de Clean Code por Rodrigo Branas
(www.agilecode.com.br)
Referência

158. Perguntas?

159. Participe!

160. dteruel@opensuse.org
http://about.me/mingomax