toolero is an R package designed to help researchers implement best practices for their coding projects. It provides a small set of opinionated, practical functions that reduce friction at the start of a project and during day-to-day data work.
Installation
You can install toolero from GitHub with:
# install.packages("pak")
pak::pak("erwinlares/toolero")Functions
init_project()
Creates a new R project with a standard folder structure suited for research workflows. Optionally initializes renv for package management and git for version control.
library(toolero)
# Create a project with the standard folder structure
init_project("~/Documents/my-project")
# Add extra folders
init_project("~/Documents/my-project", extra_folders = c("notebooks", "presentations"))
# Skip renv and git
init_project("~/Documents/my-project", use_renv = FALSE, use_git = FALSE)The default folder structure includes: data/, data-raw/, R/, scripts/, plots/, images/, results/, and docs/.
read_clean_csv()
Reads a CSV file and cleans the column names in one step, producing a tidyverse-friendly tibble.
library(toolero)
data <- read_clean_csv("path/to/file.csv")
# Show column type messages
data <- read_clean_csv("path/to/file.csv", verbose = TRUE)