dt2_update_libs: Update DataTables JS/CSS libraries (developer tool)

In DT2: 'DataTables' 2.x for R

Update DataTables JS/CSS libraries (developer tool)

Description

Checks for updates (respecting version constraints), patches version numbers in the source files, and optionally runs tools/get-dt2-libs.sh to download the new files.

Usage

dt2_update_libs(pkg_dir = ".", download = TRUE, dry_run = FALSE)

Arguments

pkg_dir	Path to the DT2 source root (the directory containing DESCRIPTION). Defaults to the current working directory.
download	Logical. If TRUE, runs the shell script after patching version numbers. Default TRUE.
dry_run	Logical. If TRUE, shows what would change without modifying any files. Default FALSE.

Details

This function only works from the package source tree (i.e. during development). It will refuse to run from an installed package.

The workflow is:

1. Query npm for the latest compatible version of every library.

2. Patch tools/get-dt2-libs.sh (version variables).

3. Patch R/dt2_extensions.R (extension registry).

4. Patch R/dt2_check_updates.R (core lib versions).

5. Patch R/dt2_deps.R (DataTables core version).

6. Run bash tools/get-dt2-libs.sh to download the files.

Version constraints prevent incompatible upgrades:

• jQuery is pinned to 3.x (DataTables 2 requires jQuery 3).

• pdfmake is pinned to 0.2.x (0.3.x has breaking changes and is not available on cdnjs).

• Bootstrap is pinned to 5.x.

Libraries marked as "PINNED" are skipped. Only "UPDATE" items are applied.

Value

Invisibly, a data.frame with the update results.

Examples

## Not run: 
# Developer-only tool: requires the DT2 package source tree
# (DESCRIPTION, tools/get-dt2-libs.sh, R/dt2_extensions.R, ...).
# It cannot run from an installed package, so it is not executable
# in CRAN check or from a regular user session.

# from the DT2 source root:
dt2_update_libs()

# preview changes without modifying anything:
dt2_update_libs(dry_run = TRUE)

## End(Not run)

DT2 documentation built on June 14, 2026, 9:06 a.m.