Make it easier to apply existing `Content` functions to lists of content

[toph-allen]

#463 (in flight at time of writing) modifies search_content() to return a list of Connect class objects.

Right now, the best way to call existing functions that operate on Content class objects is to use purrr::map(). This is pretty simple if there are no additional arguments passed, but if additional args were required, you'd have to use R's anonymous function syntax.

# Assume `old_content` is a list of content class objects that need to be locked.

length(old_content)
# [1] 48

# Use purrr::map to apply existing functions to the list.
old_content <- purrr::map(old_content, lock_content)

# When passing extra args
old_content <- purrr::map(old_content, \(x) lock_content(x, locked_message = "R version is too old."))

It would be nicer if you could just pass the list to the functions and have it work, like so:

old_content <- lock_content(old_content, locked_message = "R version is too old.")

This might require us modifying all the content functions.

[nealrichardson]

purrr::map() does let you pass extra args in ..., though I see their docs now discourage it: https://purrr.tidyverse.org/reference/map.html

lapply et al. also let you pass args in ...

[toph-allen]

Yeah, I saw that their docs discourage it. It sounds like it's discouraged not because it's going away, but for the sake of clarity in code and error messages.

I think it's probably not worth, like, adjusting all functions to work on lists now. Perhaps adjusting the documentation to show examples of using map or lapply on these lists is a better route for the short term.