modules (version 0.4.0)

module: Define Modules in R

Description

Use module to define self contained organizational units. Modules have their own search path. import can be used to import packages. use can be used to import other modules.

Usage

module(expr = { }, topEncl = autoTopEncl(parent.frame()))
"print"(x, ...)
import(from, ..., where = parent.frame())
use(module, ..., attach = FALSE, reInit = TRUE, where = parent.frame())
expose(module, ..., reInit = TRUE, where = parent.frame())
export(..., where = parent.frame())
autoTopEncl(where)

Arguments

expr

an expression

topEncl

(environment) the root of the local search path. It is tried to find a good default via autoTopEncl.

x

a module

...

(character, or unquoted expression) names to import from package or names to export from module. For exports a character of length 1 with a leading "^" is interpreted as regular expression.

from

(character, or unquoted expression) a package name

where

(environment) important for testing

module

(character | module) a module as file or folder name or a list representing a module.

attach

(logical) whether to attach the module to the search path

reInit

(logical) whether to re-initialize module. This argument is passed to as.module.

Details

topEncl is the environment where the search of the module ends. autoTopEncl handles the different situations. In general it defaults to the base environment or the environment from which module has been called. If you are using use or expose refering to a module in a file, it will always be the base environment. When identical(topenv(parent.frame()), globalenv()) is false it (most likely) means that the module is part of a package. In that case the module defines a sub unit within a package but has access to the packages namespace. This is relevant when you use the function module explicitly. When you define a nested module which the module will connect to the calling environment.

import and use are no replacements for library and attach. Both will work when called in the .GlobalEnv but should only be used for development and debugging of modules.

export will never export a function with a leading "." in its name.

expose is similar to use but instead of attaching a module it will copy all elements into the calling environment. This means that all functions will be re-exported; if not stated otherwise using export.

Examples

## Not run: 
# vignette("modulesInR", "modules")
# ## End(Not run)