relaton-ietf 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: f9bf4b1db7471743fbce87d242ebd9f8a7a59630
+  data.tar.gz: deb0f7674386a76f577671a1f6f883249ffe0beb
+SHA512:
+  metadata.gz: fc38e9bdf1be20eaeb09b3b6b42783af101a40ac3f1e3238d46d23a1612cb5dbc8748d43079db05338c0d9dc28ae4998dcd1684f81236367297276675c398876
+  data.tar.gz: 38d10c12570ff5836b1421776b8eedde6f3ccc7118ef78b2db4fb25ef51a7a5229600a2eedc7ef5cee7d5a8b1f4e2be59bbc8b1b8d23e5ae8faab38fe6b05a2f

data/.gitignore

@@ -0,0 +1,13 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+.vscode/
+
+# rspec failure tracking
+.rspec_status
+.rubocop-https---raw-githubusercontent-com-riboseinc-oss-guides-master-ci-rubocop-yml

data/.hound.yml

@@ -0,0 +1,3 @@
+ruby:
+  Enabled: true
+  config_file: .rubocop.yml

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,10 @@
+# This project follows the Ribose OSS style guide.
+# https://github.com/riboseinc/oss-guides
+# All project-specific additions and overrides should be specified in this file.
+
+inherit_from:
+  - https://raw.githubusercontent.com/riboseinc/oss-guides/master/ci/rubocop.yml
+AllCops:
+  TargetRubyVersion: 2.3
+Rails:
+  Enabled: true

data/.travis.yml

@@ -0,0 +1,17 @@
+# Auto-generated !!! Do not edit it manually
+# use ci-master https://github.com/metanorma/metanorma-build-scripts
+language: ruby
+cache: bundler
+os:
+- linux
+- osx
+rvm:
+- 2.5
+- 2.4
+- ruby-head
+before_install: 
+- gem install bundler -v 2.0.1
+- bundle update
+matrix:
+  allow_failures:
+    - rvm: ruby-head

data/Gemfile

@@ -0,0 +1,9 @@
+Encoding.default_external = Encoding::UTF_8
+Encoding.default_internal = Encoding::UTF_8
+
+source "https://rubygems.org"
+
+git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
+
+# Specify your gem's dependencies in relaton_ietf.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,91 @@
+PATH
+  remote: .
+  specs:
+    relaton-ietf (0.1.0)
+      relaton-iso-bib (~> 0.1.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.6.0)
+      public_suffix (>= 2.0.2, < 4.0)
+    byebug (11.0.1)
+    coderay (1.1.2)
+    crack (0.4.3)
+      safe_yaml (~> 1.0.0)
+    debase (0.2.2)
+      debase-ruby_core_source (>= 0.10.2)
+    debase-ruby_core_source (0.10.4)
+    diff-lcs (1.3)
+    docile (1.3.1)
+    equivalent-xml (0.6.0)
+      nokogiri (>= 1.4.3)
+    hashdiff (0.4.0)
+    isoics (0.1.7)
+    json (2.2.0)
+    method_source (0.9.2)
+    mini_portile2 (2.3.0)
+    nokogiri (1.8.5)
+      mini_portile2 (~> 2.3.0)
+    pry (0.12.2)
+      coderay (~> 1.1.0)
+      method_source (~> 0.9.0)
+    pry-byebug (3.7.0)
+      byebug (~> 11.0)
+      pry (~> 0.10)
+    public_suffix (3.1.0)
+    rake (10.5.0)
+    relaton-bib (0.1.6)
+      addressable
+      nokogiri (~> 1.8.4)
+    relaton-iso-bib (0.1.0)
+      isoics (~> 0.1.6)
+      nokogiri (~> 1.8.4)
+      relaton-bib (~> 0.1.5)
+      ruby_deep_clone (~> 0.8.0)
+    rspec (3.8.0)
+      rspec-core (~> 3.8.0)
+      rspec-expectations (~> 3.8.0)
+      rspec-mocks (~> 3.8.0)
+    rspec-core (3.8.0)
+      rspec-support (~> 3.8.0)
+    rspec-expectations (3.8.3)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.8.0)
+    rspec-mocks (3.8.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.8.0)
+    rspec-support (3.8.0)
+    ruby-debug-ide (0.6.1)
+      rake (>= 0.8.1)
+    ruby_deep_clone (0.8.0)
+    safe_yaml (1.0.5)
+    simplecov (0.16.1)
+      docile (~> 1.1)
+      json (>= 1.8, < 3)
+      simplecov-html (~> 0.10.0)
+    simplecov-html (0.10.2)
+    vcr (5.0.0)
+    webmock (3.5.1)
+      addressable (>= 2.3.6)
+      crack (>= 0.3.2)
+      hashdiff
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 2.0.1)
+  debase
+  equivalent-xml (~> 0.6)
+  pry-byebug
+  rake (~> 10.0)
+  relaton-ietf!
+  rspec (~> 3.0)
+  ruby-debug-ide
+  simplecov
+  vcr
+  webmock
+
+BUNDLED WITH
+   2.0.1

