Package 'checklist'

Description

• check_package: add a package check badge

• check_project: add a project check badge

• doi: add a DOI badge

• url: add a website badge

• version: add a version badge

Usage

add_badges(x = ".", ...)

Arguments

See Also

Other both: check_filename(), check_lintr(), check_spelling(), custom_dictionary(), default_organisation(), print.checklist_spelling(), read_checklist(), read_organisation(), update_citation(), write_checklist(), write_citation_cff(), write_organisation(), write_zenodo_json()

Examples

## Not run: 
  add_badges(url = "https://www.inbo.be")
  add_badges(doi = "10.5281/zenodo.8063503")
  add_badges(check_project = "inbo/checklist")
  add_badges(check_package = "inbo/checklist")
  add_badges(version = "v0.1.2")
  add_badges(url = "https://www.inbo.be", doi = "10.5281/zenodo.8063503")

## End(Not run)

Description

Ask for rights holder or funder

Usage

ask_rightsholder_funder(org, type = c("rightsholder", "funder"))

Arguments

Value

A list with the selected names and the updated organisation object

See Also

Other utils: ask_yes_no(), author2df(), bookdown_zenodo(), c_sort(), create_hexsticker(), execshell(), get_default_org_list(), inbo_org_list(), install_pak(), menu_first(), store_authors(), use_author(), validate_email(), validate_orcid(), yesno()

Description

Function to ask a simple yes no question Provides a simple wrapper around utils::askYesNo(). This function is used to ask questions in an interactive way. It repeats the question until a valid answer is given.

Usage

ask_yes_no(msg, default = TRUE, prompts = c("Yes", "No", "Cancel"), ...)

Arguments

See Also

Other utils: ask_rightsholder_funder(), author2df(), bookdown_zenodo(), c_sort(), create_hexsticker(), execshell(), get_default_org_list(), inbo_org_list(), install_pak(), menu_first(), store_authors(), use_author(), validate_email(), validate_orcid(), yesno()

Description

Results in a data.frame with the given name, family name, e-mail, ORCID, affiliation and role. Missing elements result in an empty string (""). Persons with multiple roles will have the roles as a comma separated string.

Usage

author2df(person)

Arguments

See Also

Other utils: ask_rightsholder_funder(), ask_yes_no(), bookdown_zenodo(), c_sort(), create_hexsticker(), execshell(), get_default_org_list(), inbo_org_list(), install_pak(), menu_first(), store_authors(), use_author(), validate_email(), validate_orcid(), yesno()

Description

First clears all the existing files in the output_dir set in ⁠_bookdown_.yml⁠. Then renders all required output formats and uploads them to Zenodo. bookdown_zenodo() creates a draft record when you don't specify a community in the yaml. Otherwise it creates a review request for the first community.

Usage

bookdown_zenodo(
  path,
  zip_format = c("bookdown::gitbook", "INBOmd::gitbook"),
  single_format = c("bookdown::pdf_book", "bookdown::epub_book", "INBOmd::pdf_report",
    "INBOmd::epub_book"),
  token,
  sandbox = TRUE,
  logger = "INFO"
)

Arguments

See Also

Other utils: ask_rightsholder_funder(), ask_yes_no(), author2df(), c_sort(), create_hexsticker(), execshell(), get_default_org_list(), inbo_org_list(), install_pak(), menu_first(), store_authors(), use_author(), validate_email(), validate_orcid(), yesno()

Description

Setting the locale before sorting ensures a stable sorting order

Usage

c_sort(x, ...)

Arguments

See Also

Other utils: ask_rightsholder_funder(), ask_yes_no(), author2df(), bookdown_zenodo(), create_hexsticker(), execshell(), get_default_org_list(), inbo_org_list(), install_pak(), menu_first(), store_authors(), use_author(), validate_email(), validate_orcid(), yesno()

Description

Use the checks from codemetar::give_opinions().

Usage

check_codemeta(x = ".")

Arguments

Value

A checklist object.

See Also

Other package: check_cran(), check_description(), check_documentation(), check_environment(), check_license(), check_package(), tidy_desc()

Description

CRAN imposes an impressive list of tests on every package before publication. This suite of test is available in every R installation. Hence we use this full suite of tests too. Notice that check_package() runs several additional tests.

Usage

check_cran(x = ".", quiet = FALSE)

Arguments

Value

A checklist object.

See Also

Other package: check_codemeta(), check_description(), check_documentation(), check_environment(), check_license(), check_package(), tidy_desc()

Description

The DESCRIPTION file contains the most important meta-data of the package. A good DESCRIPTION is tidy, has a meaningful version number, full author details and a clear license.

Usage

check_description(x = ".")

Arguments

Details

This function ensures the DESCRIPTION is tidy, using tidy_desc().

The version number of the package must have either a 0.0 or a ⁠0.0.0⁠ format (see this discussion why we allow only these formats). The version number in every branch must be larger than the current version number in the main or master branch. New commits in the main or master must have a larger version number than the previous commit. We recommend to protect the main or master branch and to not commit into the main or master.

Furthermore we check the author information.

• Is INBO listed as copyright holder and funder?

• Has every author an ORCID?

We check the license through check_license().

See Also

