O que é o reprex
O reprex
é o apelido "exemplo reprodutível", inglês.
A ideia do pacote e da função reprex
é rodar o código em um ambiente "novo" e "limpo", assim como ocorrerá com quem tentar reproduzir seu exemplo/problema.
Desta forma, a simples produção de um reprex
já é ela mesma a garantia de que o exemplo em questão é reprodutível.
Como usar
1. Ctrl + c
Há várias formas para usar o reprex
. Uma das que mais gosto é copiar o código e rodar reprex::reprex()
. Quando o reprex
é usado sem argumentos ele verifica se há algum código no seu "crtl + c" e, havendo, ele usa para criar o exemplo reprodutível.
Infelizmente esta alternativa não é tão reprodutível assim e não consigo criar um reprex desta forma de usar o reprex()
.
2. Dentro de chaves {}
Outra alternativa é colocar o código que será rodado como primeiro argumento do reprex()
envolto em chaves ({}
). Realizando seu exemplo e rodando
library(reprex)
reprex({
(y <- 1:4)
mean(y)
})
Teríamos o pedaço a baixo como resultado.
(y <- 1:4)
#> [1] 1 2 3 4
mean(y)
#> [1] 2.5
Created on 2020-01-22 by the reprex package (v0.3.0)
Para que se dar ao trabalho?
A vantagem de usar o reprex()
é que ele evidencia prontamente erros que fariam com que quem for te ajudar com o problema desista de tentar. Um bom exemplo é aquele em que se esquece de compartilhar os dados usados para reproduzir o problema.
Neste exemplo você poderia compartilhar apenas o pedaço de código
mean(meus_dados$y)
E ainda que isso funcione para você não vai funcionar para mais ninguém. Isso acontece porque esse código depende do ambiente em que ele foi rodado e ninguém mais tem acesso a esse ambiente.
Se você colocar apenas essa mesma linha dentro do reprex,
reprex({mean(meus_dados$y)})
O resultado será:
mean(meus_dados$y)
#> Error in mean(meus_dados$y): objeto 'meus_dados' não encontrado
Created on 2020-01-22 by the reprex package (v0.3.0)
Com isso você já saberá de antemão que deve readequar seu código para que o exemplo contenha todos os elementos que permitam que ele seja reproduzido em um outro contexto ou ambiente.