exlibris-aleph 1.1.0 → 2.0.0

data/lib/exlibris/aleph/item/processing_status.rb

@@ -0,0 +1,23 @@
+module Exlibris
+  module Aleph
+    class Item
+      class ProcessingStatus
+        attr_reader :code, :display
+
+        def initialize(code, display=nil)
+          @code = code
+          @display = display
+        end
+
+        def to_s
+          (display || code)
+        end
+
+        def ==(other_object)
+          other_object.instance_of?(self.class) && code == other_object.code
+        end
+        alias_method :eql?, :==
+      end
+    end
+  end
+end

data/lib/exlibris/aleph/item/queue.rb

@@ -0,0 +1,32 @@
+module Exlibris
+  module Aleph
+    class Item
+      class Queue
+        attr_reader :value
+
+        def initialize(value)
+          @value = value
+        end
+
+        def to_s
+          value
+        end
+
+        def number_of_requests
+          @number_of_requests ||= begin
+            if number_of_requests_matched_data.nil?
+              0
+            else
+              number_of_requests_matched_data[1].to_i
+            end
+          end
+        end
+
+        private
+        def number_of_requests_matched_data
+          @number_of_requests_matched_data ||= /^(\d+) request\(s\)/.match(value)
+        end
+      end
+    end
+  end
+end

data/lib/exlibris/aleph/item/status.rb

@@ -0,0 +1,23 @@
+module Exlibris
+  module Aleph
+    class Item
+      class Status
+        attr_reader :code, :display
+
+        def initialize(code, display=nil)
+          @code = code
+          @display = display
+        end
+
+        def to_s
+          (display || code)
+        end
+
+        def ==(other_object)
+          other_object.instance_of?(self.class) && code == other_object.code
+        end
+        alias_method :eql?, :==
+      end
+    end
+  end
+end

data/lib/exlibris/aleph/items.rb

@@ -0,0 +1,51 @@
+module Exlibris
+  module Aleph
+    class Items
+
+      extend Forwardable
+      def_delegators :to_a, :each, :size
+
+      include Enumerable
+
+      attr_reader :record_id
+
+      def initialize(record_id)
+        @record_id = record_id
+      end
+
+      def to_a
+        @array ||= ids.map { |id| Item.new(record_id, id) }
+      end
+
+      private
+      def client
+        @client ||= API::Client::Record::Items.new(record_id)
+      end
+
+      def root
+        @root ||= client.root
+      end
+
+      def items_root
+        @items_root ||= root['items']
+      end
+
+      def items
+        @items ||= items_root['item'] unless items_root.nil?
+      end
+
+      def ids
+        @ids ||= begin
+          if items.nil?
+            []
+          else
+            items.map do |item|
+              href = (items.size > 1) ? item['href'] : item[1]
+              href.split('/').pop
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/exlibris/aleph/metadata.rb

@@ -0,0 +1,25 @@
+module Exlibris
+  module Aleph
+    require 'marc'
+    class Metadata
+      attr_reader :marc_xml
+
+      def initialize(marc_xml)
+        @marc_xml = marc_xml.strip
+      end
+
+      def marc_record
+        @marc_record ||= marc_xml_reader.first
+      end
+
+      private
+      def string_io
+        StringIO.new(marc_xml)
+      end
+
+      def marc_xml_reader
+        MARC::XMLReader.new(string_io)
+      end
+    end
+  end
+end

data/lib/exlibris/aleph/patron.rb

@@ -1,100 +1,36 @@
 module Exlibris
   module Aleph
-    # ==Overview
-    # Provides access to the Aleph Patron REST API.
-    class Patron < Rest::Base
-      attr_accessor :patron_id
+    class Patron
+      attr_reader :id
 
-      # Place a hold on the specificed item.
-      # Returns a Hash, including the "note" returned from the underlying API.
-      # Raises an exception if the response is not valid XML or there are errors.
-      def place_hold(adm_library, bib_library, bib_id, item_id, params)
-        options = { :body => "post_xml=#{place_hold_xml(params)}"}
-        self.response = self.class.put("#{patron_url}/record/#{bib_library}#{bib_id}/items/#{item_id}/hold", options)
-        raise_error_if("Error placing hold through Aleph REST APIs. #{error}") {
-          (response.parsed_response["put_item_hold"].nil? or response.parsed_response["put_item_hold"]["create_hold"].nil?)
-        }
-        response.parsed_response["put_item_hold"]["create_hold"]
+      def initialize(id)
+        @id = id
       end
 
-      # Returns a Hash representing the patron's address information.
-      # Every method call refreshes the data from the underlying API.
-      # Raises an exception if the response is not valid XML or there are errors.
-      def address
-        self.response = self.class.get("#{patron_url}/patronInformation/address")
-        raise_error_if("Error getting patron address through Aleph REST APIs.") {
-          (response.parsed_response["get_pat_adrs"].nil? or response.parsed_response["get_pat_adrs"]["address_information"].nil?)
-        }
-        response.parsed_response["get_pat_adrs"]["address_information"]
-      end
-
-      # Returns an Array of institutions. 
-      # Each institution is a Hash containing an array of loans for that institution.
-      # Every method call refreshes the data from the underlying API.
-      # Raises an exception if the response is not valid XML or there are errors.
-      def loans
-        self.response = self.class.get("#{patron_url}/circulationActions/loans?view=full")
-        raise_error_if("Error getting loans through Aleph REST APIs.") {
-          (response.parsed_response["pat_loan_list"].nil? or response.parsed_response["pat_loan_list"]["loans"].nil?)
-        }
-        [response.parsed_response["pat_loan_list"]["loans"]["institution"]].flatten
+      def admin_library
+        @admin_library ||= AdminLibrary.new(reader.admin_library_code)
       end
 
-      # Renew the specified item.
-      # Will renew all if item not specified.
-      # Returns an Array of institutions. 
-      # Each institution is a Hash containing an array of loan renewals for that institution.
-      # Raises an exception if the response is not valid XML or there are errors.
-      def renew_loans(item_id="")
-        self.response = self.class.post("#{patron_url}/circulationActions/loans/#{item_id}")
-        raise_error_if("Error renewing loans through Aleph REST APIs.") {
-          (response.parsed_response["renew_loan"].nil? or response.parsed_response["renew_loan"]["renewals"].nil?)
-        }
-        [response.parsed_response["renew_loan"]["renewals"]["institution"]].flatten
+      def address
+        @address ||= Address.new(id)
       end
 
-      # Returns the note associated with the request.
-      def note
-        return (not response.first.last.kind_of?(Hash) or response.first.last["create_hold"].nil?) ? "" : ": #{response.first.last["create_hold"]["note"]["__content__"]}" if response.instance_of?(Hash)
+      def record(record_id)
+        Record.new(id, record_id)
       end
 
-      # Returns the error associated with the request.
-      # Returns nil if no error.
-      def error
-        return nil if reply_code == "0000"
-        return "#{reply_text}#{note}"
+      private
+      def client
+        @client ||= API::Client::Patron.new(id)
       end
 
-      def patron_url
-        @patron_url ||= "#{rest_url}/patron/#{patron_id}"
+      def root
+        @root ||= client.root
       end
-      private :patron_url
 
-      def place_hold_xml(params)
-        pickup_location = params[:pickup_location]
-        last_interest_date = params.fetch(:last_interest_date, "")
-        start_interest_date = params.fetch(:start_interest_date, "")
-        sub_author = params.fetch(:sub_author, "")
-        sub_title = params.fetch(:sub_title, "")
-        pages = params.fetch(:pages, "")
-        note_1 = params.fetch(:note_1, "")
-        note_2 = params.fetch(:note_2, "")
-        rush = params.fetch(:rush, "N")
-        build_xml { |xml|
-          xml.send(:"hold-request-parameters") {
-            xml.send :"pickup-location", pickup_location
-            xml.send :"last-interest-date", last_interest_date
-            xml.send :"start-interest-date", start_interest_date
-            xml.send :"sub-author", sub_author
-            xml.send :"sub-title", sub_title
-            xml.send :"pages", pages
-            xml.send :"note-1", note_1
-            xml.send :"note-2", note_2
-            xml.send :"rush", rush
-          }
-        }
+      def reader
+        @reader ||= API::Reader::Patron.new(root)
       end
-      private :place_hold_xml
     end
   end
-end
+end

data/lib/exlibris/aleph/patron/address.rb

