Skip to content

readr

2.2.0

Read Rectangular Text Data

757packages dependsuggested by 302
11.3Mdownloads / year
85.3%test coverage
13/13flavors OK

Overview

About

The goal of 'readr' is to provide a fast and friendly way to read rectangular data (like 'csv', 'tsv', and 'fwf'). It is designed to flexibly parse many types of data found in the wild, while still cleanly failing when data unexpectedly changes.

Changes in 2.2.0

This release advances many deprecations.

  • melt_csv(), melt_csv2(), melt_delim(), melt_tsv(), melt_fwf(), melt_table(), melt_table2(), and all melt_*_chunked() variants have been removed from readr. These functions were deprecated in readr 2.0.0 (2021-07-20). See the meltr package (https://github.com/r-lib/meltr).
  • read_table2() has been removed from readr. This function was deprecated in readr 2.0.0 (2021-07-20) in favor of read_table(). Use read_table() instead.
  • read_csv(), read_csv2(), read_tsv(), read_delim(), and read_fwf() now emit a deprecation warning when literal data is passed without wrapping it in I(). For example, usage like read_csv(I("x,y\n1,2")) is preferred over read_csv("x,y\n1,2") (#1611).
  • The quote_escape parameter has been removed from write_delim(), write_csv(), write_csv2(), write_excel_csv(), write_excel_csv2(), write_tsv(), format_delim(), format_csv(), format_csv2(), and format_tsv(). This parameter was deprecated in readr 2.0.0 (2021-07-20) in favor of the escape parameter. Use escape instead.
  • The path parameter has been removed from write_delim(), write_csv(), write_csv2(), write_excel_csv(), write_excel_csv2(), write_tsv(), write_lines(), write_file(), and write_rds(). This parameter was deprecated in readr 1.4.0 (2020-01-31) in favor of the file parameter. Use file instead.
  • The skip_empty_rows argument of fwf_empty() now throws an error if used in edition 2. This argument was deprecated in readr 2.0.0 (2021-07-20).
  • The quoted_na argument now throws an error if used in edition 2 with read_delim(), read_csv(), read_csv2(), or read_tsv(). This usage was first deprecated in readr 2.0.0 (2021-07-20).

From NEWS.md in the release

Install

Health

CRAN checks
13OK
Slowest check: 5.5 min · r-devel-windows-x86_64
Status changes
  • OK13 OK2026-08-05
  • NOTE12 OK, 1 NOTE2026-08-01
  • OK13 OK2026-05-02
  • NOTE12 OK, 2 NOTE2026-03-10
Advisories

none known

Documentation

In release 2.2.0
READMEYes · 859 wordsVignettesYes · 3 · dynamicNEWSYes · 100% structured · mentions 2.2.0Citation fileNoWebsiteYes · pkgdown
Help pages
43 (10 internal)includes a package overview page
Examples that run
100%35 run in a plain check
Exported functions with examples
83%
Documented parameters
93%
Return-value docs
33%
Help pages citing references
5%

Downloads

11.3M
CRAN downloads in the past year
Rank #89 · ~30.9K/day · ~939.8K/mo
Daily download trend is not available in this view yet.
757.9K30 days
2.2M90 days
11.3M1 year
Compare downloads with other packages →
Also on168.8K r2u212 autocran1.3M conda_forge588 bioconda20.1K c2d4u

Repository

1,041Stars
296Forks
92Open issues
13Open PRs
20Releases
1,944Commits
118Commit identities
rcsvfwfparsing
1,944 commits · Last activity 2026-04-10 · 0% stars, 30d · Default branch at 2.2.0.9000, ahead of CRAN 2.2.0 (checked 2026-10-11)
Responsiveness
How these are sampled
PRs merged (all time)
77%
Median days to close, 50 most recently updated closed issues
238
Median days to close, 50 most recently updated closed PRs
1

Stars over time

2025-10-06 · 1,0122026-09-13 · 1,041
PracticesBeta

20 development-tooling and community-health practices detected across 8 families in the upstream repository

Checks run against github.com/tidyverse/readr on 2026-10-11.

Continuous integration (2)
GitHub ActionsR CMD check workflow

The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel

Governance and community (5)
Code of conductContributing guideIssue templatesCODEOWNERSSupport guide
Docs source (4)
README.Rmdpkgdown

GitHub Pages site last deployed 2026-04-10 · The repository has a site deploy workflow

pkgdown site last built 2026-02-19

Coverage (1)
Coverage reporting (Codecov)
Show all practicesHide 4 practices
Reproducibility and dev environment (1)
data-raw/
CRAN release process (2)
cran-comments.mdrevdep/
Lint, format, editor (4)
Lint workflowAirVS CodeRStudio project
Git structural (1)
.gitattributes
How this is detected·Detection ruleset v3 (2026-09-26)
AI coding toolsBeta

This repository shows signs of AI coding tools.

  • Claude Codefirst seen 2025-11-12
    Seen in the repository: .claude, .claude/skills
    Named in .Rbuildignore: .claude, CLAUDE.md
    Named in .gitignore: .claude
How this is detected·Detection ruleset v4 (updated 2026-09-27)

Dependencies

Declared dependencies
23 external dependencies (excludes base and recommended)

Installing readr adds 23 packages (12 with compiled code, 6.4 MB of source tarballs). Heaviest: vctrs 1.0 MB, rlang 766 KB, cli 629 KB.

Depends (1)
R >= 4.1
LinkingTo (2)
Enhances (0)
none

Datasets

People & History

People (9)
Author, Maintainer since 2.1.1 (2021) · added in 2.1.1
Author · added in 1.0.0
Contributor · added in 2.1.2
Contributor
Contributor, Copyright holder · added in 1.1.0
grisu3 implementation
Contributor, Copyright holder · added in 1.0.0
grisu3 implementation
Copyright holder, Funder · added in 2.1.5
Copyright holder · added in 2.0.0
mio library

Previously maintained by Jim Hester (1.1.0 to 2.1.0) and Hadley Wickham (0.1.0 to 1.0.0).

Listed in earlier versions (4)
Show 4 peopleHide 4 people
no longer listed · 0.1.0 to 1.4.0
RStudio
no longer listed · 0.1.0 to 2.1.3
Jukka Jäylnki
no longer listed · 1.0.0
Posit, PBC
no longer listed · 2.1.4
Releases (24)

Pick two releases to compare their code metrics.

  • R
    R 4.6.0 released · 2026-04-24
  • 2.2.0Latest
    record
    2026-02-19 · current release · diff ↗ ·
    removed 12 exports
    melt_csv, melt_csv2, melt_csv2_chunked, melt_csv_chunked, melt_delim, melt_delim_chunked, melt_fwf, melt_table, melt_table2, melt_tsv, melt_tsv_chunked, read_table2
  • 2.1.6
    record
    2025-11-14 · diff ↗
  • R
    R 4.5.0 released · 2025-04-11
  • R
    R 4.4.0 released · 2024-04-24
  • 2.1.5
    record
    2024-01-11 · diff ↗
  • R
    R 4.3.0 released · 2023-04-21
  • 2.1.4
    record
    2023-02-10 · diff ↗
  • 2.1.3
    record
    2022-10-01 · diff ↗
  • R
    R 4.2.0 released · 2022-04-22
  • 2.1.2
    record
    2022-01-30 · diff ↗
  • 2.1.1
    record
    2021-11-30 · diff ↗
  • 2.1.0
    record
    2021-11-11 · diff ↗ ·
    added 1 export
    should_read_lazy
  • 2.0.2
    record
    2021-09-27 · diff ↗
  • 2.0.1
    record
    2021-08-10 · diff ↗
  • 2.0.0
    record
    2021-07-20 · diff ↗ ·
    removed 1 export
    spec_table2
    added 5 exports
    edition_get, local_edition, readr_threads, should_show_types, with_edition
Show 22 earlier eventsHide 22 earlier events
  • R
    R 4.1.0 released · 2021-05-18
  • 1.4.0
    record
    2020-10-05 · diff ↗ ·
    added 1 export
    read_builtin
  • R
    R 4.0.0 released · 2020-04-24
  • R
    R 3.6.0 released · 2019-04-26
  • 1.3.1
    record
    2018-12-21 · diff ↗ ·
    added 1 export
    show_progress
  • 1.3.0
    record
    2018-12-11 · diff ↗
  • 1.2.1
    record
    2018-11-22 · diff ↗
  • 1.2.0
    record
    2018-11-22 · diff ↗ ·
    added 19 exports
    AccumulateCallback, as.col_spec, clipboard, format_csv2, melt_csv, melt_csv2, melt_csv2_chunked, melt_csv_chunked, melt_delim, melt_delim_chunked, melt_fwf, melt_table, melt_table2, melt_tsv, melt_tsv_chunked, read_lines_raw_chunked, spec_table2, write_csv2, write_excel_csv2
  • R
    R 3.5.0 released · 2018-04-23
  • 1.1.1
    record
    2017-05-16 · diff ↗
  • R
    R 3.4.0 released · 2017-04-21
  • 1.1.0
    record
    2017-03-22 · diff ↗ ·
    removed 4 exports
    col_euro_double, col_numeric, parse_euro_double, parse_numeric
    added 4 exports
    ListCallback, fwf_cols, read_table2, tokenizer_ws
  • 1.0.0
    record
    2016-08-03 · diff ↗ ·
    added 22 exports
    ChunkCallback, DataFrameCallback, SideEffectChunkCallback, cols_condense, guess_parser, read_csv2_chunked, read_csv_chunked, read_delim_chunked, read_file_raw, read_lines_chunked, read_tsv_chunked, readr_example, spec, spec_csv, spec_csv2, spec_delim, spec_table, spec_tsv, stop_for_problems, write_excel_csv, write_file, write_lines
  • R
    R 3.3.0 released · 2016-05-03
  • 0.2.2
    record
    2015-10-22 · diff ↗
  • 0.2.1
    record
    2015-10-21 · diff ↗
  • 0.2.0
    record
    2015-10-20 · diff ↗ ·
    removed 2 exports
    col_names_standardise, col_types_standardise
    added 23 exports
    col_guess, col_number, col_time, cols, cols_only, date_names, date_names_lang, date_names_langs, default_locale, format_csv, format_delim, format_tsv, guess_encoding, locale, output_column, parse_guess, parse_number, parse_time, read_lines_raw, read_rds, write_delim, write_rds, write_tsv
  • orphanedOrphaned by its maintainer
    2015-05-29
    non-cross-platform calls to 'iconv()' were not corrected by the original maintainer (and have been by the CRAN team)
  • 0.1.1
    record
    2015-05-29 · diff ↗
  • R
    R 3.2.0 released · 2015-04-16
  • 0.1.0
    record
    2015-04-09
  • R
    R 3.1.0 released · 2014-04-10

Package metadata

First published
2015-04-09
Total releases
24 / 11 yrs
License
MIT + file LICENSE OSI · relicensed from GPL (>= 2) | file LICENSE in 2.0.0
Minimum R
≥ 4.1
Download size
289 KB
Appears in task views

Cite

Cite this package

Run in R for the authors' preferred citation:

citation("readr")
Bryan, J., Posit Software, PBC, https://github.com/mandreyel/, Bearrows, S., Francois, R., Hester, J., Jylänki, J., Jørgensen, M., & Wickham, H. (2026). readr: Read Rectangular Text Data (Version 2.2.0) [Computer software]. https://doi.org/10.32614/CRAN.package.readr

This package has no citation file, so citation() returns this entry built from DESCRIPTION.

Cite the R Observatory

For a number measured here: a download total, a coverage figure, an archival date.

APA

Balamuta, J. J. (2026). R Observatory: Metrics for readr version 2.2.0 [Data set]. HJJB, LLC. Data release v2026-10-17. https://doi.org/10.5281/zenodo.21843040

From data release v2026-10-17, which the citation names so these numbers can be found later. More on citing and the projects behind them.

Report a problem with this page →

Privacy choices

These apply to this browser and are stored on this device only. Nothing about your choice is sent to us.

Read the privacy policy