us_core_test_kit 0.1.0

data/lib/us_core_test_kit/generated/condition/condition_validation_test.rb

@@ -0,0 +1,34 @@
+require_relative '../../validation_test'
+
+module USCoreTestKit
+  class ConditionValidationTest < Inferno::Test
+    include USCoreTestKit::ValidationTest
+
+    id :us_core_311_condition_validation_test
+    title 'Condition resources returned during previous tests conform to the US Core Condition Profile'
+    description %(
+This test verifies resources returned from the first search conform to
+the [US Core Condition Profile](http://hl7.org/fhir/us/core/StructureDefinition/us-core-condition).
+
+It verifies the presence of mandatory elements and that elements with
+required bindings contain appropriate values. CodeableConcept element
+bindings will fail if none of their codings have a code/system belonging
+to the bound ValueSet. Quantity, Coding, and code element bindings will
+fail if their code/system are not found in the valueset.
+
+    )
+    output :dar_code_found, :dar_extension_found
+
+    def resource_type
+      'Condition'
+    end
+
+    def scratch_resources
+      scratch[:condition_resources] ||= {}
+    end
+
+    run do
+      perform_validation_test(scratch_resources[:all] || [], 'http://hl7.org/fhir/us/core/StructureDefinition/us-core-condition')
+    end
+  end
+end

data/lib/us_core_test_kit/generated/condition_group.rb

@@ -0,0 +1,91 @@
+require_relative 'condition/condition_patient_search_test'
+require_relative 'condition/condition_patient_onset_date_search_test'
+require_relative 'condition/condition_patient_category_search_test'
+require_relative 'condition/condition_patient_clinical_status_search_test'
+require_relative 'condition/condition_patient_code_search_test'
+require_relative 'condition/condition_read_test'
+require_relative 'condition/condition_provenance_revinclude_search_test'
+require_relative 'condition/condition_validation_test'
+require_relative 'condition/condition_must_support_test'
+require_relative 'condition/condition_reference_resolution_test'
+
+module USCoreTestKit
+  class ConditionGroup < Inferno::TestGroup
+    title 'Condition Tests'
+    short_description 'Verify support for the server capabilities required by the US Core Condition Profile.'
+    description %(
+# Background
+
+The US Core Condition sequence verifies that the system under test is
+able to provide correct responses for Condition queries. These queries
+must contain resources conforming to the US Core Condition Profile as
+specified in the US Core v3.1.1 Implementation Guide.
+
+# Testing Methodology
+## Searching
+This test sequence will first perform each required search associated
+with this resource. This sequence will perform searches with the
+following parameters:
+
+* patient
+
+### Search Parameters
+The first search uses the selected patient(s) from the prior launch
+sequence. Any subsequent searches will look for its parameter values
+from the results of the first search. For example, the `identifier`
+search in the patient sequence is performed by looking for an existing
+`Patient.identifier` from any of the resources returned in the `_id`
+search. If a value cannot be found this way, the search is skipped.
+
+### Search Validation
+Inferno will retrieve up to the first 20 bundle pages of the reply for
+Condition resources and save them for subsequent tests. Each of
+these resources is then checked to see if it matches the searched
+parameters in accordance with [FHIR search
+guidelines](https://www.hl7.org/fhir/search.html). The test will fail,
+for example, if a Patient search for `gender=male` returns a `female`
+patient.
+
+
+## Must Support
+Each profile contains elements marked as "must support". This test
+sequence expects to see each of these elements at least once. If at
+least one cannot be found, the test will fail. The test will look
+through the Condition resources found in the first test for these
+elements.
+
+## Profile Validation
+Each resource returned from the first search is expected to conform to
+the [US Core Condition Profile](http://hl7.org/fhir/us/core/StructureDefinition/us-core-condition). Each element is checked against
+teminology binding and cardinality requirements.
+
+Elements with a required binding are validated against their bound
+ValueSet. If the code/system in the element is not part of the ValueSet,
+then the test will fail.
+
+## Reference Validation
+Each reference within the resources found from the previous tests must
+resolve. The test will attempt to read each reference found and will
+fail if any attempted read fails.
+
+    )
+
+    id :us_core_311_condition
+    run_as_group
+
+    def self.metadata
+      @metadata ||= Generator::GroupMetadata.new(YAML.load_file(File.join(__dir__, 'condition', 'metadata.yml')))
+    end
+
+    test from: :us_core_311_condition_patient_search_test
+    test from: :us_core_311_condition_patient_onset_date_search_test
+    test from: :us_core_311_condition_patient_category_search_test
+    test from: :us_core_311_condition_patient_clinical_status_search_test
+    test from: :us_core_311_condition_patient_code_search_test
+    test from: :us_core_311_condition_read_test
+    test from: :us_core_311_condition_provenance_revinclude_search_test
+    test from: :us_core_311_condition_validation_test
+    test from: :us_core_311_condition_must_support_test
+    test from: :us_core_311_condition_reference_resolution_test
+  end
+end

data/lib/us_core_test_kit/generated/device/device_must_support_test.rb

@@ -0,0 +1,43 @@
+require_relative '../../must_support_test'
+
+module USCoreTestKit
+  class DeviceMustSupportTest < Inferno::Test
+    include USCoreTestKit::MustSupportTest
+
+    title 'All must support elements are provided in the Device resources returned'
+    description %(
+      US Core Responders SHALL be capable of populating all data elements as
+      part of the query results as specified by the US Core Server Capability
+      Statement. This test will look through the Device resources
+      found previously for the following must support elements:
+
+      * Device.distinctIdentifier
+      * Device.expirationDate
+      * Device.lotNumber
+      * Device.manufactureDate
+      * Device.patient
+      * Device.serialNumber
+      * Device.type
+      * Device.udiCarrier
+      * Device.udiCarrier.deviceIdentifier
+    )
+
+    id :us_core_311_device_must_support_test
+
+    def resource_type
+      'Device'
+    end
+
+    def self.metadata
+      @metadata ||= Generator::GroupMetadata.new(YAML.load_file(File.join(__dir__, 'metadata.yml')))
+    end
+
+    def scratch_resources
+      scratch[:device_resources] ||= {}
+    end
+
+    run do
+      perform_must_support_test(all_scratch_resources)
+    end
+  end
+end

data/lib/us_core_test_kit/generated/device/device_patient_search_test.rb

@@ -0,0 +1,65 @@
+require_relative '../../search_test'
+require_relative '../../generator/group_metadata'
+
+module USCoreTestKit
+  class DevicePatientSearchTest < Inferno::Test
+    include USCoreTestKit::SearchTest
+
+    title 'Server returns valid results for Device search by patient'
+    description %(
+A server SHALL support searching by
+patient on the Device resource. This test
+will pass if resources are returned and match the search criteria. If
+none are returned, the test is skipped.
+
+This test verifies that the server supports searching by reference using
+the form `patient=[id]` as well as `patient=Patient/[id]`. The two
+different forms are expected to return the same number of results. US
+Core requires that both forms are supported by US Core responders.
+
+Because this is the first search of the sequence, resources in the
+response will be used for subsequent tests.
+
+Additionally, this test will check that GET and POST search methods
+return the same number of results. Search by POST is required by the
+FHIR R4 specification, and these tests interpret search by GET as a
+requirement of US Core v3.1.1.
+
+[US Core Server CapabilityStatement](http://hl7.org/fhir/us/core/STU3.1.1/CapabilityStatement-us-core-server.html)
+
+    )
+
+    id :us_core_311_device_patient_search_test
+    input :patient_ids,
+      title: 'Patient IDs',
+      description: 'Comma separated list of patient IDs that in sum contain all MUST SUPPORT elements'
+
+    input :implantable_device_codes,
+      title: 'Implantable Device Type Code',
+      description: 'Enter the code for an Implantable Device type, or multiple codes separated by commas. '\
+                   'If blank, Inferno will validate all Device resources against the Implantable Device profile',
+      optional: true
+
+    def self.properties
+      @properties ||= SearchTestProperties.new(
+        first_search: true,
+        resource_type: 'Device',
+        search_param_names: ['patient'],
+        test_reference_variants: true,
+        test_post_search: true
+      )
+    end
+
+    def self.metadata
+      @metadata ||= Generator::GroupMetadata.new(YAML.load_file(File.join(__dir__, 'metadata.yml')))
+    end
+
+    def scratch_resources
+      scratch[:device_resources] ||= {}
+    end
+
+    run do
+      run_search_test
+    end
+  end
+end

data/lib/us_core_test_kit/generated/device/device_patient_type_search_test.rb

@@ -0,0 +1,52 @@
+require_relative '../../search_test'
+require_relative '../../generator/group_metadata'
+
+module USCoreTestKit
+  class DevicePatientTypeSearchTest < Inferno::Test
+    include USCoreTestKit::SearchTest
+
+    title 'Server returns valid results for Device search by patient + type'
+    description %(
+A server SHOULD support searching by
+patient + type on the Device resource. This test
+will pass if resources are returned and match the search criteria. If
+none are returned, the test is skipped.
+
+[US Core Server CapabilityStatement](http://hl7.org/fhir/us/core/STU3.1.1/CapabilityStatement-us-core-server.html)
+
+    )
+
+    id :us_core_311_device_patient_type_search_test
+    optional
+
+    input :patient_ids,
+      title: 'Patient IDs',
+      description: 'Comma separated list of patient IDs that in sum contain all MUST SUPPORT elements'
+
+    input :implantable_device_codes,
+      title: 'Implantable Device Type Code',
+      description: 'Enter the code for an Implantable Device type, or multiple codes separated by commas. '\
+                   'If blank, Inferno will validate all Device resources against the Implantable Device profile',
+      optional: true
+
+    def self.properties
+      @properties ||= SearchTestProperties.new(
+        resource_type: 'Device',
+        search_param_names: ['patient', 'type'],
+        token_search_params: ['type']
+      )
+    end
+
+    def self.metadata
+      @metadata ||= Generator::GroupMetadata.new(YAML.load_file(File.join(__dir__, 'metadata.yml')))
+    end
+
+    def scratch_resources
+      scratch[:device_resources] ||= {}
+    end
+
+    run do
+      run_search_test
+    end
+  end
+end

data/lib/us_core_test_kit/generated/device/device_provenance_revinclude_search_test.rb

@@ -0,0 +1,49 @@
+require_relative '../../search_test'
+require_relative '../../generator/group_metadata'
+
+module USCoreTestKit
+  class DeviceProvenanceRevincludeSearchTest < Inferno::Test
+    include USCoreTestKit::SearchTest
+
+    title 'Server returns Provenance resources from Device search by patient + revInclude:Provenance:target'
+    description %(
+      A server SHALL be capable of supporting _revIncludes:Provenance:target.
+
+      This test will perform a search by patient + revInclude:Provenance:target and
+      will pass if a Provenance resource is found in the response.
+    %)
+
+    id :us_core_311_device_provenance_revinclude_search_test
+
+    input :patient_ids,
+      title: 'Patient IDs',
+      description: 'Comma separated list of patient IDs that in sum contain all MUST SUPPORT elements'
+
+    def properties
+      @properties ||= SearchTestProperties.new(
+        resource_type: 'Device',
+        search_param_names: ['patient']
+      )
+    end
+
+    def self.metadata
+      @metadata ||= Generator::GroupMetadata.new(YAML.load_file(File.join(__dir__, 'metadata.yml')))
+    end
+
+    def self.provenance_metadata
+      @provenance_metadata ||= Generator::GroupMetadata.new(YAML.load_file(File.join(__dir__, '..', 'provenance', 'metadata.yml')))
+    end
+
+    def scratch_resources
+      scratch[:device_resources] ||= {}
+    end
+
+    def scratch_provenance_resources
+      scratch[:provenance_resources] ||= {}
+    end
+
+    run do
+      run_provenance_revinclude_search_test
+    end
+  end
+end

data/lib/us_core_test_kit/generated/device/device_read_test.rb

@@ -0,0 +1,24 @@
+require_relative '../../read_test'
+
+module USCoreTestKit
+  class DeviceReadTest < Inferno::Test
+    include USCoreTestKit::ReadTest
+
+    title 'Server returns correct Device resource from Device read interaction'
+    description 'A server SHALL support the Device read interaction.'
+
+    id :us_core_311_device_read_test
+
+    def resource_type
+      'Device'
+    end
+
+    def scratch_resources
+      scratch[:device_resources] ||= {}
+    end
+
+    run do
+      perform_read_test(all_scratch_resources)
+    end
+  end
+end

data/lib/us_core_test_kit/generated/device/device_reference_resolution_test.rb

@@ -0,0 +1,28 @@
+require_relative '../../reference_resolution_test'
+
+module USCoreTestKit
+  class DeviceReferenceResolutionTest < Inferno::Test
+    include USCoreTestKit::ReferenceResolutionTest
+
+    title 'Every reference within Device resources can be read'
+    description %(
+      This test will attempt to read the first 50 references found in the
+      resources from the first search. The test will fail if Inferno fails to
+      read any of those references.
+    )
+
+    id :us_core_311_device_reference_resolution_test
+
+    def resource_type
+      'Device'
+    end
+
+    def scratch_resources
+      scratch[:device_resources] ||= {}
+    end
+
+    run do
+      perform_reference_resolution_test(scratch_resources[:all])
+    end
+  end
+end

data/lib/us_core_test_kit/generated/device/device_validation_test.rb

@@ -0,0 +1,34 @@
+require_relative '../../validation_test'
+
+module USCoreTestKit
+  class DeviceValidationTest < Inferno::Test
+    include USCoreTestKit::ValidationTest
+
+    id :us_core_311_device_validation_test
+    title 'Device resources returned during previous tests conform to the US Core Implantable Device Profile'
+    description %(
+This test verifies resources returned from the first search conform to
+the [US Core Implantable Device Profile](http://hl7.org/fhir/us/core/StructureDefinition/us-core-implantable-device).
+
+It verifies the presence of mandatory elements and that elements with
+required bindings contain appropriate values. CodeableConcept element
+bindings will fail if none of their codings have a code/system belonging
+to the bound ValueSet. Quantity, Coding, and code element bindings will
+fail if their code/system are not found in the valueset.
+
+    )
+    output :dar_code_found, :dar_extension_found
+
+    def resource_type
+      'Device'
+    end
+
+    def scratch_resources
+      scratch[:device_resources] ||= {}
+    end
+
+    run do
+      perform_validation_test(scratch_resources[:all] || [], 'http://hl7.org/fhir/us/core/StructureDefinition/us-core-implantable-device')
+    end
+  end
+end

data/lib/us_core_test_kit/generated/device_group.rb

@@ -0,0 +1,85 @@
+require_relative 'device/device_patient_search_test'
+require_relative 'device/device_patient_type_search_test'
+require_relative 'device/device_read_test'
+require_relative 'device/device_provenance_revinclude_search_test'
+require_relative 'device/device_validation_test'
+require_relative 'device/device_must_support_test'
+require_relative 'device/device_reference_resolution_test'
+
+module USCoreTestKit
+  class DeviceGroup < Inferno::TestGroup
+    title 'Implantable Device Tests'
+    short_description 'Verify support for the server capabilities required by the US Core Implantable Device Profile.'
+    description %(
+# Background
+
+The US Core Implantable Device sequence verifies that the system under test is
+able to provide correct responses for Device queries. These queries
+must contain resources conforming to the US Core Implantable Device Profile as
+specified in the US Core v3.1.1 Implementation Guide.
+
+# Testing Methodology
+## Searching
+This test sequence will first perform each required search associated
+with this resource. This sequence will perform searches with the
+following parameters:
+
+* patient
+
+### Search Parameters
+The first search uses the selected patient(s) from the prior launch
+sequence. Any subsequent searches will look for its parameter values
+from the results of the first search. For example, the `identifier`
+search in the patient sequence is performed by looking for an existing
+`Patient.identifier` from any of the resources returned in the `_id`
+search. If a value cannot be found this way, the search is skipped.
+
+### Search Validation
+Inferno will retrieve up to the first 20 bundle pages of the reply for
+Device resources and save them for subsequent tests. Each of
+these resources is then checked to see if it matches the searched
+parameters in accordance with [FHIR search
+guidelines](https://www.hl7.org/fhir/search.html). The test will fail,
+for example, if a Patient search for `gender=male` returns a `female`
+patient.
+
+
+## Must Support
+Each profile contains elements marked as "must support". This test
+sequence expects to see each of these elements at least once. If at
+least one cannot be found, the test will fail. The test will look
+through the Device resources found in the first test for these
+elements.
+
+## Profile Validation
+Each resource returned from the first search is expected to conform to
+the [US Core Implantable Device Profile](http://hl7.org/fhir/us/core/StructureDefinition/us-core-implantable-device). Each element is checked against
+teminology binding and cardinality requirements.
+
+Elements with a required binding are validated against their bound
+ValueSet. If the code/system in the element is not part of the ValueSet,
+then the test will fail.
+
+## Reference Validation
+Each reference within the resources found from the previous tests must
+resolve. The test will attempt to read each reference found and will
+fail if any attempted read fails.
+
+    )
+
+    id :us_core_311_device
+    run_as_group
+
+    def self.metadata
+      @metadata ||= Generator::GroupMetadata.new(YAML.load_file(File.join(__dir__, 'device', 'metadata.yml')))
+    end
+
+    test from: :us_core_311_device_patient_search_test
+    test from: :us_core_311_device_patient_type_search_test
+    test from: :us_core_311_device_read_test
+    test from: :us_core_311_device_provenance_revinclude_search_test
+    test from: :us_core_311_device_validation_test
+    test from: :us_core_311_device_must_support_test
+    test from: :us_core_311_device_reference_resolution_test
+  end
+end

data/lib/us_core_test_kit/generated/diagnostic_report_lab/diagnostic_report_lab_must_support_test.rb

@@ -0,0 +1,43 @@
+require_relative '../../must_support_test'
+
+module USCoreTestKit
+  class DiagnosticReportLabMustSupportTest < Inferno::Test
+    include USCoreTestKit::MustSupportTest
+
+    title 'All must support elements are provided in the DiagnosticReport resources returned'
+    description %(
+      US Core Responders SHALL be capable of populating all data elements as
+      part of the query results as specified by the US Core Server Capability
+      Statement. This test will look through the DiagnosticReport resources
+      found previously for the following must support elements:
+
+      * DiagnosticReport.category
+      * DiagnosticReport.category:LaboratorySlice
+      * DiagnosticReport.code
+      * DiagnosticReport.effective[x]
+      * DiagnosticReport.issued
+      * DiagnosticReport.performer
+      * DiagnosticReport.result
+      * DiagnosticReport.status
+      * DiagnosticReport.subject
+    )
+
+    id :us_core_311_diagnostic_report_lab_must_support_test
+
+    def resource_type
+      'DiagnosticReport'
+    end
+
+    def self.metadata
+      @metadata ||= Generator::GroupMetadata.new(YAML.load_file(File.join(__dir__, 'metadata.yml')))
+    end
+
+    def scratch_resources
+      scratch[:diagnostic_report_lab_resources] ||= {}
+    end
+
+    run do
+      perform_must_support_test(all_scratch_resources)
+    end
+  end
+end

data/lib/us_core_test_kit/generated/diagnostic_report_lab/diagnostic_report_lab_patient_category_date_search_test.rb

@@ -0,0 +1,46 @@
+require_relative '../../search_test'
+require_relative '../../generator/group_metadata'
+
+module USCoreTestKit
+  class DiagnosticReportLabPatientCategoryDateSearchTest < Inferno::Test
+    include USCoreTestKit::SearchTest
+
+    title 'Server returns valid results for DiagnosticReport search by patient + category + date'
+    description %(
+A server SHALL support searching by
+patient + category + date on the DiagnosticReport resource. This test
+will pass if resources are returned and match the search criteria. If
+none are returned, the test is skipped.
+
+[US Core Server CapabilityStatement](http://hl7.org/fhir/us/core/STU3.1.1/CapabilityStatement-us-core-server.html)
+
+    )
+
+    id :us_core_311_diagnostic_report_lab_patient_category_date_search_test
+    input :patient_ids,
+      title: 'Patient IDs',
+      description: 'Comma separated list of patient IDs that in sum contain all MUST SUPPORT elements'
+
+    def self.properties
+      @properties ||= SearchTestProperties.new(
+        resource_type: 'DiagnosticReport',
+        search_param_names: ['patient', 'category', 'date'],
+        possible_status_search: true,
+        token_search_params: ['category'],
+        params_with_comparators: ['date']
+      )
+    end
+
+    def self.metadata
+      @metadata ||= Generator::GroupMetadata.new(YAML.load_file(File.join(__dir__, 'metadata.yml')))
+    end
+
+    def scratch_resources
+      scratch[:diagnostic_report_lab_resources] ||= {}
+    end
+
+    run do
+      run_search_test
+    end
+  end
+end

data/lib/us_core_test_kit/generated/diagnostic_report_lab/diagnostic_report_lab_patient_category_search_test.rb

@@ -0,0 +1,63 @@
+require_relative '../../search_test'
+require_relative '../../generator/group_metadata'
+
+module USCoreTestKit
+  class DiagnosticReportLabPatientCategorySearchTest < Inferno::Test
+    include USCoreTestKit::SearchTest
+
+    title 'Server returns valid results for DiagnosticReport search by patient + category'
+    description %(
+A server SHALL support searching by
+patient + category on the DiagnosticReport resource. This test
+will pass if resources are returned and match the search criteria. If
+none are returned, the test is skipped.
+
+This test verifies that the server supports searching by reference using
+the form `patient=[id]` as well as `patient=Patient/[id]`. The two
+different forms are expected to return the same number of results. US
+Core requires that both forms are supported by US Core responders.
+
+Because this is the first search of the sequence, resources in the
+response will be used for subsequent tests.
+
+Additionally, this test will check that GET and POST search methods
+return the same number of results. Search by POST is required by the
+FHIR R4 specification, and these tests interpret search by GET as a
+requirement of US Core v3.1.1.
+
+[US Core Server CapabilityStatement](http://hl7.org/fhir/us/core/STU3.1.1/CapabilityStatement-us-core-server.html)
+
+    )
+
+    id :us_core_311_diagnostic_report_lab_patient_category_search_test
+    input :patient_ids,
+      title: 'Patient IDs',
+      description: 'Comma separated list of patient IDs that in sum contain all MUST SUPPORT elements'
+
+    def self.properties
+      @properties ||= SearchTestProperties.new(
+        first_search: true,
+        fixed_value_search: true,
+        resource_type: 'DiagnosticReport',
+        search_param_names: ['patient', 'category'],
+        saves_delayed_references: true,
+        possible_status_search: true,
+        token_search_params: ['category'],
+        test_reference_variants: true,
+        test_post_search: true
+      )
+    end
+
+    def self.metadata
+      @metadata ||= Generator::GroupMetadata.new(YAML.load_file(File.join(__dir__, 'metadata.yml')))
+    end
+
+    def scratch_resources
+      scratch[:diagnostic_report_lab_resources] ||= {}
+    end
+
+    run do
+      run_search_test
+    end
+  end
+end