healthcare_phony 0.4.1 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7ca0b2d6dc3884c2d04d140ac59a78f88abf316ce203c042ae3eeba4b39423bf
-  data.tar.gz: c5b7e20a1bf7d070847e1aab071c21536b13cfba5ba8f3536eb84406add20cb5
+  metadata.gz: 0bf69a0e95725d4b59987822d2ee0245635900728ce68eb50211ec7bd146a3fc
+  data.tar.gz: 783ce3a984372d26e1348d4c5fb5db6506b1db8111316be33e1d39736aa60137
 SHA512:
-  metadata.gz: c161e48cef5b3f4365aa13693d56ef55ea02c74c7744d5f71caa64f58e84ff6ff4faea6cea409a48d7b879ec71e47aa410a19871eb4017147daf12f34f775df4
-  data.tar.gz: 51420c695bc3bf1db62dc8bcbd3ffb0264d1371bbe50d3dea95159f632ecec4b51a861b380ec1eb332a619af576a72a12b2d3291ea259a75548c8fc26359d356
+  metadata.gz: 721a6a91d809ab0af3d810c8ce2eaba33cbcd398dd38433251027ca629db3ba93f8d7efa782f355b25595f9bdd736c7166219e8bde973a82b43b2d2509e5d312
+  data.tar.gz: 4344b7d926102eb4e97f1489897635cd65891a7acbb302c9556ce11fc8337c3cee745bdd9633d43514dad5d9814c40060fbffe517203be85245427a90a98f000

data/README.md

@@ -147,6 +147,7 @@ The creation of the Patient can be customized by sending the following parameter
 * race_count → By default on Race is generated, this allows you to specify a number > 1.
 * gender → A Gender object which will be used to generate a Male or Female name if specified.
 * degree_data_file → Location of YAML file containing a list of potential degrees to choose from. By default the gem supplied file will be used.  The default file [degree.yml](https://github.com/austinmoody/healthcare_phony/blob/main/lib/healthcare_phony/data_files/degree.yml).
+* visit_type → VisitType of this patient's visit
 
 ### Patient Visit
 
@@ -309,6 +310,48 @@ The creation of the Hl7Message object can be customized by sending the following
 * message_receiving_application - Array of Receiving Applications (MSH.5) to randomly choose from.  Specified as comma separated String or Ruby Array.
 * message_receiving_facility - Array of Receiving Facilities (MSH.6) to randomly choose from.  Specified as comma separated String or Ruby Array.
 
+## Examples
+
+See the examples directory.
+
+So far there phony_adt_sender.rb.  This script will generate a specified number of fake ADT messages and send them to the specified host and port using TCP/IP mllp.
+
+Command line argument description:
+
+```text
+Usage: phony_adt_sender.rb [options]
+
+    -n, --number NUMBER              Number of messages to send
+    -h, --host HOST                  IP or DNS for listening host
+    -p, --port PORT                  Listening port
+    -c, --config CONFIGFILE          Path to configuration file (YAML) for message parameters
+        --mllp-start HEX             Hex character(s) to denote start of message bytes. In form nn (example 0b for vertical tab) or nnnn (example 1c0d for file separator & carriage return)
+        --mllp-end HEX               Hex character(s) to denote start of message bytes. In form nn (example 0b for vertical tab) or nnnn (example 1c0d for file separator & carriage return)
+        --help                       Show this message
+```
+
+An example config file is also in the examples directory.
+
+So to send 100 messages to 192.168.1.50:3022 using a config file phony_adt_sender.yml with non-standard mllp beginning/ending.
+
+```text
+ruby phony_adt_sender.rb -h 192.168.1.50 --number 100 --port 3022 --config phony_adt_sender.yml --mllp-start 05 --mllp-end 0304
+```
+
+Also in the examples directory are two files that can be used to generate a CSV.
+
+* phony_csv.yml → a configuration file that can be used to set parametesr for generation patients.  Then two items specific to creating the CSV
+  * number_of_rows → The # of rows to write
+  * template_file → Path to a ERB template for the CSV.  If not specified the default in the library is used.
+* bigger_csv_example.erb → Just another CSV template example.
+
+Using these files in IRB (or in a script) you could do:
+
+```ruby
+csv_parameters = Psych.load_file('./examples/phony_csv.yml')
+csv = HealthcarePhony::CsvFile.new(csv_parameters)
+csv.to_file("d:/temp/testnewtemplate.csv")
+```
 ## Contributing
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/austinmoody/healthcare_phony. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/[USERNAME]/healthcare_phony/blob/master/CODE_OF_CONDUCT.md).

data/VERSION

@@ -1 +1 @@
-0.4.1
+0.7.0

data/examples/bigger_csv_example.erb

@@ -0,0 +1,4 @@
+<% if write_header %>
+Patient_Identifier,First_Name,Middle_Name,Last_Name,Address_1,City,State,Zip,Home_Phone,Work_Phone,Cell_Phone,DOB,Gender,SSN
+<% end %>
+"<%= patient.medical_record_number.identifier %>","<%= patient.names[0].given_name %>","<%= patient.names[0].middle_name %>","<%= patient.names[0].family_name %>","<%= patient.addresses[0].address_line1 %>","<%= patient.addresses[0].city %>","<%= patient.addresses[0].state %>","<%= patient.addresses[0].postal_code %>","(<%= patient.home_phone.area_code %>)<%= patient.home_phone.exchange_code %>-<%= patient.home_phone.subscriber_number %>","(<%= patient.work_phone.area_code %>)<%= patient.work_phone.exchange_code %>-<%= patient.work_phone.subscriber_number %>","(<%= patient.cell_phone.area_code %>)<%= patient.cell_phone.exchange_code %>-<%= patient.cell_phone.subscriber_number %>","<%= patient.date_of_birth.to_s %>","<%= patient.gender.code %>","<%= patient.ssn %>"

data/examples/phony_adt_sender.rb

