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

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.

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 - [email protected]
• Adrien Cocuaud - Contributor - [email protected]

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