pennmarc 1.2.18 → 1.2.19

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bfe99e899e8bbe77d66ef712bfae42563177050a1ba756b04a0fa41a11b12397
-  data.tar.gz: 9a48e8add493cc6b95d2c621c4f6d70cdd1a2844e480be7b8484dc8dadcdef77
+  metadata.gz: 000b00c70e9c8d7e21a755f490a167aab853654d6c709cf53081607e9053ead2
+  data.tar.gz: 17fcc4f50b4fd28843e318e63a152759fec88d0efc4b3ccb8af2aabfb8ab7e1d
 SHA512:
-  metadata.gz: a90ae9991af5501ed84fa8fa0be396426d1ef33a63acb4118828a4480620f4a3b4abbe06314fedfbd03c67cddc3b64fb32530074c55e4a97bf98141c6b798b73
-  data.tar.gz: 7e5cc458a8cacaaecad970e74fb6e0c381b847973e15e465cd84f3a855f89cf16def85a4cb824a4ef2b19d2361c2ae191de5846cf37e9db4bde18be606e925b8
+  metadata.gz: '009d28e75c876d7d83d2a3834d494cb24eee0ce00ef6d172ce1f16e858af2aba23f0c65837a46907a2ae3c3d71237711789553604614a9a470fae79fae47e0a2'
+  data.tar.gz: 38a430b6eb4bbbdad006d57175dce8c830ef3cf0e1a3732a096e313bb08803e3b178e023fe7da2e5be84ee1a420bd28b527e77583cfed41420034e86acc4210d

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.18'
+  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.18
+  version: 1.2.19
 platform: ruby
 authors:
 - Mike Kanning
@@ -12,7 +12,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-06-03 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