Package 'sitrep'

Display the available sitrep templates

Description

Display the available sitrep templates

Usage

available_sitrep_templates(categorise = FALSE, ...)

Arguments

categorise	if TRUE, the results are split into a list of outbreak and survey categories. Defaults to FALSE.
...	options to pass on to dir

Value

a vector of available templates in the sitrep package

Examples

available_sitrep_templates(categorise = TRUE)
available_sitrep_templates(categorise = TRUE, full.names = TRUE)

---

Run the templates found in the sitrep package.

Description

Run the templates found in the sitrep package.

Usage

check_sitrep_templates(
  templates = available_sitrep_templates(),
  path = tempdir(),
  quiet = FALSE,
  progress = FALSE,
  mustwork = FALSE,
  output_format = NULL,
  clean = TRUE
)

Arguments

templates	a vector of templates to create and render
path	a directory in which to store the templates
quiet	if FALSE (default), a message will be printed for every template.
progress	if TRUE, then the progress of the template is printed to screen (passed to the quiet argument of rmarkdown::render()). Defaults to FALSE
mustwork	if TRUE, then the templates must work for the function to succeed. Defaults to FALSE, which will simply print the errors.
output_format	a character defining the output formats to use for the template files. Defaults to the output_format defined in the templates (which is word_document), but can be modified to html_document for cross-platform cromulence checking.
clean	if TRUE (default), this will remove the previous output file before rendering.

Value

the path where the templates were built.

Examples

check_sitrep_templates("mortality")

---

Check if all sitrep dependencies are available

Description

Checks if all packages needed for the sitrep ecosystem are installed and loads properly. Useful for verifying offline readiness.

Usage

sitrep_check_deps(quiet = FALSE)

Arguments

quiet

Should output be suppressed? Default is FALSE

Value

Named logical vector indicating which packages are available. Names are package names, values are TRUE if available, FALSE otherwise.

Examples

# Check what's missing before going offline
sitrep_check_deps()

---

Check for function conflicts in sitrep ecosystem

Description

This function identifies any naming conflicts between functions in the sitrep ecosystem packages.

Usage

sitrep_conflicts()

Value

NULL (invisibly). Prints messages about conflicts to console.

---

List all functions in sitrep ecosystem

Description

Shows all available functions across the sitrep ecosystem packages.

Usage

sitrep_functions(pattern = NULL)

Arguments

pattern

Optional regex pattern to filter function names

Value

A data frame with columns 'package' and 'function_name', sorted by package and function name.

---

Install all sitrep ecosystem dependencies for offline use

Description

This function provides code to install all packages needed for the complete sitrep ecosystem, ensuring you have everything needed for working without internet connection.

Usage

sitrep_install_deps(
  upgrade = "ask",
  dependencies = TRUE,
  repos = getOption("repos"),
  quiet = FALSE,
  force = FALSE
)

Arguments

upgrade	Should packages be upgraded? Options: "ask", "always", "never". Default is "ask"
dependencies	Should dependencies be installed? Default is TRUE
repos	Repository to use. Default uses getOption("repos")
quiet	Should installation be quiet? Default is FALSE
force	Should installation proceed without prompts? Default is FALSE

Details

This function reads the sitrep DESCRIPTION file and provides code to install all packages listed in Depends, Imports, and Suggests fields. This ensures complete functionality in offline environments.

Value

Character vector of all dependency package names (invisibly).

Examples

# Install everything for offline field work (with prompts)
sitrep_install_deps()

# Install without prompts
sitrep_install_deps(force = TRUE)

# Install quietly without prompts or upgrades
sitrep_install_deps(upgrade = "never", quiet = TRUE, force = TRUE)

---