relaton-bib 1.14.4 → 1.14.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6d516a0a4756006072259b99674e50cefab3405f8824761c50faeca40bac5c71
-  data.tar.gz: f349fc209e2f2f684e71ad1044b3c23d37dcf905f4852841509f0319bfcd42be
+  metadata.gz: 4a4d2a5d90a56a9b93f34acc0d037d101130c36b34a4d436c28c6dc8c53496eb
+  data.tar.gz: 2b99e61f20b08a6ca48a2b42c16abef7cfe0e9f4340e413d1e37a4ff3e098969
 SHA512:
-  metadata.gz: 99f2a47867468501d678c7b3807eb3be541dfd522ebe5f373b48499b82a3c4095c4bfe572967cd1f871e87b98e58d66c8207dc339a06a91355f25f560b06c4ad
-  data.tar.gz: a69cad9aaee6bd53fb2e17dc55102e2c37738142d6f7a6978d5db3d4524b3b29a276df85ca9feb95567f173dfae6d574c46c2a5da97c771774c8de5de084dd24
+  metadata.gz: 2d1f0ec61452cdc6bdedde4bd1025a2aa9d3baeeeaa65f3e3b212aa56cd2753afee04dccc13870a1bea5e88b388a97e086adea56353272204a49251b46145384
+  data.tar.gz: 880ddde78e8fc665caf7b7a104efecd476c5787d34f839f73a7f1bc70425b6872dcd68bdaa7305fc751eb7cfe6e5c3395fa9df69771bec0634ceccdfdf66f890

data/.rubocop.yml

@@ -7,6 +7,6 @@ require: rubocop-rails
 inherit_from:
   - https://raw.githubusercontent.com/riboseinc/oss-guides/master/ci/rubocop.yml
 AllCops:
-  TargetRubyVersion: 2.6
+  TargetRubyVersion: 2.7
 Rails:
   Enabled: false

data/lib/relaton_bib/bib_item_locality.rb

@@ -62,9 +62,10 @@ module RelatonBib
       when "chapter" then item.chapter = reference_from
       when "page"
         value = reference_from
-        value += "-#{reference_to}" if reference_to
+        value += "--#{reference_to}" if reference_to
         item.pages = value
       when "volume" then item.volume = reference_from
+      when "issue" then item.number = reference_from
       end
     end
   end

data/lib/relaton_bib/bibliographic_item.rb

@@ -151,7 +151,7 @@ module RelatonBib
     # @param series [Array<RelatonBib::Series>]
     # @param medium [RelatonBib::Medium, nil]
     # @param place [Array<String, RelatonBib::Place>]
-    # @param extent [Array<Relaton::Locality, RelatonBib::LocalityStack>]
+    # @param extent [Array<RelatonBib::Locality, RelatonBib::LocalityStack>]
     # @param accesslocation [Array<String>]
     # @param classification [Array<RelatonBib::Classification>]
     # @param validity [RelatonBib:Validity, nil]
@@ -378,13 +378,7 @@ module RelatonBib
     # @return [String, Nokogiri::XML::Builder::NodeBuilder] XML
     #
     def to_bibxml(builder = nil, include_keywords: false)
-      if builder
-        render_bibxml builder, include_keywords
-      else
-        Nokogiri::XML::Builder.new(encoding: "UTF-8") do |xml|
-          render_bibxml xml, include_keywords
-        end.doc.root.to_xml
-      end
+      Renderer::BibXML.new(self).render builder: builder, include_keywords: include_keywords
     end
 
     # @return [Hash]
@@ -448,7 +442,7 @@ module RelatonBib
     # @return [String]
     #
     def to_bibtex(bibtex = nil)
-      bibtext_item(bibtex).to_s
+      Renderer::BibtexBuilder.build(self, bibtex).to_s
     end
 
     #
@@ -459,7 +453,9 @@ module RelatonBib
     # @return [Hash] citeproc
     #
     def to_citeproc(bibtex = nil)
-      bibtext_item(bibtex).to_citeproc.map { |cp| cp.transform_keys(&:to_s) }
+      Renderer::BibtexBuilder.build(self, bibtex).to_citeproc.map do |cp|
+        cp.transform_keys(&:to_s)
+      end
     end
 
     # @param lang [String, nil] language code Iso639
@@ -497,6 +493,8 @@ module RelatonBib
         ttl = me.title.select do |t|
           t.type != "main" && t.title.language&.include?(l)
         end
+        next if ttl.empty?
+
         tm_en = ttl.map { |t| t.title.content }.join " – "
         me.title.detect do |t|
           t.type == "main" && t.title.language&.include?(l)
@@ -590,162 +588,6 @@ module RelatonBib
 
     private
 
