Skip to contents

Any valid symbol can be used as a keyword argument to an R function call. Sometimes, it is necessary to quote (or backtick) an argument that is not an otherwise valid symbol (e.g. creating a vector whose names have spaces); besides this edge case, quoting should not be done.

Usage

keyword_quote_linter()

Details

The most common source of violation for this is creating named vectors, lists, or data.frame-alikes, but it can be observed in other calls as well.

Similar reasoning applies to extractions with $ or @.

See also

linters for a complete list of linters available in lintr.

Examples

# will produce lints
lint(
  text = 'data.frame("a" = 1)',
  linters = keyword_quote_linter()
)
#> ::warning file=<text>,line=1,col=12::file=<text>,line=1,col=12,[keyword_quote_linter] Only quote named arguments to functions if necessary, i.e., if the name is not a valid R symbol (see ?make.names).

lint(
  text = "data.frame(`a` = 1)",
  linters = keyword_quote_linter()
)
#> ::warning file=<text>,line=1,col=12::file=<text>,line=1,col=12,[keyword_quote_linter] Only quote named arguments to functions if necessary, i.e., if the name is not a valid R symbol (see ?make.names).

lint(
  text = 'my_list$"key"',
  linters = keyword_quote_linter()
)
#> ::warning file=<text>,line=1,col=9::file=<text>,line=1,col=9,[keyword_quote_linter] Only quote targets of extraction with $ if necessary, i.e., if the name is not a valid R symbol (see ?make.names). Use backticks to create non-syntactic names, or use [[ to extract by string.

lint(
  text = 's4obj@"key"',
  linters = keyword_quote_linter()
)
#> ::warning file=<text>,line=1,col=7::file=<text>,line=1,col=7,[keyword_quote_linter] Only quote targets of extraction with @ if necessary, i.e., if the name is not a valid R symbol (see ?make.names). Use backticks to create non-syntactic names, or use slot() to extract by string.

# okay
lint(
  text = "data.frame(`a b` = 1)",
  linters = keyword_quote_linter()
)

lint(
  text = "my_list$`a b`",
  linters = keyword_quote_linter()
)