relaton-iec 1.7.8 → 1.10.1

data/lib/relaton_iec/basic_block/index.rb

@@ -0,0 +1,27 @@
+module BasicBlock
+  class Index
+    #
+    # @param [Array<BasicBlock::TextElement] primary
+    # @param [Hash] args
+    # @option args [String, nil] :to
+    # @option args [Array<BasicBlock::TextElement>, nil] :secondary
+    # @option args [Array<BasicBlock::TextElement>, nil] :tertiary
+    #
+    def initialize(primary:, **args)
+      @to = args[:to]
+      @primary = primary
+      @secondary = args[:secondary]
+      @tertiary = args[:tertiary]
+    end
+
+    # @param [Nokogiri::XML::Builder] builder
+    def to_xml(builder) # rubocop:disable Metrics/CyclomaticComplexity
+      idx = builder.index do |b|
+        @primary.each { |p| p.to_xml b }
+        @secondary&.each { |s| s.to_xml b }
+        @tertiary&.each { |t| t.to_xml b }
+      end
+      idx[:to] = @to if @to
+    end
+  end
+end

data/lib/relaton_iec/basic_block/index_xref.rb

@@ -0,0 +1,31 @@
+module BasicBlock
+  class IndexXref
+    #
+    # @param [Boolean] also
+    # @param [Array<BasicBlock::TextElement>] primary
+    # @param [Array<BasicBlock::TextElement>] target
+    # @param [Hash] args
+    # @option args [Array<BasicBlock::TextElement>, nil] secondary
+    # @option args [Array<BasicBlock::TextElement>, nil] tertiary
+    #
+    def initialize(also:, primary:, target:, **args)
+      @also = also
+      @primary = primary
+      @target = target
+      @secondary = args[:secondary]
+      @tertiary = args[:tertiary]
+    end
+
+    #
+    # @param [Nokogiri::XML::Builder] builder
+    #
+    def to_xml(builder) # rubocop:disable Metrics/CyclomaticComplexity
+      builder.send "index-xref", also: @also do |b|
+        @primary.each { |p| p.to_xml b }
+        @secondary&.each { |s| s.to_xml b }
+        @tertiary&.each { |t| t.to_xml b }
+        @target.each { |t| t.to_xml b }
+      end
+    end
+  end
+end

data/lib/relaton_iec/basic_block/note.rb

@@ -0,0 +1,21 @@
+module BasicBlock
+  class Note
+    #
+    # @param [String] id
+    # @param [Array<BasicBlock::Paragraph>] content
+    #
+    def initialize(id:, content:)
+      @id = id
+      @contain = content
+    end
+
+    #
+    # @param [Nokogiei::XMO::Builder] builder
+    #
+    def to_xml(builder)
+      builder.note id: @id do |b|
+        @content.each { |c| c.to_xm b }
+      end
+    end
+  end
+end

data/lib/relaton_iec/basic_block/paragraph.rb

@@ -0,0 +1,27 @@
+module BasicBlock
+  class Paragraph
+    #
+    # @param [String] id
+    # @param [Array<BasicBlock::TextElement>] content
+    # @param [Array<BasicBlock::Note>] note
+    # @param [BasicBlock::Alignment, nil] align
+    #
+    def initialize(id:, content:, note:, align: nil)
+      @id = id
+      @content = content
+      @note = note
+      @align = align
+    end
+  end
+
+  #
+  # @param [Nokogiri::XML::Builder] builder
+  #
+  def to_xml(builder)
+    p = builder.p id: @id do |b|
+      @content.each { |c| c.to_xml b }
+      @note.each { |n| n.to_xml b }
+    end
+    p[:align] = @align if @align
+  end
+end

data/lib/relaton_iec/basic_block/paragraph_with_footnote.rb