Other package: check_codemeta(), check_cran(), check_documentation(), check_environment(), check_license(), check_package(), tidy_desc()

Description

The function make sure that the documentation is up to date. Rules:

• You must use roxygen2 to document the functions.

• If you use a README.Rmd, it should be rendered. You need at least a README.md.

• Don't use a NEWS.Rmd but a NEWS.md.

• NEWS.md must contain an entry for the current package version.

Usage

check_documentation(x = ".", quiet = FALSE)

Arguments

Details

The function generates the help files from the roxygen2 tag in the R code. Then it checks whether any of the help files changed. We use the same principle with the README.Rmd. If any file changed, the documentation does not match the code. Hence check_documentation() returns an error.

A side effect of running check_documentation() locally, is that it generates all the documentation. So the only thing left for you to do, is to commit these changes. Pro tip: make sure RStudio renders the roxygen2 tags whenever you install and restart the package. We describe this in vignette("getting_started") under "Prepare local setup".

Required format for NEWS.md

# package_name version

* Description of something that changed.
* Lines should not exceed 80 characters.
  Start a new line with two space to continue an item.
* Add a single blank line before and after each header.

## Second level heading

* You can use second level headings when you want to add more structure.

 # `package_name` version

 * Adding back ticks around the package name is allowed.

See Also

Other package: check_codemeta(), check_cran(), check_description(), check_environment(), check_license(), check_package(), tidy_desc()

Description

Some actions will fail when these environment variables are not set. This function does only work on GitHub.

Usage

check_environment(x = ".")

Arguments

Value

An invisible checklist object.

See Also

Other package: check_codemeta(), check_cran(), check_description(), check_documentation(), check_license(), check_package(), tidy_desc()

Description

A consistent naming schema avoids problems when working together, especially when working with different OS. Some OS (e.g. Windows) are case-insensitive whereas others (e.g. Linux) are case-sensitive. Note that the checklist GitHub Actions will test your code on Linux, Windows and MacOS.

Usage

check_filename(x = ".")

Arguments

Details

The sections below describe the default rules. We allow several exceptions when the community standard is different. E.g. a package stores the function scripts in the R folder, while our standard enforces lower case folder names. Use the community standard, even if it does not conform with the checklist rules. Most likely checklist will have an exception for the name. If not, you can file an issue and motivate why you think we should add an exception.

Rules for folder names

• Folder names should only contain lower case letters, numbers, dashes (-) and underscores (⁠_⁠).

• They can start with a single dot (.).

Default rules for file names

• Base names should only contain lower case letters, numbers, dashes (-) and underscores (⁠_⁠).

• File extensions should only contain lower case letters and numbers. Exceptions: file extensions related to R must have an upper case R ( .R, .Rd, .Rda, .Rnw, .Rmd, .Rproj). Exception to these exceptions: R/sysdata.rda.

Exceptions for some file formats

Underscores (⁠_⁠) causes problems for graphical files when using LaTeX to create pdf output. This is how we generate pdf output from rmarkdown. Therefore you need to use a dash (-) as separator instead of an underscores (⁠_⁠). Applies to files with extensions csl, eps, gif, jpg, jpeg, pdf, png, ps, svg, tiff, tif, wmf and .cls.

We ignore files with .otf or .ttf extensions. These are fonts files which often require their own file name scheme.

See Also

Other both: add_badges(), check_lintr(), check_spelling(), custom_dictionary(), default_organisation(), print.checklist_spelling(), read_checklist(), read_organisation(), update_citation(), write_checklist(), write_citation_cff(), write_organisation(), write_zenodo_json()

Description

For the time being, this function only checks projects. Keep in mind that R packages have requirements for the folder structure. That is one of things that check_cran() checks.

Usage

check_folder(x = ".")

Arguments

Recommended folder structure

• source: contains all R scripts and Rmd files.

• data: contains all data files.

source

A simple project with only R scripts or only Rmd files can place all the files directly in the source folder.

More elaborate projects should place in the files in several folders under source. Place every bookdown document in a dedicated folder. And create an RStudio project for that folder.

data

Simple projects in which source has no subfolders, place data at the root of the project. For more elaborate project you must choose between either data at the root of the project or data as subfolder of the subfolders of source. E.g. source/report/data.

Place the data in an open file format. E.g. csv, txt or tsv for tabular data. We strongly recommend to use git2rdata::write_vc() to store such data. Use the geopackage format for spatial data. Optionally add description of the data as markdown files.

See Also

Other project: check_project(), check_source()

Description

Every package needs a clear license. Without a license, the end-users have no clue under what conditions they can use the package. You must specify the license in the DESCRIPTION and provide a LICENSE.md file.

Usage

check_license(x = ".", org)

Arguments

Details

This functions checks if the DESCRIPTION mentions one of the standard licenses. The LICENSE.md must match this license. Use setup_package() to add the correct LICENSE.md to the package.

Currently, following licenses are allowed:

• GPL-3

• MIT

We will consider pull requests adding support for other open source licenses.

See Also

Other package: check_codemeta(), check_cran(), check_description(), check_documentation(), check_environment(), check_package(), tidy_desc()

Description

