Package org.fhirfrog.frog.ant

package org.fhirfrog.frog.ant
Ant task integration for FHIR Frog.

This package provides Apache Ant Task subclasses for the full FHIR testing lifecycle: generating server configuration, bootstrapping a pre-warmed Docker image, executing TestScripts and TestPlans, and writing Surefire XML reports.

Key Classes

  • FhirTestTask — Executes a TestScript or TestPlan against a running FHIR server; writes optional Surefire XML and FHIR TestReport output
  • FhirInitTask — Reads sushi-config.yaml, resolves IG dependencies, and generates application.yaml + docker-compose.yml for HAPI FHIR
  • FhirBootstrapTask — Performs the one-time HAPI warm-up (docker compose bootstrap profile) and commits the result as a reusable Docker image, reducing subsequent test startup to ~25 seconds

Typical Build Sequence


 <!-- 1. Generate HAPI config from sushi-config.yaml -->
 <fhirinit igConfig="sushi-config.yaml"
           fhirVersion="R4"
           outputDir=".fhir-frog"
           imageTag="hapi-myig:1.0.0"/>

 <!-- 2. Bootstrap once (skipped if image already exists) -->
 <fhirbootstrap imageTag="hapi-myig:1.0.0"
                composeFile=".fhir-frog/docker-compose.yml"/>

 <!-- 3. Execute tests -->
 <fhirtest testPlan="tests/suite.json"
           serverUrl="http://localhost:8080/fhir"
           reportDir="target/fhir-reports"/>
See Also:
  • Classes
    Class
    Description
    FhirBootstrapTask
    Ant task that performs a one-time HAPI FHIR bootstrap and captures the loaded server state as a committed HAPI Docker image plus a pg_dump SQL file.
    FhirCacheTask
    Ant task that saves and restores HAPI bootstrap artifacts (committed HAPI Docker image and pg_dump SQL file) to/from a container registry.
    FhirInitTask
    Ant task that generates Docker Compose and HAPI FHIR configuration files from an IG's sushi-config.yaml.
    FhirTestTask
    Ant task for executing FHIR TestScripts and TestPlans.