davinci_pdex_test_kit 0.11.0 → 0.12.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (111) hide show
  1. checksums.yaml +4 -4
  2. data/config/presets/pdex_payer_client_postman_preset.json.erb +67 -0
  3. data/config/presets/pdex_payer_server_fhir_foundry_ri_preset.json +2 -2
  4. data/config/presets/pdex_payer_server_inferno_ri_preset.json +2 -2
  5. data/lib/davinci_pdex_test_kit/docs/payer_client_suite_description_v200.md +124 -32
  6. data/lib/davinci_pdex_test_kit/pdex_payer_client/client_auth_smart_alca_group.rb +32 -0
  7. data/lib/davinci_pdex_test_kit/pdex_payer_client/client_auth_smart_alcs_group.rb +32 -0
  8. data/lib/davinci_pdex_test_kit/pdex_payer_client/client_auth_smart_alp_group.rb +32 -0
  9. data/lib/davinci_pdex_test_kit/pdex_payer_client/client_auth_udap_group.rb +31 -0
  10. data/lib/davinci_pdex_test_kit/pdex_payer_client/client_member_match_tests/client_member_match_validation_test.rb +7 -6
  11. data/lib/davinci_pdex_test_kit/pdex_payer_client/client_registration/configuration_display_smart_test.rb +38 -0
  12. data/lib/davinci_pdex_test_kit/pdex_payer_client/client_registration/configuration_display_udap_test.rb +38 -0
  13. data/lib/davinci_pdex_test_kit/pdex_payer_client/client_registration_group.rb +67 -0
  14. data/lib/davinci_pdex_test_kit/pdex_payer_client/client_validation_test.rb +10 -2
  15. data/lib/davinci_pdex_test_kit/pdex_payer_client/client_workflow_interaction_test.rb +43 -12
  16. data/lib/davinci_pdex_test_kit/pdex_payer_client/clinical_data_request_tests/allergyintolerance_clinical_data_request_test.rb +0 -1
  17. data/lib/davinci_pdex_test_kit/pdex_payer_client/clinical_data_request_tests/careplan_clinical_data_request_test.rb +0 -1
  18. data/lib/davinci_pdex_test_kit/pdex_payer_client/clinical_data_request_tests/careteam_clinical_data_request_test.rb +0 -1
  19. data/lib/davinci_pdex_test_kit/pdex_payer_client/clinical_data_request_tests/condition_clinical_data_request_test.rb +0 -1
  20. data/lib/davinci_pdex_test_kit/pdex_payer_client/clinical_data_request_tests/device_clinical_data_request_test.rb +1 -2
  21. data/lib/davinci_pdex_test_kit/pdex_payer_client/clinical_data_request_tests/diagnosticreport_clinical_data_request_test.rb +0 -1
  22. data/lib/davinci_pdex_test_kit/pdex_payer_client/clinical_data_request_tests/documentreference_clinical_data_request_test.rb +0 -1
  23. data/lib/davinci_pdex_test_kit/pdex_payer_client/clinical_data_request_tests/encounter_clinical_data_request_test.rb +0 -1
  24. data/lib/davinci_pdex_test_kit/pdex_payer_client/clinical_data_request_tests/explanationofbenefit_clinical_data_request_test.rb +0 -1
  25. data/lib/davinci_pdex_test_kit/pdex_payer_client/clinical_data_request_tests/goal_clinical_data_request_test.rb +0 -1
  26. data/lib/davinci_pdex_test_kit/pdex_payer_client/clinical_data_request_tests/immunization_clinical_data_request_test.rb +0 -1
  27. data/lib/davinci_pdex_test_kit/pdex_payer_client/clinical_data_request_tests/location_clinical_data_request_test.rb +0 -1
  28. data/lib/davinci_pdex_test_kit/pdex_payer_client/clinical_data_request_tests/medicationdispense_clinical_data_request_test.rb +0 -1
  29. data/lib/davinci_pdex_test_kit/pdex_payer_client/clinical_data_request_tests/medicationrequest_clinical_data_request_test.rb +0 -1
  30. data/lib/davinci_pdex_test_kit/pdex_payer_client/clinical_data_request_tests/observation_clinical_data_request_test.rb +0 -1
  31. data/lib/davinci_pdex_test_kit/pdex_payer_client/clinical_data_request_tests/organization_clinical_data_request_test.rb +0 -1
  32. data/lib/davinci_pdex_test_kit/pdex_payer_client/clinical_data_request_tests/patient_clinical_data_request_test.rb +0 -1
  33. data/lib/davinci_pdex_test_kit/pdex_payer_client/clinical_data_request_tests/practitioner_clinical_data_request_test.rb +0 -1
  34. data/lib/davinci_pdex_test_kit/pdex_payer_client/clinical_data_request_tests/practitionerrole_clinical_data_request_test.rb +0 -1
  35. data/lib/davinci_pdex_test_kit/pdex_payer_client/clinical_data_request_tests/procedure_clinical_data_request_test.rb +0 -1
  36. data/lib/davinci_pdex_test_kit/pdex_payer_client/mock_server/export_endpoint.rb +1 -1
  37. data/lib/davinci_pdex_test_kit/pdex_payer_client/mock_server/export_status_endpoint.rb +1 -1
  38. data/lib/davinci_pdex_test_kit/pdex_payer_client/mock_server/next_page_endpoint.rb +9 -2
  39. data/lib/davinci_pdex_test_kit/pdex_payer_client/mock_server/patient_endpoint.rb +1 -1
  40. data/lib/davinci_pdex_test_kit/pdex_payer_client/mock_server/proxy_endpoint.rb +15 -6
  41. data/lib/davinci_pdex_test_kit/pdex_payer_client/mock_server/resource_read_endpoint.rb +1 -1
  42. data/lib/davinci_pdex_test_kit/pdex_payer_client/mock_server/resource_search_endpoint.rb +1 -1
  43. data/lib/davinci_pdex_test_kit/pdex_payer_client/mock_server.rb +28 -2
  44. data/lib/davinci_pdex_test_kit/pdex_payer_client/mock_udap_smart_server/authorization_endpoint.rb +53 -0
  45. data/lib/davinci_pdex_test_kit/pdex_payer_client/mock_udap_smart_server/token_endpoint.rb +85 -0
  46. data/lib/davinci_pdex_test_kit/pdex_payer_client/pdex_client_options.rb +26 -0
  47. data/lib/davinci_pdex_test_kit/pdex_payer_client/tags.rb +8 -9
  48. data/lib/davinci_pdex_test_kit/pdex_payer_client/urls.rb +17 -9
  49. data/lib/davinci_pdex_test_kit/pdex_payer_client_suite.rb +57 -10
  50. data/lib/davinci_pdex_test_kit/pdex_payer_server/device/device_must_support_test.rb +50 -0
  51. data/lib/davinci_pdex_test_kit/pdex_payer_server/device/device_patient_search_test.rb +68 -0
  52. data/lib/davinci_pdex_test_kit/pdex_payer_server/device/device_patient_type_search_test.rb +54 -0
  53. data/lib/davinci_pdex_test_kit/pdex_payer_server/{explanation_of_benefit/explanation_of_benefit_provenance_revinclude_search_test.rb → device/device_provenance_revinclude_search_test.rb} +7 -7
  54. data/lib/davinci_pdex_test_kit/pdex_payer_server/device/device_read_test.rb +26 -0
  55. data/lib/davinci_pdex_test_kit/pdex_payer_server/device/device_reference_resolution_test.rb +42 -0
  56. data/lib/davinci_pdex_test_kit/pdex_payer_server/device/device_validation_test.rb +39 -0
  57. data/lib/davinci_pdex_test_kit/pdex_payer_server/device/metadata.yml +154 -0
  58. data/lib/davinci_pdex_test_kit/pdex_payer_server/device_group.rb +88 -0
  59. data/lib/davinci_pdex_test_kit/pdex_payer_server/explanation_of_benefit/explanation_of_benefit_id_search_test.rb +7 -24
  60. data/lib/davinci_pdex_test_kit/pdex_payer_server/explanation_of_benefit/explanation_of_benefit_identifier_search_test.rb +10 -24
  61. data/lib/davinci_pdex_test_kit/pdex_payer_server/explanation_of_benefit/explanation_of_benefit_must_support_test.rb +37 -5
  62. data/lib/davinci_pdex_test_kit/pdex_payer_server/explanation_of_benefit/explanation_of_benefit_patient_lastupdated_search_test.rb +48 -0
  63. data/lib/davinci_pdex_test_kit/pdex_payer_server/explanation_of_benefit/explanation_of_benefit_patient_search_test.rb +62 -0
  64. data/lib/davinci_pdex_test_kit/pdex_payer_server/explanation_of_benefit/explanation_of_benefit_patient_service_date_search_test.rb +7 -23
  65. data/lib/davinci_pdex_test_kit/pdex_payer_server/explanation_of_benefit/explanation_of_benefit_patient_type_search_test.rb +6 -23
  66. data/lib/davinci_pdex_test_kit/pdex_payer_server/explanation_of_benefit/explanation_of_benefit_reference_resolution_test.rb +7 -4
  67. data/lib/davinci_pdex_test_kit/pdex_payer_server/explanation_of_benefit/explanation_of_benefit_validation_test.rb +9 -10
  68. data/lib/davinci_pdex_test_kit/pdex_payer_server/explanation_of_benefit/metadata.yml +276 -264
  69. data/lib/davinci_pdex_test_kit/pdex_payer_server/explanation_of_benefit_group.rb +62 -64
  70. data/lib/davinci_pdex_test_kit/pdex_payer_server/export_patient_group.rb +8 -9
  71. data/lib/davinci_pdex_test_kit/pdex_payer_server/export_validation_group.rb +1 -2
  72. data/lib/davinci_pdex_test_kit/pdex_payer_server/medication_dispense/medication_dispense_must_support_test.rb +42 -0
  73. data/lib/davinci_pdex_test_kit/pdex_payer_server/medication_dispense/medication_dispense_patient_search_test.rb +64 -0
  74. data/lib/davinci_pdex_test_kit/pdex_payer_server/medication_dispense/medication_dispense_patient_status_search_test.rb +54 -0
  75. data/lib/davinci_pdex_test_kit/pdex_payer_server/medication_dispense/medication_dispense_patient_status_type_search_test.rb +55 -0
  76. data/lib/davinci_pdex_test_kit/pdex_payer_server/medication_dispense/medication_dispense_provenance_revinclude_search_test.rb +54 -0
  77. data/lib/davinci_pdex_test_kit/pdex_payer_server/medication_dispense/medication_dispense_read_test.rb +26 -0
  78. data/lib/davinci_pdex_test_kit/pdex_payer_server/medication_dispense/medication_dispense_reference_resolution_test.rb +42 -0
  79. data/lib/davinci_pdex_test_kit/pdex_payer_server/medication_dispense/medication_dispense_validation_test.rb +39 -0
  80. data/lib/davinci_pdex_test_kit/pdex_payer_server/medication_dispense/metadata.yml +206 -0
  81. data/lib/davinci_pdex_test_kit/pdex_payer_server/medication_dispense_group.rb +69 -0
  82. data/lib/davinci_pdex_test_kit/pdex_payer_server/multiple_member_matches_group.rb +36 -36
  83. data/lib/davinci_pdex_test_kit/pdex_payer_server/no_member_matches_group.rb +30 -30
  84. data/lib/davinci_pdex_test_kit/pdex_payer_server/patient_operation_in_capability_statement_validation.rb +15 -13
  85. data/lib/davinci_pdex_test_kit/pdex_payer_server/provenance/metadata.yml +173 -0
  86. data/lib/davinci_pdex_test_kit/pdex_payer_server/provenance/provenance_must_support_test.rb +51 -0
  87. data/lib/davinci_pdex_test_kit/pdex_payer_server/provenance/provenance_read_test.rb +26 -0
  88. data/lib/davinci_pdex_test_kit/pdex_payer_server/provenance/provenance_reference_resolution_test.rb +46 -0
  89. data/lib/davinci_pdex_test_kit/pdex_payer_server/provenance/provenance_validation_test.rb +39 -0
  90. data/lib/davinci_pdex_test_kit/pdex_payer_server/provenance_group.rb +59 -0
  91. data/lib/davinci_pdex_test_kit/pdex_payer_server/workflow_clinical_data_group.rb +22 -11
  92. data/lib/davinci_pdex_test_kit/pdex_payer_server/workflow_everything_group.rb +19 -6
  93. data/lib/davinci_pdex_test_kit/pdex_payer_server/workflow_export_group.rb +24 -16
  94. data/lib/davinci_pdex_test_kit/pdex_payer_server/workflow_member_match_group.rb +44 -25
  95. data/lib/davinci_pdex_test_kit/pdex_payer_server_suite.rb +123 -110
  96. data/lib/davinci_pdex_test_kit/pdex_provider_client_suite.rb +8 -8
  97. data/lib/davinci_pdex_test_kit/requirements/davinci-pdex-test-kit_out_of_scope_requirements.csv +1 -0
  98. data/lib/davinci_pdex_test_kit/requirements/davinci-pdex-test-kit_requirements.csv +66 -0
  99. data/lib/davinci_pdex_test_kit/requirements/generated/davinci-pdex-test-kit_requirements_coverage.csv +66 -0
  100. data/lib/davinci_pdex_test_kit/version.rb +2 -2
  101. data/lib/davinci_pdex_test_kit.rb +1 -0
  102. data/lib/inferno_requirements_tools/ext/inferno_core/runnable.rb +22 -0
  103. data/lib/inferno_requirements_tools/rake/rakefile_template +19 -0
  104. data/lib/inferno_requirements_tools/tasks/collect_requirements.rb +228 -0
  105. data/lib/inferno_requirements_tools/tasks/requirements_coverage.rb +284 -0
  106. data/lib/requirements_config.yaml +17 -0
  107. metadata +96 -13
  108. data/config/presets/pdex_payer_client_postman_preset.json +0 -12
  109. data/lib/davinci_pdex_test_kit/pdex_payer_client/mock_server/token_endpoint.rb +0 -27
  110. data/lib/davinci_pdex_test_kit/pdex_payer_server/explanation_of_benefit/explanation_of_benefit_patient_last_updated_search_test.rb +0 -64
  111. data/lib/davinci_pdex_test_kit/pdex_payer_server/explanation_of_benefit/explanation_of_benefit_patient_use_search_test.rb +0 -69
