R/charlatan-package.R

In charlatan: Make Fake Data

#' charlatan
#'
#' Make fake data, supporting addresses, person names, dates,
#' times, colors, coordinates, currencies, digital object identifiers
#' (DOIs), jobs, phone numbers, DNA sequences, doubles and integers
#' from distributions and within a range.
#'
#' @name charlatan-package
#' @importFrom R6 R6Class
#' @importFrom whisker whisker.render
#' @importFrom tibble as_tibble
#' @aliases charlatan
#' @docType package
#' @keywords package
#' @author Scott Chamberlain \email{myrmecocystus+r@@gmail.com}
#' @author Kyle Voytovich
#' @author Martin Pedersen
#'
#' @section Package API:
#'
#' - [ch_generate()]: generate a data.frame with fake data
#' - [fraudster()]: single interface to all fake data methods
#' - High level interfaces: There are high level functions prefixed with
#'  `ch_` that wrap low level interfaces, and are meant to be easier
#'  to use and provide easy way to make many instances of a thing.
#' - Low level interfaces: All of these are R6 objects that a user can
#'  initialize and then call methods on the them.
#'
#' @examples
#' # generate individual types of data
#' ch_name()
#' ch_phone_number()
#' ch_job()
#'
#' # generate a data.frame
#' ch_generate()
#'
#' # one interface to all data types - generate the class first
#' #  reports the locale to be used, can change optionally
#' (x <- fraudster())
#' x$job()
#' x$name()
#' x$color_name()
#' x$hex_color()
#'
#' # low level interfaces to "data providers"
#' # these are exported by hidden from package man page
#' # as most users will likely not interact with these
#' x <- ColorProvider$new()
#' x$color_name()
#' x$hex_color()
NULL