@@ -0,0 +1,111 @@
+# frozen_string_literal: true
+
+require 'socket'
+require 'healthcare_phony'
+require 'optparse'
+require 'psych'
+
+class PhonyAdtSender
+  attr_reader :host, :port, :number_messages, :message_parameters, :mllp_start, :mllp_end
+
+  def initialize
+    @message_parameters = {}
+    parse
+  end
+
+  def send
+    puts "Sending #{@number_messages} messages to #{@host}:#{@port}"
+
+    @number_messages.to_i.times do
+      t = TCPSocket.new(@host, @port)
+
+      m = HealthcarePhony::Adt.new(@message_parameters)
+      # #{@mllp_start}
+      t.send "#{[@mllp_start].pack("H*")}#{m.to_s}#{[@mllp_end].pack("H*")}", 0
+
+      pp "Message With ID #{m.hl7_message.message_control_id} sent..."
+
+      reading_response = true
+      ack_response = ''
+      while reading_response
+        current_read = t.read(1)
+        ack_response += current_read unless current_read.nil?
+        reading_response = false if current_read.nil?
+      end
+
+      pp "ACK: #{ack_response}"
+
+      t.close
+    end
+  end
+
+  private
+
+  def parse
+    options = {}
+    optparse = OptionParser.new do |parser|
+      parser.banner = 'Usage: phony_adt_sender.rb [options]'
+      parser.separator ''
+
+      parser.on('-n', '--number NUMBER', Integer, 'Number of messages to send') do |number_messages|
+        options[:number_messages] = number_messages
+      end
+
+      parser.on('-h', '--host HOST', String, 'IP or DNS for listening host') do |host|
+        options[:host] = host
+      end
+
+      parser.on('-p', '--port PORT', Integer, 'Listening port') do |port|
+        options[:port] = port
+      end
+
+      parser.on('-c', '--config CONFIGFILE', String, 'Path to configuration file (YAML) for message parameters') do |config|
+        options[:config] = config
+      end
+
+      parser.on('--mllp-start HEX',
+                'Hex character(s) to denote start of message bytes. In form nn (example 0b for vertical tab) or nnnn (example 1c0d for file separator & carriage return)') do |mllp_start|
+        options[:mllp_start] = mllp_start
+      end
+
+      parser.on('--mllp-end HEX', String,
+                'Hex character(s) to denote start of message bytes. In form nn (example 0b for vertical tab) or nnnn (example 1c0d for file separator & carriage return)') do |mllp_end|
+        options[:mllp_end] = mllp_end
+      end
+
+      parser.on('--help', 'Show this message') do
+        puts parser
+        exit
+      end
+    end
+
+    begin
+      optparse.parse!
+      mandatory = %i[host port number_messages]
+      missing = mandatory.select { |param| options[param].nil? }
+      raise OptionParser::MissingArgument, missing.join(', ') unless missing.empty?
+    rescue OptionParser::InvalidOption, OptionParser::MissingArgument
+      puts $!.to_s
+      puts optparse
+      exit
+    end
+
+    @host = options[:host]
+    @port = options[:port]
+    @number_messages = options[:number_messages]
+    @message_parameters = Psych.load_file(options[:config]) unless options[:config].nil?
+    @mllp_start = if options[:mllp_start].nil?
+                    '0b'
+                  else
+                    options[:mllp_start]
+                  end
+    @mllp_end = if options[:mllp_end].nil?
+                  '1c0d'
+                else
+                  options[:mllp_end]
+                end
+  end
+end
+
+pas = PhonyAdtSender.new
+pas.send

data/examples/phony_adt_sender.yml

@@ -0,0 +1,12 @@
+---
+:message_sending_facility: HOSP1,HOSP2,HOSP3
+:message_sending_application: RUBY
+:message_receiving_application: MIRTH
+:message_receiving_facility: NCSAS
+:message_version: '2.5.1'
+:patient_class: I,O,E
+:adt_events: A01,A03,A04,A08
+:message_control_id_pattern: HEALTHCARE_PHONY_\d{15}
+:message_processing_id: P
+:given_name_append: ZZFAKE
+:family_name_append: ZZPHONY

data/examples/phony_csv.yml

@@ -0,0 +1,5 @@
+---
+:given_name_append: ZZFAKE
+:family_name_append: ZZPHONY
+:number_of_rows: 1000
+:template_file: "D:/Users/amoody/RubymineProjects/healthcare_phony/examples/bigger_csv_example.erb"

data/lib/healthcare_phony.rb

@@ -11,41 +11,57 @@ Faker::Config.locale = 'en-US'
 
 module HealthcarePhony
   class Adt
-    attr_reader :template, :adt_arguments
+    attr_reader :template, :adt_arguments, :hl7_message, :patient, :visit
 
-    def initialize(**init_args)
+    def initialize(init_args = {})
       @adt_arguments = init_args
       @adt_arguments[:message_types] = 'ADT'
-      unless adt_arguments[:template].nil?
-        @template = adt_arguments[:template]
+      set_template
+      @hl7_message = Hl7Message.new(@adt_arguments)
+      @patient = Patient.new(@adt_arguments)
+      @visit = PatientVisit.new(@adt_arguments.merge({ visit_type: set_visit_type }))
+    end
+
+    def to_s
+      erb_template = ERB.new(@template)
+      erb_template.result_with_hash({ patient: @patient, hl7: @hl7_message, visit: @visit })
+    end
+
+    private
+
+    def set_template
+      unless @adt_arguments[:template].nil?
+        @template = @adt_arguments[:template]
         return
       end
-      @template = if adt_arguments[:template_file].nil?
+      @template = if @adt_arguments[:template_file].nil?
                     File.read(File.join(File.dirname(__FILE__), 'healthcare_phony', 'templates', 'adt_example.erb'))
                   else
-                    File.read(adt_arguments[:template_file])
+                    File.read(@adt_arguments[:template_file])
                   end
     end
 
-    def to_s
-      template = ERB.new(@template)
-      message = Hl7Message.new(@adt_arguments)
-      patient = Patient.new(@adt_arguments)
-      visit = PatientVisit.new(@adt_arguments)
-      template.result_with_hash({ patient: patient, hl7: message, visit: visit })
+    def set_visit_type
+      case @hl7_message.trigger_event
+      when 'A01'
+        HealthcarePhony::VisitType::ADMIT
+      when 'A03'
+        HealthcarePhony::VisitType::DISCHARGE
+      when 'A04'
+        HealthcarePhony::VisitType::REGISTRATION
+      else
+        HealthcarePhony::VisitType::OTHER
+      end
     end
   end
 
   class CsvFile
-    attr_reader :template_file, :number_of_rows
-
-    def initialize(number_of_rows, template_file = nil)
-      @template_file = if template_file.nil?
-                         File.join(File.dirname(__FILE__), 'healthcare_phony', 'templates', 'csv_example.erb')
-                       else
-                         template_file
-                       end
-      @number_of_rows = number_of_rows
+    attr_reader :template_file, :number_of_rows, :csv_arguments
+
+    def initialize(init_args = {}) #(number_of_rows, template_file = nil)
+      @csv_arguments = init_args
+      @number_of_rows = @csv_arguments[:number_of_rows] #@csv_arguments[:number_of_rows].nil? ? 1 : @csv_arguments[:number_of_rows]
+      set_template
     end
 
     def to_s
@@ -53,11 +69,39 @@ module HealthcarePhony
       counter = 0
       output_string = ''
       while counter < @number_of_rows
-        output_string += "#{template.result_with_hash({ patient: Patient.new, write_header: counter.zero? })}\n"
+        output_string += "#{template.result_with_hash({ patient: Patient.new(@csv_arguments), write_header: counter.zero? })}\n"
         counter += 1
       end
       output_string
     end
+
+    def to_file(file_name)
+      template = ERB.new(File.read(@template_file), trim_mode: '<>')
+      counter = 0
+      output_file = File.open(file_name, 'w')
+      while counter < @number_of_rows
+        output_file.write("#{template.result_with_hash({ patient: Patient.new(@csv_arguments), write_header: counter.zero? })}\n")
+        counter += 1
+      end
+      output_file.close
+
+      return output_file
+
+    end
+
+    private
+
+    def set_template
+      unless @csv_arguments[:template].nil?
+        @template_file = @csv_arguments[:template]
+        return
+      end
+      @template_file = if @csv_arguments[:template_file].nil?
+                    File.join(File.dirname(__FILE__), 'healthcare_phony', 'templates', 'csv_example.erb') #File.read(File.join(File.dirname(__FILE__), 'healthcare_phony', 'templates', 'csv_example.erb'))
+                  else
+                    @csv_arguments[:template_file]
+                  end
+    end
   end
 end
 

data/lib/healthcare_phony/address.rb

@@ -13,7 +13,7 @@ module HealthcarePhony
     # address_type_data_file - YAML file containing address types to randomly choose from if different options than
     # those that come with gem are desired.
     # See {address_type.yml}[https://github.com/austinmoody/healthcare_phony/blob/main/lib/healthcare_phony/data_files/address_type.yml]
-    def initialize(**init_args)
+    def initialize(init_args = {})
       @set_blank = !init_args[:blank].nil? && Helper.random_with_blank('X', init_args[:blank]) == ''
       @state = init_args[:state]
       @country = init_args[:country]

data/lib/healthcare_phony/cell_phone_number.rb

@@ -9,7 +9,7 @@ module HealthcarePhony
     # blank - An integer representing the % of times phone number components should be blank.
     # use_code - Allows specification of the phone use code (PID.13.2)
     # equipment_type - Allows specification of the phone equipment type (PID.13.3)
-    def initialize(**init_args)
+    def initialize(init_args = {})
       super(init_args)
       @use_code = init_args[:use_code].nil? ? 'ORN' : init_args[:use_code]
       @use_code = '' unless @set_blank == false

data/lib/healthcare_phony/doctor.rb

@@ -11,7 +11,7 @@ module HealthcarePhony
     # Public: Initialize a Doctor.  Pass in hash of different parameters, currently this includes:
     #
     # identifier - Allows you to specify an identifier for this Doctor instead of having it randomly generated.
-    def initialize(**init_args)
+    def initialize(init_args = {})
       @identifier = if !init_args[:identifier].nil?
                       init_args[:identifier]
                     else
@@ -19,7 +19,8 @@ module HealthcarePhony
                       (pre_check_npi.to_s + Helper.get_npi_check_digit(pre_check_npi).to_s).to_i
                     end
 
-      @name = PersonName.new(degree: 'MD,DO')
+      init_args[:degree] = 'MD,DO'
+      @name = PersonName.new(init_args)
     end
   end
 end

data/lib/healthcare_phony/email.rb

@@ -7,7 +7,7 @@ module HealthcarePhony
                   :use_code,
                   :equipment_type
 
-    def initialize(**init_args)
+    def initialize(init_args = {})
       @set_blank = !init_args[:blank].nil? && Helper.random_with_blank('X', init_args[:blank]) == ''
       @email_address = Faker::Internet.email
       @email_address = '' unless @set_blank == false

data/lib/healthcare_phony/ethnic_group.rb

@@ -12,7 +12,7 @@ module HealthcarePhony
     # ethnic_group_data_file - YAML file containing ethnic group information to randomly choose from if different options than
     # those that come with gem are desired.  See {ethnic_group.yml}[https://github.com/austinmoody/healthcare_phony/blob/main/lib/healthcare_phony/data_files/ethnic_group.yml]
     # for default values.
-    def initialize(**init_args)
+    def initialize(init_args = {})
       @set_blank = !init_args[:blank].nil? && Helper.random_with_blank('X', init_args[:blank]) == ''
       data_file = if !init_args[:ethnic_group_data_file].nil?
                     init_args[:ethnic_group_data_file]

data/lib/healthcare_phony/gender.rb

@@ -8,7 +8,7 @@ module HealthcarePhony
 
     # Public: Initializes a Gender. Pass in hash of different parameters, currently this includes:
     # blank - An integer representing the % of times Address components should be blank.
-    def initialize(**init_args)
+    def initialize(init_args = {})
       @description = %w[Female Male Unknown].sample
 
       @description = if !init_args[:blank].nil?

data/lib/healthcare_phony/hl7_message.rb

@@ -42,7 +42,7 @@ module HealthcarePhony
     # separated String or Ruby Array.
     # message_receiving_facility - Array of Receiving Facilities (MSH.6) to randomly choose from.  Specified as comma separated
     # String or Ruby Array.
-    def initialize(**init_args)
+    def initialize(init_args)
       define_message_type(init_args)
       define_trigger_event(init_args)
       define_control_id(init_args)
@@ -60,7 +60,7 @@ module HealthcarePhony
 
     private
 
-    def define_message_type(**init_args)
+    def define_message_type(init_args = {})
       file_name = "#{::File.expand_path(::File.join("..", "data_files"), __FILE__)}/hl7_message_types.yml"
       file_name = init_args[:message_type_file] unless init_args[:message_type_file].nil?
       hl7_message_types = if !init_args[:message_types].nil?
@@ -71,7 +71,7 @@ module HealthcarePhony
       @message_type = hl7_message_types.nil? ? '' : hl7_message_types.sample
     end
 
-    def define_trigger_event(**init_args)
+    def define_trigger_event(init_args = {})
       @trigger_event = Helper.get_array(init_args[:message_events]).sample
       return unless @trigger_event.nil?
 
@@ -85,22 +85,22 @@ module HealthcarePhony
       end
     end
 
-    def define_adt_trigger_event(**init_args)
+    def define_adt_trigger_event(init_args = {})
       event_types = get_adt_events(init_args)
       event_types&.sample
     end
 
-    def define_oru_trigger_event(**init_args)
+    def define_oru_trigger_event(init_args = {})
       event_types = get_oru_events(init_args)
       event_types&.sample
     end
 
-    def define_mdm_trigger_event(**init_args)
+    def define_mdm_trigger_event(init_args = {})
       event_types = get_mdm_events(init_args)
       event_types&.sample
     end
 
-    def get_adt_events(**init_args)
+    def get_adt_events(init_args = {})
       file_name = "#{::File.expand_path(::File.join("..", "data_files"), __FILE__)}/adt_event_types.yml"
       if init_args[:adt_events].nil?
         Psych.load_file(file_name)
@@ -109,7 +109,7 @@ module HealthcarePhony
       end
     end
 
-    def get_oru_events(**init_args)
+    def get_oru_events(init_args = {})
       file_name = "#{::File.expand_path(::File.join("..", "data_files"), __FILE__)}/oru_event_types.yml"
       if init_args[:oru_events].nil?
         Psych.load_file(file_name)
@@ -118,7 +118,7 @@ module HealthcarePhony
       end
     end
 
-    def get_mdm_events(**init_args)
+    def get_mdm_events(init_args = {})
       file_name = "#{::File.expand_path(::File.join("..", "data_files"), __FILE__)}/mdm_event_types.yml"
       if init_args[:mdm_events].nil?
         Psych.load_file(file_name)
@@ -127,7 +127,7 @@ module HealthcarePhony
       end
     end
 
-    def define_control_id(**init_args)
+    def define_control_id(init_args = {})
       control_id_pattern = if init_args[:message_control_id_pattern].nil?
                              'PHONY\d{10}'
                            else
@@ -136,22 +136,22 @@ module HealthcarePhony
       @message_control_id = Regexp.new(control_id_pattern).random_example
     end
 
-    def define_sending_facility(**init_args)
+    def define_sending_facility(init_args = {})
       sf_choices = Helper.get_array(init_args[:message_sending_facility])
       @sending_facility = !sf_choices.empty? ? sf_choices.sample : ''
     end
 
-    def define_sending_application(**init_args)
+    def define_sending_application(init_args = {})
       sa_choices = Helper.get_array(init_args[:message_sending_application])
       @sending_application = !sa_choices.empty? ? sa_choices.sample : ''
     end
 
-    def define_receiving_application(**init_args)
+    def define_receiving_application(init_args = {})
       ra_choices = Helper.get_array(init_args[:message_receiving_application])
       @receiving_application = !ra_choices.empty? ? ra_choices.sample : ''
     end
 
-    def define_receiving_facility(**init_args)
+    def define_receiving_facility(init_args = {})
       rf_choices = Helper.get_array(init_args[:message_receiving_facility])
       @receiving_facility = !rf_choices.empty? ? rf_choices.sample : ''
     end

data/lib/healthcare_phony/home_phone_number.rb

@@ -9,7 +9,7 @@ module HealthcarePhony
     # blank - An integer representing the % of times phone number components should be blank.
     # use_code - Allows specification of the phone use code (PID.13.2)
     # equipment_type - Allows specification of the phone equipment type (PID.13.3)
-    def initialize(**init_args)
+    def initialize(init_args = {})
       super(init_args)
       @use_code = init_args[:use_code].nil? ? 'PRN' : init_args[:use_code]
       @use_code = '' unless @set_blank == false

data/lib/healthcare_phony/identifier.rb

@@ -12,7 +12,7 @@ module HealthcarePhony
     # type_code - Identifier Type Code, example PID.3.5.  HL7 Data Table 0203
     # pattern - Regex pattern used to randomly generate the identifier.  Default is \d{10} which would generate an
     # identifier like 5992657933.
-    def initialize(**init_args)
+    def initialize(init_args = {})
       @identifier_type_code = init_args[:type_code].nil? ? '' : init_args[:type_code]
 
       identifier_pattern = init_args[:pattern].nil? ? '\d{10}' : init_args[:pattern]