data/LICENSE.txt

@@ -0,0 +1,25 @@
+BSD 2-Clause License
+
+Copyright (c) 2018, Ribose
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README.adoc

@@ -0,0 +1,124 @@
+= RelatonIetf
+
+image:https://img.shields.io/gem/v/relaton-ietf.svg["Gem Version", link="https://rubygems.org/gems/relaton-ietf"]
+image:https://img.shields.io/travis/metanorma/relaton-ietf/master.svg["Build Status", link="https://travis-ci.org/metanorma/relaton-ietf"]
+image:https://ci.appveyor.com/api/projects/status/eirsba4v3nviejs4?svg=true["Appveyor Build Status", link="https://ci.appveyor.com/project/ribose/relaton-ietf"]
+image:https://codeclimate.com/github/metanorma/relaton-ietf/badges/gpa.svg["Code Climate", link="https://codeclimate.com/github/metanorma/relaton-ietf"]
+
+_Formerly known as_ `rfcbib`.
+
+RelatonIetf is a Ruby gem that search and fetch standards from the https://www.ietf.org[Internet Engineering Task Force (IETF)], including RFCs.
+
+The standards scrape form https://www.rfc-editor.org/search/rfc_search.php
+
+== Installation
+
+Add this line to your application's Gemfile:
+
+[source, ruby]
+----
+gem 'relaton-ietf'
+----
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install relaton-ietf
+
+== Usage
+
+=== Search document
+
+[source,ruby]
+----
+require 'relaton_ietf'
+
+item = RelatonIetf::IetfBibliography.search 'RFC 8341'
+=> #<RelatonIetf::IetfBibliographicItem:0x007fd1875e7f58
+...
+
+# Return nil if document doesn't exist.
+RelatonIetf::IetfBibliography.search '1111'
+1111.xml: not recognised for RFC
+=> nil
+----
+
+=== Serialization
+
+[source,ruby]
+----
+item.to_xml
+=>"<bibitem id="RFC8341">
+  <fetched>2019-06-05</fetched>
+  <title format="text/plain" language="en" script="Latn">Network Configuration Access Control Model</title>
+  <uri type="src">https://www.rfc-editor.org/info/rfc8341</uri>
+  <docidentifier type="IETF">RFC 8341</docidentifier>
+  <docidentifier type="DOI">10.17487/RFC8341</docidentifier>
+  <date type="published">
+    <on>2018-03</on>
+  </date>
+  <contributor>
+    <role type="author"/>
+    <person>
+      <name>
+        <completename language="en">A. Bierman</completename>
+      </name>
+      <affiliation>
+        <organization>
+          <name>IETF</name>
+          <abbreviation>IETF</abbreviation>
+        </organization>
+      </affiliation>
+    </person>
+  </contributor>
+  <contributor>
+    <role type="author"/>
+    <person>
+      <name>
+        <completename language="en">M. Bjorklund</completename>
+      </name>
+      <affiliation>
+        <organization>
+          <name>IETF</name>
+          <abbreviation>IETF</abbreviation>
+        </organization>
+      </affiliation>
+    </person>
+  </contributor>
+  <language>en</language>
+  <script>Latn</script>
+  <series type="main">
+    <title format="text/plain" language="en" script="Latn">STD</title>
+    <number>91</number>
+  </series>
+  <series type="main">
+    <title format="text/plain" language="en" script="Latn">RFC</title>
+    <number>8341</number>
+  </series>
+</bibitem>"
+----
+With `bibdata: true` option XML output wrapped with `bibdata` element and `ext` element added.
+[source,ruby]
+----
+item.to_xml bibdata: true
+=>"<bibdata>
+  <fetched>2019-06-05</fetched>
+  <title format="text/plain" language="en" script="Latn">Network Configuration Access Control Model</title>
+  <uri type="src">https://www.rfc-editor.org/info/rfc8341</uri>
+  ...
+  <ext>
+    <doctype>rfc</doctype>
+  </ext>
+</bibdata>"
+----
+
+== Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/metanorma/relaton-ietf.
+
+== License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/appveyor.yml

