relaton-ietf 1.9.0 → 1.9.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: de34f43de3864f7494ab3931162ecff103d9f2f66828374bc26ccc91da3c3295
-  data.tar.gz: 84f76c4b573041e55f60efdf208480c6832129a9a094bc3c12205bc19ba42552
+  metadata.gz: 5ed659b3ac3a91f53fa5872cb839be97adeba30e6eba56f211f140e55b5836d8
+  data.tar.gz: 8b1c58e40158c126f11ab25c92ca99230a3e00064b8d0fb20ad250c51c01e7b8
 SHA512:
-  metadata.gz: d6f0c509201f46a402655f2ea4d75b678cb6c4638715a07cd637c8b5c8fa3dc04254ea914dfcd27eebe024231b8caec5b2435f944bc5d8185622b1b515dff3ab
-  data.tar.gz: bd93874e76dad53e998abd0988aba64354a7a5d011141f57e945bb2a2e7c690e0b790c58a343070160bee77d2e8cb7332fe5b2a59d2c983b3222e9bc55db09f7
+  metadata.gz: 163f11e5a49d8dd44d6592c1741281b8756f505ac49feb59d3a508ec2ad7340498db0a5d71a1ccfbbc8c4de385ee967388119238f0c4f94641a839623fe19c65
+  data.tar.gz: 0a86ac885aca2d200e5d64cdee74e0b4b5e6d42f77a5e9fb60c233e77e19c176137ebc8220a7397e56e6564edcd58c09933553810a4265597fbc7e64c02a173b

data/README.adoc

@@ -90,6 +90,21 @@ item.to_xml bibdata: true
 </bibdata>"
 ----
 
