Private Configuration for 'R' Packages

Set configuration options on a per-package basis. Options set by a given package only apply to that package, other packages are unaffected.

Linux Build Status Windows Build status Coverage Status

Easy way to create configuration parameters in your R package. Configuration values set in different packages are independent.

Call set_config() to set a configuration parameter. Call get_config() to query it.


Use the devtools package:


Typical usage

the CRAN version of the igraph package.

The igraph package has two ways of returning a set of vertices. Before version 1.0.0, it simply returned a numeric vector. From version 1.0.0 it sets an S3 class on this vector by default, but it has an option called that can be set to FALSE to request the old behavior.

The problem with the option is that it is global. Once set to FALSE (interactively or from a package), R will use that setting in all packages, which breaks packages that expect the new behavior.

pkgconfig solves this problem, by providing configuration settings that are private to packages. Setting a configuration key from a given package will only apply to that package.


Let's assume that two packages, pkgA and pkgB, both set the igraph option, but pkgA sets it to TRUE, and pkgB sets it to FALSE. Here is how their code will look.


pkgA imports set_config from the pkgconfig package, and sets the option from it's .onLoad function:

.onLoad <- function(lib, pkg) {
    pkgconfig::set_config("" = TRUE)


pkgB is similar, but it sets the option to FALSE:

.onLoad <- function(lib, pkg) {
    pkgconfig::set_config("" = FALSE)


The igraph package will use get_config to query the option, and will supply a fallback value for the cases when it is not set:

return_vs_es_default <- TRUE
# ...
igraph_func <- function() {
    # ...
    pkgconfig::get_config("", return_vs_es_default)
    # ...

If igraph_func is called from pkgA (maybe through other packages), get_config will return TRUE, and if it is called from pkgB, get_config will return FALSE. For all other packages the option is not set, and the default value is used, as specified in igraph.

What if pkgA calls pkgB?

It might happen that both pkgA and pkgB set an option, and pkgA also calls functions from pkgB, which in turn, might call igraph. In this case the package that is further down the call stack wins. In other words, if the call sequence looks like this:

... -> pkgA -> ... -> pkgB -> ... -> igraph

then pkgB's value is used in igraph. (Assuming the last ... does not contain a call to pkgA of course.)


Please comment in the Github issue tracker of the project.


MIT © Gábor Csárdi



No user visible changes, work around a CRAN check false positive.


No changes in functionality, only internal cleanup.


  • Can also be used from the global environment, not only from packages.
  • set_config_in() function, to allow custom APIs. This means that packages does not have to use set_config() and get_config(), but they can provide their own API.
  • Fix a get_config() bug, for composite values only the first element was returned.
  • Fix a bug when key was not set at all. In these cases fallback was ignored in get_config().


Initial release.

Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.


2.0.3 by Gábor Csárdi, 2 years ago

Report a bug at

Browse source code at

Authors: Gábor Csárdi

Documentation:   PDF Manual  

MIT + file LICENSE license

Imports utils

Suggests covr, testthat, disposables

Imported by RSQLite, hms, igraph, jtools, nombre, tibble.

Depended on by biospear.

See at CRAN