Changelog

Source: NEWS.md

fmtr 1.6.5

• Add %q and %Q format codes for quarters. Do not exist in Base R.

fmtr 1.6.42024-05-10

• Allow single item vector lookup.
• Added read.flist() and write.flist() functions.
• Fixed note on fapply() of flist object.
• Fixed minor issues with as.fcat().
• Added “Factor” column to UDF data frame conversion. Will allow user to set “as.factor” property from a data frame.

fmtr 1.6.32024-01-09

• Improved documentation and examples.

fmtr 1.6.22023-11-10

• Added “as.factor” parameter to value() function to convert results to a factor.

fmtr 1.6.02023-09-10

• Increment version.
• CRAN fix.

fmtr 1.5.92022-09-08

• Changed default separator on fapply2() to a blank space. This seems like a more useful default.
• Allowed label on user-defined format to be a string format. This means a string format can be executed conditionally.
• Added “type” parameter to fmt_quantile_range() function so user can specify the type of quantile algorithm to use.
• Added output logging.
• Updated logo.

fmtr 1.5.82022-08-08

• BREAKING CHANGE: Removed the labels.data.frame() function from this package, as it has now been moved to the common package. A dependency has been added to fmtr so that the common package will be loaded automatically, and the labels.data.frame() function will be available automatically. However, if you use fully qualified function calls in your programs, such as fmtr::labels(), these calls will be broken, and will have to be changed to common::labels().
• Fixed bug on fapply() that was causing it to pick up and apply haven format attributes.
• Added fapply2() function to format and combine two variables.
• Added na and zero parameters to fmt_cnt_pct() to apply specified string in cases where the count is NA or zero.

fmtr 1.5.72022-06-25

• Fixed fapply() so that NA values in data are returned as NA instead of a string “NA”.

fmtr 1.5.52022-01-13

• Fixed bug in as.fmt.data.frame() that was converting all label and order values to character. Now it will return the stored data type.
• Added sd_format parameter to the fmt_mean_sd() function to format the standard deviation separately if desired.
• Documentation fixes/updates.

fmtr 1.5.42021-11-18

• Added FAQ and Complete Example to vignettes.
• Took out errors on convenience functions if data frame does not have a variable specified on the incoming list. Now this situation is ignored, and no error is generated. The error was removed to allow the list to contain more formats/labels/etc. than exist on the data frame, but still assign the matching items.

fmtr 1.5.32021-10-09

• Added covr and codecov.
• Allow assignment of NULL to convenience functions to clear attributes.
• Update examples and documentation for convenience functions.

fmtr 1.5.22021-07-25

• Fixed bug on R 3.6 where fdata() function was turning all columns into factors.
• Changed fapply() function so it will accept non-character vector formats. Now works with integer, numeric, and date vectors also.

fmtr 1.5.12021-06-21

• Fixed bug when vector format has no corresponding input value. Was assigning an NA. Now leaving the original value.
• Made code compatible back to R version 3.6.0
• Added GitHub Actions for prior R version checks

fmtr 1.5.02021-02-22

• Added labels.data.frame() function to assign label attributes of a data frame
• Small documentation fixes

fmtr 1.4.12021-01-06

• Added descriptions() attribute assignment functions
• Modified fattr() functions to include description attribute
• Added pkgdown site

fmtr 1.3.02020-11-16

• Added functions to convert data frames, tibble, and format catalogs to flist
• Print summarized list of fcat contents
• Fixed bug on as.fmt() when input data is a tibble
• Added label and description parameters to fattr()
• Added descriptions() function to set descriptions for data frame
• Fixed bug on levels() and labels() functions when formats read from data frame
• Made a few documentation fixes

fmtr 1.2.22020-10-10

• Documentation updates/improvements.

fmtr 1.2.1

• Improved printing of format catalogs, formats, formatting lists
• Added a NEWS.md file to track changes to the package.

fmtr 1.2.0

• Added fcat() function to create a format catalog
• Added associated utility functions for format catalogs for reading, writing, printing, and converting from/to data frames
• Fixed bug on fapply() with user-define format, which was throwing an error when no conditions were met. Now, values that meet no conditions will fall through unaltered

fmtr 1.1.02020-09-11

• Added Helper functions for common statistical formatting: fmt_cnt_pct(), fmt_range(), fmt_n(), fmt_median(), fmt_mean_sd(), fmt_quantile_rng()
• Added “order” parameter on condition() function to order labels differently than specified in the value() function
• Made small change to fdata() to not call base format() function unless a parameter is specifically passed to on “…”

fmtr 1.0.0

• Initial version
• Added fapply() to format a vector
• Added fdata() to format an entire data frame/tibble
• Added value() and condition() functions to create a user-defined format
• Added flist() function to create a formatting list
• Added fattr() to assign format information to a vector
• Added formats(), widths(), and justification() functions to assign formatting formation to multiple columns in a data frame
• Created package infrastructure, including testthat tests, description file, readme file, vignette, and man pages