kramdown-rfc2629 1.6.12 → 1.6.15

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ac3949475273a7c4f72acf86a47d2c9fb176c2a6f81c8d9cc9db03d595c61248
-  data.tar.gz: 165b94bb4a9306134e92515dae4eec7a9022b0264d95484d7f31a316982d3b01
+  metadata.gz: d667e6af185771592ba7f5b42b1671821b3f8c722aec85af0f9606d2d9857886
+  data.tar.gz: 43b32714ed1aa1be0666a78bf81587f49e4c34a42bc3236a12c5afcac7455ae8
 SHA512:
-  metadata.gz: 1686e35bd93c3e9ff63f42bb830845e3b7accf1b2b7621fb78d49b0fafc3c1edeaea53a645c6e81d8ee5c9f468c54fb0920cb91831325c210d9b98d810f64564
-  data.tar.gz: 5599b22f40492bbfffc8a5d34af3e9ddc69452757bc0c9eb95a97ce312bdc730d3858ffbe1b00bce3af8377d651a3277d3ec82acd0b62e65f7436c8051797bd7
+  metadata.gz: a6b1488ba454538d9a12c6c21fb35c8a916d8a5c5352b140934ae9efce9e87e929aaa6dc302fe6a0c6e3e4f2959860667119bddf734388cf707784529d31d158
+  data.tar.gz: 3f427762bfec7d57eb13038d442ca0f5752257dcfd45174bc74e53016307713acba005ecee53705f668a9957cd69173391164273894fc6272c33dd6ff475d42f

data/bin/doilit

@@ -1,16 +1,12 @@
 #!/usr/bin/env ruby
-require 'open-uri'
 require 'yaml'
-require 'json'
 require 'kramdown-rfc2629'
 require 'kramdown-rfc/parameterset'
 require 'kramdown-rfc/refxml'
+require 'kramdown-rfc/doi'
 
 # doilit -c 10.6028/NIST.SP.800-183 10.1016/j.adhoc.2015.04.007 10.1109/MIC.2012.29 10.1145/2507924.2507954
 
-
-ACCEPT_CITE_JSON = {"Accept" => "application/citeproc+json"}
-
 $verbose = false
 $fuzzy = false
 $handle = "a"
@@ -43,79 +39,9 @@ ARGV.each do |doi|
     warn "*** Usage: doilit [-c] [-f] [-v] [-h=handle|-x=xmlhandle] doi..."
     exit 1
   end
-  cite = JSON.parse(URI("https://dx.doi.org/#{doi}").open(ACCEPT_CITE_JSON).read)
-  puts cite.to_yaml if $verbose
-  lit = {}
-  ser = lit["seriesinfo"] = {}
-  lit["title"] = cite["title"]
-  if (st = cite["subtitle"]) && Array === st # defensive
-    st.delete('')
-    if st != []
-      lit["title"] << ": " << st.join("; ")
-    end
-  end
-  if authors = cite["author"]
-    lit["author"] = authors.map do |au|
-      lau = {}
-      if (f = au["family"])
-        if (g = au["given"])
-          lau["name"] = "#{g} #{f}"
-          lau["ins"] =  "#{g[0]}. #{f}"
-        else
-          lau["name"] = "#{f}"
-#          lau["ins"] =  "#{g[0]}. #{f}"
-        end
-      end
-      lau
-    end
-  end
-  if iss = cite["issued"]
-    if dp = iss["date-parts"]
-      if Integer === (dp = dp[0])[0]
-        lit["date"] = ["%04d" % dp[0], *dp[1..-1].map {|p| "%02d" % p}].join("-")
-      end
-    end
-  end
-  if !lit.key?("date") && $fuzzy && (iss = cite["created"])
-    if dp = iss["date-parts"]
-      if Integer === (dp = dp[0])[0]
-        lit["date"] = ["%04d" % dp[0], *dp[1..-1].map {|p| "%02d" % p}].join("-")
-      end
-    end
-  end
-  if (ct = cite["container-title"]) && ct != []
-    info = []
-    if v = cite["volume"]
-      vi = "vol. #{v}"
-      if (v = cite["journal-issue"]) && (issue = v["issue"])
-        vi << ", no. #{issue}"
-      end
-      info << vi
-    end
-    if p = cite["page"]
-      info << "pp. #{p}"
-    end
-    rhs = info.join(", ")
-    if info != []
-      ser[ct] = rhs
-    else
-      spl = ct.split(" ")
-      ser[spl[0..-2].join(" ")] = spl[-1]
-    end
-  elsif pub = cite["publisher"]
-    info = []
-    if t = cite["type"]
-      info << t
-    end
-    rhs = info.join(", ")
-    if info != []
-      ser[pub] = rhs
-    else
-      spl = pub.split(" ")
-      ser[spl[0..-2].join(" ")] = spl[-1]
-    end
-  end
-  lit["seriesinfo"]["DOI"] = cite["DOI"]
+
+  lit = doi_fetch_and_convert(doi, fuzzy: $fuzzy, verbose: $verbose)
+
   while litent[$handle]
     $handle.succ!
   end

