healthcare_phony 0.5.0 → 0.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9bdfa5957ba72b641eea38c4c61d96c6cea69b33889f010e8b0fa58e61e48683
-  data.tar.gz: bbbc2532c8092dc625d2be9a20cb108dbba97701eb5f510b218932421ec3bcd5
+  metadata.gz: 6ae7efeeef2b6a025dd43df5aaca7d92d2e042e4ede0b7e126b62629ac09adc2
+  data.tar.gz: c06db583438d4fa05a02c107b77317396c7f26ebef78414c9bf6a11d0bc5daf7
 SHA512:
-  metadata.gz: 2b86d2d6978257091dd388b8c1e9f64fa40079484cdb66efd7400f50bb239cb99f6c270fe48185d9a8269e44dc96e73ce150dfcc2c56175322c8d6f2e17526a9
-  data.tar.gz: 7283bf0ce04e1b7fa23fa32feb8d0a6bd10a4cdf232446b66def8b32d6294a8d4dab8a50fee713dd37623c41e63571a67922f4863d06d945fe2feb00769884c6
+  metadata.gz: 538d1d41816b27f99a8e0e41b1d11612fe2fba9532f4de0dbdee1279388089462dd96eb8b2953adc5d9309c31a11aa09f23373c45c6db27a795eca12fbf72012
+  data.tar.gz: 80e8a6a025ba3a33498f84a48b3d14908977c0c83934868ddfd8d1cabbff366e009014049797b53209ccabe130cc591e831669818ed21daed2e8e625e26879ad

data/README.md

@@ -309,6 +309,34 @@ 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 is only one script 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
+```
+
 ## 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.5.0
+0.5.1

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,10 @@
+---
+:message_sending_facility: CLINIC1,CLINIC2,CLINIC3
+:message_sending_application: RUBY
+:message_receiving_application: MIRTH
+:message_receiving_facility: HOSPITAL_ONE
+:message_version: '2.3'
+:patient_class: A,B,C,X
+:adt_events: A99,A88
+:message_control_id_pattern: HL7_\d{15}
+:message_processing_id: X

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: healthcare_phony
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.5.1
 platform: ruby
 authors:
 - Austin Moody
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2021-01-23 00:00:00.000000000 Z
+date: 2021-01-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -113,6 +113,8 @@ files:
 - README.md
 - Rakefile
 - VERSION
+- examples/phony_adt_sender.rb
+- examples/phony_adt_sender.yml
 - healthcare_phony.gemspec
 - lib/healthcare_phony.rb
 - lib/healthcare_phony/address.rb