@@ -0,0 +1,29 @@
+module BasicBlock
+  class ParagraphWithFootnote
+    #
+    # @param [String] id
+    # @param [Hash] args
+    # @param [BasicBlock::Alignment, nil] align
+    # @param [Array<BasicBlock::TextElement, BasicBlock::Eref, BasicBlock::Stem,
+    #   BasicBlock::Image, BasicBlock::Index, BasicBlock::IndexXref>] content
+    # @param [Array<RelatonIec::Note>] note
+    #
+    def initialize(id:, align: nil, content: [], note: [])
+      @id = id
+      @aligments = align
+      @content = content
+      @note = note
+    end
+
+    #
+    # @param [Nokogiri::XML::Builder] builder
+    #
+    def to_xml(builder)
+      elm = builder.p(@id) do |b|
+        @content.each { |te| te.to_xml b }
+        @note.each { |n| n.to_xml b }
+      end
+      elm[:align] = @align if @align
+    end
+  end
+end

data/lib/relaton_iec/basic_block/reference_format.rb

@@ -0,0 +1,38 @@
+module RelatonIec
+  def self.respond_to_missing?(method, _include_private)
+    method == "ReferenceFormat"
+  end
+
+  def self.method_missing(_method, *args)
+    ReferenceFormat.new *args
+  end
+
+  class ReferenceFormat
+    FORMATS = %w[external inline footnote callout].freeze
+
+    #
+    # @param [String] format
+    #
+    def initialize(format)
+      unless FORMATS.include? format
+        warn "[relaton-iec] WARNING: invalid reference format \"#{format}\""
+        warn "[relaton-iec] alloved reference formats are: #{FORMATS.join ', '}"
+      end
+      @format = format
+    end
+
+    #
+    # @return [String]
+    #
+    def to_s
+      @format
+    end
+
+    #
+    # @return [Sting] <description>
+    #
+    def inspect
+      to_s
+    end
+  end
+end

data/lib/relaton_iec/basic_block/stem.rb

@@ -0,0 +1,30 @@
+module BasicBlock
+  class Stem
+    TYPES = %w[MathML AsciiMath].freeze
+
+    # @return [String]
+    attr_reader :type
+
+    #
+    # @param [String] type
+    # @param [Array<#to_xml>] content any element
+    #
+    def initialize(type:, content: [])
+      unless TYPES.include? type
+        warn "[relaton-iec] WARNING: invalud type \"#{type}\""
+        warn "[relaton-iec] allowed types are: #{TYPES.join ', '}"
+      end
+      @type = type
+      @content = content
+    end
+
+    #
+    # @param [Nokogiri::XML::Builder] builder
+    #
+    def to_xml(builder)
+      builder.stem(type) do |b|
+        content.each { |c| c.to_xml b }
+      end
+    end
+  end
+end

data/lib/relaton_iec/basic_block/table.rb