This functions does static code analysis. It relies on lintr::lint_package(). We recommend that you activate all code diagnostics in RStudio to help meeting the requirements. You can find this in the menu Tools > Global options > Code > Diagnostics. Please have a look at vignette("philosophy") for more details on the rules.

Usage

check_lintr(x = ".", quiet = FALSE)

Arguments

Details

When check_lintr() runs on a git repository, it checks whether the organisation has a custom .lintr file in their checklist repository. If so, it uses this file. Otherwise it looks for a local .lintr file in the project directory. If this file is not present, it uses the default .lintr file provided with the checklist package.

See Also

Other both: add_badges(), check_filename(), check_spelling(), custom_dictionary(), default_organisation(), print.checklist_spelling(), read_checklist(), read_organisation(), update_citation(), write_checklist(), write_citation_cff(), write_organisation(), write_zenodo_json()

Description

A convenience function that runs all packages related tests in sequence. The details section lists the relevant functions. After fixing a problem, you can quickly check if it is solved by running only the related check. But we still recommend to run check_package() before you push to GitHub. And only push when the functions indicate that there are no problems. This catches most problems before sending the code to GitHub.

Usage

check_package(
  x = ".",
  fail = !interactive(),
  pkgdown = interactive(),
  quiet = FALSE
)

Arguments

Details

List of checks in order:

1. check_cran()

2. check_lintr()

3. check_filename()

4. check_description()

5. check_documentation()

6. check_codemeta()

See Also

Other package: check_codemeta(), check_cran(), check_description(), check_documentation(), check_environment(), check_license(), tidy_desc()

Description

Set or update the required checks via setup_project().

Usage

check_project(x = ".", fail = !interactive(), quiet = FALSE)

Arguments

See Also

Other project: check_folder(), check_source()

Description

Defunct function. Please use check_project() instead.

Usage

check_source(x = ".", fail = !interactive())

Arguments

See Also

Other project: check_folder(), check_project()

Description

This function checks by default any markdown (.md) or Rmarkdown (.Rmd) file found within the project. It also checks any R help file (.Rd) in the man folder. Use the set_exceptions() method of the checklist object to exclude files or use a different language. Have a look at vignette("spelling", package = "checklist") for more details.

Usage

check_spelling(x = ".", quiet = FALSE)

Arguments

See Also

Other both: add_badges(), check_filename(), check_lintr(), custom_dictionary(), default_organisation(), print.checklist_spelling(), read_checklist(), read_organisation(), update_citation(), write_checklist(), write_citation_cff(), write_organisation(), write_zenodo_json()

Description

A class which contains all checklist results.

Super class

checklist::spelling -> checklist

Public fields

Active bindings

Methods

Public methods

• checklist$add_error()

• checklist$add_linter()

• checklist$add_motivation()

• checklist$add_notes()

• checklist$add_rcmdcheck()

• checklist$add_spelling()

• checklist$add_warnings()

• checklist$allowed()

• checklist$confirm_motivation()

• checklist$new()

• checklist$print()

• checklist$set_pak()

• checklist$set_required()

• checklist$clone()

Method add_error()

Add errors

Usage

checklist$add_error(errors, item, keep = TRUE)

Arguments

Method add_linter()

Add results from lintr::lint_package()

Usage

checklist$add_linter(linter, error = FALSE)

Arguments

Method add_motivation()

Add motivation for allowed issues.

Usage

checklist$add_motivation(which = c("warnings", "notes"))

Arguments

Method add_notes()

Add notes

Usage

checklist$add_notes(notes, item)

Arguments

Method add_rcmdcheck()

Add results from rcmdcheck::rcmdcheck

Usage

checklist$add_rcmdcheck(errors, warnings, notes)

Arguments

Method add_spelling()

Add results from check_spelling()

Usage

checklist$add_spelling(issues)

Arguments

Method add_warnings()

Add warnings

Usage

checklist$add_warnings(warnings, item)

Arguments

Method allowed()

Add allowed warnings and notes

Usage

checklist$allowed(
  warnings = vector(mode = "list", length = 0),
  notes = vector(mode = "list", length = 0)
)

Arguments

Method confirm_motivation()

Confirm the current motivation for allowed issues.

Usage

checklist$confirm_motivation(which = c("warnings", "notes"))

Arguments

Method new()

Initialize a new checklist object.

Usage

checklist$new(x = ".", language, package = TRUE)

Arguments

Method print()

Print the checklist object. Add quiet = TRUE to suppress printing.

Usage

checklist$print(...)

Arguments

Method set_pak()

Set packages to install with pak::pkg_install().

Usage

checklist$set_pak(pkg = character(0))

Arguments

Method set_required()

set required checks

Usage

checklist$set_required(checks = character(0))

Arguments

Method clone()

The objects of this class are cloneable with this method.

Usage

checklist$clone(deep = FALSE)

Arguments

See Also

Other class: citation_meta, org_item, org_list, organisation, spelling

Description

A class which contains citation information.

Active bindings

Methods

Public methods

• citation_meta$new()

• citation_meta$print()

• citation_meta$clone()

Method new()

Initialize a new citation_meta object.

Usage

citation_meta$new(path = ".")

Arguments

Method print()

Print the citation_meta object.

Usage

citation_meta$print(...)

