healthcare_phony 0.3.0

data/Rakefile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rake/testtask'
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'test'
+  t.libs << 'lib'
+  t.test_files = FileList['test/**/*_test.rb']
+end
+
+task default: :test

data/VERSION

@@ -0,0 +1 @@
+0.3.0

data/healthcare_phony.gemspec

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+lib = File.expand_path('lib', __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'healthcare_phony/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'healthcare_phony'
+  spec.version       = HealthcarePhony::VERSION
+  spec.authors       = ['Austin Moody']
+  spec.email         = ['austin.moody@hey.com']
+
+  spec.summary       = 'A utility to create fake data and files for healthcare integration testing'
+  spec.homepage      = 'http://github.com/austinmoody/healthcare_phony'
+  spec.license       = 'MIT'
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bundler', '~> 2.2'
+  spec.add_development_dependency 'minitest', '~> 5.0'
+  spec.add_development_dependency 'rake', '~> 12.3.3'
+
+  spec.required_ruby_version     = '>= 2.6'
+  spec.required_rubygems_version = '>= 2.6.10'
+
+  spec.add_dependency 'faker', '~> 2.13.0'
+  spec.add_dependency 'psych', '~> 3.1.0'
+  spec.add_dependency 'regexp-examples', '~> 1.5.1'
+end

data/lib/healthcare_phony.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+require 'erb'
+require 'faker'
+require 'psych'
+require 'regexp-examples'
+
+Dir[File.join(__dir__, 'healthcare_phony', '*.rb')].sort.each { |file| require file }
+
+Faker::Config.locale = 'en-US'
+
+module HealthcarePhony
+  class Adt
+    attr_reader :template_file
+
+    def initialize(template_file = nil)
+      @template_file = if template_file.nil?
+                         File.join(File.dirname(__FILE__), 'healthcare_phony', 'templates', 'adt_example.erb')
+                       else
+                         template_file
+                       end
+    end
+
+    def to_s
+      template = ERB.new(File.read(@template_file))
+      message = Hl7Message.new
+      patient = Patient.new
+      visit = PatientVisit.new
+      template.result_with_hash({ patient: patient, hl7: message, visit: visit })
+    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
+    end
+
+    def to_s
+      template = ERB.new(File.read(@template_file), trim_mode: '<>')
+      counter = 0
+      output_string = ''
+      while counter < @number_of_rows
+        output_string += template.result_with_hash({ patient: Patient.new, write_header: counter == 0 }) + "\n"
+        counter += 1
+      end
+      output_string
+    end
+  end
+end
+
+class String
+  def to_hl7date
+    self
+  end
+
+  def to_hl7datetime
+    self
+  end
+end
+
+class Date
+  def to_hl7date
+    strftime('%Y%m%d')
+  end
+end
+
+class Time
+  def to_hl7datetime
+    strftime('%Y%m%d%H%M%S')
+  end
+end
+
+class NilClass
+  def to_hl7datetime
+    ''
+  end
+
+  def to_hl7date
+    ''
+  end
+end

data/lib/healthcare_phony/address.rb

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+
+module HealthcarePhony
+  # Public: Generates a fake Address
+  class Address
+    attr_accessor :address_line1, :address_line2, :city, :state, :postal_code, :country, :address_type
+
+    # Public: Initializes an Address. Pass in hash of different parameters, currently this includes:
+    # blank - An integer representing the % of times Address components should be blank.
+    # state - Allows specification of the Address state instead of randomly being chosen.
+    # country - Allows specification of the Address country.  Is blank by default.
+    # address_type - Allows specification of the Address type.
+    # 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)
+      @set_blank = !init_args[:blank].nil? && Helper.random_with_blank('X', init_args[:blank]) == ''
+      @state = init_args[:state]
+      @country = init_args[:country]
+      @address_type_data_file = init_args[:address_type_data_file]
+      @address_type = init_args[:address_type]
+      define_address_line1
+      define_address_line2
+      define_city
+      define_state
+      define_postal_code
+      define_country
+      define_address_type
+    end
+
+    private
+
+    # Private: Boolean set during initialization if Address components should be set to blank.
+    attr_accessor :set_blank
+    # Private: File containing address types to randomly choose from.
+    attr_accessor :address_type_data_file
+
+    # Private: Randomly generates the street address (address_line1)
+    def define_address_line1
+      @address_line1 = Faker::Address.street_address
+      @address_line1 = '' unless @set_blank == false
+    end
+
+    # Private: Randomly generates a second part of the street address (address_line2)
+    def define_address_line2
+      @address_line2 = Faker::Address.secondary_address
+      @address_line2 = '' unless @set_blank == false
+    end
+
+    # Private: Randomly generates the city.
+    def define_city
+      @city = Faker::Address.city
+      @city = '' unless @set_blank == false
+    end
+
+    # Private: Randomly generates the state unless state was specified during initialization.
+    def define_state
+      @state = Faker::Address.state_abbr if @state.nil?
+      @state = '' unless @set_blank == false
+    end
+
+    # Private: Randomly generates the postal/zip code.
+    def define_postal_code
+      @postal_code = Faker::Address.zip_code(state_abbreviation: @state)
+      @postal_code = '' unless @set_blank == false
+    end
+
+    def define_country
+      @country = '' if @country.nil?
+      @country = '' unless @set_blank == false
+    end
+
+    # Private: Sets the address type, either by the address type specified during initialization, by randomly choosing
+    # a value from the address_type.yml file, or by a random value from a file specified by address_type_data_file
+    # during initialization.
+    def define_address_type
+      if @address_type.nil?
+        data_file = if !@address_type_data_file.nil?
+                      @address_type_data_file
+                    else
+                      "#{::File.expand_path(::File.join("..", "data_files"), __FILE__)}/address_type.yml"
+                    end
+        address_types = Psych.load_file(data_file)
+        @address_type = address_types.sample unless address_types.nil?
+      end
+      @address_type = '' unless @set_blank == false
+    end
+  end
+end

data/lib/healthcare_phony/assigning_authority.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module HealthcarePhony
+  class AssigningAuthority
+  end
+end

data/lib/healthcare_phony/cell_phone_number.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+require File.expand_path('phone_number', __dir__)
+
+module HealthcarePhony
+  # Public: Generates a fake cell phone number
+  class CellPhoneNumber < PhoneNumber
+    # Public: Initializes a cell 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 - 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)
+      super(init_args)
+      @use_code = init_args[:use_code].nil? ? 'ORN' : init_args[:use_code]
+      @use_code = '' unless @set_blank == false
+      @equipment_type = init_args[:equipment_type].nil? ? 'CP' : init_args[:equipment_type]
+      @equipment_type = '' unless @set_blank == false
+    end
+  end
+end

data/lib/healthcare_phony/data_files/address_type.yml

@@ -0,0 +1,7 @@
+---
+- H
+- L
+- M
+- P
+- O
+- C

data/lib/healthcare_phony/data_files/adt_event_types.yml

@@ -0,0 +1,59 @@
+---
+- A01
+- A02
+- A03
+- A04
+- A05
+- A06
+- A07
+- A08
+- A09
+- A10
+- A11
+- A12
+- A13
+- A14
+- A15
+- A16
+- A17
+- A18
+- A19
+- A20
+- A21
+- A22
+- A23
+- A24
+- A25
+- A26
+- A27
+- A28
+- A29
+- A30
+- A31
+- A32
+- A33
+- A34
+- A35
+- A36
+- A37
+- A38
+- A39
+- A40
+- A41
+- A42
+- A43
+- A44
+- A45
+- A46
+- A47
+- A48
+- A49
+- A50
+- A51
+- A52
+- A53
+- A54
+- A55
+- A60
+- A61
+- A62

data/lib/healthcare_phony/data_files/degree.yml

@@ -0,0 +1,9 @@
+---
+- MD
+- CANP
+- CMA
+- CNM
+- CNP
+- CNS
+- CPNP
+- CRN

data/lib/healthcare_phony/data_files/discharge_disposition.yml

@@ -0,0 +1,15 @@
+---
+- '01'
+- '02'
+- '03'
+- '04'
+- '05'
+- '06'
+- '07'
+- '08'
+- '09'
+- '20'
+- '30'
+- '40'
+- '41'
+- '42'

data/lib/healthcare_phony/data_files/ethnic_group.yml

@@ -0,0 +1,10 @@
+---
+- :code: H
+  :description: 'Hispanic or Latino'
+  :coding_system: HL70189
+- :code: N
+  :description: 'Not Hispanic or Latino'
+  :coding_system: HL70189
+- :code: U
+  :description: Unknown
+  :coding_system: HL70189

data/lib/healthcare_phony/data_files/hl7_message_types.yml

@@ -0,0 +1,4 @@
+---
+- ADT
+- ORU
+- MDM

data/lib/healthcare_phony/data_files/language.yml

@@ -0,0 +1,7 @@
+---
+- :code: eng
+  :description: english
+  :coding_system: HL70296
+- :code: spa
+  :description: spanish
+  :coding_system: HL70296

data/lib/healthcare_phony/data_files/marital_status.yml

@@ -0,0 +1,49 @@
+---
+- :code: A
+  :description: Separated
+  :coding_system: HL70002
+- :code: B
+  :description: Unmarried
+  :coding_system: HL70002
+- :code: C
+  :description: Common Law
+  :coding_system: HL70002
+- :code: D
+  :description: Divorced
+  :coding_system: HL70002
+- :code: E
+  :description: Legally Separated
+  :coding_system: HL70002
+- :code: G
+  :description: Living Together
+  :coding_system: HL70002
+- :code: I
+  :description: Interlocutory
+  :coding_system: HL70002
+- :code: M
+  :description: Married
+  :coding_system: HL70002
+- :code: N
+  :description: Annulled
+  :coding_system: HL70002
+- :code: O
+  :description: Other
+  :coding_system: HL70002
+- :code: P
+  :description: Domestic Partner
+  :coding_system: HL70002
+- :code: R
+  :description: Registered Domestic Partner
+  :coding_system: HL70002
+- :code: S
+  :description: Single
+  :coding_system: HL70002
+- :code: T
+  :description: Unreported
+  :coding_system: HL70002
+- :code: U
+  :description: Unknown
+  :coding_system: HL70002
+- :code: W
+  :description: Widowed
+  :coding_system: HL70002

data/lib/healthcare_phony/data_files/mdm_event_types.yml

@@ -0,0 +1,12 @@
+---
+- T01
+- T02
+- T03
+- T04
+- T05
+- T06
+- T07
+- T08
+- T09
+- T10
+- T11