malawi_hiv_program_reports 1.0.1 → 1.0.2

data/app/services/malawi_hiv_program_reports/utils/model_utils.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+# This module contains utility methods for retrieving models
+module MalawiHivProgramReports
+  module Utils
+    module ModelUtils
+      # Retrieve concept by its name
+      #
+      # Parameters:
+      #  name - A string repr of the concept name
+      def concept(name)
+        ::Concept.joins(:concept_names).where('LOWER(concept_name.name) = ?', name.downcase).first
+      end
+
+      def concept_name(name)
+        ::ConceptName.where('LOWER(name) = ?', name.downcase).first
+      end
+
+      def concept_name_to_id(name)
+        return nil if name.blank?
+
+        concept_name(name)&.concept_id
+      end
+
+      def concept_id_to_name(id)
+        return nil if id.blank?
+
+        concept = ::Concept.find_by_concept_id(id)
+        concept&.fullname
+      end
+
+      def program(name)
+        ::Program.where('LOWER(name) = ?', name.downcase).first
+      end
+
+      def encounter_type(name)
+        ::EncounterType.where('LOWER(name) = ?', name.downcase).first
+      end
+
+      def global_property(name)
+        ::GlobalProperty.where('LOWER(property) = ?', name.downcase).first
+      end
+
+      def user_property(name, user_id: nil)
+        user_id ||= ::User.current.user_id
+        ::UserProperty.where('user_id = ? AND LOWER(property) = ?', user_id, name).first
+      end
+
+      def order_type(name)
+        ::OrderType.where('LOWER(name) = ?', name.downcase).first
+      end
+
+      def report_type(name)
+        ::ReportType.where('LOWER(name) = ?', name.downcase).first
+      end
+
+      def patient_identifier_type(name)
+        ::PatientIdentifierType.where('LOWER(name) = ?', name.downcase).first
+      end
+
+      def drug(name)
+        ::Drug.where('LOWER(name) = ?', name.downcase).first
+      end
+    end
+  end
+end

data/app/services/malawi_hiv_program_reports/utils/parameter_utils.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require 'logger'
+
+# Utility methods for dealing with ActiveSupport::Parameters objects.
+module MalawiHivProgramReports
+  module Utils
+    module ParameterUtils
+      LOGGER = Logger.new($stdout)
+
+      # Fetches field from ActiveSupport::Parameters.
+      #
+      # This method is just a wrapper around the fetch or raise bad request
+      # routine for retrieving parameter values.
+      #
+      # @throws InvalidParameterError - When field is not found in stock_obs
+      def fetch_parameter(parameters, field)
+        parameters.fetch(field)
+      rescue KeyError => e
+        LOGGER.error("Failed to fetch parameter `#{field}` due to #{e}")
+        raise ::InvalidParameterError, "`#{field}` not found in parameters: #{parameters.to_json}"
+      end
+
+      def fetch_parameter_as_date(parameters, field, default = nil)
+        parameters.fetch(field, default)&.to_date
+      rescue ArgumentError => e
+        LOGGER.error("Failed to fetch parameter `#{field}` due to #{e}")
+        raise ::InvalidParameterError, "Could not parse #{field} as date from: #{parameters.to_json}"
+      end
+    end
+  end
+end

data/app/services/malawi_hiv_program_reports/utils/time_utils.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module MalawiHivProgramReports
+  module Utils
+    module TimeUtils
+      class << self
+        def time_epoch
+          Time.now - 120.years
+        end
+
+        def date_epoch
+          Date.today - 120.years
+        end
+
+        # Returns a 24 hour period (day) containing the date
+        def day_bounds(datetime)
+          datetime = datetime&.to_time || datetime
+          [datetime.strftime('%Y-%m-%d 00:00:00').to_time,
+           datetime.strftime('%Y-%m-%d 23:59:59').to_time]
+        end
+
+        ##
+        # Parses and validates start_date and end_date provided by users
+        #
+        # Returns: A pair of Date objects containing the start_date and end_date
+        def parse_date_range(start_date, end_date)
+          raise ::InvalidParameterError, 'start_date is required' if start_date.blank?
+          raise ::InvalidParameterError, 'end_date is required' if end_date.blank?
+
+          start_date = start_date.to_date
+          end_date = end_date.to_date
+
+          raise ::InvalidParameterError, "start_date can't be greater than end_date" if start_date > end_date
+
+          [start_date, end_date]
+        end
+
+        # Returns a time object comprising the given date plus the current time.
+        def retro_timestamp(date)
+          return nil unless date
+
+          date = date.to_time
+          "#{date.strftime('%Y-%m-%d')} #{Time.now.strftime('%H:%M:%S')}".to_time
+        end
+
+        def get_person_age(birthdate:)
+          ((Time.zone.now - birthdate.to_time) / 1.year.seconds).floor
+        end
+      end
+    end
+  end
+end

data/lib/malawi_hiv_program_reports/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module MalawiHivProgramReports
-  VERSION = '1.0.1'
+  VERSION = '1.0.2'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: malawi_hiv_program_reports
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.0.2
 platform: ruby
 authors:
 - Roy Chanunkha
@@ -90,6 +90,79 @@ files:
 - MIT-LICENSE
 - README.md
 - Rakefile
