class Iecbib::IecBibliography

Class methods for search ISO standards.

Public Class Methods

get(code, year, opts) click to toggle source

@param code [String] the ISO standard Code to look up (e..g “ISO 9000”) @param year [String] the year the standard was published (optional) @param opts [Hash] options; restricted to :all_parts if all-parts reference is required @return [String] Relaton XML serialisation of reference

# File lib/iecbib/iec_bibliography.rb, line 33
def get(code, year, opts)
  return iev if code.casecmp('IEV') == 0
  code += '-1' if opts[:all_parts]
  ret = iecbib_get1(code, year, opts)
  return nil if ret.nil?
  ret.to_most_recent_reference unless year || opts[:keep_year]
  ret.to_all_parts if opts[:all_parts]
  ret
end
search_and_fetch(text, year = nil) click to toggle source

@param text [String] @return [Array<IsoBibliographicItem>]

# File lib/iecbib/iec_bibliography.rb, line 25
def search_and_fetch(text, year = nil)
  Scrapper.get(text, year)
end

Private Class Methods

fetch_pages(s, n) click to toggle source
# File lib/iecbib/iec_bibliography.rb, line 62
def fetch_pages(s, n)
  workers = WorkersPool.new n
  workers.worker { |w| { i: w[:i], hit: w[:hit].fetch } }
  s.each_with_index { |hit, i| workers << { i: i, hit: hit } }
  workers.end
  workers.result.sort { |x, y| x[:i] <=> y[:i] }.map { |x| x[:hit] }
end
fetch_ref_err(code, year, missed_years) click to toggle source
# File lib/iecbib/iec_bibliography.rb, line 45
def fetch_ref_err(code, year, missed_years)
  id = year ? "#{code}:#{year}" : code
  warn "WARNING: no match found online for #{id}. "\
    "The code must be exactly like it is on the standards website."
  warn "(There was no match for #{year}, though there were matches "\
    "found for #{missed_years.join(', ')}.)" unless missed_years.empty?
  if /\d-\d/ =~ code
    warn "The provided document part may not exist, or the document "\
      "may no longer be published in parts."
  else
    warn "If you wanted to cite all document parts for the reference, "\
      "use \"#{code} (all parts)\".\nIf the document is not a standard, "\
      "use its document type abbreviation (TS, TR, PAS, Guide)."
  end
  nil
end
iecbib_get1(code, year, opts) click to toggle source
# File lib/iecbib/iec_bibliography.rb, line 135
def iecbib_get1(code, year, opts)
  return iev if code.casecmp("IEV") == 0
  result = isobib_search_filter(code) or return nil
  ret = isobib_results_filter(result, year)
  return ret[:ret] if ret[:ret]
  fetch_ref_err(code, year, ret[:years])
end
iev(code = "IEC 60050") click to toggle source
# File lib/iecbib/iec_bibliography.rb, line 82
      def iev(code = "IEC 60050")
        IsoBibItem::XMLParser.from_xml(<<~"END")
          <bibitem type="international-standard" id="IEV">
          <fetched>#{Date.today.to_s}</fetched>
  <title format="text/plain" language="en" script="Latn">International Electrotechnical Vocabulary</title>
  <link type="src">http://www.electropedia.org</link>
  <docidentifier>#{code}:2011</docidentifier>
  <date type="published"><on>2011</on></date>
  <contributor>
    <role type="publisher"/>
    <organization>
      <name>International Electrotechnical Commission</name>
      <abbreviation>IEC</abbreviation>
      <uri>www.iec.ch</uri>
    </organization>
  </contributor>
  <language>en</language> <language>fr</language>
  <script>Latn</script>
  <status> <stage>60</stage> </status>
  <copyright>
    <from>2018</from>
    <owner>
      <organization>
      <name>International Electrotechnical Commission</name>
      <abbreviation>IEC</abbreviation>
      <uri>www.iec.ch</uri>
      </organization>
    </owner>
  </copyright>
</bibitem>
        END
      end
isobib_results_filter(result, year) click to toggle source

Sort through the results from Isobib, fetching them three at a time, and return the first result that matches the code, matches the year (if provided), and which # has a title (amendments do not). Only expects the first page of results to be populated. Does not match corrigenda etc (e.g. ISO 3166-1:2006/Cor 1:2007) If no match, returns any years which caused mismatch, for error reporting

# File lib/iecbib/iec_bibliography.rb, line 121
def isobib_results_filter(result, year)
  missed_years = []
  result.each_slice(3) do |s| # ISO website only allows 3 connections
    fetch_pages(s, 3).each_with_index do |r, i|
      return { ret: r } if !year
      r.dates.select { |d| d.type == "published" }.each do |d|
        return { ret: r } if year.to_i == d.on.year
        missed_years << d.on.year
      end
    end
  end
  { years: missed_years }
end
isobib_search_filter(code) click to toggle source
# File lib/iecbib/iec_bibliography.rb, line 70
def isobib_search_filter(code)
  docidrx = %r{^(ISO|IEC)[^0-9]*\s[0-9-]+}
  corrigrx = %r{^(ISO|IEC)[^0-9]*\s[0-9-]+:[0-9]+/}
  warn "fetching #{code}..."
  result = search(code)
  result.select do |i|
    i.hit[:code] &&
      i.hit[:code].match(docidrx).to_s == code &&
      corrigrx !~ i.hit[:code]
  end
end