Desarrollo de paquetes con R (III): check, check, check

Uno de los pasos más importantes en el desarrollo de un paquete es verificar que funciona correctamente. Un check comprueba la estructura del paquete, la consistencia entre el código y la documentación, que no faltan secciones importantes en esta última, que los ejemplos pueden ejecutarse sin problemas, etc.

De ahí que sirva para para muchos propósitos. En particular, si uno elige los ejemplos que acompañan a la documentación de las funciones con buen criterio, éstos servirán no sólo para ilustrar el comportamiento de las funciones sino, también, para verificar el funcionamiento del paquete. Además, de usar R-forge, como el sistema realiza checks en varias plataformas distintas, el elegir bien los ejemplos permite realizar comprobaciones multiplataforma del código.

Confieso no saber cómo hacer un check sobre Windows, la verdad. Por eso me voy a limitar al entorno que uso, Linux ―aunque entiendo que el procedimiento es válido también para variantes de Unix, incluida la de Mac―. Normalmente, suelo desarrollar sobre el directorio $HOME/src/r. En él guardo diversos directorios con distintos proyectos relacionados con R. Al hacer

R CMD check mi_paquete

R crea un directorio adicional, mi_paquete.Rcheck, en el directorio de trabajo. Por mantener limpio mi disco, suelo proceder así:

cd /tmp
ln -s $HOME/src/r/mi_paquete
R CMD check mi_paquete

De esta manera, los directorios adicionales creados por R quedan en /tmp y se eliminan por sí solos al apagar el equipo.

 

Un comentario sobre “Desarrollo de paquetes con R (III): check, check, check

  1. Luciano Selzer 13 julio, 2011 19:04

    En windows se hace igual, solo que el comando es Rcmd check. Además hay que instalar algunas cosas (compilador C, compilador de latex) para poder hacer paquetes. Además hay un nuevo paquete test_that para probar que el código del paquete funcione como se espera.

Los comentarios están desabilitados.