This function contains the general set of actions that are always used when recoding a source (e.g. check the input, document the justification, etc). Users should normally never call this function.
generic_recoding(
input,
codes,
func,
filenameRegex = ".*",
filter = TRUE,
output = NULL,
outputPrefix = "",
outputSuffix = "_recoded",
decisionLabel = NULL,
justification = NULL,
justificationFile = NULL,
preventOverwriting = rock::opts$get("preventOverwriting"),
encoding = rock::opts$get("encoding"),
silent = rock::opts$get("silent"),
...
)
Invisibly, the recoded source(s) or source(s) object.
One of 1) a character string specifying the path to a file
with a source; 2) an object with a loaded source as produced by a call
to load_source()
; 3) a character string specifying the path to a
directory containing one or more sources; 4) or an object with a list of
loaded sources as produced by a call to load_sources()
.
The codes to process
The function to apply.
Only process files matching this regular expression.
Optionally, a filter to apply to specify a subset of the
source(s) to process (see get_source_filter()
).
If specified, the coded source will be written here.
The prefix and suffix to add to the filenames when writing the processed files to disk, in case multiple sources are passed as input.
A description of the (recoding) decision that was taken.
The justification for this action.
If specified, the justification is appended to
this file. If not, it is saved to the justifier::workspace()
. This can
then be saved or displayed at the end of the R Markdown file or R script
using justifier::save_workspace()
.
Whether to prevent overwriting existing files
when writing the files to output
.
The encoding to use.
Whether to be chatty or quiet.
Other arguments to pass to fnc
.