-    #
-    # Create BibTeX item for this document
-    #
-    # @param [BibTeX::Bibliography, nil] bibtex <description>
-    #
-    # @return [BibTeX::Bibliography] BibTeX bibliography
-    #
-    def bibtext_item(bibtex) # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength
-      item = BibTeX::Entry.new
-      item.type = bibtex_type
-      item.key = id
-      title.to_bibtex item
-      item.edition = edition.content if edition
-      bibtex_author item
-      bibtex_contributor item
-      item.address = place.first.name if place.any?
-      bibtex_note item
-      bibtex_relation item
-      bibtex_extent item
-      bibtex_date item
-      bibtex_series item
-      bibtex_classification item
-      item.keywords = keyword.map(&:content).join(", ") if keyword.any?
-      bibtex_docidentifier item
-      item.timestamp = fetched.to_s if fetched
-      bibtex_link item
-      bibtex ||= BibTeX::Bibliography.new
-      bibtex << item
-      bibtex
-    end
-
-    # @return [String]
-    def bibtex_type
-      case type
-      when "standard", nil then "misc"
-      else type
-      end
-    end
-
-    # @param [BibTeX::Entry]
-    def bibtex_author(item) # rubocop:disable Metrics/CyclomaticComplexity,Metrics/PerceivedComplexity, Metrics/MethodLength, Metrics/AbcSize
-      authors = contributor.select do |c|
-        c.entity.is_a?(Person) && c.role.map(&:type).include?("author")
-      end.map &:entity
-
-      return unless authors.any?
-
-      item.author = authors.map do |a|
-        if a.name.surname
-          "#{a.name.surname}, #{a.name.forename.map(&:to_s).join(' ')}"
-        else
-          a.name.completename.to_s
-        end
-      end.join " and "
-    end
-
-    # @param [BibTeX::Entry]
-    def bibtex_contributor(item) # rubocop:disable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/MethodLength
-      contributor.each do |c|
-        rls = c.role.map(&:type)
-        if rls.include?("publisher") then item.publisher = c.entity.name
-        elsif rls.include?("distributor")
-          case type
-          when "techreport" then item.institution = c.entity.name
-          when "inproceedings", "conference", "manual", "proceedings"
-            item.organization = c.entity.name
-          when "mastersthesis", "phdthesis" then item.school = c.entity.name
-          end
-        end
-      end
-    end
-
-    # @param [BibTeX::Entry]
-    def bibtex_note(item) # rubocop:disable Metrics/CyclomaticComplexity,Metrics/AbcSize
-      biblionote.each do |n|
-        case n.type
-        when "annote" then item.annote = n.content
-        when "howpublished" then item.howpublished = n.content
-        when "comment" then item.comment = n.content
-        when "tableOfContents" then item.content = n.content
-        when nil then item.note = n.content
-        end
-      end
-    end
-
-    # @param [BibTeX::Entry]
-    def bibtex_relation(item)
-      rel = relation.detect { |r| r.type == "partOf" }
-      if rel
-        title_main = rel.bibitem.title.detect { |t| t.type == "main" }
-        item.booktitle = title_main.title.content
-      end
-    end
-
-    # @param [BibTeX::Entry]
-    def bibtex_extent(item)
-      extent.each { |e| e.to_bibtex(item) }
-    end
-
-    # @param [BibTeX::Entry]
-    def bibtex_date(item)
-      date.each do |d|
-        case d.type
-        when "published"
-          item.year = d.on :year
-          item.month = d.on :month
-        when "accessed" then item.urldate = d.on.to_s
-        end
-      end
-    end
-
-    # @param [BibTeX::Entry]
-    def bibtex_series(item)
-      series.each do |s|
-        case s.type
-        when "journal"
-          item.journal = s.title.title
-          item.number = s.number if s.number
-        when nil then item.series = s.title.title
-        end
-      end
-    end
-
-    # @param [BibTeX::Entry]
-    def bibtex_classification(item)
-      classification.each do |c|
-        case c.type
-        when "type" then item["type"] = c.value
-        # when "keyword" then item.keywords = c.value
-        when "mendeley" then item["mendeley-tags"] = c.value
-        end
-      end
-    end
-
-    # @param [BibTeX::Entry]
-    def bibtex_docidentifier(item)
-      docidentifier.each do |i|
-        case i.type
-        when "isbn" then item.isbn = i.id
-        when "lccn" then item.lccn = i.id
-        when "issn" then item.issn = i.id
-        end
-      end
-    end
-
-    # @param [BibTeX::Entry]
-    def bibtex_link(item)
-      link.each do |l|
-        case l.type
-        when "doi" then item.doi = l.content
-        when "file" then item.file2 = l.content
-        when "src" then item.url = l.content
-        end
-      end
-    end
-
     # @param opts [Hash]
     # @option opts [Nokogiri::XML::Builder] :builder XML builder
     # @option opts [Boolean] bibdata
@@ -811,268 +653,5 @@ module RelatonBib
       xml["schema-version"] = schema unless opts[:embedded]
       xml
     end
