add github workflow

[ferrighi]

Before merging the branch https://github.com/metno/mmd/tree/issue128-199-276-330 a new workflow should be added.

The steps are:

• when any of the below has changed
  • thesauri/mmd-vocablary.ttl,
  • xsd/enum_mmd.xsd,
  • xsd/create_enum.py
  • doc/ch04-md-contrvocabs.adoc
• run xsd/create_enum.py
• push to new generated files
  • xsd/enum_mmd.xsd,
  • doc/ch04-md-contrvocabs.adoc

This will make sure that if auto-generated files are edited, they will be recreated and overwritten and also that when new terms are added in the vocabulary the schema and documentation will be updated.

[ferrighi]

I think the following should work:
created mmd/Dockerfile.enumeration

#
# Docker file used in GitHub Actions run enumeration.
#

FROM python:3.8-slim
LABEL maintainer="laraf@met.no"

RUN apt-get update && \
    apt-get install -y git && \
    apt-get clean && \
    pip install "rdflib" \
                "lxml"

VOLUME /src
WORKDIR /src

create mmd/docker-compose.enumeration.yml

version: '3.4'

services:
  enum:
    build:
      context: .
      dockerfile: Dockerfile.enumeration
    environment:
      CI: "${CI}"
      GITHUB_REF: "${GITHUB_REF}"
      GITHUB_SHA: "${GITHUB_SHA}"
      GITHUB_ACTIONS: "${GITHUB_ACTIONS}"
    volumes:
      - .:/src
    command: sh -c "cd xsd && ./create_enum.py && cd .."

add .github/workflows/enumeration.yml

name: 'create_enumeration'

on:
  push:
    paths:
      - 'thesauri/mmd-vocabulary.ttl'
      - 'doc/ch04-md-contrvocabs.adoc'
      - 'xsd/**'

jobs:
  build:

    runs-on: ubuntu-latest

    permissions:
      contents: write

    steps:
    - uses: actions/checkout@v4

    - name: enumeration
      run: |
        docker compose -f docker-compose.enumeration.yml up

    - name: commit changed files
      run: |
        git config --local user.email "action@github.com"
        git config --local user.name "GitHub Action"
        git add -f xsd/enum_mmd.xsd
        git add -f doc/ch04-md-contrvocabs.adoc
        git commit -m "Automatic updated by GitHub Action"

    - name: push code to ${{ github.ref }}
      run: |
        remote_repo="https://${GITHUB_ACTOR}:${{ secrets.GITHUB_TOKEN }}@github.com/${GITHUB_REPOSITORY}.git"
        git push "${remote_repo}" HEAD:${{ github.ref }} --follow-tags

I'm not sure the permissions are needed and I guess it should run before the html/pdf creation is run.

[steingod]

Agree