magrittr: A Forward-Pipe Operator for R

#' magrittr - Ceci n'est pas un pipe
#'
#' The magrittr package offers a set of operators which promote semantics 
#' that will improve your code by
#' \itemize{
#'   \item structuring sequences of data operations left-to-right
#'         (as opposed to from the inside and out),
#'   \item avoiding nested function calls, 
#'   \item minimizing the need for local variables and function definitions, and
#'   \item making it easy to add steps anywhere in the sequence of operations.
#' }
#' The operators pipe their left-hand side values forward into expressions that
#' appear on the right-hand side, i.e. one can replace `f(x)` with 
#' \code{x \%>\% f}, where \code{\%>\%} is the (main) pipe-operator.
#' 
#' Consider the example below. Four operations are performed to 
#' arrive at the desired data set, and they are written in a natural order: 
#' the same as the order of execution. Also, no temporary variables are needed.
#' If yet another operation is required, it is straight-forward to add to the
#' sequence of operations whereever it may be needed.
#' 
#' For a more detailed introduction see the vignette 
#' (`vignette("magrittr")`) or the documentation pages for the
#' available operators:\cr
#' \tabular{ll}{
#'    \code{\link{\%>\%}}  \tab pipe.\cr
#'    \code{\link{\%T>\%}} \tab tee pipe.\cr
#'    \code{\link{\%<>\%}} \tab assignment pipe.\cr
#'    \code{\link{\%$\%}}  \tab exposition pipe.\cr
#' }
#' 
#' @useDynLib magrittr, .registration = TRUE
#' @examples
#' \dontrun{
#' 
#' the_data <-
#'   read.csv('/path/to/data/file.csv') %>%
#'   subset(variable_a > x) %>%
#'   transform(variable_c = variable_a/variable_b) %>%
#'   head(100)
#' }
#' @keywords internal
"_PACKAGE"

.onLoad <- function(lib, pkg) {
  .Call(magrittr_init, asNamespace("magrittr"))
}