pueri 0.7.0 → 0.11.2

data/docs/top-level-namespace.html

@@ -100,7 +100,7 @@
 </div>
 
       <div id="footer">
-  Generated on Sat Oct 19 21:50:31 2019 by
+  Generated on Mon Oct 28 17:34:32 2019 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.20 (ruby-2.5.5).
 </div>

data/lib/pueri.rb

@@ -1,6 +1,8 @@
 # frozen_string_literal: true
 
 require 'pueri/age'
+require 'pueri/dosecalc'
+require 'pueri/dosecheck'
 require 'pueri/neuro'
 require 'pueri/vax'
 require 'pueri/version'

data/lib/pueri/dosecalc.rb

@@ -0,0 +1,114 @@
+# frozen_string_literal: true
+
+module Pueri
+  # Calculates the prescription of a given medication given the weight of the
+  # pacient, the dose-per-weight-day, the concentration of the medication's
+  # presentation and the periodicity of takes in hours.
+  class DoseCalc
+    attr_reader :weight, :dose, :time, :days, :concentration, :result, :name
+    attr_accessor :dose_unit, :conc_unit
+
+    # Calculate the dosage for each taking of a given medicine.
+    #
+    # @param params [Hash] A Hash of elements, all of which are required to
+    #   properly calculate and output the final dosage-per-taking:
+    #   [+:weight+]         The weight of the pacient, in _kilograms_.
+    #   [+:dose+]           The dose for the pacient, in _unit/kg/day_.
+    #   [+:time+]           The time between takings, in hours.
+    #   [+:days+]           The number of days to take the medication.
+    #   [+:concentration+]  The posologic concentration, number only.
+    #   [+:dose_unit+]      The unit of dosage for the pacient (_e.g._ mg/kg/d).
+    #   [+:conc_unit+]      The unit of concentration (_e.g._ mg/mL, mcg/pill).
+    #   [+:name+]           The name of the medication.
+    def initialize(params)
+      init_vars(params)
+      @result = ((@weight * @dose * @time) / (24.0 * @concentration)).round(3)
+    end
+
+    # Outputs the calculated dosage into a prescription string.
+    #
+    # @return [String] The prescription string.
+    def to_s
+      [
+        "- #{@name} #{@concentration.to_i}#{@conc_unit.join '/'}",
+        "Tomar #{@result}#{@conc_unit[1]} #{time_to_s} #{days_to_s}."
+      ].join "\n"
+    end
+
+    # Outputs the calculated dosage for each taking. _E.g._ +3.7+, as in _use
+    # 3.7 units of medication each time_.
+    #
+    # @return [Float] The dosage to be used each time one takes the medication.
+    def to_f
+      @result
+    end
+
+    private
+
+    def time_to_s
+      if @time == 24.0
+        'uma vez por dia'
+      else
+        time = @time.to_i.to_s.rjust(2, '0')
+        hour = 'hora'
+        hour += 's' if @time > 1.0
+        "de #{time}/#{time} #{hour}"
+      end
+    end
+
+    def days_to_s
+      if @days == 1.0
+        str = 'por um dia'
+        str = 'em dose única' if @time == 24.0
+        str
+      else
+        days = @days.to_i.to_s.rjust(2, '0')
+        str = 'dia'
+        str += 's' if @days > 1.0
+        "por #{days} #{str}"
+      end
+    end
+
+    def init_vars(params)
+      check_vars(params)
+      init_calc_vars(params)
+      init_str_vars(params)
+    end
+
+    def check_vars(params)
+      params.each do |key, value|
+        if value.is_a? String
+          check_str_var(key, value)
+        elsif value.zero?
+          raise ArgumentError, "#{key} must not be zero"
+        end
+      end
+    end
+
+    def check_str_var(key, value)
+      raise ArgumentError, "#{key} must not be zero" if value.empty?
+
+      if key == :dose_unit
+        msg = "#{key} must follow unit/kg/d format"
+        raise ArgumentError, msg unless value.match? %r{^[A-Za-z]+\/kg\/d$}
+      elsif key == :conc_unit
+        msg = "#{key} must follow unit/presentation format"
+        raise ArgumentError, msg unless value.match? %r{^[A-Za-z]+\/[A-Za-z]+$}
+      end
+    end
+
+    def init_calc_vars(params)
+      @weight        = params[:weight].to_f
+      @dose          = params[:dose].to_f
+      @time          = params[:time].to_f
+      @days          = params[:days].to_i
+      @concentration = params[:concentration].to_f
+    end
+
+    def init_str_vars(params)
+      @dose_unit = params[:dose_unit].split '/'
+      @conc_unit = params[:conc_unit].split '/'
+      @name      = params[:name].strip
+    end
+  end
+end

data/lib/pueri/dosecheck.rb