+- app/services/malawi_hiv_program_reports/README.md
+- app/services/malawi_hiv_program_reports/adapters/moh/custom.rb
+- app/services/malawi_hiv_program_reports/archiving_candidates.rb
+- app/services/malawi_hiv_program_reports/arv_refill_periods.rb
+- app/services/malawi_hiv_program_reports/clinic/README.md
+- app/services/malawi_hiv_program_reports/clinic/appointments_report.rb
+- app/services/malawi_hiv_program_reports/clinic/discrepancy_report.rb
+- app/services/malawi_hiv_program_reports/clinic/docs/hypertension_report.md
+- app/services/malawi_hiv_program_reports/clinic/drug_dispensations.rb
+- app/services/malawi_hiv_program_reports/clinic/external_consultation_clients.rb
+- app/services/malawi_hiv_program_reports/clinic/hypertension_report.rb
+- app/services/malawi_hiv_program_reports/clinic/ipt_coverage.rb
+- app/services/malawi_hiv_program_reports/clinic/ipt_report.rb
+- app/services/malawi_hiv_program_reports/clinic/lims_results.rb
+- app/services/malawi_hiv_program_reports/clinic/outcome_list.rb
+- app/services/malawi_hiv_program_reports/clinic/patients_alive_and_on_treatment.rb
+- app/services/malawi_hiv_program_reports/clinic/patients_due_for_viral_load.rb
+- app/services/malawi_hiv_program_reports/clinic/patients_on_antiretrovirals.rb
+- app/services/malawi_hiv_program_reports/clinic/patients_on_dtg.rb
+- app/services/malawi_hiv_program_reports/clinic/patients_on_treatment.rb
+- app/services/malawi_hiv_program_reports/clinic/patients_with_outdated_demographics.rb
+- app/services/malawi_hiv_program_reports/clinic/pregnant_patients.rb
+- app/services/malawi_hiv_program_reports/clinic/regimen_dispensation_data.rb
+- app/services/malawi_hiv_program_reports/clinic/regimen_switch.rb
+- app/services/malawi_hiv_program_reports/clinic/regimens_and_formulations.rb
+- app/services/malawi_hiv_program_reports/clinic/regimens_by_weight_and_gender.rb
+- app/services/malawi_hiv_program_reports/clinic/retention.rb
+- app/services/malawi_hiv_program_reports/clinic/stock_card_report.rb
+- app/services/malawi_hiv_program_reports/clinic/tpt_outcome.rb
+- app/services/malawi_hiv_program_reports/clinic/tx_rtt.rb
+- app/services/malawi_hiv_program_reports/clinic/viral_load.rb
+- app/services/malawi_hiv_program_reports/clinic/viral_load_disaggregated.rb
+- app/services/malawi_hiv_program_reports/clinic/viral_load_results.rb
+- app/services/malawi_hiv_program_reports/clinic/visits_report.rb
+- app/services/malawi_hiv_program_reports/clinic/vl_collection.rb
+- app/services/malawi_hiv_program_reports/cohort/outcomes.rb
+- app/services/malawi_hiv_program_reports/cohort/regimens.rb
+- app/services/malawi_hiv_program_reports/cohort/side_effects.rb
+- app/services/malawi_hiv_program_reports/cohort/tpt.rb
+- app/services/malawi_hiv_program_reports/moh/cohort.rb
+- app/services/malawi_hiv_program_reports/moh/cohort_builder.rb
+- app/services/malawi_hiv_program_reports/moh/cohort_disaggregated.rb
+- app/services/malawi_hiv_program_reports/moh/cohort_disaggregated_additions.rb
+- app/services/malawi_hiv_program_reports/moh/cohort_disaggregated_builder.rb
+- app/services/malawi_hiv_program_reports/moh/cohort_struct.rb
+- app/services/malawi_hiv_program_reports/moh/cohort_survival_analysis.rb
+- app/services/malawi_hiv_program_reports/moh/moh_tpt.rb
+- app/services/malawi_hiv_program_reports/moh/tpt_newly_initiated.rb
+- app/services/malawi_hiv_program_reports/pepfar/defaulter_list.rb
+- app/services/malawi_hiv_program_reports/pepfar/maternal_status.rb
+- app/services/malawi_hiv_program_reports/pepfar/patient_start_vl.rb
+- app/services/malawi_hiv_program_reports/pepfar/regimen_switch.rb
+- app/services/malawi_hiv_program_reports/pepfar/sc_arvdisp.rb
+- app/services/malawi_hiv_program_reports/pepfar/sc_curr.rb
+- app/services/malawi_hiv_program_reports/pepfar/tb_prev.rb
+- app/services/malawi_hiv_program_reports/pepfar/tb_prev2.rb
+- app/services/malawi_hiv_program_reports/pepfar/tb_prev3.rb
+- app/services/malawi_hiv_program_reports/pepfar/tpt_status.rb
+- app/services/malawi_hiv_program_reports/pepfar/tx_ml.rb
+- app/services/malawi_hiv_program_reports/pepfar/tx_new.rb
+- app/services/malawi_hiv_program_reports/pepfar/tx_rtt.rb
+- app/services/malawi_hiv_program_reports/pepfar/tx_tb.rb
+- app/services/malawi_hiv_program_reports/pepfar/utils.rb
+- app/services/malawi_hiv_program_reports/pepfar/viral_load_coverage.rb
+- app/services/malawi_hiv_program_reports/pepfar/viral_load_coverage2.rb
+- app/services/malawi_hiv_program_reports/report_map.rb
+- app/services/malawi_hiv_program_reports/utils/README.md
+- app/services/malawi_hiv_program_reports/utils/common_sql_query_utils.rb
+- app/services/malawi_hiv_program_reports/utils/concurrency_utils.rb
+- app/services/malawi_hiv_program_reports/utils/docs/common_sql_query_utils.md
+- app/services/malawi_hiv_program_reports/utils/model_utils.rb
+- app/services/malawi_hiv_program_reports/utils/parameter_utils.rb
+- app/services/malawi_hiv_program_reports/utils/time_utils.rb
 - lib/malawi_hiv_program_reports.rb
 - lib/malawi_hiv_program_reports/engine.rb
 - lib/malawi_hiv_program_reports/version.rb