
Migration Utilities for RDS to JSON Conversion
Source:R/migration-utilities.R
boilerplate_migrate_to_json.Rd
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 fileserrors
: List of any errors encountered during migrationvalidation
: 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:
Scans source directory for RDS files
Creates timestamped backup if requested
Converts RDS to JSON format
Validates against schema if requested
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)
}
} # }