fhir-ig-action

This action provides the following functionality for GitHub Actions users:

• Build a FHIR® Implementation Guide with the IG Publisher.
• Use the set versions of the IG Publisher and SUSHI (if needed).
• Matches IG Publisher and SUSHI errors in GitHub, to easily spot issues:
  
  See also the live example of a failing pull request.

Usage

The action can be configured with the following inputs:

Input	Values	Default value	Description	Since
ig-publisher	x.y.z, latest	latest	The version of the IG Publisher to use.	v0.1.0
sushi	x, x.y, x.y.z, latest, false	false	The version of SUSHI to use, or false not to use SUSHI.	v0.1.0
java-max-heap-memory	8G, 500m, 8192k, 8388608	8G	The maximum heap memory for the Java VM running the IG Publisher.	v0.4.0

Examples

The following example will build an Implementation Guide 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@v4
      - uses: qligier/fhir-ig-action@v0.3.0

Another example for a SUSHI Implementation Guide, with specific versions:

name: Build the IG
on: [push, pull_request]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: qligier/fhir-ig-action@v0.3.0
        with:
          ig-publisher: "1.6.25"
          sushi: "3.11.1"
          java-max-heap-memory: 12G

To build an Implementation Guide 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@v4
      - 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.

FHIR® is the registered trademark of HL7 and is used with the permission of HL7.