data/data/kramdown-rfc2629.erb

@@ -102,11 +102,13 @@
 <%     mail_subdomain, mail_domain = mail_host.split(".", 2) -%>
 <%     group = venue[:group] || mail_local # XXX -%>
 <%     arch = venue[:arch] || "https://mailarchive.ietf.org/arch/browse/#{mail_local}/" -%>
+<%     subscribe = venue[:subscribe] || "https://www.ietf.org/mailman/listinfo/#{mail_local}/" -%>
 <%     GROUPS = {"ietf" => "Working ", "irtf" => "Research "} -%>
 <%     gtype ||= "#{GROUPS[mail_subdomain]}Group" -%>
         Discussion of this document takes place on the
         <%=group%> <%=gtype%> mailing list (<eref target="mailto:<%=mail%>"/>),
         which is archived at <eref target="<%=arch%>"/>.
+        Subscribe at <eref target="<%=subscribe%>"/>.
 <%   end -%>
 <%   if homepage -%>
         <%=gtype%> information can be found at <eref target="<%=homepage%>"/>.

data/kramdown-rfc2629.gemspec

@@ -1,6 +1,6 @@
 spec = Gem::Specification.new do |s|
   s.name = 'kramdown-rfc2629'
-  s.version = '1.6.12'
+  s.version = '1.6.15'
   s.summary = "Kramdown extension for generating RFCXML (RFC 799x)."
   s.description = %{An RFCXML (RFC 799x) generating backend for Thomas Leitner's
 "kramdown" markdown parser.  Mostly useful for RFC writers.}

data/lib/kramdown-rfc/command.rb

@@ -149,6 +149,7 @@ NMDTAGS = ["{:/nomarkdown}\n\n", "\n\n{::nomarkdown}\n"]
 NORMINFORM = { "!" => :normative, "?" => :informative }
 
 def yaml_load(input, *args)
+ begin
   if YAML.respond_to?(:safe_load)
     begin
       YAML.safe_load(input, *args)
@@ -158,6 +159,10 @@ def yaml_load(input, *args)
   else
     YAML.load(input)
   end
+ rescue Psych::SyntaxError => e
+   warn "*** YAML syntax error: #{e}"
+   exit 65 # EX_DATAERR
+ end
 end
 
 def process_kramdown_options(coding_override = nil,

data/lib/kramdown-rfc/doi.rb

@@ -0,0 +1,92 @@
+require 'open-uri'
+require 'json'
+require 'yaml'
+
+ACCEPT_CITE_JSON = {"Accept" => "application/citeproc+json"}
+
+def doi_fetch_and_convert(doi, fuzzy: false, verbose: false)
+  cite = JSON.parse(URI("https://dx.doi.org/#{doi}").open(ACCEPT_CITE_JSON).read)
+  puts cite.to_yaml if verbose
+  lit = {}
+  ser = lit["seriesinfo"] = {}
+  lit["title"] = cite["title"]
+  if (st = cite["subtitle"]) && Array === st # defensive
+    st.delete('')
+    if st != []
+      lit["title"] << ": " << st.join("; ")
+    end
+  end
+  if authors = cite["author"]
+    lit["author"] = authors.map do |au|
+      lau = {}
+      if (f = au["family"])
+        if (g = au["given"])
+          lau["name"] = "#{g} #{f}"
+          lau["ins"] =  "#{g[0]}. #{f}"
+        else
+          lau["name"] = "#{f}"
+#          lau["ins"] =  "#{g[0]}. #{f}"
+        end
+      end
+      if (f = au["affiliation"]) && Array === f
+        names = f.map { |affn|
+          if Hash === affn && (n = affn["name"]) && String === n
+            n
+          end
+        }.compact
+        if names.size > 0
+          lau["org"] = names.join("; ")
+        end
+      end
+      lau
+    end
+  end
+  if iss = cite["issued"]
+    if dp = iss["date-parts"]
+      if Integer === (dp = dp[0])[0]
+        lit["date"] = ["%04d" % dp[0], *dp[1..-1].map {|p| "%02d" % p}].join("-")
+      end
+    end
+  end
+  if !lit.key?("date") && fuzzy && (iss = cite["created"])
+    if dp = iss["date-parts"]
+      if Integer === (dp = dp[0])[0]
+        lit["date"] = ["%04d" % dp[0], *dp[1..-1].map {|p| "%02d" % p}].join("-")
+      end
+    end
+  end
+  if (ct = cite["container-title"]) && ct != []
+    info = []
+    if v = cite["volume"]
+      vi = "vol. #{v}"
+      if (v = cite["journal-issue"]) && (issue = v["issue"])
+        vi << ", no. #{issue}"
+      end
+      info << vi
+    end
+    if p = cite["page"]
+      info << "pp. #{p}"
+    end
+    rhs = info.join(", ")
+    if info != []
+      ser[ct] = rhs
+    else
+      spl = ct.split(" ")
+      ser[spl[0..-2].join(" ")] = spl[-1]
+    end
+  elsif pub = cite["publisher"]
+    info = []
+    if t = cite["type"]
+      info << t
+    end
+    rhs = info.join(", ")
+    if info != []
+      ser[pub] = rhs
+    else
+      spl = pub.split(" ")
+      ser[spl[0..-2].join(" ")] = spl[-1]
+    end
+  end
+  ser["DOI"] = cite["DOI"]
+  lit
+end

data/lib/kramdown-rfc2629.rb

@@ -22,6 +22,8 @@ require 'open3'                 # for math
 require 'json'                  # for math
 require 'rexml/document'        # for SVG and bibxml acrobatics
 
+require 'kramdown-rfc/doi'      # for fetching information for a DOI
+
 class Object
   def deep_clone
     Marshal.load(Marshal.dump(self))
@@ -1002,6 +1004,12 @@ COLORS
         warn "(#{"%.3f" % (t2 - t1)} s)" if KRAMDOWN_PERSISTENT_VERBOSE
       end
 
+      def get_doi(refname)
+        lit = doi_fetch_and_convert(refname, fuzzy: true)
+        anchor = "DOI_#{refname.gsub("/", "_")}"
+        KramdownRFC::ref_to_xml(anchor, lit)
+      end
+
       # this is now slightly dangerous as multiple urls could map to the same cachefile
       def get_and_cache_resource(url, cachefile, tvalid = 7200, tn = Time.now)
         fn = "#{REFCACHEDIR}/#{cachefile}"
@@ -1016,7 +1024,17 @@ COLORS
             fetch_timeout = 60 # seconds; long timeout needed for Travis
           end
           $stderr.puts "#{fn}: #{message} from #{url}"
-          if ENV["HAVE_WGET"]
+          if Array === url
+            begin
+              case url[0]
+              when :DOI
+                ref = get_doi(url[1])
+                File.write(fn, ref)
+              end
+            rescue Exception => e
+              warn "*** Error fetching #{url[0]} #{url[1].inspect}: #{e}"
+            end
+          elsif ENV["HAVE_WGET"]
             `cd #{REFCACHEDIR}; wget -t 3 -T #{fetch_timeout} -Nnv "#{url}"` # ignore errors if offline (hack)
             begin
               File.utime nil, nil, fn
@@ -1089,7 +1107,8 @@ COLORS
         "NIST" => "bibxml2",
         "OASIS" => "bibxml2",
         "PKCS" => "bibxml2",
-        "DOI" => ["bibxml7", 86400, true], # 24 h cache at source anyway
+        "DOI" => ["bibxml7", 86400, true, ->(fn, n){ ["computed-#{fn}", [:DOI, n] ] }, true # always_altproc
+                 ], # emulate old 24 h cache
         "IANA" => ["bibxml8", 86400, true], # ditto
       }
 
