Estilo

Frans van Dunné me ha hecho llegar su guía de estilo de programación en R. Abunda en otra creada por Google hace un tiempo y que traduje y adapté aquí.

Tiene como novedad, dice, su adaptación a las formas y maneras de Hadley Wickham, aún no tan conocido entonces. Coinciden, no obstante, en lo más.

Ninguna de las dos trata el uso las tuberías (operador %>%). Pero es un asunto que se nos puede ir de las manos: de hecho, hoy he conocido el paquete [backpipe](https://github.com/decisionpatterns/backpipe), que implementa %<% y que nos augura largas y desesperantes sesiones de depuración de código.

R es un lenguaje de programación de alto nivel que se usa principalmente en aplicaciones estadísticas y para la generación de gráficos. El objetivo de esta guía de estilo es que nuestro código sea más fácil de leer, compartir y analizar. Las reglas de esta guía fueron consensuadas con la comunidad de usuarios de R en Google.

• Resumen de las reglas de estilo

  1. Nombres de ficheros: tienen la extensión .R
  2. Identificacores: variable.name, FunctionName, kConstantName
  3. Longitud de línea: no más de 80 caracteres
  4. Indentación: dos espacios, no tabuladores
  5. Espacios
  6. Llaves: el primero en la misma línea; el último, solo
  7. Asignaciones: usar <-, no =
  8. Puntos y comas: no usarlos
  9. Distribución general y ordenación
  10. Comentarios: todos los comentarios comienzan con # seguido de un espacio; los comentarios dentro del código necesitan dos espacios delante de #
  11. Definiciones y llamadas a funciones
  12. Documentación de funciones
  13. Ejemplo de función
  14. Estilo para los TODO: TODO(username)

• Resumen de las reglas de programación