folio_client 0.2.1 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 821d1cc96a7b33ce8c0c8e86c29864175ebfb775ad7c09f0d876d5e52a4a7515
-  data.tar.gz: ed7139af94e9a0be7aa9393cc6dc5477b05630f81efe1ed693f2778e81286211
+  metadata.gz: 960e3e0d138665bbf21b4f609fb7c789c52110101bf303c42ba2c98b93583b98
+  data.tar.gz: b2690e1193c7391a6e4bd6bae4c4f417f395ed91faa50d6215c43e1fc39aaadd
 SHA512:
-  metadata.gz: 31b71ca76d853865aef2752b688d795e2e8d3370febb99371e52d14e44f04f0e00f39d29ae2c8de006cd6cb49a73c8860a7d46bbe084a0c4b80dc119240e9261
-  data.tar.gz: 658f33fa1639211c7139009800e972b59ae19ebb8558a71cbb1d304b5c0a2537c3a089898dcf41d8a74533ee42ab8758e0f59310f76f617b8e46c64875f86a0a
+  metadata.gz: 42cbfadefe92754026e08435bd06378e6dee17ae97e539bd9d71d7833e873c02194ad1762690b55087f002f5fca553f63579a981dfe915674ee95fb8e839bbf2
+  data.tar.gz: 4e2067aa01d4cd2534079cc9a5d11834d73432cd05c209fc57553713ec7d07a27dcf458ec52cace086fab3971d0fe3b9048e3e30e0669d3736d2ea37dcd0589b

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    folio_client (0.2.0)
+    folio_client (0.3.0)
       activesupport (>= 4.2, < 8)
       faraday
       zeitwerk
@@ -97,6 +97,7 @@ GEM
 
 PLATFORMS
   x86_64-darwin-19
+  x86_64-darwin-20
   x86_64-linux
 
 DEPENDENCIES

data/lib/folio_client/source_storage.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+class FolioClient
+  # Lookup records in Folio Source Storage
+  class SourceStorage
+    attr_accessor :client
+
+    # @param client [FolioClient] the configured client
+    def initialize(client)
+      @client = client
+    end
+
+    # @param instance_hrid [String] the key to use for MARC lookup
+    # @return [Hash] hash representation of the MARC. should be usable by MARC::Record.new_from_hash (from ruby-marc gem)
+    # @raises NotFound, MultipleRecordsForIdentifier
+    def fetch_marc_hash(instance_hrid:)
+      response_hash = client.get("/source-storage/source-records", {instanceHrid: instance_hrid})
+
+      record_count = response_hash["totalRecords"]
+      raise FolioClient::UnexpectedResponse::ResourceNotFound, "No records found for #{instance_hrid}" if record_count.zero?
+      raise FolioClient::UnexpectedResponse::MultipleResourcesFound, "Expected 1 record for #{instance_hrid}, but found #{record_count}" if record_count > 1
+
+      response_hash["sourceRecords"].first["parsedRecord"]["content"]
+    end
+  end
+end

data/lib/folio_client/unexpected_response.rb

@@ -6,9 +6,12 @@ class FolioClient
     # Error raised by the Folio Auth API returns a 422 Unauthorized
     class UnauthorizedError < StandardError; end
 
-    # Error raised when the Folio API returns a 404 NotFound
+    # Error raised when the Folio API returns a 404 NotFound, or returns 0 results when one was expected
     class ResourceNotFound < StandardError; end
 
+    # Error raised when e.g. exactly one result was expected, but more than one was returned
+    class MultipleResourcesFound < StandardError; end
+
     # Error raised when the Folio API returns a 403 Forbidden
     class ForbiddenError < StandardError; end
 

data/lib/folio_client/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 class FolioClient
-  VERSION = "0.2.1"
+  VERSION = "0.3.0"
 end

data/lib/folio_client.rb

@@ -31,7 +31,7 @@ class FolioClient
     end
 
     delegate :config, :connection, :get, :post, to: :instance
-    delegate :fetch_hrid, to: :instance
+    delegate :fetch_hrid, :fetch_marc_hash, to: :instance
   end
 
   attr_accessor :config
@@ -74,4 +74,11 @@ class FolioClient
       inventory.fetch_hrid(...)
     end
   end
+
+  def fetch_marc_hash(...)
+    TokenWrapper.refresh(config, connection) do
+      source_storage = SourceStorage.new(self)
+      source_storage.fetch_marc_hash(...)
+    end
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: folio_client
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.3.0
 platform: ruby
 authors:
 - Peter Mangiafico
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-02-22 00:00:00.000000000 Z
+date: 2023-02-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -163,6 +163,7 @@ files:
 - lib/folio_client.rb
 - lib/folio_client/authenticator.rb
 - lib/folio_client/inventory.rb
+- lib/folio_client/source_storage.rb
 - lib/folio_client/token_wrapper.rb
 - lib/folio_client/unexpected_response.rb
 - lib/folio_client/version.rb
@@ -188,7 +189,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.5
+rubygems_version: 3.3.7
 signing_key:
 specification_version: 4
 summary: Interface for interacting with the Folio ILS API.