mods_display 1.2.1 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c13877b6d0839a4341a26072d23f3e31ed3d27e173f05bb0b1cbbc6e5c0d77b1
-  data.tar.gz: d99b93bfb31352d75299990cea5810ce6668c06035fa5aa90d4ffd3f4fb31f0d
+  metadata.gz: 7e56a492203162fcc4977642c25ae1480279abb98addbb8b37fc89c5d508ec1b
+  data.tar.gz: f2b56fb5a9273fc3ae27aac611737d80adc0d825c29aada98377468697912c17
 SHA512:
-  metadata.gz: 281488c21b60e419dc943a7af91a08f0ab32c4ba92e6ed276b1c86ab0b64722c87a4915f81b482e25c968ecc3855da7736b2b699a0dc6534635bf1822cf73ab1
-  data.tar.gz: cebd18e35b4c81f9ac2dc3d2251a1bf9f8af7e2d9d36e1adc0561e33c48c5ca05faf057f8cd8df1943294aebd2a70914c9a25d7cf893e6aff3dd2e08061057af
+  metadata.gz: 52c2b74b30ddf95a6c04ec094ff3c9f064c7282898030f0d81507bebbf8eb45babc9f80edd9e4ef3e0149a1ae730519cb45eff174b6f39cae2f06768c9fe893c
+  data.tar.gz: b5ddfbde80b819cf3eed221e9d338e1526ca42ebc4289125cdfb34a07632da0e28a71920690e17f7c25c766997730deb24b50b5a03a0a206ab101781917119cb

data/lib/mods_display/fields/imprint.rb

@@ -39,163 +39,20 @@ module ModsDisplay
       end
     end
 
-    def date_values(element)
-      date_field_keys.map do |date_field|
-        next unless element.respond_to?(date_field)
+    def date_values(element, date_field_keys: %i[dateCreated dateCaptured dateValid dateModified copyrightDate])
+      imprint = Stanford::Mods::Imprint.new(element)
 
-        elements = element.send(date_field)
-        next if elements.empty?
+      date_field_keys.map do |date_field|
+        date_values = imprint.dates([date_field])
+        next if date_values.empty?
 
         ModsDisplay::Values.new(
-          label: displayLabel(element) || pub_info_labels[elements.first.name.to_sym],
-          values: parse_dates(elements)
+          label: displayLabel(element) || pub_info_labels[date_field],
+          values: select_the_best_date(date_values)
         )
       end.compact
     end
 