@@ -0,0 +1,115 @@
+module BasicBlock
+  class Table
+    #
+    # @param [String] id
+    # @param [Array<BasicBlock::Tr>] tbody
+    # @param [Array<BasicBlock::Paragraph>] note
+    # @param [Hash] args
+    # @option args [Boolean, nil] :unnumbered
+    # @option args [String, nil] :subsequence
+    # @option args [String, nil] :alt
+    # @option args [String, nil] :summary
+    # @option args [String, nil] :uri
+    # @option args [BasicBlock::TextElement, nil] :tname
+    # @option args [BasicBlock::Table::Tr, nil] :thead
+    # @option args [BasicBlock::TextElement, nil] :tfoot
+    # @option args [BasicBlock::Dl, nil] :dl
+    #
+    def initialize(id:, tbody:, note:, **args) # rubocop:disable Metrics/MethodLength
+      @id = id
+      @unnumbered = args[:unnumbered]
+      @subsequence = args[:subsequence]
+      @alt = args[:alt]
+      @summary = args[:summary]
+      @uri = args[:uri]
+      @tname = args[:tname]
+      @thead = args[:thead]
+      @tbody = tbody
+      @tfoot = args[:tfoot]
+      @note = note
+      @dl = args[:dl]
+    end
+
+    # @param [Nokogiri::XML::Builder] builder
+    def to_xml(builder) # rubocop:disable Metrics/AbcSize,Metrics/CyclomaticComplexity,Metrics/MethodLength,Metrics/PerceivedComplexity
+      tab = builder.table id: @id do |b|
+        b.name { @tname.to_xml b } if @tname
+        b.thead { @thead.to_xml b } if @thead
+        @tbody.each { |tb| tb.to_xml b }
+        b.name { @tfoot.to_xml b } if @tfoot
+        @note.each { |n| b.note { n.to_xml b } }
+        @dl.to_xml b
+      end
+      tab[:unnumbered] = @unnumbered if @unnumbered
+      tab[:subsequence] = @subsequence if @subsequence
+      tab[:alt] = @alt if @alt
+      tab[:summary] = @summary if @summary
+      tab[:uri] = @uri if @uri
+    end
+
+    class Tr
+      # @param [Array<BasicBlock::Table::Td, BasicBlock::Table::Th>] content
+      def initialize(content)
+        @content = content
+      end
+
+      # @param [Nokogiri::XML::Builder] builder
+      def to_xml(builder)
+        builder.tr do |b|
+          @content.each { |c| c.to_xm b }
+        end
+      end
+    end
+
+    class TabCell
+      ALIGNS = %w[left right ceter].freeze
+      VALIGNS = %w[top middle bottom baseline].freeze
+
+      # @param [Array<BasicBlock::TextElement,
+      #   BasicBlock::ParagraphWithFootnote>] content
+      # @param [Hssh] args
+      # @option args [String, nil] :colspan
+      # @option args [String, nil] :rowspan
+      # @option args [String, nil] :align
+      # @option args [String, nil] :valign
+      def initialize(content, **args) # rubocop:disable Metrics/AbcSize,Metrics/MethodLength
+        if args[:align] && !ALIGNS.include?(args[:align])
+          warn "[basic-block] WARNING: invalid table/tr/td align \"#{args[:align]}\""
+          warn "[basic-block] alloved aligns are: #{ALIGNS.join ', '}"
+        end
+        if args[:valign] && !VALIGNS.include?(args[:valign])
+          warn "[basic-block] WARNING: invalid table/tr/td valign \"#{args[:valign]}\""
+          warn "[basic-block] alloved valigns are: #{VALIGNS.join ', '}"
+        end
+        @content = content
+        @colspan = args[:colspan]
+        @rowspan = args[:rowspan]
+        @align = args[:align]
+        @valign = args[:valign]
+      end
+
+      # @param [Nokogiri::XML::Builder] builder
+      def to_xml(builder)
+        td = @content.each { |c| c.to_xml builder }
+        td[:colspan] = @colspan if @colspan
+        td[:rowspan] = @rowspan if @rowspan
+        td[:align] = @align if @align
+        td[:valign] = @valign if @valign
+      end
+    end
+
+    class Td < BasicBlock::Table::TabCell
+      # @param [Nokogiri::XML::Builder] builder
+      def to_xml(builder)
+        builder.th { super }
+      end
+    end
+
+    class Th < BasicBlock::Table::TabCell
+      # @param [Nokogiri::XML::Builder] builder
+      def to_xml(builder)
+        builder.td { super }
+      end
+    end
+  end
+end

data/lib/relaton_iec/basic_block/text_element.rb

@@ -0,0 +1,27 @@
+module BasicBlock
+  class TextElement
+    TAGS = %w[em strong sub sup tt underline strike smallcap br hr keyword rp
+              rt ruby pagebreak bookmark].freeze
+
+    #
+    # @param [String] tag
+    # @param [Array<String, BasicBlock::TextElement, BasicBlock::Stem>,
+    #   String] content
+    #
+    def initialize(tag:, content:)
+      unless TAGS.include? tag
+        warn "[basic-block] WARNING: invalid tag \"#{tag}\""
+        warn "[basic-block] allowed tags are: #{TAGS.join ', '}"
+      end
+      @tag = tag
+      @content = content
+    end
+
+    # @param [Nokogiri::XML::Builder]
+    def to_xml(builder)
+      builder.send @tag do |b|
+        @content.each { |c| c.is_a?(String) ? c : c.to_xml(b) }
+      end
+    end
+  end
+end

data/lib/relaton_iec/hit_collection.rb