@@ -0,0 +1,35 @@
+# Auto-generated !!! Do not edit it manually
+# use ci-master https://github.com/metanorma/metanorma-build-scripts
+version: '{build}'
+
+cache:
+  - vendor/bundle
+
+environment:
+  matrix:
+    - RUBY_VERSION: 25
+    - RUBY_VERSION: 24
+    - RUBY_VERSION: _trunk
+
+matrix:
+  allow_failures:
+    - RUBY_VERSION: _trunk
+
+install:
+  - ps: . { iwr -useb https://raw.githubusercontent.com/metanorma/metanorma-build-scripts/master/appveyor.ps1 } | iex
+  - refreshenv
+
+build_script:
+  - set PATH=C:\Ruby%RUBY_VERSION%\bin;%PATH%
+  - set GIT_TERMINAL_PROMPT=0
+  - bundle config --local path vendor/bundle
+  - bundle update
+  - bundle install
+
+before_test:
+  - ruby -v
+  - gem -v
+  - bundle -v
+
+test_script:
+  - bundle exec rake

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "relaton_ietf"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/relaton/processor.rb

@@ -0,0 +1,23 @@
+require "relaton/processor"
+require "relaton_ietf/xml_parser"
+
+module Relaton
+  module RelatonIetf
+    class Processor < Relaton::Processor
+      def initialize
+        @short = :relaton_ietf
+        @prefix = "IETF"
+        @defaultprefix = /^RFC /
+        @idtype = "IETF"
+      end
+
+      def get(code, date, opts)
+        ::RelatonIetf::IetfBibliography.get(code, date, opts)
+      end
+
+      def from_xml(xml)
+        ::RelatonIetf::XMLParser.from_xml xml
+      end
+    end
+  end
+end

data/lib/relaton_ietf.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require "relaton_ietf/version"
+require "relaton_ietf/ietf_bibliography"
+require "relaton_ietf/ietf_bibliographi_item"
+require "relaton_ietf/xml_parser"
+
+if defined? Relaton
+  require_relative "relaton/processor"
+  Relaton::Registry.instance.register(Relaton::RelatonIetf::Processor)
+end

data/lib/relaton_ietf/ietf_bibliographi_item.rb

@@ -0,0 +1,25 @@
+module RelatonIetf
+  class IetfBibliographicItem < RelatonBib::BibliographicItem
+    # @return [String, NilClass]
+    attr_reader :doctype
+
+    def initialize(**args)
+      @doctype = args.delete :doctype
+      super
+    end
+
+    # @param builder
+    # @param opts [Hash]
+    # @option opts [Symbol, NilClass] :date_format (:short), :full
+    def to_xml(builder = nil, **opts)
+      opts[:date_format] ||= :short
+      super builder, **opts do |b|
+        if opts[:bibdata]
+          b.ext do
+            b.doctype doctype if doctype
+          end
+        end
+      end
+    end
+  end
+end

data/lib/relaton_ietf/ietf_bibliography.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal:true
+
+require "relaton_ietf/scrapper"
+
+module RelatonIetf
+  # IETF bibliography module
+  module IetfBibliography
+    class << self
+      # @param code [String] the ISO standard Code to look up (e..g "ISO 9000")
+      # @return [RelatonIetf::IetfBibliographicItem]
+      def search(text)
+        Scrapper.scrape_page text
+      end
+
+      # @param code [String] the ISO standard Code to look up (e..g "ISO 9000")
+      # @param year [String] the year the standard was published (optional)
+      # @param opts [Hash] options; restricted to :all_parts if all-parts reference is required
+      # @return [RelatonIetf::IetfBibliographicItem] Relaton of reference
+      def get(code, _year = nil, _opts = {})
+        search code
+      end
+    end
+  end
+end

data/lib/relaton_ietf/scrapper.rb

@@ -0,0 +1,255 @@
+# frozen_string_literal: true
+
+require "net/http"
+require "nokogiri"
+require "relaton_bib"
+
+module RelatonIetf
+  # rubocop:disable Metrics/ModuleLength
+
+  # Scrapper module
+  module Scrapper
+    RFC_URI_PATTERN = "https://xml2rfc.tools.ietf.org/public/rfc/bibxml/reference.CODE"
+    ID_URI_PATTERN = "https://xml2rfc.tools.ietf.org/public/rfc/bibxml-ids/reference.CODE"
+
+    class << self
+      # @param text [String]
+      # @return [RelatonIetf::IetfBibliographicItem]
+      def scrape_page(text)
+        # Remove initial "IETF " string if specified
+        ref = text.
+          gsub(/^IETF /, "").
+          sub(" ", ".") + ".xml"
+
+        case ref
+        when /^RFC/
+          uri = RFC_URI_PATTERN.dup
+          doctype = "rfc"
+        when /^I-D/
+          uri = ID_URI_PATTERN.dup
+          doctype = "internet-draft"
+        else
+          warn "#{ref}: not recognised for RFC"
+          return
+        end
+
+        uri = uri.gsub("CODE", ref)
+        begin
+          res = Net::HTTP.get_response(URI(uri))
+          if res.code != "200"
+            warn "No document found at #{uri}"
+            return
+          end
+          doc = Nokogiri::HTML Net::HTTP.get(URI(uri))
+          reference = doc.at("//reference")
+          return unless reference
+
+          bib_item reference, doctype
+        rescue Timeout::Error, Errno::EINVAL, Errno::ECONNRESET, EOFError,
+               Net::HTTPBadResponse, Net::HTTPHeaderSyntaxError, Net::ProtocolError
+          warn "No document found at #{uri}"
+        end
+      end
+
+      private
+
+      # rubocop:disable Metrics/MethodLength
+
+      # @return [RelatonIetf::IetfBibliographicItem]
+      def bib_item(reference, doctype)
+        RelatonIetf::IetfBibliographicItem.new(
+          fetched: Date.today.to_s,
+          id: reference[:anchor],
+          docid: docids(reference),
+          status: status(reference),
+          language: [language(reference)],
+          script: ["Latn"],
+          link: [{ type: "src", content: reference[:target] }],
+          titles: titles(reference),
+          contributors: contributors(reference),
+          dates: dates(reference),
+          series: series(reference),
+          doctype: doctype,
+        )
+      end
+      # rubocop:enable Metrics/MethodLength
+
+      # @return [String]
+      def language(reference)
+        reference[:lang] || "en"
+      end
+
+      # @return [Array<Hash>]
+      def titles(reference)
+        title = reference.at("./front/title")
+        [{ content: title.text, language: language(reference), script: "Latn" }]
+      end
+
+      # @return [Array<Hash>]
+      def contributors(reference)
+        persons(reference) + organizations(reference)
+      end
+
+      # @return [Array<Hash{Symbol=>RelatonBib::Person,Symbol=>Array<String>}>]
+      def persons(reference)
+        reference.xpath("./front/author").map do |author|
+          entity = RelatonBib::Person.new(
+            name: full_name(author, reference),
+            affiliation: [affiliation(author)],
+            contacts: contacts(author.at("./address")),
+          )
+          { entity: entity, roles: [contributor_role(author)] }
+        end
+      end
+
+      # @return [Array<Hash{Symbol=>RelatonBib::Organization,Symbol=>Array<String>}>]
+      def organizations(reference)
+        reference.xpath("./seriesinfo").map do |si|
+          next unless si[:stream]
+
+          entity = RelatonBib::Organization.new name: si[:stream]
+          { entity: entity, roles: ["author"] }
+        end.compact
+      end
+
+      # @param author [Nokogiri::XML::Document]
+      # @param ref [Nokogiri::XML::Document]
+      # @return [RelatonBib::FullName]
+      def full_name(author, ref)
+        RelatonBib::FullName.new(
+          completename: localized_string(author[:fullname], ref),
+          initials: [localized_string(author[:initials], ref)],
+          surname: [localized_string(author[:surname], ref)],
+        )
+      end
+
+      # @param content [String]
+      # @return [RelatonBib::LocalizedString]
+      def localized_string(content, ref)
+        RelatonBib::LocalizedString.new(content, language(ref))
+      end
+
+      # @param postal [Nokogiri::XML::Document]
+      # @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::Document]
+      # @rerurn [RelatonBib::Address]
+      def address(postal)
+        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::Document]
+      # @return [RelatonBib::Affilation]
+      def affiliation(author)
+        organization = author.at("./organization")
+        RelatonBib::Affilation.new RelatonBib::Organization.new(
+          name: organization.text.empty? ? "IETF" : organization.text,
+          abbreviation: organization[:abbrev] || "IETF",
+        )
+      end
+
+      # @param author [Nokogiri::XML::Document]
+      # @return [String]
+      def contributor_role(author)
+        author[:role] || "author"
+      end
+
+      def month(mon)
+        return mon if /^\d+$/ =~ mon
+
+        Date::MONTHNAMES.index(mon)
+      end
+
+      #
+      # Extract date from reference.
+      #
+      # @return [Array<RelatonBib::BibliographicDate>] published data.
+      #
+      def dates(reference)
+        return unless (date = reference.at "./front/date")
+
+        d = [date[:year], month(date[:month]),
+             (date[:day] || "01")].compact.join "-"
+        date = Time.parse(d).strftime "%Y-%m-%d"
+        [RelatonBib::BibliographicDate.new(type: "published", on: date)]
+      end
+
+      #
+      # Extract document identifiers from reference
+      #
+      # @return [Array<RelatonBib::DocumentIdentifier>]
+      #
+      def docids(reference)
+        id = reference[:anchor].sub(/^(RFC)/, "\\1 ")
+        ret = []
+        ret << RelatonBib::DocumentIdentifier.new(type: "IETF", id: id)
+        ret + reference.xpath("./seriesinfo").map do |si|
+          next unless si[:name] == "DOI"
+
+          RelatonBib::DocumentIdentifier.new(id: si[:value], type: si[:name])
+        end.compact
+      end
+
+      #
+      # Extract series form reference
+      # @param reference [Nokogiri::XML::Document]
+      #
+      # @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::Document]
+      #
+      # @return [RelatonBib::DocumentStatus]
+      #
+      def status(reference)
+        st = reference.at("./seriesinfo[@status]")
+        return unless st
+
+        RelatonBib::DocumentStatus.new(
+          stage: st[:status],
+        )
+      end
+    end
+  end
+  # rubocop:enable Metrics/ModuleLength
+end