-
-    #
-    # Render BibXML (RFC, BCP)
-    #
-    # @param [Nokogiri::XML::Builder] builder
-    # @param [Boolean] include_bibdata
-    #
-    def render_bibxml(builder, include_keywords) # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
-      target = link.detect { |l| l.type.casecmp("src").zero? } ||
-        link.detect { |l| l.type.casecmp("doi").zero? }
-      bxml = if docnumber&.match(/^BCP/) || (docidentifier.detect(&:primary)&.id ||
-                  docidentifier[0].id).include?("BCP")
-               render_bibxml_refgroup(builder, include_keywords)
-             else
-               render_bibxml_ref(builder, include_keywords)
-             end
-      bxml[:target] = target.content.to_s if target
-    end
-
-    #
-    # Render BibXML (BCP)
-    #
-    # @param [Nokogiri::XML::Builder] builder
-    # @param [Boolean] include_keywords
-    #
-    def render_bibxml_refgroup(builder, include_keywords)
-      builder.referencegroup(**ref_attrs) do |b|
-        relation.each do |r|
-          r.bibitem.to_bibxml(b, include_keywords: include_keywords) if r.type == "includes"
-        end
-      end
-    end
-
-    #
-    # Render BibXML (RFC)
-    #
-    # @param [Nokogiri::XML::Builder] builder
-    # @param [Boolean] include_keywords
-    #
-    def render_bibxml_ref(builder, include_keywords) # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength, Metrics/PerceivedComplexity
-      builder.reference(**ref_attrs) do |xml|
-        if title.any? || contributor.any? || date.any? || abstract.any? ||
-            editorialgroup&.technical_committee&.any? ||
-            (include_keywords && keyword.any?)
-          xml.front do
-            xml.title title[0].title.content if title.any?
-            render_authors xml
-            render_date xml
-            render_workgroup xml
-            render_keyword xml if include_keywords
-            render_abstract xml
-          end
-        end
-        render_seriesinfo xml
-        render_format xml
-      end
-    end
-
-    def render_format(builder)
-      link.select { |l| l.type == "TXT" }.each do |l|
-        builder.format type: l.type, target: l.content
-      end
-    end
-
-    #
-    # Create reference attributes
-    #
-    # @return [Hash<Symbol=>String>] attributes
-    #
-    def ref_attrs # rubocop:disable Metrics/AbcSize
-      discopes = %w[anchor docName number]
-      attrs = docidentifier.each_with_object({}) do |di, h|
-        next unless discopes.include?(di.scope)
-
-        h[di.scope.to_sym] = di.id
-      end
-      return attrs if attrs.any?
-
-      docidentifier.first&.tap do |di|
-        anchor = di.type == "IANA" ? di.id.split[1..-1].join(" ").upcase : di.id
-        return { anchor: anchor.gsub(" ", ".") }
-      end
-    end
-
-    #
-    # Render keyword
-    #
-    # @param [Nokogiri::XML::Builder] builder xml builder
-    #
-    def render_keyword(builder)
-      keyword.each { |kw| builder.keyword kw.content }
-    end
-
-    #
-    # Render workgroup
-    #
-    # @param [Nokogiri::XML::Builder] builder xml builder
-    #
-    def render_workgroup(builder)
-      editorialgroup&.technical_committee&.each do |tc|
-        builder.workgroup tc.workgroup.name
-      end
-    end
-
-    #
-    # Render abstract
-    #
-    # @param [Nokogiri::XML::Builder] builder xml builder
-    #
-    def render_abstract(builder)
-      return unless abstract.any?
-
-      builder.abstract { |xml| xml << abstract[0].content.gsub(/(<\/?)p(>)/, '\1t\2') }
-    end
-
-    #
-    # Render date
-    #
-    # @param [Nokogiri::XML::Builder] builder xml builder
-    #
-    def render_date(builder) # rubocop:disable Metrics/AbcSize, Metrics/MethodLength, Metrics/PerceivedComplexity, Metrics/CyclomaticComplexity
-      dt = date.detect { |d| d.type == "published" }
-      return unless dt
-
-      elm = builder.date
-      y = dt.on(:year) || dt.from(:year) || dt.to(:year)
-      elm[:year] = y if y
-      m = dt.on(:month) || dt.from(:month) || dt.to(:month)
-      elm[:month] = Date::MONTHNAMES[m] if m
-      # rfcs = %w[RFC BCP FYI STD]
-      # unless rfcs.include?(doctype) && docidentifier.detect { |di| rfcs.include? di.type }
-      d = dt.on(:day) || dt.from(:day) || dt.to(:day)
-      elm[:day] = d if d
-      # end
-    end
-
-    #
-    # Render seriesinfo
-    #
-    # @param [Nokogiri::XML::Builder] builder xml builder
-    #
-    def render_seriesinfo(builder) # rubocop:disable Metrics/AbcSize, Metrics/MethodLength, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
-      docidentifier.each do |di|
-        if BibXMLParser::SERIESINFONAMES.include? di.type
-          builder.seriesInfo(name: di.type, value: di.id)
-        end
-      end
-      # di_types = docidentifier.map(&:type)
-      series.select do |s|
-        s.title && # !di_types.include?(s.title.title.to_s) &&
-          !BibXMLParser::SERIESINFONAMES.include?(s.title.title.to_s)
-      end.uniq { |s| s.title.title.to_s }.each do |s|
-        si = builder.seriesInfo(name: s.title.title.to_s)
-        si[:value] = s.number if s.number
-      end
-    end
-
-    #
-    # Render authors
-    #
-    # @param [Nokogiri::XML::Builder] builder xml builder
-    #
-    def render_authors(builder) # rubocop:disable Metrics/AbcSize
-      contributor.each do |c|
-        builder.author do |xml|
-          xml.parent[:role] = "editor" if c.role.detect { |r| r.type == "editor" }
-          if c.entity.is_a?(Person) then render_person xml, c.entity
-          else render_organization xml, c.entity, c.role
-          end
-          render_address xml, c
-        end
-      end
-    end
-
-    #
-    # Render address
-    #
-    # @param [Nokogiri::XML::Builder] builder xml builder
-    # @param [RelatonBib::ContributionInfo] contrib contributor
-    #
-    def render_address(builder, contrib) # rubocop:disable Metrics/AbcSize, Metrics/MethodLength, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
-      # addr = contrib.entity.contact.reject do |cn|
-      #   cn.is_a?(Address) && cn.postcode.nil?
-      # end
-      if contrib.entity.contact.any?
-        builder.address do |xml|
-          address = contrib.entity.contact.detect { |cn| cn.is_a? Address }
-          if address
-            xml.postal do
-              xml.city address.city if address.city
-              xml.code address.postcode if address.postcode
-              xml.country address.country if address.country
-              xml.region address.state if address.state
-              xml.street address.street[0] if address.street.any?
-            end
-          end
-          render_contact xml, contrib.entity.contact
-        end
-      end
-    end
-
-    #
-    # Render contact
-    #
-    # @param [Nokogiri::XML::Builder] builder xml builder
-    # @param [Array<RelatonBib::Address, RelatonBib::Contact>] addr contact
-    #
-    def render_contact(builder, addr)
-      %w[phone email uri].each do |type|
-        cont = addr.detect { |cn| cn.is_a?(Contact) && cn.type == type }
-        builder.send type, cont.value if cont
-      end
-    end
-
-    #
-    # Render person
-    #
-    # @param [Nokogiri::XML::Builder] builder xml builder
-    # @param [RelatonBib::Person] person person
-    #
-    def render_person(builder, person) # rubocop:disable Metrics/AbcSize, Metrics/MethodLength, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
-      render_organization builder, person.affiliation.first&.organization
-      if person.name.completename
-        builder.parent[:fullname] = person.name.completename.content
-      elsif person.name.forename.any?
-        builder.parent[:fullname] = person.name.forename.map do |n|
-          n.content || n.initial
-        end.join " "
-      end
-      if person.name.initials
-        builder.parent[:initials] = person.name.initials.content
-      elsif person.name.forename.any?
-        builder.parent[:initials] = person.name.forename.map do |f|
-          "#{f.initial || f.content[0]}."
-        end.join
-      end
-      if person.name.surname
-        if !person.name.completename && person.name.forename.any? && person.name.surname
-          builder.parent[:fullname] += " #{person.name.surname}"
-        end
-        builder.parent[:surname] = person.name.surname.content
-      end
-    end
-
-    #
-    # Render organization
-    #
-    # @param [Nokogiri::XML::Builder] builder xml builder
-    # @param [RelatonBib::Organization] org organization
-    #
-    def render_organization(builder, org, _role = []) # rubocop:disable Metrics/PerceivedComplexity, Metrics/CyclomaticComplexity, Metrics/MethodLength, Metrics/AbcSize
-      abbrev = org&.abbreviation&.content
-      orgname = org&.name&.first&.content
-      orgname = if BibXMLParser::ORGNAMES.key?(abbrev) then abbrev
-                else BibXMLParser::ORGNAMES.key(orgname) || orgname || abbrev
-                end
-      # if role.detect { |r| r.description.detect { |d| d.content == "BibXML author" } }
-      #   builder.parent[:fullname] = orgname
-      # else
-      org = builder.organization orgname
-      org[:abbrev] = abbrev if abbrev
-      # end
-    end
   end
 end

