ARROW-21 Test PyMongoArrow documentation build in CI (#49)

Author: blink1073

.readthedocs.yaml

@@ -0,0 +1,10 @@
+version: 2
+sphinx:
+  configuration: ./bindings/python/docs/source/conf.py
+conda:
+  environment: ./bindings/python/docs/environment.yml
+python:
+  install:
+    # install the package itself
+    - method: pip
+      path: ./bindings/python

bindings/python/docs/environment.yml

@@ -0,0 +1,8 @@
+name: mongo_arrow_documentation
+channels:
+  - conda-forge
+dependencies:
+- python=3.9
+- sphinx
+- libbson
+- pkg-config

bindings/python/docs/source/conf.py

@@ -12,8 +12,6 @@
 #
 import os
 import os.path as p
-import sys
-sys.path.insert(0, os.path.abspath('../..'))
 
 
 # -- Project information -----------------------------------------------------
@@ -43,11 +41,6 @@
     'sphinx.ext.intersphinx'
 ]
 
-# https://docs.readthedocs.io/en/stable/faq.html#i-get-import-errors-on-libraries-that-depend-on-c-modules
-autodoc_mock_imports = ['pyarrow',
-                        'pymongoarrow.lib',
-                        'bson']
-
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']
 
@@ -72,7 +65,7 @@
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
-html_static_path = ['_static']
+html_static_path = []
 
 # These paths are either relative to html_static_path
 # or fully qualified paths (eg. https://...)

bindings/python/docs/source/index.rst

@@ -83,6 +83,7 @@ Indices and tables
    installation
    quickstart
    supported_types
+   faq
    api/index
    changelog
    developer/index

bindings/python/docs/source/supported_types.rst

@@ -37,7 +37,7 @@ respectively, and '_id' that is an `ObjectId`, your schema can be defined as::
     '_id': ObjectId,
     'f1': pyarrow.int32(),
     'f2': pyarrow.timestamp('ms')
-})
+  })
 
 Unsupported data types in a schema cause a ``ValueError`` identifying the
 field and its data type.

bindings/python/setup.py

@@ -119,7 +119,7 @@ def append_arrow_flags(module):
 
     # Handle the arrow library files manually.
     # Alternative to using pyarrow.create_library_symlinks().
-    # You can use MONGO_LIBARROW_DIR to explicitly set the location of the 
+    # You can use MONGO_LIBARROW_DIR to explicitly set the location of the
     # arrow libraries (for instance in a conda build).
     # We first check for an unmodified path to the library,
     # then look for a library file with a version modifier, e.g. libarrow.600.dylib.