data/lib/healthcare_phony/language.rb

@@ -10,7 +10,7 @@ module HealthcarePhony
     # Public: Initializes an Address. Pass in hash of different parameters, currently this includes:
     # language_data_file - Location of YAML file containing Language data (Code, Description, and Coding System) if a
     # different set of random values is desired.  Otherwise the default file {language.yml}[https://github.com/austinmoody/healthcare_phony/blob/main/lib/healthcare_phony/data_files/language.yml] will be used.
-    def initialize(**init_args)
+    def initialize(init_args = {})
       # TODO: allow a way for caller to pass in a custom set of codes to choose from.
       # TODO: allow a way for caller to pass in % blank
 

data/lib/healthcare_phony/patient.rb

@@ -25,7 +25,7 @@ module HealthcarePhony
                   :death_indicator,
                   :death_datetime
 
-    def initialize(**init_args)
+    def initialize(init_args = {})
       define_gender(init_args)
       define_names(init_args)
       define_addresses(init_args)
@@ -40,7 +40,7 @@ module HealthcarePhony
 
     private
 
-    def define_gender(**init_args)
+    def define_gender(init_args = {})
       @gender = if !init_args[:gender].nil? && init_args[:gender].is_a?(HealthcarePhony::Gender)
                   init_args[:gender]
                 else
@@ -48,7 +48,7 @@ module HealthcarePhony
                 end
     end
 
-    def define_names(**init_args)
+    def define_names(init_args = {})
       init_args[:gender] = @gender
       names_count = init_args[:names_count].nil? || init_args[:names_count] < 1 ? 1 : init_args[:names_count]
       @names = []
@@ -58,7 +58,7 @@ module HealthcarePhony
       end
     end
 
-    def define_addresses(**init_args)
+    def define_addresses(init_args = {})
       address_count = init_args[:address_count].nil? || init_args[:address_count] < 1 ? 1 : init_args[:address_count]
       @addresses = []
       while address_count.positive?
@@ -67,19 +67,19 @@ module HealthcarePhony
       end
     end
 
-    def define_phones(**init_args)
+    def define_phones(init_args = {})
       @home_phone = HomePhoneNumber.new(init_args)
       @cell_phone = CellPhoneNumber.new(init_args)
       @work_phone = WorkPhoneNumber.new(init_args)
     end
 
-    def define_dob(**init_args)
+    def define_dob(init_args = {})
       min_age = init_args[:min_age].nil? ? 1 : init_args[:min_age]
       max_age = init_args[:max_age].nil? ? 99 : init_args[:max_age]
       @date_of_birth = Faker::Date.birthday(min_age: min_age, max_age: max_age)
     end
 
-    def define_race(**init_args)
+    def define_race(init_args = {})
       races_count = init_args[:race_count].nil? || init_args[:race_count] < 1 ? 1 : init_args[:race_count]
       @races = []
       while races_count.positive?

data/lib/healthcare_phony/patient_visit.rb

@@ -23,8 +23,9 @@ module HealthcarePhony
     # or Ruby array. Otherwise this field is left blank.
     # vip_indicator - Array of Patient Type codes (PV1.18) to randomly choose from. Specified as comma separated String
     # or Ruby array. Otherwise this field is left blank.
-    def initialize(**init_args)
-      @doctors = VisitDoctors.new
+    # visit_type - VisitType of the patient's visit
+    def initialize(init_args = {})
+      @doctors = VisitDoctors.new(init_args)
       @location = VisitLocation.new(init_args)
       @admission = VisitAdmission.new(init_args)
       @bed_status = define_bed_status(init_args)
@@ -40,7 +41,7 @@ module HealthcarePhony
 
     private
 
-    def define_hospital_service(**init_args)
+    def define_hospital_service(init_args = {})
       standard_hospital_service = %w[CAR MED PUL SUR URO]
       hs_choices = Helper.get_array(init_args[:hospital_service])
       if !hs_choices.empty?
@@ -50,13 +51,13 @@ module HealthcarePhony
       end
     end
 
-    def define_patient_class(**init_args)
+    def define_patient_class(init_args = {})
       standard_pc_choices = %w[B C E I N O P R U]
       pc_choices = Helper.get_array(init_args[:patient_class])
       !pc_choices.empty? ? pc_choices.sample : standard_pc_choices.sample
     end
 
-    def define_ambulatory_status(**init_args)
+    def define_ambulatory_status(init_args = {})
       standard_ambulatory_status = %w[A0 A1 A2 A3 A4 A5 A6 A7 A8 A9 B1 B2 B3 B4 B5 B6]
       as_choices = Helper.get_array(init_args[:ambulatory_status])
       if !as_choices.empty?
@@ -66,7 +67,7 @@ module HealthcarePhony
       end
     end
 
-    def define_bed_status(**init_args)
+    def define_bed_status(init_args = {})
       bs_choices = Helper.get_array(init_args[:bed_status])
       if !bs_choices.empty?
         bs_choices.sample
@@ -75,7 +76,7 @@ module HealthcarePhony
       end
     end
 
-    def define_patient_type(**init_args)
+    def define_patient_type(init_args = {})
       pt_choices = Helper.get_array(init_args[:patient_type])
       if !pt_choices.empty?
         pt_choices.sample
@@ -84,7 +85,7 @@ module HealthcarePhony
       end
     end
 
-    def define_vip(**init_args)
+    def define_vip(init_args = {})
       vip_choices = Helper.get_array(init_args[:vip_indicator])
       if !vip_choices.empty?
         vip_choices.sample

data/lib/healthcare_phony/person_name.rb

@@ -15,12 +15,12 @@ module HealthcarePhony
     # gender - A Gender object which will be used to generate a Male or Female name if specified.
     # degree_data_file - Location of YAML file containing a list of potential degrees to choose from. By default the
     # gem supplied file will be used.  The default file {degree.yml}[https://github.com/austinmoody/healthcare_phony/blob/main/lib/healthcare_phony/data_files/degree.yml].