data/lib/relaton_bib/bibtex_parser.rb

@@ -2,6 +2,7 @@ require "bibtex"
 require "iso639"
 
 module RelatonBib
+  # @todo: move this class to the RelatonBib::Bibtex module
   class BibtexParser
     class << self
       # @param bibtex [String]

data/lib/relaton_bib/forename.rb

@@ -1,6 +1,6 @@
 module RelatonBib
   class Forename < LocalizedString
-    # @return [RelatonBib::Forename] forename
+    # @return [String, nil]
     attr_accessor :initial
 
     #

data/lib/relaton_bib/formatted_string.rb

@@ -122,7 +122,7 @@ module RelatonBib
       str.gsub(/(?<=<)\w+:(?=\w+>)/, "").gsub(/(?<=<\/)\w+:(?=\w+>)/, "")
         .gsub(/<i>/, "<em>").gsub(/<\/i>/, "</em>")
         .gsub(/<b>/, "<strong>").gsub(/<\/b>/, "</strong>")
-        .gsub(/<(?!\/?(em|strong|stem|sup|sub|tt|br\s?\/|p))[^\s!]\/?.*?>/, " ")
+        .gsub(/<(?!\/?(em|strong|stem|sup|sub|tt|br\s?\/|p))[^\s!]\/?.*?>/, "")
         .gsub(/\s+([.,:;!?<])/, "\\1").strip
     end
   end

data/lib/relaton_bib/hash_converter.rb

@@ -282,7 +282,7 @@ module RelatonBib
         return [] unless person[:affiliation]
 
         RelatonBib.array(person[:affiliation]).map do |a|
-          a[:description] = RelatonBib.array(a[:description])&.map do |d|
+          a[:description] = RelatonBib.array(a[:description]).map do |d|
             cnt = if d.is_a?(Hash)
                     { content: d[:content], language: d[:language],
                       script: d[:script], format: d[:format] }
@@ -323,7 +323,9 @@ module RelatonBib
         return unless ret[:copyright]
 
         ret[:copyright] = RelatonBib.array(ret[:copyright]).map do |c|
-          c[:owner] = RelatonBib.array(c[:owner])
+          c[:owner] = RelatonBib.array(c[:owner]).map do |o|
+            org_hash_to_bib(o)
+          end
           c
         end
       end

data/lib/relaton_bib/hit.rb

@@ -1,3 +1,5 @@
+require "weakref"
+
 module RelatonBib
   class Hit
     # @return [RelatonBib::HitCollection]
@@ -10,7 +12,7 @@ module RelatonBib
     # @param hit_collection [RelatonBib::HitCollection]
     def initialize(hit, hit_collection = nil)
       @hit            = hit
-      @hit_collection = hit_collection
+      @hit_collection = WeakRef.new hit_collection if hit_collection
     end
 
     # @return [String]

data/lib/relaton_bib/medium.rb

@@ -11,7 +11,7 @@ module RelatonBib
     # @param form [String, nil] form of the medium
     # @param carrier [String, nil] carrier of the medium
     # @param size [String, nil] size of the medium
-    # @param scale [String, nil] 
+    # @param scale [String, nil]
     #
     def initialize(**args)
       @content = args[:content]

data/lib/relaton_bib/renderer/bibtex_builder.rb

@@ -0,0 +1,312 @@
+# Monkey patch to fix the issue with month quotes in BibTeX
+module BibTeX
+  class Value
+    def to_s(options = {}) # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
+      if options.key?(:filter)
+        opts = options.reject { |k,| k == :filter || (k == :quotes && (!atomic? || symbol?)) }
+        return convert(options[:filter]).to_s(opts)
+      end
+
+      return value.to_s unless options.key?(:quotes) && atomic?
+
+      q = Array(options[:quotes])
+      [q[0], value, q[-1]].compact.join
+    end
+  end
+end
+
+module RelatonBib
+  # BibTeX builder.
+  module Renderer
+    class BibtexBuilder
+      ATTRS = %i[
+        type id title author editor booktitle series number edition contributor
+        date address note relation extent classification keyword docidentifier
+        timestamp link
+      ].freeze
+
+      #
+      # Build BibTeX bibliography.
+      #
+      # @param bib [RelatonBib::BibliographicItem]
+      # @param bibtex [BibTeX::Bibliography, nil] BibTeX bibliography
+      #
+      # @return [BibTeX::Bibliography] BibTeX bibliography
+      #
+      def self.build(bib, bibtex = nil)
+        new(bib).build bibtex
+      end
+
+      #
+      # Initialize BibTeX builder.
+      #
+      # @param bib [RelatonBib::BibliographicItem]
+      def initialize(bib)
+        @bib = bib
+      end
+
+      #
+      # Build BibTeX bibliography.
+      #
+      # @param bibtex [BibTeX::Bibliography, nil] BibTeX bibliography
+      #
+      # @return [BibTeX::Bibliography] BibTeX bibliography
+      #
+      def build(bibtex = nil)
+        @item = BibTeX::Entry.new
+        ATTRS.each { |a| send("add_#{a}") }
+        bibtex ||= BibTeX::Bibliography.new
+        bibtex << @item
+        bibtex
+      end
+
+      private
+
+      #
+      # Add type to BibTeX item
+      #
+      def add_type
+        @item.type = bibtex_type
+      end
+
+      # @return [String] BibTeX type
+      def bibtex_type
+        case @bib.type
+        when "standard", nil then "misc"
+        else @bib.type
+        end
+      end
+
+      #
+      # Add ID to BibTeX item
+      #
+      def add_id
+        @item.key = @bib.id
+      end
+
+      #
+      # Add title to BibTeX item
+      #
+      def add_title
+        @bib.title.to_bibtex @item
+      end
+
+      #
+      # Add booktitle to BibTeX item
+      #
+      def add_booktitle
+        included_in = @bib.relation.detect { |r| r.type == "includedIn" }
+        return unless included_in
+
+        @item.booktitle = included_in.bibitem.title.first.title
+      end
+
+      #
+      # Add author to BibTeX item
+      #
+      def add_author
+        add_author_editor "author"
+      end
+
+      #
+      # Add editor to BibTeX item
+      #
+      def add_editor
+        add_author_editor "editor"
+      end
+
+      #
+      # Add author or editor to BibTeX item
+      #
+      # @param [String] type "author" or "editor"
+      #
+      def add_author_editor(type)
+        contribs = @bib.contributor.select do |c|
+          c.entity.is_a?(Person) && c.role.any? { |e| e.type == type }
+        end.map &:entity
+
+        return unless contribs.any?
+
+        @item.send "#{type}=", concat_names(contribs)
+      end
+
+      #
+      # Concatenate names of contributors
+      #
+      # @param [Array<RelatonBib::Person>] contribs contributors
+      #
+      # @return [String] concatenated names
+      #
+      def concat_names(contribs)
+        contribs.map do |p|
+          if p.name.surname
+            "#{p.name.surname}, #{p.name.forename.map(&:to_s).join(' ')}"
+          else
+            p.name.completename.to_s
+          end
+        end.join(" and ")
+      end
+
+      #
+      # Add series to BibTeX item
+      #
+      def add_series
+        @bib.series.each do |s|
+          case s.type
+          when "journal"
+            @item.journal = s.title.title
+            @item.number = s.number if s.number
+          when nil then @item.series = s.title.title
+          end
+        end
+      end
+
+      #
+      # Add number to BibTeX item
+      #
+      def add_number
+        return unless %w[techreport manual].include? @bib.type
+
+        did = @bib.docidentifier.detect { |i| i.primary == true }
+        did ||= @bib.docidentifier.first
+        @item.number = did.id if did
+      end
+
+      #
+      # Add edition to BibTeX item
+      #
+      def add_edition
+        @item.edition = @bib.edition.content if @bib.edition
+      end
+
+      #
+      # Add contributor to BibTeX item
+      #
+      def add_contributor # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength
+        @bib.contributor.each do |c|
+          rls = c.role.map(&:type)
+          if rls.include?("publisher") then @item.publisher = c.entity.name
+          elsif rls.include?("distributor")
+            case @bib.type
+            when "techreport" then @item.institution = c.entity.name
+            when "inproceedings", "conference", "manual", "proceedings"
+              @item.organization = c.entity.name
+            when "mastersthesis", "phdthesis" then @item.school = c.entity.name
+            end
+          end
+        end
+      end
+
+      #
+      # Add date to BibTeX item
+      #
+      def add_date
+        @bib.date.each do |d|
+          case d.type
+          when "published"
+            @item.year = d.on :year
+            month = d.on :month
+            @item.month = month if month
+          when "accessed" then @item.urldate = d.on.to_s
+          end
+        end
+      end
+
+      #
+      # Add address to BibTeX item
+      #
+      def add_address # rubocop:disable Metrics/AbcSize
+        return unless @bib.place.any?
+
+        reg = @bib.place[0].region[0].name if @bib.place[0].region.any?
+        addr = [@bib.place[0].name, @bib.place[0].city, reg]
+        @item.address = addr.compact.join(", ")
+      end
+
+      #
+      # Add note to BibTeX item
+      #
+      def add_note # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity
+        @bib.biblionote.each do |n|
+          case n.type
+          when "annote" then @item.annote = n.content
+          when "howpublished" then @item.howpublished = n.content
+          when "comment" then @item.comment = n.content
+          when "tableOfContents" then @item.content = n.content
+          when nil then @item.note = n.content
+          end
+        end
+      end
+
+      #
+      # Add relation to BibTeX item
+      #
+      def add_relation
+        rel = @bib.relation.detect { |r| r.type == "partOf" }
+        if rel
+          title_main = rel.bibitem.title.detect { |t| t.type == "main" }
+          @item.booktitle = title_main.title.content
+        end
+      end
+
+      #
+      # Add extent to BibTeX item
+      #
+      def add_extent
+        @bib.extent.each { |e| e.to_bibtex(@item) }
+      end
+
+      #
+      # Add classification to BibTeX item
+      #
+      def add_classification
+        @bib.classification.each do |c|
+          case c.type
+          when "type" then @item["type"] = c.value
+          when "mendeley" then @item["mendeley-tags"] = c.value
+          end
+        end
+      end
+
+      #
+      # Add keywords to BibTeX item
+      #
+      def add_keyword
+        @item.keywords = @bib.keyword.map(&:content).join(", ") if @bib.keyword.any?
+      end
+
+      #
+      # Add docidentifier to BibTeX item
+      #
+      def add_docidentifier
+        @bib.docidentifier.each do |i|
+          case i.type
+          when "isbn" then @item.isbn = i.id
+          when "lccn" then @item.lccn = i.id
+          when "issn" then @item.issn = i.id
+          end
+        end
+      end
+
+      #
+      # Add identifier to BibTeX item
+      #
+      def add_timestamp
+        @item.timestamp = @bib.fetched.to_s if @bib.fetched
+      end
+
+      #
+      # Add link to BibTeX item
+      #
+      def add_link
+        @bib.link.each do |l|
+          case l.type&.downcase
+          when "doi" then @item.doi = l.content
+          when "file" then @item.file2 = l.content
+          when "src" then @item.url = l.content
+          end
+        end
+      end
+    end
+  end
+end

