relaton 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bdc3737ec5342a53ecbfe76300389b0afb81b32bd6c7aaa45ccbf450f679d886
-  data.tar.gz: 596df09db41419e1aa452d6a0dee24556c4a6b885c121c31b7b3426c42233297
+  metadata.gz: 42d388ac89c1d26d3cee93b0129d4c7393d7799849d94b2a84266830b3f9436d
+  data.tar.gz: bf8af87b24de874c0693711b48b821f9f347a5b1efe8c0158b82e7df88f5529b
 SHA512:
-  metadata.gz: 1511495c2d16d1364682f7d5cb0f0d3e61bab30e97611b5fefa563ee7cd7653a205f0b1405293c95a4212e67c42aeb528211302560a123d4ee38be6170423f92
-  data.tar.gz: 5ed4ef760452c3e1bc60644ae773548e5d8683b29663bc0ded1a9cc77e227a9c556c3bfe289ced91dc836c3d60259984dd671a788f1d72c9caa8689fd36ee744
+  metadata.gz: 8f34dd9a4738927f277c0e71ec36d0213e45e70f31a260819bcbcad8e7519e87ce2c1e883c53111e52ab73d9cbc580ab1d8cb8c8afd9ebce4257d1a287f73f48
+  data.tar.gz: 1bbf4542a44735cbf8078ae18249fab3e43c5d081db6a8645d89d554c82e8028dc85296650cc909252da690db8be8bc3dafb81fd4ecfb186ce470bd2ee346744

data/Gemfile.lock

@@ -3,10 +3,10 @@ PATH
   specs:
     relaton (0.1.1)
       algoliasearch
-      gbbib (~> 0.1.0)
+      gbbib (~> 0.2.0)
       iev (~> 0.1.0)
       isobib (~> 0.2.0)
-      rfcbib (~> 0.1.0)
+      rfcbib (~> 0.2.0)
 
 GEM
   remote: https://rubygems.org/
@@ -24,9 +24,9 @@ GEM
       nokogiri (>= 1.4.3)
     ffi (1.9.25)
     formatador (0.2.5)
-    gbbib (0.1.4)
-      cnccs
-      iso-bib-item
+    gbbib (0.2.0)
+      cnccs (~> 0.1.1)
+      iso-bib-item (~> 0.2)
     guard (2.14.2)
       formatador (>= 0.2.4)
       listen (>= 2.7, < 4.0)
@@ -82,7 +82,7 @@ GEM
     rb-fsevent (0.10.3)
     rb-inotify (0.9.10)
       ffi (>= 0.5.0, < 2)
-    rfcbib (0.1.1)
+    rfcbib (0.2.0)
       iso-bib-item (~> 0.2.0)
     rspec (3.7.0)
       rspec-core (~> 3.7.0)

data/README.adoc

@@ -4,17 +4,89 @@ image:https://img.shields.io/gem/v/relaton.svg["Gem Version", link="https://ruby
 image:https://img.shields.io/travis/riboseinc/relaton/master.svg["Build Status", link="https://travis-ci.org/riboseinc/relaton"]
 image:https://codeclimate.com/github/riboseinc/relaton/badges/gpa.svg["Code Climate", link="https://codeclimate.com/github/riboseinc/relaton"]
 