-    class DateValue
-        attr_reader :value
-        delegate :text, :date, :point, :qualifier, :encoding, to: :value
-
-        def initialize(value)
-          @value = value
-        end
-
-        # True if the element text isn't blank or the placeholder "9999".
-        def valid?
-          text.present? && !['9999', '0000-00-00', 'uuuu'].include?(text.strip)
-        end
-
-        # Element text reduced to digits and hyphen. Captures date ranges and
-        # negative (BCE) dates. Used for comparison/deduping.
-        def base_value
-          if text =~ /^\[?1\d{3}-\d{2}\??\]?$/
-            return text.sub(/(\d{2})(\d{2})-(\d{2})/, '\1\2-\1\3')
-          end
-
-          text.gsub(/(?<![\d])(\d{1,3})([xu-]{1,3})/i) { "#{$1}#{'0' * $2.length}"}.scan(/[\d-]/).join
-        end
-
-        # Decoded version of the date, if it was encoded. Strips leading zeroes.
-        def decoded_value
-          return text.strip unless date
-
-          unless encoding.present?
-            return text.strip unless text =~ /^-?\d+$/ || text =~ /^[\dXxu?-]{4}$/
-          end
-
-          # Delegate to the appropriate decoding method, if any
-          case value.precision
-          when :day
-            date.strftime('%B %e, %Y')
-          when :month
-            date.strftime('%B %Y')
-          when :year
-            year = date.year
-            if year < 1
-              "#{year.abs + 1} BCE"
-            # Any dates before the year 1000 are explicitly marked CE
-            elsif year > 1 && year < 1000
-              "#{year} CE"
-            else
-              year.to_s
-            end
-          when :century
-            return "#{(date.to_s[0..1].to_i + 1).ordinalize} century"
-          when :decade
-            return "#{date.year}s"
-          else
-            text.strip
-          end
-        end
-
-        # Decoded date with "BCE" or "CE" and qualifier markers. See (outdated):
-        # https://consul.stanford.edu/display/chimera/MODS+display+rules#MODSdisplayrules-3b.%3CoriginInfo%3E
-        def qualified_value
-          date = decoded_value
-
-          return "[ca. #{date}]" if qualifier == 'approximate'
-          return "[#{date}?]" if qualifier == 'questionable'
-          return "[#{date}]" if qualifier == 'inferred'
-
-          date
-        end
-      end
-
-      class DateRange
-        def initialize(start: nil, stop: nil)
-          @start = start
-          @stop = stop
-        end
-
-        # Base value as hyphen-joined string. Used for comparison/deduping.
-        def base_value
-          "#{@start&.base_value}-#{@stop&.base_value}"
-        end
-
-        # Base values as array. Used for comparison/deduping of individual dates.
-        def base_values
-          [@start&.base_value, @stop&.base_value].compact
-        end
-
-        # The encoding value for the start of the range, or stop if not present.
-        def encoding
-          @start&.encoding || @stop&.encoding
-        end
-
-        # Decoded dates with "BCE" or "CE" and qualifier markers applied to
-        # the entire range, or individually if dates differ.
-        def qualified_value
-          if @start&.qualifier == @stop&.qualifier
-            qualifier = @start&.qualifier || @stop&.qualifier
-            date = "#{@start&.decoded_value}-#{@stop&.decoded_value}"
-            return "[ca. #{date}]" if qualifier == 'approximate'
-            return "[#{date}?]" if qualifier == 'questionable'
-            return "[#{date}]" if qualifier == 'inferred'
-
-            date
-          else
-            "#{@start&.qualified_value}-#{@stop&.qualified_value}"
-          end
-        end
-      end
-    def parse_dates(elements)
-      # convert to DateValue objects and keep only valid ones
-      dates = elements.map(&:as_object).flatten.map { |element| DateValue.new(element) }.select(&:valid?)
-
-      # join any date ranges into DateRange objects
-      point, nonpoint = dates.partition(&:point)
-      if point.any?
-        range = DateRange.new(start: point.find { |date| date.point == 'start' },
-                              stop: point.find { |date| date.point == 'end' })
-        nonpoint.unshift(range)
-      end
-      dates = nonpoint
-
-      # ensure dates are unique with respect to their base values
-      dates = dates.group_by(&:base_value).map do |_value, group|
-        group.first if group.one?
-
-        # if one of the duplicates wasn't encoded, use that one. see:
-        # https://consul.stanford.edu/display/chimera/MODS+display+rules#MODSdisplayrules-3b.%3CoriginInfo%3E
-        if group.reject(&:encoding).any?
-          group.reject(&:encoding).first
-
-        # otherwise just randomly pick the last in the group
-        else
-          group.last
-        end
-      end
-
-      # if any single dates are already part of a range, discard them
-      range_base_values = dates.select { |date| date.is_a?(DateRange) }
-                               .map(&:base_values).flatten
-      dates = dates.reject { |date| range_base_values.include?(date.base_value) }
-
-      # output formatted dates with qualifiers, CE/BCE, etc.
-      dates.map(&:qualified_value)
-    end
-
     def other_pub_info(element)
       element.children.select do |child|
         pub_info_parts.include?(child.name.to_sym)
@@ -278,11 +135,14 @@ module ModsDisplay
       compact_and_join_with_delimiter(publishers, ' : ')
     end
 
-    def parts_element(value)
-      date_elements = %w[dateIssued dateOther].map do |date_field_name|
-        next unless value.respond_to?(date_field_name.to_sym)
+    def parts_element(value, date_field_keys: %i[dateIssued dateOther])
+      imprint = Stanford::Mods::Imprint.new(value)
 
-        parse_dates(value.send(date_field_name.to_sym))
+      date_elements = date_field_keys.map do |date_field|
+        date_values = imprint.dates([date_field])
+        next if date_values.empty?
+
+        select_the_best_date(date_values)
       end.flatten.compact.reject do |date|
         date.strip.empty?
       end.map(&:strip)
@@ -293,10 +153,6 @@ module ModsDisplay
       %i[issuance frequency]
     end
 
-    def date_field_keys
-      %i[dateCreated dateCaptured dateValid dateModified copyrightDate]
-    end
-
     def pub_info_labels
       { dateCreated: I18n.t('mods_display.date_created'),
         dateCaptured: I18n.t('mods_display.date_captured'),
@@ -306,5 +162,30 @@ module ModsDisplay
         issuance: I18n.t('mods_display.issuance'),
         frequency: I18n.t('mods_display.frequency') }
     end
