getExperimentHubOption: Get and set options for default ExperimentHub behavior.

In Bioconductor/ExperimentHub: Client to access ExperimentHub resources

Get and set options for default ExperimentHub behavior.

Description

These functions get or set options for creation of new ‘ExperimentHub’ instances.

Usage

getExperimentHubOption(arg)
setExperimentHubOption(arg, value)

Arguments

arg	The character(1) hub options to set. see ‘Details’ for current options.
value	The value to be assigned to the hub option.

Details

Supported options include:

“URL”:

character(1). The base URL of the ExperimentHub. Default: https://experimenthub.bioconductor.org

“CACHE”:

character(1). The location of the hub cache. Default: “.ExperimentHub” in the user home directory.

“MAX_DOWNLOADS”:

numeric(1). The integer number of downloads allowed before triggering an error. This is to help avoid accidental download of a large number of ExperimentHub members.

“PROXY”:

Describes a proxy connection allowing Internet access, usually through a restrictive firewall. Setting this option sends all ExperimentHub requests through the proxy. Default: NULL.

In setExperimentHubOption("PROXY", value), value can be NULL or a well-formed URL as character(1). The URL can be completely specified by http://username:[e-mail]:8080; username:password and port (e.g. :8080) are optional.

Unfortunately unlike the previously used 'httr::set_config', there is no option to globally set the proxy for httr2 requests. To get around this you can also set a system wide environment variable "EXPERIMENT_HUB_PROXY" for ExperimentHub proxy or "HUB_PROXY" that will work across all Hub classes (e.g. AnnotationHub and ExperimentHub)

“LOCAL”:

logical(1). Should the ExperimentHub create a hub consisting only of previously downloaded resources. Default: FALSE.

“ASK”:

logical(1). TRUE/FALSE should the ExperimentHub ask if the hub location should be created. If FALSE, the default location will be used and created if it doesn't exist without asking. If TRUE will ask the user and if in a non interactive session utilize a temporary directoy for the caching. Default: TRUE.

Default values may also be determined by system and global R environment variables visible before the package is loaded. Use options or variables preceded by “EXPERIMENT_HUB_”, e.g., options(EXPERIMENT_HUB_MAX_DOWNLOADS=10) prior to package load sets the default number of downloads to 10.

Value

The requested or successfully set option.

Author(s)

Bioconductor Core Team

Examples

getExperimentHubOption("URL")
## Not run: 
setExperimentHubOption("CACHE", "~/.myHub")

## End(Not run)

Bioconductor/ExperimentHub documentation built on June 2, 2025, 7:18 a.m.