Arguments

Method clone()

The objects of this class are cloneable with this method.

Usage

citation_meta$clone(deep = FALSE)

Arguments

See Also

Other class: checklist, org_item, org_list, organisation, spelling

Description

• update local branches that are behind their counterpart on origin.

• list local branches that have diverged from their counterpart the origin.

• list local branches without counterpart on origin that have diverged from the main branch.

• remove local branches without counterpart on origin and fully merged into the main branch.

• remove local copies of origin branches deleted at the origin.

Usage

clean_git(repo = ".", verbose = TRUE)

Arguments

See Also

Other git: create_draft_pr(), get_branches_tags(), is_repository(), is_workdir_clean(), new_branch(), set_tag()

Description

This function creates a draft pull request for the current version of the package.

Usage

create_draft_pr(x = ".")

Arguments

See Also

Other git: clean_git(), get_branches_tags(), is_repository(), is_workdir_clean(), new_branch(), set_tag()

Description

This function makes a hexagonal logo in INBO style for the provided package name.

Usage

create_hexsticker(
  package_name,
  filename = path("man", "figures", "logo.svg"),
  icon,
  x = 0,
  y = 0,
  scale = 1
)

Arguments

Value

A figure is saved in the working directory or provided path.

See Also

Other utils: ask_rightsholder_funder(), ask_yes_no(), author2df(), bookdown_zenodo(), c_sort(), execshell(), get_default_org_list(), inbo_org_list(), install_pak(), menu_first(), store_authors(), use_author(), validate_email(), validate_orcid(), yesno()

Examples

## Not run: 
# make tempfile to save logo (or just use (path and) filename)
#' output <- tempfile(pattern = "hexsticker", fileext = ".svg")
create_hexsticker("checklist", filename = output)

## End(Not run)

Description

Creates a package template in a new folder. Use this function when you want to start a new package. Please DO READ vignette("getting_started") before running this function.

Usage

create_package(package, path = ".")

Arguments

Details

What you get with a checklist setup:

• minimal folder structure and files required for an R package using INBO guidelines with GPL-3 or MIT license.

• an RStudio project file

• a local git repository

• an initial NEWS.md file

• a template for an README.Rmd

• set-up for automated checks and releases of the package using GitHub Actions.

• a code of conduct and contributing guidelines.

• the set-up for a pkgdown website using the INBO corporate identity.

See Also

Other setup: create_project(), new_org_list(), prepare_ghpages(), set_license(), setup_package(), setup_project(), setup_source()

Description

This function creates a new RStudio project with checklist functionality.

Usage

create_project(path, project)

Arguments

See Also

Other setup: create_package(), new_org_list(), prepare_ghpages(), set_license(), setup_package(), setup_project(), setup_source()

Description

Add words to custom dictionaries

Usage

custom_dictionary(issues)

Arguments

See Also

Other both: add_badges(), check_filename(), check_lintr(), check_spelling(), default_organisation(), print.checklist_spelling(), read_checklist(), read_organisation(), update_citation(), write_checklist(), write_citation_cff(), write_organisation(), write_zenodo_json()

Description

Store the default organisation rules. First run org <- organisation$new() with the appropriate argument. Next you can store the configuration with default_organisation(org).

Usage

default_organisation(org = organisation$new())

Arguments

See Also

Other both: add_badges(), check_filename(), check_lintr(), check_spelling(), custom_dictionary(), print.checklist_spelling(), read_checklist(), read_organisation(), update_citation(), write_checklist(), write_citation_cff(), write_organisation(), write_zenodo_json()

Description

Cross-platform function to pass a command to the shell, using either base::system() or (Windows-only) base::shell(), depending on the operating system.

Usage

execshell(commandstring, intern = FALSE, path = ".", ...)

Arguments

See Also

Other utils: ask_rightsholder_funder(), ask_yes_no(), author2df(), bookdown_zenodo(), c_sort(), create_hexsticker(), get_default_org_list(), inbo_org_list(), install_pak(), menu_first(), store_authors(), use_author(), validate_email(), validate_orcid(), yesno()

Description

Get branches and tags of a GitHub repository

Usage

get_branches_tags(owner, repo)

Arguments

Value

A sorted character vector of branch and tag names, excluding the gh-pages branch.

See Also

Other git: clean_git(), create_draft_pr(), is_repository(), is_workdir_clean(), new_branch(), set_tag()

Description

This function retrieves the default organisation list from the organisation.yml file in the organisations checklist repository. The origin of the repository is used to determine the root URL of the organisation.

Usage

get_default_org_list(x = ".")

Arguments

Value

An org_list object containing the organisation list. The function also stores the information in the user's R configuration.

See Also

Other utils: ask_rightsholder_funder(), ask_yes_no(), author2df(), bookdown_zenodo(), c_sort(), create_hexsticker(), execshell(), inbo_org_list(), install_pak(), menu_first(), store_authors(), use_author(), validate_email(), validate_orcid(), yesno()

Description

The INBO organisation list

Usage

inbo_org_list()

See Also

Other utils: ask_rightsholder_funder(), ask_yes_no(), author2df(), bookdown_zenodo(), c_sort(), create_hexsticker(), execshell(), get_default_org_list(), install_pak(), menu_first(), store_authors(), use_author(), validate_email(), validate_orcid(), yesno()