+=== Typed links
+
+IETF documents may have `src`, `xml`, and `doi` link type.
+
+* `src` - web pulication
+* `xml` - BibXML publication
+* `doi` - DOI reference
+
+[source,ruby]
+----
+item.link
+=> [#<RelatonBib::TypedUri:0x00007fe8b287a120 @content=#<Addressable::URI:0x7e4 URI:https://raw.githubusercontent.com/relaton/relaton-data-ietf/master/data/reference.RFC.8341.xml>, @type="xml">,
+ #<RelatonBib::TypedUri:0x00007fe8b2237ec0 @content=#<Addressable::URI:0x7f8 URI:https://www.rfc-editor.org/info/rfc8341>, @type="src">]
+----
+
 === Parse a file locally
 
 [source,ruby]

data/lib/relaton_ietf/committee.rb

@@ -0,0 +1,8 @@
+module RelatonIetf
+  class Committee < RelatonBib::TechnicalCommittee
+    # @param builder [Nokogiri::XML::Builder]
+    def to_xml(builder)
+      builder.committee { |b| workgroup.to_xml b }
+    end
+  end
+end

data/lib/relaton_ietf/ietf_bibliographic_item.rb

@@ -21,7 +21,7 @@ module RelatonIetf
     # @return [RelatonIetf::IetfBibliographicItem]
     def self.from_hash(hash)
       item_hash = ::RelatonIetf::HashConverter.hash_to_bib(hash)
-      new **item_hash
+      new(**item_hash)
     end
 
     # @param opts [Hash]
@@ -32,7 +32,7 @@ module RelatonIetf
     # @return [String] XML
     def to_xml(**opts)
       opts[:date_format] ||= :short
-      super **opts
+      super(**opts)
     end
   end
 end

data/lib/relaton_ietf/scrapper.rb

@@ -5,365 +5,372 @@ require "relaton_bib"
 require "relaton_ietf/ietf_bibliographic_item"
 
 module RelatonIetf
-  # rubocop:disable Metrics/ModuleLength
-
   # Scrapper module
   module Scrapper
-    GH_URL = "https://raw.githubusercontent.com/relaton/relaton-data-ietf/master/data/reference."
-    BCP_URI_PATTERN = "https://www.rfc-editor.org/info/CODE"
-
-    class << self
-      # @param text [String]
-      # @param is_relation [TrueClass, FalseClass]
-      # @return [RelatonIetf::IetfBibliographicItem]
-      def scrape_page(text, is_relation: false)
-        # Remove initial "IETF " string if specified
-        ref = text.gsub(/^IETF /, "")
-        /^(?:RFC|BCP|FYI|STD)\s(?<num>\d+)/ =~ ref
-        ref.sub! /(?<=^(?:RFC|BCP|FYI|STD)\s)(\d+)/, num.rjust(4, "0") if num
-        rfc_item ref, is_relation
-      rescue Timeout::Error, Errno::EINVAL, Errno::ECONNRESET, EOFError,
-             Net::HTTPBadResponse, Net::HTTPHeaderSyntaxError,
-             Net::ProtocolError, SocketError
-        raise RelatonBib::RequestError, "No document found for #{ref} reference"
-      end
-
-      # @param reference [Nokogiri::XML::Element, nil]
-      # @param is_relation [TrueClass, FalseClass]
-      # @param url [String, NilClass]
-      # @param ver [String, NilClass] Internet Draft version
-      # @return [RelatonIetf::IetfBibliographicItem]
-      def fetch_rfc(reference, is_relation: false, url: nil, ver: nil) # rubocop:disable Metrics/AbcSize,Metrics/MethodLength
-        return unless reference
-
-        ietf_item(
-          is_relation: is_relation,
-          id: reference[:anchor],
-          type: "standard",
-          docid: docids(reference, ver),
-          status: status(reference),
-          language: [language(reference)],
-          link: link(reference, url, ver),
-          title: titles(reference),
-          formattedref: formattedref(reference),
-          abstract: abstracts(reference),
-          contributor: contributors(reference),
-          relation: relations(reference),
-          date: dates(reference),
-          series: series(reference),
-          place: ["Fremont, CA"],
-          keyword: reference.xpath("front/keyword").map(&:text),
-          doctype: doctype(reference[:anchor]),
-        )
-      end
-
-      private
-
-      # @param anchor [String]
-      # @return [String]
-      def doctype(anchor)
-        anchor&.include?("I-D") ? "internet-draft" : "rfc"
-      end
-
-      # @param reference [Nokogiri::XML::Element]
-      # @param url [String]
-      # @param ver [String, NilClass] Internet Draft version
-      # @return [Array<Hash>]
-      def link(reference, url, ver)
-        l = []
-        l << { type: "xml", content: url } if url
-        l << { type: "src", content: reference[:target] } if reference[:target]
-        if /^I-D/.match? reference[:anchor]
-          reference.xpath("format").each do |f|
-            c = ver ? f[:target].sub(/(?<=-)\d{2}(?=\.)/, ver) : f[:target]
-            l << { type: f[:type], content: c }
-          end
-        end
-        l
-      end
-
-      # @param attrs [Hash]
-      # @return [RelatonIetf::IetfBibliographicItem]
-      def ietf_item(**attrs)
-        attrs[:fetched] = Date.today.to_s unless attrs.delete(:is_relation)
-        attrs[:script] = ["Latn"]
-        RelatonIetf::IetfBibliographicItem.new **attrs
-      end
-
-      # @param ref [String]
-      # @param is_relation [Boolen, nil]
-      # @return [RelatonIetf::IetfBibliographicItem]
-      def rfc_item(ref, is_relation)
-        /(?<=-)(?<ver>\d{2})$/ =~ ref
-        if /^I-D/.match? ref
-          ref.sub! /-\d{2}/, "" if ver
-          ref.sub! /(?<=I-D\.)draft-/, ""
-        end
-
-        uri = "#{GH_URL}#{ref.sub(/\s|\u00a0/, '.')}.xml"
-        doc = Nokogiri::XML get_page(uri)
-        r = doc.at("/referencegroup", "/reference")
-        fetch_rfc r, is_relation: is_relation, url: uri, ver: ver
-      end
-
-      # @param reference [Nokogiri::XML::Element]
-      # @return [Hash]
-      def relations(reference)
-        reference.xpath("reference").map do |ref|
-          { type: "includes", bibitem: fetch_rfc(ref, is_relation: true) }
-        end
-      end
-
-      # @param uri [String]
-      # @return [String] HTTP response body
-      def get_page(uri)
-        res = Net::HTTP.get_response(URI(uri))
-        return unless res.code == "200"
-
-        #   raise RelatonBib::RequestError, "No document found at #{uri}"
-        # end
-
-        res.body
-      end
-
-      # @param reference [Nokogiri::XML::Element]
-      # @return [String]
-      def language(reference)
-        reference[:lang] || "en"
-      end
+    extend RelatonBib::BibXMLParser
+    extend Scrapper
 
-      # @param reference [Nokogiri::XML::Element]
-      # @return [Array<Hash>]
-      def titles(reference)
-        reference.xpath("./front/title").map do |title|
-          { content: title.text, language: language(reference), script: "Latn" }
-        end
-      end
+    FLAVOR = "IETF"
 
-      # @param reference [Nokogiri::XML::Element]
-      # @return [RelatonBib::FormattedRef, nil]
-      def formattedref(reference)
-        return if reference.at "./fornt/title"
-
-        cont = (reference[:anchor] || reference[:docName] || reference[:number])
-        if cont
-          RelatonBib::FormattedRef.new(
-            content: cont, language: language(reference), script: "Latn",
-          )
-        end
-      end
-
-      # @param reference [Nokogiri::XML::Element]
-      # @return [Array<RelatonBib::FormattedString>]
-      def abstracts(ref)
-        ref.xpath("./front/abstract").map do |a|
-          RelatonBib::FormattedString.new(
-            content: a.text.gsub(/\\n\\t{2,4}/, " ").strip,
-            language: language(ref), script: "Latn"
-          )
-        end
-      end
-
-      # @param reference [Nokogiri::XML::Element]
-      # @return [Array<Hash>]
-      def contributors(reference)
-        persons(reference) + organizations(reference)
-      end
-
-      # @param reference [Nokogiri::XML::Element]
-      # @return [Array<Hash{Symbol=>RelatonBib::Person,Symbol=>Array<String>}>]
-      def persons(reference)
-        reference.xpath("./front/author[@surname]|./front/author[@fullname]")
-          .map do |author|
-          entity = RelatonBib::Person.new(
-            name: full_name(author, reference),
-            affiliation: [affiliation(author)],
-            contact: contacts(author.at("./address")),
-          )
-          { entity: entity, role: [contributor_role(author)] }
-        end
-      end
-
-      # @param reference [Nokogiri::XML::Element]
-      # @return [Array<Hash{Symbol=>RelatonBib::Organization,
-      #   Symbol=>Array<String>}>]
-      def organizations(reference)
-        publisher = { entity: new_org, role: [type: "publisher"] }
-        orgs = reference.xpath("./seriesinfo").reduce([publisher]) do |mem, si|
-          next mem unless si[:stream]
-
-          mem << { entity: new_org(si[:stream], nil), role: [type: "author"] }
-        end
-        orgs + reference.xpath(
-          "front/author[not(@surname)][not(@fullname)]/organization",
-        ).map do |org|
-          { entity: new_org(org.text, nil), role: [type: "author"] }
-        end
-      end
-
-      # @param author [Nokogiri::XML::Element]
-      # @param ref [Nokogiri::XML::Element]
-      # @return [RelatonBib::FullName]
-      def full_name(author, ref)
-        lang = language ref
-        RelatonBib::FullName.new(
-          completename: localized_string(author[:fullname], lang),
-          initial: [localized_string(author[:initials], lang)].compact,
-          surname: localized_string(author[:surname], lang),
-        )
-      end
-
-      # @param content [String]
-      # @param lang [String]
-      # @return [RelatonBib::LocalizedString]
-      def localized_string(content, lang)
-        return unless content
-
-        RelatonBib::LocalizedString.new(content, lang)
-      end
-
-      # @param postal [Nokogiri::XML::Element]
-      # @return [Array<RelatonBib::Address, RelatonBib::Phone>]
-      def contacts(addr)
-        contacts = []
-        return contacts unless addr
-
-        postal = addr.at("./postal")
-        contacts << address(postal) if postal
-        add_contact(contacts, "phone", addr.at("./phone"))
-        add_contact(contacts, "email", addr.at("./email"))
-        add_contact(contacts, "uri", addr.at("./uri"))
-        contacts
-      end
-
-      # @param postal [Nokogiri::XML::Element]
-      # @rerurn [RelatonBib::Address]
-      def address(postal) # rubocop:disable Metrics/CyclomaticComplexity
-        RelatonBib::Address.new(
-          street: [(postal.at("./postalLine") || postal.at("./street"))&.text],
-          city: postal.at("./city")&.text,
-          postcode: postal.at("./code")&.text,
-          country: postal.at("./country")&.text,
-          state: postal.at("./region")&.text,
-        )
-      end
-
-      # @param type [String] allowed "phone", "email" or "uri"
-      # @param value [String]
-      def add_contact(contacts, type, value)
-        return unless value
-
-        contacts << RelatonBib::Contact.new(type: type, value: value.text)
-      end
-
-      # @param author [Nokogiri::XML::Element]
-      # @return [RelatonBib::Affiliation]
-      def affiliation(author)
-        organization = author.at("./organization")
-        org = if organization.nil? || organization&.text&.empty?
-                new_org
-              else
-                new_org organization.text, organization[:abbrev]
-              end
-        RelatonBib::Affiliation.new organization: org
-      end
-
-      # @param name [String]
-      # @param abbr [String]
-      # @return [RelatonBib::Organization]
-      def new_org(name = "Internet Engineering Task Force", abbr = "IETF")
-        RelatonBib::Organization.new name: name, abbreviation: abbr
-      end
-
-      # @param author [Nokogiri::XML::Document]
-      # @return [Hash]
-      def contributor_role(author)
-        { type: author[:role] || "author" }
-      end
+    GH_URL = "https://raw.githubusercontent.com/relaton/relaton-data-ietf/master/data/reference."
 
-      def month(mon)
-        return 1 if !mon || mon.empty?
-        return mon if /^\d+$/.match? mon
+    # @param text [String]
+    # @param is_relation [TrueClass, FalseClass]
+    # @return [RelatonIetf::IetfBibliographicItem]
+    def scrape_page(text, is_relation: false)
+      # Remove initial "IETF " string if specified
+      ref = text.gsub(/^IETF /, "")
+      /^(?:RFC|BCP|FYI|STD)\s(?<num>\d+)/ =~ ref
+      ref.sub!(/(?<=^(?:RFC|BCP|FYI|STD)\s)(\d+)/, num.rjust(4, "0")) if num
+      rfc_item ref, is_relation
+    rescue Timeout::Error, Errno::EINVAL, Errno::ECONNRESET, EOFError,
+            Net::HTTPBadResponse, Net::HTTPHeaderSyntaxError,
+            Net::ProtocolError, SocketError
+      raise RelatonBib::RequestError, "No document found for #{ref} reference"
+    end
 
-        Date::MONTHNAMES.index(mon)
+    # @param reference [Nokogiri::XML::Element, nil]
+    # @param is_relation [Boolean] don't add fetched date for relation
+    # @param url [String, NilClass]
+    # @param ver [String, NilClass] Internet Draft version
+    # @return [RelatonBib::tfBibliographicItem]
+    # def fetch_rfc(reference, is_relation: false, url: nil, ver: nil) # rubocop:disable Metrics/AbcSize,Metrics/MethodLength
+    #   return unless reference
+
+    #   hash = {
+    #     id: reference[:anchor],
+    #     type: "standard",
+    #     docid: docids(reference, ver),
+    #     status: status(reference),
+    #     language: [language(reference)],
+    #     script: ["Latn"],
+    #     link: link(reference, url, ver),
+    #     title: titles(reference),
+    #     formattedref: formattedref(reference),
+    #     abstract: abstracts(reference),
+    #     contributor: contributors(reference),
+    #     relation: relations(reference),
+    #     date: dates(reference),
+    #     series: series(reference),
+    #     keyword: reference.xpath("front/keyword").map(&:text),
+    #     doctype: doctype(reference[:anchor]),
+    #   }
+    #   hash[:fetched] = Date.today.to_s unless is_relation
+    #   bib_item(**hash)
+    # end
+
+    private
+
+    # @param anchor [String]
+    # @return [String]
+    # def doctype(anchor)
+    #   anchor&.include?("I-D") ? "internet-draft" : "rfc"
+    # end
+
+    # @param reference [Nokogiri::XML::Element]
+    # @param url [String]
+    # @param ver [String, NilClass] Internet Draft version
+    # @return [Array<Hash>]
+    # def link(reference, url, ver)
+    #   l = []
+    #   l << { type: "xml", content: url } if url
+    #   l << { type: "src", content: reference[:target] } if reference[:target]
+    #   if /^I-D/.match? reference[:anchor]
+    #     reference.xpath("format").each do |f|
+    #       c = ver ? f[:target].sub(/(?<=-)\d{2}(?=\.)/, ver) : f[:target]
+    #       l << { type: f[:type], content: c }
+    #     end
+    #   end
+    #   l
+    # end
+
+    # @param attrs [Hash]
+    # @return [RelatonIetf::IetfBibliographicItem]
+    def bib_item(**attrs)
+      unless attrs.delete(:is_relation)
+        attrs[:fetched] = Date.today.to_s
+        attrs[:place] = ["Fremont, CA"]
       end
+      RelatonIetf::IetfBibliographicItem.new(**attrs)
+    end
 
-      #
-      # Extract date from reference.
-      #
-      # @param reference [Nokogiri::XML::Element]
-      # @return [Array<RelatonBib::BibliographicDate>] published data.
-      #
-      def dates(reference)
-        return unless (date = reference.at "./front/date")
-
-        d = [date[:year], month(date[:month]),
-             (date[:day] || 1)].compact.join "-"
-        date = Time.parse(d).strftime "%Y-%m-%d"
-        [RelatonBib::BibliographicDate.new(type: "published", on: date)]
+    # @param ref [String]
+    # @param is_relation [Boolen, nil]
+    # @return [RelatonIetf::IetfBibliographicItem]
+    def rfc_item(ref, is_relation)
+      /(?<=-)(?<ver>\d{2})$/ =~ ref
+      if /^I-D/.match? ref
+        ref.sub!(/-\d{2}/, "") if ver
+        ref.sub!(/(?<=I-D\.)draft-/, "")
       end
 
-      #
-      # Extract document identifiers from reference
-      #
-      # @param reference [Nokogiri::XML::Element]
-      # @param ver [String, NilClass] Internet Draft version
-      #
-      # @return [Array<RelatonBib::DocumentIdentifier>]
-      #
-      def docids(reference, ver) # rubocop:disable Metrics/MethodLength,Metrics/CyclomaticComplexity,Metrics/PerceivedComplexity,Metrics/AbcSize
-        id = (reference[:anchor] || reference[:docName] || reference[:number])
-        ret = []
-        if id
-          ret << RelatonBib::DocumentIdentifier.new(
-            type: "IETF", id: id.sub(/^(RFC)/, "\\1 "),
-          )
-        end
-        if (id = reference[:anchor])
-          ret << RelatonBib::DocumentIdentifier.new(type: "rfc-anchor", id: id)
-        end
-        ret + reference.xpath("./seriesInfo").map do |si|
-          next unless ["DOI", "Internet-Draft"].include? si[:name]
-
-          id = si[:value]
-          id.sub! /(?<=-)\d{2}$/, ver if ver && si[:name] == "Internet-Draft"
-          RelatonBib::DocumentIdentifier.new(id: id, type: si[:name])
-        end.compact
-      end
+      uri = "#{GH_URL}#{ref.sub(/\s|\u00a0/, '.')}.xml"
+      # doc = Nokogiri::XML get_page(uri)
+      # r = doc.at("/referencegroup", "/reference")
+      # fetch_rfc r, is_relation: is_relation, url: uri, ver: ver
+      parse get_page(uri), url: uri, is_relation: is_relation, ver: ver
+    end
 
-      #
-      # Extract series form reference
-      # @param reference [Nokogiri::XML::Element]
-      #
-      # @return [Array<RelatonBib::Series>]
-      #
-      def series(reference)
-        reference.xpath("./seriesInfo").map do |si|
-          next if si[:name] == "DOI" || si[:stream] || si[:status]
-
-          RelatonBib::Series.new(
-            title: RelatonBib::TypedTitleString.new(
-              content: si[:name], language: language(reference), script: "Latn",
-            ),
-            number: si[:value],
-            type: "main",
-          )
-        end.compact
-      end
+    # @param reference [Nokogiri::XML::Element]
+    # @return [Hash]
+    # def relations(reference)
+    #   reference.xpath("reference").map do |ref|
+    #     { type: "includes", bibitem: fetch_rfc(ref, is_relation: true) }
+    #   end
+    # end
+
+    # @param uri [String]
+    # @return [String] HTTP response body
+    def get_page(uri)
+      res = Net::HTTP.get_response(URI(uri))
+      return unless res.code == "200"
+
+      res.body
+    end
 
-      #
-      # extract status
-      # @param reference [Nokogiri::XML::Element]
-      #
-      # @return [RelatonBib::DocumentStatus]
-      #
-      def status(reference)
-        st = reference.at("./seriesinfo[@status]")
-        return unless st
-
-        RelatonBib::DocumentStatus.new(stage: st[:status])
-      end
+    # @param [RelatonBib::WorkGroup]
+    # @return [RelatonIetf::Committee]
+    def committee(wgr)
+      Committee.new wgr
     end
+
+    # @param reference [Nokogiri::XML::Element]
+    # @return [String]
+    # def language(reference)
+    #   reference[:lang] || "en"
+    # end
+
+    # @param reference [Nokogiri::XML::Element]
+    # @return [Array<Hash>]
+    # def titles(reference)
+    #   reference.xpath("./front/title").map do |title|
+    #     { content: title.text, language: language(reference), script: "Latn" }
+    #   end
+    # end
+
+    # @param reference [Nokogiri::XML::Element]
+    # @return [RelatonBib::FormattedRef, nil]
+    # def formattedref(reference)
+    #   return if reference.at "./front/title"
+
+    #   cont = (reference[:anchor] || reference[:docName] || reference[:number])
+    #   if cont
+    #     RelatonBib::FormattedRef.new(
+    #       content: cont, language: language(reference), script: "Latn",
+    #     )
+    #   end
+    # end
+
+    # @param reference [Nokogiri::XML::Element]
+    # @return [Array<RelatonBib::FormattedString>]
+    # def abstracts(ref)
+    #   ref.xpath("./front/abstract").map do |a|
+    #     RelatonBib::FormattedString.new(
+    #       content: a.text.gsub(/\\n\\t{2,4}/, " ").strip,
+    #       language: language(ref), script: "Latn"
+    #     )
+    #   end
+    # end
+
+    # @param reference [Nokogiri::XML::Element]
+    # @return [Array<Hash>]
+    # def contributors(reference)
+    #   persons(reference) + organizations(reference)
+    # end
+
+    # @param reference [Nokogiri::XML::Element]
+    # @return [Array<Hash{Symbol=>RelatonBib::Person,Symbol=>Array<String>}>]
+    # def persons(reference)
+    #   reference.xpath("./front/author[@surname]|./front/author[@fullname]")
+    #     .map do |author|
+    #     entity = RelatonBib::Person.new(
+    #       name: full_name(author, reference),
+    #       affiliation: [affiliation(author)],
+    #       contact: contacts(author.at("./address")),
+    #     )
+    #     { entity: entity, role: [contributor_role(author)] }
+    #   end
+    # end
+
+    # @param reference [Nokogiri::XML::Element]
+    # @return [Array<Hash{Symbol=>RelatonBib::Organization,
+    #   Symbol=>Array<String>}>]
+    # def organizations(reference)
+    #   publisher = { entity: new_org, role: [type: "publisher"] }
+    #   orgs = reference.xpath("./seriesinfo").reduce([publisher]) do |mem, si|
+    #     next mem unless si[:stream]
+
+    #     mem << { entity: new_org(si[:stream], nil), role: [type: "author"] }
+    #   end
+    #   orgs + reference.xpath(
+    #     "front/author[not(@surname)][not(@fullname)]/organization",
+    #   ).map do |org|
+    #     { entity: new_org(org.text, nil), role: [type: "author"] }
+    #   end
+    # end
+
+    # @param author [Nokogiri::XML::Element]
+    # @param ref [Nokogiri::XML::Element]
+    # @return [RelatonBib::FullName]
+    # def full_name(author, ref)
+    #   lang = language ref
+    #   RelatonBib::FullName.new(
+    #     completename: localized_string(author[:fullname], lang),
+    #     initial: [localized_string(author[:initials], lang)].compact,
+    #     surname: localized_string(author[:surname], lang),
+    #   )
+    # end
+
+    # @param content [String]
+    # @param lang [String]
+    # @return [RelatonBib::LocalizedString]
+    # def localized_string(content, lang)
+    #   return unless content
+
+    #   RelatonBib::LocalizedString.new(content, lang)
+    # end
+
+    # @param postal [Nokogiri::XML::Element]
+    # @return [Array<RelatonBib::Address, RelatonBib::Phone>]
+    # def contacts(addr)
+    #   contacts = []
+    #   return contacts unless addr
+
+    #   postal = addr.at("./postal")
+    #   contacts << address(postal) if postal
+    #   add_contact(contacts, "phone", addr.at("./phone"))
+    #   add_contact(contacts, "email", addr.at("./email"))
+    #   add_contact(contacts, "uri", addr.at("./uri"))
+    #   contacts
+    # end
+
+    # @param postal [Nokogiri::XML::Element]
+    # @rerurn [RelatonBib::Address]
+    # def address(postal) # rubocop:disable Metrics/CyclomaticComplexity
+    #   RelatonBib::Address.new(
+    #     street: [(postal.at("./postalLine") || postal.at("./street"))&.text],
+    #     city: postal.at("./city")&.text,
+    #     postcode: postal.at("./code")&.text,
+    #     country: postal.at("./country")&.text,
+    #     state: postal.at("./region")&.text,
+    #   )
+    # end
+
+    # @param type [String] allowed "phone", "email" or "uri"
+    # @param value [String]
+    # def add_contact(contacts, type, value)
+    #   return unless value
+
+    #   contacts << RelatonBib::Contact.new(type: type, value: value.text)
+    # end
+
+    # @param author [Nokogiri::XML::Element]
+    # @return [RelatonBib::Affiliation]
+    # def affiliation(author)
+    #   organization = author.at("./organization")
+    #   org = if organization.nil? || organization&.text&.empty?
+    #           new_org
+    #         else
+    #           new_org organization.text, organization[:abbrev]
+    #         end
+    #   RelatonBib::Affiliation.new organization: org
+    # end
+
+    # @param name [String]
+    # @param abbr [String]
+    # @return [RelatonBib::Organization]
+    # def new_org(name = "Internet Engineering Task Force", abbr = "IETF")
+    #   RelatonBib::Organization.new name: name, abbreviation: abbr
+    # end
+
+    # @param author [Nokogiri::XML::Document]
+    # @return [Hash]
+    # def contributor_role(author)
+    #   { type: author[:role] || "author" }
+    # end
+
+    # def month(mon)
+    #   return 1 if !mon || mon.empty?
+    #   return mon if /^\d+$/.match? mon
+
+    #   Date::MONTHNAMES.index(mon)
+    # end
+
+    #
+    # Extract date from reference.
+    #
+    # @param reference [Nokogiri::XML::Element]
+    # @return [Array<RelatonBib::BibliographicDate>] published data.
+    #
+    # def dates(reference)
+    #   return unless (date = reference.at "./front/date")
+
+    #   d = [date[:year], month(date[:month]),
+    #        (date[:day] || 1)].compact.join "-"
+    #   date = Time.parse(d).strftime "%Y-%m-%d"
+    #   [RelatonBib::BibliographicDate.new(type: "published", on: date)]
+    # end
+
+    #
+    # Extract document identifiers from reference
+    #
+    # @param reference [Nokogiri::XML::Element]
+    # @param ver [String, NilClass] Internet Draft version
+    #
+    # @return [Array<RelatonBib::DocumentIdentifier>]
+    #
+    # def docids(reference, ver) # rubocop:disable Metrics/MethodLength,Metrics/CyclomaticComplexity,Metrics/PerceivedComplexity,Metrics/AbcSize
+    #   id = (reference[:anchor] || reference[:docName] || reference[:number])
+    #   ret = []
+    #   if id
+    #     ret << RelatonBib::DocumentIdentifier.new(
+    #       type: "IETF", id: id.sub(/^(RFC)/, "\\1 "),
+    #     )
+    #   end
+    #   if (id = reference[:anchor])
+    #     ret << RelatonBib::DocumentIdentifier.new(type: "rfc-anchor", id: id)
+    #   end
+    #   names = ["DOI", "Internet-Draft"]
+    #   ret + reference.xpath("./seriesInfo").map do |si|
+    #     next unless names.include? si[:name]
+
+    #     id = si[:value]
+    #     id.sub!(/(?<=-)\d{2}$/, ver) if ver && si[:name] == "Internet-Draft"
+    #     RelatonBib::DocumentIdentifier.new(id: id, type: si[:name])
+    #   end.compact
+    # end
+
+    #
+    # Extract series form reference
+    # @param reference [Nokogiri::XML::Element]
+    #
+    # @return [Array<RelatonBib::Series>]
+    #
+    # def series(reference)
+    #   reference.xpath("./seriesInfo").map do |si|
+    #     next if si[:name] == "DOI" || si[:stream] || si[:status]
+
+    #     RelatonBib::Series.new(
+    #       title: RelatonBib::TypedTitleString.new(
+    #         content: si[:name], language: language(reference), script: "Latn",
+    #       ),
+    #       number: si[:value],
+    #       type: "main",
+    #     )
+    #   end.compact
+    # end
+
+    #
+    # extract status
+    # @param reference [Nokogiri::XML::Element]
+    #
+    # @return [RelatonBib::DocumentStatus]
+    #
+    # def status(reference)
+    #   st = reference.at("./seriesinfo[@status]")
+    #   return unless st
+
+    #   RelatonBib::DocumentStatus.new(stage: st[:status])
+    # end
   end
-  # rubocop:enable Metrics/ModuleLength
 end

data/lib/relaton_ietf/version.rb

@@ -1,3 +1,3 @@
 module RelatonIetf
-  VERSION = "1.9.0".freeze
+  VERSION = "1.9.1".freeze
 end

data/lib/relaton_ietf/xml_parser.rb

@@ -9,7 +9,7 @@ module RelatonIetf
       # @param item_hash [Hash]
       # @return [RelatonIetf::IetfBibliographicItem]
       def bib_item(item_hash)
-        IetfBibliographicItem.new **item_hash
+        IetfBibliographicItem.new(**item_hash)
       end
     end
   end

data/lib/relaton_ietf.rb

@@ -5,6 +5,7 @@ require "relaton_ietf/ietf_bibliography"
 require "relaton_ietf/ietf_bibliographic_item"
 require "relaton_ietf/xml_parser"
 require "relaton_ietf/hash_converter"
+require "relaton_ietf/committee"
 
 require "relaton/provider_ietf"
 

data/relaton_ietf.gemspec

@@ -38,5 +38,5 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "vcr"
   spec.add_development_dependency "webmock"
 
-  spec.add_dependency "relaton-bib", "~> 1.9.0"
+  spec.add_dependency "relaton-bib", ">= 1.9.5"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: relaton-ietf
 version: !ruby/object:Gem::Version
-  version: 1.9.0
+  version: 1.9.1
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2021-08-26 00:00:00.000000000 Z
+date: 2021-10-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: equivalent-xml
@@ -126,16 +126,16 @@ dependencies:
   name: relaton-bib
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 1.9.0
+        version: 1.9.5
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 1.9.0
+        version: 1.9.5
 description: "RelatonIetf: retrieve IETF Standards for bibliographic use \nusing the
   BibliographicItem model.\n\nFormerly known as rfcbib.\n"
 email:
@@ -163,6 +163,7 @@ files:
 - grammars/reqt.rng
 - lib/relaton/provider_ietf.rb
 - lib/relaton_ietf.rb
+- lib/relaton_ietf/committee.rb
 - lib/relaton_ietf/hash_converter.rb
 - lib/relaton_ietf/ietf_bibliographic_item.rb
 - lib/relaton_ietf/ietf_bibliography.rb