devops: deploy docs to GitHub Pages (#185)

Author: mxschmitt

.github/workflows/deploy-docs.yml

@@ -0,0 +1,25 @@
+name: Deploy docs
+on:
+  push:
+    branches: [ master ]
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Python
+      uses: actions/setup-python@v2
+      with:
+        python-version: 3.8
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -r local-requirements.txt
+        pip install -e .
+    - name: Generate docs
+      run: pdoc3 --html -o docs playwright
+    - name: Deploy
+      uses: peaceiris/actions-gh-pages@v3
+      with:
+        github_token: ${{ secrets.GITHUB_TOKEN }}
+        publish_dir: ./docs

.gitignore

@@ -17,3 +17,4 @@ htmlcov/
 _repo_version.py
 coverage.xml
 junit/
+docs/

local-requirements.txt

@@ -16,3 +16,4 @@ flake8==3.8.3
 twine==3.2.0
 pyOpenSSL==19.1.0
 service_identity==18.1.0
+pdoc3==0.9.1