Description

Install extra packages defined in checklist.yml

Usage

install_pak(x = ".", ...)

Arguments

See Also

Other utils: ask_rightsholder_funder(), ask_yes_no(), author2df(), bookdown_zenodo(), c_sort(), create_hexsticker(), execshell(), get_default_org_list(), inbo_org_list(), menu_first(), store_authors(), use_author(), validate_email(), validate_orcid(), yesno()

Description

The path arguments specifies the directory at which to start the search for a git repository. If it is not a git repository itself, then its parent directory is consulted, then the parent's parent, and so on.

Usage

is_repository(path = ".")

Arguments

Value

TRUE if directory is in a git repository else FALSE

See Also

Other git: clean_git(), create_draft_pr(), get_branches_tags(), is_workdir_clean(), new_branch(), set_tag()

Description

A clean working directory has no staged, unstaged or untracked files.

Usage

is_workdir_clean(repo)

Arguments

Value

TRUE when there are no staged, unstaged or untracked files. Otherwise FALSE

See Also

Other git: clean_git(), create_draft_pr(), get_branches_tags(), is_repository(), new_branch(), set_tag()

Description

Improved version of menu()

Usage

menu_first(choices, graphics = FALSE, title = NULL)

Arguments

See Also

Other utils: ask_rightsholder_funder(), ask_yes_no(), author2df(), bookdown_zenodo(), c_sort(), create_hexsticker(), execshell(), get_default_org_list(), inbo_org_list(), install_pak(), store_authors(), use_author(), validate_email(), validate_orcid(), yesno()

Description

This functions first runs clean_git(). Then it creates the new branch from the (updated) main branch.

Usage

new_branch(branch, verbose = TRUE, checkout = TRUE, repo = ".")

Arguments

See Also

Other git: clean_git(), create_draft_pr(), get_branches_tags(), is_repository(), is_workdir_clean(), set_tag()

Description

An interactive alternative for org_list$new(). Reuses available organisations where possible.

Usage

new_org_list(git)

Arguments

See Also

org_list, org_item

Other setup: create_package(), create_project(), prepare_ghpages(), set_license(), setup_package(), setup_project(), setup_source()

Description

A class containing a single organisation

Active bindings

Methods

Public methods

• org_item$new()

• org_item$as_person()

• org_item$compare_by_name()

• org_item$get_license()

• org_item$get_pkgdown()

• org_item$print()

• org_item$clone()

Method new()

Initialize a new org_item object.

Usage

org_item$new(
  name,
  email,
  orcid = FALSE,
  rightsholder = c("optional", "single", "shared", "when no other"),
  funder = c("optional", "single", "shared", "when no other"),
  license = list(package = c(`GPL-3.0` =
    paste("https://raw.githubusercontent.com/inbo/checklist/refs/heads/main",
    "inst/generic_template/gplv3.md", sep = "/"), MIT =
    paste("https://raw.githubusercontent.com/inbo/checklist/refs/heads/main",
    "inst/generic_template/mit.md", sep = "/")), project = c(`CC BY 4.0` =
    paste("https://raw.githubusercontent.com/inbo/checklist/refs/heads/main",
    "inst/generic_template/cc_by_4_0.md", sep = "/")), data = c(CC0 =
    paste("https://raw.githubusercontent.com/inbo/checklist",
    "131fe5829907079795533bfea767bf7df50c3cfd/inst/generic_template", 
     "cc0.md", sep
    = "/"))),
  ror = "",
  zenodo = "",
  website = "",
  logo = ""
)

Arguments

Method as_person()

as_person The organisation as a person.

Usage

org_item$as_person(lang = names(private$name)[1], role = c("cph", "fnd"))

Arguments

Method compare_by_name()

Compares the number of matching words with the organisation name. Either Inf when there is a perfect match. Otherwise a number between 0 and 1 indicating the ratio of the matching words with the total number of words in name. A value of 1 means that all words in name are present in one of the organisation names but in a different order.

Usage

org_item$compare_by_name(name)

Arguments

Method get_license()

Get the organisation license.

Usage

org_item$get_license(type = c("package", "project", "data", "all"))

Arguments

Returns

A named character vector with the allowed licenses.

Method get_pkgdown()

The pkgdown author field.

Usage

org_item$get_pkgdown(lang)

Arguments

Method print()

Print the org_item object.

Usage

org_item$print()

Method clone()

The objects of this class are cloneable with this method.

Usage

org_item$clone(deep = FALSE)

Arguments

See Also

Other class: checklist, citation_meta, org_list, organisation, spelling

Description

A class containing a list of organisations

Active bindings

Methods

Public methods

• org_list$add_item()

• org_list$check()

• org_list$get_allowed_licenses()

• org_list$get_person()

• org_list$get_zenodo_by_email()

• org_list$get_match()

• org_list$get_name_by_domain()

• org_list$get_pkgdown()

• org_list$new()

• org_list$print()

• org_list$read()

• org_list$validate_person()

• org_list$validate_rules()

• org_list$write()

• org_list$clone()

Method add_item()

Add one or more org_item objects to the list.

