neu-mods 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ab1cb07bf4122e98017ded99c790824865f68fb8ccdfdcbb3b5fc8e7d72cbf55
-  data.tar.gz: 6d3b467da6fde096e0ea26f9e76c447ea24c563c6cc5fd1a47e06b8f18d72aca
+  metadata.gz: 4271827888541fa8ae2c61c52a6d3d73b79c7ee3ae3ae114ba391e3aae5e16a5
+  data.tar.gz: a59905f08b0092b40ade775cf95d846941d210b922aca213b5f1ee7b70ad864d
 SHA512:
-  metadata.gz: 4c9b5a6006cf0ab3faced2d60f49f703ab482f28f2208d39c5225bd7af769c4f6bba634b0808d83d3b5ac3f2210efca07f8b1ad37976e0ed17d1175d666fcccf
-  data.tar.gz: 2c92060d9faddce439bb9b462982fbb186f6d792f5fc86cfa9702a7cf1c2118c06a3236a5e0875c2499e5593083f531a5668c841696168d330c6527728ca56a7
+  metadata.gz: 25775e1c92de8bbc6f730980b1cbf78a5f0c78668ab901fb3c84f62e6ab15986bab6270ef37f511dfac367caa275d901b0cde87490a5b7d6f3338fd75d99415a
+  data.tar.gz: 61726ef704b127856f0fc1f2febe3b35681ffe48b7822a7cbbe1d30a4c8b094071bd681c57a1b3639c09f0ad1f085d4d3d543608fe86a7d2c558fa84ec913dc2

data/.version

@@ -1 +1 @@
-0.1.0
+0.1.1

data/README.md

@@ -34,6 +34,12 @@ doc.topical_subjects # => ["Civil society", ...]   (every <topic>, for the acces
 doc.keywords       # => [...]   (only the editable attribute-free keyword subjects)
 doc.to_h           # => full projection, keyed to Atlas's Metadata::MODS attributes
 
+# Pure title composition (no document needed) — for callers that already hold
+# the parts (e.g. Atlas's access-copy model) and must not re-parse XML on read.
+NEU::MODS.compose_title(non_sort: "", title: "What's New",
+                        part_name: "How We Respond to Disaster", part_number: "Episode 1")
+# => "What's New - How We Respond to Disaster, Episode 1"   (== doc.plain_title)
+
 # Selectors (live nodes — for editing)
 node = doc.primary_title_info.at_xpath("mods:title", NEU::MODS::NAMESPACE)
 node.content = "New Title" unless NEU::MODS.whitespace_equivalent?(node.text, "New Title")

data/lib/neu/mods/projection.rb

@@ -31,13 +31,21 @@ module NEU
       # Composed display title (the former Atlas MODSDecoration#plain_title), driven
       # off the scoped primary title.
       def plain_title
-        p = title_parts
-        return "" if blank?(p[:title])
+        Projection.compose_title(title_parts)
+      end
 
-        "#{p[:non_sort]}#{p[:title]}" +
-          prefix(": ", p[:subtitle]) +
-          prefix(" - ", p[:part_name]) +
-          prefix(", ", p[:part_number])
+      # Pure title composition over a parts hash, factored out of #plain_title so
+      # callers that already hold the parts -- e.g. Atlas's access-copy model --
+      # can compose the display title WITHOUT re-parsing XML on the read path
+      # (reaching for Nokogiri in a decorator is the smell this avoids). Keys:
+      # :non_sort :title :subtitle :part_name :part_number (nil or "" for absent).
+      # Returns "" when there is no title. Exposed as NEU::MODS.compose_title.
+      def self.compose_title(parts)
+        return "" if parts[:title].to_s.strip.empty?
+
+        optional = { ": " => parts[:subtitle], " - " => parts[:part_name], ", " => parts[:part_number] }
+        suffix = optional.filter_map { |sep, val| "#{sep}#{val}" unless val.to_s.strip.empty? }.join
+        "#{parts[:non_sort]}#{parts[:title]}#{suffix}"
       end
 
       # --- Abstract / access ---------------------------------------------------
@@ -176,14 +184,6 @@ module NEU
         v.empty? ? nil : v
       end
 
-      def blank?(str)
-        str.nil? || str.strip.empty?
-      end
-
-      def prefix(sep, val)
-        blank?(val) ? "" : "#{sep}#{val}"
-      end
-
       def join_paragraphs(nodes)
         nodes.map { |n| NEU::MODS.normalize_paragraphs(n.text) }.reject(&:empty?).join("\n\n")
       end

data/lib/neu-mods.rb

@@ -33,5 +33,10 @@ module NEU
     # Curator-freetext normalization for the access copy (see TextNormalizer).
     def normalize(str) = TextNormalizer.normalize(str)
     def normalize_paragraphs(str) = TextNormalizer.normalize_paragraphs(str)
+
+    # Pure display-title composition over a primary-title parts hash (see
+    # Projection.compose_title). Lets a caller that already holds the parts --
+    # e.g. Atlas's access-copy model -- compose the title without parsing XML.
+    def compose_title(parts) = Projection.compose_title(parts)
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: neu-mods
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - David Cliff