R/debugOnOff.R

In mslegrand/pegr: PEG PARSER

#' Turn on the pegR rule debugger
#' 
#' The pegR rule debugger allows one to step through as the rules
#' as they are invoked.
#' 
#' 
#'  When applying a given rule to to a text input string,  
#'  that rule may call other rules which in turn may call other 
#'  rules, ad nausem. The  peg rule debugger allows one to 
#'  step through that calling sequence, examining the state
#'  of the parsing both upon entering a rule and 
#'  and exiting a rule. 
#'  @examples
#'  \dontrun{
#'  pegR<-new.parser()
#'  debug.pegR(pegR)
#'  pegR + "A<-B" + "B<-C" + "C<-'abc'"
#'  pegR[['A']]('abc')
#'  undebug.pegR(pegR)
#'  }

#' @seealso \code{\link{undebug.pegR}}
#' @export
debug.pegR<-function(peg){
  pexSetDebugOn(peg, TRUE)
}


#' Turn off the pegR rule debugger
#' 
#' @seealso \code{\link{debug.pegR}}
#' 
#' 
#' @export
undebug.pegR<-function(peg){
  pexSetDebugOn(peg, FALSE)    
}