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
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions