folio_api_client 0.4.0 → 0.4.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b95e817f47b4694776baae831bcad7784810d06e7533577f27f8bcf4ea216b06
-  data.tar.gz: 63291ad25685d7c4ba71dd2399104b8925241da84eca2483f8bd63b4567b4454
+  metadata.gz: c9101df88d1bcae72de9607a5646631b5b4a3ecb2f281f4e81064ea47b1ee9b3
+  data.tar.gz: b9e838309973de0b1b66069bf2aa7c6a5c96f32f8a6b8d167a8cb9cc07d87626
 SHA512:
-  metadata.gz: '018541167173b30bbf0c938c10465888581fd87d8c64885fd59dfcc3ea4a2305e93d75533f55c752b7eb495ee2b72be7b8514246caffe7bdebbe56b18f5f44ee'
-  data.tar.gz: 7812af3dbf43c33aa37c490e8a0a084de82842b64bcdc86571c0eb9e713ad293884f7ff03098d26d15acd75bbcb4a73a89d7f2c2d4eee6e1f32eccf1233405bf
+  metadata.gz: 5f087226a449dc37b26445d40f0d99fe752c6f9203123bc0d6aef87f050a5257c0c6b371ee7441905406454933ecb9d37df1c539a21a82f068d6ded468902663
+  data.tar.gz: e8d41ca37c67901d6db368509e72f1360bcd509e71a179aa6443defe544d145bcef7a2a56e0f1a40c16dae7ad1d914c0a3e1f36d9d6197470d08479883307e8b

data/README.md

@@ -47,6 +47,8 @@ client.delete(path, body, content_type: 'application/json'))
 
 client.find_item_record(barcode: 'some-barcode')
 client.find_location_record(location_id: 'some-location-id')
+client.find_location_record(code: 'some-location-code')
+client.find_material_type_record(material_type_id: 'some-material-type-id')
 client.find_holdings_record(holdings_record_id: 'some-holdings-record-id')
 client.find_instance_record(instance_record_id: 'some-instance-record-id')
 client.find_instance_record(instance_record_hrid: 'some-instance-record-hrid')

data/lib/folio_api_client/finders.rb

@@ -14,8 +14,36 @@ class FolioApiClient
       item_search_results.first
     end
 
-    def find_location_record(location_id:)
-      self.get("/locations/#{location_id}")
+    def find_location_record(location_id: nil, code: nil) # rubocop:disable Metrics/MethodLength
+      if location_id
+        return self.get("/locations/#{location_id}")
+      elsif code
+        location_record_search_results = self.get(
+          '/locations',
+          location_record_query(code: code)
+        )['locations']
+
+        return nil if location_record_search_results.empty?
+
+        if location_record_search_results.length > 1
+          raise FolioApiClient::Exceptions::UnexpectedMultipleRecordsFoundError,
+                'Only expected one location with this code, but found more than one.'
+        end
+
+        return location_record_search_results.first
+      end
+
+      nil
+    rescue Faraday::ResourceNotFound
+      nil
+    end
+
+    def find_material_type_record(material_type_id:)
+      return nil if material_type_id.nil?
+
+      self.get("/material-types/#{material_type_id}")
+    rescue Faraday::ResourceNotFound
+      nil
     end
 
     def find_loan_type_record(loan_type_id:)
@@ -77,5 +105,12 @@ class FolioApiClient
       raise FolioApiClient::Exceptions::MissingQueryFieldError,
             'Missing query field.  Must supply either an instance_record_id or instance_record_hrid.'
     end
+
+    def location_record_query(code: nil)
+      return { query: "code==#{code}", limit: 2 } if code
+
+      raise FolioApiClient::Exceptions::MissingQueryFieldError,
+            'Missing query field.  Must supply a code.'
+    end
   end
 end

data/lib/folio_api_client/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 class FolioApiClient
-  VERSION = '0.4.0'
+  VERSION = '0.4.3'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: folio_api_client
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.4.3
 platform: ruby
 authors:
 - Eric O'Hanlon
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-06-06 00:00:00.000000000 Z
+date: 2025-09-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday