cocina_display 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 68f245cc22043da571e4a9abf0f0fedd613fc19035c4a50369b95400c76573b5
-  data.tar.gz: 86de10bbfcabc44d23d9b3df480eb6b3f0d28b358c9f4fece1ece089cf5cca20
+  metadata.gz: 7faaded226886ab37cfbff854b64721c55964959089a1675706ae6160d4a1a5c
+  data.tar.gz: 111b995bfdf70805eb7a613bf5f221bacf101be1ed3f9ad6fb2407266c7a35ab
 SHA512:
-  metadata.gz: 9ea9ac44480ac83533704c06705f0f6f078ac4065b27756cea527f4110ab99b3bafcfcf525097368005e89534bed78a8bb17a81cb96dc1c48c479a5052b877f6
-  data.tar.gz: 3600cc57ec5e162cb39e2547fa09c9dc7aadc87742146649a0c9d3427ad6c8a2eede1357103af6d4cab531e51d93136a69f075de0995c86daaf471fac2ff08c7
+  metadata.gz: 6a8586d41059d8880ac29c48f564907a51b718dc7812f2314e564032e1f19722d97620755cd53f52aa927e17e45dbfab79b56936c022255f2c22c3147e2c110c
+  data.tar.gz: 58ddd5de3cfe25d78904c24c1edaed72d4212eb7149b58b3b6e5c216390db75acc0c8ad81c039c9c712da99480842df2cab27c70573c848e2cb9377f0a31b909

data/lib/cocina_display/cocina_record.rb

@@ -16,6 +16,7 @@ require_relative "concerns/subjects"
 require_relative "concerns/forms"
 require_relative "concerns/languages"
 require_relative "concerns/geospatial"
+require_relative "concerns/structural"
 require_relative "utils"
 
 module CocinaDisplay
@@ -30,6 +31,7 @@ module CocinaDisplay
     include CocinaDisplay::Concerns::Forms
     include CocinaDisplay::Concerns::Languages
     include CocinaDisplay::Concerns::Geospatial
+    include CocinaDisplay::Concerns::Structural
 
     # Fetch a public Cocina document from PURL and create a CocinaRecord.
     # @note This is intended to be used in development or testing only.
@@ -109,16 +111,27 @@ module CocinaDisplay
       content_type == "collection"
     end
 
-    # Traverse nested FileSets and return an enumerator over their files.
-    # Each file is a +Hash+.
-    # @return [Enumerator] Enumerator over file hashes
-    # @example
-    #  record.files.each do |file|
-    #   puts file["filename"] #=> "image1.jpg"
-    #   puts file["size"] #=> 123456
-    #  end
-    def files
-      path("$.structural.contains.*.structural.contains[*]")
+    # Resources related to the object.
+    # @return [Array<CocinaDisplay::RelatedResource>]
+    def related_resources
+      @related_resources ||= path("$.description.relatedResource[*]").map { |res| RelatedResource.new(res) }
+    end
+  end
+
+  # A resource related to the record; behaves like a CocinaRecord.
+  # @note Related resources have no structural metadata.
+  class RelatedResource < CocinaRecord
+    # Description of the relation to the source record.
+    # @return [String]
+    # @example "is part of"
+    # @see https://github.com/sul-dlss/cocina-models/blob/main/docs/description_types.md#relatedresource-types
+    attr_reader :type
+
+    # Restructure the hash so that everything is under "description" key, since
+    # it's all descriptive metadata. This makes CocinaRecord methods work.
+    def initialize(cocina_doc)
+      @type = cocina_doc["type"]
+      @cocina_doc = {"description" => cocina_doc.except("type")}
     end
   end
 end

data/lib/cocina_display/concerns/structural.rb

@@ -0,0 +1,41 @@
+require "active_support/number_helper/number_to_human_size_converter"
+
+module CocinaDisplay
+  module Concerns
+    # Methods for inspecting structural metadata (e.g. file hierarchy)
+    module Structural
+      # Structured data for all individual files in the object.
+      # Traverses nested FileSet structure to return a flattened array.
+      # @return [Array<Hash>]
+      # @example
+      #  record.files.each do |file|
+      #   puts file["filename"] #=> "image1.jpg"
+      #   puts file["size"] #=> 123456
+      #  end
+      def files
+        @files ||= path("$.structural.contains.*.structural.contains.*").search
+      end
+
+      # All unique MIME types of files in this object.
+      # @return [Array<String>]
+      # @example ["image/jpeg", "application/pdf"]
+      def file_mime_types
+        files.pluck("hasMimeType").uniq
+      end
+
+      # Human-readable string representation of {total_file_size_int}.
+      # @return [String]
+      # @example "2.5 MB"
+      def total_file_size_str
+        ActiveSupport::NumberHelper.number_to_human_size(total_file_size_int)
+      end
+
+      # Summed size of all files in bytes.
+      # @return [Integer]
+      # @example 2621440
+      def total_file_size_int
+        files.pluck("size").sum
+      end
+    end
+  end
+end

