Documentos de Académico
Documentos de Profesional
Documentos de Cultura
% Añade
"hadley@me.com", role = c("aut", "cre"))
Estructura de Paquetes los paquetes de los cuales el tuyo depende con
devtools::use_package()
Description: Lo que el paquete hace (en un párrafo)
Depends: R (>= 3.1.0)
Un paquete es una costumbre, un convenio informal, Añade un paquete al campo Imports (o el campo License: GPL-2 Imports: paquetes que tu paquete
Suggests si el segundo argumento es “Suggests”). LazyData: true
para organizar archivos en carpetas. necesita tener para funcionar. R los
Imports: instalará cuando instalas tu paquete.
dplyr (>= 0.4.0),
Esta hoja muestra como trabajar con las 7 partes mas CC0 MIT GPL-2
ggvis (>= 0.2) Suggests: paquetes que no son
Licencia MIT aplica si tu Licencia GPL-2 aplica a tu
comunes de un paquete de R: Sin restricciones
código es compartido código y todo el código que Suggests: esenciales para el tuyo. Usuarios los
alguien incluye en el paquete pueden instalar manualmente, si
por otros. knitr (>= 0.1.0)
# Package si es compartido por otros. gustan, o no instalarlos.
" DESCRIPTION Configuración
$ R/ Escribe código Escribe código ( $ R/) Pruebas
Setup ( $ tests/)
( " DESCRIPTION)
$ tests/ Pruebas
$ man/ Documentación Todo el código R de tu paquete va a $ R/. Un paquete con The
Usa $ DESCRIPTION
" tests/ para guardar
file describes
pruebasyour
unitarias
work que
and te
sets
$ vignettes/ Enseña solamente una carpeta R/ directory es un paquete útil. informarán
up how your
enpackage
el caso de
willinterrupciones
work with other
enpackages.
tu código.
$ data/ Añade datos
" NAMESPACE Organiza
% Creadevtools::create("camino/a/nombre")
un nuevo proyecto de paquete con % You must
Añade unahave a DESCRIPTION
carpeta file testthat con
tests/ e importa
% Adddevtools::use_testthat()
El contenido de un paquete se puede guardar en disco como:
Crea una plantilla para desarrollar un paquete.
% devtools::use_package()
the packages
Configura that yours
el paquete relies
para usar
automatizadas con testthat
on with
pruebas
• fuente - una carpeta con subcarpetas como arriba
Addspruebas
a package tocontext(),
the Imports file (default) or
• paquete - un solo archivo comprimido (.tar.gz)
• binario - un solo archivo comprimido optimizado para un
% Guardo tu código en $ R/ como scripts (extensión .R) Escribe
Suggests fieldcon
% Guarda test(),
(if second argument isy expectativas
tus pruebas como archivos .R en tests/
"Suggests").
devtools::load_all()
Repositorio
context("Arithmetic")
Binario
Version: 0.1.0
Fuente
memoria. devtools::test()
Authors@R: person("Hadley", "Wickham", email =
Ctrl/Cmd + Shift + L (abreviado de teclado) Corre todas las pruebas role test_that("Math
"hadley@me.com", = c("aut", "cre", works",
"cst")) {
install.packages() CRAN ○ guardadas en $
Description: What the package
tests/. expect_equal(1 + 1, 2)
does (one paragraph)
install.packages(type = CRAN Guarda todos los documentos y llama load_all(). Depends: R (>= 3.1.0) expect_equal(1 + 2, 3)
"source")
○ Ctrl/Cmd + Shift + T
License: GPL-2 expect_equal(1 + 3, 4)
○ ○ 3. Experimenta en la consola. (abreviado de teclado)
LazyData: true })
R CMD install ○ ○ 3. Repite hasta que todas las
4. Repite. Imports:
○ ○ pruebas pasan (>= 0.4.0),
dplyr
devtools::install() ○ • Usa un estilo consistente con r-pkgs.had.co.nz/r.html#style. ggvis (>= 0.2)
expect_equal()
Suggests: es igual dentro de pequeño margen de tolerancia numerica?
devtools::build() ○ ○ • Haz clic en la función y aprieta F2 para abrir su definición.
expect_identical()
knitr (>= es exactamente
0.1.0) igual?
devtools::install_github( github ○ • Busca una función con Ctrl + . expect_match() coincide con caracteres específicos o expresion regular?
)devtools::load_all() ○ ○ expect_output() imprime salida especificada?
Build & Reload (RStudio) ○ ○ ○
Visita r-pkgs.had.co.nz expect_message() muestra mensaje espeficado?
library() ○ ○ expect_warning() muestra advertencia especificada?
Internet On disk library memory Aprende mas en http://r-pkgs.had.co.nz • devtools 1.6.1 • Actualizado: 1/15 expect_error() arroja el error especificado?
devtools::add_build_ignore("file") RStudio® es una marca registrada de of RStudio, Inc. • Todos los derechos reservados expect_is() salida hereda de una clase especifica?
info@rstudio.com • 844-448-1212 • rstudio.com
Añade archivos a .Rbuildignore, una lista de archivos que no se expect_false() devuelve FALSE?
incluirán al construir (build) el paquete. Traducido por Frans van Dunné • innovateonline.nl expect_true() devuelve TRUE?
RStudio® es una marca registrada de RStudio, Inc. • CC BY RStudio • info@rstudio.com • 844-448-1212 • rstudio.com Learn more at http://r-pkgs.had.co.nz • devtools 1.6.1 • Updated: 1/15
Traducido por Frans van Dunné • www.ixpantia.com
Documentación ( $ man/) Añade datos ( $ data/)
$ man/ contiene la documentación de tus funciones, y las páginas de ayuda para tu paquete. La carpeta $ data/ te permite incluir datos con tu
Usa comentarios roxygen para documentar cada paquete.
El paquete roxygen
% función a la par de su definición