Usage

org_list$add_item(...)

Arguments

Method check()

Check if the organisation list is compatible with the default as set in the organisations git repository.

Usage

org_list$check(x = ".")

Arguments

Method get_allowed_licenses()

Return the allowed licenses.

Usage

org_list$get_allowed_licenses(
  email = character(0),
  type = c("package", "project", "data", "all")
)

Arguments

Method get_person()

Return the organisation with matching email as a person().

Usage

org_list$get_person(email, role = c("cph", "fnd"), lang)

Arguments

Method get_zenodo_by_email()

Return a vector of Zenodo communities associated with the organisations with matching email.

Usage

org_list$get_zenodo_by_email(email)

Arguments

Returns

A character vector with the communities.

Method get_match()

Return the organisation with a matching name.

Usage

org_list$get_match(name)

Arguments

Returns

A list with the organisation name, email and match ratio.

Method get_name_by_domain()

Return the organisation names with a matching email domain.

Usage

org_list$get_name_by_domain(email, lang)

Arguments

Details

The function extracts the domain from the email address and matches it against the organisation email addresses. If multiple organisations have the same domain, the function returns all matching names. If the language is not available for a specific organisation, it will return the first available name.

Returns

A character vector with the organisation names.

Method get_pkgdown()

get_pkgdown The pkgdown author field

Usage

org_list$get_pkgdown(lang)

Arguments

Method new()

Initialize a new org_list object.

Usage

org_list$new(..., git = character(0))

Arguments

Method print()

Print the org_list object.

Usage

org_list$print()

Method read()

Read the org_list object from an organisation.yml file.

Usage

org_list$read(x = ".")

Arguments

Method validate_person()

Validate a person object given the org_list object.

Usage

org_list$validate_person(person, lang)

Arguments

Method validate_rules()

Validate the rules for the rightsholder and funder.

Usage

org_list$validate_rules(rightsholder = person(), funder = person())

Arguments

Method write()

Write the org_list object to an organisation.yml file.

Usage

org_list$write(x = ".", license = FALSE)

Arguments

Returns

The path to the written organisation.yml file.

Method clone()

The objects of this class are cloneable with this method.

Usage

org_list$clone(deep = FALSE)

Arguments

See Also

Other class: checklist, citation_meta, org_item, organisation, spelling

Description

A class with the organisation defaults

Active bindings

Methods

Public methods

• organisation$new()

• organisation$print()

• organisation$clone()

Method new()

Initialize a new organisation object.

Usage

organisation$new(...)

Arguments

Details

• github: the name of the github organisation. Set to NA_character_ in case you don't want a mandatory github organisation.

• community: the mandatory Zenodo community. Defaults to "inbo". Set to NA_character_ in case you don't want a mandatory community.

• email: the e-mail of the organisation. Defaults to "[email protected]". Set to NA_character_ in case you don't want an organisation e-mail.

• funder: the funder. Defaults to "Research Institute for Nature and Forest (INBO)". Set to NA_character_ in case you don't want to set a funder.

• rightsholder: the rightsholder. Defaults to "Research Institute for Nature and Forest (INBO)". Set to NA_character_ in case you don't want to set a rightsholder.

• organisation: a named list with one or more organisation default rules. The names of the element must match the e-mail domain name of the organisation. Every element should be a named list containing affiliation and orcid. affiliation is a character vector with the approved organisation names in one or more languages. orcid = TRUE indicated a mandatory ORCiD for every member. Use an empty list in case you don't want to set this.

Method print()

Print the organisation object.

Usage

organisation$print(...)

Arguments

Method clone()

The objects of this class are cloneable with this method.

Usage

organisation$clone(deep = FALSE)

Arguments

See Also

Other class: checklist, citation_meta, org_item, org_list, spelling

Description

Prepare a gh-pages branch with a place holder page

Usage

prepare_ghpages(x = ".", verbose = TRUE)

Arguments

See Also

Other setup: create_package(), create_project(), new_org_list(), set_license(), setup_package(), setup_project(), setup_source()

Description

Display a checklist_spelling summary

Usage

## S3 method for class 'checklist_spelling'
print(x, ...)

Arguments

See Also

Other both: add_badges(), check_filename(), check_lintr(), check_spelling(), custom_dictionary(), default_organisation(), read_checklist(), read_organisation(), update_citation(), write_checklist(), write_citation_cff(), write_organisation(), write_zenodo_json()

Description

The checklist package stores configuration information in the checklist.yml file in the root of a project. This function reads this configuration. It is mainly used by the other functions inside the package. If no checklist.yml file is found at the path, the function walks upwards through the directory structure until it finds such file. The function returns an error when it reaches the root of the disk without finding a checklist.yml file.

Usage

read_checklist(x = ".")

Arguments

Value

A checklist object.

See Also

Other both: add_badges(), check_filename(), check_lintr(), check_spelling(), custom_dictionary(), default_organisation(), print.checklist_spelling(), read_organisation(), update_citation(), write_checklist(), write_citation_cff(), write_organisation(), write_zenodo_json()

Description

The checklist package stores organisation information in the organisation.yml file in the root of a project.

Usage

read_organisation(x = ".")

Arguments

Value

An organisation object.

