folio_client 0.12.0 → 0.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7918be772bc1758840166cbb6f0fb66bfbf4765f636118d971efef2192a947df
-  data.tar.gz: 86d3c7e5656e849cf3358ddf7e22463bd65527cedf017a9a31dfdd2606bad88a
+  metadata.gz: c3b597d27e912d256a895af940e312d24e85acf5c234f48788c6716a4e8947de
+  data.tar.gz: 9700fb07ff086e5b6c833897abd921adaa8efd19e173c8948484ad5d554614a2
 SHA512:
-  metadata.gz: 9471247fec95c9df775cd359896c788d124173477b74f1124d41641f76e6d61438fe7b5e7c10fb3ee7d6efb9f5dba11c9b0b7b45fb9040520f6668cba626fc1d
-  data.tar.gz: 4f0adf00bb277b709a68552e7f2b5119e7b8597723ffc3c4f500d850e2c8470df0249a19e35a98bcfcf2ef6daa3befb8155e57d5f69c8d825fe3b1806cd240a5
+  metadata.gz: a8256c90e8c80390e5536d4c988140d30074481d6d8b958a3e8321b81e6dc0f2f7634f3e5253abe7c9b60b22fbebb5246fe6f9052c93b658d621a108a1598ff9
+  data.tar.gz: 99e52e340c66cc0233e577e73840880c2a0f9b2eea758b42418784124a524d1c7d1fc73ede20dd8bdd77aa0d69f44843eebd0f82e08067306b687b0082dc326b

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    folio_client (0.12.0)
+    folio_client (0.13.0)
       activesupport (>= 4.2, < 8)
       dry-monads
       faraday
@@ -72,7 +72,7 @@ GEM
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.12.0)
     rspec-support (3.12.1)
-    rubocop (1.56.3)
+    rubocop (1.56.4)
       base64 (~> 0.1.1)
       json (~> 2.3)
       language_server-protocol (>= 3.17.0)
@@ -86,14 +86,14 @@ GEM
       unicode-display_width (>= 2.4.0, < 3.0)
     rubocop-ast (1.29.0)
       parser (>= 3.2.1.0)
-    rubocop-capybara (2.18.0)
+    rubocop-capybara (2.19.0)
       rubocop (~> 1.41)
     rubocop-factory_bot (2.24.0)
       rubocop (~> 1.33)
     rubocop-performance (1.19.1)
       rubocop (>= 1.7.0, < 2.0)
       rubocop-ast (>= 0.4.0)
-    rubocop-rspec (2.24.0)
+    rubocop-rspec (2.24.1)
       rubocop (~> 1.33)
       rubocop-capybara (~> 2.17)
       rubocop-factory_bot (~> 2.22)
@@ -123,12 +123,12 @@ GEM
     unf (0.1.4)
       unf_ext
     unf_ext (0.0.8.2)
-    unicode-display_width (2.4.2)
+    unicode-display_width (2.5.0)
     webmock (3.19.1)
       addressable (>= 2.8.0)
       crack (>= 0.3.2)
       hashdiff (>= 0.4.0, < 2.0.0)
-    zeitwerk (2.6.11)
+    zeitwerk (2.6.12)
 
 PLATFORMS
   x86_64-darwin-19

data/README.md

@@ -131,6 +131,22 @@ After checking out the repo, run `bin/setup` to install dependencies. Then, run
 
 To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 
+## Integration Testing
+
+To test that the gem works against the Folio APIs, run `api_test.rb` via:
+
+```shell
+# NOTE: This is bash syntax, YMMV
+$ export OKAPI_PASSWORD=$(vault kv get --field=content puppet/application/folio/stage/app_sdr_password)
+$ export OKAPI_TENANT=sul
+$ export OKAPI_USER=app_sdr
+$ export OKAPI_URL=https://okapi-stage.stanford.edu
+# NOTE: The args below are a list of MARC files
+$ bundle exec ruby ./api_test.rb /path/to/marc/files/test.mrc /another/marc/file/at/foobar.marc
+```
+
+Inspect the output and make sure there are no errors.
+
 ## Contributing
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/sul-dlss/folio_client.

data/api_test.rb

@@ -0,0 +1,38 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "folio_client"
+
+marc_files = *ARGV
+
+client =
+  FolioClient.configure(
+    url: ENV["OKAPI_URL"],
+    login_params: {
+      username: ENV["OKAPI_USER"],
+      password: ENV["OKAPI_PASSWORD"]
+    },
+    okapi_headers: {
+      "X-Okapi-Tenant": ENV["OKAPI_TENANT"],
+      "User-Agent": "folio_client gem (testing)"
+    }
+  )
+
+pp(client.fetch_marc_hash(instance_hrid: "a666"))
+
+puts client.fetch_marc_xml(instance_hrid: "a666")
+puts client.fetch_marc_xml(barcode: "20503330279")
+
+records = marc_files.flat_map do |marc_file_path|
+  MARC::Reader.new(marc_file_path).to_a
+end
+
+data_importer =
+  client.data_import(
+    records: records,
+    job_profile_id: "e34d7b92-9b83-11eb-a8b3-0242ac130003",
+    job_profile_name: "Default - Create instance and SRS MARC Bib"
+  )
+
+puts data_importer.wait_until_complete
+puts data_importer.instance_hrids

data/lib/folio_client/data_import.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require "date"
-require "marc"
 require "stringio"
 
 class FolioClient

data/lib/folio_client/source_storage.rb

@@ -3,6 +3,8 @@
 class FolioClient
   # Lookup records in Folio Source Storage
   class SourceStorage
+    FIELDS_TO_REMOVE = %w[001 003].freeze
+
     attr_accessor :client
 
     # @param client [FolioClient] the configured client
@@ -24,5 +26,36 @@ class FolioClient
 
       response_hash["sourceRecords"].first["parsedRecord"]["content"]
     end
+
+    # get marc bib data as MARCXML from folio given an instance HRID
+    # @param instance_hrid [String] the instance HRID to use for MARC lookup
+    # @param barcode [String] the barcode to use for MARC lookup
+    # @return [String] MARCXML string
+    # @raise [ResourceNotFound]
+    # @raise [MultipleResourcesFound]
+    def fetch_marc_xml(instance_hrid: nil, barcode: nil)
+      raise ArgumentError, "Either a barcode or a Folio instance HRID must be provided" if barcode.nil? && instance_hrid.nil?
+
+      instance_hrid ||= client.fetch_hrid(barcode: barcode)
+
+      raise ResourceNotFound, "Catalog record not found. HRID: #{instance_hrid} | Barcode: #{barcode}" if instance_hrid.blank?
+
+      marc_record = MARC::Record.new_from_hash(
+        fetch_marc_hash(instance_hrid: instance_hrid)
+      )
+      updated_marc = MARC::Record.new
+      updated_marc.leader = marc_record.leader
+      marc_record.fields.each do |field|
+        # explicitly remove all listed tags from the record
+        next if FIELDS_TO_REMOVE.include?(field.tag)
+
+        updated_marc.fields << field
+      end
+      # explicitly inject the instance_hrid into the 001 field
+      updated_marc.fields << MARC::ControlField.new("001", instance_hrid)
+      # explicitly inject FOLIO into the 003 field
+      updated_marc.fields << MARC::ControlField.new("003", "FOLIO")
+      updated_marc.to_xml.to_s
+    end
   end
 end

data/lib/folio_client/version.rb

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

data/lib/folio_client.rb

@@ -3,8 +3,9 @@
 require "active_support/core_ext/module/delegation"
 require "active_support/core_ext/object/blank"
 require "faraday"
-require "singleton"
+require "marc"
 require "ostruct"
+require "singleton"
 require "zeitwerk"
 
 # Load the gem's internal dependencies: use Zeitwerk instead of needing to manually require classes
@@ -72,10 +73,10 @@ class FolioClient
 
     delegate :config, :connection, :data_import, :default_timeout,
       :edit_marc_json, :fetch_external_id, :fetch_hrid, :fetch_instance_info,
-      :fetch_marc_hash, :get, :has_instance_status?, :http_get_headers,
-      :http_post_and_put_headers, :interface_details, :job_profiles,
-      :organization_interfaces, :organizations, :post, :put, to: :instance
-  end
+      :fetch_marc_hash, :fetch_marc_xml, :get, :has_instance_status?,
+      :http_get_headers, :http_post_and_put_headers, :interface_details,
+      :job_profiles, :organization_interfaces, :organizations, :post, :put, to:
+      :instance end
 
   attr_accessor :config
 
@@ -175,6 +176,13 @@ class FolioClient
       .fetch_marc_hash(...)
   end
 
+  # @see SourceStorage#fetch_marc_xml
+  def fetch_marc_xml(...)
+    SourceStorage
+      .new(self)
+      .fetch_marc_xml(...)
+  end
+
   # @see Inventory#has_instance_status?
   def has_instance_status?(...)
     Inventory

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: folio_client
 version: !ruby/object:Gem::Version
-  version: 0.12.0
+  version: 0.13.0
 platform: ruby
 authors:
 - Peter Mangiafico
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-09-22 00:00:00.000000000 Z
+date: 2023-10-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -187,6 +187,7 @@ files:
 - LICENSE
 - README.md
 - Rakefile
+- api_test.rb
 - folio_client.gemspec
 - lib/folio_client.rb
 - lib/folio_client/authenticator.rb
@@ -220,7 +221,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.7
+rubygems_version: 3.4.19
 signing_key:
 specification_version: 4
 summary: Interface for interacting with the Folio ILS API.