R.AlphA.Home

Feel at Home using R, Thanks to Shortcuts Functions Making it Simple

Overview

R.AlphA.Home is a collection of personal functions designed to simplify and streamline common R programming tasks. This package provides reusable tools and shortcuts for frequently used calculations and workflows, making R programming more accessible and efficient.

Installation

You can install the released version of R.AlphA.Home from CRAN with:

install.packages("R.AlphA.Home")

Or install the development version from GitHub with:

# install.packages("devtools")
devtools::install_github("R-alpha-act/R.AlphA.Home")

Main Functions

📊 Data Manipulation and Processing

• cols_pad() - Add variables to ease data usage in pivot tables
• compareVars() - Compare table variables
• countSwitches() - Create incremented counters based on start/stop markers
• importAll() - Import and concatenate multiple data files efficiently (enhanced v1.1.0)
• left_join_checks() - Left join operations with built-in validation checks

📅 Date and Time Utilities

• rdate() - Generate random dates with similar usage as r* functions
• Rtimer - Class R6, allow organized tracking of R code execution time (new in v1.1.0)

💾 Data Output and Formatting

• quickSave() - Save files with automatic date prefixing in designated directory
• sepThsd() - Quick number formatting with customizable defaults
• printif() - Conditionally print objects based (new in v1.1.0)

🎨 Graphics and Visual Utilities

• lum_0_100() - Adjust graphics window brightness for comfortable ggplot2 viewing
• ret_lum() - Adjust brightness of hex colors
• shiny_lum_0_100() - Set Shiny background and sidebar colors to chosen grey shades
• show_diff() - Compare two texts or files with diffobj

🔧 System and Environment

• root() - Get root directory of current source file
• setOption() - Set global options from named list elements (new in v1.1.0)
• loadCheck() - Load and install package if necessary (new in v1.1.0)
• ralpha_fold() / ralpha_unfold() - Enhanced code folding functionality (new in v1.1.0)
• RStudio Addins - Convenient shortcuts for folding functions (new in v1.1.0)

⚠️ Deprecated Functions

• timer() → Use the class Rtimer instead
• foldAllBr() → Use ralpha_fold() and ralpha_unfold() instead

Dependencies

The package imports 12 essential R packages: - Data manipulation: data.table, dplyr, tibble - Date/time: lubridate - Graphics: ggplot2, diffobj - File operations: readxl, writexl, R.utils - Utilities: rstudioapi, magrittr, R6

Optional (in Suggests): shiny, shinyWidgets for Shiny integration.

Contributing

We welcome contributions! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

Support

• Documentation: Access help with ?function_name or help(package = "R.AlphA.Home")
• Bug Reports and Feature Requests: GitHub Issues

License

This package is licensed under GPL-3.

Authors

• Raphaël Flambard - Author and Maintainer - raphael@ralpha.fr
• Adrien Cocuaud - Contributor - adrien@ralpha.fr

Making R programming feel like home, one function at a time. 🏠