Add Nitrokey Python SDK documentation

.github/workflows/ci.yml

@@ -6,11 +6,13 @@ jobs:
   syntax-check:
     name: Check syntax
     runs-on: ubuntu-latest
-    container: python:3.11-slim
+    container: python:3.11
     continue-on-error: true
     steps:
       - name: Checkout repository
         uses: actions/checkout@v3
+        with:
+          submodules: true
       - name: Create virtual environment
         run: |
           python -m venv venv
@@ -23,15 +25,18 @@ jobs:
   build-error-check:
     name: Check build error
     runs-on: ubuntu-latest
-    container: python:3.11-slim
+    container: python:3.11
     steps:
       - name: Checkout repository
         uses: actions/checkout@v3
+        with:
+          submodules: true
       - name: Create virtual environment
         run: |
           python -m venv venv
           . venv/bin/activate
           pip install -r requirements.txt
+          pip install ./nitrokey-sdk-py
       - name: Build documentation
         run: |
           . venv/bin/activate

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "nitrokey-sdk-py"]
+	path = nitrokey-sdk-py
+	url = https://github.com/Nitrokey/nitrokey-sdk-py.git

Dockerfile

@@ -4,3 +4,6 @@ WORKDIR /docs
 COPY requirements.txt /docs
 COPY source/conf.py /docs
 RUN pip3 install -r requirements.txt
+
+COPY nitrokey-sdk-py /docs/nitrokey-sdk-py
+RUN pip3 install ./nitrokey-sdk-py

source/components/software/index.rst

@@ -7,3 +7,4 @@ Software
 
    nk-app2/index
    nitropy/index
+   nitrokey-sdk-py/index

source/components/software/nitrokey-sdk-py

@@ -0,0 +1 @@
+../../../nitrokey-sdk-py/docs/

source/conf.py

@@ -39,6 +39,7 @@
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
 extensions = [
+    'sphinx.ext.autodoc',
     'sphinx.ext.todo',
     'sphinx.ext.coverage',
     #'sphinx_copybutton',
@@ -71,7 +72,7 @@
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
 # This pattern also affects html_static_path and html_extra_path.
-exclude_patterns = ['venv/*', 'components/nethsm/_*.rst', 'components/to-be-integrated.rst']
+exclude_patterns = ['venv/*', 'components/nethsm/_*.rst', 'components/to-be-integrated.rst', 'nitrokey-sdk-py/*']
 
 # The name of the Pygments (syntax highlighting) style to use.
 #pygments_style = "solarizeddark"
@@ -434,3 +435,9 @@
 
 # Disables the closing of tabs if clicked on the currently active tab
 sphinx_tabs_disable_tab_closing = True
+
+# -- Options for autodoc extension -------------------------------------------
+
+autodoc_class_signature = 'separated'
+autodoc_member_order = 'groupwise'
+autodoc_typehints = 'description'