Package {bigbang}

Type:	Package
Title:	Build 'Tidyverse'-Style Meta-Packages from Local Package Files
Version:	0.1.0
Description:	Creates meta-packages (in the style of the 'tidyverse') from locally stored package archives (.tar.gz, .zip). Designed for teams working behind institutional firewalls without access to package repositories. Resolves dependencies between local packages by building a dependency graph with topological ordering and cycle detection, classifies dependencies as local or CRAN, detects implicit dependencies by scanning source code, and generates the full meta-package scaffold including re-exports, vignettes and documentation.
License:	GPL (≥ 3)
URL:	https://github.com/sebollin/bigbang
BugReports:	https://github.com/sebollin/bigbang/issues
Encoding:	UTF-8
Language:	en
VignetteBuilder:	knitr
Depends:	R (≥ 3.6.0)
Imports:	brio, glue, utils, whisker
Suggests:	devtools, knitr, rmarkdown, testthat (≥ 3.0.0), withr
Config/testthat/edition:	3
Config/roxygen2/version:	8.0.0
NeedsCompilation:	no
Packaged:	2026-08-03 16:20:59 UTC; user
Author:	Sebastian Lucas [aut, cre], Richard Detomasi [ctb] (Suggested the initial idea of a metapackage builder)
Maintainer:	Sebastian Lucas <sebalucas@gmail.com>
Repository:	CRAN
Date/Publication:	2026-08-08 12:50:11 UTC

Deprecated Spanish alias for create_metapackage()

Description

Deprecated Spanish alias for create_metapackage()

Usage

crear_meta_paquete_local(
  nombre,
  paquetes_locales,
  ruta_instalables,
  ext = ".tar.gz",
  version = "0.1.0",
  ruta_destino,
  reexportar_funciones = FALSE,
  generar_documentacion = TRUE,
  mostrar_progreso = TRUE,
  autores =
    "person('First', 'Last', email = 'first.last@example.com', role = c('aut', 'cre'))",
  descripcion = "Local Package Metapackage",
  licencia = "MIT + file LICENSE",
  deps_adicionales = NULL,
  deps_ignorar = NULL,
  deps_imports = c("data.table", "dplyr", "ggplot2", "readr", "tibble", "tidyr", "xts",
    "zoo"),
  deps_forzar = NULL,
  verbose = FALSE
)

Arguments

Value

A bigbang_result, invisibly.

Build a local meta-package

Description

Creates the full structure and files of a meta-package that installs, manages and loads a set of locally stored R packages, resolving the dependencies between them with a graph-based (topologically ordered) approach.

Usage

create_metapackage(
  name,
  packages,
  pkg_dir,
  ext = ".tar.gz",
  version = "0.1.0",
  dest_dir,
  reexport = FALSE,
  document = TRUE,
  verbose = getOption("bigbang.verbose", interactive()),
  authors =
    "person('First', 'Last', email = 'first.last@example.com', role = c('aut', 'cre'))",
  description = "Local Package Metapackage",
  license = "MIT + file LICENSE",
  additional_deps = NULL,
  ignore_deps = NULL,
  import_deps = c("data.table", "dplyr", "ggplot2", "readr", "tibble", "tidyr", "xts",
    "zoo"),
  force_deps = NULL,
  debug = FALSE
)

Arguments

Details

The function performs the following steps:

1. Creates the basic R package structure (R, man, vignettes, etc.).

2. Detects dependencies between packages, both explicit (from DESCRIPTION) and implicit (found by scanning the source code).

3. Generates DESCRIPTION and NAMESPACE with the appropriate dependencies.

4. Creates a basic vignette documenting the meta-package.

5. Generates R files with functions to install and load the component packages:

   • ⁠<name>_install()⁠: installs the component packages from the local archives.

   • ⁠<name>_attach()⁠: attaches the components that are already installed.

   • ⁠<name>_detach()⁠: detaches all the meta-package's components.

   • ⁠<name>_packages()⁠: lists the included packages.

Installation is explicit: calling ⁠library(<meta>)⁠ attaches the components that are already installed and reports which ones are missing, but does not install anything or delete any files. To install the components from the local archives, the user calls ⁠<meta>_install()⁠. Installation resolves dependencies with a graph-based topological ordering that also detects circular dependencies.

Value

Invisibly, a bigbang_result containing the generated path, component archives, dependency classification, and documentation status.

Component installation

The generated meta-package installs component packages only when the user explicitly calls ⁠<meta>_install()⁠. Loading it with library() never installs packages. By default, the generated installer does not access a repository.

If reexport = TRUE, a reexports.R file is generated so users can reach the component functions directly through the meta-package (meta::fun() instead of component::fun()), tidyverse style.

Requirements

• The local packages must exist in pkg_dir with the given extension.

• Automatic documentation (document = TRUE) requires the devtools package.