+
+    def select_the_best_date(dates)
+      # ensure dates are unique with respect to their base values
+      dates = dates.group_by(&:base_value).map do |_value, group|
+        group.first if group.one?
+
+        # if one of the duplicates wasn't encoded, use that one. see:
+        # https://consul.stanford.edu/display/chimera/MODS+display+rules#MODSdisplayrules-3b.%3CoriginInfo%3E
+        if group.reject(&:encoding).any?
+          group.reject(&:encoding).first
+
+        # otherwise just randomly pick the last in the group
+        else
+          group.last
+        end
+      end
+
+      # if any single dates are already part of a range, discard them
+      range_base_values = dates.select { |date| date.is_a?(Stanford::Mods::Imprint::DateRange) }
+                               .map(&:base_values).flatten
+      dates = dates.reject { |date| range_base_values.include?(date.base_value) }
+
+      # output formatted dates with qualifiers, CE/BCE, etc.
+      dates.map(&:qualified_value)
+    end
   end
 end

data/lib/mods_display/fields/name.rb

@@ -30,6 +30,11 @@ module ModsDisplay
       '<br />'
     end
 
+    # Override of Field#element_text to get text rather than HTML
+    def element_text(element)
+      element.text.strip
+    end
+
     def collapse_roles(fields)
       return [] if fields.blank?
 

data/lib/mods_display/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ModsDisplay
-  VERSION = '1.2.1'
+  VERSION = '1.3.0'
 end

metadata

@@ -1,35 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: mods_display
 version: !ruby/object:Gem::Version
-  version: 1.2.1
+  version: 1.3.0
 platform: ruby
 authors:
 - Jessie Keck
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-07-14 00:00:00.000000000 Z
+date: 2023-02-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: stanford-mods
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 3.0.0.alpha1
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '4'
+        version: '3.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 3.0.0.alpha1
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '4'
+        version: '3.3'
 - !ruby/object:Gem::Dependency
   name: i18n
   requirement: !ruby/object:Gem::Requirement
@@ -226,7 +220,6 @@ files:
 - lib/mods_display/related_item_concerns.rb
 - lib/mods_display/relator_codes.rb
 - lib/mods_display/version.rb
-- mods_display.gemspec
 homepage: https://github.com/sul-dlss/mods_display
 licenses: []
 metadata: {}
@@ -245,7 +238,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.7
+rubygems_version: 3.3.26
 signing_key:
 specification_version: 4
 summary: The MODS Display gem allows implementers to configure a customized display

data/mods_display.gemspec

@@ -1,36 +0,0 @@
-# frozen_string_literal: true
-require_relative "lib/mods_display/version"
-
-Gem::Specification.new do |gem|
-  gem.name          = 'mods_display'
-  gem.version       = ModsDisplay::VERSION
-  gem.authors       = ['Jessie Keck']
-  gem.email         = ['jessie.keck@gmail.com']
-  gem.description   = 'MODS Display is a gem to centralize the display logic of MODS medadata.'
-  gem.summary       = 'The MODS Display gem allows implementers to configure a customized display of MODS metadata.  This display implements the specifications defined at Stanford for how to display MODS.'
-  gem.homepage      = 'https://github.com/sul-dlss/mods_display'
-
-  # Specify which files should be added to the gem when it is released.
-  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
-  gem.files = Dir.chdir(File.expand_path(__dir__)) do
-    `git ls-files -z`.split("\x0").reject do |f|
-      (f == __FILE__) || f.match(%r{\A(?:(?:test|spec|features)/|\.(?:git|travis|circleci)|appveyor)})
-    end
-  end
-  gem.bindir = "exe"
-  gem.executables = gem.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
-  gem.require_paths = ["lib"]
-
-  gem.add_dependency 'stanford-mods', '>= 3.0.0.alpha1', '< 4'
-  gem.add_dependency 'i18n'
-  gem.add_dependency 'view_component'
-
-  gem.add_development_dependency 'rake'
-  gem.add_development_dependency 'rspec', '~> 3.0'
-  gem.add_development_dependency 'rspec-rails'
-  gem.add_development_dependency 'rubocop'
-  gem.add_development_dependency 'capybara'
-  gem.add_development_dependency 'byebug'
-  gem.add_development_dependency 'rails', ENV['RAILS_VERSION'] || '~> 6.0'
-  gem.add_development_dependency 'combustion', '~> 1.3'
-end