Develop

.github/actions/lint-jsonschema/action.yml

@@ -0,0 +1,52 @@
+name: Lint JSON Schema
+
+runs:
+  using: "composite"
+  steps:
+    - name: Set up check-jsonschema
+      shell: bash
+      run: |
+        pip install check-jsonschema
+
+    - name: Set up environment
+      shell: bash
+      run: |
+        # Sadly, composite actions currently don't support environment variables so we freestyle a replacement
+        echo 'SCHEMAS_ROOT=src/schema' >> .gha-env
+        echo 'EXAMPLES_ROOT=src/schema/examples' >> .gha-env
+
+    - name: Verify schemas
+      shell: bash
+      run: |
+        source .gha-env
+
+        # We handle the return code ourselves to prevent the action from exiting on the first error
+        rc=0
+
+        while read -r file; do
+          echo "Validating $file"
+          if ! check-jsonschema --check-metaschema "$file"; then
+            rc=1
+          fi
+        done < <(find "$SCHEMAS_ROOT" -name "*.json" -maxdepth 1)
+
+        exit $rc
+
+    - name: Verify examples
+      shell: bash
+      run: |
+        source .gha-env
+
+        # We handle the return code ourselves to prevent the action from exiting on the first error
+        rc=0
+
+        while read -r file; do
+          schema=$(basename "$file")
+          schema=$SCHEMAS_ROOT/${schema%%.*}.json
+          echo "Validating $file against $schema"
+          if ! check-jsonschema --schemafile "$schema" "$file"; then
+            rc=1
+          fi
+        done < <(find "$EXAMPLES_ROOT" -name "*.json")
+
+        exit $rc

.github/actions/lint-links/action.yml

@@ -0,0 +1,64 @@
+name: Lint Links
+
+runs:
+  using: "composite"
+  steps:
+    - name: Verify links
+      shell: bash
+      run: |
+        function warn {
+          >&2 echo -e "\033[0;33m$@\033[0m"
+        }
+
+        function err {
+          >&2 echo -e "\033[0;31m$@\033[0m"
+        }
+
+        rc=0
+
+        while read -r file; do
+          echo "Checking $file"
+
+          pushd "$(dirname "$file")" > /dev/null
+
+          while read -r location; do
+            echo "Checking location $location"
+
+            if [[ "$location" == http* ]]; then
+              if ! curl -X OPTIONS --silent --fail "$location" 2>&1 > /dev/null; then
+                if ! curl --head --silent --fail "$location" 2>&1 > /dev/null; then
+                  if ! curl --silent --fail "$location" 2>&1 > /dev/null; then
+                    # Some URLs are examples or the endpoints helpfully support neither OPTIONS nor HEAD
+                    if [[ "$location" = *example* ]] || \
+                       [[ "$location" = https://idp-ref.app.ti-dienste.de/auth* ]] || \
+                       [[ "$location" = https://idp.app.ti-dienste.de/auth* ]] || \
+                       [[ "$location" = https://idp-ref.app.ti-dienste.de/token* ]] || \
+                       [[ "$location" = https://idp.app.ti-dienste.de/token* ]] || \
+                       [[ "$location" = https://idp-ref.app.ti-dienste.de ]];
+                    then
+                      warn "$file references non-verifiable location $location"
+                    else
+                      err "$file references non-existent location $location"
+                      rc=1
+                    fi
+                  fi
+                fi
+              fi
+            else
+              # Strip fragments and prefix absolute paths with repo root
+              path=${location/\#*/}
+              if [[ "$path" == /* ]]; then
+                path=$(git rev-parse --show-toplevel)/$path
+              fi
+
+              if [[ ! -e "$path" ]]; then
+                err "$file references non-existent location $location"
+                rc=1
+              fi
+            fi
+          done < <(grep -hoE 'link:[^\[]*|image::?[^\[]*|https?://[^\["[:space:]]*' "$(basename "$file")" | grep -v '^image:' | sed -E "s/^link:+//g")
+
+          popd > /dev/null
+        done < <(find . -type f -name "*.adoc")
+
+        exit $rc

.github/workflows/generate-images.yml

@@ -0,0 +1,22 @@
+name: Generate images
+
+on:
+  push:
+    branches:
+    - '**'
+    paths:
+    - '.github/workflows/generate-images.yml'
+    - 'images/generated/**'
+    - '**.drawio'
+    - '**.puml'
+  workflow_dispatch:
+
+jobs:
+  generate:
+    uses: gematik/github-image-actions/.github/workflows/[email protected]
+    with:
+      srcdir: src/images
+      outdir: images/generated
+      ref: 0.2.0
+      png: true
+      svg: false

.github/workflows/lint.yml

@@ -0,0 +1,59 @@
+name: Lint
+
+on:
+  pull_request:
+  push:
+    branches:
+    - main
+  workflow_dispatch:
+
+jobs:
+  asciidoc-images:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Lint
+        uses: gematik/github-image-actions/.github/actions/[email protected]
+
+  asciidoc-links:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Lint
+        uses: ./.github/actions/lint-links
+
+  drawio:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Lint
+        uses: gematik/github-image-actions/.github/actions/[email protected]
+
+  jsonschema:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Lint
+        uses: ./.github/actions/lint-jsonschema
+
+  plantuml:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Lint
+        uses: gematik/github-image-actions/.github/actions/[email protected]

.gitignore

@@ -1,3 +1,5 @@
 *.dtmp
 src/fhir/input-cache
-.idea
+.idea
+target/
+.DS_Store