Add Render-Report Command

Closes: #105

Author: alexanderkiel

README.md

@@ -38,11 +38,14 @@ Usage:
   blazectl [command]
 
 Available Commands:
+  compact          Compact a Database Column Family
   completion       Generate the autocompletion script for the specified shell
   count-resources  Counts all resources by type
-  download         Download FHIR resources in NDJSON format
+  download         Download resources in NDJSON format
+  download-history Download history in NDJSON format
   evaluate-measure Evaluates a Measure
   help             Help about any command
+  render-report    Renders a MeasureReport
   upload           Upload transaction bundles
 
 Flags:
@@ -180,11 +183,19 @@ Given a measure in YAML form, creates the required FHIR resources, evaluates tha
 You can run:
 
 ```sh
-blazectl evaluate-measure --server "http://localhost:8080/fhir" stratifier-condition-code.yml
+blazectl evaluate-measure --server "http://localhost:8080/fhir" query.yml
 ```
 
 More comprehensive documentation can be found in the [Blaze CQL Queries Documentation][9].
 
+### Render Report
+
+Renders a FHIR MeasureReport resource as simple, standalone HTML file. The idea is to combine two `blazectl` calls, first the `evaluate-measure` call and second the `render-report` call. 
+
+```sh
+blazectl evaluate-measure --server "http://localhost:8080/fhir" query.yml | blazectl render-report > query.html
+```
+
 ## GitHub Attestations
 
 To ensure trust and security in the software supply chain, GitHub [attestations][11] are available for all `blazectl` binaries. To verify the attestations, please install the [GitHub CLI][10] tool and run:

cmd/evaluateMeasure.go

@@ -6,19 +6,20 @@ import (
 	"encoding/json"
 	"errors"
 	"fmt"
+	"io"
+	"net/http"
+	"net/url"
+	"os"
+	"os/signal"
+	"time"
+
 	"github.com/goccy/go-yaml"
 	"github.com/google/uuid"
 	"github.com/samply/blazectl/data"
 	"github.com/samply/blazectl/fhir"
 	"github.com/samply/blazectl/util"
 	fm "github.com/samply/golang-fhir-models/fhir-models/fhir"
 	"github.com/spf13/cobra"
-	"io"
-	"net/http"
-	"net/url"
-	"os"
-	"os/signal"
-	"time"
 )
 
 var forceSync bool
@@ -69,6 +70,12 @@ func createMeasureGroup(g data.Group) (*fm.MeasureGroup, error) {
 			},
 		}
 	}