Examples

archives <- system.file("extdata", package = "bigbang")
destination <- tempfile("bigbang-example-")
dir.create(destination)

result <- create_metapackage(
  name = "toyverse",
  packages = "toycomponent_0.1.0",
  pkg_dir = archives,
  dest_dir = destination,
  document = FALSE,
  verbose = FALSE,
  import_deps = character(),
  force_deps = character()
)
list.files(result$path)

unlink(destination, recursive = TRUE)

Diagnose implicit dependencies of local packages

Description

Scans local packages for references to the recommended packages 'Matrix' and 'class', which can cause ⁠R CMD check⁠ failures when they are used implicitly but not declared as dependencies.

Usage

diagnose_dependencies(packages, pkg_dir, ext = ".tar.gz")

Arguments

Details

Extracts and scans the R source of each package for patterns that suggest implicit use of 'Matrix' or 'class'. Useful for debugging ⁠R CMD check⁠ errors such as "there is no package called 'Matrix'" even when the package does not appear to use it directly.

Value

A named list with one entry per local package, each a list with two elements:

matrix_refs

Character vector of references to 'Matrix', with file and line.

class_refs

Character vector of references to 'class', with file and line.

Examples

archives <- system.file("extdata", package = "bigbang")
res <- diagnose_dependencies(
  packages = "toycomponent_0.1.0",
  pkg_dir = archives
)
res[["toycomponent_0.1.0"]]
lapply(res, function(x) x$matrix_refs)

Deprecated Spanish alias for diagnose_dependencies()

Description

Deprecated Spanish alias for diagnose_dependencies()

Usage

diagnosticar_dependencias(paquetes_locales, ruta_instalables, ext = ".tar.gz")

Arguments

Value

The result of diagnose_dependencies().

Deprecated Spanish alias for install_local_pkg()

Description

Deprecated Spanish alias for install_local_pkg()

Usage

install_loc_pkg_w_dep(
  nombre_paquete,
  ruta_instalables,
  ext = ".tar.gz",
  repos = getOption("repos"),
  cran_deps = c("skip", "error", "install"),
  verbose = getOption("bigbang.verbose", interactive())
)

Arguments

Value

The result of install_local_pkg().

Installation

This function installs packages into the user's active R library. Installation occurs only when the user calls the function; loading bigbang never installs packages. With the default cran_deps = "skip", it does not access the network.

Install a local package together with its dependencies

Description

Installs a package from a local archive. Dependencies available as local archives are installed recursively; missing non-local dependencies follow the explicit cran_deps policy. ZIP archives containing Meta/package.rds are treated as Windows binaries, while other ZIP archives are unpacked and installed as source packages.

Usage

install_local_pkg(
  package,
  pkg_dir,
  ext = ".tar.gz",
  repos = getOption("repos"),
  cran_deps = c("skip", "error", "install"),
  verbose = getOption("bigbang.verbose", interactive())
)

Arguments

Value

Invisibly, a list describing installed, failed, and skipped packages.

Installation

This function installs packages into the user's active R library. Installation occurs only when the user calls the function; loading bigbang never installs packages. With the default cran_deps = "skip", it does not access the network.

See Also

create_metapackage() for generating a meta-package with an explicit component installer.

Print an artifact scan

Description

Print an artifact scan

Usage

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

Arguments

Value

x, invisibly.

Print a local package installation result

Description

Print a local package installation result

Usage

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

Arguments

Value

x, invisibly.

Print a metapackage generation result

Description

Print a metapackage generation result

Usage

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

Arguments

Value

x, invisibly.

Scan a generated metapackage for historical deletion signatures

Description

Inspects a generated metapackage source directory, source archive, or installed package without loading it. The scanner looks for the historical V1, V2, V3, and V7 deletion signatures from the pre-release security investigation. Provenance is read from both the current generator fields and the legacy pre-rename fields so development artifacts remain classifiable.

Usage

scan_bigbang_artifact(path, dry_run = TRUE)

Arguments

Details

Installed packages are inspected through R's internal lazy-load database API. That code is isolated in .scan_installed_lazydb() and has been exercised with R 4.6.1. Because this is an internal R format, callers should re-run the scanner tests when adopting a new R minor release.

Value

A list with the artifact type, vulnerability flag, detected signatures, evidence locations, provenance fields, and R version used for the scan.

Examples

archives <- system.file("extdata", package = "bigbang")
destination <- tempfile("bigbang-scan-example-")
dir.create(destination)

result <- create_metapackage(
  name = "toyverse",
  packages = "toycomponent_0.1.0",
  pkg_dir = archives,
  dest_dir = destination,
  document = FALSE,
  verbose = FALSE,
  import_deps = character(),
  force_deps = character()
)
scan_bigbang_artifact(result$path)

unlink(destination, recursive = TRUE)