@@ -0,0 +1,56 @@
+module Exlibris
+  module Aleph
+    class Patron
+      class Address
+        attr_reader :patron_id
+
+        def initialize(patron_id)
+          @patron_id = patron_id
+        end
+
+        (1..5).each do |n|
+          address_n = "address#{n}".to_sym
+          define_method(address_n) do
+            eval("@#{address_n} ||= reader.send(address_n)")
+          end
+        end
+
+        (1..4).each do |n|
+          telephone_n = "telephone#{n}".to_sym
+          define_method(telephone_n) do
+            eval("@#{telephone_n} ||= reader.send(telephone_n)")
+          end
+        end
+
+        def zip
+          @zip ||= reader.zip
+        end
+
+        def sms_number
+          @sms_number ||= reader.sms_number
+        end
+
+        def want_sms
+          @want_sms ||= reader.want_sms
+        end
+
+        def email
+          @email ||= reader.email
+        end
+
+        private
+        def client
+          @client ||= API::Client::Patron::Address.new(patron_id)
+        end
+
+        def root
+          @root ||= client.root
+        end
+
+        def reader
+          @reader ||= API::Reader::Patron::Address.new(root)
+        end
+      end
+    end
+  end
+end

data/lib/exlibris/aleph/patron/circulation_policy.rb

@@ -0,0 +1,26 @@
+module Exlibris
+  module Aleph
+    class Patron
+      class CirculationPolicy
+        attr_reader :identifier, :privileges
+
+        def initialize(identifier, privileges)
+          unless identifier.is_a?(Identifier)
+            raise ArgumentError.new("Expecting #{identifier} to be a Patron::CirculationPolicy::Identifier")
+          end
+          unless privileges.is_a?(Privileges)
+            raise ArgumentError.new("Expecting #{privileges} to be a Patron::CirculationPolicy::Privileges")
+          end
+          @identifier = identifier
+          @privileges = privileges
+        end
+
+        def ==(other_object)
+          (other_object.instance_of?(self.class) &&
+            identifier == other_object.identifier)
+        end
+        alias_method :eql?, :==
+      end
+    end
+  end
+end

data/lib/exlibris/aleph/patron/circulation_policy/identifier.rb

@@ -0,0 +1,29 @@
+module Exlibris
+  module Aleph
+    class Patron
+      class CirculationPolicy
+        class Identifier
+          attr_reader :status, :sub_library
+
+          def initialize(status, sub_library)
+            unless status.is_a?(Status)
+              raise ArgumentError.new("Expecting #{status} to be a Patron::Status")
+            end
+            unless sub_library.is_a?(SubLibrary)
+              raise ArgumentError.new("Expecting #{sub_library} to be a SubLibrary")
+            end
+            @status = status
+            @sub_library = sub_library
+          end
+
+          def ==(other_object)
+            (other_object.instance_of?(self.class) &&
+              status == other_object.status &&
+              sub_library == other_object.sub_library)
+          end
+          alias_method :eql?, :==
+        end
+      end
+    end
+  end
+end

data/lib/exlibris/aleph/patron/circulation_policy/privileges.rb

@@ -0,0 +1,56 @@
+module Exlibris
+  module Aleph
+    class Patron
+      class CirculationPolicy
+        class Privileges
+
+          attr_reader :borrow, :photocopy, :request, :request_multiple,
+            :request_on_shelf, :renew, :book, :rush_cataloging
+
+          def initialize(privileges)
+            @borrow = privileges.borrow
+            @photocopy = privileges.photocopy
+            @request = privileges.request
+            @request_multiple = privileges.request_multiple
+            @request_on_shelf = privileges.request_on_shelf
+            @renew = privileges.renew
+            @book = privileges.book
+            @rush_cataloging = privileges.rush_cataloging
+          end
+
+          def can_borrow?
+            borrow == 'Y'
+          end
+
+          def can_photocopy?
+            photocopy == 'Y'
+          end
+
+          def can_request?
+            request == 'Y'
+          end
+
+          def can_request_multiple?
+            request_multiple == 'Y'
+          end
+
+          def can_request_on_shelf?
+            request_on_shelf == 'Y'
+          end
+
+          def can_renew?
+            renew == 'Y'
+          end
+
+          def can_book?
+            book == 'Y'
+          end
+
+          def can_rush_cataloging?
+            rush_cataloging == 'Y'
+          end
+        end
+      end
+    end
+  end
+end