arrow-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject arrow git commit: ARROW-716: [Python] Update README build instructions after moving libpyarrow to C++ tree
Date Tue, 28 Mar 2017 03:13:38 GMT
Repository: arrow
Updated Branches:
  refs/heads/master d2d27555b -> e717d4786

ARROW-716: [Python] Update README build instructions  after moving libpyarrow to C++ tree

Author: Wes McKinney <>

Closes #445 from wesm/ARROW-716 and squashes the following commits:

2608d2b [Wes McKinney] Update README after moving libpyarrow to main C++ source tree


Branch: refs/heads/master
Commit: e717d47865038a65a23d80d6d5d6df782d9a8e43
Parents: d2d2755
Author: Wes McKinney <>
Authored: Mon Mar 27 23:13:33 2017 -0400
Committer: Wes McKinney <>
Committed: Mon Mar 27 23:13:33 2017 -0400

 cpp/    | 10 ++++++++++
 python/ | 33 +++++++++++++++++++--------------
 2 files changed, 29 insertions(+), 14 deletions(-)
diff --git a/cpp/ b/cpp/
index 51f1f06..b6f0fa0 100644
--- a/cpp/
+++ b/cpp/
@@ -81,6 +81,16 @@ variables
 * Hadoop: `HADOOP_HOME` (only required for the HDFS I/O extensions)
 * jemalloc: `JEMALLOC_HOME` (only required for the jemalloc-based memory pool)
+### Building Python integration library
+The `arrow_python` shared library can be built by passing `-DARROW_PYTHON=on`
+to CMake. This must be installed or in your library load path to be able to
+build pyarrow, the Arrow Python bindings.
+The Python library must be built against the same Python version for which you
+are building pyarrow, e.g. Python 2.7 or Python 3.6. NumPy must also be
 ### API documentation
 To generate the (html) API documentation, run the following command in the apidoc
diff --git a/python/ b/python/
index 88ab17e..25a3a67 100644
--- a/python/
+++ b/python/
@@ -22,25 +22,30 @@ other traditional Python scientific computing packages.
 This project is layered in two pieces:
-* pyarrow, a C++ library for easier interoperability between Arrow C++, NumPy,
-  and pandas
-* Cython extensions and pure Python code under arrow/ which expose Arrow C++
+* arrow_python, a library part of the main Arrow C++ project for Python,
+  pandas, and NumPy interoperability
+* Cython extensions and pure Python code under pyarrow/ which expose Arrow C++
   and pyarrow to pure Python users
 #### PyArrow Dependencies:
-These are the various projects that PyArrow depends on.
-1. **g++ and gcc Version >= 4.8**
-2. **cmake > 2.8.6**
-3. **boost**
-4. **Arrow-cpp and its dependencies**
-The Arrow C++ library must be built with all options enabled and installed with
-``ARROW_HOME`` environment variable set to the installation location. Look at
-( for instructions.
+To build pyarrow, first build and install Arrow C++ with the Python component
+enabled using `-DARROW_PYTHON=on`, see
+( . These components
+must be installed either in the default system location (e.g. `/usr/local`) or
+in a custom `$ARROW_HOME` location.
+mkdir cpp/build
+pushd cpp/build
+make -j4
+make install
-Ensure PyArrow can locate the Arrow-cpp shared libraries by setting the
-LD_LIBRARY_PATH environment variable.
+If you build with a custom `CMAKE_INSTALL_PREFIX`, during development, you must
+set `ARROW_HOME` as an environment variable and add it to your
+`LD_LIBRARY_PATH` on Linux and OS X:

View raw message