alma 0.3.2 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f162f9bb1a3b0eee2af44a379b1d094141b6cc9c06767d17acb39d909eb27ed1
-  data.tar.gz: 98eb300d6c0ab62ae07790fa64449c65839f89bd3903b3c0e010e911bf4d3ce0
+  metadata.gz: 55ea295ada19c46e1c3c157ded8cdf0997d62e744913b513a288c45f2239cdce
+  data.tar.gz: 213034074451c8d5388abdf9a6ee6385b56432adab463fa3e9a5d39b8e3dd953
 SHA512:
-  metadata.gz: bff5a50e3f546962f71c3ce2fbfe2ed553b63fc4698df62b1ce2828e53c86c62c018716a476005759ed8b94102d371911e9b3ef69f6b03752b96fe85bcbf7f97
-  data.tar.gz: 8159b943d247e6bd34f3efcd09325191806ca26471252d39d3f54be4182a5b45bc875b2eb7c5bc432b492b70e932cbac8c12054ba0b64883ac14e974933c215f
+  metadata.gz: 3c9d95eb4c80778b3d132ed790a7a615c775a7c650e38936cc588782efabaa1a2e393b39ef94ea90acecee05e514c625b0bace832cbbf6aa9e885ecff77c32bf
+  data.tar.gz: 55060edf008d1ee5c78a5d598daaa03666b3a423960e03fdea668aa7976e839b31385d1f4d2577f945cd4a66d1f40f6a20ca7fd19e0883fb5ced62a8c0fca420

data/.circleci/config.yml

@@ -1,6 +1,6 @@
 version: 2.1
 orbs:
-  ruby: circleci/ruby@0.1.2
+  ruby: circleci/ruby@1.2
 
 workflows:
   version: 2
@@ -17,7 +17,7 @@ workflows:
 jobs:
   build:
     docker:
-      - image: cimg/ruby:2.7.2-node
+      - image: cimg/ruby:2.7.2-browsers
         auth:
           username: $DOCKERHUB_USER
           password: $DOCKERHUB_PASSWORD
@@ -28,7 +28,7 @@ jobs:
       - run:
           name: Which bundler?
           command: bundle -v
-      - ruby/bundle-install
+      - run: bundle install
       - run:
           name: lint
           command: bundle exec rubocop
@@ -37,7 +37,7 @@ jobs:
           command: bundle exec rake
   deploy:
     docker:
-      - image: circleci/ruby:2.7.2-node-browsers
+      - image: cimg/ruby:2.7.2-browsers
 
     working_directory: ~/repo
 

data/CODE_OF_CONDUCT.md

@@ -55,7 +55,7 @@ further defined and clarified by project maintainers.
 ## Enforcement
 
 Instances of abusive, harassing, or otherwise unacceptable behavior may be
-reported by contacting the project team at chad.nelson@temple.edu. All
+reported by contacting the project team at svc.libdev@temple.edu. All
 complaints will be reviewed and investigated and will result in a response that
 is deemed necessary and appropriate to the circumstances. The project team is
 obligated to maintain confidentiality with regard to the reporter of an incident.

data/lib/alma/bib_item_set.rb

@@ -21,7 +21,8 @@ module Alma
       @mms_id = @options.delete(:mms_id)
 
       validate(response)
-      @items = parsed.fetch(key, []).map { |item| single_record_class.new(item) }
+      @items = (parsed.fetch(key, []) || [])
+        .map { |item| single_record_class.new(item) }
     end
 
     def loggable

data/lib/alma/error.rb

@@ -10,7 +10,7 @@ module Alma::Error
   end
 
   def error
-    @response.fetch("web_service_result", {})
+    @response.fetch("web_service_result", {}) || {}
   end
 end
 

data/lib/alma/fine_set.rb

@@ -12,7 +12,7 @@ module Alma
       @raw_response = raw_response
       @response = raw_response.parsed_response
       validate(raw_response)
-      @results = @response.fetch(key, [])
+      @results = (@response.fetch(key, []) || [])
         .map { |item| single_record_class.new(item) }
     end
 

data/lib/alma/library_set.rb

@@ -9,7 +9,7 @@ module Alma
     end
 
     def results
-      @results ||= @response.fetch(key, [])
+      @results ||= (@response.fetch(key, []) || [])
          .map { |item| single_record_class.new(item) }
     end
 

data/lib/alma/loan_set.rb

@@ -16,8 +16,8 @@ module Alma
       @response = raw_response.parsed_response
       @search_args = search_args
       validate(raw_response)
-      @results = @response.fetch(key, [])
-        .map { |item| single_record_class.new(item) }
+      @results = @response.fetch(key, []) || []
+      @results.map! { |item| single_record_class.new(item) }
       # args passed to the search that returned this set
       # such as limit, expand, order_by, etc
     end

data/lib/alma/payment_response.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Alma
+  class PaymentResponse
+    def initialize(response)
+      @raw_response = response
+      @response = response.parsed_response
+      @success  = response["total_sum"] == 0.0
+    end
+
+    def loggable
+      { uri: @raw_response&.request&.uri.to_s
+      }.select { |k, v| !(v.nil? || v.empty?) }
+    end
+
+    def paid?
+      @success
+    end
+
+    def has_payment_error?
+      !paid?
+    end
+
+    def payment_message
+      if paid?
+        "Your balance has been paid."
+      else
+        "There was a problem processing your payment. Please contact the library for assistance."
+      end
+    end
+
+    def error_message
+      @response unless paid?
+    end
+  end
+end

data/lib/alma/request_set.rb

@@ -14,8 +14,8 @@ module Alma
       @raw_response = raw_response
       @response = raw_response.parsed_response
       validate(raw_response)
-      @results = @response.fetch(key, [])
-                   .map { |item| single_record_class.new(item) }
+      @results = @response.fetch(key, []) || []
+      @results.map! { |item| single_record_class.new(item) }
     end
 
     def loggable

data/lib/alma/result_set.rb

@@ -22,7 +22,7 @@ class Alma::ResultSet
   end
 
   def each
-    @results ||= @response.fetch(key, [])
+    @results ||= (@response.fetch(key, []) || [])
       .map { |item| single_record_class.new(item) }
   end
 

data/lib/alma/user.rb

@@ -26,7 +26,6 @@ module Alma
       response.code == 204
     end
 
-
     # The User object can respond directly to Hash like access of attributes
     def_delegators :response, :[], :[]=, :has_key?, :keys, :to_json
 
@@ -58,7 +57,7 @@ module Alma
     end
 
     def total_fines
-      response.dig("fees", "value") || "0"
+      response.dig("fees", "value") || 0.0
     end
 
     def total_requests
@@ -69,7 +68,6 @@ module Alma
       response.dig("loans", "value") || "0"
     end
 
-
     # Access the top level JSON attributes as object methods
     def method_missing(name)
       return response[name.to_s] if has_key?(name.to_s)
@@ -80,14 +78,12 @@ module Alma
       has_key?(name.to_s) || super
     end
 
-
     # Persist the user in it's current state back to Alma
     def save!
       response = HTTParty.put("#{users_base_path}/#{id}", timeout: timeout, headers: headers, body: to_json)
       get_body_from(response)
     end
 
-
     def fines
       Alma::Fine.where_user(id)
     end
@@ -96,7 +92,6 @@ module Alma
       Alma::UserRequest.where_user(id)
     end
 
-
     def loans(args = {})
       @loans ||= Alma::Loan.where_user(id, args)
     end
@@ -108,7 +103,6 @@ module Alma
       end
     end
 
-
     def renew_multiple_loans(loan_ids)
       loan_ids.map { |id| renew_loan(id) }
     end
@@ -148,8 +142,6 @@ module Alma
       "#{preferred_first_name} #{preferred_middle_name} #{preferred_last_name} #{preferred_suffix}"
     end
 
-
-
     private
 
       # Attempts to renew a single item for a user
@@ -177,11 +169,20 @@ module Alma
         loan_ids.map { |id| Alma::User.send_loan_renewal_request(args.merge(loan_id: id)) }
       end
 
+      # Attempts to pay total fines for a user
+      # @param [Hash] args
+      # @option args [String] :user_id The unique id of the user
+      def self.send_payment(args)
+        user_id = args.delete(:user_id) { raise ArgumentError }
+        params = { op: "pay", amount: "ALL", method: "ONLINE" }
+        response = HTTParty.post("#{users_base_path}/#{user_id}/fees/all", query: params, headers: headers)
+        PaymentResponse.new(response)
+      end
+
       def get_body_from(response)
         JSON.parse(response.body)
       end
 
-
       def self.users_base_path
         "https://api-na.hosted.exlibrisgroup.com/almaws/v1/users"
       end

data/lib/alma/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Alma
-  VERSION = "0.3.2"
+  VERSION = "0.4.0"
 end

data/lib/alma.rb

@@ -17,6 +17,7 @@ require "alma/fine"
 require "alma/bib_set"
 require "alma/request_set"
 require "alma/renewal_response"
+require "alma/payment_response"
 require "alma/availability_response"
 require "alma/bib_item"
 require "alma/request_options"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: alma
 version: !ruby/object:Gem::Version
-  version: 0.3.2
+  version: 0.4.0
 platform: ruby
 authors:
 - Jennifer Anton
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2021-05-06 00:00:00.000000000 Z
+date: 2022-11-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ezwadl
@@ -260,6 +260,7 @@ files:
 - lib/alma/loan_set.rb
 - lib/alma/location.rb
 - lib/alma/location_set.rb
+- lib/alma/payment_response.rb
 - lib/alma/renewal_response.rb
 - lib/alma/request.rb
 - lib/alma/request_options.rb