data/lib/relaton_bib/renderer/bibxml.rb

@@ -0,0 +1,290 @@
+module RelatonBib
+  module Renderer
+    class BibXML
+      def initialize(bib)
+        @bib = bib
+      end
+
+      #
+      # Render BibXML (RFC)
+      #
+      # @param [Nokogiri::XML::Builder, nil] builder
+      # @param [Boolean] include_keywords (false)
+      #
+      # @return [String, Nokogiri::XML::Builder::NodeBuilder] XML
+      #
+      def render(builder: nil, include_keywords: true)
+        if builder
+          render_bibxml builder, include_keywords
+        else
+          Nokogiri::XML::Builder.new(encoding: "UTF-8") do |xml|
+            render_bibxml xml, include_keywords
+          end.doc.root.to_xml
+        end
+      end
+
+      #
+      # Render BibXML (RFC, BCP)
+      #
+      # @param [Nokogiri::XML::Builder] builder
+      # @param [Boolean] include_bibdata
+      #
+      def render_bibxml(builder, include_keywords) # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
+        target = @bib.link.detect { |l| l.type.casecmp("src").zero? } ||
+          @bib.link.detect { |l| l.type.casecmp("doi").zero? }
+        bxml = if @bib.docnumber&.match(/^BCP/) || (@bib.docidentifier.detect(&:primary)&.id ||
+                    @bib.docidentifier[0].id).include?("BCP")
+                 render_bibxml_refgroup(builder, include_keywords)
+               else
+                 render_bibxml_ref(builder, include_keywords)
+               end
+        bxml[:target] = target.content.to_s if target
+      end
+
+      #
+      # Render BibXML (BCP)
+      #
+      # @param [Nokogiri::XML::Builder] builder
+      # @param [Boolean] include_keywords
+      #
+      def render_bibxml_refgroup(builder, include_keywords)
+        builder.referencegroup(**ref_attrs) do |b|
+          @bib.relation.each do |r|
+            r.bibitem.to_bibxml(b, include_keywords: include_keywords) if r.type == "includes"
+          end
+        end
+      end
+
+      #
+      # Render BibXML (RFC)
+      #
+      # @param [Nokogiri::XML::Builder] builder
+      # @param [Boolean] include_keywords
+      #
+      def render_bibxml_ref(builder, include_keywords) # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength, Metrics/PerceivedComplexity
+        builder.reference(**ref_attrs) do |xml|
+          if @bib.title.any? || @bib.contributor.any? || @bib.date.any? || @bib.abstract.any? ||
+              @bib.editorialgroup&.technical_committee&.any? ||
+              (include_keywords && @bib.keyword.any?)
+            xml.front do
+              xml.title @bib.title[0].title.content if @bib.title.any?
+              render_authors xml
+              render_date xml
+              render_workgroup xml
+              render_keyword xml if include_keywords
+              render_abstract xml
+            end
+          end
+          render_seriesinfo xml
+          render_format xml
+        end
+      end
+
+      #
+      # Create reference attributes
+      #
+      # @return [Hash<Symbol=>String>] attributes
+      #
+      def ref_attrs # rubocop:disable Metrics/AbcSize
+        discopes = %w[anchor docName number]
+        attrs = @bib.docidentifier.each_with_object({}) do |di, h|
+          next unless discopes.include?(di.scope)
+
+          h[di.scope.to_sym] = di.id
+        end
+        return attrs if attrs.any?
+
+        @bib.docidentifier.first&.tap do |di|
+          anchor = di.type == "IANA" ? di.id.split[1..].join(" ").upcase : di.id
+          return { anchor: anchor.gsub(" ", ".") }
+        end
+      end
+
+      #
+      # Render authors
+      #
+      # @param [Nokogiri::XML::Builder] builder xml builder
+      #
+      def render_authors(builder) # rubocop:disable Metrics/AbcSize
+        @bib.contributor.each do |c|
+          builder.author do |xml|
+            xml.parent[:role] = "editor" if c.role.detect { |r| r.type == "editor" }
+            if c.entity.is_a?(Person) then render_person xml, c.entity
+            else render_organization xml, c.entity, c.role
+            end
+            render_address xml, c
+          end
+        end
+      end
+
+      #
+      # Render address
+      #
+      # @param [Nokogiri::XML::Builder] builder xml builder
+      # @param [RelatonBib::ContributionInfo] contrib contributor
+      #
+      def render_address(builder, contrib) # rubocop:disable Metrics/AbcSize, Metrics/MethodLength, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
+        # addr = contrib.entity.contact.reject do |cn|
+        #   cn.is_a?(Address) && cn.postcode.nil?
+        # end
+        if contrib.entity.contact.any?
+          builder.address do |xml|
+            address = contrib.entity.contact.detect { |cn| cn.is_a? Address }
+            if address
+              xml.postal do
+                xml.city address.city if address.city
+                xml.code address.postcode if address.postcode
+                xml.country address.country if address.country
+                xml.region address.state if address.state
+                xml.street address.street[0] if address.street.any?
+              end
+            end
+            render_contact xml, contrib.entity.contact
+          end
+        end
+      end
+
+      #
+      # Render contact
+      #
+      # @param [Nokogiri::XML::Builder] builder xml builder
+      # @param [Array<RelatonBib::Address, RelatonBib::Contact>] addr contact
+      #
+      def render_contact(builder, addr)
+        %w[phone email uri].each do |type|
+          cont = addr.detect { |cn| cn.is_a?(Contact) && cn.type == type }
+          builder.send type, cont.value if cont
+        end
+      end
+
+      #
+      # Render person
+      #
+      # @param [Nokogiri::XML::Builder] builder xml builder
+      # @param [RelatonBib::Person] person person
+      #
+      def render_person(builder, person) # rubocop:disable Metrics/AbcSize, Metrics/MethodLength, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
+        render_organization builder, person.affiliation.first&.organization
+        if person.name.completename
+          builder.parent[:fullname] = person.name.completename.content
+        elsif person.name.forename.any?
+          builder.parent[:fullname] = person.name.forename.map do |n|
+            n.content || n.initial
+          end.join " "
+        end
+        if person.name.initials
+          builder.parent[:initials] = person.name.initials.content
+        elsif person.name.forename.any?
+          builder.parent[:initials] = person.name.forename.map do |f|
+            "#{f.initial || f.content[0]}."
+          end.join
+        end
+        if person.name.surname
+          if !person.name.completename && person.name.forename.any? && person.name.surname
+            builder.parent[:fullname] += " #{person.name.surname}"
+          end
+          builder.parent[:surname] = person.name.surname.content
+        end
+      end
+
+      #
+      # Render organization
+      #
+      # @param [Nokogiri::XML::Builder] builder xml builder
+      # @param [RelatonBib::Organization] org organization
+      #
+      def render_organization(builder, org, _role = []) # rubocop:disable Metrics/PerceivedComplexity, Metrics/CyclomaticComplexity, Metrics/MethodLength, Metrics/AbcSize
+        abbrev = org&.abbreviation&.content
+        orgname = org&.name&.first&.content
+        orgname = if BibXMLParser::ORGNAMES.key?(abbrev) then abbrev
+                  else BibXMLParser::ORGNAMES.key(orgname) || orgname || abbrev
+                  end
+        # if role.detect { |r| r.description.detect { |d| d.content == "BibXML author" } }
+        #   builder.parent[:fullname] = orgname
+        # else
+        org = builder.organization orgname
+        org[:abbrev] = abbrev if abbrev
+        # end
+      end
+
+      #
+      # Render date
+      #
+      # @param [Nokogiri::XML::Builder] builder xml builder
+      #
+      def render_date(builder) # rubocop:disable Metrics/AbcSize, Metrics/MethodLength, Metrics/PerceivedComplexity, Metrics/CyclomaticComplexity
+        dt = @bib.date.detect { |d| d.type == "published" }
+        return unless dt
+
+        elm = builder.date
+        y = dt.on(:year) || dt.from(:year) || dt.to(:year)
+        elm[:year] = y if y
+        m = dt.on(:month) || dt.from(:month) || dt.to(:month)
+        elm[:month] = Date::MONTHNAMES[m] if m
+        # rfcs = %w[RFC BCP FYI STD]
+        # unless rfcs.include?(doctype) && docidentifier.detect { |di| rfcs.include? di.type }
+        d = dt.on(:day) || dt.from(:day) || dt.to(:day)
+        elm[:day] = d if d
+        # end
+      end
+
+      #
+      # Render workgroup
+      #
+      # @param [Nokogiri::XML::Builder] builder xml builder
+      #
+      def render_workgroup(builder)
+        @bib.editorialgroup&.technical_committee&.each do |tc|
+          builder.workgroup tc.workgroup.name
+        end
+      end
+
+      #
+      # Render keyword
+      #
+      # @param [Nokogiri::XML::Builder] builder xml builder
+      #
+      def render_keyword(builder)
+        @bib.keyword.each { |kw| builder.keyword kw.content }
+      end
+
+      #
+      # Render abstract
+      #
+      # @param [Nokogiri::XML::Builder] builder xml builder
+      #
+      def render_abstract(builder)
+        return unless @bib.abstract.any?
+
+        builder.abstract { |xml| xml << @bib.abstract[0].content.gsub(/(<\/?)p(>)/, '\1t\2') }
+      end
+
+      #
+      # Render seriesinfo
+      #
+      # @param [Nokogiri::XML::Builder] builder xml builder
+      #
+      def render_seriesinfo(builder) # rubocop:disable Metrics/AbcSize, Metrics/MethodLength, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
+        @bib.docidentifier.each do |di|
+          if BibXMLParser::SERIESINFONAMES.include?(di.type) && di.scope != "trademark"
+            builder.seriesInfo(name: di.type, value: di.id)
+          end
+        end
+        # di_types = docidentifier.map(&:type)
+        @bib.series.select do |s|
+          s.title && # !di_types.include?(s.title.title.to_s) &&
+            !BibXMLParser::SERIESINFONAMES.include?(s.title.title.to_s)
+        end.uniq { |s| s.title.title.to_s }.each do |s|
+          si = builder.seriesInfo(name: s.title.title.to_s)
+          si[:value] = s.number if s.number
+        end
+      end
+
+      def render_format(builder)
+        @bib.link.select { |l| l.type == "TXT" }.each do |l|
+          builder.format type: l.type, target: l.content
+        end
+      end
+    end
+  end
+end

