Cmake: build python bindings doc (sphinx)

If WITH_DOC is set while PYTHON_BINDINGS is on, then build the python binding doc, and leave it in the html directory Signed-off-by: Robin Getz <[email protected]>
analogdevicesinc · Apr 8, 2020 · 88cf702 · 88cf702
1 parent 33b1f15
commit 88cf702
Showing 1 changed file with 23 additions and 0 deletions.
diff --git a/bindings/python/CMakeLists.txt b/bindings/python/CMakeLists.txt
@@ -29,3 +29,26 @@ if (Python_Interpreter_FOUND)
 else()
 	message(FATAL_ERROR "Python search failed : Can not build Python bindings")
 endif()
+
+if(WITH_DOC)
+	find_program(SPHINX_EXECUTABLE
+		NAMES sphinx-build
+		DOC "Sphinx Documentation Builder (sphinx-doc.org)"
+	)
+	if (NOT SPHINX_EXECUTABLE)
+		message(FATAL_ERROR "Can not build python doc without sphinx-build")
+	endif()
+	message (STATUS "Building with Python Doc (Sphinx)")
+	configure_file(
+		${CMAKE_CURRENT_SOURCE_DIR}/doc/conf.py.in
+		${CMAKE_CURRENT_SOURCE_DIR}/doc/conf.py)
+	add_custom_command(TARGET libiio-py POST_BUILD
+		COMMAND ${SPHINX_EXECUTABLE}
+			-b html
+			-c ${CMAKE_CURRENT_SOURCE_DIR}/doc
+			-d ${CMAKE_CURRENT_BINARY_DIR}/doctrees
+			${CMAKE_CURRENT_SOURCE_DIR}/doc
+			${CMAKE_HTML_DEST_DIR}/python
+		COMMENT "Generating Python binding documentation with Sphinx" VERBATIM
+	)
+endif()