@@ -1122,14 +1141,16 @@ COLORS
           anchor.gsub!('/', '_')              # should take out all illegals
           to_insert = ""
           src.scan(/(W3C|3GPP|[A-Z-]+)[.]?([A-Za-z_0-9.\(\)\/\+-]+)/) do |t, n|
+            never_altproc = n.sub!(/^[.]/, "")
             fn = "reference.#{t}.#{n}.xml"
-            sub, ttl, _can_anchor, altproc = XML_RESOURCE_ORG_MAP[t]
+            sub, ttl, _can_anchor, altproc, always_altproc = XML_RESOURCE_ORG_MAP[t]
             ttl ||= KRAMDOWN_REFCACHETTL  # everything but RFCs might change a lot
             puts "*** Huh: #{fn}" unless sub
-            if altproc && !KRAMDOWN_USE_TOOLS_SERVER
+            if altproc && !never_altproc && (!KRAMDOWN_USE_TOOLS_SERVER || always_altproc)
               fn, url = altproc.call(fn, n)
             else
               url = "#{XML_RESOURCE_ORG_PREFIX}/#{sub}/#{fn}"
+              fn = "alt-#{fn}" if never_altproc || KRAMDOWN_USE_TOOLS_SERVER
             end
             # if can_anchor # create anchor server-side for stand_alone: false
             #   url << "?anchor=#{anchor}"
@@ -1141,6 +1162,7 @@ COLORS
             begin
               d = REXML::Document.new(to_insert)
               d.xml_decl.nowrite
+              d.delete d.doctype
               d.root.attributes["anchor"] = anchor
               if t == "RFC" or t == "I-D"
                 if KRAMDOWN_NO_TARGETS

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: kramdown-rfc2629
 version: !ruby/object:Gem::Version
-  version: 1.6.12
+  version: 1.6.15
 platform: ruby
 authors:
 - Carsten Bormann
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-06-27 00:00:00.000000000 Z
+date: 2022-08-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: kramdown
@@ -100,6 +100,7 @@ files:
 - kramdown-rfc2629.gemspec
 - lib/kramdown-rfc/autolink-iref-cleanup.rb
 - lib/kramdown-rfc/command.rb
+- lib/kramdown-rfc/doi.rb
 - lib/kramdown-rfc/erb.rb
 - lib/kramdown-rfc/gzip-clone.rb
 - lib/kramdown-rfc/kdrfc-processor.rb