metanorma-iec 0.0.1

data/spec/asciidoctor-iec/inline_spec.rb

@@ -0,0 +1,162 @@
+require "spec_helper"
+
+RSpec.describe Asciidoctor::Iec do
+  it "processes inline_quoted formatting" do
+    expect(strip_guid(Asciidoctor.convert(<<~"INPUT", backend: :iec, header_footer: true))).to be_equivalent_to <<~"OUTPUT"
+      #{ASCIIDOC_BLANK_HDR}
+      _emphasis_
+      *strong*
+      `monospace`
+      "double quote"
+      'single quote'
+      super^script^
+      sub~script~
+      stem:[a_90]
+      stem:[<mml:math><mml:msub xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:m="http://schemas.openxmlformats.org/officeDocument/2006/math"> <mml:mrow> <mml:mrow> <mml:mi mathvariant="bold-italic">F</mml:mi> </mml:mrow> </mml:mrow> <mml:mrow> <mml:mrow> <mml:mi mathvariant="bold-italic">&#x391;</mml:mi> </mml:mrow> </mml:mrow> </mml:msub> </mml:math>]
+      [alt]#alt#
+      [deprecated]#deprecated#
+      [domain]#domain#
+      [strike]#strike#
+      [smallcap]#smallcap#
+    INPUT
+            #{BLANK_HDR}
+       <sections>
+         <em>emphasis</em>
+       <strong>strong</strong>
+       <tt>monospace</tt>
+       “double quote”
+       ‘single quote’
+       super<sup>script</sup>
+       sub<sub>script</sub>
+       <stem type="MathML"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub><mi>a</mi><mn>90</mn></msub></math></stem>
+       <stem type="MathML"><math xmlns="http://www.w3.org/1998/Math/MathML"><msub> <mrow> <mrow> <mi mathvariant="bold-italic">F</mi> </mrow> </mrow> <mrow> <mrow> <mi mathvariant="bold-italic">Α</mi> </mrow> </mrow> </msub> </math></stem>
+       <admitted>alt</admitted>
+       <deprecates>deprecated</deprecates>
+       <domain>domain</domain>
+       <strike>strike</strike>
+       <smallcap>smallcap</smallcap>
+       </sections>
+       </iso-standard>
+    OUTPUT
+  end
+
+  it "processes breaks" do
+    expect(strip_guid(Asciidoctor.convert(<<~"INPUT", backend: :iec, header_footer: true))).to be_equivalent_to <<~"OUTPUT"
+      #{ASCIIDOC_BLANK_HDR}
+      Line break +
+      line break
+
+      '''
+
+      <<<
+    INPUT
+            #{BLANK_HDR}
+       <sections><p id="_">Line break<br/>
+       line break</p>
+       <hr/>
+       <pagebreak/></sections>
+       </iso-standard>
+    OUTPUT
+  end
+
+  it "processes links" do
+    expect(strip_guid(Asciidoctor.convert(<<~"INPUT", backend: :iec, header_footer: true))).to be_equivalent_to <<~"OUTPUT"
+      #{ASCIIDOC_BLANK_HDR}
+      mailto:fred@example.com
+      http://example.com[]
+      http://example.com[Link]
+    INPUT
+            #{BLANK_HDR}
+       <sections>
+         <p id="_">mailto:fred@example.com
+       <link target="http://example.com"/>
+       <link target="http://example.com">Link</link></p>
+       </sections>
+       </iso-standard>
+    OUTPUT
+  end
+
+    it "processes bookmarks" do
+    expect(strip_guid(Asciidoctor.convert(<<~"INPUT", backend: :iec, header_footer: true))).to be_equivalent_to <<~"OUTPUT"
+      #{ASCIIDOC_BLANK_HDR}
+      Text [[bookmark]] Text
+    INPUT
+            #{BLANK_HDR}
+       <sections>
+         <p id="_">Text <bookmark id="bookmark"/> Text</p>
+       </sections>
+       </iso-standard>
+    OUTPUT
+    end
+
+    it "processes crossreferences" do
+      expect(strip_guid(Asciidoctor.convert(<<~"INPUT", backend: :iec, header_footer: true))).to be_equivalent_to <<~"OUTPUT"
+      #{ASCIIDOC_BLANK_HDR}
+      [[reference]]
+      == Section
+
+      Inline Reference to <<reference>>
+      Footnoted Reference to <<reference,fn>>
+      Inline Reference with Text to <<reference,text>>
+      Footnoted Reference with Text to <<reference,fn: text>>
+    INPUT
+       #{BLANK_HDR}
+        <sections>
+         <clause id="reference" inline-header="false" obligation="normative">
+         <title>Section</title>
+         <p id="_">Inline Reference to <xref target="reference"/>
+       Footnoted Reference to <xref target="reference"/>
+       Inline Reference with Text to <xref target="reference">text</xref>
+       Footnoted Reference with Text to <xref target="reference">text</xref></p>
+       </clause>
+       </sections>
+       </iso-standard>
+      OUTPUT
+    end
+
+    it "processes bibliographic anchors" do
+      expect(strip_guid(Asciidoctor.convert(<<~"INPUT", backend: :iec, header_footer: true))).to be_equivalent_to <<~"OUTPUT"
+      #{ASCIIDOC_BLANK_HDR}
+      [bibliography]
+      == Normative References
+
+      * [[[ISO712,x]]] Reference
+      * [[[ISO713]]] Reference
+
+    INPUT
+            #{BLANK_HDR}
+       <sections>
+
+       </sections><bibliography><references id="_" obligation="informative">
+         <title>Normative References</title>
+         <bibitem id="ISO712">
+         <formattedref format="application/x-isodoc+xml">Reference</formattedref>
+         <docidentifier>x</docidentifier>
+       </bibitem>
+         <bibitem id="ISO713">
+         <formattedref format="application/x-isodoc+xml">Reference</formattedref>
+         <docidentifier>ISO713</docidentifier>
+       </bibitem>
+       </references>
+       </bibliography>
+       </iso-standard>
+    OUTPUT
+  end
+
+  it "processes footnotes" do
+      expect(strip_guid(Asciidoctor.convert(<<~"INPUT", backend: :iec, header_footer: true))).to be_equivalent_to <<~"OUTPUT"
+      #{ASCIIDOC_BLANK_HDR}
+      Hello!footnote:[Footnote text]
+    INPUT
+            #{BLANK_HDR}
+       <sections>
+         <p id="_">Hello!<fn reference="1">
+         <p id="_">Footnote text</p>
+       </fn></p>
+       </sections>
+       </iso-standard>
+    OUTPUT
+  end
+
+
+end

data/spec/asciidoctor-iec/lists_spec.rb

@@ -0,0 +1,190 @@
+require "spec_helper"
+
+RSpec.describe Asciidoctor::Iec do
+  it "processes simple lists" do
+    output = Asciidoctor.convert(<<~"INPUT", backend: :iec, header_footer: true)
+      #{ASCIIDOC_BLANK_HDR}
+      * List 1
+      * List 2
+      * List 3
+
+      . List A
+      . List B
+      . List C
+
+      List D:: List E
+      List F:: List G
+
+    INPUT
+    expect(strip_guid(output)).to be_equivalent_to <<~"OUTPUT"
+            #{BLANK_HDR}
+       <sections>
+         <ul id="_">
+         <li>
+           <p id="_">List 1</p>
+         </li>
+         <li>
+           <p id="_">List 2</p>
+         </li>
+         <li>
+           <p id="_">List 3</p>
+           <ol id="_" type="arabic">
+         <li>
+           <p id="_">List A</p>
+         </li>
+         <li>
+           <p id="_">List B</p>
+         </li>
+         <li>
+           <p id="_">List C</p>
+           <dl id="_">
+         <dt>List D</dt>
+         <dd>
+           <p id="_">List E</p>
+         </dd>
+         <dt>List F</dt>
+         <dd>
+           <p id="_">List G</p>
+         </dd>
+       </dl>
+         </li>
+       </ol>
+         </li>
+       </ul>
+       </sections>
+       </iso-standard>
+    OUTPUT
+  end
+
+    it "processes complex lists" do
+    output = Asciidoctor.convert(<<~"INPUT", backend: :iec, header_footer: true)
+      #{ASCIIDOC_BLANK_HDR}
+      [[id]]
+      * First
+      * Second
+      +
+      --
+      entry1
+
+      entry2
+      --
+
+      [[id1]]
+      [loweralpha]
+      . First
+      . Second
+      [upperalpha]
+      .. Third
+      .. Fourth
+      . Fifth
+      . Sixth
+
+      [lowerroman]
+      . A
+      . B
+      [upperroman]
+      .. C
+      .. D
+      [arabic]
+      ... E
+      ... F
+
+
+      Notes1::
+      Notes::  Note 1.
+      +
+      Note 2.
+      +
+      Note 3.
+
+    INPUT
+    expect(strip_guid(output)).to be_equivalent_to <<~"OUTPUT"
+            #{BLANK_HDR}
+       <sections><ul id="id">
+         <li>
+           <p id="_">First</p>
+         </li>
+         <li><p id="_">Second</p><p id="_">entry1</p>
+       <p id="_">entry2</p></li>
+       </ul>
+       <ol id="id1" type="alphabet">
+         <li>
+           <p id="_">First</p>
+         </li>
+         <li>
+           <p id="_">Second</p>
+           <ol id="_" type="alphabet_upper">
+         <li>
+           <p id="_">Third</p>
+         </li>
+         <li>
+           <p id="_">Fourth</p>
+         </li>
+       </ol>
+         </li>
+         <li>
+           <p id="_">Fifth</p>
+         </li>
+         <li>
+           <p id="_">Sixth</p>
+         </li>
+       </ol>
+       <ol id="_" type="roman">
+         <li>
+           <p id="_">A</p>
+         </li>
+         <li>
+           <p id="_">B</p>
+           <ol id="_" type="roman_upper">
+         <li>
+           <p id="_">C</p>
+         </li>
+         <li>
+           <p id="_">D</p>
+           <ol id="_" type="arabic">
+         <li>
+           <p id="_">E</p>
+         </li>
+         <li>
+           <p id="_">F</p>
+           <dl id="_">
+         <dt>Notes1</dt>
+         <dd/>
+         <dt>Notes</dt>
+         <dd><p id="_">Note 1.</p><p id="_">Note 2.</p>
+       <p id="_">Note 3.</p></dd>
+       </dl>
+         </li>
+       </ol>
+         </li>
+       </ol>
+         </li>
+       </ol></sections>
+       </iso-standard>
+       OUTPUT
+    end
+
+    it "anchors lists and list items" do
+     expect(strip_guid(Asciidoctor.convert(<<~"INPUT", backend: :iec, header_footer: true))).to be_equivalent_to <<~"OUTPUT"
+      #{ASCIIDOC_BLANK_HDR}
+      [[id1]]
+      * [[id2]] List item
+      * Hello [[id3]] List item
+
+     INPUT
+             #{BLANK_HDR}
+             <sections>
+              <ul id="id1">
+         <li id="id2">
+           <p id="_">List item</p>
+         </li>
+         <li>
+           <p id="_">Hello <bookmark id="id3"/> List item</p>
+         </li>
+       </ul>
+       </sections>
+       </iso-standard>
+     OUTPUT
+    end
+
+end

data/spec/asciidoctor-iec/macros_spec.rb

@@ -0,0 +1,21 @@
+require "spec_helper"
+
+RSpec.describe Asciidoctor::Iec do
+  it "processes the Asciidoctor::ISO inline macros" do
+    expect(strip_guid(Asciidoctor.convert(<<~"INPUT", backend: :iec, header_footer: true))).to be_equivalent_to <<~"OUTPUT"
+      #{ASCIIDOC_BLANK_HDR}
+      alt:[term1]
+      deprecated:[term1]
+      domain:[term1]
+    INPUT
+            #{BLANK_HDR}
+       <sections>
+         <admitted>term1</admitted>
+       <deprecates>term1</deprecates>
+       <domain>term1</domain>
+       </sections>
+       </iso-standard>
+    OUTPUT
+  end
+
+end

data/spec/asciidoctor-iec/refs_spec.rb

@@ -0,0 +1,268 @@
+require "spec_helper"
+require "relaton_iso"
+require "relaton_ietf"
+
+RSpec.describe Asciidoctor::Iec do
+  it "processes draft ISO reference" do
+    #stub_fetch_ref no_year: true, note: "The standard is in press"
+
+    expect(strip_guid(Asciidoctor.convert(<<~"INPUT", backend: :iec, header_footer: true))).to be_equivalent_to <<~"OUTPUT"
+      #{ASCIIDOC_BLANK_HDR}
+      [bibliography]
+      == Normative References
+
+      * [[[iso123,ISO 123:--]]] footnote:[The standard is in press] _Standard_
+    INPUT
+       #{BLANK_HDR}
+       <sections>
+              </sections><bibliography><references id="_" obligation="informative">
+         <title>Normative References</title>
+         <bibitem id="iso123" type="standard">
+         <title format="text/plain">Standard</title>
+         <docidentifier>ISO 123:—</docidentifier>
+         <date type="published">
+           <on>--</on>
+         </date>
+         <contributor>
+           <role type="publisher"/>
+           <organization>
+             <name>International Organization for Standardization</name>
+             <abbreviation>ISO</abbreviation>
+           </organization>
+         </contributor>
+         <note format="text/plain" reference="1">ISO DATE: The standard is in press</note>
+       </bibitem>
+       </references>
+       </bibliography>
+       </iso-standard>
+    OUTPUT
+  end
+
+  it "processes all-parts ISO reference" do
+    #stub_fetch_ref(all_parts: true)
+
+    expect(strip_guid(Asciidoctor.convert(<<~"INPUT", backend: :iec, header_footer: true))).to be_equivalent_to <<~"OUTPUT"
+      #{ASCIIDOC_BLANK_HDR}
+      [bibliography]
+      == Normative References
+
+      * [[[iso123,ISO 123:1066 (all parts)]]] _Standard_
+    INPUT
+      #{BLANK_HDR}
+      <sections>
+      </sections><bibliography><references id="_" obligation="informative">
+        <title>Normative References</title>
+        <bibitem id="iso123" type="standard">
+         <title format="text/plain">Standard</title>
+         <docidentifier>ISO 123:1066 (all parts)</docidentifier>
+         <date type="published">
+           <on>1066</on>
+         </date>
+         <contributor>
+           <role type="publisher"/>
+           <organization>
+             <name>International Organization for Standardization</name>
+             <abbreviation>ISO</abbreviation>
+           </organization>
+         </contributor>
+         <extent type="part"><referenceFrom>all</referenceFrom></extent>
+       </bibitem>
+      </references>
+      </bibliography>
+      </iso-standard>
+    OUTPUT
+  end
+
+  it "processes non-ISO reference in Normative References" do
+    expect(strip_guid(Asciidoctor.convert(<<~"INPUT", backend: :iec, header_footer: true))).to be_equivalent_to <<~"OUTPUT"
+      #{ASCIIDOC_BLANK_HDR}
+      [bibliography]
+      == Normative References
+
+      * [[[iso123,XYZ 123:1066 (all parts)]]] _Standard_
+    INPUT
+       #{BLANK_HDR}
+              <sections>
+
+       </sections><bibliography><references id="_" obligation="informative">
+         <title>Normative References</title>
+         <bibitem id="iso123">
+         <formattedref format="application/x-isodoc+xml">
+           <em>Standard</em>
+         </formattedref>
+         <docidentifier>XYZ 123:1066 (all parts)</docidentifier>
+       </bibitem>
+       </references>
+       </bibliography>
+       </iso-standard>
+    OUTPUT
+  end
+
+  it "processes non-ISO reference in Bibliography" do
+    expect(strip_guid(Asciidoctor.convert(<<~"INPUT", backend: :iec, header_footer: true))).to be_equivalent_to <<~"OUTPUT"
+      #{ASCIIDOC_BLANK_HDR}
+      [bibliography]
+      == Bibliography
+
+      * [[[iso123,1]]] _Standard_
+    INPUT
+       #{BLANK_HDR}
+              <sections>
+
+       </sections><bibliography><references id="_" obligation="informative">
+         <title>Bibliography</title>
+         <bibitem id="iso123">
+         <formattedref format="application/x-isodoc+xml">
+           <em>Standard</em>
+         </formattedref>
+         <docidentifier>[1]</docidentifier>
+       </bibitem>
+       </references>
+       </bibliography>
+       </iso-standard>
+    OUTPUT
+  end
+
+  private
+
+      private
+
+    def mock_isobib_get_123
+      expect(Isobib::IsoBibliography).to receive(:get).with("ISO 123", nil, {}) do
+        IsoBibItem::XMLParser.from_xml(<<~"OUTPUT")
+        <bibitem type=\"international-standard\" id=\"ISO123\">\n  <fetched>#{Date.today}</fetched>\n<title format=\"text/plain\" language=\"en\" script=\"Latn\">Rubber latex -- Sampling</title>\n  <title format=\"text/plain\" language=\"fr\" script=\"Latn\">Latex de caoutchouc -- ?chantillonnage</title>\n  <uri type=\"src\">https://www.iso.org/standard/23281.html</uri>\n  <uri type=\"obp\">https://www.iso.org/obp/ui/#!iso:std:23281:en</uri>\n  <uri type=\"rss\">https://www.iso.org/contents/data/standard/02/32/23281.detail.rss</uri>\n  <docidentifier type="ISO">ISO 123:2001</docidentifier>\n  <date type=\"published\">\n    <on>2001</on>\n  </date>\n  <contributor>\n    <role type=\"publisher\"/>\n    <organization>\n      <name>International Organization for Standardization</name>\n      <abbreviation>ISO</abbreviation>\n      <uri>www.iso.org</uri>\n    </organization>\n  </contributor>\n  <edition>3</edition>\n  <language>en</language>\n  <language>fr</language>\n  <script>Latn</script>\n  <status>Published</status>\n  <copyright>\n    <from>2001</from>\n    <owner>\n      <organization>\n        <name>ISO</name>\n        <abbreviation></abbreviation>\n      </organization>\n    </owner>\n  </copyright>\n  <relation type=\"obsoletes\">\n    <bibitem>\n      <formattedref>ISO 123:1985</formattedref>\n      </bibitem>\n  </relation>\n  <relation type=\"updates\">\n    <bibitem>\n      <formattedref>ISO 123:2001</formattedref>\n      </bibitem>\n  </relation>\n</bibitem>
+        OUTPUT
+      end
+    end
+
+    def mock_isobib_get_124
+      expect(Isobib::IsoBibliography).to receive(:get).with("ISO 124", "2014", {}) do
+        IsoBibItem::XMLParser.from_xml(<<~"OUTPUT")
+                 <bibitem type="international-standard" id="iso124">
+      <fetched>#{Date.today}</fetched>
+         <title format="text/plain" language="en" script="Latn">Latex, rubber -- Determination of total solids content</title>
+         <title format="text/plain" language="fr" script="Latn">Latex de caoutchouc -- Détermination des matières solides totales</title>
+         <uri type="src">https://www.iso.org/standard/61884.html</uri>
+         <uri type="obp">https://www.iso.org/obp/ui/#!iso:std:61884:en</uri>
+         <uri type="rss">https://www.iso.org/contents/data/standard/06/18/61884.detail.rss</uri>
+         <docidentifier type="ISO">ISO 124:2014</docidentifier>
+         <date type="published">
+           <on>2014</on>
+         </date>
+         <contributor>
+           <role type="publisher"/>
+           <organization>
+             <name>International Organization for Standardization</name>
+             <abbreviation>ISO</abbreviation>
+             <uri>www.iso.org</uri>
+           </organization>
+         </contributor>
+         <edition>7</edition>
+         <language>en</language>
+         <language>fr</language>
+         <script>Latn</script>
+         <abstract format="plain" language="en" script="Latn">ISO 124:2014 specifies methods for the determination of the total solids content of natural rubber field and concentrated latices and synthetic rubber latex. These methods are not necessarily suitable for latex from natural sources other than the Hevea brasiliensis, for vulcanized latex, for compounded latex, or for artificial dispersions of rubber.</abstract>
+         <status>Published</status>
+         <copyright>
+           <from>2014</from>
+           <owner>
+             <organization>
+               <name>ISO</name>
+               <abbreviation/>
+             </organization>
+           </owner>
+         </copyright>
+         <relation type="obsoletes">
+           <bibitem>
+             <formattedref>ISO 124:2011</formattedref>
+           </bibitem>
+         </relation>
+        <ics>
+          <code>83.040.10</code>
+          <text>Latex and raw rubber</text>
+        </ics>
+      </bibitem>
+        OUTPUT
+      end
+    end
+
+    def mock_isobib_get_iec12382
+      expect(Isobib::IsoBibliography).to receive(:get).with("ISO/IEC TR 12382", "1992", {}) do
+      IsoBibItem::XMLParser.from_xml(<<~"OUTPUT")
+      <bibitem type="international-standard" id="iso123">
+      <fetched>#{Date.today}</fetched>
+         <title format="text/plain" language="en" script="Latn">Permuted index of the vocabulary of information technology</title>
+         <title format="text/plain" language="fr" script="Latn">Index permuté du vocabulaire des technologies de l'information</title>
+         <uri type="src">https://www.iso.org/standard/21071.html</uri>
+         <uri type="obp">https://www.iso.org/obp/ui/#!iso:std:21071:en</uri>
+         <uri type="rss">https://www.iso.org/contents/data/standard/02/10/21071.detail.rss</uri>
+         <docidentifier type="ISO">ISO/IEC 12382:1992</docidentifier>
+         <date type="published">
+           <on>1992</on>
+         </date>
+         <contributor>
+           <role type="publisher"/>
+           <organization>
+             <name>International Organization for Standardization</name>
+             <abbreviation>ISO</abbreviation>
+             <uri>www.iso.org</uri>
+           </organization>
+         </contributor>
+         <contributor>
+           <role type="publisher"/>
+           <organization>
+             <name>International Electrotechnical Commission</name>
+             <abbreviation>IEC</abbreviation>
+             <uri>www.iec.ch</uri>
+           </organization>
+         </contributor>
+         <edition>2</edition>
+         <language>en</language>
+         <language>fr</language>
+         <script>Latn</script>
+         <abstract format="plain" language="en" script="Latn">Contains a permuted index of all terms included in the parts 1 - 28 of ISO 2382. If any of these parts has been revised, the present TR refers to the revision.</abstract>
+         <status>Published</status>
+         <copyright>
+           <from>1992</from>
+           <owner>
+             <organization>
+               <name>ISO/IEC</name>
+               <abbreviation/>
+             </organization>
+           </owner>
+         </copyright>
+         <relation type="updates">
+           <bibitem>
+             <formattedref>ISO/IEC TR 12382:1992</formattedref>
+           </bibitem>
+         </relation>
+        <ics>
+          <code>35.020</code>
+          <text>Information technology (IT) in general</text>
+        </ics>
+        <ics>
+          <code>01.040.35</code>
+          <text>Information technology (Vocabularies)</text>
+        </ics>
+       </bibitem>
+OUTPUT
+    end
+end
+
+       def mock_rfcbib_get_rfc8341
+      expect(IETFBib::RfcBibliography).to receive(:get).with("RFC 8341", nil, {}) do
+      IETFBib::XMLParser.from_xml(<<~"OUTPUT")
+      <bibitem id="RFC8341">
+      <fetched>#{Date.today}</fetched>
+  <title format="text/plain" language="en" script="Latn">Network Configuration Access Control Model</title>
+  <docidentifier type="IETF">RFC 8341</docidentifier>
+  <date type="published">
+    <on>2018</on>
+  </date>
+  <status>published</status>
+</bibitem>
+OUTPUT
+    end
+end
+
+end