arrow-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From w...@apache.org
Subject arrow git commit: ARROW-1326: [Python] Fix Sphinx Build in Travis CI, treat Sphinx warnings as errors
Date Fri, 04 Aug 2017 15:36:13 GMT
Repository: arrow
Updated Branches:
  refs/heads/master a388ddf88 -> aa5d417bb


ARROW-1326: [Python] Fix Sphinx Build in Travis CI, treat Sphinx warnings as errors

Author: Wes McKinney <wes.mckinney@twosigma.com>
Author: Wes McKinney <wesmckinn@gmail.com>

Closes #936 from wesm/ARROW-1326 and squashes the following commits:

8af31d72 [Wes McKinney] Fix bash syntax
1d4dc699 [Wes McKinney] Only build Sphinx documentation on Linux because of case sensitivity
issue
b88adc95 [Wes McKinney] Travis OS X is case insensitive file system
7eb12b02 [Wes McKinney] Nudge build
b33ced76 [Wes McKinney] Use sphinx-build directly, error on Sphinx warnings
11418fbb [Wes McKinney] Build Python docs inside docs directory to avoid import errors


Project: http://git-wip-us.apache.org/repos/asf/arrow/repo
Commit: http://git-wip-us.apache.org/repos/asf/arrow/commit/aa5d417b
Tree: http://git-wip-us.apache.org/repos/asf/arrow/tree/aa5d417b
Diff: http://git-wip-us.apache.org/repos/asf/arrow/diff/aa5d417b

Branch: refs/heads/master
Commit: aa5d417bbd32fcdf96462181791f6c044ab3215d
Parents: a388ddf
Author: Wes McKinney <wes.mckinney@twosigma.com>
Authored: Fri Aug 4 11:36:08 2017 -0400
Committer: Wes McKinney <wes.mckinney@twosigma.com>
Committed: Fri Aug 4 11:36:08 2017 -0400

----------------------------------------------------------------------
 ci/travis_script_python.sh   | 13 ++++++-------
 python/doc/source/api.rst    | 11 ++++++++---
 python/doc/source/plasma.rst |  2 +-
 3 files changed, 15 insertions(+), 11 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/arrow/blob/aa5d417b/ci/travis_script_python.sh
----------------------------------------------------------------------
diff --git a/ci/travis_script_python.sh b/ci/travis_script_python.sh
index 4a50d2f..66cd17d 100755
--- a/ci/travis_script_python.sh
+++ b/ci/travis_script_python.sh
@@ -120,14 +120,13 @@ python_version_tests() {
   PYARROW_PATH=$CONDA_PREFIX/lib/python$PYTHON_VERSION/site-packages/pyarrow
   python -m pytest -vv -r sxX -s $PYARROW_PATH --parquet
 
-  pushd $ARROW_PYTHON_DIR
-  # Build documentation once
-  if [[ "$PYTHON_VERSION" == "3.6" ]]
-  then
-      conda install -y -q --file=doc/requirements.txt
-      python setup.py build_sphinx -s doc/source
+  if [ "$PYTHON_VERSION" == "3.6" ] && [ $TRAVIS_OS_NAME == "linux" ]; then
+      # Build documentation once
+      pushd $ARROW_PYTHON_DIR/doc
+      conda install -y -q --file=requirements.txt
+      sphinx-build -b html -d _build/doctrees -W source _build/html
+      popd
   fi
-  popd
 }
 
 # run tests for python 2.7 and 3.6

http://git-wip-us.apache.org/repos/asf/arrow/blob/aa5d417b/python/doc/source/api.rst
----------------------------------------------------------------------
diff --git a/python/doc/source/api.rst b/python/doc/source/api.rst
index fd1cb72..1aaf89c 100644
--- a/python/doc/source/api.rst
+++ b/python/doc/source/api.rst
@@ -91,13 +91,14 @@ Scalar Value Types
 
 .. _api.array:
 
-Array Types and Constructors
-----------------------------
+.. currentmodule:: pyarrow.lib
+
+Array Types
+-----------
 
 .. autosummary::
    :toctree: generated/
 
-   array
    Array
    BooleanArray
    DictionaryArray
@@ -126,6 +127,8 @@ Array Types and Constructors
 
 .. _api.table:
 
+.. currentmodule:: pyarrow
+
 Tables and Record Batches
 -------------------------
 
@@ -214,6 +217,8 @@ Memory Pools
 
 .. _api.type_classes:
 
+.. currentmodule:: pyarrow.lib
+
 Type Classes
 ------------
 

http://git-wip-us.apache.org/repos/asf/arrow/blob/aa5d417b/python/doc/source/plasma.rst
----------------------------------------------------------------------
diff --git a/python/doc/source/plasma.rst b/python/doc/source/plasma.rst
index 98dd62f..832d996 100644
--- a/python/doc/source/plasma.rst
+++ b/python/doc/source/plasma.rst
@@ -16,7 +16,7 @@
 .. under the License.
 
 .. currentmodule:: pyarrow
-.. _io:
+.. _plasma:
 
 The Plasma In-Memory Object Store
 =================================


Mime
View raw message