fuj 0.3.0

Deprecations

• quick_dfl() is now deprecated #91

Improvements and bug fixes

• match_ext functions have minor improvements for direct aliases and documentation updates #86
• quick_df() no longer allows NULL values in the input list #81
• quick_df() is now a little faster #91
• list() is now a little faster #91
• list0()’s functionality to ignore empty inputs can be disabled if options(fuj.list.active = FALSE) before {fuj} is loaded #91

New functions and methods

• set_file_ext() and file_ext<-() added for controlling file extensions #89
• + and / methods added for file_path classes, allowing path creation (e.g., fp("folder") / "subfolder" / "file" + "extension") #89
• hold() and toss() are added for retaining and removing values in a vectors #85
• negate() and not() added to negate functions #84
• encode() and fact() added to encode values and create factors #87
• np() added for normalizing file paths #100
• fp() no longer normalizes file paths #100
• match_arg() added for and internally used #102
• delay() added as a wrapper for passing an expression into on.exit() (similar to withr::defer())
• require_namespace() no longer loads the namespace being checked #111
• BREAKING require_namespace() now requires <package> <op> <version> to be space delimited. Optionally, a list() can be used with the three components included (e.g., require_namespace(list("fuj", ">=", "0.2.2"), list("base", "==", getRversion()))

Changes in conditions

General improvements for conditions #90

• BREAKING new_condition(type) now defaults to "condition" rather than "error"
• BREAKING new_condition() with a package not uses <package>::<class> names, rather than <package>:<class> names
• new_condition() transformations on class have been adjusted
  • classes are no longer convert to camelCase; likewise, the base fujCondition class is now fuj_condition
  • classes no longer need their type specified (e.g., my_error, my_warning); the value of the type field is automatically appended to each element in class if it doesn’t already exist. This behavior can be controlled by using an AsIs class (e.g., class = I("exactly_this_class"))
  • class can now be a list for more control (e.g., class = list("value", I("exact value")))
  • new_condition(pkg) is deprecated in favor of new_condition(package)
  • new_condition(msg) is deprecated in favor of new_condition(message); message is now the first argument
  • new_condition() now only accepts message, class, and type as positional arguments with the include of ...; all other arguments must be explicitly named
• default condition functions exported
  • include input_error(), class_error(), value_error(), warning equivalents and more (see all with ?fuj::conditions)
  • error_condition()/err(), warning_condition()/wrn(), message_condition()/msg() exported for simple conditions (e.g., message(msg("this is a message")) [#105]
• internally, {fuj} now simplifies use of new_condition()
  • many conditions within {fuj} have been simplified through the use of generic condition classes (e.g., input_error, type_error, class_error)
  • verbose_message will try to avoid printing a message when options(fuj.verbose = FALSE) is set

New vap family

Includes new vap family functions; essentially familiar wrappers for apply functions #83

• vaps are vector apply functions, with certain presets to assist with common cases
• all vap functions have type-stable variants:

The below table shows inputs for vap functions and how they behave with the provided functions (f). Arguments to f()) can use any name.

Note: vapi() uses either the index or names of x as the second argument to f.

Each vap function comes with the following type variants. If you are not concerned about type safety, usevap_vec().

Note: these variants do not perform checks on output results, but rather coerce the output to the specified type. These do not function the same as vapply(), which is recommended for more aggressive type checking.

fuj 0.2.2

• require_namespace() now produces a more reasonable error when specifying a version #63
• adds yes_no() prompting #64
• adds internal package() utility as the default for new_condition(pkg = package()) #67
• new_condition() now allows type = "message" #74
• workflows updated
• quick_df(list()) now works #72
• removes tests for struct() #78

fuj 0.2.1

Fixes

• lst() again works with NA_character_ #60

fuj 0.2.0

Fixes

• %wi% no longer drops duplicated in x #44
• list0() now works better with some edge cases #55

New features

• fp() added for creating file path objects with is_path() as a means of checking for the class; file_path() and is_file_path() exported as aliases, respectively #55
• include() added as a means of partially attaching a package with specific exports #49
• op.fuj, a named list of default options for {fuj} is now exported
• multiple improvements for verbose() #50
  • verbose() has additional options for controlling the message output #36
    • .label can be set to a string to prepend to the message (defaults to "[verbose]")
    • .fill can be set to repeat .label on each line of the message (defaults to FALSE)
    • .verbose can be set to TRUE to print the message rather than relying on options()
  • verbose() prints prepended with "verbose " instead of "[verbose] " #42
  • make_verbose() is included to create a verbose function that will be triggered with a configured option, rather than the default getOption("fuj.verbose", getOption("verbose")) pattern. This can be used to define your own custom verbose function:
• lst() exported as an alias for list0()

library(fuj)
options(fuj.verbose = FALSE)
verbose("will not show")

options(my.verbose = TRUE)
my_verbose <- make_verbose("my.verbose")
my_verbose("will show")
#> [verbose] will show

Internals

• %||% is now copied from {base} when available (R versions >= 4.4) #35
• additional local testing for os version
• {covr} dropped as a suggest dependency
• require_namespace() now allows for version requirements (e.g., require_namespace("fuj>=0.1.4")). When the version requirement is not met, an error of class namespaceVersionError is returned #41
• simpleErrors converted to custom errors #43

fuj 0.1.4

• adds %::% and %:::% (which now aliases %colons$) or retrieving exported and non-exported values from namespaces #31
• adds verbose() for conditional message printing #29
• GitHub workflow added to maintain version bumps on merge jmbarbone/actions/r-check-version

fuj 0.1.3

• list0() now accepts named arguments in ... #25

fuj 0.1.2

• new_condition() gains a pkg argument to control for prepending a package name to the condition call. The default value of TRUE will try to find the .packageName object from your package. Change the default setting of pkg to prevent this addition. #12
• require_namespace() can now accept multiple namespaces. The first namespace not found will throw an error #14
• list0() now correctly throws valid errors #19
• typo fixed in README #20

fuj 0.1.1

• subset2 is now exported as an alias of [[ and subset3 is added as an alias of $ #3
• improved documentation for aliases #3
• improved test coverage – no longer skipping any functions #7

fuj 0.1.0

• First release
• Added a NEWS.md file to track changes to the package.