get_source_expressions: Parsed sourced file from a filename

In r-lib/lintr: A 'Linter' for R Code

Parsed sourced file from a filename

Description

This object is given as input to each linter.

Usage

get_source_expressions(filename, lines = NULL)

Arguments

filename	the file to be parsed.
lines	a character vector of lines. If NULL, then filename will be read.

Details

The file is read using the encoding setting. This setting is found by taking the first valid result from the following locations

1. The encoding key from the usual lintr configuration settings.

2. The Encoding field from a Package DESCRIPTION file in a parent directory.

3. The Encoding field from an R Project .Rproj file in a parent directory.

4. "UTF-8" as a fallback.

Value

A list with three components:

expressions

a list of n+1 objects. The first n elements correspond to each expression in filename, and consist of a list of 8 elements:

• filename (character) the name of the file.

• line (integer) the line in the file where this expression begins.

• column (integer) the column in the file where this expression begins.

• lines (named character) vector of all lines spanned by this expression, named with the corresponding line numbers.

• parsed_content (data.frame) as given by utils::getParseData() for this expression.

• xml_parsed_content (xml_document) the XML parse tree of this expression as given by xmlparsedata::xml_parse_data().

• content (character) the same as lines as a single string (not split across lines).

• xml_find_function_calls(function_names) (function) a function that returns all SYMBOL_FUNCTION_CALL XML nodes from xml_parsed_content with specified function names.

The final element of expressions is a list corresponding to the full file consisting of 7 elements:

• filename (character) the name of this file.

• file_lines (character) the readLines() output for this file.

• content (character) for .R files, the same as file_lines; for .Rmd or .qmd scripts, this is the extracted R source code (as text).

• full_parsed_content (data.frame) as given by utils::getParseData() for the full content.

• full_xml_parsed_content (xml_document) the XML parse tree of all expressions as given by xmlparsedata::xml_parse_data().

• terminal_newline (logical) records whether filename has a terminal newline (as determined by readLines() producing a corresponding warning).

• xml_find_function_calls(function_names) (function) a function that returns all SYMBOL_FUNCTION_CALL XML nodes from full_xml_parsed_content with specified function names.

error

A Lint object describing any parsing error.

lines

The readLines() output for this file.

Examples

tmp <- tempfile()
writeLines(c("x <- 1", "y <- x + 1"), tmp)
get_source_expressions(tmp)
unlink(tmp)

r-lib/lintr documentation built on Dec. 20, 2024, 7:24 p.m.