data/lib/relaton_bib/version.rb

@@ -1,3 +1,3 @@
 module RelatonBib
-  VERSION = "1.14.4".freeze
+  VERSION = "1.14.6".freeze
 end

data/lib/relaton_bib.rb

@@ -11,6 +11,8 @@ require "relaton_bib/bibliographic_item"
 require "relaton_bib/hit_collection"
 require "relaton_bib/hit"
 require "relaton_bib/bibxml_parser"
+require "relaton_bib/renderer/bibtex_builder"
+require "relaton_bib/renderer/bibxml"
 
 module RelatonBib
   class Error < StandardError; end
@@ -66,15 +68,17 @@ module RelatonBib
     # Parse yaml content
     #
     # @param [String] yaml content
+    # @param [Array] classes classes to be allowed
+    # @param [Boolean] symbolize_names symbolize names if true (default: false)
     #
     # @return [Hash] data
     #
-    def parse_yaml(yaml, classes = [])
+    def parse_yaml(yaml, classes = [], symbolize_names: false)
       # Newer versions of Psych uses the `permitted_classes:` parameter
       if YAML.method(:safe_load).parameters.map(&:last).include? :permitted_classes
-        YAML.safe_load(yaml, permitted_classes: classes)
+        YAML.safe_load(yaml, permitted_classes: classes, symbolize_names: symbolize_names)
       else