data/lib/relaton_ietf/version.rb

@@ -0,0 +1,3 @@
+module RelatonIetf
+  VERSION = "0.1.0".freeze
+end

data/lib/relaton_ietf/xml_parser.rb

@@ -0,0 +1,24 @@
+require "nokogiri"
+
+module RelatonIetf
+  class XMLParser < RelatonBib::XMLParser
+    class << self
+      def from_xml(xml)
+        doc = Nokogiri::XML(xml)
+        ietfitem = doc.at("/bibitem|/bibdata")
+        RelatonIetf::IetfBibliographicItem.new(item_data(ietfitem))
+      end
+
+      private
+
+      def item_data(ietfitem)
+        data = super
+        ext = ietfitem.at "./ext"
+        return data unless ext
+
+        data[:doctype] = ext.at("./doctype")&.text
+        data
+      end
+    end
+  end
+end

data/relaton_ietf.gemspec

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+lib = File.expand_path("lib", __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "relaton_ietf/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "relaton-ietf"
+  spec.version       = RelatonIetf::VERSION
+  spec.authors       = ["Ribose Inc."]
+  spec.email         = ["open.source@ribose.com"]
+
+  spec.summary       = "RelatonIetf: retrieve IETF Standards for bibliographic use "\
+                       "using the BibliographicItem model"
+  spec.description   = <<~DESCRIPTION
+    RelatonIetf: retrieve IETF Standards for bibliographic use 
+    using the BibliographicItem model.
+
+    Formerly known as rfcbib.
+  DESCRIPTION
+  spec.homepage      = "https://github.com/metanorma/relaton-ietf"
+  spec.license       = "BSD-2-Clause"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  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.4.0")
+
+  spec.add_development_dependency "bundler", "~> 2.0.1"
+  spec.add_development_dependency "debase"
+  spec.add_development_dependency "equivalent-xml", "~> 0.6"
+  spec.add_development_dependency "pry-byebug"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.0"
+  spec.add_development_dependency "ruby-debug-ide"
+  spec.add_development_dependency "simplecov"
+  spec.add_development_dependency "vcr"
+  spec.add_development_dependency "webmock"
+
+  spec.add_dependency "relaton-iso-bib", "~> 0.1.0"
+end

metadata

@@ -0,0 +1,221 @@
+--- !ruby/object:Gem::Specification
+name: relaton-ietf
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Ribose Inc.
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2019-06-05 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.0.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.0.1
+- !ruby/object:Gem::Dependency
+  name: debase
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: equivalent-xml
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+- !ruby/object:Gem::Dependency
+  name: pry-byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: ruby-debug-ide
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: vcr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: relaton-iso-bib
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+description: "RelatonIetf: retrieve IETF Standards for bibliographic use \nusing the
+  BibliographicItem model.\n\nFormerly known as rfcbib.\n"
+email:
+- open.source@ribose.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".hound.yml"
+- ".rspec"
+- ".rubocop.yml"
+- ".travis.yml"
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.adoc
+- Rakefile
+- appveyor.yml
+- bin/console
+- bin/setup
+- lib/relaton/processor.rb
+- lib/relaton_ietf.rb
+- lib/relaton_ietf/ietf_bibliographi_item.rb
+- lib/relaton_ietf/ietf_bibliography.rb
+- lib/relaton_ietf/scrapper.rb
+- lib/relaton_ietf/version.rb
+- lib/relaton_ietf/xml_parser.rb
+- relaton_ietf.gemspec
+homepage: https://github.com/metanorma/relaton-ietf
+licenses:
+- BSD-2-Clause
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.4.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.12
+signing_key: 
+specification_version: 4
+summary: 'RelatonIetf: retrieve IETF Standards for bibliographic use using the BibliographicItem
+  model'
+test_files: []