merge pr #891: 0.7.0 on CRAN!

DESCRIPTION

@@ -1,7 +1,7 @@
 Type: Package
 Package: broom
 Title: Convert Statistical Objects into Tidy Tibbles
-Version: 0.7.0.9000
+Version: 0.7.0
 Authors@R:
     c(person(given = "David",
              family = "Robinson",
@@ -12,6 +12,10 @@ Authors@R:
              role = c("aut", "cre"),
              email = "alexpghayes@gmail.com",
              comment = c(ORCID = "0000-0002-4985-5160")),
+      person(given = "Simon",
+             family = "Couch",
+             role = "aut",
+             email = "simonpatrickcouch@gmail.com"),
       person(given = "Indrajeet",
              family = "Patil",
              role = "ctb",
@@ -566,6 +570,7 @@ Suggests:
     metafor,
     mfx,
     mgcv,
+    modeldata,
     modeltests,
     muhaz,
     multcomp,
@@ -600,7 +605,7 @@ VignetteBuilder:
 Encoding: UTF-8
 LazyData: true
 Roxygen: list(markdown = TRUE)
-RoxygenNote: 7.1.0
+RoxygenNote: 7.1.0.9000
 Language: en-US
 Collate:
     'aaa-documentation-helper.R'
@@ -619,6 +624,7 @@ Collate:
     'car-tidiers.R'
     'caret-tidiers.R'
     'data-frame-tidiers.R'
+    'deprecated-0-7-0.R'
     'drc-tidiers.R'
     'emmeans-tidiers.R'
     'epiR-tidiers.R'
@@ -694,7 +700,6 @@ Collate:
     'stats-mlm-tidiers.R'
     'stats-prcomp-tidiers.R'
     'stats-smooth.spline-tidiers.R'
-    'stats-tidiers.R'
     'stats-time-series-tidiers.R'
     'survey-tidiers.R'
     'survival-aareg-tidiers.R'

NAMESPACE

@@ -6,6 +6,7 @@ S3method(augment,betamfx)
 S3method(augment,betareg)
 S3method(augment,clm)
 S3method(augment,coxph)
+S3method(augment,data.frame)
 S3method(augment,decomposed.ts)
 S3method(augment,default)
 S3method(augment,drc)
@@ -23,16 +24,20 @@ S3method(augment,lm)
 S3method(augment,lmRob)
 S3method(augment,lmrob)
 S3method(augment,loess)
+S3method(augment,logitmfx)
 S3method(augment,mclogit)
 S3method(augment,mfx)
 S3method(augment,mjoint)
+S3method(augment,negbinmfx)
 S3method(augment,nlrq)
 S3method(augment,nls)
 S3method(augment,pam)
 S3method(augment,plm)
 S3method(augment,poLCA)
+S3method(augment,poissonmfx)
 S3method(augment,polr)
 S3method(augment,prcomp)
+S3method(augment,probitmfx)
 S3method(augment,rlm)
 S3method(augment,rma)
 S3method(augment,rq)
@@ -85,19 +90,23 @@ S3method(glance,lm)
 S3method(glance,lmRob)
 S3method(glance,lmodel2)
 S3method(glance,lmrob)
+S3method(glance,logitmfx)
 S3method(glance,mclogit)
 S3method(glance,mfx)
 S3method(glance,mjoint)
 S3method(glance,mlm)
 S3method(glance,muhaz)
 S3method(glance,multinom)
+S3method(glance,negbinmfx)
 S3method(glance,nlrq)
 S3method(glance,nls)
 S3method(glance,orcutt)
 S3method(glance,pam)
 S3method(glance,plm)
 S3method(glance,poLCA)
+S3method(glance,poissonmfx)
 S3method(glance,polr)
+S3method(glance,probitmfx)
 S3method(glance,pyears)
 S3method(glance,ridgelm)
 S3method(glance,rlm)
@@ -109,6 +118,7 @@ S3method(glance,scam)
 S3method(glance,smooth.spline)
 S3method(glance,speedglm)
 S3method(glance,speedlm)
+S3method(glance,summaryDefault)
 S3method(glance,survdiff)
 S3method(glance,survexp)
 S3method(glance,survfit)
@@ -142,6 +152,7 @@ S3method(tidy,binWidth)
 S3method(tidy,boot)
 S3method(tidy,btergm)
 S3method(tidy,cch)
+S3method(tidy,character)
 S3method(tidy,cld)
 S3method(tidy,clm)
 S3method(tidy,clmm)
@@ -150,6 +161,7 @@ S3method(tidy,confint.glht)
 S3method(tidy,confusionMatrix)
 S3method(tidy,coxph)
 S3method(tidy,cv.glmnet)
+S3method(tidy,data.frame)
 S3method(tidy,default)
 S3method(tidy,density)
 S3method(tidy,dgCMatrix)
@@ -188,6 +200,8 @@ S3method(tidy,lm.beta)
 S3method(tidy,lmRob)
 S3method(tidy,lmodel2)
 S3method(tidy,lmrob)
+S3method(tidy,logical)
+S3method(tidy,logitmfx)
 S3method(tidy,lsmobj)
 S3method(tidy,manova)
 S3method(tidy,map)
@@ -199,16 +213,20 @@ S3method(tidy,mle2)
 S3method(tidy,mlm)
 S3method(tidy,muhaz)
 S3method(tidy,multinom)
+S3method(tidy,negbinmfx)
 S3method(tidy,nlrq)
 S3method(tidy,nls)
+S3method(tidy,numeric)
 S3method(tidy,orcutt)
 S3method(tidy,pairwise.htest)
 S3method(tidy,pam)
 S3method(tidy,plm)
 S3method(tidy,poLCA)
+S3method(tidy,poissonmfx)
 S3method(tidy,polr)
 S3method(tidy,power.htest)
 S3method(tidy,prcomp)
+S3method(tidy,probitmfx)
 S3method(tidy,pyears)
 S3method(tidy,rcorr)
 S3method(tidy,ref.grid)
@@ -227,6 +245,7 @@ S3method(tidy,speedglm)
 S3method(tidy,speedlm)
 S3method(tidy,summary.glht)
 S3method(tidy,summary.plm)
+S3method(tidy,summaryDefault)
 S3method(tidy,summary_emm)
 S3method(tidy,survdiff)
 S3method(tidy,survexp)
@@ -241,6 +260,10 @@ S3method(tidy,ts)
 S3method(tidy,zoo)
 export(augment)
 export(augment_columns)
+export(bootstrap)
+export(confint_tidy)
+export(finish_glance)
+export(fix_data_frame)
 export(glance)
 export(tidy)
 export(tidy_irlba)

NEWS.md

@@ -1,14 +1,9 @@
-# broom 0.7.0.9000
-(To be released as 0.7.0)
+# broom 0.7.0
 
-## Breaking changes
-
-`broom 0.7.0` is a major release with a large number of breaking changes and
-deprecations. Most of these breaking changes are meant to improve 
-maintainability and internal consistency, which have posed long-standing 
-difficulties.
+`broom 0.7.0` is a major release with a large number of new tidiers,
+soft-deprecations, and planned hard-deprecations of functions and arguments.
 
-### Big picture breaking changes
+### Big picture changes
 
 - We have changed how we report degrees of freedom for `lm` objects 
 (#212, #273). This is especially important for instructors in statistics 
@@ -48,25 +43,22 @@ of `comparison`, `level1` and `level2`, or `lhs` and `rhs` (see #692).
 
 ### Deprecations
 
-This release of `broom` hard-deprecates the following functions and tidier 
+This release of `broom` soft-deprecates the following functions and tidier 
 methods:
 
 - Tidier methods for data frames, rowwise data frames, vectors and matrices
 - `bootstrap()`
 - `confint_tidy()`
 - `fix_data_frame()`
+- `finish_glance()`
 - `augment.glmRob()`
 - `tidy.table()` and `tidy.ftable()` have been deprecated in favor of
 `tibble::as_tibble()`
 - `tidy.summaryDefault()` and `glance.summaryDefault()` have been deprecated in 
 favor of `skimr::skim()`
 
-We regret that we were unable to provide warnings for some of these
-changes. Affected maintainers were notified two weeks before the planned release.
-
-We have also gone forward with our planned mixed model 
-deprecations, and have removed the following methods, which now live 
-in `broom.mixed`:
+We have also gone forward with our planned mixed model deprecations, and have 
+removed the following methods, which now live in `broom.mixed`:
 
 - `tidy.brmsfit()`
 - `tidy.merMod()`, `glance.merMod()`, `augment.merMod()`
@@ -231,16 +223,20 @@ regardless of link function.
 
 - Removed dependencies on reshape2 and superseded functions in dplyr.
 
+- All documentation now links to help files rather than topics.
+
 ## For developers and contributors
 
 - Moved core tests to the `modeltests` package.
 
-- In general, after this release, the broom dev team will no longer add new
-  tidiers to the package, in favor of adding tidier methods to the model-owning
-  package. An article describing best practices in doing so can be found
-  on the {tidymodels} website at 
+- Generally, after this release, the broom dev team will first ask that
+  attempts to add tidier methods supporting a model object are first
+  directed to the model-owning package. An article describing best practices 
+  in doing so can be found on the {tidymodels} website at 
   https://www.tidymodels.org/learn/develop/broom/, and we will continue
-  adding additional resources to that article as we develop them.
+  adding additional resources to that article as we develop them. In the case
+  that the maintainer is uninterested in taking on the tidier methods, please
+  note this in your issue or PR.
 
 - Added a new vignette discussing how to implement new tidier methods in 
   non-broom packages.

R/base-tidiers.R

@@ -3,18 +3,18 @@
 #'
 #' @description Deprecated. Please use [tibble::as_tibble()] instead.
 #'
-#' @param x A [table] object.
+#' @param x A [base::table] object.
 #' @template param_unused_dots
 #'
 #' @return A [tibble::tibble] in long-form containing frequency information
 #'   for the table in a `Freq` column. The result is much like what you get
 #'   from [tidyr::pivot_longer()].
 #'
-#' @details Directly calls [tibble::as_tibble()] on a [table] object, which
-#'   does the same things as [as.data.frame.table()] but also gives the
+#' @details Directly calls [tibble::as_tibble()] on a [base::table] object, which
+#'   does the same things as [base::as.data.frame.table()] but also gives the
 #'   returned object [tibble::tibble] class.
 #'
-#' @seealso [as_tibble.table()]
+#' @seealso [tibble::as_tibble.table()]
 #' @export
 tidy.table <- function(x, ...) {
   .Deprecated()