Create a tag-based linter configuration

Make a new list based on all linters provided by packages and tagged with tags. The result of this function is meant to be passed to the linters argument of lint(), or to be put in your configuration file.

Usage

linters_with_tags(tags, ..., packages = "lintr", exclude_tags = "deprecated")

Arguments

tags

Optional character vector of tags to search. Only linters with at least one matching tag will be returned. If tags is NULL, all linters will be returned. See available_tags("lintr") to find out what tags are already used by lintr.

...

Arguments of elements to change. If unnamed, the argument is automatically named. If the named argument already exists in the list of linters, it is replaced by the new element. If it does not exist, it is added. If the value is NULL, the linter is removed.

packages

A character vector of packages to search for linters.

exclude_tags

Tags to exclude from the results. Linters with at least one matching tag will not be returned. If except_tags is NULL, no linters will be excluded. Note that tags takes priority, meaning that any tag found in both tags and exclude_tags will be included, not excluded.

Value

A modified list of linters.

See also

• linters_with_defaults for basing off lintr's set of default linters.

• all_linters for basing off all available linters in lintr.

• available_linters to get a data frame of available linters.

• linters for a complete list of linters available in lintr.

Examples

# `linters_with_defaults()` and `linters_with_tags("default")` are the same:
all.equal(linters_with_defaults(), linters_with_tags("default"))
#> [1] TRUE

# Get all linters useful for package development
linters <- linters_with_tags(tags = c("package_development", "style"))
names(linters)
#>  [1] "assignment_linter"                "backport_linter"                 
#>  [3] "brace_linter"                     "commas_linter"                   
#>  [5] "commented_code_linter"            "conjunct_test_linter"            
#>  [7] "consecutive_assertion_linter"     "cyclocomp_linter"                
#>  [9] "expect_comparison_linter"         "expect_identical_linter"         
#> [11] "expect_length_linter"             "expect_named_linter"             
#> [13] "expect_not_linter"                "expect_null_linter"              
#> [15] "expect_s3_class_linter"           "expect_s4_class_linter"          
#> [17] "expect_true_false_linter"         "expect_type_linter"              
#> [19] "extraction_operator_linter"       "function_argument_linter"        
#> [21] "function_left_parentheses_linter" "implicit_assignment_linter"      
#> [23] "implicit_integer_linter"          "indentation_linter"              
#> [25] "infix_spaces_linter"              "keyword_quote_linter"            
#> [27] "library_call_linter"              "line_length_linter"              
#> [29] "numeric_leading_zero_linter"      "object_length_linter"            
#> [31] "object_name_linter"               "object_usage_linter"             
#> [33] "package_hooks_linter"             "paren_body_linter"               
#> [35] "pipe_call_linter"                 "pipe_consistency_linter"         
#> [37] "pipe_continuation_linter"         "quotes_linter"                   
#> [39] "repeat_linter"                    "semicolon_linter"                
#> [41] "spaces_inside_linter"             "spaces_left_parentheses_linter"  
#> [43] "T_and_F_symbol_linter"            "todo_comment_linter"             
#> [45] "trailing_blank_lines_linter"      "trailing_whitespace_linter"      
#> [47] "undesirable_function_linter"      "undesirable_operator_linter"     
#> [49] "unnecessary_concatenation_linter" "whitespace_linter"               
#> [51] "yoda_test_linter"                

# Get all linters tagged as "default" from lintr and mypkg
if (FALSE) {
  linters_with_tags("default", packages = c("lintr", "mypkg"))
}