metanorma-standoc 1.0.7 → 1.0.8

data/spec/asciidoctor-standoc/macros_spec.rb

@@ -21,7 +21,7 @@ RSpec.describe Asciidoctor::Standoc do
   it "processes the PlantUML macro" do
     expect(strip_guid(Asciidoctor.convert(<<~"INPUT", backend: :standoc, header_footer: true))).to be_equivalent_to <<~"OUTPUT"
       #{ASCIIDOC_BLANK_HDR}
-      
+
       [plantuml]
       ....
       @startuml

data/spec/asciidoctor-standoc/refs_spec.rb

@@ -65,64 +65,78 @@ RSpec.describe Asciidoctor::Standoc do
 
 
   it "fetches simple ISO reference" do
-    mock_isobib_get_123
-    expect(strip_guid(Asciidoctor.convert(<<~"INPUT", backend: :standoc, header_footer: true))).to be_equivalent_to <<~"OUTPUT"
-      #{ISOBIB_BLANK_HDR}
-      [bibliography]
-      == Normative References
-
-      * [[[iso123,ISO 123]]] _Standard_
-    INPUT
-      #{BLANK_HDR}
-      <sections>
-             </sections><bibliography><references id="_" obligation="informative">
-         <title>Normative References</title>
-         <bibitem type="international-standard" id="iso123">
-         <title format="text/plain" language="en" script="Latn">Rubber latex -- Sampling</title>
-         <title format="text/plain" language="fr" script="Latn">Latex de caoutchouc -- ?chantillonnage</title>
-         <uri type="src">https://www.iso.org/standard/23281.html</uri>
-         <uri type="obp">https://www.iso.org/obp/ui/#!iso:std:23281:en</uri>
-         <uri type="rss">https://www.iso.org/contents/data/standard/02/32/23281.detail.rss</uri>
-         <docidentifier>ISO 123</docidentifier>
-         <date type="published">
-           <on>2001</on>
-         </date>
-         <contributor>
-           <role type="publisher"/>
-           <organization>
-             <name>International Organization for Standardization</name>
-             <abbreviation>ISO</abbreviation>
-             <uri>www.iso.org</uri>
-           </organization>
-         </contributor>
-         <edition>3</edition>
-         <language>en</language>
-         <language>fr</language>
-         <script>Latn</script>
-         <status>Published</status>
-         <copyright>
-           <from>2001</from>
-           <owner>
-             <organization>
-               <name>ISO</name>
-               <abbreviation/>
-             </organization>
-           </owner>
-         </copyright>
-         <relation type="obsoletes">
-           <bibitem>
-             <formattedref>ISO 123:1985</formattedref>
-           </bibitem>
-         </relation>
-         <relation type="updates">
-           <bibitem>
-             <formattedref>ISO 123:2001</formattedref>
-           </bibitem>
-         </relation>
-       </bibitem>
-       </references></bibliography>
-       </standard-document>
-    OUTPUT
+    # mock_isobib_get_123
+    VCR.use_cassette "isobib_get_123" do
+      expect(strip_guid(Asciidoctor.convert(<<~"INPUT", backend: :standoc, header_footer: true))).to be_equivalent_to <<~"OUTPUT"
+        #{ISOBIB_BLANK_HDR}
+        [bibliography]
+        == Normative References
+
+        * [[[iso123,ISO 123]]] _Standard_
+      INPUT
+        #{BLANK_HDR}
+        <sections>
+              </sections><bibliography><references id="_" obligation="informative">
+          <title>Normative References</title>
+          <bibitem type="international-standard" id="iso123">
+          <fetched>#{Date.today}</fetched>
+          <title format="text/plain" language="en" script="Latn">Rubber latex — Sampling</title>
+          <title format="text/plain" language="fr" script="Latn">Latex de caoutchouc — Échantillonnage</title>
+          <uri type="src">https://www.iso.org/standard/23281.html</uri>
+          <uri type="obp">https://www.iso.org/obp/ui/#!iso:std:23281:en</uri>
+          <uri type="rss">https://www.iso.org/contents/data/standard/02/32/23281.detail.rss</uri>
+          <docidentifier type="ISO">ISO 123</docidentifier>
+          <contributor>
+            <role type="publisher"/>
+            <organization>
+              <name>International Organization for Standardization</name>
+              <abbreviation>ISO</abbreviation>
+              <uri>www.iso.org</uri>
+            </organization>
+          </contributor>
+          <edition>3</edition>
+          <language>en</language>
+          <language>fr</language>
+          <script>Latn</script>
+          <status>
+            <stage>90</stage>
+            <substage>93</substage>
+          </status>
+          <copyright>
+            <from>2001</from>
+            <owner>
+              <organization>
+                <name>ISO</name>
+              </organization>
+            </owner>
+          </copyright>
+          <relation type="obsoletes">
+            <bibitem>
+              <formattedref>ISO 123:1985</formattedref>
+            </bibitem>
+          </relation>
+          <relation type="updates">
+            <bibitem>
+              <formattedref>ISO 123:2001</formattedref>
+            </bibitem>
+          </relation>
+          <relation type="instance">
+            <bibitem>
+              <formattedref>ISO 123:2001</formattedref>
+            </bibitem>
+          </relation>
+          <editorialgroup>
+            <technical-committee number="45" type="TC">ISO/TC 45/SC 3Raw materials (including latex) for use in the rubber industry</technical-committee>
+          </editorialgroup>
+          <ics>
+            <code>83.040.10</code>
+            <text>Latex and raw rubber</text>
+          </ics>
+        </bibitem>
+        </references></bibliography>
+        </standard-document>
+      OUTPUT
+    end
   end
 
   it "processes simple IEC reference" do
@@ -154,123 +168,138 @@ RSpec.describe Asciidoctor::Standoc do
   end
 
   it "processes dated ISO reference and joint ISO/IEC references" do
-    mock_isobib_get_iec12382
-    mock_isobib_get_124
-    expect(strip_guid(Asciidoctor.convert(<<~"INPUT", backend: :standoc, header_footer: true))).to be_equivalent_to <<~"OUTPUT"
-      #{ISOBIB_BLANK_HDR}
-      [bibliography]
-      == Normative References
-
-      * [[[iso123,ISO/IEC TR 12382:1992]]] _Standard_
-      * [[[iso124,ISO 124:2014]]] _Standard_
-    INPUT
-      #{BLANK_HDR}
-      <sections>
-
-      </sections><bibliography><references id="_" obligation="informative">
-         <title>Normative References</title>
-         <bibitem type="international-standard" id="iso123">
-         <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>ISO/IEC 12382</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>
-         <bibitem type="international-standard" id="iso124">
-         <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>ISO 124</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>
-       </references></bibliography>
-       </standard-document>
-
-    OUTPUT
+    # mock_isobib_get_iec12382
+    # mock_isobib_get_124
+    VCR.use_cassette "dated_iso_ref_joint_iso_iec" do
+      expect(strip_guid(Asciidoctor.convert(<<~"INPUT", backend: :standoc, header_footer: true))).to be_equivalent_to <<~"OUTPUT"
+        #{ISOBIB_BLANK_HDR}
+        [bibliography]
+        == Normative References
+
+        * [[[iso123,ISO/IEC TR 12382:1992]]] _Standard_
+        * [[[iso124,ISO 124:2014]]] _Standard_
+      INPUT
+        #{BLANK_HDR}
+        <sections>
+
+        </sections><bibliography><references id="_" obligation="informative">
+          <title>Normative References</title>
+          <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 TR 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>
+            <stage>90</stage>
+            <substage>93</substage>
+          </status>
+          <copyright>
+            <from>1992</from>
+            <owner>
+              <organization>
+                <name>ISO/IEC</name>
+              </organization>
+            </owner>
+          </copyright>
+          <relation type="updates">
+            <bibitem>
+              <formattedref>ISO/IEC TR 12382:1992</formattedref>
+            </bibitem>
+          </relation>
+          <editorialgroup>
+            <technical-committee number="1" type="TC">ISO/IEC JTC 1Information technology</technical-committee>
+          </editorialgroup>
+          <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>
+          <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>
+          <abstract format="plain" language="fr" script="Latn">L’ISO 124:2014 spécifie des méthodes pour la détermination des matières solides totales dans le latex de plantation, le latex de concentré de caoutchouc naturel et le latex de caoutchouc synthétique. Ces méthodes ne conviennent pas nécessairement au latex d’origine naturelle autre que celui de l’Hevea brasiliensis, au latex vulcanisé, aux mélanges de latex, ou aux dispersions artificielles de caoutchouc.</abstract>
+          <status>
+            <stage>60</stage>
+            <substage>60</substage>
+          </status>
+          <copyright>
+            <from>2014</from>
+            <owner>
+              <organization>
+                <name>ISO</name>
+              </organization>
+            </owner>
+          </copyright>
+          <relation type="obsoletes">
+            <bibitem>
+              <formattedref>ISO 124:2011</formattedref>
+            </bibitem>
+          </relation>
+          <editorialgroup>
+            <technical-committee number="45" type="TC">ISO/TC 45/SC 3Raw materials (including latex) for use in the rubber industry</technical-committee>
+            </editorialgroup>
+          <ics>
+            <code>83.040.10</code>
+            <text>Latex and raw rubber</text>
+          </ics>
+        </bibitem>
+        </references></bibliography>
+        </standard-document>
+
+      OUTPUT
+    end
   end
 
   it "processes draft ISO reference" do
@@ -342,42 +371,81 @@ RSpec.describe Asciidoctor::Standoc do
   end
 
   it "processes RFC reference in Normative References" do
