Skip to contents

Functions to help migrate from individual RDS files to unified JSON structure Migrate Boilerplate Database from RDS to JSON

Usage

boilerplate_migrate_to_json(
  source_path,
  output_path,
  format = c("unified", "separate"),
  validate = TRUE,
  backup = TRUE,
  quiet = FALSE
)

Arguments

source_path

Path to directory containing RDS files or single RDS file

output_path

Path where JSON files should be saved

format

Output format: "unified" (single JSON) or "separate" (one per category)

validate

Logical. Validate against JSON schema after conversion? Default is TRUE.

backup

Logical. Create backup of original files? Default is TRUE.

quiet

Logical. Suppress progress messages? Default is FALSE.

Value

List with migration results containing:

  • migrated: Character vector of successfully migrated files

  • errors: List of any errors encountered during migration

  • validation: Validation results if validate=TRUE

Details

Comprehensive migration tool that converts existing RDS-based boilerplate databases to JSON format. Supports both unified (single file) and separate (multiple files) output formats with optional schema validation.

The migration process:

  1. Scans source directory for RDS files

  2. Creates timestamped backup if requested

  3. Converts RDS to JSON format

  4. Validates against schema if requested

  5. Reports results and any issues

The "unified" format creates a single JSON file containing all categories, which is recommended for version control and collaborative workflows.

Examples

if (FALSE) { # \dontrun{
# Migrate from GitHub templates structure
results <- boilerplate_migrate_to_json(
  source_path = "~/templates/boilerplate_data",
  output_path = "~/my_project/boilerplate/data",
  format = "unified",
  validate = TRUE
)

# Check results
if (length(results$errors) == 0) {
  message("Migration successful!")
} else {
  print(results$errors)
}
} # }