qligier / fhir-ig-action

A GitHub Action for FHIR IGs.

fhir-ig-action

This action provides the following functionality for GitHub Actions users:

• Build a FHIR IG with the IG Publisher
• Use the set versions of the IG Publisher and SUSHI (if needed)
• Matches IG Publisher and Sushi errors in GitHub

Usage

The action can be configured with the following inputs:

ig-publisher

The version of the IG Publisher to use. The value can be a full version (i.e. x.y.z) or the keyword 'latest'. The default value is 'latest'.

sushi

The version of SUSHI to use. The value can be a partial or full version (i.e. x, x.y or x.y.z), the keyword 'latest', or the keyword 'false' to disable SUSHI. The default value is 'false'.

Examples

The following example will build an IG with the latest version of the IG Publisher, without SUSHI. The ig.ini file is expected in the top directory of the project.

name: Build the IG
on: [push, pull_request]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: qligier/fhir-ig-action@v0.3.0

Another example for a SUSHI IG, with specific versions:

name: Build the IG
on: [push, pull_request]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: qligier/fhir-ig-action@v0.3.0
        with:
          ig-publisher: "1.3.5"
          sushi: "2.10"

To build an IG in another directory, you should use the working-directory configuration:

name: Build the IG
on: [push, pull_request]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: qligier/fhir-ig-action@v0.3.0
        working-directory: ./folder/my-ig # This will use ./folder/my-ig/ig.ini

License

This project is released under the MIT License.

Development

Issues and pull requests are very welcome 💙

Code contributions must pass the code checks: shfmt, ShellCheck and Prettier. See the GitHub Action file for details.