@@ -0,0 +1,95 @@
+# frozen_string_literal: true
+
+module Pueri
+  # Checks the prescription of a given medication given the weight of the
+  # pacient, the dose-per-take, the concentration of the medication's
+  # presentation and the periodicity of takes in hours.
+  class DoseCheck
+    attr_reader :weight, :dose, :time, :concentration, :result, :name
+    attr_accessor :dose_unit, :conc_unit, :way
+
+    # Calculate the dosage-per-weight-day for the prescribed medicine.
+    #
+    # @param params [Hash] A Hash of elements, all of which are required to
+    #   properly calculate and output the final dosage-per-weight-day:
+    #   [+:weight+]         The weight of the pacient, in _kilograms_.
+    #   [+:dose+]           The dose for the pacient, in any given _unit_.
+    #   [+:time+]           The time between takings, in hours.
+    #   [+:concentration+]  The posologic concentration, number only.
+    #   [+:dose_unit+]      The unit of medication for each taking (_e.g._ mL).
+    #   [+:conc_unit+]      The unit of concentration (_e.g._ mg/mL, mcg/pill).
+    #   [+:way+]            The way of admnistration (_e.g._ IV, SC).
+    #   [+:name+]           The name of the medication.
+    def initialize(params)
+      init_vars(params)
+      @result = ((@dose * @concentration * 24.0) / (@time * @weight)).round(3)
+    end
+
+    # Outputs the calculated dosage as a string.
+    #
+    # @return [String] The dosage-per-weight-day string.
+    def to_s
+      [
+        "#{@name} #{@concentration.to_i}#{@conc_unit.join '/'} (#{usage})",
+        "-> Dose de #{@result}#{@conc_unit[0]}/kg/d."
+      ].join "\n"
+    end
+
+    # Outputs the calculated dosage-per-weight-day as a float.
+    #
+    # @return [Float] The dosage prescribe as a float, without units.
+    def to_f
+      @result
+    end
+
+    private
+
+    def usage
+      time = @time.to_i
+      "#{@dose}#{@dose_unit} #{@way} #{time}/#{time}h por #{@days.to_i}d"
+    end
+
+    def init_vars(params)
+      check_vars(params)
+      init_calc_vars(params)
+      init_str_vars(params)
+    end
+
+    def check_vars(params)
+      params.each do |key, value|
+        if value.is_a? String
+          check_str_var(key, value)
+        elsif value.zero?
+          raise ArgumentError, "#{key} must not be zero"
+        end
+      end
+    end
+
+    def check_str_var(key, value)
+      raise ArgumentError, "#{key} must not be zero" if value.empty?
+
+      if key == :dose_unit
+        msg = "#{key} must follow 'unit' format"
+        raise ArgumentError, msg unless value.match?(/^[A-Za-z]+$/)
+      elsif key == :conc_unit
+        msg = "#{key} must follow unit/presentation format"
+        raise ArgumentError, msg unless value.match? %r{^[A-Za-z]+\/[A-Za-z]+$}
+      end
+    end
+
+    def init_calc_vars(params)
+      @weight        = params[:weight].to_f
+      @dose          = params[:dose].to_f
+      @time          = params[:time].to_f
+      @days          = params[:days].to_i
+      @concentration = params[:concentration].to_f
+    end
+
+    def init_str_vars(params)
+      @dose_unit = params[:dose_unit].strip
+      @conc_unit = params[:conc_unit].split '/'
+      @name      = params[:name].strip
+      @way       = params[:way].strip
+    end
+  end
+end

data/lib/pueri/version.rb

@@ -6,7 +6,7 @@
 # of Immunization (PNI), using the 2019 uptade.
 module Pueri
   # Sets the current version of the gem
-  @version = '0.7.0'
+  @version = '0.11.2'
 
   # Returns the Gem's current version.
   #

data/package.json

@@ -1,7 +1,7 @@
 {
   "name": "Pueri",
   "description": "Um script em Ruby para ajudar o dia-a-dia de médicos e enfermeiros de Atenção Básica.",
-  "version": "0.7.0",
+  "version": "0.11.2",
   "maintainers": [
     {
       "name": "Igor Padoim",

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pueri
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.11.2
 platform: ruby
 authors:
 - Igor Padoim
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-10-20 00:00:00.000000000 Z
+date: 2019-10-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -93,10 +93,12 @@ files:
 - ".github/ISSUE_TEMPLATE/user_question.md"
 - ".github/PULL_REQUEST_TEMPLATE.md"
 - ".github/config.yml"
+- ".github/workflows/ruby.yml"
 - ".gitignore"
 - ".rspec"
 - ".rubocop.yml"
 - ".travis.yml"
+- ABOUT.md
 - CHANGELOG.md
 - CODE-OF-CONDUCT.md
 - CONTRIBUTING.md
@@ -109,6 +111,8 @@ files:
 - bin/setup
 - docs/Pueri.html
 - docs/Pueri/Age.html
+- docs/Pueri/DoseCalc.html
+- docs/Pueri/DoseCheck.html
 - docs/Pueri/Neuro.html
 - docs/Pueri/Vax.html
 - docs/_index.html
@@ -127,6 +131,8 @@ files:
 - docs/top-level-namespace.html
 - lib/pueri.rb
 - lib/pueri/age.rb
+- lib/pueri/dosecalc.rb
+- lib/pueri/dosecheck.rb
 - lib/pueri/neuro.rb
 - lib/pueri/vax.rb
 - lib/pueri/version.rb