pyktx (Python bindings for libktx) (KhronosGroup#698)

Add Python bindings, documentation and tests. Add to CI.

Adds a manual Publish step for publishing to PyPl. See KhronosGroup#663 for details.

Fixes KhronosGroup#663.

Co-authored-by: Mark Callow <[email protected]>

CMakeLists.txt

@@ -50,6 +50,7 @@ CMAKE_DEPENDENT_OPTION( KTX_FEATURE_TOOLS
 option( KTX_FEATURE_DOC "Create KTX documentation." OFF )
 option( KTX_FEATURE_STATIC_LIBRARY "Create static libraries (shared otherwise)." ${LIB_TYPE_DEFAULT} )
 option( KTX_FEATURE_JNI "Create Java bindings for libktx." OFF )
+option( KTX_FEATURE_PY "Create Python source distribution." OFF )
 option( KTX_FEATURE_TESTS "Create unit tests." ON )
 option( KTX_FEATURE_TOOLS_CTS "Enable KTX CLI Tools CTS tests (requires CTS submodule)." OFF )
 
@@ -731,6 +732,10 @@ if(KTX_FEATURE_JNI)
     add_subdirectory(interface/java_binding)
 endif()
 
+if(KTX_FEATURE_PY)
+    add_subdirectory(interface/python_binding)
+endif()
+
 create_version_header(lib ktx)
 create_version_file()
 

cmake/docs.cmake

@@ -189,6 +189,17 @@ function( CreateDocJSWrappers )
     add_docs_cmake_plus( jswrappers.doc pkgdoc/jswrappersDoxyLayout.xml )
 endfunction()
 
+# pyktxwrappers.doc
+function( CreateDocPyktxWrappers )
+    add_custom_command(
+        TARGET libktx.doc
+        POST_BUILD
+        COMMAND
+            ${CMAKE_COMMAND} -E copy_directory ${KTX_BUILD_DIR}/interface/python_binding/docs/html/pyktx/html ${KTX_BUILD_DIR}/docs/html/pyktx
+    )
+    add_dependencies( libktx.doc pyktx )
+endfunction()
+
 # ktxpkg.doc
 function( CreateDocKTX )
     set( DOXYGEN_PROJECT_NAME "Khronos Texture Software" )
@@ -215,6 +226,9 @@ endfunction()
 CreateDocLibKTX()
 CreateDocTools()
 CreateDocJSWrappers()
+if (KTX_FEATURE_PY)
+    CreateDocPyktxWrappers()
+endif()
 CreateDocKTX()
 
 add_dependencies( libktx.doc ktxpkg.doc ktx_version )