Skip to content

Advance deprecations #1600

@jennybc

Description

@jennybc

This issue tracks deprecations that could be advanced in a future readr release.

Is it time to soft deprecate the first edition? In readr 2.0.0, we said:

We will continue to support the first edition for a number of releases, but eventually this support will be first deprecated and then removed.


Deprecated in readr 2.0.0 (2021-07-20)

✅ Melt functions

  • Removed in Remove all the melt functions #1598
  • Functions affected:
    • melt_csv(), melt_csv2(), melt_delim(), melt_tsv() (were in R/melt_delim.R)
    • melt_fwf() (was in R/melt_fwf.R)
    • melt_table(), melt_table2() (were in R/melt_table.R)
    • melt_csv_chunked(), melt_csv2_chunked(), melt_delim_chunked(), melt_tsv_chunked() (were in R/melt_delim_chunked.R)
  • Replacement: Use the meltr package (https://cran.r-project.org/package=meltr)

read_table2() function

quote_escape Parameter

  • Removed in Remove quote_escape argument #1602
  • Functions affected:
    • write_delim()
    • write_csv()
    • write_csv2()
    • write_excel_csv()
    • write_excel_csv2()
    • write_tsv()
  • Behaviour before removal: lifecycle::deprecate_soft("2.0.0", ...) then assigning value to the escape parameter

quoted_na Parameter

  • Hard deprecated in some settings in Advance deprecation of quoted_na argument #1604. Sort of a complicated situation.
  • quoted_na appears in the signature of some core functions:
    • read_delim()
    • read_csv()
    • read_csv2()
    • read_tsv()
      Use of quoted_na now errors unless user is explicitly using the 1st edition. It has been deprecate_soft() since readr 2.0.0 and was just ignored.
  • quoted_na is used in some functions that live entirely in readr and are arguably legacy:
    • read_*_chunked()
    • tokenizer_*()
      The documentation has been updated here to better reflect the situation (?).

skip_empty_rows parameter in fwf_empty()

  • Deprecation advanced in 9713f73
  • Use of fwf_empty(skip_empty_rows =) now errors unless user is explicitly using the 1st edition. It has been deprecate_soft() since readr 2.0.0 and was just ignored.
  • skip_empty_rows arguments appear elsewhere (i.e. not just fwf_empty()) and are still used by first edition, so it's complicated.

Deprecated in readr 1.4.0 (2020-01-31)

path Parameter

  • Removed in Remove the long deprecated path argument #1601
  • Deprecated in favor of: file parameter
  • Behavior before removal: lifecycle::deprecate_warn("1.4.0", ...) then assigning value to file parameter
  • Functions affected: 9 write functions:
    • write_delim()
    • write_csv()
    • write_csv2()
    • write_excel_csv()
    • write_excel_csv2()
    • write_tsv()
    • write_lines()
    • write_file()
    • write_rds()

Metadata

Metadata

Assignees

No one assigned

    Labels

    upkeepmaintenance, infrastructure, and similar

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions