readr
2.2.0Read Rectangular Text Data
Overview
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.
This release advances many deprecations.
melt_csv(),melt_csv2(),melt_delim(),melt_tsv(),melt_fwf(),melt_table(),melt_table2(), and allmelt_*_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 ofread_table(). Useread_table()instead.read_csv(),read_csv2(),read_tsv(),read_delim(), andread_fwf()now emit a deprecation warning when literal data is passed without wrapping it inI(). For example, usage likeread_csv(I("x,y\n1,2"))is preferred overread_csv("x,y\n1,2")(#1611).- The
quote_escapeparameter has been removed fromwrite_delim(),write_csv(),write_csv2(),write_excel_csv(),write_excel_csv2(),write_tsv(),format_delim(),format_csv(),format_csv2(), andformat_tsv(). This parameter was deprecated in readr 2.0.0 (2021-07-20) in favor of theescapeparameter. Useescapeinstead. - The
pathparameter has been removed fromwrite_delim(),write_csv(),write_csv2(),write_excel_csv(),write_excel_csv2(),write_tsv(),write_lines(),write_file(), andwrite_rds(). This parameter was deprecated in readr 1.4.0 (2020-01-31) in favor of thefileparameter. Usefileinstead. - The
skip_empty_rowsargument offwf_empty()now throws an error if used in edition 2. This argument was deprecated in readr 2.0.0 (2021-07-20). - The
quoted_naargument now throws an error if used in edition 2 withread_delim(),read_csv(),read_csv2(), orread_tsv(). This usage was first deprecated in readr 2.0.0 (2021-07-20).
From NEWS.md in the release
Install
Health
- OK13 OK2026-08-05
- NOTE12 OK, 1 NOTE2026-08-01
- OK13 OK2026-05-02
- NOTE12 OK, 2 NOTE2026-03-10
Documentation
- 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%
- Introduction to readr HTML
- Column type HTML
- Locales HTML
Downloads
Repository
- 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
Forks over time
Releases over time
Issues over time
PRs over time
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.
The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel
GitHub Pages site last deployed 2026-04-10 · The repository has a site deploy workflow
pkgdown site last built 2026-02-19
Show all practicesHide 4 practices
This repository shows signs of AI coding tools.
- Claude Codefirst seen 2025-11-12Seen in the repository: .claude, .claude/skillsNamed in .Rbuildignore: .claude, CLAUDE.mdNamed in .gitignore: .claude
Dependencies
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.
Show the 48 most downloaded dependentsHide the 48 most downloaded dependents
and 709 more dependents and 302 packages that suggest it on CRAN ↗
Code & Tests
Datasets
People & History
Previously maintained by Jim Hester (1.1.0 to 2.1.0) and Hadley Wickham (0.1.0 to 1.0.0).
Show 4 peopleHide 4 people
Pick two releases to compare their code metrics.
- RR 4.6.0 released · 2026-04-24
- 2.2.0Latest2026-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.62025-11-14 · diff ↗
- RR 4.5.0 released · 2025-04-11
- RR 4.4.0 released · 2024-04-24
- 2.1.52024-01-11 · diff ↗
- RR 4.3.0 released · 2023-04-21
- 2.1.42023-02-10 · diff ↗
- 2.1.32022-10-01 · diff ↗
- RR 4.2.0 released · 2022-04-22
- 2.1.22022-01-30 · diff ↗
- 2.1.12021-11-30 · diff ↗
- 2.1.0
- 2.0.22021-09-27 · diff ↗
- 2.0.12021-08-10 · diff ↗
- 2.0.02021-07-20 · diff ↗ ·
removed 1 export
spec_table2added 5 exports
edition_get, local_edition, readr_threads, should_show_types, with_edition
Show 22 earlier eventsHide 22 earlier events
- RR 4.1.0 released · 2021-05-18
- 1.4.0
- RR 4.0.0 released · 2020-04-24
- RR 3.6.0 released · 2019-04-26
- 1.3.1
- 1.3.02018-12-11 · diff ↗
- 1.2.12018-11-22 · diff ↗
- 1.2.02018-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 - RR 3.5.0 released · 2018-04-23
- 1.1.12017-05-16 · diff ↗
- RR 3.4.0 released · 2017-04-21
- 1.1.02017-03-22 · diff ↗ ·
removed 4 exports
col_euro_double, col_numeric, parse_euro_double, parse_numericadded 4 exports
ListCallback, fwf_cols, read_table2, tokenizer_ws - 1.0.02016-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 - RR 3.3.0 released · 2016-05-03
- 0.2.22015-10-22 · diff ↗
- 0.2.12015-10-21 · diff ↗
- 0.2.02015-10-20 · diff ↗ ·
removed 2 exports
col_names_standardise, col_types_standardiseadded 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 maintainer2015-05-29non-cross-platform calls to 'iconv()' were not corrected by the original maintainer (and have been by the CRAN team)
- 0.1.12015-05-29 · diff ↗
- RR 3.2.0 released · 2015-04-16
- 0.1.02015-04-09
- RR 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
Cite
Cite this package
Run in R for the authors' preferred citation:
citation("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.
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.