daisybill_api 0.1.0

data/lib/daisybill_api/ext/attributes/attribute.rb

@@ -0,0 +1,60 @@
+module DaisybillApi
+  module Ext
+    # @private
+    module Attributes
+      class Attribute
+        attr_accessor :name, :type, :options
+        attr_reader :value
+
+        def initialize(name, type, options = {})
+          @name = name.to_s
+          @type = type
+          @options = options
+          @value = [] if collection?
+        end
+
+        def value=(value)
+          @value = TypeCastings.convert_to(value, type)
+        end
+
+        def readonly?
+          !!options[:readonly]
+        end
+
+        def param_name
+          if collection?
+            simple_collection? ? name : "#{name}_attributes"
+          else
+            simple_type? ? name : "#{name}_attributes"
+          end
+        end
+
+        def param_value
+          if collection?
+            simple_collection? ? value : value.map(&:to_params)
+          else
+            simple_type? ? value : (value && value.to_params)
+          end
+        end
+
+        def to_param
+          readonly? ? {} : { param_name => param_value }
+        end
+
+        private
+
+        def simple_type?
+          type.is_a? Symbol
+        end
+
+        def collection?
+          type.is_a? Array
+        end
+
+        def simple_collection?
+          collection? && type.first.is_a?(Symbol)
+        end
+      end
+    end
+  end
+end

data/lib/daisybill_api/ext/attributes/type_castings.rb

@@ -0,0 +1,78 @@
+require 'open-uri'
+
+module DaisybillApi
+  module Ext
+    module Attributes
+      module TypeCastings
+        class << self
+          def convert_to(value, type)
+            return to_array(value, type.first) if type.is_a? Array
+            return if value.nil? || (value.is_a?(String) && value.strip.empty?)
+            return to_class(value, type) if type.is_a? Class
+            case type
+              when :integer
+                to_integer(value)
+              when :string
+                to_string(value)
+              when :date
+                to_date(value)
+              when :datetime
+                to_datetime(value)
+              when :boolean
+                to_boolean(value)
+              when :attachment
+                to_attachment(value)
+              when :float
+                to_float(value)
+              else
+                raise 'Unknown Type'
+            end
+          end
+
+          private
+
+          def to_date(value)
+            return value.to_date if value.respond_to? :to_date
+            Date.parse value rescue nil
+          end
+
+          def to_datetime(value)
+            return value.to_datetime if value.respond_to? :to_datetime
+            DateTime.iso8601 value rescue nil
+          end
+
+          def to_integer(value)
+            value.to_i rescue nil
+          end
+
+          def to_string(value)
+            value.to_s rescue nil
+          end
+
+          def to_boolean(value)
+            !!value
+          end
+
+          def to_float(value)
+            value.to_f rescue nil
+          end
+
+          def to_class(attributes, type)
+            return attributes if attributes.is_a? type
+            type.new attributes rescue nil
+          end
+
+          def to_array(values, type)
+            return [] if values.nil?
+            values.map { |value| convert_to value, type }
+          end
+
+          def to_attachment(value)
+            return open(value) if value.is_a? String
+            value if value.is_a?(StringIO) || value.kind_of?(IO)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/daisybill_api/ext/crud.rb

