NEWS

scribe 0.3.0.9002

---help, ---version super arguments (scribeSuperArg objects) are now included with scribeCommandArgs. This are objects that (by default) can be called within any scribeCommandArgs and intended to hold additional information about the {scribe} package. These are not meant to be user accessible.
- scribeCommandArgs gain a new field, supers; a list of scribeSuperArg objects
- command_args(super = included) added
- internal scribe_version_arg() function (used with command_args(include = "verison") and called with --version) is now deprecated. Using ---version now returns the version of {scribe}
- internal scribe_help_super() now available via ---help and returns information about {scribe} ca$get_args(super = TRUE) returns scribeSuerArgs
ca$help() printing has been improved
corrects issue with ca$parse()
ca$get_values(empty, super, included) added to prevent filtering of specific argument types and values
internal linting improvements
new_arg() now throws a more helpful error when value doesn't convert to itself
arg$show() now denotes if the argument is resolves by display an "R" before the value
arg$show() now prints values of class "scribe_empty_value" as <empty>
arg$add_argument() correctly passes all method arguments #78
ca$parse() correctly deals with new arguments that nave the same name as ones in included #80

$convert field now defaults to the newly exported scribe_convert() helper
- This selects one of three conversions: 1) default (see next bullet), 2) string evaluation, and 3) no conversion.
- default conversions use value_convert(), which internally uses utils::type.convert() (and some additional steps for dates. Be aware that type.convert("1", as.is = TRUE) will return integers, and a decimal should be included if a numeric is desired (e.g., type.convert("1.", as.is = TRUE)
- previously, a prototype could be set (e.g., convert = character()), which will now fail but can be replaced with a simple function (e.g., convert = as.character).

GitHub workflow added to maintain version bumps on merge jmbarbone/actions/r-check-version

execute is a new field for scribeArg where a function can be called #63
stop is a new field for scribeArg which controls how further arguments are parsed and allows for early stops #60
options() for {scribe} are now listed in ?scribe documentation and set in .onAttach() #57
scribeArgs can now be given a separate scribeArg as a default #54
positional arguments now can have default values #52
scribeArgs with action = 'flag' now accept default = TRUE #55 and (when option no = TRUE) can also accept NA #67

scribeArgs with action = "flag" will now throw an error instead of a warning when default is not logical(1) #68