SPARQL-Validator is a GitHub Action that checks whether the SPARQL queries included in one or multiple .sparql files are well formed. The action evaluates each of the queries found in the repository in the SPARQL endpoint specified as a parameter. If the status obtained after evaluating this query is 400, this means that the file is not well formed and the action will fail. Independently of the result of the execution, the action will put a comment in the pull request with the results of the execution.

Create a .github.workflows/[name].yaml file in the repository.

Example workflow:

name: [name]
on:   
  pull_request:
    branches: [master]

jobs:    
  [name]:
    runs-on: ubuntu-latest
    name: [name]
    steps:
      - name: Checkout
        uses: actions/checkout@v2
      
      - name: github-action-sparql
        uses: oeg-upm/github-action-sparql@v1.0.0
        id: 'github-action-sparql'
        with:
          owner: ${{ github.repository_owner }}
          repo: ${{ github.event.repository.name }}
          pr_number: ${{ github.event.number }}
          token: ${{ secrets.GITHUB_TOKEN }}
          actor: ${{ github.actor }}
          endpoint: '[endpoint]'
          graph_uri: [uri]
          format: [format]
          path: [path]

      - name: update files and push to branch
        if: always()
        run: |
          git config --global user.name "github-actions[bot]"
          git config --global user.email "41898282+github-actions[bot]@users.noreply.github.com"

          git add -A
          git commit -m "Output ${{ github.actor }} - ${{ github.event.number }}" --allow-empty
          git push origin HEAD:${{ github.head_ref }} --force

The owner of the repository, it is taken from ${{ github.repository_owner }}.

The repository name, it is taken from ${{ github.event.repository.name }}.

The pull request number, it is taken from ${{ github.event.number }}.

The account access token, it is taken from ${{ secrets.GITHUB_TOKEN }}.

The account that created the pull request, it is taken from ${{ github.actor }}.

The endpoint for the SPARQL queries, without https://.

The graph_uri for the SPARQL query.

The format of the output of the query.

The default path is the path where the files with the querys are stored.

None indicates that the results are not stored in the repository.

If the path in the parameter is set, it should look like: [name]/[name]

The path to store the outputs of the querys will look like, [path]/[filename]-[actor].[output].

El trabajo realizado en este repositorio ha sido elaborado por Miguel Jorge Garcia-Muñoz en el contexto de un Trabajo Fin de Grado de la ETSIINF del curso 2021-2022, bajo la dirección de Oscar Corcho.