@@ -0,0 +1,147 @@
+require 'daisybill_api/ext/crud/index'
+require 'daisybill_api/ext/crud/create'
+require 'daisybill_api/ext/crud/show'
+require 'daisybill_api/ext/crud/update'
+require 'daisybill_api/ext/crud/destroy'
+
+module DaisybillApi
+  module Ext
+    module CRUD
+      # @private
+      module ClassMethods
+        def rest_actions(*actions)
+          actions.each { |action|
+            name = action.capitalize
+            extend "DaisybillApi::Ext::CRUD::#{name}::ClassMethods".constantize
+            include "DaisybillApi::Ext::CRUD::#{name}::InstanceMethods".constantize
+          }
+        end
+
+        def path=(value)
+          @path = value
+        end
+
+        def path
+          @path ||= "/#{plural_key}"
+        end
+
+        def path_prefix(path, property)
+          @prefix_path = path
+          @prefix_property = property
+          attribute property, :integer, readonly: true
+          validates property, presence: true, if: :new_record?
+        end
+
+        def path_prefix?
+          !!(@prefix_path && @prefix_property)
+        end
+
+        def prefix_path
+          @prefix_path
+        end
+
+        def prefix_property
+          @prefix_property
+        end
+
+        def plural_key
+          @plural_key ||= demodulize self.model_name.plural
+        end
+
+        def singular_key
+          @singular_key ||= demodulize self.model_name.singular
+        end
+
+        def show_path(id)
+          "#{path}/#{id}"
+        end
+
+        def index_path(prefix_id)
+          if path_prefix?
+            index_path_with_prefix(prefix_id)
+          else
+            index_path_without_prefix
+          end
+        end
+
+        def client(method, path, params = {})
+          DaisybillApi::Data::Client.build method, path, params
+        end
+
+        private
+
+        PREFIX_LENGTH = 'daisybill_api_models_'.length
+
+        def demodulize(name)
+          name[PREFIX_LENGTH..name.length]
+        end
+
+        def index_path_with_prefix(prefix_id)
+          "#{prefix_path}/#{prefix_id}#{path}"
+        end
+
+        def index_path_without_prefix
+          path
+        end
+      end
+
+      # @private
+      module InstanceMethods
+        def new_record?
+          id.nil?
+        end
+
+        def destroyed?
+          !!@destroyed
+        end
+
+        protected
+
+        def index_path
+          params = self.class.path_prefix? ? [self.send(self.class.prefix_property)] : []
+          self.class.index_path *params
+        end
+
+        def show_path
+          self.class.show_path(id)
+        end
+
+        def data
+          { self.class.singular_key => to_params }
+        end
+
+        private
+
+        def client(method, path, params = {})
+          self.class.client method, path, params
+        end
+
+        def send_data(method, url)
+          self.external_errors = nil
+          valid? && process_response(client method, url, data)
+        end
+
+        def process_response(client)
+          if client.success?
+            response = client.response.clone
+            self.links = response.delete 'links'
+            self.attributes = response
+            true
+          elsif client.bad_request?
+            self.external_errors = client.response['errors']
+            self.valid?
+          else
+            false
+          end
+        end
+      end
+
+      def self.included(base)
+        base.class_eval do
+          include DaisybillApi::Ext::CRUD::InstanceMethods
+          extend DaisybillApi::Ext::CRUD::ClassMethods
+        end
+      end
+    end
+  end
+end

data/lib/daisybill_api/ext/crud/create.rb

