v0.3.0

janitor 0.3.0 (Release date: 2017-05-06)

Release summary

The primary purpose of this release is to maintain accuracy given the changes to the dplyr package, upon which janitor is built, in dplyr version 0.6.0. This update also contains a number of minor improvements.

Critical: if you update the package dplyr to version 0.6.0, you must update janitor to version 0.3.0 to ensure accurate results from janitor's tabyl() function. This is due to a change in the behavior of dplyr's _join functions (discussed in #111).

janitor 0.3.0 is compatible with this new version of dplyr as well as old versions of dplyr back to 0.5.0. That is, updating janitor to 0.3.0 does not necessitate an update to dplyr 0.6.0.

Breaking changes

• The functions add_totals_row and add_totals_col were combined into a single function, adorn_totals(). (#57). The add_totals_ functions are now deprecated and should not be used.
• The first argument of adorn_crosstab() is now "dat" instead of "crosstab" (indicating that the function can be called on any data.frame, not just a result of crosstab())

Features

Major

• Exported the %>% pipe from magrittr (#107).

Deprecated the following functions:

• use_first_valid_of() - use dplyr::coalesce() instead
• convert_to_NA() - use dplyr::na_if() instead
• add_totals_row() and add_totals_col() - replaced by the single function adorn_totals()

Minor

• adorn_totals() and ns_to_percents() can now be called on data.frames that have non-numeric columns beyond the first one (those columns will be ignored) (#57)
• adorn_totals("col") retains factor class in 1st column if 1st column in the input data.frame was a factor

Bug fixes

• clean_names() now handles leading spaces (#85)
• adorn_crosstab() and ns_to_percents() work on a 2-column data.frame (#89)
• adorn_totals() now works on a grouped tibble (#97)
• Long variable names with spaces no longer break tabyl() and crosstab() (#87)
• An NA_ column in the result of a crosstab() will appear at the last column position (#109)