Merge pull request #1 from kuleuven/feature/workflows

[ci/cd]: add workflows

.github/workflows/python-package.yml

@@ -0,0 +1,62 @@
+# This workflow will install Python dependencies, run tests and lint with a variety of Python versions
+# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-python
+# Some changes have been made: different OS
+# Copied from kuleuven/mango-mdschema
+
+name: Python package
+
+run-name: Build triggered via ${{ github.event_name }} by ${{ github.actor }}
+
+on:
+  # push won't trigger this because you cannot push without PR anyways
+  pull_request:
+    branches: ["main"]
+
+jobs:
+  test:
+    strategy:
+      fail-fast: false
+      matrix:
+        # test in multiple python versions and OS
+        # results in 12 (4x3) jobs
+        python-version: ["3.8", "3.9", "3.10", "3.11"]
+        os: [ubuntu-latest, windows-latest, macos-latest]
+    runs-on: ${{ matrix.os }}
+
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install pytest pytest-cov
+          pip install -r requirements.txt
+      - name: Test with pytest
+        run: |
+          pytest tests --doctest-modules --junitxml=junit/test-results-${{ matrix.python-version }}-${{ matrix.os }}.xml --cov --cov-report=xml --cov-report=html
+      - name: Upload pytest test results
+        uses: actions/upload-artifact@v4
+        with:
+          name: pytest-results-${{ matrix.python-version }}-${{ matrix.os }}
+          path: junit/test-results-${{ matrix.python-version }}-${{ matrix.os }}.xml
+        # Use always() to always run this step to publish test results when there are test failures
+        if: ${{ always() }}
+  lint:
+    # only run one linting job on ubuntu and the latest Python
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v5
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install pylint
+          pip install -r requirements.txt
+      - name: Lint with pylint
+        run: |
+          # fail only if there are errors
+          pylint src/mango_mdconverter tests --fail-under=6

.github/workflows/python-publish.yml

@@ -0,0 +1,82 @@
+# This workflow will upload a Python Package using Twine when a release is created
+# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-python#publishing-to-package-registries
+
+# This workflow uses actions that are not certified by GitHub.
+# They are provided by a third-party and are governed by
+# separate terms of service, privacy policy, and support
+# documentation.
+
+# Lots taken from https://packaging.python.org/en/latest/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows/
+# Copied from kuleuven/mango-mdschema
+
+name: Upload Python Package
+
+run-name: Deploy triggered by ${{ github.actor }}
+
+on:
+  release:
+    types: [published]
+  push:
+    branches: [main]
+jobs:
+  build:
+    runs-on: ubuntu-latest # only build this distribution for now
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: "3.x"
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install build
+      - name: Build package
+        run: python -m build
+      - name: Archive production artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: package-distribution
+          path: dist/
+  pypi-publish:
+    name: Upload release to PyPI
+    # only upload to PyPI on releases and tagged branches
+    if: startsWith(github.ref, 'refs/tags/')
+    needs:
+      - build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/mango-mdconverter
+    permissions:
+      id-token: write # IMPORTANT: this permission is mandatory for trusted publishing
+    steps:
+      - name: Download dists
+        uses: actions/download-artifact@v4
+        with:
+          name: package-distribution
+          path: dist/
+      - name: Publish package distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+  testpypi-publish:
+    name: Upload release to TestPyPI
+    # upload to TestPyPI on every push to main, not with tags
+    if: (!startsWith(github.ref, 'refs/tags/'))
+    needs:
+      - build
+    runs-on: ubuntu-latest
+    environment:
+      name: testpypi
+      url: https://test.pypi.org/p/mango-mdconverter
+    permissions:
+      id-token: write # IMPORTANT: this permission is mandatory for trusted publishing
+    steps:
+      - name: Download dists
+        uses: actions/download-artifact@v4
+        with:
+          name: package-distribution
+          path: dist/
+      - name: Publish package distributions to TestPyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/