@@ -0,0 +1,107 @@
+module DaisybillApi
+  module Ext
+    module CRUD
+      module Create
+        module ClassMethods
+          # === Creating a record
+          #
+          #   DaisybillApi::Models::Patient.create(
+          #     first_name: "Johnny",
+          #     last_name: "Smith",
+          #     billing_provider_id: 14
+          #   )
+          #   # => <DaisybillApi::Models::Patient billing_provider_id: 14 ...>
+          #
+          #
+          # === Creating a Bill
+          #
+          #   bp = DaisybillApi::Models::BillingProvider.find(14)
+          #   # => <DaisybillApi::Models::BillingProvider id: 14...>
+          #   pos = bp.places_of_service.first
+          #   # => <DaisybillApi::Models::PlaceOfService billing_provider_id: 14...>
+          #   rp = bp.rendering_providers.first
+          #   # => <DaisybillApi::Models::RenderingProvider billing_provider_id: 14...>
+          #
+          #   sli = DaisybillApi::Models::ServiceLineItem.new(
+          #     procedure_code: "S9981",
+          #     units: 1,
+          #     modifier_codes: ["93", "17"],
+          #     diagnosis_code_1: "72700",
+          #     custom_unit_charge_cents: 12345
+          #   )
+          #   # => <DaisybillApi::Models::ServiceLineItem...>
+          #
+          #   bill = DaisybillApi::Models::Bill.new(
+          #     injury_id: 345,
+          #     date_of_service: '2015-01-01',
+          #     rendering_provider_id: rp.id,
+          #     place_of_service_id: pos.id,
+          #     diagnosis_codes: ["72700"],
+          #     diagnosis_type: "Icd10",
+          #     service_line_items: [sli]
+          #   )
+          #   # => <DaisybillApi::Models::Bill...>
+          #
+          #   bill.save
+          #   # => true
+          #
+          # @param attributes [Hash]
+          # @return [Object]
+          def create(attributes = {})
+            instance = new(attributes)
+            instance.create
+            instance
+          end
+        end
+
+        module InstanceMethods
+          # == Creating or Updating a record
+          #
+          # === Creating a record
+          #
+          #   pt = DaisyBillApi::Models::Patient.new(
+          #     billing_provider_id: 14,
+          #     first_name: "Johnny",
+          #     last_name: "Smith",
+          #     ssn: "123456789",
+          #     gender: "Male"
+          #   )
+          #
+          #   pt.save # => true
+          #
+          # === Updating a record
+          #
+          #   pt = DaisybillApi::Models::Patient.find(12) # => <DaisybillApi::Models::Patient id: 12...>
+          #
+          #   pt.telephone                # => "2138888888"
+          #
+          #   pt.telephone = "2137777777" # => "2137777777"
+          #
+          #   pt.telephone                # => "2137777777"
+          #
+          #   pt.save # => true
+          #
+          # === Inspecting errors
+          #
+          #   pt = DaisybillApi::Models::Patient.new(billing_provider_id: 14, first_name: "Johnny")
+          #
+          #   pt.save # => false
+          #
+          #   pt.errors.full_messages # => ["Last name can't be blank"]
+          def save
+            return create if new_record?
+            return update if respond_to? :update
+            message = '#save method is not supported for saved record'
+            DaisybillApi.logger.error message
+            raise NotImplementedError.new message
+          end
+
+          # @private
+          def create
+            send_data :post, index_path
+          end
+        end
+      end
+    end
+  end
+end

data/lib/daisybill_api/ext/crud/destroy.rb

@@ -0,0 +1,28 @@
+module DaisybillApi
+  module Ext
+    module CRUD
+      module Destroy
+        # @private
+        module ClassMethods; end
+
+        module InstanceMethods
+          # === Deleting records
+          #
+          #   bill = DaisybillApi::Models::Bill.find(12) # => <DaisybillApi::Models::Bill id: 12>
+          #   bill.destroy # => true
+          #   DaisybillApi::Models::Bill.find(12) # => nil
+          #
+          # Some records will not be deletable depending on their conditions:
+          #
+          #   bill = DaisybillApi::Models::Bill.find(1) # => <DaisybillApi::Models::Bill id: 1...>
+          #   bill.status  # => "done"
+          #   bill.destroy # => false
+          #   bill.errors.full_messages # => ["Bill is not deletable"]
+          def destroy
+            @destroyed = send_data :delete, show_path
+          end
+        end
+      end
+    end
+  end
+end

data/lib/daisybill_api/ext/crud/index.rb

@@ -0,0 +1,41 @@
+module DaisybillApi
+  module Ext
+    module CRUD
+      module Index
+        module ClassMethods
+          # Retrieves a list of records
+          #
+          #   @patients = DaisybillApi::Models::Patient.all(billing_provider_id: 2)
+          #   # => #<DaisybillApi::Ext::PageableCollection>
+          #
+          # @param [Hash] options
+          # @return [Object] a {DaisybillApi::Ext::PageableCollection PageableCollection} that includes Enumerable
+          def all(options = {})
+            id = options[@prefix_property]
+            c = client(:get, index_path(id), options)
+
+            if c.success?
+              DaisybillApi::Ext::PageableCollection.new(
+                c.response[plural_key.to_s].map { |attributes|
+                  instance = new(attributes)
+                  instance.send("#{prefix_property}=", id) if path_prefix?
+                  instance
+                },
+                {
+                  headers: c.headers,
+                  params: options,
+                  resource_class: self
+                }
+              )
+            else
+              DaisybillApi::Ext::PageableCollection.new([])
+            end
+          end
+        end
+
+        # @private
+        module InstanceMethods; end
+      end
+    end
+  end
+end