@@ -25,7 +25,7 @@ module RelatonIec
     def to_all_parts # rubocop:disable Metrics/AbcSize,Metrics/MethodLength,Metrics/CyclomaticComplexity
       parts = @array.reject { |h| h.part.nil? }
       hit = parts.min_by &:part
-      return @array.first.fetch lang unless hit
+      return @array.first&.fetch unless hit
 
       bibitem = hit.fetch
       all_parts_item = bibitem.to_all_parts

data/lib/relaton_iec/iec_bibliographic_item.rb

@@ -3,14 +3,99 @@ module RelatonIec
     TYPES = %w[
       international-standard technical-specification technical-report
       publicly-available-specification international-workshop-agreement
-      guide
+      guide industry-technical-agreement
     ].freeze
 
+    FUNCTION = %w[emc safety enviroment quality-assurance].freeze
+
+    # @return [String, nil]
+    attr_reader :function, :updates_document_type, :price_code, :secretary,
+                :interest_to_committees
+
+    # @return [Boolean, nil]
+    attr_reader :accessibility_color_inside, :cen_processing
+
+    # attr_reader :tc_sc_officers_note
+
+    def initialize(**args) # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
+      if args[:function] && !FUNCTION.include?(args[:function])
+        warn "[relaton-iec] WARNING: invalid function \"#{args[:function]}\""
+        warn "[relaton-iec] allowed function values are: #{FUNCTION.join(', ')}"
+      end
+      if args[:updates_document_type] &&
+          !TYPES.include?(args[:updates_document_type])
+        warn "[relaton-iec] WARNING: invalid updates_document_type "\
+          "\"#{args[:updates_document_type]}\""
+        warn "[relaton-iec] allowed updates_document_type values are: "\
+          "#{TYPES.join(', ')}"
+      end
+      @function = args.delete :function
+      @updates_document_type = args.delete :updates_document_type
+      @accessibility_color_inside = args.delete :accessibility_color_inside
+      @price_code = args.delete :price_code
+      @cen_processing = args.delete :cen_processing
+      @secretary = args.delete :secretary
+      @interest_to_committees = args.delete :interest_to_committees
+      super
+    end
+
     # @param hash [Hash]
     # @return [RelatonIsoBib::IecBibliographicItem]
     def self.from_hash(hash)
       item_hash = ::RelatonIec::HashConverter.hash_to_bib(hash)
       new **item_hash
     end
+
+    # @param opts [Hash]
+    # @option opts [Nokogiri::XML::Builder] :builder XML builder
+    # @option opts [Boolean] :bibdata
+    # @option opts [String] :lang language
+    # @return [String] XML
+    def to_xml(**opts) # rubocop:disable Metrics/AbcSize,Metrics/MethodLength,Metrics/CyclomaticComplexity,Metrics/PerceivedComplexity
+      super **opts do |b|
+        if opts[:bibdata]
+          b.ext do
+            b.doctype doctype if doctype
+            b.horizontal horizontal unless horizontal.nil?
+            b.function function if function
+            editorialgroup&.to_xml b
+            ics.each { |i| i.to_xml b }
+            structuredidentifier&.to_xml b
+            b.stagename stagename if stagename
+            if updates_document_type
+              b.send("updates-document-type", updates_document_type)
+            end
+            unless accessibility_color_inside.nil?
+              b.send("accessibility-color-inside", accessibility_color_inside)
+            end
+            b.send("price-code", price_code) if price_code
+            b.send("cen-processing", cen_processing) unless cen_processing.nil?
+            b.secretary secretary if secretary
+            if interest_to_committees
+              b.send("interest-to-committees", interest_to_committees)
+            end
+          end
+        end
+      end
+    end
+
+    # @return [Hash]
+    def to_hash # rubocop:disable Metrics/AbcSize,Metrics/CyclomaticComplexity,Metrics/MethodLength,Metrics/PerceivedComplexity
+      hash = super
+      hash["function"] = function if function
+      if updates_document_type
+        hash["updates_document_type"] = updates_document_type
+      end
+      unless accessibility_color_inside.nil?
+        hash["accessibility_color_inside"] = accessibility_color_inside
+      end
+      hash["price_code"] = price_code if price_code
+      hash["cen_processing"] = cen_processing unless cen_processing.nil?
+      hash["secretary"] = secretary if secretary
+      if interest_to_committees
+        hash["interest_to_committees"] = interest_to_committees
+      end
+      hash
+    end
   end
 end