-    def initialize(**init_args)
+    def initialize(init_args = {})
       @set_blank = !init_args[:blank].nil? && Helper.random_with_blank('X', init_args[:blank]) == ''
       @gender = init_args[:gender]
       @degree_data_file = get_degree_data_file(init_args)
-      @given_name = define_given_name
-      @family_name = define_family_name
+      @given_name = (init_args[:given_name_append].nil? ? '' : init_args[:given_name_append]) + define_given_name
+      @family_name = (init_args[:family_name_append].nil? ? '' : init_args[:family_name_append]) + define_family_name
       @middle_name = define_middle_name
       @suffix = define_suffix
       @prefix = define_prefix
@@ -33,7 +33,7 @@ module HealthcarePhony
     attr_accessor :set_blank
     attr_accessor :degree_data_file
 
-    def get_degree_data_file(**init_args)
+    def get_degree_data_file(init_args = {})
       if !init_args[:degree_data_file].nil?
         init_args[:degree_data_file]
       else
@@ -85,7 +85,7 @@ module HealthcarePhony
       end
     end
 
-    def define_degree(**init_args)
+    def define_degree(init_args = {})
       if @set_blank
         ''
       elsif !init_args[:degree].nil?

data/lib/healthcare_phony/phone_number.rb

@@ -11,7 +11,7 @@ module HealthcarePhony
                   :use_code,
                   :equipment_type
 
-    def initialize(**init_args)
+    def initialize(init_args = {})
       # Public: Initializes a home phone number. Pass in hash of different parameters, currently this includes:
       # blank - An integer representing the % of times phone number components should be blank.
       # use_code_data_file - YAML file containing use codes to randomly choose from.  If not specified then values from

data/lib/healthcare_phony/race.rb

@@ -6,10 +6,11 @@ module HealthcarePhony
     attr_accessor :code,
                   :description,
                   :coding_system
+
     # Public: Initializes an Address. Pass in hash of different parameters, currently this includes:
     # race_data_file - Location of YAML file containing a list of potential degrees to choose from. By default the
     # gem supplied file will be used.  The default file {race.yml}[https://github.com/austinmoody/healthcare_phony/blob/main/lib/healthcare_phony/data_files/race.yml].
-    def initialize(**init_args)
+    def initialize(init_args = {})
       # TODO: allow a way for caller to pass in % blank
       # TODO: set coding system
 

data/lib/healthcare_phony/religion.rb

@@ -11,7 +11,7 @@ module HealthcarePhony
     # religion_data_file - YAML file containing religion information to randomly choose from if different options than
     # those that come with gem are desired.  See {religion.yml}[https://github.com/austinmoody/healthcare_phony/blob/main/lib/healthcare_phony/data_files/religion.yml]
     # for default values.
-    def initialize(**init_args)
+    def initialize(init_args = {})
       # TODO: allow a way for caller to pass in a custom set of codes to choose from
       # TODO: allow a way for caller to pass in % blank
 

data/lib/healthcare_phony/templates/adt_example.erb

@@ -1,6 +1,6 @@
 MSH|^~\&|<%= hl7.sending_application %>|<%= hl7.sending_facility %>|<%= hl7.receiving_application %>|<%= hl7.receiving_facility %>|<%= hl7.message_datetime.to_hl7datetime() %>||<%= hl7.message_type %>^<%= hl7.trigger_event %>|<%= hl7.message_control_id %>|<%= hl7.processing_id %>|<%= hl7.version %>
 EVN|<%= hl7.trigger_event %>|<%= hl7.message_datetime.to_hl7datetime() %>
