viernes, 17 de octubre de 2014

Python (05) Estilo de codificación

Una vez que ya hemos visto lo más básico de Python, es hora de ver las reglas de estilo de codificación de este lenguaje, para ello puedes acceder a la web de PEP 8, donde se encuentran descritas, ya que en esta entrada solo veremos las más importantes:
  •  Recorta la líneas a 79 caracteres, ayudando a los usuarios con pantallas pequeñas a tener una buena visualización, y a que los que tienen pantallas grandes les da la posibilidad de tener varios archivos abiertos a la vez.
  • Usa sangrías de 4 espacios, no tabuladores: los 4 espacios son una buena opción entre las más pequeñas que no permiten ver bien el código y las mas grades que lo ensanchan demasiado comiéndose los 79 espacios.
  • Utiliza líneas en blanco cunado vayas a separar funciones y bloques de código
  • Intenta poner los comentarios en una sola línea
  • Utiliza docstrings en las funciones
  • Utiliza espacios alrededor de operadores y detrás de las comas, pero no dentro de los paréntesis.
f = g(1, 2) + h(3, 4) 

  • Hay que nombrar las clases con un nombre descriptivo corto con camelCase y las funciones y métodos con_guiones_bajos.
  • No utilizar codificaciones extrañas, python utiliza UTF-8 por defecto
Con estos consejos los códigos deben de quedar relativamente limpios y claros para el resto de la comunidad.

No hay comentarios:

Publicar un comentario