Package 'roxylint'

Description

Provided a list of linters for a given tag, iterate over linters to raise alerts during the documentation process.

Usage

check_linter(linters, tag, ...)

## Default S3 method:
check_linter(linters, tag, ...)

## S3 method for class 'list'
check_linter(linters, tag, ...)

## S3 method for class ''function''
check_linter(linters, tag, ...)

## S3 method for class 'character'
check_linter(linters, tag, message = NULL, ...)

Arguments

Value

TRUE, invisibly. However, this function is primarily used for its side-effect of raising alerts during documentation.

Methods (by class)

• check_linter(default): By default, no linting is performed

• check_linter(list): A list of functions or character regular expressions.

  If a character value is named, the name is used as the message for a alert that is raised when the expression does not match.

• check_linter(`function`): A function to evaluate for the given tag

  function's are evaluated with the following arguments:

  1. The roxygen2::roxy_tag()

  2. The contents of the tag's ⁠$val⁠, as named arguments

  Because the number of arguments might not be readily apparent, any function should accept a trailing ... argument.

  Provided functions may print lint output, or signal lint output with messages or warnings. A cli::cli_alert() will reflect the severity of the function used to emit the output.

• check_linter(character): A character regular expressions.

  If a character value is found, its value is assumed to be a regular expression which must match a given tag's raw content (the text as it appears in the roxygen2 header).

Description

Tools for inspecting roxygen2::roxy_tag()s. This can be helpful for exploring the intermediate tag objects. For example, you can use this function to generate a tag and explore the named values in ⁠$val⁠.

Usage

demo_tag(str)

Arguments

Value

A roxygen2::roxy_tag().

Examples

demo_tag("@param var abc")

Description

Preconfigured linters, either as a collective list of linters or individually. "tidy" linters implement guidelines from the tidyverse style guide.

Usage

lint_starts_lowercase(x, ...)

lint_full_stop(x, ...)

lint_no_full_stop(x, ...)

lint_sentence_case(x, ...)

lint_title_case(x, ...)

tidy_title(x, ...)

tidy_param(x, name, description, ...)

tidy_return(x, ...)

tidy_seealso(x, ...)

tidy

Arguments

Format

An object of class list of length 4.

Details

Refer to the individual roxygen2::roxy_tag() for the respective tag for argument details.

Functions

• lint_starts_lowercase(): Lowercase start linting. (uses ⁠$raw⁠ for roxygen2::roxy_tag()s)

• lint_full_stop(): Ends in a full stop. (uses ⁠$raw⁠ for roxygen2::roxy_tag()s)

• lint_no_full_stop(): Does not end in a full stop. (uses ⁠$raw⁠ for roxygen2::roxy_tag()s)

• lint_sentence_case(): Sentence case linting (uses ⁠$raw⁠ for roxygen2::roxy_tag()s)

• lint_title_case(): Title case linting

• tidy_title(): Tidy 'Sentence case' titles

• tidy_param(): Tidy 'Sentence case' ⁠@param⁠ definitions

• tidy_return(): Tidy 'Sentence case' ⁠@return⁠ definitions

• tidy_seealso(): Tidy 'Sentence case' ⁠@seealso⁠ definitions

• tidy: A list of all tidyverse style guide inspired linters

Description

A registration mechanism for other packages to provide linters, either for custom tags or to implement their own linting styles.

Usage

register_linters(..., linters = list(...), .overwrite = FALSE)

Arguments

Value

TRUE, invisibly.

Description

Roclets used to embed linters during documentation. To use, add the roclet in your DESCRIPTION file.

Usage

roxylint()

Details

Config/Needs/documentation: roxylint
Roxygen:
  list(
    markdown = TRUE,
    roclets = c("namespace", "rd", "roxylint::roxylint")
  )

Value

A roxylint roxygen2::roclet().