+	if g.Code != "" {
+		group.Code = &fm.CodeableConcept{Text: &g.Code}
+	}
+	if g.Description != "" {
+		group.Description = &g.Description
+	}
 	for i, population := range g.Population {
 		p, err := createMeasureGroupPopulation(population)
 		if err != nil {
@@ -103,22 +110,26 @@ func createMeasureGroupPopulation(population data.Population) (*fm.MeasureGroupP
 	}, nil
 }
 
-func createMeasureGroupStratifier(stratifier data.Stratifier) (*fm.MeasureGroupStratifier, error) {
-	if stratifier.Code == "" {
+func createMeasureGroupStratifier(s data.Stratifier) (*fm.MeasureGroupStratifier, error) {
+	if s.Code == "" {
 		return nil, fmt.Errorf("missing code")
 	}
-	if stratifier.Expression == "" {
+	if s.Expression == "" {
 		return nil, fmt.Errorf("missing expression name")
 	}
-	return &fm.MeasureGroupStratifier{
+	stratifier := fm.MeasureGroupStratifier{
 		Code: &fm.CodeableConcept{
-			Text: &stratifier.Code,
+			Text: &s.Code,
 		},
 		Criteria: &fm.Expression{
 			Language:   "text/cql-identifier",
-			Expression: &stratifier.Expression,
+			Expression: &s.Expression,
 		},
-	}, nil
+	}
+	if s.Description != "" {
+		stratifier.Description = &s.Description
+	}
+	return &stratifier, nil
 }
 
 func createCoding(system string, code string) fm.Coding {

cmd/evalueMeasure_test.go

@@ -4,14 +4,15 @@ import (
 	"encoding/json"
 	"errors"
 	"fmt"
-	"github.com/samply/blazectl/data"
-	"github.com/samply/blazectl/fhir"
-	fm "github.com/samply/golang-fhir-models/fhir-models/fhir"
-	"github.com/stretchr/testify/assert"
 	"net/http"
 	"net/http/httptest"
 	"net/url"
 	"testing"
+
+	"github.com/samply/blazectl/data"
+	"github.com/samply/blazectl/fhir"
+	fm "github.com/samply/golang-fhir-models/fhir-models/fhir"
+	"github.com/stretchr/testify/assert"
 )
 
 func TestCreateMeasureResource(t *testing.T) {
@@ -106,6 +107,52 @@ func TestCreateMeasureResource(t *testing.T) {
 		assert.Equal(t, "InInitialPopulation", *resource.Group[0].Population[0].Criteria.Expression)
 	})
 
+	t.Run("with one group with code and one population", func(t *testing.T) {
+		m := data.Measure{
+			Group: []data.Group{
+				{
+					Code: "observation",
+					Population: []data.Population{
+						{
+							Expression: "InInitialPopulation",
+						},
+					},
+				},
+			},
+		}
+
+		resource, err := CreateMeasureResource(m, measureUrl, libraryUrl)
+		if err != nil {
+			t.Fatalf("error while generating the measure resource: %v", err)
+		}
+
+		assert.Equal(t, 1, len(resource.Group))
+		assert.Equal(t, "observation", *resource.Group[0].Code.Text)
+	})
+
+	t.Run("with one group with description and one population", func(t *testing.T) {
+		m := data.Measure{
+			Group: []data.Group{
+				{
+					Description: "all the observations",
+					Population: []data.Population{
+						{
+							Expression: "InInitialPopulation",
+						},
+					},
+				},
+			},
+		}
+
+		resource, err := CreateMeasureResource(m, measureUrl, libraryUrl)
+		if err != nil {
+			t.Fatalf("error while generating the measure resource: %v", err)
+		}
+
+		assert.Equal(t, 1, len(resource.Group))
+		assert.Equal(t, "all the observations", *resource.Group[0].Description)
+	})
+
 	t.Run("with one group and one population and one empty stratifier", func(t *testing.T) {
 		m := data.Measure{
 			Group: []data.Group{
@@ -185,6 +232,36 @@ func TestCreateMeasureResource(t *testing.T) {
 		assert.Equal(t, "foo", *resource.Group[0].Stratifier[0].Code.Text)
 	})
 
+	t.Run("with one group and one population and one stratifier with description", func(t *testing.T) {
+		m := data.Measure{
+			Group: []data.Group{
+				{
+					Population: []data.Population{
+						{
+							Expression: "InInitialPopulation",
+						},
+					},
+					Stratifier: []data.Stratifier{
+						{
+							Code:        "foo",
+							Description: "the foo stratifier",
+							Expression:  "Foo",
+						},
+					},
+				},
+			},
+		}
+
+		resource, err := CreateMeasureResource(m, measureUrl, libraryUrl)
+		if err != nil {
+			t.Fatalf("error while generating the measure resource: %v", err)
+		}
+
+		assert.Equal(t, 1, len(resource.Group))
+		assert.Equal(t, 1, len(resource.Group[0].Stratifier))
+		assert.Equal(t, "the foo stratifier", *resource.Group[0].Stratifier[0].Description)
+	})
+
 	t.Run("with one Condition group", func(t *testing.T) {
 		m := data.Measure{
 			Group: []data.Group{

cmd/renderReport.go

@@ -0,0 +1,70 @@
+// Copyright 2019 - 2025 The Samply Community
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package cmd
+
+import (
+	_ "embed"
+	"encoding/json"
+	"io"
+	"os"
+
+	"html/template"
+
+	fm "github.com/samply/golang-fhir-models/fhir-models/fhir"
+	"github.com/spf13/cobra"
+)
+
+//go:embed report-template.gohtml
+var reportTemplate string
+
+var renderReportCmd = &cobra.Command{
+	Use:   "render-report",
+	Short: "Renders a MeasureReport",
+	RunE: func(cmd *cobra.Command, args []string) error {
+		data, err := io.ReadAll(os.Stdin)
+		if err != nil {
+			return err
+		}
+
+		var report fm.MeasureReport
+		if err := json.Unmarshal(data, &report); err != nil {
+			return err
+		}
+
+		funcMap := template.FuncMap{
+			"inc": func(i int) int {
+				return i + 1
+			},
+			"ratio": func(n int, d int) float32 {
+				return float32(n*100) / float32(d)
+			},
+			"isNullString": func(s *string) bool {
+				return s == nil || *s == "null"
+			},
+		}
+
+		tmpl := template.Must(template.New("report").Funcs(funcMap).Parse(reportTemplate))
+
+		if err := tmpl.Execute(os.Stdout, report); err != nil {
+			return err
+		}
+
+		return nil
+	},
+}
+
+func init() {
+	rootCmd.AddCommand(renderReportCmd)
+}