data/lib/relaton_iec/scrapper.rb

@@ -9,6 +9,11 @@ module RelatonIec
   # Scrapper.
   module Scrapper
     DOMAIN = "https://webstore.iec.ch"
+    ABBREVS = {
+      "ISO" => ["International Organization for Standardization", "www.iso.org"],
+      "IEC" => ["International Electrotechnical Commission", "www.iec.ch"],
+      "CISPR" => ["International special committee on radio interference", "www.iec.ch"],
+    }.freeze
 
     TYPES = {
       "ISO" => "international-standard",
@@ -36,7 +41,7 @@ module RelatonIec
 
         # Fetch edition.
         edition = doc.at(
-          "//th[contains(., 'Edition')]/following-sibling::td/span"
+          "//th[contains(., 'Edition')]/following-sibling::td/span",
         ).text
 
         status, relations = fetch_status_relations hit_data[:url]
@@ -59,7 +64,7 @@ module RelatonIec
           copyright: fetch_copyright(hit_data[:code], doc),
           link: fetch_link(doc, hit_data[:url]),
           relation: relations,
-          place: ["Geneva"]
+          place: ["Geneva"],
         )
       end
       # rubocop:enable Metrics/AbcSize, Metrics/MethodLength
@@ -71,7 +76,7 @@ module RelatonIec
       def fetch_docid(hit)
         urn = RelatonIec.code_to_urn hit[:code], "en"
         [
-          RelatonBib::DocumentIdentifier.new(id: hit[:code], type: "IEC"),
+          RelatonBib::DocumentIdentifier.new(id: hit[:code], type: "IEC", primary: true),
           RelatonBib::DocumentIdentifier.new(id: urn, type: "URN"),
         ]
       end
@@ -121,12 +126,12 @@ module RelatonIec
         item_ref = doc.at("//span[@itemprop='productID']")
         unless item_ref
           return RelatonIsoBib::StructuredIdentifier.new(
-            project_number: "?", part_number: "", prefix: nil, id: "?"
+            project_number: "?", part_number: "", prefix: nil, id: "?",
           )
         end
 
         m = item_ref.text.match(
-          /(?<=\s)(?<project>\d+)-?(?<part>(?<=-)\d+|)-?(?<subpart>(?<=-)\d+|)/
+          /(?<=\s)(?<project>\d+)-?(?<part>(?<=-)\d+|)-?(?<subpart>(?<=-)\d+|)/,
         )
         RelatonIsoBib::StructuredIdentifier.new(
           project_number: m[:project],
@@ -134,7 +139,7 @@ module RelatonIec
           subpart_number: m[:subpart],
           prefix: nil,
           type: "IEC",
-          id: item_ref.text
+          id: item_ref.text,
         )
       end
 
@@ -190,7 +195,7 @@ module RelatonIec
                  else r_type
                  end
           fref = RelatonBib::FormattedRef.new(
-            content: r.at("FULL_NAME").text, format: "text/plain"
+            content: r.at("FULL_NAME").text, format: "text/plain",
           )
           bibitem = IecBibliographicItem.new(formattedref: fref)
           { type: type, bibitem: bibitem }
@@ -199,8 +204,8 @@ module RelatonIec
 
       def fetch_status_relations(url)
         pubid = url.match(/\d+$/).to_s
-        uri = URI DOMAIN + "/webstore/webstore.nsf/AjaxRequestXML?"\
-        "Openagent&url=" + pubid
+        uri = URI "#{DOMAIN}/webstore/webstore.nsf/AjaxRequestXML?"\
+                  "Openagent&url=#{pubid}"
         resp = Net::HTTP.get_response uri
         doc = Nokogiri::XML resp.body
         status = fetch_status doc
@@ -214,7 +219,7 @@ module RelatonIec
       # @return [String]
       def fetch_type(doc)
         doc.at(
-          '//th[contains(., "Publication type")]/following-sibling::td/span'
+          '//th[contains(., "Publication type")]/following-sibling::td/span',
         ).text.downcase.tr " ", "-"
       end
 
@@ -253,9 +258,9 @@ module RelatonIec
       # @return [Array<Hash>]
       def fetch_ics(doc)
         doc.xpath(
-          '//th[contains(text(), "ICS")]/following-sibling::td/a'
+          '//th[contains(text(), "ICS")]/following-sibling::td/a',
         ).map do |i|
-          code = i.text.match(/[\d\.]+/).to_s.split "."
+          code = i.text.match(/[\d.]+/).to_s.split "."
           { field: code[0], group: code[1], subgroup: code[2] }
         end
       end
@@ -292,11 +297,7 @@ module RelatonIec
       # rubocop:enable Metrics/MethodLength
 
       def name_url(abbrev)
-        case abbrev
-        when "ISO" then ["International Organization for Standardization", "www.iso.org"]
-        when "IEC" then ["International Electrotechnical Commission", "www.iec.ch"]
-        when "CISPR" then ["International special committee on radio interference", "www.iec.ch"]
-        end
+        ABBREVS[abbrev]
       end
     end
   end

data/lib/relaton_iec/tc_sc_officers_note.rb

@@ -0,0 +1,24 @@
+module RelatonIec
+  class TcScOfficersNote
+    # @return [Array<RelatonIec::BasicBlock>]
+    attr_reader :basic_blocks
+
+    #
+    # @param [Array<BasicBlock::ParagraphWithFootnote>] basic_blocks
+    #
+    def initialize(basic_blocks)
+      @basic_blocks = basic_blocks
+    end
+
+    #
+    # XML serialization
+    #
+    # @param [Nokogiri::XML::Builder] builder
+    #
+    def to_xml(builder)
+      builder.send "tc-sc-officers-note" do |b|
+        basic_blocks.each { |bb| bb.to_xml b }
+      end
+    end
+  end
+end

data/lib/relaton_iec/version.rb

@@ -1,3 +1,3 @@
 module RelatonIec
-  VERSION = "1.7.8".freeze
+  VERSION = "1.10.1".freeze
 end

data/lib/relaton_iec/xml_parser.rb

@@ -1,6 +1,26 @@
 module RelatonIec
   class XMLParser < RelatonIsoBib::XMLParser
     class << self
+      # Override RelatonIsoBib::XMLParser.item_data method.
+      # @param isoitem [Nokogiri::XML::Element]
+      # @returtn [Hash]
+      def item_data(isoitem) # rubocop:disable Metrics/AbcSize,Metrics/CyclomaticComplexity,Metrics/MethodLength,Metrics/PerceivedComplexity
+        data = super
+        ext = isoitem.at "./ext"
+        return data unless ext
+
+        data[:function] = ext.at("./function")&.text
+        data[:updates_document_type] = ext.at("./updates-document-type")&.text
+        aci = ext.at("./accessibility-color-inside")
+        data[:accessibility_color_inside] = aci.text == "true" if aci
+        data[:price_code] = ext.at("./price-code")&.text
+        cp = ext.at("./cen-processing")
+        data[:cen_processing] = cp.text == "true" if cp
+        data[:secretary] = ext.at("./secretary")&.text
+        data[:interest_to_committees] = ext.at("./interest-to-committees")&.text
+        data
+      end
+
       private
 
       # override RelatonIsoBib::IsoBibliographicItem.bib_item method

data/relaton_iec.gemspec

@@ -21,19 +21,17 @@ 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.4.0")
+  spec.required_ruby_version = Gem::Requirement.new(">= 2.5.0")
 
-  # 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 "ruby-jing"
   spec.add_development_dependency "simplecov"
   spec.add_development_dependency "vcr"
   spec.add_development_dependency "webmock"
 
   spec.add_dependency "addressable"
-  spec.add_dependency "relaton-iso-bib", "~> 1.7.0"
+  spec.add_dependency "relaton-iso-bib", "~> 1.10.1"
 end