diff --git a/R/DESCRIPTION b/R/DESCRIPTION index 31acfe1..2eaa33c 100644 --- a/R/DESCRIPTION +++ b/R/DESCRIPTION @@ -1,8 +1,9 @@ Package: feather Title: R Bindings to the Feather 'API' -Version: 0.3.5.9000 +Version: 0.4.0 Authors@R: c( person("Hadley", "Wickham", , "hadley@rstudio.com", role = c("aut", "cre")), + person("Neal", "Richardson", , "neal@ursalabs.org", role = "ctb"), person("RStudio", role = "cph"), person("LevelDB Authors", role = "ctb") ) diff --git a/R/NEWS.md b/R/NEWS.md index 1c2b8ef..d93a418 100644 --- a/R/NEWS.md +++ b/R/NEWS.md @@ -1,4 +1,13 @@ -# feather (development version) +# feather 0.4.0 + +This release updates `feather` to depend on the [`arrow`](https://arrow.apache.org/docs/r/) package, which is where Feather format development has moved. This resolves many bug reports and missing features from the previous implementation of Feather in R, and it brings the R package in line with the Python `feather` package, which has depended on `pyarrow` since 2017. + +For compatibility, `feather::write_feather()` uses V1 of the Feather specification: it is a wrapper around `arrow::write_feather(version = 1)`. Feather V2 is just the Arrow format on disk and has support for a much richer set of data types. To switch to V2, we recommend just using `arrow::write_feather()`. + +With these changes, most of `feather`'s APIs are preserved in spirit, but there are some noteworthy changes: + +* The `feather` class, which allowed for accessing data in a Feather file without reading it all into R, has been replaced by an `arrow::Table` backed by the memory-mapped Feather file. This should preserve the intent of the original implementation but with much richer functionality. One behavior change that results though is that slicing/extracting from the Table results in another arrow Table, so the data aren't pulled into a `data.frame` until you `as.data.frame()` them. +* `feather_metadata` also now does the same # feather 0.3.5 diff --git a/R/README.md b/R/README.md index d41062b..9d8056c 100644 --- a/R/README.md +++ b/R/README.md @@ -1,7 +1,5 @@ ## Feather for R -[![Build Status](https://travis-ci.org/wesm/feather.svg?branch=master)](https://travis-ci.org/wesm/feather) - Feather is file format designed for efficient on-disk serialisation of data frames that can be shared across programming languages (e.g. Python and R). ```R @@ -10,6 +8,8 @@ write_feather(mtcars, "mtcars.feather") mtcars2 <- read_feather("mtcars.feather") ``` +Feather developement has continued in [Apache Arrow](https://arrow.apache.org/), and `feather` is now a wrapper around the [`arrow`](https://arrow.apache.org/docs/r/) package. We encourage you to update your workflows to use `arrow::write_feather()` and `arrow::read_feather()` directly. + ## Installation Install the released version from CRAN: