relaton-iec 2.0.0.pre.alpha.3 → 2.0.0.pre.alpha.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ed597ec310f08e21a319b80ba42b45dc9e431a2b14100c18d45353314c44bb80
-  data.tar.gz: c9f4043f6d6e9e98359afea8ff2f6b9499ca408712f65f4c90d514a290fdedfe
+  metadata.gz: ebeb05280a8fbd70863f0fbe6d73d9e8d0955680793374b75dfe11481d27ddf8
+  data.tar.gz: dabab87eabda78692f9dcd031731cc3c1e8a62a71ce1ebba498b25adbd8da484
 SHA512:
-  metadata.gz: c04abe068d4badc329f6e2a7598bf13562b3e21b6163a1d02593b7c52ba91385cd97c1c45aee087f8b909dca148bdaa4bdf58cffaf4e0b35036ddf569e9efb95
-  data.tar.gz: 120b8a7267badaf015db74182579fe079fb43e08d9fc2987c72d7cfb2772581f3467e969c24ad51245d5de8f098a9562d27b45048bf0fd4f0c97164e39481c99
+  metadata.gz: a04af9af473fc47d98cde3b47d4d941fdcc43641860ec1f6fb56132fd053007353d9fc67b617b3f856be18a4cb0af4523be1c2c78a3ea753523d4e0378dcca69
+  data.tar.gz: ff377cf623ba4806c34e78cc2c18e04b0a462ac2875d3daf76e9cf00aee037546c643c63290b18cbb82248f10cbdfdad98beb9ec0816aa3b727444bbef97f7f8

data/README.adoc

@@ -122,7 +122,7 @@ Possible options:
 [source,ruby]
 ----
 item.to_xml
-=> "<bibitem id="IEC600501122010" type="standard" schema-version="v1.4.1">
+=> "<bibitem id="IEC600501122010" type="standard" schema-version="v1.5.6">
       <fetched>2026-02-02</fetched>
       <title language="en" script="Latn" type="title-main">International Electrotechnical Vocabulary (IEV)</title>
       <title language="en" script="Latn" type="title-part">Part 112: Quantities and units</title>
@@ -141,7 +141,7 @@ item.to_xml
     </bibitem>"
 
 item.to_xml bibdata: true
-=> "<bibdata type="standard" schema-version="v1.4.1">
+=> "<bibdata type="standard" schema-version="v1.5.6">
       <fetched>2026-02-02</fetched>
       <title language="en" script="Latn" type="title-main">International Electrotechnical Vocabulary (IEV)</title>
       <title language="en" script="Latn" type="title-part">Part 112: Quantities and units</title>
@@ -157,14 +157,14 @@ item.to_xml bibdata: true
       <docidentifier type="IEC" primary="true">IEC 60050-112:2010</docidentifier>
       <docidentifier type="URN">urn:iec:std:iec:60050-112:2010-01:::</docidentifier>
       ...
-      <ext schema-version="v1.0.0">
+      <ext schema-version="v1.1.2">
         <doctype>international-standard</doctype>
         ...
       </ext>
     </bibdata>"
 
 item.to_xml note: [{ content: "Note", type: "note" }]
-=> "<bibitem id="IEC600501122010" type="standard" schema-version="v1.4.1">
+=> "<bibitem id="IEC600501122010" type="standard" schema-version="v1.5.6">
       ...
       <note type="note">Note</note>
       ...

data/grammars/basicdoc.rng

@@ -187,6 +187,15 @@ Applicable to modify and delete</a:documentation>
         <a:documentation>Optional caption of this block</a:documentation>
       </attribute>
     </optional>
+    <optional>
+      <attribute name="position">
+        <a:documentation>For an "add" change, whether the change is added before or after the location</a:documentation>
+        <choice>
+          <value>before</value>
+          <value>after</value>
+        </choice>
+      </attribute>
+    </optional>
     <optional>
       <element name="location">
         <a:documentation>The location(s) in the original document which have undergone the change described in this block</a:documentation>
@@ -208,11 +217,15 @@ Applicable to modify and delete</a:documentation>
     </zeroOrMore>
     <optional>
       <element name="newcontent">
-        <a:documentation>New content to be added to the document; applicable to add and modify</a:documentation>
+        <a:documentation>New content to be added to the document; applicable to add and modify.
+Can be blocks and/or sections</a:documentation>
         <ref name="OptionalId"/>
         <zeroOrMore>
           <ref name="BasicBlock"/>
         </zeroOrMore>
+        <zeroOrMore>
+          <ref name="section"/>
+        </zeroOrMore>
       </element>
     </optional>
     <zeroOrMore>

data/grammars/biblio.rng

@@ -1142,11 +1142,11 @@ NOTE: This should preferably be encoded as  a URI or short identifier, rather th
         <a:documentation>Information about how long the current description of the bibliographic item is valid for</a:documentation>
       </ref>
     </optional>
-    <optional>
+    <zeroOrMore>
       <ref name="depiction">
         <a:documentation>Depiction of the bibliographic item, typically an image</a:documentation>
       </ref>
-    </optional>
+    </zeroOrMore>
   </define>
   <define name="ReducedBibliographicItem">
     <a:documentation>Reduced description of a bibliographic resource, without mandatory title and docidentifier, used for document relations
@@ -1939,10 +1939,10 @@ Detailed in https://www.relaton.org/model/relations/</a:documentation>
       <value>hasAnnotation</value>
       <value>draftOf</value>
       <value>hasDraft</value>
-      <value>preliminaryDraftOf</value>
-      <value>hasPreliminaryDraft</value>
-      <value>revisionDraftOf</value>
-      <value>hasRevisionDraft</value>
+      <value>predecessorDraftOf</value>
+      <value>hasPredecessorDraft</value>
+      <value>successorDraftOf</value>
+      <value>hasSuccessorDraft</value>
       <value>editionOf</value>
       <value>hasEdition</value>
       <value>updates</value>
@@ -2063,13 +2063,13 @@ provided that it is not the entire bibliographic item that is so related</a:docu
           <ref name="LocalizedString"/>
         </element>
       </optional>
-      <oneOrMore>
+      <zeroOrMore>
         <element name="taxon">
           <a:documentation>The keywords as a hierarchical taxonomy. For example, the sequence of `taxon` elements
 `pump`, `centrifugal pump`, `line shaft pump` represents a taxonomic classification</a:documentation>
           <ref name="LocalizedString"/>
         </element>
-      </oneOrMore>
+      </zeroOrMore>
       <zeroOrMore>
         <ref name="vocabid">
           <a:documentation>Identifiers for the keyword as a controlled vocabulary</a:documentation>

data/lib/relaton/iec/bibliography.rb

@@ -34,7 +34,7 @@ module Relaton
           ref = code.sub(/\s\(all parts\)/, "")
           return iev if ref.casecmp("IEV").zero?
 
-          pubid = Pubid::Iec::Identifier.parse ref.upcase
+          pubid = ::Pubid::Iec::Identifier.parse ref.upcase
           pubid.year = year.to_i if year
 
           ret = iecbib_get(pubid, opts)
@@ -213,7 +213,7 @@ module Relaton
           end
 
           rel.bibitem.docidentifier&.each do |did|
-            year = did.content[/:(\d{4})/, 1]&.to_i
+            year = did.to_s[/:(\d{4})/, 1]&.to_i
             next unless year&.positive?
 
             return false if opts[:publication_date_before] && year >= opts[:publication_date_before].year

data/lib/relaton/iec/data_fetcher.rb

@@ -12,6 +12,10 @@ module Relaton
       #
       # Fetch data from IEC.
       #
+      def log_error(msg)
+        Util.error msg
+      end
+
       def fetch(source = "iec-harmonised-latest") # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
         @all = source == "iec-harmonised-all"
 
@@ -23,6 +27,7 @@ module Relaton
         fetch_all
         index.save
         save_last_change
+        report_errors
       rescue StandardError => e
         Util.error do
           "#{e.message}\n#{e.backtrace.join("\n")}"
@@ -53,7 +58,7 @@ module Relaton
 
       def index
         @index ||= Relaton::Index.find_or_create(
-          :iec, file: "#{INDEXFILE}.yaml", pubid_class: Pubid::Iec::Identifier
+          :iec, file: "#{INDEXFILE}.yaml", pubid_class: ::Pubid::Iec::Identifier
         )
       end
 
@@ -81,7 +86,7 @@ module Relaton
         did = find_primary_docidentifier item
         return unless did
 
-        pubid = parse_pubid(did.content)
+        pubid = parse_pubid(did.to_s)
         index.add_or_update pubid, file if pubid
       rescue StandardError => e
         Util.warn "Failed to index file `#{file}`: #{e.message}"
@@ -184,13 +189,13 @@ module Relaton
       # @param [Hash] pub publication
       #
       def fetch_pub(pub) # rubocop:disable Metrics/MethodLength, Metrics/AbcSize
-        bib = DataParser.new(pub).parse
+        bib = DataParser.new(pub, @errors).parse
         did = bib.docidentifier.detect(&:primary)
-        file = output_file(did.content)
+        file = output_file(did.to_s)
         if @files.include? file then Util.warn "File #{file} exists."
         else
           @files << file
-          pubid = parse_pubid(did.content)
+          pubid = parse_pubid(did.to_s)
           index.add_or_update pubid, file if pubid
         end
         @last_change_max = pub["lastChangeTimestamp"] if last_change_max < pub["lastChangeTimestamp"]
@@ -198,7 +203,7 @@ module Relaton
       end
 
       def parse_pubid(content)
-        Pubid::Iec::Identifier.parse(content)
+        ::Pubid::Iec::Identifier.parse(content)
       rescue StandardError => e
         Util.warn "Failed to parse pubid `#{content}`: #{e.message}"
         nil

data/lib/relaton/iec/data_parser.rb

@@ -31,8 +31,9 @@ module Relaton
       #
       # @param [Hash] pub document data
       #
-      def initialize(pub)
+      def initialize(pub, errors = {})
         @pub = pub
+        @errors = errors
       end
 
       #
@@ -55,10 +56,38 @@ module Relaton
       # @return [Array<Relaton::Bib::Docidentifier>] document identifiers
       #
       def docidentifier
-        ids = []
-        ids << Docidentifier.new(content: @pub["reference"], type: "IEC", primary: true)
-        urnid = "urn:#{@pub['urnAlt'][0]}"
-        ids << Docidentifier.new(content: urnid, type: "URN")
+        result = [iec_docid, urn_docid].compact
+        @errors[:docidentifier] &&= result.empty?
+        result
+      end
+
+      def iec_docid
+        pubid = ::Pubid::Iec::Identifier.parse(@pub["reference"])
+        Docidentifier.new(content: pubid, type: "IEC", primary: true)
+      rescue StandardError => e
+        Util.warn "Failed to parse IEC identifier `#{@pub['reference']}`: #{e.message}"
+        Docidentifier.new(content: @pub["reference"], type: "IEC", primary: true)
+      end
+
+      def urn_docid
+        pubid = parse_urn_pubid
+        return unless pubid
+
+        Docidentifier.new(content: pubid, type: "URN")
+      end
+
+      def parse_urn_pubid
+        if @pub["urnAlt"]&.first
+          urnid = "urn:#{@pub['urnAlt'][0]}"
+          begin
+            return ::Pubid::Iec::Identifier.parse(urnid)
+          rescue StandardError => e
+            Util.warn "Failed to parse URN `#{urnid}`: #{e.message}"
+          end
+        end
+        ::Pubid::Iec::Identifier.parse(@pub["reference"])
+      rescue StandardError
+        nil
       end
 
       #
@@ -67,7 +96,9 @@ module Relaton
       # @return [Array<String>] languages
       #
       def language
-        @pub["title"].map { |t| t["lang"] }.uniq
+        result = @pub["title"].map { |t| t["lang"] }.uniq
+        @errors[:language] &&= result.empty?
+        result
       end
 
       #
@@ -76,10 +107,12 @@ module Relaton
       # @return [Array<String>] scripts
       #
       def script