-    mock_rfcbib_get_rfc8341
-    expect(strip_guid(Asciidoctor.convert(<<~"INPUT", backend: :standoc, header_footer: true))).to be_equivalent_to <<~"OUTPUT"
-      #{ISOBIB_BLANK_HDR}
-      [bibliography]
-      == Normative References
-
-      * [[[iso123,IETF(RFC 8341)]]], _Standard_
-
-      == Clause 4
-
-      <<iso123>>
-    INPUT
-       #{BLANK_HDR}
-              <sections>
-<clause id="_" inline-header="false" obligation="normative">
-  <title>Clause 4</title>
-  <p id="_">
-  <eref type="inline" bibitemid="iso123" citeas="RFC 8341"/>
-</p>
-</clause>
-
-       </sections><bibliography><references id="_" obligation="informative">
-         <title>Normative References</title>
-               <bibitem type="" id="iso123">
-  <title format="text/plain" language="en" script="Latn">Network Configuration Access Control Model</title>
-  <docidentifier type="DOI">10.17487/RFC8341</docidentifier>
-  <docidentifier type="IETF">RFC 8341</docidentifier>
-  <date type="published">
-    <on>2018</on>
-  </date>
-  <status>published</status>
-</bibitem>
-       </references>
-       </bibliography>
-       </standard-document>
-    OUTPUT
+    # mock_rfcbib_get_rfc8341
+    VCR.use_cassette "rfcbib_get_rfc8341" do
+      expect(strip_guid(Asciidoctor.convert(<<~"INPUT", backend: :standoc, header_footer: true))).to be_equivalent_to <<~"OUTPUT"
+        #{ISOBIB_BLANK_HDR}
+        [bibliography]
+        == Normative References
+
+        * [[[iso123,IETF(RFC 8341)]]], _Standard_
+
+        == Clause 4
+
+        <<iso123>>
+      INPUT
+  #{BLANK_HDR}
+  <sections>
+  <clause id="_" inline-header="false" obligation="normative">
+    <title>Clause 4</title>
+    <p id="_">
+    <eref type="inline" bibitemid="iso123" citeas="RFC 8341"/>
+  </p>
+  </clause>
+  </sections><bibliography><references id="_" obligation="informative">
+  <title>Normative References</title>
+  <bibitem id="iso123">
+    <fetched>#{Date.today}</fetched>
+    <title format="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</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>
+    <series type="main">
+      <title format="plain" language="en" script="Latn">STD</title>
+      <number>91</number>
+    </series>
+    <series type="main">
+      <title format="plain" language="en" script="Latn">RFC</title>
+      <number>8341</number>
+    </series>
+  </bibitem>
+        </references>
+        </bibliography>
+        </standard-document>
+      OUTPUT
+    end
   end
 
   it "processes non-ISO reference in Normative References" do
@@ -482,7 +550,7 @@ RSpec.describe Asciidoctor::Standoc do
 
     def mock_isobib_get_123
       expect(Isobib::IsoBibliography).to receive(:get).with("ISO 123", nil, {}) do
-        IsoBibItem.from_xml(<<~"OUTPUT")
+        IsoBibItem::XMLParser.from_xml(<<~"OUTPUT")
         <bibitem type=\"international-standard\" id=\"ISO123\">\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>ISO 123</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
@@ -490,7 +558,7 @@ RSpec.describe Asciidoctor::Standoc do
 
     def mock_isobib_get_124
       expect(Isobib::IsoBibliography).to receive(:get).with("ISO 124", "2014", {}) do
-        IsoBibItem.from_xml(<<~"OUTPUT")
+        IsoBibItem::XMLParser.from_xml(<<~"OUTPUT")
                  <bibitem type="international-standard" id="iso124">
          <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>
@@ -540,7 +608,7 @@ RSpec.describe Asciidoctor::Standoc do
 
     def mock_isobib_get_iec12382
       expect(Isobib::IsoBibliography).to receive(:get).with("ISO/IEC TR 12382", "1992", {}) do
-      IsoBibItem.from_xml(<<~"OUTPUT")
+      IsoBibItem::XMLParser.from_xml(<<~"OUTPUT")
       <bibitem type="international-standard" id="iso123">
          <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>
@@ -602,7 +670,7 @@ end
 
     def mock_rfcbib_get_rfc8341
       expect(IETFBib::RfcBibliography).to receive(:get).with("RFC 8341", nil, {}) do
-        IsoBibItem.from_xml(<<~"OUTPUT")
+        IsoBibItem::XMLParser.from_xml(<<~"OUTPUT")
       <bibitem id="RFC8341">
   <title format="text/plain" language="en" script="Latn">Network Configuration Access Control Model</title>
   <docidentifier type="DOI">10.17487/RFC8341</docidentifier>