pennmarc 1.2.14 → 1.2.19

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e25cd42397f1b6d4da3dcef75c21eba21de3fdeefa61fcc99496665e03069f46
-  data.tar.gz: f393d5264264be23afc4ca02d0053fbc0ee6aef9a59505c3e366f7c1619c6e34
+  metadata.gz: 000b00c70e9c8d7e21a755f490a167aab853654d6c709cf53081607e9053ead2
+  data.tar.gz: 17fcc4f50b4fd28843e318e63a152759fec88d0efc4b3ccb8af2aabfb8ab7e1d
 SHA512:
-  metadata.gz: b4b734468602dab1e0ad2ecdcd818ad454fe6c2a85274070e733756f3ad1224df793acf2ad94bc63c2b3a707bba3ec7bb40525972e18c9bcdeed941dd822fc80
-  data.tar.gz: 3622b464b9f48c8523548833ba9d3bb97bf129feb27880f44e19629569ef41172ed655e1d21a64d25b8f222404a6382ce95986604389c3414849602112bcd6c4
+  metadata.gz: '009d28e75c876d7d83d2a3834d494cb24eee0ce00ef6d172ce1f16e858af2aba23f0c65837a46907a2ae3c3d71237711789553604614a9a470fae79fae47e0a2'
+  data.tar.gz: 38a430b6eb4bbbdad006d57175dce8c830ef3cf0e1a3732a096e313bb08803e3b178e023fe7da2e5be84ee1a420bd28b527e77583cfed41420034e86acc4210d

data/.pipeline.yml

@@ -1,8 +1,11 @@
 include:
-  - project: "devops/gitlab/ci-templates/general"
-    file:
-      - ".install_hashicorp_vault.yml"
-      - ".vault_jwt_auth.yml"
+  - component: gitlab.library.upenn.edu/devops/gitlab/components/general/install_hashicorp_vault@~latest
+  - component: gitlab.library.upenn.edu/devops/gitlab/components/general/vault_jwt_auth@~latest
+    inputs:
+        vault_addr: ${VAULT_ADDR}
+        vault_auth_path: ${VAULT_AUTH_PATH}
+        vault_auth_role: ${VAULT_AUTH_ROLE}
+
   - project: "devops/gitlab/ci-templates/ruby"
     ref: "sans-dind"
     file:
@@ -38,18 +41,20 @@ rubocop_app_test:
 gem_publication:
   stage: deploy
   image: ruby:3.2.2
+  extends:
+    - .vault_jwt_auth
   variables:
     GEMSPEC_FILE: "${CI_PROJECT_NAME}.gemspec"
   before_script:
     - !reference [.install_hashicorp_vault, before_script]
     - !reference [.vault_jwt_auth, before_script]
+  script:
     - export GEM_HOST_API_KEY="$(vault kv get -field=rubygems_api_key ${VAULT_KV_ENDPOINT}${ENVIRONMENT})"
     - |
       gem -v
       rm -f ./*.gem
       [ -f "${GEMSPEC_FILE}" ] || (echo "No ${GEMSPEC_FILE} file found!" && exit 1)
     - '[ -n "${GEM_HOST_API_KEY}" ] || (echo "GEM_HOST_API_KEY is not set!" && exit 1)'
-  script:
     - GEM_FILE=$(echo "${CI_PROJECT_NAME}-${CI_COMMIT_TAG:1}.gem")
     - |
       gem build "${GEMSPEC_FILE}"

data/lib/pennmarc/encoding_level.rb

@@ -1,11 +1,10 @@
 # frozen_string_literal: true
 
-# MARC encoding level
-# See: https://www.oclc.org/bibformats/en/fixedfield/elvl.html
-# Not sure how this is used
+# MARC {https://www.oclc.org/bibformats/en/fixedfield/elvl.html encoding level values} and a means of ranking them.
+# See the `EncodingRank` helper for usage.
 module PennMARC
   module EncodingLevel
-    # Official MARC codes (https://www.loc.gov/marc/bibliographic/bdleader.html)
+    # {https://www.loc.gov/marc/bibliographic/bdleader.html Official MARC codes}
     FULL = ' '
     FULL_NOT_EXAMINED = '1'
     UNFULL_NOT_EXAMINED = '2'
@@ -17,7 +16,8 @@ module PennMARC
     UNKNOWN = 'u'
     NOT_APPLICABLE = 'z'
 
-    # OCLC extension codes (https://www.oclc.org/bibformats/en/fixedfield/elvl.html)
+    # {https://www.oclc.org/bibformats/en/fixedfield/elvl.html OCLC extension codes}. These are deprecated but still
+    # found in our records.
     OCLC_FULL = 'I'
     OCLC_MINIMAL = 'K'
     OCLC_BATCH_LEGACY = 'L'
@@ -27,9 +27,9 @@ module PennMARC
     RANK = {
       # top 4 (per nelsonrr), do not differentiate among "good" records
       FULL => 0,
-      FULL_NOT_EXAMINED => 0, # 1
-      OCLC_FULL => 0, # 2
-      CORE => 0, # 3
+      FULL_NOT_EXAMINED => 0,
+      OCLC_FULL => 0,
+      CORE => 0,
       UNFULL_NOT_EXAMINED => 4,
       ABBREVIATED => 5,
       PRELIMINARY => 6,

data/lib/pennmarc/helpers/encoding_rank.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module PennMARC
+  # Extract encoding level and provide an opinionated rating of the encoding level
+  class EncodingRank < Helper
+    class << self
+      LEADER_POSITION = 17
+
+      # Return a value corresponding to the {https://www.oclc.org/bibformats/en/fixedfield/elvl.html encoding level}
+      # from the MARC leader. Lower numbers indicate a higher level of description. See {PennMARC::EncodingLevel} for
+      # hash that determines the ranking. We still consider some "legacy" OCLC non-numeric codes here, though they are
+      # no longer recommended for use by OCLC. If an invalid value is found, nil is returned.
+      # @param [MARC::Record] record
+      # @return [Integer, nil]
+      def sort(record:)
+        EncodingLevel::RANK[
+          record.leader[LEADER_POSITION]
+        ]
+      end
+    end
+  end
+end

data/lib/pennmarc/helpers/helper.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require_relative '../encoding_level'
 require_relative '../enriched'
 require_relative '../mappers'
 require_relative '../util'

data/lib/pennmarc/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module PennMARC
-  VERSION = '1.2.14'
+  VERSION = '1.2.19'
 end

data/spec/lib/pennmarc/helpers/encoding_rank_spec.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+describe 'PennMARC::EncodingRank' do
+  let(:helper) { PennMARC::EncodingRank }
+
+  describe '.sort' do
+    let(:record) { marc_record leader: leader }
+    let(:result) { helper.sort record: record }
+    let(:leader) { "                 #{level}     " }
+
+    context 'with an empty value' do
+      let(:level) { PennMARC::EncodingLevel::FULL }
+
+      it 'returns 0' do
+        expect(result).to eq 0
+      end
+    end
+
+    context 'with an official MARC code present' do
+      let(:level) { PennMARC::EncodingLevel::MINIMAL }
+
+      it 'returns 7' do
+        expect(result).to eq 7
+      end
+    end
+
+    context 'with an OCLC extension code' do
+      let(:level) { PennMARC::EncodingLevel::OCLC_BATCH }
+
+      it 'returns 9' do
+        expect(result).to eq 9
+      end
+    end
+
+    context 'with an unhandled value' do
+      let(:level) { 'T' }
+
+      it 'returns nil' do
+        expect(result).to be_nil
+      end
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pennmarc
 version: !ruby/object:Gem::Version
-  version: 1.2.14
+  version: 1.2.19
 platform: ruby
 authors:
 - Mike Kanning
@@ -12,7 +12,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-05-19 00:00:00.000000000 Z
+date: 2025-06-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -114,6 +114,7 @@ files:
 - lib/pennmarc/helpers/database.rb
 - lib/pennmarc/helpers/date.rb
 - lib/pennmarc/helpers/edition.rb
+- lib/pennmarc/helpers/encoding_rank.rb
 - lib/pennmarc/helpers/format.rb
 - lib/pennmarc/helpers/genre.rb
 - lib/pennmarc/helpers/helper.rb
@@ -155,6 +156,7 @@ files:
 - spec/lib/pennmarc/helpers/database_spec.rb
 - spec/lib/pennmarc/helpers/date_spec.rb
 - spec/lib/pennmarc/helpers/edition_spec.rb
+- spec/lib/pennmarc/helpers/encoding_rank_spec.rb
 - spec/lib/pennmarc/helpers/format_spec.rb
 - spec/lib/pennmarc/helpers/genre_spec.rb
 - spec/lib/pennmarc/helpers/identifer_spec.rb