-PID|||<%= patient.medical_record_number.identifier %>||<%= patient.names[0].family_name %>^<%= patient.names[0].given_name %>^<%= patient.names[0].middle_name%>^||<%= patient.date_of_birth.to_hl7date %>|<%= patient.gender.code %>||<%= patient.races[0].code %>|<%= patient.addresses[0].address_line1 %>^<%= patient.addresses[0].address_line2 %>^<%= patient.addresses[0].city %>^<%= patient.addresses[0].state %>^<%= patient.addresses[0].postal_code %>||(<%= patient.home_phone.area_code %>)<%= patient.home_phone.exchange_code %>-<%= patient.home_phone.subscriber_number %>~(<%= patient.cell_phone.area_code %>)<%= patient.cell_phone.exchange_code %>-<%= patient.cell_phone.subscriber_number %>|(<%= patient.work_phone.area_code %>)<%= patient.work_phone.exchange_code %>-<%= patient.work_phone.subscriber_number %>||||<%= patient.account_number.identifier %>|<%= patient.ssn %>
-PV1||<%= visit.patient_class %>
-
+PID|||<%= patient.medical_record_number.identifier %>||<%= patient.names[0].family_name %>^<%= patient.names[0].given_name %>^<%= patient.names[0].middle_name%>^||<%= patient.date_of_birth.to_hl7date %>|<%= patient.gender.code %>||<%= patient.races[0].code %>|<%= patient.addresses[0].address_line1 %>^<%= patient.addresses[0].address_line2 %>^<%= patient.addresses[0].city %>^<%= patient.addresses[0].state %>^<%= patient.addresses[0].postal_code %>||(<%= patient.home_phone.area_code %>)<%= patient.home_phone.exchange_code %>-<%= patient.home_phone.subscriber_number %>~(<%= patient.cell_phone.area_code %>)<%= patient.cell_phone.exchange_code %>-<%= patient.cell_phone.subscriber_number %>|(<%= patient.work_phone.area_code %>)<%= patient.work_phone.exchange_code %>-<%= patient.work_phone.subscriber_number %>|<%= patient.language.code %>^<%= patient.language.description %>^<%= patient.language.coding_system %>|<%= patient.marital_status.code %>^<%= patient.marital_status.description %>^<%= patient.marital_status.coding_system %>|<%= patient.religion.code %>^<%= patient.religion.description %>^<%= patient.religion.coding_system %>|<%= patient.account_number.identifier %>|<%= patient.ssn %>
+PV1||<%= visit.patient_class %>|<%= visit.location.point_of_care %>^<%= visit.location.room %>^<%= visit.location.bed %>^<%= visit.location.facility %>^<%= visit.location.status %>^<%= visit.location.type %>^<%= visit.location.building %>^<%= visit.location.floor %>^<%= visit.location.description %>|<%= visit.admission.type %>|||<%= visit.doctors.attending.identifier %>^<%= visit.doctors.attending.name.family_name %>^<%= visit.doctors.attending.name.given_name %>^<%= visit.doctors.attending.name.middle_name %>^<%= visit.doctors.attending.name.suffix %>^<%= visit.doctors.attending.name.prefix %>^<%= visit.doctors.attending.name.degree %>|<%= visit.doctors.referring.identifier %>^<%= visit.doctors.referring.name.family_name %>^<%= visit.doctors.referring.name.given_name %>^<%= visit.doctors.referring.name.middle_name %>^<%= visit.doctors.referring.name.suffix %>^<%= visit.doctors.referring.name.prefix %>^<%= visit.doctors.referring.name.degree %>|<%= visit.doctors.consulting.identifier %>^<%= visit.doctors.consulting.name.family_name %>^<%= visit.doctors.consulting.name.given_name %>^<%= visit.doctors.consulting.name.middle_name %>^<%= visit.doctors.consulting.name.suffix %>^<%= visit.doctors.consulting.name.prefix %>^<%= visit.doctors.consulting.name.degree %>|<%= visit.hospital_service %>|11|12|<%= visit.readmission_indicator %>|<%= visit.admission.source %>|15|16|<%= visit.doctors.admitting.identifier %>^<%= visit.doctors.admitting.name.family_name %>^<%= visit.doctors.admitting.name.given_name %>^<%= visit.doctors.admitting.name.middle_name %>^<%= visit.doctors.admitting.name.suffix %>^<%= visit.doctors.admitting.name.prefix %>^<%= visit.doctors.admitting.name.degree %>|<%= visit.patient_type %>|<%= visit.visit_number.identifier %>^^^^<%= visit.visit_number.identifier_type_code %>|||||||||||||||||<%= visit.discharge.disposition %>|<%= visit.discharge.location %>|38|39|40|41|42|43|<%= visit.admission.datetime.to_hl7datetime() %>|<%= visit.discharge.datetime.to_hl7datetime() %>
+PV2|||^<%= visit.admission.reason %>
 

data/lib/healthcare_phony/visit_admission.rb

@@ -12,7 +12,7 @@ module HealthcarePhony
     # Ruby array. Otherwise default HL7 v2.5.1. Table 0007 values are used.
     # admit_reason - Array of values to use as Admit Reason (PV2.3) to randomly choose from.  Specified as comma
     # separated String or Ruby array.  Otherwise a string of data is generated with Faker::Lorem.sentence
-    def initialize(**init_args)
+    def initialize(init_args = {})
       @source = define_source(init_args)
       @type = define_type(init_args)
       @datetime = Faker::Time.backward(days: Faker::Number.number(digits: 1))
@@ -21,7 +21,7 @@ module HealthcarePhony
 
     private
 
-    def define_source(**init_args)
+    def define_source(init_args = {})
       standard_admit_source = '123456789'.split('')
       as_choices = Helper.get_array(init_args[:admit_source])
       if !as_choices.empty?
@@ -31,7 +31,7 @@ module HealthcarePhony
       end
     end
 
-    def define_type(**init_args)
+    def define_type(init_args = {})
       standard_admission_types = %w[A C E L N R U]
       at_choices = Helper.get_array(init_args[:admission_type])
       if !at_choices.empty?
@@ -41,7 +41,7 @@ module HealthcarePhony
       end
     end
 
-    def define_reason(**init_args)
+    def define_reason(init_args = {})
       ar_choices = Helper.get_array(init_args[:admit_reason])
       if !ar_choices.empty?
         ar_choices.sample

data/lib/healthcare_phony/visit_discharge.rb

@@ -8,14 +8,14 @@ module HealthcarePhony
                   :datetime
 
     # Public: Initializes an EthnicGroup. Pass in hash of different parameters, currently this includes:
-    # event_type - The HL7 trigger event type that this visit is associated with.
+    # visit_type - VisitType of this patient's visit
     # discharge_disposition - Array of discharge disposition codes (PV1.36) to randomly choose from.  Specified as comma
     # separated String or Ruby array. Otherwise default HL7 v2.5.1 Table 0112 values are used.
     # discharge_location - Array of discharge locations to randomly choose from.  Specified as comma separated String or
     # Ruby array. Otherwise a string of data is generated with Faker::Lorem.sentence
     # admit_datetime - The admit date/time associated with this visit.  If not specified the current date/time is used.
-    def initialize(**init_args)
-      if init_args[:event_type] == 'A03'
+    def initialize(init_args = {})
+      if init_args[:visit_type] == HealthcarePhony::VisitType::DISCHARGE # init_args[:event_type] == 'A03'
         @disposition = define_discharge_disposition(init_args)
         @location = define_discharge_location(init_args)
         @datetime = define_discharge_datetime(init_args)
@@ -28,9 +28,9 @@ module HealthcarePhony
 
     private
 
-    def define_discharge_disposition(**init_args)
+    def define_discharge_disposition(init_args = {})
       dd_choices = Helper.get_array(init_args[:discharge_disposition])
-      if init_args[:event_type] != 'A03'
+      if init_args[:visit_type] != HealthcarePhony::VisitType::DISCHARGE # init_args[:event_type] != 'A03'
         ''
       elsif !dd_choices.empty?
         dd_choices.sample
@@ -41,7 +41,7 @@ module HealthcarePhony
       end
     end
 
-    def define_discharge_location(**init_args)
+    def define_discharge_location(init_args = {})
       dl_choices = Helper.get_array(init_args[:discharge_location])
       if !dl_choices.empty?
         dl_choices.sample
@@ -50,7 +50,7 @@ module HealthcarePhony
       end
     end
 
-    def define_discharge_datetime(**init_args)
+    def define_discharge_datetime(init_args = {})
       from_datetime = if init_args[:admit_datetime].nil?
                         Time.now
                       else

data/lib/healthcare_phony/visit_doctors.rb

@@ -9,11 +9,11 @@ module HealthcarePhony
                   :consulting,
                   :admitting
 
-    def initialize
-      @attending = Doctor.new
-      @referring = Doctor.new
-      @consulting = Doctor.new
-      @admitting = Doctor.new
+    def initialize(init_args = {})
+      @attending = Doctor.new(init_args)
+      @referring = Doctor.new(init_args)
+      @consulting = Doctor.new(init_args)
+      @admitting = Doctor.new(init_args)
     end
   end
 end

data/lib/healthcare_phony/visit_location.rb

@@ -32,7 +32,7 @@ module HealthcarePhony
     # String or Ruby array. Otherwise a random 2 digit number is used.
     # location_description - Array of potential location descriptions (PV1.3.9) to randomly choose from.  Specified as
     # a comma separated String or Ruby array. Otherwise a random string is generated.
-    def initialize(**init_args)
+    def initialize(init_args = {})
       @point_of_care = define_point_of_care(init_args)
       @room = define_room(init_args)
       @bed = define_bed(init_args)
@@ -46,12 +46,12 @@ module HealthcarePhony
 
     private
 
-    def define_point_of_care(**init_args)
+    def define_point_of_care(init_args = {})
       poc_choices = Helper.get_array(init_args[:point_of_care])
       !poc_choices.empty? ? poc_choices.sample : /[A-Z]{10}/.random_example
     end
 
-    def define_room(**init_args)
+    def define_room(init_args = {})
       room_choices = Helper.get_array(init_args[:room])
       if !room_choices.empty?
         room_choices.sample
@@ -60,7 +60,7 @@ module HealthcarePhony
       end
     end
 
-    def define_bed(**init_args)
+    def define_bed(init_args = {})
       bed_choices = Helper.get_array(init_args[:bed])
       if !bed_choices.empty?
         bed_choices.sample
@@ -69,32 +69,32 @@ module HealthcarePhony
       end
     end
 
-    def define_facility(**init_args)
+    def define_facility(init_args = {})
       fac_choices = Helper.get_array(init_args[:facility])
       !fac_choices.empty? ? fac_choices.sample : Faker::Lorem.sentence
     end
 
-    def define_status(**init_args)
+    def define_status(init_args = {})
       ls_choices = Helper.get_array(init_args[:location_status])
       !ls_choices.empty? ? ls_choices.sample : /[A-Z]/.random_example
     end
 
-    def define_type(**init_args)
+    def define_type(init_args = {})
       plt_choices = Helper.get_array(init_args[:person_location_type])
       !plt_choices.empty? ? plt_choices.sample : %w[C D H N O P S].sample
     end
 
-    def define_building(**init_args)
+    def define_building(init_args = {})
       building_choices = Helper.get_array(init_args[:building])
       !building_choices.empty? ? building_choices.sample : /[1-9]/.random_example
     end
 
-    def define_floor(**init_args)
+    def define_floor(init_args = {})
       floor_choices = Helper.get_array(init_args[:floor])
       !floor_choices.empty? ? floor_choices.sample : /[0-9]{2}/.random_example
     end
 
-    def define_description(**init_args)
+    def define_description(init_args = {})
       ld_choices = Helper.get_array(init_args[:location_description])
       if !ld_choices.empty?
         ld_choices.sample

data/lib/healthcare_phony/visit_type.rb

@@ -0,0 +1,9 @@
+module HealthcarePhony
+  module VisitType
+    ADMIT = 1
+    REGISTRATION = 2
+    DISCHARGE = 3
+    TRANSFER = 4
+    OTHER = 5
+  end
+end

data/lib/healthcare_phony/work_phone_number.rb

@@ -9,7 +9,7 @@ module HealthcarePhony
     # blank - An integer representing the % of times phone number components should be blank.
     # use_code - Allows specification of the phone use code (PID.13.2)
     # equipment_type - Allows specification of the phone equipment type (PID.13.3)
-    def initialize(**init_args)
+    def initialize(init_args = {})
       super(init_args)
       @use_code = init_args[:use_code].nil? ? 'WPN' : init_args[:use_code]
       @use_code = '' unless @set_blank == false

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: healthcare_phony
 version: !ruby/object:Gem::Version
-  version: 0.4.1
+  version: 0.7.0
 platform: ruby
 authors:
 - Austin Moody
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2021-01-22 00:00:00.000000000 Z
+date: 2021-07-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -113,6 +113,10 @@ files:
 - README.md
 - Rakefile
 - VERSION
+- examples/bigger_csv_example.erb
+- examples/phony_adt_sender.rb
+- examples/phony_adt_sender.yml
+- examples/phony_csv.yml
 - healthcare_phony.gemspec
 - lib/healthcare_phony.rb
 - lib/healthcare_phony/address.rb
@@ -158,6 +162,7 @@ files:
 - lib/healthcare_phony/visit_discharge.rb
 - lib/healthcare_phony/visit_doctors.rb
 - lib/healthcare_phony/visit_location.rb
+- lib/healthcare_phony/visit_type.rb
 - lib/healthcare_phony/work_phone_number.rb
 homepage: http://github.com/austinmoody/healthcare_phony
 licenses:
@@ -178,7 +183,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: 2.6.10
 requirements: []
-rubygems_version: 3.0.3
+rubygems_version: 3.0.3.1
 signing_key: 
 specification_version: 4
 summary: A utility to create fake data and files for healthcare integration testing