folio_api_client 0.4.2 → 0.4.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b840ff7acc1495be7cb4dc3895c9a0e372d98df6db09bd45e5a77725e1cc3444
-  data.tar.gz: 187a19aa42bfe6e1f64e859dfd1b7d71c03db8a0967ab93a7df2318bdc2c4b32
+  metadata.gz: c9101df88d1bcae72de9607a5646631b5b4a3ecb2f281f4e81064ea47b1ee9b3
+  data.tar.gz: b9e838309973de0b1b66069bf2aa7c6a5c96f32f8a6b8d167a8cb9cc07d87626
 SHA512:
-  metadata.gz: 4b1d313a2cf74cd8b28f5d151239136a3fd8c7fe4db9a2bb85c924dd9390ab464e733012fc95d8bc8bf274db6571e2638f66ab0e4fa0633e4e0b5f372184647c
-  data.tar.gz: 52216d3b49b1b5d5c45c3698eb95eb8350aca7b59846de99f9498524c3e2fe8f202f7a8227a7f53b9f5b6e03da9ad6d33be816e7e87a12412579ecd6c1e445ee
+  metadata.gz: 5f087226a449dc37b26445d40f0d99fe752c6f9203123bc0d6aef87f050a5257c0c6b371ee7441905406454933ecb9d37df1c539a21a82f068d6ded468902663
+  data.tar.gz: e8d41ca37c67901d6db368509e72f1360bcd509e71a179aa6443defe544d145bcef7a2a56e0f1a40c16dae7ad1d914c0a3e1f36d9d6197470d08479883307e8b

data/README.md

@@ -47,6 +47,7 @@ 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')

data/lib/folio_api_client/finders.rb

@@ -14,10 +14,26 @@ class FolioApiClient
       item_search_results.first
     end
 
-    def find_location_record(location_id:)
-      return nil if location_id.nil?
+    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
 
-      self.get("/locations/#{location_id}")
+      nil
     rescue Faraday::ResourceNotFound
       nil
     end
@@ -89,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.2'
+  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.2
+  version: 0.4.3
 platform: ruby
 authors:
 - Eric O'Hanlon
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-09-15 00:00:00.000000000 Z
+date: 2025-09-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday