staticryptR (version 0.1.0)

staticryptr: Staticrypt Wrapper Function with Command Print Option and User-Specified String

Description

This function is an R wrapper for the Staticrypt CLI tool. It allows users to encrypt or decrypt files using various customizable options, includes type checking for each argument, offers the option to print the resulting command without executing it, and allows the inclusion of a user-specified string.

Usage

staticryptr(
  files,
  directory = NULL,
  recursive = FALSE,
  password = NULL,
  short = FALSE,
  decrypt = FALSE,
  remember = NULL,
  salt = NULL,
  share = NULL,
  share_remember = FALSE,
  config = NULL,
  template = NULL,
  template_button = NULL,
  template_color_primary = NULL,
  template_color_secondary = NULL,
  template_instructions = NULL,
  template_error = NULL,
  template_placeholder = NULL,
  template_remember = NULL,
  template_title = NULL,
  template_toggle_hide = NULL,
  template_toggle_show = NULL,
  print_cmd = FALSE,
  user_string = NULL
)

Value

Executes the Staticrypt CLI with the specified options or prints the command if print_cmd is TRUE.

Arguments

files

Character. One or more filenames to encrypt/decrypt.

directory

Character. Directory where the generated files will be saved (default: NULL).

recursive

Boolean. Whether to recursively encrypt the input directory (default: FALSE).

password

Character. Password for encryption (default: NULL, prompts if empty).

short

Boolean. Hide "short password" warning (default: FALSE).

decrypt

Boolean. Flag to decrypt files (default: FALSE).

remember

Integer. Expiration in days for "Remember me" checkbox (default: NULL).

salt

Character. 32-character hexadecimal string used as salt (default: NULL).

share

Character. URL for auto-decrypting link (default: NULL).

share_remember

Boolean. Auto-enable "Remember me" in the share link (default: FALSE).

config

Character. Path to the config file (default: NULL).

template

Character. Path to custom HTML template (default: NULL).

template_button

Character. Label for the decrypt button (default: NULL).

template_color_primary

Character. Primary color for the button (default: NULL).

template_color_secondary

Character. Secondary color for the background (default: NULL).

template_instructions

Character. Special instructions for the user (default: NULL).

template_error

Character. Error message on wrong password (default: NULL).

template_placeholder

Character. Placeholder for password input (default: NULL).

template_remember

Character. Label for "Remember me" checkbox (default: NULL).

template_title

Character. Title for the HTML page (default: NULL).

template_toggle_hide

Character. Alt text for hiding the password (default: NULL).

template_toggle_show

Character. Alt text for showing the password (default: NULL).

print_cmd

Boolean. Whether to print the resulting command instead of executing it (default: FALSE).

user_string

Character. A user-specified string to be appended to the command (default: NULL).

Examples

# Encrypt a file with a password
# `print_cmd = TRUE` Only outputs the command to be passed to `system()`
staticryptr(
  "index.html",
  password = "yourpassword",
  print_cmd = TRUE
)

# Decrypt a file (assuming you have the correct configuration)
staticryptr(
  "index.html",
  decrypt = TRUE,
  print_cmd = TRUE
)

# Encrypt multiple files with custom options
staticryptr(
  files = c("page1.html", "page2.html"),
  password = "securepassword",
  template = "custom_template.html",
  template_color_primary = "#3498db",
  template_instructions = "Enter the password to access the page.",
  print_cmd = TRUE
)

# Encrypt a directory recursively
staticryptr(
  files = "_output/",
  directory = ".",
  password = "yourverylongpassword",
  short = TRUE,
  recursive = TRUE,
  print_cmd = TRUE
)