data/lib/cocina_display/contributors/contributor.rb

@@ -63,6 +63,12 @@ module CocinaDisplay
         roles.any?(&:publisher?)
       end
 
+      # Does this contributor have a role that indicates they are a funder?
+      # @return [Boolean]
+      def funder?
+        roles.any?(&:funder?)
+      end
+
       # Does this contributor have any roles defined?
       # @return [Boolean]
       def role?
@@ -77,6 +83,20 @@ module CocinaDisplay
         names.map { |name| name.to_s(with_date: with_date) }.first
       end
 
+      # The full forename for the contributor from the first available name.
+      # @see Contributor::Name::forename_str
+      # @return [String, nil]
+      def forename
+        names.map(&:forename_str).first.presence
+      end
+
+      # The full surname for the contributor from the first available name.
+      # @see Contributor::Name::surname_str
+      # @return [String, nil]
+      def surname
+        names.map(&:surname_str).first.presence
+      end
+
       # A string representation of the contributor's roles, formatted for display.
       # If there are multiple roles, they are joined with commas.
       # @return [String]

data/lib/cocina_display/contributors/name.rb

@@ -37,8 +37,6 @@ module CocinaDisplay
         end
       end
 
-      private
-
       # The full name as a string, combining all name components and terms of address.
       # @return [String]
       def full_name_str
@@ -56,33 +54,35 @@ module CocinaDisplay
       # Otherwise, fall back to any names explicitly marked as "name" or untyped.
       # @return [Array<String>]
       def name_components
-        [surname_str, forename_ordinal_str].compact_blank.presence || Array(name_values["name"])
+        [surname_str, forename_str].compact_blank.presence || Array(name_values["name"])
       end
 
-      # Flatten all forenames and ordinals into a single string.
+      # Flatten all terms of address into a comma-delimited string.
       # @return [String]
-      def forename_ordinal_str
-        Utils.compact_and_join(Array(name_values["forename"]) + Array(name_values["ordinal"]), delimiter: " ")
+      def terms_of_address_str
+        Utils.compact_and_join(Array(name_values["term of address"]), delimiter: ", ")
       end
 
-      # Flatten all terms of address into a single string.
+      # Flatten all forename values and ordinals into a whitespace-delimited string.
       # @return [String]
-      def terms_of_address_str
-        Utils.compact_and_join(Array(name_values["term of address"]), delimiter: ", ")
+      def forename_str
+        Utils.compact_and_join(Array(name_values["forename"]) + Array(name_values["ordinal"]), delimiter: " ")
       end
 
-      # Flatten all surnames into a single string.
+      # Flatten all surname values into a whitespace-delimited string.
       # @return [String]
       def surname_str
         Utils.compact_and_join(Array(name_values["surname"]), delimiter: " ")
       end
 
-      # Flatten all life and activity dates into a single string.
+      # Flatten all life and activity dates into a comma-delimited string.
       # @return [String]
       def dates_str
         Utils.compact_and_join(Array(name_values["life dates"]) + Array(name_values["activity dates"]), delimiter: ", ")
       end
 
+      private
+
       # A hash mapping destructured name types to their values.
       # Name values with no type are grouped under "name".
       # @return [Hash<String, Array<String>>]

data/lib/cocina_display/contributors/role.rb

@@ -30,7 +30,7 @@ module CocinaDisplay
       # Does this role indicate the contributor is an author?
       # @return [Boolean]
       def author?
-        to_s =~ /^(author|creator)/i
+        to_s =~ /^(author|creator|primary investigator)/i
       end
 
       # Does this role indicate the contributor is a publisher?
@@ -39,6 +39,12 @@ module CocinaDisplay
         to_s =~ /^publisher/i
       end
 
+      # Does this role indicate the contributor is a funder?
+      # @return [Boolean]
+      def funder?
+        to_s =~ /^funder/i
+      end
+
       private
 
       # Does this role have a MARC relator code?

data/lib/cocina_display/version.rb

@@ -2,5 +2,5 @@
 
 # :nodoc:
 module CocinaDisplay
-  VERSION = "1.0.0" # :nodoc:
+  VERSION = "1.1.0" # :nodoc:
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cocina_display
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Nick Budak
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-08-08 00:00:00.000000000 Z
+date: 2025-08-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: janeway-jsonpath
@@ -219,6 +219,7 @@ files:
 - lib/cocina_display/concerns/geospatial.rb
 - lib/cocina_display/concerns/identifiers.rb
 - lib/cocina_display/concerns/languages.rb
+- lib/cocina_display/concerns/structural.rb
 - lib/cocina_display/concerns/subjects.rb
 - lib/cocina_display/concerns/titles.rb
 - lib/cocina_display/contributors/contributor.rb