-        YAML.safe_load(yaml, classes)
+        YAML.safe_load(yaml, classes, symbolize_names: symbolize_names)
       end
     end
   end

data/relaton-bib.gemspec

@@ -21,7 +21,7 @@ Gem::Specification.new do |spec|
   spec.bindir        = "exe"
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
-  spec.required_ruby_version = Gem::Requirement.new(">= 2.6.0")
+  spec.required_ruby_version = Gem::Requirement.new(">= 2.7.0")
 
   spec.add_development_dependency "byebug"
   spec.add_development_dependency "equivalent-xml", "~> 0.6"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: relaton-bib
 version: !ruby/object:Gem::Version
-  version: 1.14.4
+  version: 1.14.6
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2023-01-07 00:00:00.000000000 Z
+date: 2023-03-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: byebug
@@ -266,6 +266,8 @@ files:
 - lib/relaton_bib/organization.rb
 - lib/relaton_bib/person.rb
 - lib/relaton_bib/place.rb
+- lib/relaton_bib/renderer/bibtex_builder.rb
+- lib/relaton_bib/renderer/bibxml.rb
 - lib/relaton_bib/series.rb
 - lib/relaton_bib/structured_identifier.rb
 - lib/relaton_bib/technical_committee.rb
@@ -289,7 +291,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.6.0
+      version: 2.7.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="