De la idea al paquete: programá tu primer paquete de R
Taller de LatinR 2026
Estoy al horno
Estar en un problema muy grande y sin salida fácil.
Argentina
Este dicho salió del paquete que vamos a construir en el taller: dichosos, un paquete con dichos y expresiones populares de América Latina. Al final de la tarde vas a tener en tu computadora un paquete de R funcional, con funciones, datos, documentación y tests. Y vas a llevarte las herramientas para poder hacer lo mismo con tu propio código.
¿Para quién es este taller?
Para personas que ya programan en R y escriben (o están aprendiendo a escribir) sus propias funciones, pero nunca crearon un paquete.
Si te reconocés en alguna de estas personas, este taller es para vos:
- Valentina es bióloga en Córdoba. Tiene un script de 300 líneas que copia de proyecto en proyecto, y cada vez que corrige un error lo tiene que corregir en cada uno de los proyectos donde lo uso.
- Diego trabaja en una oficina de estadística en Bogotá. Su equipo comparte funciones en un DropBox y nadie sabe cuál es la versión actualizada.
- Julian da clases en una universidad de Lima. Quiere que sus estudiantes instalen los datos del curso con una sola línea de código.
Seguí las instrucciones de la página de Preparación para tener tu entorno listo para desarrollar paquetes. Lleva unos 20 minutos.
Lo que vas a aprender
Al terminar el taller vas a poder:
- Explicar qué es un paquete de R y por qué conviene crear uno, aunque sea solo para vos.
- Crear la estructura de un paquete con
usethisy comprobarla condevtools::check(). - Agregar funciones y usar el ciclo editar, cargar, probar.
- Documentar funciones con
roxygen2. - Incluir datos en un paquete y documentarlos.
- Declarar dependencias y escribir mensajes de error claros con
cli. - Escribir tests con
testthat. - Escribir un README e instalar tu paquete para usarlo desde cualquier proyecto.
- Decidir en qué partes del ciclo conviene usar herramientas de IA y revisar lo que generan.
Cómo vamos a trabajar
- Programación en vivo: la instructora escribe el código en vivo, despacio, y vos lo escribís a la par en tu computadora. Si se equivoca (¡va a pasar!), vemos juntos cómo resolverlo.
- Desafíos cortos después de cada parte, para practicar y comprobar que todo se entendió.
- Notas adhesivas cuando necesitás ayuda pegas tu nota adhesiva en tu computadora y una persona del equipo docente se acerca a ayudarte.
- Un documento colaborativo con notas, los enlaces, las preguntas y las respuestas, que queda para después del taller.
- Equivocarse está bien. Los errores son la mejor parte del aprendizaje y vamos a ver varios a propósito.
Horario
| Hora | Lección |
|---|---|
| 0:00 | Bienvenida, código de conducta y presentaciones |
| 0:10 | 1. ¿Qué es un paquete? |
| 0:25 | 2. Crear el paquete |
| 0:50 | 3. Nuestra primera función |
| 1:15 | 🧉 Pausa (10 minutos) |
| 1:25 | 4. Documentar funciones |
| 1:42 | 5. Datos en el paquete |
| 2:07 | 🤸 Pausa (10 minutos) |
| 2:17 | 6. Dependencias y mensajes claros |
| 2:32 | 7. Tests |
| 2:52 | 8. Compartir el paquete |
| 3:04 | 9. La IA en el ciclo de desarrollo |
| 3:24 | Cierre, próximos pasos y opiniones |
| 3:30 | Fin |
Código de conducta
Este taller es parte de LatinR y se rige por su código de conducta. Queremos que todas las personas se sientan bienvenidas, sin importar su experiencia, su país, su género o la cantidad de veces que pregunten lo mismo. Si algo te hace sentir incómoda o incómodo, hablá con la organización de LatinR.
¿Por qué dichos?
Porque un paquete de ejemplo tiene que ser simple, funcional y presentar las características mínimas de lo que hace un paquete de R un paquete.
Los dichos son una excusa perfecta: nos dan un conjunto de datos manejable sobre el que podemos conducir acciones, como filtrar y buscar con la yapa de aprender expresiones de diferentes paises.
Algo divertido que podemos hacer es sumar los dichos de tu país y el paquete se hace más rico con cada taller.
Fuentes
Los talleres Desarrollo de paquetes para principiantes, Desarrollo de paquetes avanzado y ¡Código hermoso, porque lo valemos! del Programa de Campeones y Campeonas de rOpenSci desarrollados y dictados por Maëlle Salmon. De ahí vienen la secuencia de herramientas, muchas de las preguntas frecuentes, la idea de los snippets de código y la analogía de la bicicleta.
El libro Introducción a la Programación II, de Paola Corrales y Yanina Bellini Saibene, en especial los capítulos Funciones, Empaquetando funciones, Documentando paquetes y funciones, Dependencias y tests y Contribuir y aceptar contribuciones.
La charla Desarrollando paquetes de R con la ayuda de rOpenSci, de Yanina Bellini Saibene, donde nació la idea de un paquete de dichos regionales y la primera version de las slides de este taller.
La lección 9 adapta el taller Modern R Workflow (ft. Positron and AI), de Hadley Wickham y Jenny Bryan (posit::conf 2026), y las pautas de rOpenSci sobre el uso de IA publicadas en Software Review in the Era of AI.