See Also

Other both: add_badges(), check_filename(), check_lintr(), check_spelling(), custom_dictionary(), default_organisation(), print.checklist_spelling(), read_checklist(), update_citation(), write_checklist(), write_citation_cff(), write_organisation(), write_zenodo_json()

Description

Set the proper license

Usage

set_license(x = ".", license, org)

Arguments

Value

Invisible NULL.

See Also

Other setup: create_package(), create_project(), new_org_list(), prepare_ghpages(), setup_package(), setup_project(), setup_source()

Description

This function is a part of the GitHub Action. Therefore it only works when run in a GitHub Action on the main or master branch. Otherwise it will only return a message. It sets a new tag at the current commit using the related entry from NEWS.md as message. This tag will turn into a release.

Usage

set_tag(x = ".")

Arguments

See Also

Other git: clean_git(), create_draft_pr(), get_branches_tags(), is_repository(), is_workdir_clean(), new_branch()

Description

Use this function when you have an existing package and you want to use the checklist functionality. Please keep in mind that the checklist is an opinionated list of checks. It might require some breaking changes in your package. Please DO READ vignette("getting_started") before running this function.

Usage

setup_package(path = ".")

Arguments

Details

What you get with a checklist setup:

• minimal folder structure and files required for an R package using INBO guidelines with GPL-3 or MIT license.

• an RStudio project file

• a local git repository

• an initial NEWS.md file

• a template for an README.Rmd

• set-up for automated checks and releases of the package using GitHub Actions.

• a code of conduct and contributing guidelines.

• the set-up for a pkgdown website using the INBO corporate identity.

See Also

Other setup: create_package(), create_project(), new_org_list(), prepare_ghpages(), set_license(), setup_project(), setup_source()

Description

Use this function to set-up or change the checklist infrastructure for an existing project. The function interactively asks questions to set-up the required checks.

Usage

setup_project(path = ".")

Arguments

See Also

Other setup: create_package(), create_project(), new_org_list(), prepare_ghpages(), set_license(), setup_package(), setup_source()

Description

This adds the required GitHub workflows to run check_source() automatically whenever you push commits to GitHub. It also adds a CC-BY 4.0 license file, a CODE_OF_CONDUCT.md and the checklist configuration file (checklist.yml).

Usage

setup_source(path = ".")

Arguments

See Also

Other setup: create_package(), create_project(), new_org_list(), prepare_ghpages(), set_license(), setup_package(), setup_project()

Description

A class with the configuration for spell checking

Active bindings

Methods

Public methods

• spelling$new()

• spelling$print()

• spelling$set_default()

• spelling$set_exceptions()

• spelling$set_ignore()

• spelling$set_other()

• spelling$clone()

Method new()

Initialize a new spelling object.

Usage

spelling$new(language, base_path = ".")

Arguments

Method print()

Print the spelling object.

Usage

spelling$print(...)

Arguments

Method set_default()

Define which files to ignore or to spell check in a different language.

Usage

spelling$set_default(language)

Arguments

Method set_exceptions()

Define which files to ignore or to spell check in a different language.

Usage

spelling$set_exceptions()

Method set_ignore()

Manually set the ignore vector. Only use this if you known what you are doing.

Usage

spelling$set_ignore(ignore)

Arguments

Method set_other()

Manually set the other list. Only use this if you known what you are doing.

Usage

spelling$set_other(other)

Arguments

Method clone()

The objects of this class are cloneable with this method.

Usage

spelling$clone(deep = FALSE)

Arguments

See Also

Other class: checklist, citation_meta, org_item, org_list, organisation

Description

Store author details for later usage

Usage

store_authors(x = ".")

Arguments

See Also

Other utils: ask_rightsholder_funder(), ask_yes_no(), author2df(), bookdown_zenodo(), c_sort(), create_hexsticker(), execshell(), get_default_org_list(), inbo_org_list(), install_pak(), menu_first(), use_author(), validate_email(), validate_orcid(), yesno()

Description

A tidy DESCRIPTION uses a strict formatting and order of key-value pairs. This function reads the current DESCRIPTION and overwrites it with a tidy version.

Usage

tidy_desc(x = ".")

Arguments

See Also

Other package: check_codemeta(), check_cran(), check_description(), check_documentation(), check_environment(), check_license(), check_package()

Description

The function extracts citation meta data from the project. Then it checks the required meta data. Upon success, it writes several files.

Usage

update_citation(x = ".", quiet = FALSE)

Arguments

Details

• .zenodo.json contains the citation information in the format that Zenodo requires.

• CITATION.cff provides the citation information in the format that GitHub requires.

• inst/CITATION provides the citation information in the format that R packages require. It is only relevant for packages.

Value

An invisible checklist object.

Note

Source of the citation meta data:

• package: DESCRIPTION

• project: README.md

Should you want to add more information to the inst/CITATION file, add it to that file outside ⁠# begin checklist entry⁠ and ⁠# end checklist entry⁠.

See Also

Other both: add_badges(), check_filename(), check_lintr(), check_spelling(), custom_dictionary(), default_organisation(), print.checklist_spelling(), read_checklist(), read_organisation(), write_checklist(), write_citation_cff(), write_organisation(), write_zenodo_json()

Description

Reuse existing author information or add a new author. Allows to update existing author information.

Usage

use_author(email, lang)

Arguments

Value

A data.frame with author information.

See Also

Other utils: ask_rightsholder_funder(), ask_yes_no(), author2df(), bookdown_zenodo(), c_sort(), create_hexsticker(), execshell(), get_default_org_list(), inbo_org_list(), install_pak(), menu_first(), store_authors(), validate_email(), validate_orcid(), yesno()

Description

It only checks the format of the text, not if the email address exists.

Usage

validate_email(email)

Arguments

Value

A logical vector.

See Also

Other utils: ask_rightsholder_funder(), ask_yes_no(), author2df(), bookdown_zenodo(), c_sort(), create_hexsticker(), execshell(), get_default_org_list(), inbo_org_list(), install_pak(), menu_first(), store_authors(), use_author(), validate_orcid(), yesno()

Description

Checks whether the ORCID has the proper format and the checksum.

Usage

validate_orcid(orcid)

Arguments

Value

A logical vector with the same length as the input vector.

See Also

Other utils: ask_rightsholder_funder(), ask_yes_no(), author2df(), bookdown_zenodo(), c_sort(), create_hexsticker(), execshell(), get_default_org_list(), inbo_org_list(), install_pak(), menu_first(), store_authors(), use_author(), validate_email(), yesno()

Description

checklist stores it configuration as a checklist.yml file. create_package(), setup_package() and setup_source() generate a default file. If you need to allow some warnings or notes, you need to update the configuration.

Usage

write_checklist(x = ".")

Arguments

Details

First run x <- checklist::check_package() or x <- checklist::check_source(). These commands run the checks and store the checklist object in the variable x. Next you can store the configuration with checklist::write_checklist(x). This will first list any existing allowed warnings or notes. For every one of them, choose whether you want to keep it or not. Next, the function presents every new warning or note which you may allow or not. If you choose to allow a warning or note, you must provide a motivation. Please provide a sensible motivation. Keep in mind that checklist.yml stores these motivations in plain text, so they are visible for other users. We use the yesno() function to make sure you carefully read the questions.

Caveat

When you allow a warning or note, this warning or note must appear. Otherwise you get a "missing warning" or "missing note" error. So if you fix an allowed warning or note, you need to rerun checklist::write_checklist(x) and remove the old version.

If you can solve a warning or note, then solve it rather than to allow it. Only allow a warning or note in case of a generic "problem" that you can't solve. The best example is the ⁠checking CRAN incoming feasibility ... NOTE New submission⁠ which appears when checking a package not on CRAN. That is should an allowed note as long as the package is not on CRAN. Or permanently when your package is not intended for CRAN.

Do not allow a warning or note to fix an issue specific to your machine. That will result in an error when checking the package on an other machine (e.g. GitHub actions).

See Also

Other both: add_badges(), check_filename(), check_lintr(), check_spelling(), custom_dictionary(), default_organisation(), print.checklist_spelling(), read_checklist(), read_organisation(), update_citation(), write_citation_cff(), write_organisation(), write_zenodo_json()

Description

This file format contains the citation information. It is supported by GitHub, Zenodo and Zotero. This function is super-seeded by update_citation().

Usage

write_citation_cff(x = ".", roles)

Arguments

Value

An invisible checklist object.

See Also

Other both: add_badges(), check_filename(), check_lintr(), check_spelling(), custom_dictionary(), default_organisation(), print.checklist_spelling(), read_checklist(), read_organisation(), update_citation(), write_checklist(), write_organisation(), write_zenodo_json()

Description

Store the organisation rules into organisation.yml file. First run org <- organisation$new() with the appropriate argument. Next you can store the configuration with write_organisation(org).

Usage

write_organisation(org, x = ".")

Arguments

See Also

Other both: add_badges(), check_filename(), check_lintr(), check_spelling(), custom_dictionary(), default_organisation(), print.checklist_spelling(), read_checklist(), read_organisation(), update_citation(), write_checklist(), write_citation_cff(), write_zenodo_json()

Description

Zenodo uses the .zenodo.json file to define the citation information. See the Zenodo developers website for more information.

Usage

write_zenodo_json(x = ".")

Arguments

Value

An invisible checklist object.

See Also

Other both: add_badges(), check_filename(), check_lintr(), check_spelling(), custom_dictionary(), default_organisation(), print.checklist_spelling(), read_checklist(), read_organisation(), update_citation(), write_checklist(), write_citation_cff(), write_organisation()

Description

A function that asks a yes or no question to the user

Usage

yesno(...)

Arguments

Value

A logical where TRUE implies a "yes" answer from the user.

Author(s)

Hadley Wickham [email protected] Largely based on devtools:::yesno(). The user gets three options in an random order: 2 for "no", 1 for "yes". The wording for "yes" and "no" is random as well. This forces the user to carefully read the question.

See Also

Other utils: ask_rightsholder_funder(), ask_yes_no(), author2df(), bookdown_zenodo(), c_sort(), create_hexsticker(), execshell(), get_default_org_list(), inbo_org_list(), install_pak(), menu_first(), store_authors(), use_author(), validate_email(), validate_orcid()