ci.yml

name: ci

on: [push, pull_request]

env:
  X_PYTHON_MIN_VERSION: "3.9"
  X_PYTHON_MAX_VERSION: "3.13"

jobs:
  check-python-versions:
    # This job checks that the Python Versions we support match and are not End of Life
    runs-on: ubuntu-latest
    defaults:
      run:
        working-directory: ./etc/scripts
    steps:
      - uses: actions/checkout@v2

      - name: Set up Python ${{ env.X_PYTHON_MIN_VERSION }}
        uses: actions/setup-python@v2
        with:
          python-version: ${{ env.X_PYTHON_MIN_VERSION }}

      - name: Check Supported Python Versions
        run: |
          python check_python_versions_supported.py \
            ${{ env.X_PYTHON_MIN_VERSION }} \
            ${{ env.X_PYTHON_MAX_VERSION }}

      - name: Check Python Versions coincide with the SDKs pyproject.toml
        run: |
          python check_python_versions_coincide.py \
            ../../sdk/pyproject.toml \
            ${{ env.X_PYTHON_MIN_VERSION }} \
            ${{ env.X_PYTHON_MAX_VERSION }}

      # Todo: Check other pyproject.toml here as well, as we add them

  sdk-test:
    # This job runs the unittests on the python versions specified down at the matrix
    runs-on: ubuntu-latest
    strategy:
      matrix:
        python-version: ["3.8", "3.10", "3.12"]
    env:
      COUCHDB_ADMIN_PASSWORD: "yo0Quai3"
      # (2024-10-11, s-heppner)
      # Specify the tag of the released schema files from https://github.com/admin-shell-io/aas-specs/releases
      # that you want to use to test the serialization adapter against.
      # Currently, we need to update this manually, however I'm afraid this is not possible to automatically infer,
      # since it's heavily dependant of the version of the AAS specification we support.
      AAS_SPECS_RELEASE_TAG: "IDTA-01001-3-0-1_schemasV3.0.8"
    services:
      couchdb:
        image: couchdb:3
        ports:
          - 5984:5984
        env:
          COUCHDB_USER: "admin"
          COUCHDB_PASSWORD: ${{ env.COUCHDB_ADMIN_PASSWORD }}
    defaults:
      run:
        working-directory: ./sdk
    steps:
    - uses: actions/checkout@v2
    - name: Set up Python ${{ matrix.python-version }}
      uses: actions/setup-python@v2
      with:
        python-version: ${{ matrix.python-version }}
    - name: Collect schema files from aas-specs
      run: |
        mkdir -p ./test/adapter/schema
        curl -sSL -o ./test/adapter/schema/aasJSONSchema.json https://raw.githubusercontent.com/admin-shell-io/aas-specs/${{ env.AAS_SPECS_RELEASE_TAG }}/schemas/json/aas.json
        curl -sSL -o ./test/adapter/schema/aasXMLSchema.xsd https://raw.githubusercontent.com/admin-shell-io/aas-specs/${{ env.AAS_SPECS_RELEASE_TAG }}/schemas/xml/AAS.xsd
    - name: Install Python dependencies
      run: |
        python -m pip install --upgrade pip
        pip install .[dev]
    - name: Setup test config and CouchDB database server
      run: |
        python test/_helper/setup_testdb.py -u "admin" -p "$COUCHDB_ADMIN_PASSWORD"
    - name: Test with coverage + unittest
      run: |
        coverage run --source=basyx -m unittest
    - name: Report test coverage
      if: ${{ always() }}
      run: |
        coverage report -m

  sdk-static-analysis:
    # This job runs static code analysis, namely pycodestyle and mypy
    runs-on: ubuntu-latest
    defaults:
      run:
        working-directory: ./sdk
    steps:
    - uses: actions/checkout@v2
    - name: Set up Python ${{ env.X_PYTHON_MIN_VERSION }}
      uses: actions/setup-python@v2
      with:
        python-version: ${{ env.X_PYTHON_MIN_VERSION }}
    - name: Install Python dependencies
      run: |
        python -m pip install --upgrade pip
        pip install .[dev]
    - name: Check typing with MyPy
      run: |
        mypy basyx test
    - name: Check code style with PyCodestyle
      run: |
        pycodestyle --count --max-line-length 120 basyx test

  sdk-readme-codeblocks:
    # This job runs the same static code analysis (mypy and pycodestyle) on the codeblocks in our docstrings.
    runs-on: ubuntu-latest
    defaults:
      run:
        working-directory: ./sdk
    steps:
    - uses: actions/checkout@v2
    - name: Set up Python ${{ env.X_PYTHON_MIN_VERSION }}
      uses: actions/setup-python@v2
      with:
        python-version: ${{ env.X_PYTHON_MIN_VERSION }}
    - name: Install Python dependencies
      run: |
        python -m pip install --upgrade pip
        pip install .[dev]
    - name: Check typing with MyPy
      run: |
        mypy <(codeblocks python README.md)
    - name: Check code style with PyCodestyle
      run: |
        codeblocks --wrap python README.md | pycodestyle --count --max-line-length 120 -
    - name: Run readme codeblocks with Python
      run: |
        codeblocks python README.md | python

  sdk-docs:
    # This job checks, if the automatically generated documentation using sphinx can be compiled
    runs-on: ubuntu-latest
    defaults:
      run:
        working-directory: ./sdk
    steps:
    - uses: actions/checkout@v2
    - name: Set up Python ${{ env.X_PYTHON_MIN_VERSION }}
      uses: actions/setup-python@v2
      with:
        python-version: ${{ env.X_PYTHON_MIN_VERSION }}
    - name: Install Python dependencies
      run: |
        python -m pip install --upgrade pip
        pip install .
        pip install -r docs/add-requirements.txt
    - name: Check documentation for errors
      run: |
        SPHINXOPTS="-a -E -n -W --keep-going" make -C docs html

  sdk-package:
    # This job checks if we can build our SDK package
    runs-on: ubuntu-latest
    defaults:
      run:
        working-directory: ./sdk
    steps:
    - uses: actions/checkout@v2
    - name: Set up Python ${{ env.X_PYTHON_MIN_VERSION }}
      uses: actions/setup-python@v2
      with:
        python-version: ${{ env.X_PYTHON_MIN_VERSION }}
    - name: Install dependencies
      run: |
        python -m pip install --upgrade pip
        pip install build
    - name: Create source and wheel dist
      run: |
        python -m build