-        language.each_with_object([]) do |l, s|
+        result = language.each_with_object([]) do |l, s|
           scr = lang_to_script l
           s << scr if scr && !s.include?(scr)
         end
+        @errors[:script] &&= result.empty?
+        result
       end
 
       #
@@ -101,18 +134,26 @@ module Relaton
       # @return [Array<Relaton::Bib::Title>] titles
       #
       def title
-        @pub["title"].reduce([]) do |acc, t|
+        result = @pub["title"].reduce([]) do |acc, t|
           acc + Bib::Title.from_string(t["value"], t["lang"], lang_to_script(t["lang"]))
         end
+        @errors[:title] &&= result.empty?
+        result
       end
 
       def status
-        stage = Bib::Status::Stage.new content: @pub["status"]
-        Bib::Status.new stage: stage
+        result = begin
+          stage = Bib::Status::Stage.new content: @pub["status"]
+          Bib::Status.new stage: stage
+        end
+        @errors[:status] &&= result.nil?
+        result
       end
 
       def edition
-        Bib::Edition.new content: @pub["edition"]
+        result = Bib::Edition.new content: @pub["edition"]
+        @errors[:edition] &&= result.nil?
+        result
       end
 
       #
@@ -121,11 +162,13 @@ module Relaton
       # @return [Array<Relaton::Bib::LocalizedMarkedUpString>] abstract
       #
       def abstract
-        @pub["abstract"]&.map do |a|
-          Bib::LocalizedMarkedUpString.new(
+        result = Array(@pub["abstract"]).map do |a|
+          Bib::Abstract.new(
             content: a["content"], language: a["lang"], script: lang_to_script(a["lang"]),
           )
         end
+        @errors[:abstract] &&= result.empty?
+        result
       end
 
       # @return [Array<Relaton::Bib::Copyright>] copyright
@@ -143,7 +186,9 @@ module Relaton
           org = Bib::Organization.new(name: [orgname], abbreviation: abbrev, uri: [uri])
           Bib::ContributionInfo.new(organization: org)
         end
-        [Bib::Copyright.new(owner: owner, from: from)]
+        result = [Bib::Copyright.new(owner: owner, from: from)]
+        @errors[:copyright] &&= result.empty?
+        result
       end
 
       #
@@ -152,7 +197,7 @@ module Relaton
       # @return [Array<Relaton::Bib::Date>] dates
       #
       def date
-        {
+        result = {
           "published" => "publicationDate",
           "stable-until" => "stabilityDate",
           "confirmed" => "confirmationDate",
@@ -162,6 +207,8 @@ module Relaton
 
           a << Bib::Date.new(type: k, at: @pub[v])
         end
+        @errors[:date] &&= result.empty?
+        result
       end
 
       #
@@ -179,7 +226,9 @@ module Relaton
           role = Bib::Contributor::Role.new(type: "publisher")
           Bib::Contributor.new(organization: org, role: [role])
         end
-        contribs + editorialgroup_contributors
+        result = contribs + editorialgroup_contributors
+        @errors[:contributor] &&= result.empty?
+        result
       end
 
       #
@@ -216,12 +265,14 @@ module Relaton
       def source
         url = "#{DOMAIN}/publication/#{urn_id}"
         l = [Bib::Uri.new(content: url, type: "src")]
-        array(@pub["releaseItems"]).each_with_object(l) do |r, a|
+        result = array(@pub["releaseItems"]).each_with_object(l) do |r, a|
           next unless r["type"] == "PREVIEW"
 
           url = "#{DOMAIN}/preview/#{r['contentRef']['fileName']}"
           a << Bib::Uri.new(content: url, type: "obp")
         end
+        @errors[:source] &&= result.empty?
+        result
       end
 
       #
@@ -240,7 +291,7 @@ module Relaton
       #
       def relation # rubocop:disable Metrics/MethodLength
         try = 0
-        begin
+        result = begin
           uri = URI "#{DOMAIN}/webstore/webstore.nsf/AjaxRequestXML?Openagent&url=#{urn_id}"
           resp = Net::HTTP.get_response uri
           doc = Nokogiri::XML resp.body
@@ -249,6 +300,8 @@ module Relaton
           try += 1
           try < 3 ? retry : raise(e)
         end
+        @errors[:relation] &&= result.empty?
+        result
       end
 
       #
@@ -269,7 +322,7 @@ module Relaton
                 end
           ref = r.at("FULL_NAME").text
           docid = Docidentifier.new(content: ref, type: "IEC", primary: true)
-          bibitem = ItemData.new(formattedref: ref, docidentifier: [docid])
+          bibitem = ItemData.new(formattedref: Bib::Formattedref.new(content: ref), docidentifier: [docid])
           Relation.new type: type, bibitem: bibitem
         end
       end
@@ -279,13 +332,15 @@ module Relaton
       end
 
       def ext
-        Ext.new(
+        result = Ext.new(
           doctype: doctype,
           structuredidentifier: structuredidentifier,
           flavor: "iec",
           ics: ics,
-          price_code: @pub["priceInfo"]["priceCode"],
+          price_code: @pub.dig("priceInfo", "priceCode"),
         )
+        @errors[:ext] &&= result.nil?
+        result
       end
 
       #
@@ -297,8 +352,12 @@ module Relaton
         urn = @pub.dig("project", "urn")
         return unless urn
 
-        pnum = Iso::ProjectNumber.new(content: urn.split(":").last)
-        Iso::StructuredIdentifier.new(project_number: pnum, type: "IEC")
+        result = begin
+          pnum = Iso::ProjectNumber.new(content: urn.split(":").last)
+          Iso::StructuredIdentifier.new(project_number: pnum, type: "IEC")
+        end
+        @errors[:structuredidentifier] &&= result.nil?
+        result
       end
 
       #
@@ -308,7 +367,9 @@ module Relaton
       #
       def doctype
         type = DOCTYPES[@pub["stdType"]] || @pub["stdType"].downcase
-        Doctype.new content: type
+        result = Doctype.new content: type
+        @errors[:doctype] &&= result.nil?
+        result
       end
 
       #
@@ -319,9 +380,11 @@ module Relaton
       def ics
         return [] unless @pub["classifications"]
 
-        @pub["classifications"].select { |c| c["type"] == "ICS" }.map do |c|
+        result = @pub["classifications"].select { |c| c["type"] == "ICS" }.map do |c|
           Bib::ICS.new(code: c["value"])
         end
+        @errors[:ics] &&= result.empty?
+        result
       end
     end
   end

data/lib/relaton/iec/hit_collection.rb

@@ -29,7 +29,7 @@ module Relaton
         parts.reject { |h| h.hit[:id] == hit.hit[:id] }.each do |hi|
           code = hi.hit[:id].to_s
           bib = ItemData.new(
-            formattedref: code,
+            formattedref: Bib::Formattedref.new(content: code),
             docidentifier: [Docidentifier.new(content: code, type: "IEC", primary: true)],
           )
           all_parts_item.relation << Relation.new(type: "partOf", bibitem: bib)
@@ -49,7 +49,7 @@ module Relaton
           url: "#{Hit::GHURL}#{INDEXFILE}.zip",
           file: "#{INDEXFILE}.yaml",
           id_keys: VALID_ID_KEYS,
-          pubid_class: Pubid::Iec::Identifier
+          pubid_class: ::Pubid::Iec::Identifier
         )
       end
 

data/lib/relaton/iec/model/docidentifier.rb

@@ -1,40 +1,75 @@
 module Relaton
   module Iec
-    class Docidentifier < Bib::Docidentifier
-      def remove_date!
-        if type == "URN"
-          # URN format: urn:iec:std:iec:60050-102:2007:::::amd:1:2017
-          # Remove the year portion (5th segment) which may include month
-          self.content = content.sub(/^(urn:iec:std:[^:]+:[^:]+):\d{4}(?:-\d{2})?/, '\1')
-        else
-          self.content = content.sub(/:\d{4}(?=\s|$)/, "")
+    class Pubid < Lutaml::Model::Type::Value
+      class << self
+        def cast(value)
+          value.is_a?(String) ? ::Pubid::Iec::Identifier.parse(value) : value
+        rescue StandardError
+          Util.warn "Failed to parse Pubid: #{value}"
+          value
         end
       end
 
-      def remove_part!
-        if type == "URN"
-          # URN format: urn:iec:std:iec:60050-102:2007:::
-          # Remove the part number(s) from the document number segment (4th segment)
-          self.content = content.sub(/^(urn:iec:std:[^:]+:[^:-]+)-\d+(?:-\d+)*/, '\1')
-        else
-          self.content = content.sub(/-\d+(?:-\d+)*/, "")
-        end
+      ::Lutaml::Model::Config::AVAILABLE_FORMATS.each do |format|
+        define_method(:"to_#{format}") { value.to_s }
       end
 
-      def remove_stage!
-        # IEC IDs don't have stage indicators - no-op
+      def to_h = value.to_h
+      def urn = value.urn
+    end
+
+    class Docidentifier < Bib::Docidentifier
+      attribute :content, Pubid
+
+      def content_to_xml(model, parent, doc)
+        doc.add_xml_fragment parent, model.to_s
+      end
+
+      def content_to_key_value(model, doc)
+        doc["content"] = model.to_s
       end
 
       def to_all_parts!
+        if content.is_a? String
+          Util.warn "Cannot convert String to all parts: #{content}"
+          return
+        end
+
         remove_part!
         remove_date!
         remove_stage!
-        if type == "URN"
-          self.content += "ser" unless content.end_with?(":ser")
-        elsif type == "IEC" && !content.include?(" (all parts)")
-          self.content += " (all parts)"
+        content.all_parts = true if content.respond_to?(:all_parts=)
+      end
+
+      def remove_stage!
+        remove_attr! :stage
+      end
+
+      def remove_part!
+        remove_attr! :part
+      end
+
+      def remove_date!
+        remove_attr! :year
+      end
+
+      def to_s
+        return content if content.is_a? String
+
+        case type
+        when "URN" then content.urn
+        else content.to_s
         end
       end
+
+      private
+
+      def remove_attr!(attr)
+        return false if content.is_a? String
+
+        content.send(:"#{attr}=", nil)
+        true
+      end
     end
   end
 end

data/lib/relaton/iec/version.rb

@@ -1,5 +1,5 @@
 module Relaton
   module Iec
-    VERSION = "2.0.0-alpha.3".freeze
+    VERSION = "2.0.0-alpha.4".freeze
   end
 end

data/relaton_iec.gemspec

@@ -25,9 +25,9 @@ Gem::Specification.new do |spec|
 
   spec.add_dependency "addressable"
   spec.add_dependency "base64"
-  spec.add_dependency "pubid-iec", "~> 1.15.6"
-  spec.add_dependency "relaton-core", "~> 0.0.9"
+  spec.add_dependency "pubid-iec", "~> 1.15.11"
+  spec.add_dependency "relaton-core", "~> 0.0.13"
   spec.add_dependency "relaton-index", "~> 0.2.20"
-  spec.add_dependency "relaton-iso", "~> 2.0.0-alpha.2"
+  spec.add_dependency "relaton-iso", "~> 2.0.0-alpha.7"
   spec.add_dependency "rubyzip"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: relaton-iec
 version: !ruby/object:Gem::Version
-  version: 2.0.0.pre.alpha.3
+  version: 2.0.0.pre.alpha.4
 platform: ruby
 authors:
 - Ribose Inc.
@@ -43,28 +43,28 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.15.6
+        version: 1.15.11
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.15.6
+        version: 1.15.11
 - !ruby/object:Gem::Dependency
   name: relaton-core
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.0.9
+        version: 0.0.13
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.0.9
+        version: 0.0.13
 - !ruby/object:Gem::Dependency
   name: relaton-index
   requirement: !ruby/object:Gem::Requirement
@@ -85,14 +85,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.0.0.pre.alpha.2
+        version: 2.0.0.pre.alpha.7
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.0.0.pre.alpha.2
+        version: 2.0.0.pre.alpha.7
 - !ruby/object:Gem::Dependency
   name: rubyzip
   requirement: !ruby/object:Gem::Requirement