Skip to content

ARROW-6142: [R] Install instructions on linux could be clearer #5027

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
wants to merge 5 commits into from
Closed

ARROW-6142: [R] Install instructions on linux could be clearer #5027

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
63f75bd
Revise install_arrow instructions for Linux
nealrichardson Aug 6, 2019
79bd7e0
One more PPurge
nealrichardson Aug 6, 2019
36cfe28
Further linux install revisions
nealrichardson Aug 7, 2019
44c9659
Tweak language again
nealrichardson Aug 7, 2019
80b142e
s/arrow/Arrow/
nealrichardson Aug 8, 2019
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 5 additions & 2 deletions r/R/install-arrow.R
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,7 @@ install_arrow_msg <- function(has_arrow, version, from_cran, os) {
# Point to compilation instructions on readme
msg <- c(SEE_DEV_GUIDE, THEN_REINSTALL)
} else {
# Suggest arrow.apache.org/install for PPAs, or compilation instructions
# Suggest arrow.apache.org/install, or compilation instructions
msg <- c(paste(SEE_ARROW_INSTALL, OR_SEE_DEV_GUIDE), THEN_REINSTALL)
}
} else if (!dev_version && !from_cran) {
Expand Down Expand Up @@ -98,7 +98,10 @@ OR_SEE_DEV_GUIDE <- paste0(
SEE_ARROW_INSTALL <- paste(
"See the Apache Arrow project installation page",
"<https://arrow.apache.org/install/>",
"for how to install the C++ package from a PPA."
"to find pre-compiled binary packages for some common Linux distributions,",
"including Debian, Ubuntu, and CentOS. You'll need to install",
"'libparquet-dev' on Debian and Ubuntu, or 'parquet-devel' on CentOS. This",
"will also automatically install the Arrow C++ library as a dependency."
)

THEN_REINSTALL <- paste(
Expand Down
2 changes: 1 addition & 1 deletion r/README.Rmd
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ Install the latest release of `arrow` from CRAN with
install.packages("arrow")
```

On macOS and Windows, installing a binary package from CRAN will handle Arrow's C++ dependencies for you. On Linux, you'll need to first install the C++ library. See the [Arrow project installation page](https://arrow.apache.org/install/) for a list of PPAs from which you can obtain it.
On macOS and Windows, installing a binary package from CRAN will handle Arrow's C++ dependencies for you. On Linux, you'll need to first install the C++ library. See the [Arrow project installation page](https://arrow.apache.org/install/) to find pre-compiled binary packages for some common Linux distributions, including Debian, Ubuntu, and CentOS. You'll need to install `libparquet-dev` on Debian and Ubuntu, or `parquet-devel` on CentOS. This will also automatically install the Arrow C++ library as a dependency.

If you install the `arrow` package from source and the C++ library is not found, the R package functions will notify you that Arrow is not available. Call

Expand Down
9 changes: 6 additions & 3 deletions r/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -30,8 +30,11 @@ install.packages("arrow")
On macOS and Windows, installing a binary package from CRAN will handle
Arrow’s C++ dependencies for you. On Linux, you’ll need to first install
the C++ library. See the [Arrow project installation
page](https://arrow.apache.org/install/) for a list of PPAs from which
you can obtain it.
page](https://arrow.apache.org/install/) to find pre-compiled binary
packages for some common Linux distributions, including Debian, Ubuntu,
and CentOS. You’ll need to install `libparquet-dev` on Debian and
Ubuntu, or `parquet-devel` on CentOS. This will also automatically
install the Arrow C++ library as a dependency.

If you install the `arrow` package from source and the C++ library is
not found, the R package functions will notify you that Arrow is not
Expand All @@ -57,7 +60,7 @@ set.seed(24)

tab <- arrow::table(x = 1:10, y = rnorm(10))
tab$schema
#> arrow::Schema
#> arrow::Schema
#> x: int32
#> y: double
tab
Expand Down
2 changes: 1 addition & 1 deletion r/tests/testthat/test-install-arrow.R
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ r_only({
test_that("Linux on release version gets pointed to PPA first, then C++", {
expect_match(
install_arrow_msg(FALSE, "0.13.0", os="linux"),
"PPA. Or, see the Arrow C++ developer guide",
"dependency. Or, see the Arrow C++ developer guide",
fixed = TRUE
)
})
Expand Down