Skip to contents

Registers an explicit full extension chain for the current R session. The order of extensions is the S3 dispatch order, from outermost to innermost extension. For example c(mizerExtB = "1.2.0", mizerExtA = "0.4.1") dispatches to mizerExtB methods first, then mizerExtA methods, then base mizer methods.

Usage

registerExtensions(extensions, install = FALSE)

Arguments

extensions

A named character vector. Names are extension identifiers. Values are version strings, installation specifications, or NA_character_. Installed extensions only participate in S3 dispatch if they provide an S4 marker class with the same name. NA_character_ entries are treated as in-development dispatch extensions and mizer creates their marker classes automatically.

install

Logical. If TRUE, missing or outdated extension packages are installed via pak::pkg_install(). Version strings install from CRAN; other requirement strings (e.g. "user/repo@v1.2.0") are passed directly to pak and may refer to GitHub, local paths, or any other pak-supported source.

Value

The active maximal extension chain, invisibly.

Details

A session can handle objects whose extension chain is a suffix of the registered maximal chain. For example, after registering c(mizerExtB = "1.2.0", mizerExtA = "0.4.1"), objects using only c(mizerExtA = "0.4.1") are also valid.

For extension packages that register themselves incrementally from .onLoad, use registerExtension() instead.