Configure R session for fundraising analytics

Sets common R options that make working with fundraising data easier, particularly for less experienced R users. The most important setting disables scientific notation so large dollar amounts display properly.

Usage

fundr_setup(scipen = 999L, digits = 7L, fy_start_month = 7L, quiet = FALSE)

Arguments

scipen: Integer passed to options(scipen = ...). Higher values make R less likely to use scientific notation. Default 999 effectively disables it. Set to 0 to restore R's default behavior.
digits: Number of significant digits to display. Default 7.
fy_start_month: Integer 1-12 indicating fiscal year start month. Default 7 (July). Set to 1 for calendar year fiscal periods. This sets the fundr.fy_start_month option.
quiet: Logical; if TRUE, suppresses the startup message.

Value

Invisibly returns a named list of the previous option values, which can be passed to options() to restore them.

Details

This function sets the following options:

scipen = 999: Prevents scientific notation (e.g., displays 1000000 instead of 1e+06)
digits: Controls significant digits in output
fundr.fy_start_month: Default fiscal year start month used by functions like fy_year() and donor_status()

Call fundr_setup() at the beginning of your script or in your .Rprofile to ensure consistent behavior throughout your session.

Examples

# Save current options
old_opts <- options()

# Configure session with July fiscal year (default)
fundr_setup(quiet = TRUE)

# Large numbers now display without scientific notation
format(1234567890)
#> [1] "1234567890"

# Restore previous options
options(old_opts)