-gem for importing and caching bibliographic references to technical standards
+Gem for importing and caching bibliographic references to technical standards. 
+
+== Scope
+
+The Relaton gem obtains authoritative bibliographic entries for technical standards from online sources, and expresses them in a consistent format, which can be used in document authoring. (It is the underlying bibliographic tool for the https://github.com/riboseinc/metanorma[Metanorma] toolset.)
+
+The gem also caches entries it has retrieved, so that subsequent iterations do not need to go back online to retrieve the same entries. The gem uses two caches: a global cache (for all bibliographic entries retrieved by the user), and a local cache (intended to store references specific to the current document being processed.)
+
+Entries are retrieved and stored in the https://github.com/riboseinc/bib-models[Relaton bibliographic model], which is an expression of ISO 690. The subset of the model used and serialised for Relaton is defined in the https://github.com/riboseinc/iso-bib-item[iso-bib-item] gem.
+
+Entries are serialised to and from an internal data model, and multiple formats are intended to be supported. Currently only https://github.com/riboseinc/bib-models/blob/master/grammars/biblio.rnc[Relaton XML] is supported.
+
+Relaton imports bibliographic entries from:
+
+* ISO and IEC through the iso.org website, via the https://github.com/riboseinc/isobib[isobib] gem
+* GB (Chinese national standards) through the GB websites, via the https://github.com/riboseinc/gbbib[gbbib] gem [in progress]
+* IETF standards (Internet Drafts, RFC) through the http://xml2rfc.tools.ietf.org website, via the https://github.com/riboseinc/rfcbib[rfcbib] gem [in progress]
+
+The gem can be extended to use other standards-specific gems. Standards-specific gems like isobib register themselves against Relaton using `Relaton::Registry.instance.register`, which takes as an argument a subclass of `Relaton::Processor` defined in the gem; see isobib/lib/relaton for an example. The processor within the standards-specific gem needs to define
+
+* `@short`, the name of the gem
+* `@prefix`, the regex constraining the standards code to be processed
+* `get(code, date, opts)`, which takes a standards code, a year, and a hash of options, and returns an iso-bib-item bibliographic entry
+
+== Behaviours
+
+* Bibliographic entries are identified for retrieval and caching by a prefix specific to the standards class, followed by the conventional code of the standard.
+** ISO standards are identified by `ISO` followed by space or slash. For example, `ISO/IEC DIR 2:2018`
+** IEC standards are identified by `IEC` followed by space or slash
+** GB standards are identified by `GB Standard`. For example, `GB Standard GM/T 0009-2012`
+** IETF stadnards are identified by `IETF`. Foe example, `IETF RFC 7991`
+* If an entry is defined in both the local and the global cache, the local cache entry is used.
+* If an ISO entry has no date, the latest version available for the entry is retrieved.
+* If a cached ISO entry has no date, and was last retrieved more than 60 days ago, the gem fetches it again, in case there is a newer edition of the standard available.
+* Note that the gem does not currently support the totality of the Relaton model; it will only support the information available in the source websites. We do not expect to support cartographic information, for example.
+
+== Usage
 
 [source,ruby]
 ----
-x = Relaton.fetch("ISO19011")
-=> Relaton::Error "No such fetcher"
+require "relaton"
+=> true
+
+# Do not cache any entries retrieved
+db = Relaton.new(nil, nil)
+# Use only the global cache for any entries retrieved
+db = Relaton.new("global cache filename", nil)
+# Use both a local and a global cache
+db = Relaton::Db.new("global cache filename", "local cache filename")
+[relaton] detecting backends:
+isobib
+[relaton] processor "isobib" registered
+=> #<Relaton::Db:...>
+
+x = db.fetch("IEEE 19011")
+"IEEE 19011 does not have a recognised prefix: /^(ISO|IEC)[ \/]|^IEV($| )/"
+=> nil
+
+x = db.fetch("ISO 19011")
+fetching ISO 19011...
+=> #<IsoBibItem::IsoBibliographicItem:...>
+
+x = db.fetch("ISO 19011", "2011")
+fetching ISO 19011...
+=> #<IsoBibItem::IsoBibliographicItem:...>
 
-require 'relaton-iso'
-x = Relaton.fetch("ISO19011")
-=> <# Relaton::Iso @docidentifier: "ISO 19011:2011" ... >
+x = db.fetch("ISO 19011", "2011", allparts: true)
+fetching ISO 19011...
+=> #<IsoBibItem::IsoBibliographicItem:...>
 
 x.to_xml
-=> <bib-item ...>
+=> "<bib-item type=\"international-standard\" id=\"ISO19011\">...."
+
+db.to_xml
+=> "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<documents>\n <bibitem type=\"international-standard\"...."
+
+db.load_entry("ISO 19011")
+=> #<IsoBibItem::IsoBibliographicItem:...>
+
+db.save_entry("ISO 19011", nil)
+=> nil
+
+db.load_entry("ISO 19011")
+=> nil
+
 ----

data/lib/relaton/db.rb

@@ -5,7 +5,7 @@ module Relaton
   class RelatonError < StandardError; end
 
   class Db
-    SUPPORTED_GEMS = %w[ isobib rfcbib gbbib ].freeze
+    SUPPORTED_GEMS = %w[isobib rfcbib gbbib].freeze
 
     # @param global_cache [String] filename of global DB
     # @param local_cache [String] filename of local DB
@@ -66,7 +66,7 @@ module Relaton
       @db.transaction do
         Nokogiri::XML::Builder.new(encoding: "UTF-8") do |xml|
           xml.documents do
-            @db.roots.each { |key| @db[key]["bib"].to_xml(xml, {}) }
+            @db.roots.each { |key| @db[key]&.fetch("bib")&.to_xml(xml, {}) }
           end
         end.to_xml
       end
@@ -144,7 +144,7 @@ module Relaton
     # @param year [String]
     def valid_bib_entry?(bib, year)
       bib&.is_a?(Hash) && bib&.has_key?("bib") && bib&.has_key?("fetched") &&
-        (year || Date.today - Date.iso8601(bib["fetched"]) < 60)
+        (year || Date.today - bib["fetched"] < 60)
     end
 
     # @param filename [String] DB filename

data/lib/relaton/version.rb

@@ -1,3 +1,3 @@
 module Relaton
-  VERSION = "0.1.1".freeze
+  VERSION = "0.1.2".freeze
 end

data/relaton.gemspec

@@ -28,10 +28,10 @@ Gem::Specification.new do |spec|
   spec.required_ruby_version = Gem::Requirement.new(">= 2.4.0")
 
   spec.add_dependency "algoliasearch"
-  spec.add_dependency "gbbib", "~> 0.1.0"
+  spec.add_dependency "gbbib", "~> 0.2.0"
   spec.add_dependency "iev", "~> 0.1.0"
   spec.add_dependency "isobib", "~> 0.2.0"
-  spec.add_dependency "rfcbib", "~> 0.1.0"
+  spec.add_dependency "rfcbib", "~> 0.2.0"
 
   spec.add_development_dependency "bundler", "~> 1.15"
   spec.add_development_dependency "byebug", "~> 9.1"

data/spec/relaton/relaton_spec.rb

@@ -1,12 +1,14 @@
 require "spec_helper"
 
 RSpec.describe Relaton::Db do
-  it "rejects an illegal reference prefix" do
+  let!(:db) { Relaton::Db.new("testcache", "testcache2") }
+
+  before :each do
     system "rm testcache testcache2"
-    db = Relaton::Db.new("testcache", "testcache2")
+  end
+
+  it "rejects an illegal reference prefix" do
     expect { db.fetch("XYZ XYZ", nil, {}) }.to output(/does not have a recognised prefix/).to_stderr
-    # expect(File.exist?("testcache")).to be true
-    # expect(File.exist?("testcache2")).to be true
     testcache = PStore.new "testcache"
     testcache.transaction do
       expect(testcache.roots.size).to eq 0
@@ -18,11 +20,8 @@ RSpec.describe Relaton::Db do
   end
 
   it "gets an ISO reference and caches it" do
-    stub_isobib
-    system "rm testcache testcache2"
-    db = Relaton::Db.new("testcache", "testcache2")
+    stub_bib Isobib::IsoBibliography
     bib = db.fetch("ISO 19115-1", nil, {})
-    #db.fetch("ISO 19115-1", nil, {})
     expect(bib).to be_instance_of IsoBibItem::IsoBibliographicItem
     expect(bib.to_xml).to include "<bibitem type=\"international-standard\" id=\"ISO19115-1\">"
     expect(File.exist?("testcache")).to be true
@@ -38,9 +37,7 @@ RSpec.describe Relaton::Db do
   end
 
   it "deals with a non-existant ISO reference" do
-    stub_isobib
-    system "rm testcache testcache2"
-    db = Relaton::Db.new("testcache", "testcache2")
+    stub_bib Isobib::IsoBibliography
     bib = db.fetch("ISO 111111119115-1", nil, {})
     expect(bib).to be_nil
     expect(File.exist?("testcache")).to be true
@@ -58,9 +55,7 @@ RSpec.describe Relaton::Db do
   end
 
   it "list all elements as a serialization" do
-    stub_isobib 2
-    system "rm testcache testcache2"
-    db = Relaton::Db.new("testcache", "testcache2")
+    stub_bib Isobib::IsoBibliography, 2
     db.fetch "ISO 19115-1", nil, {}
     db.fetch "ISO 19115-2", nil, {}
     file = "spec/support/list_entries.xml"
@@ -69,25 +64,47 @@ RSpec.describe Relaton::Db do
   end
 
   it "save/load entry" do
-    system "rm testcache testcache2"
-    db = Relaton::Db.new "testcache", "testcache2"
     db.save_entry "test key", value: "test value"
     expect(db.load_entry("test key")[:value]).to eq "test value"
     expect(db.load_entry("not existed key")).to be_nil
   end
 
+  it "get GB reference and cache it" do
+    stub_bib Gbbib::GbBibliography
+    bib = db.fetch "GB/T 20223", "2006", {}
+    expect(bib).to be_instance_of Gbbib::GbBibliographicItem
+  end
+
+  it "get RFC reference and cache it" do
+    stub_bib RfcBib::RfcBibliography
+    bib = db.fetch "RFC 8341", nil, {}
+    expect(bib).to be_instance_of IsoBibItem::BibliographicItem
+  end
+
   private
 
-  def stub_isobib(count = 1)
-    expect(Isobib::IsoBibliography).to receive(:get).and_wrap_original do |m, *args|
-      expect(args.size).to eq 3
-      expect(args[0]).to be_instance_of String
-      expect(args[1]).to be_instance_of NilClass
-      expect(args[2]).to be_instance_of Hash
-      file = "spec/support/" + args[0].downcase.gsub(/[\s-]/, "_") + ".xml"
-      File.write file, m.call(*args).to_xml unless File.exist? file
-      resp = File.read file
-      resp.empty? ? nil : IsoBibItem.from_xml(resp)
+  # @param count [Integer] number of stubbing
+  def stub_bib(bib_type, count = 1)
+    expect(bib_type).to receive(:get).and_wrap_original do |m, *args|
+      get_resp m, *args
     end.exactly(count).times
   end
+
+  def get_resp(method, *args)
+    expect_args args
+    file = "spec/support/" + args[0].downcase.gsub(/[\/\s-]/, "_")
+    file += "_#{args[1]}" if args[1]
+    store = PStore.new file
+    store.transaction do
+      store[:resp] = method.call(*args) unless store.root? :resp
+      store[:resp]
+    end
+  end
+
+  def expect_args(args)
+    expect(args.size).to eq 3
+    expect(args[0]).to be_instance_of String
+    expect(args[1]).to be_instance_of(NilClass).or be_instance_of String
+    expect(args[2]).to be_instance_of Hash
+  end
 end

data/spec/spec_helper.rb

@@ -8,12 +8,13 @@ end
 require "bundler/setup"
 require "relaton"
 require "isobib"
+require "gbbib"
 require "rspec/matchers"
 require "equivalent-xml"
 
 RSpec.configure do |config|
   # Enable flags like --only-failures and --next-failure
-  config.example_status_persistence_file_path = '.rspec_status'
+  config.example_status_persistence_file_path = ".rspec_status"
 
   # Disable RSpec exposing methods globally on `Module` and `main`
   config.disable_monkey_patching!

data/spec/support/iso_111111119115_1

@@ -0,0 +1 @@
+{:	resp0

data/spec/support/list_entries.xml

@@ -1,8 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <documents>
   <bibitem type="international-standard" id="ISO19115-1">
-    <title format="text/plain" language="en" script="Latn">Geographic information -- Metadata -- Part 1: Fundamentals</title>
-    <title format="text/plain" language="fr" script="Latn">Information géographique -- Métadonnées -- Partie 1: Principes de base</title>
+    <title format="text/plain" language="en" script="Latn">[ -- ]</title>
+    <title format="text/plain" language="fr" script="Latn">[ -- ]</title>
     <uri type="src">https://www.iso.org/standard/53798.html</uri>
     <uri type="obp">https://www.iso.org/obp/ui/#!iso:std:53798:en</uri>
     <uri type="rss">https://www.iso.org/contents/data/standard/05/37/53798.detail.rss</uri>
@@ -28,7 +28,6 @@
       <owner>
         <organization>
           <name>ISO</name>
-          <abbreviation></abbreviation>
         </organization>
       </owner>
     </copyright>
@@ -48,8 +47,64 @@
       </bibitem>
     </relation>
     <relation type="instance">
-      <bibitem>
-        <formattedref>ISO 19115:2003</formattedref>
+      <bibitem type="international-standard">
+        <title format="text/plain" language="en" script="Latn">[ -- ]</title>
+        <title format="text/plain" language="fr" script="Latn">[ -- ]</title>
+        <uri type="src">https://www.iso.org/standard/53798.html</uri>
+        <uri type="obp">https://www.iso.org/obp/ui/#!iso:std:53798:en</uri>
+        <uri type="rss">https://www.iso.org/contents/data/standard/05/37/53798.detail.rss</uri>
+        <docidentifier>ISO 19115-1</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>1</edition>
+        <language>en</language>
+        <language>fr</language>
+        <script>Latn</script>
+        <abstract format="plain" language="en" script="Latn">ISO 19115-1:2014 defines the schema required for describing geographic information and services by means of metadata. It provides information about the identification, the extent, the quality, the spatial and temporal aspects, the content, the spatial reference, the portrayal, distribution, and other properties of digital geographic data and services.ISO 19115-1:2014 is applicable to:-the cataloguing of all types of resources, clearinghouse activities, and the full description of datasets and services;-geographic services, geographic datasets, dataset series, and individual geographic features and feature properties.ISO 19115-1:2014 defines:-mandatory and conditional metadata sections, metadata entities, and metadata elements;-the minimum set of metadata required to serve most metadata applications (data discovery, determining data fitness for use, data access, data transfer, and use of digital data and services);-optional metadata elements to allow for a more extensive standard description of resources, if required;-a method for extending metadata to fit specialized needs.Though ISO 19115-1:2014 is applicable to digital data and services, its principles can be extended to many other types of resources such as maps, charts, and textual documents as well as non-geographic data. Certain conditional metadata elements might not apply to these other forms of data.</abstract>
+        <abstract format="plain" language="fr" script="Latn">L'ISO 19115-1:2014 définit le schéma requis pour décrire des informations géographiques et des services au moyen de métadonnées. Elle fournit des informations concernant l'identification, l'étendue, la qualité, les aspects spatiaux et temporels, le contenu, la référence spatiale, la représentation des données, la distribution et d'autres propriétés des données géographiques numériques et des services.L'ISO 19115-1:2014 est applicable:-au catalogage de tous les types de ressources, des activités des centres d'informations et à la description complète des jeux de données et des services,-aux services géographiques, jeux de données géographiques, séries de jeux de données, entités géographiques individuelles et propriétés d'entités.L'ISO 19115-1:2014 définit:-des sections relatives aux métadonnées obligatoires et facultatives, aux entités de métadonnées et aux éléments de métadonnées,-le jeu minimal de métadonnées requis pour répondre au besoin de la plupart des applications des métadonnées (la découverte des données, la détermination de l'adéquation des données à une utilisation, l'accès aux données, le transfert des données et l'utilisation des données numériques et des services),-les éléments de métadonnées facultatifs pour permettre une description standard plus poussée des ressources, si cela est nécessaire,-un procédé d'extension des métadonnées pour s'adapter aux besoins spéciaux.L'ISO 19115-1:2014 est applicable aux données numériques et services, ses principes peuvent être étendus à bien d'autres types de ressources telles que les cartes, les graphes et les documents textes, de même qu'à des données non géographiques. Certains éléments de métadonnées conditionnels peuvent ne pas s'appliquer à ces autres formes de données.</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 19115:2003</formattedref>
+          </bibitem>
+        </relation>
+        <relation type="obsoletes">
+          <bibitem>
+            <formattedref>ISO 19115:2003/Cor 1:2006</formattedref>
+          </bibitem>
+        </relation>
+        <relation type="updates">
+          <bibitem>
+            <formattedref>ISO 19115-1:2014/Amd 1:2018</formattedref>
+          </bibitem>
+        </relation>
+        <editorialgroup>
+          <technical_committee number="211" type="technicalCommittee">ISO/TC 211Geographic information/Geomatics</technical_committee>
+        </editorialgroup>
+        <ics>
+          <code>35.240.70</code>
+          <text>IT applications in science</text>
+        </ics>
       </bibitem>
     </relation>
     <editorialgroup>
@@ -61,8 +116,8 @@
     </ics>
   </bibitem>
   <bibitem type="international-standard" id="ISO19115-2">
-    <title format="text/plain" language="en" script="Latn">Geographic information -- Metadata -- Part 2: Extensions for imagery and gridded data</title>
-    <title format="text/plain" language="fr" script="Latn">Information géographique -- Métadonnées -- Partie 2: Extensions pour les images et les matrices</title>
+    <title format="text/plain" language="en" script="Latn">[ -- ]</title>
+    <title format="text/plain" language="fr" script="Latn">[ -- ]</title>
     <uri type="src">https://www.iso.org/standard/39229.html</uri>
     <uri type="obp">https://www.iso.org/obp/ui/#!iso:std:39229:en</uri>
     <uri type="rss">https://www.iso.org/contents/data/standard/03/92/39229.detail.rss</uri>
@@ -88,7 +143,6 @@
       <owner>
         <organization>
           <name>ISO</name>
-          <abbreviation></abbreviation>
         </organization>
       </owner>
     </copyright>
@@ -98,8 +152,54 @@
       </bibitem>
     </relation>
     <relation type="instance">
-      <bibitem>
-        <formattedref>ISO 19115-2</formattedref>
+      <bibitem type="international-standard">
+        <title format="text/plain" language="en" script="Latn">[ -- ]</title>
+        <title format="text/plain" language="fr" script="Latn">[ -- ]</title>
+        <uri type="src">https://www.iso.org/standard/39229.html</uri>
+        <uri type="obp">https://www.iso.org/obp/ui/#!iso:std:39229:en</uri>
+        <uri type="rss">https://www.iso.org/contents/data/standard/03/92/39229.detail.rss</uri>
+        <docidentifier>ISO 19115-2</docidentifier>
+        <date type="published">
+          <on>2009</on>
+        </date>
+        <contributor>
+          <role type="publisher"/>
+          <organization>
+            <name>International Organization for Standardization</name>
+            <abbreviation>ISO</abbreviation>
+            <uri>www.iso.org</uri>
+          </organization>
+        </contributor>
+        <edition>1</edition>
+        <language>en</language>
+        <language>fr</language>
+        <script>Latn</script>
+        <abstract format="plain" language="en" script="Latn">ISO 19115-2:2009 extends the existing geographic metadata standard by defining the schema required for describing imagery and gridded data. It provides information about the properties of the measuring equipment used to acquire the data, the geometry of the measuring process employed by the equipment, and the production process used to digitize the raw data. This extension deals with metadata needed to describe the derivation of geographic information from raw data, including the properties of the measuring system, and the numerical methods and computational procedures used in the derivation. The metadata required to address coverage data in general is addressed sufficiently in the general part of ISO 19115.</abstract>
+        <abstract format="plain" language="fr" script="Latn">L'ISO 19115-2:2009 étend la norme existante sur les métadonnées géographiques en définissant le schéma requis de description des images et des matrices. Elle donne des informations relatives aux propriétés des équipements de mesure utilisés pour obtenir les données, la géométrie du processus de mesure utilisée par ces équipements, et le processus de production utilisé pour numériser les données brutes. Cette extension porte sur les métadonnées nécessaires pour décrire la déduction des informations géographiques à partir de données brutes, y compris les propriétés du système de mesure, et les méthodes numériques et procédures informatiques utilisées pour la déduction. Les métadonnées requises pour aborder les données de couverture en général sont suffisamment abordées dans la partie générale de l'ISO 19115.</abstract>
+        <status>
+          <stage>90</stage>
+          <substage>92</substage>
+        </status>
+        <copyright>
+          <from>2009</from>
+          <owner>
+            <organization>
+              <name>ISO</name>
+            </organization>
+          </owner>
+        </copyright>
+        <relation type="updates">
+          <bibitem>
+            <formattedref>ISO 19115-2</formattedref>
+          </bibitem>
+        </relation>
+        <editorialgroup>
+          <technical_committee number="211" type="technicalCommittee">ISO/TC 211Geographic information/Geomatics</technical_committee>
+        </editorialgroup>
+        <ics>
+          <code>35.240.70</code>
+          <text>IT applications in science</text>
+        </ics>
       </bibitem>
     </relation>
     <editorialgroup>

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: relaton
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-07-18 00:00:00.000000000 Z
+date: 2018-07-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: algoliasearch
@@ -30,14 +30,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.1.0
+        version: 0.2.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.1.0
+        version: 0.2.0
 - !ruby/object:Gem::Dependency
   name: iev
   requirement: !ruby/object:Gem::Requirement
@@ -72,14 +72,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.1.0
+        version: 0.2.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.1.0
+        version: 0.2.0
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -264,10 +264,12 @@ files:
 - relaton.gemspec
 - spec/relaton/relaton_spec.rb
 - spec/spec_helper.rb
-- spec/support/iso_111111119115_1.xml
-- spec/support/iso_19115_1.xml
-- spec/support/iso_19115_2.xml
+- spec/support/gb_t_20223_2006
+- spec/support/iso_111111119115_1
+- spec/support/iso_19115_1
+- spec/support/iso_19115_2
 - spec/support/list_entries.xml
+- spec/support/rfc_8341
 homepage: https://github.com/riboseinc/relaton
 licenses:
 - BSD-2-Clause

data/spec/support/iso_19115_1.xml

@@ -1,117 +0,0 @@
-<bibitem type="international-standard" id="ISO19115-1">
-  <title format="text/plain" language="en" script="Latn">Geographic information -- Metadata -- Part 1: Fundamentals</title>
-  <title format="text/plain" language="fr" script="Latn">Information géographique -- Métadonnées -- Partie 1: Principes de base</title>
-  <uri type="src">https://www.iso.org/standard/53798.html</uri>
-  <uri type="obp">https://www.iso.org/obp/ui/#!iso:std:53798:en</uri>
-  <uri type="rss">https://www.iso.org/contents/data/standard/05/37/53798.detail.rss</uri>
-  <docidentifier>ISO 19115-1</docidentifier>
-  <contributor>
-    <role type="publisher"/>
-    <organization>
-      <name>International Organization for Standardization</name>
-      <abbreviation>ISO</abbreviation>
-      <uri>www.iso.org</uri>
-    </organization>
-  </contributor>
-  <edition>1</edition>
-  <language>en</language>
-  <language>fr</language>
-  <script>Latn</script>
-  <status>
-    <stage>60</stage>
-    <substage>60</substage>
-  </status>
-  <copyright>
-    <from>2014</from>
-    <owner>
-      <organization>
-        <name>ISO</name>
-        <abbreviation></abbreviation>
-      </organization>
-    </owner>
-  </copyright>
-  <relation type="obsoletes">
-    <bibitem>
-      <formattedref>ISO 19115:2003</formattedref>
-    </bibitem>
-  </relation>
-  <relation type="obsoletes">
-    <bibitem>
-      <formattedref>ISO 19115:2003/Cor 1:2006</formattedref>
-    </bibitem>
-  </relation>
-  <relation type="updates">
-    <bibitem>
-      <formattedref>ISO 19115-1:2014/Amd 1:2018</formattedref>
-    </bibitem>
-  </relation>
-  <relation type="instance">
-    <bibitem type="international-standard">
-      <title format="text/plain" language="en" script="Latn">Geographic information -- Metadata -- Part 1: Fundamentals</title>
-      <title format="text/plain" language="fr" script="Latn">Information géographique -- Métadonnées -- Partie 1: Principes de base</title>
-      <uri type="src">https://www.iso.org/standard/53798.html</uri>
-      <uri type="obp">https://www.iso.org/obp/ui/#!iso:std:53798:en</uri>
-      <uri type="rss">https://www.iso.org/contents/data/standard/05/37/53798.detail.rss</uri>
-      <docidentifier>ISO 19115-1</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>1</edition>
-      <language>en</language>
-      <language>fr</language>
-      <script>Latn</script>
-      <abstract format="plain" language="en" script="Latn">ISO 19115-1:2014 defines the schema required for describing geographic information and services by means of metadata. It provides information about the identification, the extent, the quality, the spatial and temporal aspects, the content, the spatial reference, the portrayal, distribution, and other properties of digital geographic data and services.ISO 19115-1:2014 is applicable to:-the cataloguing of all types of resources, clearinghouse activities, and the full description of datasets and services;-geographic services, geographic datasets, dataset series, and individual geographic features and feature properties.ISO 19115-1:2014 defines:-mandatory and conditional metadata sections, metadata entities, and metadata elements;-the minimum set of metadata required to serve most metadata applications (data discovery, determining data fitness for use, data access, data transfer, and use of digital data and services);-optional metadata elements to allow for a more extensive standard description of resources, if required;-a method for extending metadata to fit specialized needs.Though ISO 19115-1:2014 is applicable to digital data and services, its principles can be extended to many other types of resources such as maps, charts, and textual documents as well as non-geographic data. Certain conditional metadata elements might not apply to these other forms of data.</abstract>
-      <abstract format="plain" language="fr" script="Latn">L'ISO 19115-1:2014 définit le schéma requis pour décrire des informations géographiques et des services au moyen de métadonnées. Elle fournit des informations concernant l'identification, l'étendue, la qualité, les aspects spatiaux et temporels, le contenu, la référence spatiale, la représentation des données, la distribution et d'autres propriétés des données géographiques numériques et des services.L'ISO 19115-1:2014 est applicable:-au catalogage de tous les types de ressources, des activités des centres d'informations et à la description complète des jeux de données et des services,-aux services géographiques, jeux de données géographiques, séries de jeux de données, entités géographiques individuelles et propriétés d'entités.L'ISO 19115-1:2014 définit:-des sections relatives aux métadonnées obligatoires et facultatives, aux entités de métadonnées et aux éléments de métadonnées,-le jeu minimal de métadonnées requis pour répondre au besoin de la plupart des applications des métadonnées (la découverte des données, la détermination de l'adéquation des données à une utilisation, l'accès aux données, le transfert des données et l'utilisation des données numériques et des services),-les éléments de métadonnées facultatifs pour permettre une description standard plus poussée des ressources, si cela est nécessaire,-un procédé d'extension des métadonnées pour s'adapter aux besoins spéciaux.L'ISO 19115-1:2014 est applicable aux données numériques et services, ses principes peuvent être étendus à bien d'autres types de ressources telles que les cartes, les graphes et les documents textes, de même qu'à des données non géographiques. Certains éléments de métadonnées conditionnels peuvent ne pas s'appliquer à ces autres formes de données.</abstract>
-      <status>
-        <stage>60</stage>
-        <substage>60</substage>
-      </status>
-      <copyright>
-        <from>2014</from>
-        <owner>
-          <organization>
-            <name>ISO</name>
-            <abbreviation></abbreviation>
-          </organization>
-        </owner>
-      </copyright>
-      <relation type="obsoletes">
-        <bibitem>
-          <formattedref>ISO 19115:2003</formattedref>
-        </bibitem>
-      </relation>
-      <relation type="obsoletes">
-        <bibitem>
-          <formattedref>ISO 19115:2003/Cor 1:2006</formattedref>
-        </bibitem>
-      </relation>
-      <relation type="updates">
-        <bibitem>
-          <formattedref>ISO 19115-1:2014/Amd 1:2018</formattedref>
-        </bibitem>
-      </relation>
-      <editorialgroup>
-        <technical_committee number="211" type="technicalCommittee">ISO/TC 211Geographic information/Geomatics</technical_committee>
-      </editorialgroup>
-      <ics>
-        <code>35.240.70</code>
-        <text>IT applications in science</text>
-      </ics>
-    </bibitem>
-  </relation>
-  <editorialgroup>
-    <technical_committee number="211" type="technicalCommittee">ISO/TC 211Geographic information/Geomatics</technical_committee>
-  </editorialgroup>
-  <ics>
-    <code>35.240.70</code>
-    <text>IT applications in science</text>
-  </ics>
-</bibitem>

data/spec/support/iso_19115_2.xml

@@ -1,97 +0,0 @@
-<bibitem type="international-standard" id="ISO19115-2">
-  <title format="text/plain" language="en" script="Latn">Geographic information -- Metadata -- Part 2: Extensions for imagery and gridded data</title>
-  <title format="text/plain" language="fr" script="Latn">Information géographique -- Métadonnées -- Partie 2: Extensions pour les images et les matrices</title>
-  <uri type="src">https://www.iso.org/standard/39229.html</uri>
-  <uri type="obp">https://www.iso.org/obp/ui/#!iso:std:39229:en</uri>
-  <uri type="rss">https://www.iso.org/contents/data/standard/03/92/39229.detail.rss</uri>
-  <docidentifier>ISO 19115-2</docidentifier>
-  <contributor>
-    <role type="publisher"/>
-    <organization>
-      <name>International Organization for Standardization</name>
-      <abbreviation>ISO</abbreviation>
-      <uri>www.iso.org</uri>
-    </organization>
-  </contributor>
-  <edition>1</edition>
-  <language>en</language>
-  <language>fr</language>
-  <script>Latn</script>
-  <status>
-    <stage>90</stage>
-    <substage>92</substage>
-  </status>
-  <copyright>
-    <from>2009</from>
-    <owner>
-      <organization>
-        <name>ISO</name>
-        <abbreviation></abbreviation>
-      </organization>
-    </owner>
-  </copyright>
-  <relation type="updates">
-    <bibitem>
-      <formattedref>ISO 19115-2</formattedref>
-    </bibitem>
-  </relation>
-  <relation type="instance">
-    <bibitem type="international-standard">
-      <title format="text/plain" language="en" script="Latn">Geographic information -- Metadata -- Part 2: Extensions for imagery and gridded data</title>
-      <title format="text/plain" language="fr" script="Latn">Information géographique -- Métadonnées -- Partie 2: Extensions pour les images et les matrices</title>
-      <uri type="src">https://www.iso.org/standard/39229.html</uri>
-      <uri type="obp">https://www.iso.org/obp/ui/#!iso:std:39229:en</uri>
-      <uri type="rss">https://www.iso.org/contents/data/standard/03/92/39229.detail.rss</uri>
-      <docidentifier>ISO 19115-2</docidentifier>
-      <date type="published">
-        <on>2009</on>
-      </date>
-      <contributor>
-        <role type="publisher"/>
-        <organization>
-          <name>International Organization for Standardization</name>
-          <abbreviation>ISO</abbreviation>
-          <uri>www.iso.org</uri>
-        </organization>
-      </contributor>
-      <edition>1</edition>
-      <language>en</language>
-      <language>fr</language>
-      <script>Latn</script>
-      <abstract format="plain" language="en" script="Latn">ISO 19115-2:2009 extends the existing geographic metadata standard by defining the schema required for describing imagery and gridded data. It provides information about the properties of the measuring equipment used to acquire the data, the geometry of the measuring process employed by the equipment, and the production process used to digitize the raw data. This extension deals with metadata needed to describe the derivation of geographic information from raw data, including the properties of the measuring system, and the numerical methods and computational procedures used in the derivation. The metadata required to address coverage data in general is addressed sufficiently in the general part of ISO 19115.</abstract>
-      <abstract format="plain" language="fr" script="Latn">L'ISO 19115-2:2009 étend la norme existante sur les métadonnées géographiques en définissant le schéma requis de description des images et des matrices. Elle donne des informations relatives aux propriétés des équipements de mesure utilisés pour obtenir les données, la géométrie du processus de mesure utilisée par ces équipements, et le processus de production utilisé pour numériser les données brutes. Cette extension porte sur les métadonnées nécessaires pour décrire la déduction des informations géographiques à partir de données brutes, y compris les propriétés du système de mesure, et les méthodes numériques et procédures informatiques utilisées pour la déduction. Les métadonnées requises pour aborder les données de couverture en général sont suffisamment abordées dans la partie générale de l'ISO 19115.</abstract>
-      <status>
-        <stage>90</stage>
-        <substage>92</substage>
-      </status>
-      <copyright>
-        <from>2009</from>
-        <owner>
-          <organization>
-            <name>ISO</name>
-            <abbreviation></abbreviation>
-          </organization>
-        </owner>
-      </copyright>
-      <relation type="updates">
-        <bibitem>
-          <formattedref>ISO 19115-2</formattedref>
-        </bibitem>
-      </relation>
-      <editorialgroup>
-        <technical_committee number="211" type="technicalCommittee">ISO/TC 211Geographic information/Geomatics</technical_committee>
-      </editorialgroup>
-      <ics>
-        <code>35.240.70</code>
-        <text>IT applications in science</text>
-      </ics>
-    </bibitem>
-  </relation>
-  <editorialgroup>
-    <technical_committee number="211" type="technicalCommittee">ISO/TC 211Geographic information/Geomatics</technical_committee>
-  </editorialgroup>
-  <ics>
-    <code>35.240.70</code>
-    <text>IT applications in science</text>
-  </ics>
-</bibitem>