Fix readthedocs

.github/workflows/pypi_test_publish.yml

@@ -0,0 +1,25 @@
+# This workflow will upload a Python Package using Twine when a release is created
+name: Upload Python Package to Test PyPi
+
+on: workflow_dispatch
+
+jobs:
+  deploy_to_test_pypi:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Python
+      uses: actions/setup-python@v2
+      with:
+        python-version: '3.x'
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install setuptools wheel twine build
+    - name: Build and publish
+      env:
+        TWINE_USERNAME: ${{ secrets.PYPI_USERNAME }}
+        TWINE_PASSWORD: ${{ secrets.TEST_PYPI_PASSWORD }}
+      run: |
+        python -m build -s -w
+        twine upload dist/*

.readthedocs.yml

@@ -5,6 +5,16 @@
 # Required
 version: 2
 
+# Set the OS, Python version and other tools you might need
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.8"
+    # You can also specify other tool versions:
+    # nodejs: "20"
+    # rust: "1.70"
+    # golang: "1.20"
+
 # Build documentation in the docs/ directory with Sphinx
 sphinx:
   configuration: docs/source/conf.py
@@ -20,7 +30,6 @@ formats:
 
 # Optionally set the version of Python and requirements required to build your docs
 python:
-  version: 3.8
   install:
     - method: pip
       path: .

docs/source/conf.py

@@ -17,6 +17,12 @@
 sys.path.insert(0, os.path.abspath('../../spooq'))
 # sys.path[0:0] = [os.path.abspath('_themes/foundation-sphinx-theme')]
 
+# Fixes broken plantUML
+# https://github.com/mgaitan/sphinxcontrib-mermaid/issues/72
+import errno
+import sphinx.util.osutil
+sphinx.util.osutil.ENOENT = errno.ENOENT
+
 # import easydev
 # from recommonmark.parser import CommonMarkParser
 # from recommonmark.transform import AutoStructify

docs/source/requirements.txt

@@ -2,4 +2,5 @@ pyspark==3.3.0
 pandas==.1.4.3
 sphinxcontrib-plantuml==0.18
 docutils<0.18
+sphinx_rtd_theme
 Cython