Modify field in model object — modify_model

Helper functions for updating fields in a bbi_{.model_type}_model object. Note that calling modify_model_field() or replace_model_field() directly is not recommended for most users because it requires knowing about the internal structure of the model object. Instead, we recommend using the friendlier helpers listed below in "See also" whenever possible.

Usage

modify_model_field(
  .mod,
  .field,
  .value,
  .append = TRUE,
  .remove = FALSE,
  .unique = TRUE,
  .char_value = TRUE
)

replace_model_field(.mod, .field, .old_val, .new_val)

Arguments

.mod: The bbi_{.model_type}_model object to modify
.field: Character scalar of the name of the component to modify
.value: Whatever is to be added to .mod[[.field]], typically a character vector (or a named list in the case of *_bbi_args()). If NULL or NA is passed and .append = FALSE then .field with be deleted from the object and corresponding YAML.
.append: If TRUE, the default, concatenate new values with currently present values. If FALSE, new values will overwrite old values.
.remove: If TRUE, .value with be removed from the .field instead of added. FALSE by default. Cannot have both .append and .remove be true in the same call.
.unique: If TRUE, the default, de-duplicate .mod[[.field]] after adding new values. If FALSE duplicate values will be kept.
.char_value: If TRUE, check that .value (after unlisting) is a character vector.
.old_val: The value to be replaced. If .old_val is not present in .mod[[.field]], function will warn user and return .mod unchanged.
.new_val: The value to insert in place of .old_val in .mod[[.field]].

Details

All functions in this family also check the object against the corresponding YAML with check_yaml_in_sync() before modifying it, and errors if they are out of sync. After the object has been modified they will write the modified object back to the YAML and update the model object in memory with an md5 digest of the newly written YAML.

Functions

replace_model_field(): Replace a single item in a model field