@@ -0,0 +1,228 @@
1
+ # frozen_string_literal: true
2
+
3
+ require 'CSV'
4
+ require 'roo'
5
+ require 'yaml'
6
+ require 'csv'
7
+
8
+ module InfernoRequirementsTools
9
+ module Tasks
10
+ # This class manages the collection of requirements details from
11
+ # requirements planning excel workbooks into a CSV representation.
12
+ # Currently splits out Requirements and Planned Not Tested Requirements
13
+ # into two separate files.
14
+ #
15
+ # The `run_check` method will check whether the previously generated file is up-to-date.
16
+ class CollectRequirements
17
+ CONFIG = YAML.load_file(File.join('lib', 'requirements_config.yaml'))
18
+
19
+ TEST_KIT_ID = CONFIG['test_kit_id']
20
+ INPUT_SETS = CONFIG['requirement_sets'].map do |req_set|
21
+ req_set['id']
22
+ end
23
+
24
+ # Derivative constants
25
+ TEST_KIT_CODE_FOLDER = TEST_KIT_ID.gsub('-', '_')
26
+ DASHERIZED_TEST_KIT_ID = TEST_KIT_ID.gsub('_', '-')
27
+ INPUT_HEADERS =
28
+ [
29
+ 'ID*',
30
+ 'URL*',
31
+ 'Requirement*',
32
+ 'Conformance*',
33
+ 'Actor*',
34
+ 'Sub-Requirement(s)',
35
+ 'Conditionality',
36
+ 'Verifiable?',
37
+ 'Verifiability Details',
38
+ 'Planning To Test?',
39
+ 'Planning To Test Details'
40
+ ].freeze
41
+ REQUIREMENTS_OUTPUT_HEADERS =
42
+ [
43
+ 'Req Set',
44
+ 'ID',
45
+ 'URL',
46
+ 'Requirement',
47
+ 'Conformance',
48
+ 'Actor',
49
+ 'Sub-Requirement(s)',
50
+ 'Conditionality'
51
+ ].freeze
52
+ REQUIREMENTS_OUTPUT_FILE_NAME = "#{DASHERIZED_TEST_KIT_ID}_requirements.csv".freeze
53
+ REQUIREMENTS_OUTPUT_FILE =
54
+ File.join('lib', TEST_KIT_CODE_FOLDER, 'requirements', REQUIREMENTS_OUTPUT_FILE_NAME).freeze
55
+ PLANNED_NOT_TESTED_OUTPUT_HEADERS = ['Req Set', 'ID', 'Reason', 'Details'].freeze
56
+ PLANNED_NOT_TESTED_OUTPUT_FILE_NAME = "#{DASHERIZED_TEST_KIT_ID}_out_of_scope_requirements.csv".freeze
57
+ PLANNED_NOT_TESTED_OUTPUT_FILE =
58
+ File.join('lib', TEST_KIT_CODE_FOLDER, 'requirements', PLANNED_NOT_TESTED_OUTPUT_FILE_NAME).freeze
59
+
60
+ def available_input_worksheets
61
+ @available_input_worksheets ||= Dir.glob(File.join(@input_directory, '*.xlsx')).reject { |f| f.include?('~$') }
62
+ end
63
+
64
+ # Of the form:
65
+ # {
66
+ # req_set_id_1: [row1, row2, row 3, ...],
67
+ # req_set_id_2: [row1, row2, row 3, ...]
68
+ # }
69
+ def input_requirement_sets
70
+ @input_requirement_sets ||= INPUT_SETS.each_with_object({}) do |req_set_id, hash|
71
+ req_set_file = available_input_worksheets.find { |worksheet_file| worksheet_file.include?(req_set_id) }
72
+
73
+ hash[req_set_id] =
74
+ unless req_set_file.nil?
75
+ CSV.parse(Roo::Spreadsheet.open(req_set_file).sheet('Requirements').to_csv,
76
+ headers: true).map do |row|
77
+ row.to_h.slice(*INPUT_HEADERS)
78
+ end
79
+ end
80
+ end
81
+ end
82
+
83
+ def new_requirements_csv
84
+ @new_requirements_csv ||=
85
+ CSV.generate(+"\xEF\xBB\xBF") do |csv| # start with an unnecessary BOM to make viewing in excel easier
86
+ csv << REQUIREMENTS_OUTPUT_HEADERS
87
+
88
+ input_requirement_sets.each do |req_set_id, input_rows|
89
+ input_rows.each do |input_row| # NOTE: use row order from source file
90
+ csv << REQUIREMENTS_OUTPUT_HEADERS.map do |header|
91
+ header == 'Req Set' ? req_set_id : input_row[header] || input_row["#{header}*"]
92
+ end
93
+ end
94
+ end
95
+ end
96
+ end
97
+
98
+ def old_requirements_csv
99
+ @old_requirements_csv ||= File.read(REQUIREMENTS_OUTPUT_FILE)
100
+ end
101
+
102
+ def new_planned_not_tested_csv
103
+ @new_planned_not_tested_csv ||=
104
+ CSV.generate(+"\xEF\xBB\xBF") do |csv| # start with an unnecessary BOM to make viewing in excel easier
105
+ csv << PLANNED_NOT_TESTED_OUTPUT_HEADERS
106
+
107
+ input_requirement_sets.each do |req_set_id, input_rows|
108
+ input_rows.each do |row|
109
+ if spreadsheet_value_falsy?(row['Verifiable?'])
110
+ csv << [req_set_id, row['ID*'], 'Not Verifiable', row['Verifiability Details']]
111
+ elsif spreadsheet_value_falsy?(row['Planning To Test?'])
112
+ csv << [req_set_id, row['ID*'], 'Not Tested', row['Planning To Test Details']]
113
+ end
114
+ end
115
+ end
116
+ end
117
+ end
118
+
119
+ def old_planned_not_tested_csv
120
+ @old_planned_not_tested_csv ||= File.read(PLANNED_NOT_TESTED_OUTPUT_FILE)
121
+ end
122
+
123
+ def run(input_directory)
124
+ @input_directory = input_directory
125
+ check_presence_of_input_files
126
+
127
+ update_requirements =
128
+ if File.exist?(REQUIREMENTS_OUTPUT_FILE)
129
+ if old_requirements_csv == new_requirements_csv
130
+ puts "'#{REQUIREMENTS_OUTPUT_FILE_NAME}' file is up to date."
131
+ false
132
+ else
133
+ puts 'Requirements set has changed.'
134
+ true
135
+ end
136
+ else
137
+ puts "No existing #{REQUIREMENTS_OUTPUT_FILE_NAME}."
138
+ true
139
+ end
140
+
141
+ if update_requirements
142
+ puts "Writing to file #{REQUIREMENTS_OUTPUT_FILE}..."
143
+ File.write(REQUIREMENTS_OUTPUT_FILE, new_requirements_csv, encoding: Encoding::UTF_8)
144
+ end
145
+
146
+ udpate_planned_not_tested =
147
+ if File.exist?(PLANNED_NOT_TESTED_OUTPUT_FILE)
148
+ if old_planned_not_tested_csv == new_planned_not_tested_csv
149
+ puts "'#{PLANNED_NOT_TESTED_OUTPUT_FILE_NAME}' file is up to date."
150
+ false
151
+ else
152
+ puts 'Planned Not Tested Requirements set has changed.'
153
+ true
154
+ end
155
+ else
156
+ puts "No existing #{PLANNED_NOT_TESTED_OUTPUT_FILE_NAME}."
157
+ true
158
+ end
159
+
160
+ if udpate_planned_not_tested
161
+ puts "Writing to file #{PLANNED_NOT_TESTED_OUTPUT_FILE}..."
162
+ File.write(PLANNED_NOT_TESTED_OUTPUT_FILE, new_planned_not_tested_csv, encoding: Encoding::UTF_8)
163
+ end
164
+
165
+ puts 'Done.'
166
+ end
167
+
168
+ def run_check(input_directory)
169
+ @input_directory = input_directory
170
+ check_presence_of_input_files
171
+
172
+ requirements_ok =
173
+ if File.exist?(REQUIREMENTS_OUTPUT_FILE)
174
+ if old_requirements_csv == new_requirements_csv
175
+ puts "'#{REQUIREMENTS_OUTPUT_FILE_NAME}' file is up to date."
176
+ true
177
+ else
178
+ puts "#{REQUIREMENTS_OUTPUT_FILE_NAME} file is out of date."
179
+ false
180
+ end
181
+ else
182
+ puts "No existing #{REQUIREMENTS_OUTPUT_FILE_NAME} file."
183
+ false
184
+ end
185
+
186
+ planned_not_tested_requirements_ok =
187
+ if File.exist?(PLANNED_NOT_TESTED_OUTPUT_FILE)
188
+ if old_planned_not_tested_csv == new_planned_not_tested_csv
189
+ puts "'#{PLANNED_NOT_TESTED_OUTPUT_FILE_NAME}' file is up to date."
190
+ true
191
+ else
192
+ puts "#{PLANNED_NOT_TESTED_OUTPUT_FILE_NAME} file is out of date."
193
+ false
194
+ end
195
+ else
196
+ puts "No existing #{PLANNED_NOT_TESTED_OUTPUT_FILE_NAME} file."
197
+ false
198
+ end
199
+
200
+ return if planned_not_tested_requirements_ok && requirements_ok
201
+
202
+ puts <<~MESSAGE
203
+ Check Failed. To resolve, run:
204
+
205
+ bundle exec rake "requirements:collect[<input_directory>]"
206
+
207
+ MESSAGE
208
+ exit(1)
209
+ end
210
+
211
+ def check_presence_of_input_files
212
+ input_requirement_sets.each do |req_set_id, rows|
213
+ next unless rows.nil?
214
+
215
+ puts %(
216
+ Could not find input file for set #{req_set_id} in directory #{@input_directory}. Aborting requirements
217
+ collection..."
218
+ )
219
+ exit(1)
220
+ end
221
+ end
222
+
223
+ def spreadsheet_value_falsy?(str)
224
+ %w[no false].include?(str&.downcase)
225
+ end
226
+ end
227
+ end
228
+ end
@@ -0,0 +1,284 @@
1
+ # frozen_string_literal: true
2
+
3
+ require 'csv'
4
+ require 'yaml'
5
+ require_relative '../ext/inferno_core/runnable'
6
+
7
+ module InfernoRequirementsTools
8
+ module Tasks
9
+ # This class manages the mapping of test kit tests to requirements that they verify
10
+ # and creates a CSV file with the tests that cover each requirement.
11
+ # It expects a CSV file in the repo at `lib/[test kit id]/requirements/[test kit id]_requirements.csv`
12
+ # that serves as the source of the requirement set for the test kit. The requirements in
13
+ # this files are identified by a requirement set and an id and tests, groups, and suites
14
+ # within in the test kit can claim that they verify a requirement by including a reference
15
+ # to that requirementin the form <requirement set>@<id> in their `verifies_requirements` field.
16
+ # Requirements that are out of scope can be listed in a companion file
17
+ # `lib/[test kit id]/requirements/[test kit id]_out_of_scope_requirements.csv`.
18
+ #
19
+ # The `run` method generates a CSV file at
20
+ # `lib/[test kit id]/requirements/generated/[test kit id]_requirements_coverage.csv``.
21
+ # This file will be identical to the input spreadsheet, plus an additional column which holds a comma separated
22
+ # list of inferno test IDs that test each requirement. These test IDs are Inferno short form IDs that represent the
23
+ # position of the test within its group and suite. For example, the fifth test in the second group will have an ID
24
+ # of 2.05. This ID is also shown in the Inferno web UI.
25
+ #
26
+ # The `run_check` method will check whether the previously generated file is up-to-date.
27
+ class RequirementsCoverage
28
+ VERSION = '0.2.0' # update when making meaningful changes to this method for tracking used versions
29
+ CONFIG = YAML.load_file(File.join('lib', 'requirements_config.yaml'))
30
+
31
+ TEST_KIT_ID = CONFIG['test_kit_id']
32
+ TEST_SUITES = CONFIG['suites'].map do |test_suite|
33
+ Object.const_get(test_suite['class_name'])
34
+ end
35
+
36
+ SUITE_ID_TO_ACTOR_MAP = CONFIG['suites'].each_with_object({}) do |test_suite, hash|
37
+ hash[test_suite['id']] = test_suite['suite_actor']
38
+ end
39
+
40
+ # Derivative constants
41
+ TEST_KIT_CODE_FOLDER = TEST_KIT_ID
42
+ DASHERIZED_TEST_KIT_ID = TEST_KIT_ID.gsub('_', '-')
43
+ INPUT_HEADERS = [
44
+ 'Req Set',
45
+ 'ID',
46
+ 'URL',
47
+ 'Requirement',
48
+ 'Conformance',
49
+ 'Actor',
50
+ 'Sub-Requirement(s)',
51
+ 'Conditionality'
52
+ ].freeze
53
+ SHORT_ID_HEADER = 'Short ID(s)'
54
+ FULL_ID_HEADER = 'Full ID(s)'
55
+ INPUT_FILE_NAME = "#{DASHERIZED_TEST_KIT_ID}_requirements.csv".freeze
56
+ INPUT_FILE = File.join('lib', TEST_KIT_CODE_FOLDER, 'requirements', INPUT_FILE_NAME).freeze
57
+ NOT_TESTED_FILE_NAME = "#{DASHERIZED_TEST_KIT_ID}_out_of_scope_requirements.csv".freeze
58
+ NOT_TESTED_FILE = File.join('lib', TEST_KIT_CODE_FOLDER, 'requirements', NOT_TESTED_FILE_NAME).freeze
59
+ OUTPUT_HEADERS = INPUT_HEADERS + TEST_SUITES.flat_map do |suite|
60
+ ["#{suite.title} #{SHORT_ID_HEADER}", "#{suite.title} #{FULL_ID_HEADER}"]
61
+ end
62
+ OUTPUT_FILE_NAME = "#{DASHERIZED_TEST_KIT_ID}_requirements_coverage.csv".freeze
63
+ OUTPUT_FILE_DIRECTORY = File.join('lib', TEST_KIT_CODE_FOLDER, 'requirements', 'generated')
64
+ OUTPUT_FILE = File.join(OUTPUT_FILE_DIRECTORY, OUTPUT_FILE_NAME).freeze
65
+
66
+ def input_rows
67
+ @input_rows ||=
68
+ CSV.parse(File.open(INPUT_FILE, 'r:bom|utf-8'), headers: true).map do |row|
69
+ row.to_h.slice(*INPUT_HEADERS)
70
+ end
71
+ end
72
+
73
+ def not_tested_requirements_map
74
+ @not_tested_requirements_map ||= load_not_tested_requirements
75
+ end
76
+
77
+ def load_not_tested_requirements
78
+ return {} unless File.exist?(NOT_TESTED_FILE)
79
+
80
+ not_tested_requirements = {}
81
+ CSV.parse(File.open(NOT_TESTED_FILE, 'r:bom|utf-8'), headers: true).each do |row|
82
+ row_hash = row.to_h
83
+ not_tested_requirements["#{row_hash['Req Set']}@#{row_hash['ID']}"] = row_hash
84
+ end
85
+
86
+ not_tested_requirements
87
+ end
88
+
89
+ # Of the form:
90
+ # {
91
+ # 'req-id-1': [
92
+ # { short_id: 'short-id-1', full_id: 'long-id-1', suite_id: 'suite-id-1' },
93
+ # { short_id: 'short-id-2', full_id: 'long-id-2', suite_id: 'suite-id-2' }
94
+ # ],
95
+ # 'req-id-2': [{ short_id: 'short-id-3', full_id: 'long-id-3', suite_id: 'suite-id-3' }],
96
+ # ...
97
+ # }
98
+ def inferno_requirements_map
99
+ @inferno_requirements_map ||= TEST_SUITES.each_with_object({}) do |suite, requirements_map|
100
+ serialize_requirements(suite, 'suite', suite.id, requirements_map)
101
+ suite.groups.each do |group|
102
+ map_group_requirements(group, suite.id, requirements_map)
103
+ end
104
+ end
105
+ end
106
+
107
+ def new_csv
108
+ @new_csv ||=
109
+ CSV.generate(+"\xEF\xBB\xBF") do |csv|
110
+ csv << OUTPUT_HEADERS
111
+ input_rows.each do |row| # NOTE: use row order from source file
112
+ next if row['Conformance'] == 'DEPRECATED' # filter out deprecated rows
113
+
114
+ TEST_SUITES.each do |suite|
115
+ suite_actor = SUITE_ID_TO_ACTOR_MAP[suite.id]
116
+ if row['Actor']&.include?(suite_actor)
117
+ add_suite_tests_for_row(row, suite)
118
+ else
119
+ row["#{suite.title} #{SHORT_ID_HEADER}"] = 'NA'
120
+ row["#{suite.title} #{FULL_ID_HEADER}"] = 'NA'
121
+ end
122
+ end
123
+ csv << row.values
124
+ end
125
+ end
126
+ end
127
+
128
+ def add_suite_tests_for_row(row, suite)
129
+ set_and_req_id = "#{row['Req Set']}@#{row['ID']}"
130
+ items = get_items_for_requirement(set_and_req_id, suite)
131
+ short_ids = items[0]
132
+ full_ids = items[1]
133
+ if short_ids.blank? && not_tested_requirements_map.key?(set_and_req_id)
134
+ row["#{suite.title} #{SHORT_ID_HEADER}"] = 'Not Tested'
135
+ row["#{suite.title} #{FULL_ID_HEADER}"] = 'Not Tested'
136
+ else
137
+ row["#{suite.title} #{SHORT_ID_HEADER}"] = short_ids&.join(', ')
138
+ row["#{suite.title} #{FULL_ID_HEADER}"] = full_ids&.join(', ')
139
+ end
140
+ end
141
+
142
+ def get_items_for_requirement(set_and_req_id, suite)
143
+ suite_requirement_items = inferno_requirements_map[set_and_req_id]&.filter do |item|
144
+ item[:suite_id] == suite.id
145
+ end
146
+ [
147
+ suite_requirement_items&.map { |item| item[:short_id] },
148
+ suite_requirement_items&.map { |item| item[:full_id] }
149
+ ]
150
+ end
151
+
152
+ def input_requirement_ids
153
+ @input_requirement_ids ||= input_rows.map { |row| "#{row['Req Set']}@#{row['ID']}" }
154
+ end
155
+
156
+ # The requirements present in Inferno that aren't in the input spreadsheet
157
+ def unmatched_requirements_map
158
+ @unmatched_requirements_map ||= inferno_requirements_map.except(*input_requirement_ids)
159
+ end
160
+
161
+ def old_csv
162
+ @old_csv ||= File.read(OUTPUT_FILE)
163
+ end
164
+
165
+ def run
166
+ unless File.exist?(INPUT_FILE)
167
+ puts "Could not find input file: #{INPUT_FILE}. Aborting requirements coverage generation..."
168
+ exit(1)
169
+ end
170
+
171
+ if unmatched_requirements_map.any?
172
+ puts "WARNING: The following requirements indicated in the test kit are not present in #{INPUT_FILE_NAME}"
173
+ output_requirements_map_table(unmatched_requirements_map)
174
+ end
175
+
176
+ if File.exist?(OUTPUT_FILE)
177
+ if old_csv == new_csv
178
+ puts "'#{OUTPUT_FILE_NAME}' file is up to date."
179
+ return
180
+ else
181
+ puts 'Requirements coverage has changed.'
182
+ end
183
+ else
184
+ puts "No existing #{OUTPUT_FILE_NAME}."
185
+ end
186
+
187
+ puts "Writing to file #{OUTPUT_FILE}..."
188
+ FileUtils.mkdir_p(OUTPUT_FILE_DIRECTORY)
189
+ File.write(OUTPUT_FILE, new_csv)
190
+ puts 'Done.'
191
+ end
192
+
193
+ def run_check
194
+ unless File.exist?(INPUT_FILE)
195
+ puts "Could not find input file: #{INPUT_FILE}. Aborting requirements coverage check..."
196
+ exit(1)
197
+ end
198
+
199
+ if unmatched_requirements_map.any?
200
+ puts "The following requirements indicated in the test kit are not present in #{INPUT_FILE_NAME}"
201
+ output_requirements_map_table(unmatched_requirements_map)
202
+ end
203
+
204
+ if File.exist?(OUTPUT_FILE)
205
+ if old_csv == new_csv
206
+ puts "'#{OUTPUT_FILE_NAME}' file is up to date."
207
+ return unless unmatched_requirements_map.any?
208
+ else
209
+ puts <<~MESSAGE
210
+ #{OUTPUT_FILE_NAME} file is out of date.
211
+ To regenerate the file, run:
212
+
213
+ bundle exec rake requirements:generate_coverage
214
+
215
+ MESSAGE
216
+ end
217
+ else
218
+ puts <<~MESSAGE
219
+ No existing #{OUTPUT_FILE_NAME} file.
220
+ To generate the file, run:
221
+
222
+ bundle exec rake requirements:generate_coverage
223
+
224
+ MESSAGE
225
+ end
226
+
227
+ puts 'Check failed.'
228
+ exit(1)
229
+ end
230
+
231
+ def map_group_requirements(group, suite_id, requirements_map)
232
+ serialize_requirements(group, group.short_id, suite_id, requirements_map)
233
+ group.tests&.each { |test| serialize_requirements(test, test.short_id, suite_id, requirements_map) }
234
+ group.groups&.each { |subgroup| map_group_requirements(subgroup, suite_id, requirements_map) }
235
+ end
236
+
237
+ def serialize_requirements(runnable, short_id, suite_id, requirements_map)
238
+ runnable.verifies_requirements&.each do |requirement_id|
239
+ requirement_id_string = requirement_id.to_s
240
+
241
+ requirements_map[requirement_id_string] ||= []
242
+ requirements_map[requirement_id_string] << { short_id:, full_id: runnable.id, suite_id: }
243
+ end
244
+ end
245
+
246
+ # Output the requirements in the map like so:
247
+ #
248
+ # requirement_id | short_id | full_id
249
+ # ---------------+------------+----------
250
+ # req-id-1 | short-id-1 | full-id-1
251
+ # req-id-2 | short-id-2 | full-id-2
252
+ #
253
+ def output_requirements_map_table(requirements_map)
254
+ headers = %w[requirement_id short_id full_id]
255
+ col_widths = headers.map(&:length)
256
+ col_widths[0] = [col_widths[0], requirements_map.keys.map(&:length).max].max
257
+ col_widths[1] = ([col_widths[1]] + requirements_map.values.flatten.map { |item| item[:short_id].length }).max
258
+ col_widths[2] = ([col_widths[2]] + requirements_map.values.flatten.map { |item| item[:full_id].length }).max
259
+ col_widths.map { |width| width + 3 }
260
+
261
+ puts [
262
+ headers[0].ljust(col_widths[0]),
263
+ headers[1].ljust(col_widths[1]),
264
+ headers[2].ljust(col_widths[2])
265
+ ].join(' | ')
266
+ puts col_widths.map { |width| '-' * width }.join('-+-')
267
+ output_requirements_map_table_contents(requirements_map, col_widths)
268
+ puts
269
+ end
270
+
271
+ def output_requirements_map_table_contents(requirements_map, col_widths)
272
+ requirements_map.each do |requirement_id, runnables|
273
+ runnables.each do |runnable|
274
+ puts [
275
+ requirement_id.ljust(col_widths[0]),
276
+ runnable[:short_id].ljust(col_widths[1]),
277
+ runnable[:full_id].ljust(col_widths[2])
278
+ ].join(' | ')
279
+ end
280
+ end
281
+ end
282
+ end
283
+ end
284
+ end
@@ -0,0 +1,17 @@
1
+ test_kit_id: davinci_pdex_test_kit
2
+
3
+ suites:
4
+ - id: pdex_payer_server
5
+ class_name: DaVinciPDexTestKit::PDexPayerServerSuite
6
+ suite_actor: Server
7
+ - id: pdex_payer_client
8
+ class_name: DaVinciPDexTestKit::PDexPayerClientSuite
9
+ suite_actor: Client
10
+
11
+ requirement_sets:
12
+ - id: hl7.fhir.us.davinci-pdex_2.0.0
13
+ folder: PDex
14
+ requirements: All
15
+ actor_map:
16
+ - {spec: Server, test_kit: Server}
17
+ - {spec: Client, test_kit: Client}