Lecciones para tratar de mejorar la calidad del código de los estudiantes recién salidos de la carrera

1. Desarrollo de software en un entorno real

2. ¡ ¿Cuántos programáis?
¡ ¿Muy bien?
¡ ¿Por qué?

4. ¡ We deliver working software on time
Steve McConnell – Code Complete
¡ Deliver working software frequently,
from a couple of weeks to a couple of months, with a preference to the shorter timescale.
Agile development. Principle #3

9. …nuestro código debe estar
preparado para ello

10. ¡ Legibilidad
¡ Comprensibilidad
¡ Mantenibilidad
¡ Reusabilidad
¡ Testeabilidad

11. Desarrollamos
a tiempo
software que
funciona

12. ¡ Nuestro cerebro es limitado y nuestra
memoria RAM escasa
¡ El problema/modelo/negocio es complicado,
que el software no lo haga peor aún
¡ “No me hagas pensar” – Stephen Krug

13. ¡ “When I wrote this, only God and I understood wh
¡ at I was doing. Now, God only knows.”
Karl Weierstrass / Johann Richter / Cualquier programador

16. ¡ Nombres apropiados
¡ Funciones claras
¡ Comentarios que aporten
¡ Formato
¡ Excepciones, pruebas unitarias, sistemas,
clases, concurrencia, refactoring

17. ¡ Claros
¡ Descriptivos
¡ Sin abreviaturas
¡ Consistentes
¡ Sin prefijos

19. ¡ <20 líneas
¡ Nombres apropiados
¡ Anidamiento mínimo
¡ Una sola función
¡ Sin efectos secundarios
¡ Niveles de abstracción descendente
¡ <3 parámetros (y sólo de entrada)

20. ¡ Que aporten información
¡ El (buen) código se “autocomenta”
¡ Explicación de intención
¡ No redundantes
¡ Sin código comentado
¡ Sin referencias a los cambios (Ctrl de versiones)
¡ No sustituyen a un buen nombre

22. ¡ Ficheros pequeños
¡ Nombres apropiados
¡ Con leer la parte de arriba es suficiente
¡ No rompas el interlineado
¡ …

24. ¡ Excepciones, pruebas unitarias, sistemas,
clases, concurrencia, refactoring

25. 1. Use only one level of indentation per method.
2. Don’t use the else keyword.
3. Wrap all primitives and strings.
4. Use only one dot per line.
5. Don’t abbreviate.
6. Keep all entities small.
7. Don’use any classes with more than two
instance variables.
8. Use first-class collections.
9. Don’t use any getters/setters/properties.

26. ¡ Hay versiones para muchos lenguajes
¡ En algunos alguna regla puede no aplicar
¡ Gracias a William Durand
http://williamdurand.fr/2013/06/03/object-calisthenics/

31. 1. Use only one level of indentation per method.
2. Don’t use the else keyword.
3. Wrap all primitives and strings.
4. Use only one dot per line.
5. Don’t abbreviate.
6. Keep all entities small.
7. Don’use any classes with more than two instance variables.
8. Use first-class collections.
9. Don’t use any getters/setters/properties.

33. ¿Por qué abrevias?
§ “Lo escribo mucho”
▪ Duplicación de código
▪ Usa un IDE
§ “Es que el método hace todo eso”
▪ Single Responsability Principle
§ “Es que no encuentro un nombre mejor”
▪ ¡Ay, amigo!

34. ¡ 50 líneas por clase
¡ 10 clases por paquete
¡ Máximo de caracteres por linea

35. ¡ Regla comprometida
¡ Dos tipos de clases:
§ Las que gestionan el estado de una variable
§ Las que coordinan dos variables
¡ Fomenta la alta cohesión y la encapsulación

36. ¡ Si un miembro de una clase es una colección
de elementos, debe ser el único miembro de
la clase
¡ Debe estar encargada de gestionar la
colección

37. ¡ Tell, don’t ask
¡ Las decisiones sobre el estado del objeto
deben ser hechas dentro del objeto

38. Soluciones temporales permanentes
- Stackoverflow

39. ¡ Lenguaje ubicuo
¡ ¿Traduzco los términos del dominio?

40. Premature optimization is the root of all evil
Donald Knuth

41. ¡ The real problem is that programmers have
spent far too much time worrying about
efficiency in the wrong places and at the
wrong times; premature optimization is the
root of all evil (or at least most of it) in
programming.
Donald Knuth

46. ¡ Object Calisthenics – Jeff Bay
in ThoughtWorks Anthology by ThoughtWorks
https://pragprog.com/book/twa/thoughtworks-
anthology
https://www.cs.helsinki.fi/u/luontola/tdd-2009/ext/
ObjectCalisthenics.pdf
¡ Clean Code – Robert C. Martin
¡ Object Calisthenics – Will Durand
http://williamdurand.fr/2013/06/03/object-
calisthenics/
¡ Your code sucks, let’s fix it – Rafael Dohms
https://www.slideshare.net/rdohms/your-code-sucks-
lets-fix-it-15471808